| Lines 4-7 were replaced by lines 4-6 |
| - to go also for a new sample environment framework Frappy. Frappy is a Python Framework developed by Enrico Faulhaber (MLZ) and Markus |
| - Zolliker (PSI), for creating servers to access mobile equipment like |
| - sample environment, using [SECoP|https://github.com/SampleEnvironment/SECoP] as communication |
| - protocol towards the experiment control software. |
| + to go also for a new sample environment framework Frappy. Frappy is a Python Framework developed at MLZ and PSI, |
| + for creating servers to access mobile equipment like sample environment, |
| + using [SECoP|https://github.com/SampleEnvironment/SECoP] as communication protocol towards the experiment control software. |
| Line 9 was replaced by line 8 |
| - For a transition period [SEA|Sea] is still used for all devices not yet migrated to Frappy. Today (spring 2021) still most |
| + For a transition period [SEA|Sea] is still used for all devices not yet migrated to Frappy. Today (spring 2025) still a lot |
| Line 14 was replaced by line 13 |
| - By default a setup 'frappy' is loaded providing the following commands: |
| + By default a setup 'frappy' is loaded providing the following commands:\\ |
| Removed line 16 |
| - |
| Lines 18-23 were replaced by lines 16-21 |
| - frappy_main('<main cfg>') # change main SE configuration (e.g. cryostat) |
| - frappy_stick('<stick cfg>') # change sample-stick configuration |
| - frappy_stick('') # remove stick |
| - frappy_main('') # remove main SE apparatus |
| - frappy_main() # show the current SE configuration |
| - frappy_addons(...) # similar to above, for additional equipment not covered by main/stick |
| + frappy('<main cfg>') # change main SE configuration (e.g. cryostat) |
| + frappy('<main cfg>', '<stick cfg>') # change main and sample-stick configuration |
| + frappy(stick='<stick cfg>') # change stick only |
| + frappy('') # remove main SE apparatus including stick |
| + frappy.show() # show the current SE configuration |
| + frappy(addons=...) # similar to above, for additional equipment not covered by main/stick |
| At line 26 added 63 lines. |
| + ''note: use {{AddSetup('frappy')}} if the setup is not yet loaded'' |
| + |
| + There is some automatic detection of devices in SEA. You might get a message in NICOS |
| + to accept the detected devices. To confirm, execute simply {{frappy()}} |
| + |
| + |
| + !! Frequently Asked Questions |
| + |
| + ! Are values of sample environment devices automatically stored in the data file? |
| + |
| + When the SE configuration is changed, automatically the following aliases are created, |
| + if the corresponding object is available: |
| + |
| + * __T__: the moveable main temperature, change before a scan: {{maw(T, 295)}}, use in a scan: {{scan(T, ...)}} |
| + * __Ts__: the sample temperature, potentially readonly |
| + * __B__: the magnetic field, moveable |
| + |
| + The aliases above (except T) are automatically put into the envrionment list, and should be saved in the data file. |
| + When the sample temperature is controlled, T and Ts point to the same real device. |
| + |
| + You might add additional devices to be stored with the {{AddEnvironment}} command. |
| + |
| + |
| + ! There is nothing displayed on the SEA client, what is going wrong here? |
| + |
| + It might be that the SEA server is not yet running. Controlling the SEA and Frappy servers: |
| + {{{ |
| + sea start # start the SEA and graph servers |
| + sea restart # restart above |
| + sea list # show running SEA and Frappy servers |
| + sea help # list available sea subcommands |
| + }}} |
| + |
| + ! The sample environment device I want to use is not available |
| + |
| + Please use the command {{frappy_list()}} in NICOS to see a list of available configurations. |
| + Creating the configuration files for Frappy is still under work. The devices to be used on above mentioned |
| + instruments according to the schedule are created first. Please contact [Markus Zolliker], if you want to use |
| + a device not yet on the list. |
| + |
| + ! How to Restart a Frappy server(s) |
| + |
| + If a sample environment device is not working properly, for example due to communication |
| + problems, it might be helpful to restart the frappy server(s): |
| + {{{ |
| + frappy('restart') # stop and start main and stick frappy servers |
| + }}} |
| + |
| + If the problem is related to a device on the stick or addons, you can restart them individually with {{frappy(stick=...)}} or {{frappy(addons=...)}}. |
| + |
| + ! How do I configure to use the sample stick rotation instead of the sample table for omega? |
| + |
| + With vertical field cryomagnets, typically the stick rotation should be used instead of the |
| + standard sample table for omega. In this case (configured on TASP, EIGER, CAMEA, ZEBRA and DMC), |
| + the frappy_main setups should contain a device __se_om__ for the stick rotation. This is |
| + automatically assigned to the device used for omega. |
| + |
| + ||Instrument || name of omega || name of sample table |
| + |TASP | a3 | a3_st |
| + |EIGER | a3 | a3_raw |
| + |ZEBRA | om | om_raw |
| + |DMC | a3 | a3s |
| + |CAMEA | a3 | som |
| At line 27 added 3 lines. |
| + On horizontal field magnets, the stick rotation is called __om_stickrot__, and is |
| + not automatically assigned to omega. In both cases, an alias __dom__ is assigned to |
| + either __se_om__ or __se_stickrot__, whatever is present. |
| At line 28 added 1 line. |
| + To change this behaviour, it is possible to assign another device to the alias, e.g. |
| At line 29 added 1 line. |
| + {{om.alias = se_stickrot}} |
| Removed line 31 |
| - |
LIN