M-Labs
/
artiq
mirror of https://github.com/m-labs/artiq.git
2
0
Fork 1
Code Issues Projects Releases Wiki Activity

faq: clarifications

This commit is contained in:
Robert Jördens 2015-03-24 13:12:40 -06:00
parent 03139808bd
commit a6316c8fee
1 changed files with 13 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
doc/manual/faq.rst
View File

@ -4,8 +4,8 @@ FAQ
How do I ... How do I ...
============ ============
override the sysclk frequency of just one dds? override the `sysclk` frequency of just one dds?
---------------------------------------------- ------------------------------------------------
Override the parameter using an argument in the ddb. Override the parameter using an argument in the ddb.
@ -18,12 +18,13 @@ Names need to be unique.
enforce functional dependencies between parameters? enforce functional dependencies between parameters?
--------------------------------------------------- ---------------------------------------------------
Use wrapper experiments, overriding parameters of arguments. If you want to slave a parameter `b` in the pdb to be `b = 2*a`,
use wrapper experiments, overriding parameters of arguments.
get rid of `DbKeys`? get rid of `DBKeys`?
-------------------- --------------------
`DbKeys` enforces valid parameter/argument names, references `DBKeys` enforces valid parameter/argument names, references
keys in pdb and hints at metadata on how values can be retrieved. keys in pdb and hints at metadata on how values can be retrieved.
write a generator feeding a kernel feeding an analyze function? write a generator feeding a kernel feeding an analyze function?
@ -61,8 +62,10 @@ Use `threading.Thread`: portable, fast, simple for one-shot calls
write part of my experiment as a coroutine/Task/generator? write part of my experiment as a coroutine/Task/generator?
---------------------------------------------------------- ----------------------------------------------------------
You want to write experiment preparation (`__init__()` or `build()`) You can not change the API that your experiment exposes: `__init__()`,
or analysis (`analyze()`) `build()`, and `analyze()` need to be regular functions, not generators,
coroutines. or `asyncio.Tasks`. That would make reusing your own code in
No. That would make reusing your own code in sub-experiments difficult and sub-experiments difficult and fragile. You can however always use the
fragile. scheduler API to achieve the same (`scheduler.suspend(duration=0)`)
or wrap your own generators/coroutines/Tasks in regular functions that
you then expose as part of the API.