Sample GetApert
Sample GetLabel
Sample GetProperty
Sample GetThk
Sample GetTrans
Sample Info
Sample SetApert
Sample SetLabel
Sample SetProperty
Sample SetThk
Sample SetTrans
Display in the console the information about sample including sample aperture, thickness, transmission, and description.
Property is one of the following sample properties: Apert, Label, Thk, or Trans.
Value is a value to which the property will be set.
Scans are described as an instrument state or a sequence of states at which measurements are made. Virtual devices and sample environment devices can be used in scan description just like any other device.
The following commands can be used to do manipulations on scans and scan lists.
Scan AppendList
Scan ChkOverwrite
Scan ClearList
Scan CopyRange
Scan CurrentToList
Scan CutRange
Scan Delete
Scan DeleteIndex
Scan Descr
Scan DescrToList
Scan DryRun
Scan Howlong
Scan InitList
Scan InitScan
Scan List
Scan ListBackup
Scan ListCopy
Scan ListDescr
Scan Load
Scan LoadConfig
Scan LoadList
Scan Modify
Scan Operation
Scan PasteRange
Scan PatchRange
Scan Run
Scan SaveConfig
Scan SaveConfigID
Scan Set
Scan ThinLoad
A string describing a scan is used to transfer the scan information between processes. This string is parsed and translated into a sequence of instrument states.
In some cases, additional parameters might be needed for the scan description to be complete. Required scan parameters for SANS instruments include:
JType = SANSAUTO: associates a given scan with Sans-specific Automatic Data interface
SANSSTOP = 0 or 1: a STOP attribute indicating the end of run range
Counts = N: number of seconds that will be counted for at each prefactor
Prefac = N: number of prefactors
Filename = S: a prefix for data files
Comment = S: sample label
In addition, some scans may define positions of selected devices that will be moved before counts are measured. For example, the following scan will move GuideTable to 7 guides, BeamStop to 2 and Temperature device to 300 followed by counting for 10 seconds:
Scan:Counts=10:Prefac=1:Filename=test:Comment=ICE:Angle=Guidetable=7: Angle=Beamstop=2:Angle=Temp=300:JType=SANSAUTO:SANSSTOP=0
The description string should always start with the word Scan. Colons separate tokens and values in a list are separated by a space. Each token is made of a field descriptor following by an equal (=) sign and one or several values. The list of available field descriptors is:
Title: Title of the scan.
Comment: Sample Label or other comment.
Filename: A string that will be added at the beginning of the data file name.
Counts: The number of counts for the point.
Prefac: A multiplication factor for the number of counts.
Npts: The number of points in the scan. Defaults to 1.
Angle: A complete list of device positions to be visited before counting is performed: Angle=Device name=Position1 Position2 …
Range: is an alternative to Angle that gives the number of devices values as a functional relation. The format is one of the following: Range=Device name=Range center Increment, Range=Device name=Range start Range stop S, or Range=Device name=Range start Increment I.
The Range token can be used to specify any value, including Temp and MagField. Values that are constant throughout the scan can also be specified with a zero increment.
Sample: Sample property given in the form: Sample=Property name=Property value. For example, Sample=Thk=0.1 will set sample thickness to 0.1; Sample=Trans=1.0 will set sample transmission to 1.
PresetDevicesProperties: A property of environment device that will be preset at the beginning of scan execution. For example, PresetDevicesProperty=Temp tolerance 1.0 will preset temperature set point error to 1; PresetDevicesProperty=Temp timeout 5.0 will preset temperature timeout to 5 seconds.
SANSRheoPulses: a number of Rheometer pulses.
Timeout: Time after which the preset counter will be stopped regardless of whether it has reached its preset value.
HoldPoint: Holding time before the preset counter is started at each point.
HoldScan: Holding time before the preset counter is started for the first point of a scan.
Any additional tokens can be appended to the scan description as meta data. These additional tokens must be separated by colons.
Scans in ICE are stored in a list in memory. The scan descriptions contained in the list are available to users to run on an instrument. In order to save scans for repeated uses over time, the scan list must be backed up to disk. Several commands exist for manipulating the scan list and moving its contents to and from disk.
Appends scans from a given file to the scan list.
Note that this can lead to entries in the current scanlist being overwritten. Use Scan ChkOverwrite to see which scans would be overwritten.
Filename is the name of the file content of which will be appended to the scan list.
Returns the list of scans which would be overwritten by loading a list of scans from a file. See also Scan LoadList and Scan AppendList commands.
Clears out all scans currently in the scan list. If those scans have not been backed up, they will be lost.
Copies a range of scans in the scan list into location starting from a given position.
Start is the an integer number greater than 0 that defines the beginning of the range of scans that will be copied.
End is the an integer number greater or equal to Start that defines the end of the range of scans that will be copied.
Destination is the an integer number greater than 0 that defines position to which selected set of scans will be copied. Note that if Destination is greater than the number of scans in the list, selected scans will be put immediately after the last scan in the list.
Puts the current scan description in the scan list on the server under a specified name. Note that if a target scan already exists in the list, it will be replaced.
Removes a range of scans from the scan list and saves them in memory to be later used with Scan Paste command.
Puts a given scan description into the scan list, under the given name. Note that if a target scan already exists in the list, it will be replaced.
Name is a positive integer specifying position in the scan list to which the scan will be saved.
Description is a properly formatted scan description.
Dry runs a given the current scan by calculating device positions for each point in a scan. Each device position is then checked for validity such as being within preset limits. If scan name not given, dry runs the current scan.
Computes the duration of a range of scans. If scan counts against Time, the duration of the scan will be set to the number of counts multiplied by the prefactor.
If scan counts against Monitor counts, a 3rd degree polynomial parameterization of the monitor rate as a function of an instrument-specific device will be used to estimate the rate at each point of the scan. The monitor rate predicted by the parameterization is scaled according to the stored monitor rate and the value of device it was measured at.
The Rate command should generally be run before Scan Howlong. If it has not been run when Scan Howlong for scans using monitor counts is run, Rate will be run automatically before a result is given.
Start is an integer greater than 0 that defines the beginning of the range of scans which duration will be estimated.
End is an integer greater or equal to Start that defines the end of the range of scans which duration will be estimated.
Instructs to return the result in seconds. Otherwise it will be in hours.
Sets a default overhead, in seconds, that will be added to the time for each point. If there is a device with a higher movement overhead than the specified overhead, then that device's overhead will be added instead.
See also: Device GetOverhead and Device SetOverhead commands.
Execution behavior: Immediate.
Initializes the scan list which includes removing all existing scans from the list and creating the default scan that fully describes current instrument state. For SANS, default scan will contain current positions of all devices.
Initializes the current scan and sets it to its first point. If the scan is already running, it will finish processing current point and will be re-initialized.
Copy an entry in the scan list pointed by Source into the entry pointed by Destination. Note that if Destination already exists in the list, it will be replaced.
Retrieves the description of a given scan from the server.
For given scan name, the system reads the current scan description and appends it to the queue for future execution. The user may change scan description later without altering the already queued scan. The user may load multiple scans with the same name and different descriptions.
Filename is a name of file which contains a scan definition to be loaded. Note, that file extension .cfg is associated with SANS configuration files.
Scanname is a positive integer that specifies a scan number which description will be replaced with the description from a given file. Alternatively, the user can load description into a range of scans between Start and End.
Replaces the scan list with the list from a given file. See also Scan ListBackup command.
Description is a properly formatted scan description.
Allows the user to apply changes to descriptions of several scans at once. This command will replace the values of specified scan parameters in the scan description with the values given by the user. If a certain scan parameter has not yet been defined for given scans, the parameter will be added.
Note that this command is intended for advanced users. The system will not prevent you from making changes which lead to invalid or inconsistent scans. See "Notes and Warnings" section below.
Name1,Name2,... is a list of positive integers that specify individual scans to which changes will be applied. The list should be separated by commas and contain no spaces.
Changes is a list of settings for scan keyword attributes. Each attribute is an attribute name followed by the equals sign and a value. Different attributes are separated by commas. See Scan for definition of scan attributes.
Scan Operation 1,3 Counts=100,Angle=Temp=200
Changes scans 1 and 3 by setting the number of counts to 100 seconds and moving temperature device to 200.
Notes and Warnings: This command does not protect against breaking scans.
See also: scan description format.
Inserts a range of scans which were previously copied into memory using Scan Cut command in a given position in the scan list.
Applies changes to the range of scans. Note that this command is intended for advanced users. The system will not prevent you from making changes which lead to invalid or inconsistent scans. See Notes and Warnings section below.
Start is the an integer number greater than 0 that defines the beginning of the range of scans that will be changed.
End is the an integer number greater or equal to Start that defines the end of the range of scans that will be changed.
Changes is a comma-separated list of settings for scan keyword attributes. Each attribute is an attribute name followed by the equals sign and a value. See scan description format for definition of scan attributes.
Scan PatchRange 1 10 Counts=100,Angle=Temp=200
Changes scans 1 through 10 by setting the number of counts to 100 sec and moving temperature device to 200.
Notes and Warnings: This command does not protect against breaking scans.
See also: scan description format and Scan Patch panel documentation for Scan PatchRange GUI support.
Executes scans in a given range. Unless Scan Load command was used before Scan Run to copy scan definition to the queue for execution, Scan Run command will use the most recent scan version. Changes made to scan definition after execution begins will not have any effect.
Command Scan Runscan is equivalent to Scan Run.
Creates and saves a scan that fully describes current instrument state into a given file.
Filename is a name of file to which a scan definition will be written. Note, that file extension .cfg is associated with SANS configuration files.
Additional parameters is a partial scan description (possibly empty) that overrides current instrument state in the created scan. See scan description format for further details.
Scan SaveConfig testConfig.cfg Counts=100:Sample=Thk=1
Retrieves all current device positions and properties, sample properties and global scan properties. These will subsequently be used to create scan description in which number of counts will be reset to 100 and Sample Thickness will be reset to 1. This scan will be saved to a file testConfig.cfg.
Sets current scan to a given scan description.
This command cannot be run if there is a scan in progress.
Description is a properly formatted scan description.
Appends a range of scans to the queue for execution. For all scans in a given range, the system reads the scan definition and appends it to the queue for future execution. The user may change scan definition up until the moment the scan execution starts at the server. These changes will apply to already queued as well as all future executions of the scan.
If one or more scans from a given range does not exist at the server, the system will create it with a description specific to the instrument. For SANS, default scan will be a STOP.