An official website of the United States government
Here’s how you know
Official websites use .gov
A .gov website belongs to an official government organization in the United States.
Secure .gov websites use HTTPS
A lock (
) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.
Commands typed at the console are in bold and follow brackets >>>. Bracket pairs < and > are used to signify the type of input needed. Three dots ... means multiple inputs are possible. Hitting [Tab] on the keyboard will list available commands, devices, and nodes – typing part of a command, device, or node will narrow the list.
What are the most basic commands I need to know?
read
Reads the value(s) of the device(s) provided.
The read command is performed immediately and the results are posted to the console.
displayinga node will show node values based on the last state read from hardware.
readinga node will query hardware directly to get the latest value. If a node's value is based on other node's values, these other nodes will also be read, recursively.
Where can I find help about using a command or device?
In the menu, under Help-->Find/Help Commands and Devices. Type part or all of the name of the device or command into the help window.
What is the difference between the soft, hard, and raw positions?
rawPosition is the raw value as read from the hardware.
hardPosition is position in a convenient unit.
hardPosition = rawPosition × conversion factor
softPosition is further adjusted by a zero offset and to orient in a convenient direction.
softPosition = parity × (hardPosition – zero)
How can I set a motor’s position?
setMotorPosition
Conveniently redefines a motor’s softPosition by adjusting the zero.
>>> setNodeProperties sampleAngleMotor.softPosition --units rad
Note:
After units are changed, the latest units will not be reflected in all GUI panels until the client is restarted. The command line and Device Panel always respect the latest unit.
The dimension of a node CANNOT be changed. For example, if a node's unit was degrees you cannot change it to cm.
How do I lock (fix) a motor or other device? What is a lock?
A lock prevents a node from being moved directly or indirectly via a move command, trajectory, sequence, etc.
Everyone has permission to lock and unlock any node: >>> setNodeProperties <node> --userLocked true
Only admin can can admin-lock and admin-unlock a node: >>> setNodeProperties <node> --adminLocked true
How do I know if the system is busy (motors moving, counting, etc)?
You can tell if the system is busy by looking at the top-right of any window in the status bar.
Go to Window > Device Control for real-time display of exactly which devices are busy.
How do I add/remove sample environment equipment?
Go to Window > Configure Devices to add and remove available device configurations.
How do I stop ONLY the current command running in the queue?
Right-click the desired command in the queue and hit Cancel.
How do I find my files? How do I copy them from a previous experiment into the current experiment?
Go to Experiment > View Experiment Manifest… to see all files organized by experiment. Search bar allows for experiments to be filtered.
Selecting an experiment shows subfolders, including sequences and trajectories. Right click and choose Copy on the files of interest.
The current experiment is always at the top of the list. You can also open a separate file browser by clicking Open Experiment Folder.
Select the folder to be copied into (do not open the folder, right click on it) and select Paste files into /...
What is the difference between a script, a sequence, and a trajectory? How do I know which to use?
How do I customize output filenames in trajectories?
Sequences are a text file of NICE commands, executed in order. No loops or if...then statements are allowed, but nesting other sequences is possible and any NICE command can be called from a sequence. The easiest way to build a sequence is to select part of the queue and Copy, then Paste into a text file! An editor with syntax-highlighting is built into NICE. To learn more, go to Sequences.
A trajectory is the recipe for a “scan”, where data points are recorded to a data file. It has syntax for supporting loops based on a “range” (e.g. start, step, stop) or a list of positions for a device to move to for each measurement. (Loops can be nested, scanning over e.g. a range of Q-values for a list of temperatures.) To learn more, go to the Trajectory Guide.
A script is an embedded Python program, allowing the program to make decisions based on the results of measurements. It is more difficult to make a script than the other two and is reserved for special circumstances (e.g., align a sample while cooling, but then move on with measurements when the setpoint temperature is reached). To learn more, go to Scripts.
How does temperature control in NICE work? What is hold time versus timeout versus tolerance band, etc?