Running the client¶
After the server has been started, you can start one or more client applications (CLIs and/or GUIs) that connect to the server. Each client connects to a specific door on the server. A single sardana can be configured with many doors allowing multiple clients to be connected at the same time.
When the sardana server was first executed, part of the registration process created one door for you so now you just have to start the client application from the command line:
Spock is an IPython based CLI. When you start spock without arguments it will assume a default profile called spockdoor. The first time spock is executed, it will inform you that profile spockdoor doesn’t exist and it will offer to create one. Just answer ‘y’. After, it will ask you to which door should the default spockdoor profile connect to. Select the door name corresponding to your sardana server (Door_lab-01_1) and press return. By now you should get an output like this:
homer@pc001:~$ spock Profile 'spockdoor' does not exist. Do you want to create one now ([y]/n)? y Available Door devices from sardanamachine:10000 : Door_lab-01_1 (a.k.a. Door/lab-01/1) Door name from the list? Door_lab-01_1 Storing ipython_config.py in /home/homer/.config/ipython/profile_spockdoor... [DONE] Spock 1.0.0 -- An interactive laboratory application. help -> Spock's help system. object? -> Details about 'object'. ?object also works, ?? prints more. IPython profile: spockdoor Connected to Door_lab-01_1 Door_lab-01_1 :
That’s it! You now have a running sardana client. Still not impressed, I see! The next chapter describes how to start adding new elements to your sardana environment.
Populating your sardana with items¶
One of sardana’s goals is to allow you to execute procedures (what we call in sardana macros, hence from here on we will use the term macro). A macro is basically a piece of code. You can write macros using the Python language to do all sorts of things. The sky is the limit here!
Sardana comes with a catalog of macros that help
users in a laboratory to run their experiments. Most of these macros
involve interaction with sardana elements like motors and experimental channels.
Therefore, the first step in a new sardana demo is to populate your system with
some elements. Fortunately, sardana comes with a macro called sar_demo that
does just that. To execute this macro just type on the command line
You should get an output like this:
Door_lab-01_1 : sar_demo Creating controllers motctrl01, ctctrl01... [DONE] Creating motors mot01, mot02, mot03, mot04... [DONE] Creating measurement group mntgrp01... [DONE]
You should now have in your sardana system a set of simulated motors and counters with which you can play.
If you want to add some real hardware, look at Adding real elements.
for clearing sardana from the elements created by the demo, execute
The next chapter (spock) will give you a complete overview of spock’s interface.