Command list

  This section contains an alphabetical list of most commands of the control mode. ICP will accept numeric input of almost any standard format when a number is part of the command. Multiple commands on the same line are separated by semicolons. When a small n is part of the command, i.e., Dn, n specifies a motor or buffer number.

!

: Comment Line. Lines starting with an exclamation point are ignored.

A

+/$-$ Enable/disable Autorange on BT-1.

A+

: The scan range of motor 4 will be automatically set whenever a buffer is opened in the prepare mode. The settings used will depend on the current monochromator selection.

A$-$

: Disable Autorange.

BUFOP

[Buffer Operations] - see Appendix B

The syntax is BUFOP [buffer type & number range] [list of operations]

Example: BUFOP I1-3 TH=5,TER=1

Operations permitted in the BUFOP command can be viewed in the Appendix. Any other commands will cause an error. If ICP discovers an error in any of the operations in a given BUFOP command, none of the changes in the bufop command will be made. Note: DRS will not check the syntax of the BUFOP command other than to verify that the type buffer is provided.

Bye

[Exit ICP]

CO

[Count] or CT [=] f

f > 0 issue count with monitor preset to f. (prefactor disregarded)

f < 0 issue count with time for f seconds.

CT

is a synonym for CO.

COL

[Collimation]

COL[LIM=] c1,c2,c3,c4: COL lets you describe up to four collimations; c2-c4 are for informational purposes only. The collimation data are stored in the data file.

The first value (c1) is the ``in pile'' collimation, selected by the shutter switch - either $15^\prime$ or $7^\prime$ (yes, the shutter lights say $14^\prime$, but $15^\prime$ is correct!)

Use COL = 15 or COL = 7 to change the ``in pile'' value only.

NOTE: It is important that the ``in pile'' value be correct, since the wavelength stored in the data file will depend on this setting.

The second number (c2) is the post-monochromator collimation [$20^\prime$ for Ge(311) and Cu(311) and $30^\prime$ for Si(531)].

The third number (c3) is the post-sample collimations, always $7^\prime$.

The fourth number (c4) is not relevant to BT-1, we usually specify 0.

To examine previously given collimation data type PC or PCOL.

Dn

Drive Angle n

Dn[=]f : Drive angle n to target angle f. f is the absolute position you want the motor to drive to. Superuser status is required to drive motors other than 3 or 4.

DnH

Drive to Hardware Angle

DnH[=]f : Drive angle n to hardware angle f.

DnI

Incremental Drive

DnI[=]f : Drive angle n to target angle (A(n) + f). f is the increment you want the motor to drive.

DnT

2:1 Drive

DnT[=]f : Drive angle n to target angle f and angle (n-1) to A(n-1) + (f - A(n))/2 ==> n : (n-1) == 2 : 1

This command results in a 2:1 drive. For example, if the current position of angles 3 and 4 are 20 and 60, respectively, the command D4T=80 will drive angle 4 to 80 and angle 3 to 30.

DELRS

delete RUN sequence

DIRI

Directory of [increment] Buffers

DR

Dry Run

DRIn

: Displays angles used in increment scan.

DRS

: Checks run sequence syntax

DRSF

<filename>: Checks run sequence command file syntax

EX

Exit ICP

EDIT

Edit Run Sequence File

EDIT <filename>: opens new or existing file in EDT full screen editor. Multiple commands on the same line should be separated by a semicolon. Lines starting with an exclamation point (!) are ignored. Use Ctrl-z and "EXIT" to leave editor and return to Control Mode.

FIX

Keep An Angle Fixed during buffer execution

FIXn

: Fixes motor n so that it will not be moved by an executing buffer.

FIXT or FIXS

: Fixes the sample table, Equivalent to FIX3; angle 3 is fixed.

To release a fixed angle type RELn (n= motor number or S, etc.)

FPD

Find Peak in Detector.

FPD d, n, p2, p3, p4 : Find a peak in the given range.
d = detector number
n = angle number to scan.
p2 = range of scan in degrees, scan center is always the current position.
p3 = step size in degrees.
p4 = count time in seconds; use p4 < 1 to count with time.

FPD will scan the given range around the current position for a peak. If a peak is found, a fit can be done, and the scanning motor will drive to the peak position. After the scan, if no peak is found, the motor will return to the initial position.

Example: FPD 1, 4, 1, 0.1, -1 will scan the 2$\theta$ angle (motor 4) around the present position, in steps of 1/10 of a degree, counting 1 sec/pt.

The calling parameters beginning with range are optional in all cases. The defaults taken are: range = 1.0, setpsize = 0.1, monitor = $-1$. Thus fpd 1,4 is equivalent to the example given.

The fpd command can be followed with the option:

/F

: keep a file of the data at each point in the scan

The FPD command can only handle up to 100 points in the scan range.

HELP

Access ICP online Help

Type HELP for the complete command list or type HELP <command> for help on a particular command.

HOLD

Hold System

HOLD[=] n : Put the system into a hold for n minutes. Can be aborted by pressing Control-A. After the hold the next command in a run sequence or run file will be processed and executed.

HOME

Send motor to home position

HOME n +/- sends motor n home in a positive or negative direction. Use home 12 - to send the beam mask home.

Superuser status is required.

HOWLONG

Estimate execution time of a series of buffers or a command file

howlong i1-3,5,7 estimates the execution time of these buffers

howlong/rs extimates the execution time of a run sequence

howlong/f <myruns.com> estimates the execution time of the run sequence file myruns.com.

At present, only R (run buffer) commands and HOLD commands are considered as taking any time in run sequence command files.

The command MRAT/S must be executed on the instrument before the HOWLONG command can be used. MRAT/S stores information needed by HOWLONG. Hold times and wait times specified in the buffers are also included in the time estimates as appropriate.

The outputs from the howlong and howlong/f commands are slightly different. The howlong output gives the execution time of each buffer as well as a running total. The howlong/f command gives the execution time of each command in the file as well as a total execution time for the entire file at the end. A time range is shown when temperature waits could make a difference. T+, H+, or P+ appear on each line where they are assumed to be in effect by howlong.

A ``/p'' option has been built into the howlong/f command which will allow one to get a time estimate for only the unexecuted portion of a command file.

INIT

Initialize Hardware Angle

INITn[=] f Initialize the current position of motor no. n to angle value f. (n integer, f real)

Ln

Set Lower Limit n

Ln[=] f : Set lower limit of angle n to value f. (n integer, f real) The appropriate lower limit for motor 4 is set when the monochromator is selected using the MONO= command.

LOGON

Write Log

Sets W to W+ and causes screen output to be written to a .log file. The filename is formed by the date. (Data that are already stored in a file when a buffer or find-peak is executed are not included in the log file.)

LOGOFF

Do Not Write Log

MONO

Define monochromator on BT-1

MONO= p1 where p1 is one of the following allowed strings: Cu311, Ge311, or Si531

MRAT

Determine Monitor Rate

MRAT[= [f]]: Determine monitor rate with a time count for f seconds. f defaults to 5 seconds.

MRAT/S

Determine monitor rate and save information needed by howlong command.

The command MRAT/S (s is for save) in ICP will function differently whether it is entered from the privileged (or instrument control) terminal or from anywhere else. When entered from the instrument control terminal, mrat/s causes the current monitor reading to be saved in memory as well as in a file. A request is made for the user to supply a constant overhead per point, where the default value should be fairly accurate. All of this information not only becomes the working numbers used in any succeeding howlong calculations, but is stored in a file and read back in whenever ICP is started on that instrument (from any terminal). This means that the latest mrat/s findings will be available to anyone logging in to that instrument from anywhere. The file contents, however, can only be changed as the result of an mrat/s command being entered at the instrument control terminal. mrat without the /s switch just counts the monitor as usual, and does not update the stored values.

If someone enters mrat/s from any terminal other than the instrument control terminal, they will be given the option of using these values as last stored, or typing in temporary local values to be used in their own howlong calculations.

NEWMONO

Change to a new monochromator; requires superuser status.

NEWMONO = p1 where p1 is Cu311, Ge311, or Si531

NEXT

Move to next automatic sample changer position on BT-1

PA

Print Software and Hardware Angles

Prints the software and hardware values of all angles served by the instrument.

PC

or PCOL: Print Collimations

PD

Print Date and Time

PFIX

: Print list of motors currently fixed

PHA

: Print Hardware Angles

Prints hardware angles for all motors served by instrument. The values given here should correspond to the controller display.

PI

: Print Increment Buffer

PIn-m: Print increment buffers n to m.

PL

: Print Lower Limits

PMONO

Print Monochromator and Collimations on BT-1

PRS

Print Predefined Command Sequence

See description of RS for a discussion of how to define and execute a sequence.

PRSF

PRSF <myruns.com> prints the file myruns.com

PSA

Print Software Angles

Print software value of all angles served by instrument.

PTD

Print Current Temperature Device

PTP

Print Temperature Parameters (gain, rate, reset, range, etc.)

PU

Print Upper Limits

PVER

Print Default Run Number

PZ

Print Zero-points

QUIT

[Exit ICP]

R

+/$-$ Enable/disable Rocking of Motor during buffer execution on BT-1

R+

: Enables Rocking of motor while counting during buffer execution. The motor number and rocking angle range will be requested.

R$-$

: Motor Rocking while counting is disabled.

REL

Release a Fixed Angle

RELn

: Releases angle n.

RELT, RELS

: Releases the sample table (= angle 3).

RI

Run Increment Buffer

RIn[-m]: Execute increment buffer n [to m]. RI/NFn[-m]: No File Option for RI command. No data files created.

RS

Execute Defined Sequence

RS= ``command'';``command'' : Defines a command sequence. These commands are ``stored'' in a file. Another way of defining this sequence is to go into prepare mode and select option F19 (define sequence). Be Careful: The commands you enter here are not checked for validity!!

RS : Executes all commands in your command sequence

RSF

<filename> Executes all commands in the file

S

+/$-$ Enable/disable Statistical checking

S+

: Enables the statistics check in your data acquisition. If prefactor is greater than 3 and counts are greater than 10, each prefactor will be checked for statistical consistency.

S$-$

: Statistics check is disabled.

SET

Change Zero-point

SET n[=] f: Change the zero-point in such a way that the current position equals to f. (n integer, f real) f is usually a calculated angle. Please do not use this command at BT-1; use the INI command instead.

SETP

Set-up Temp Controller parameters

SETP0

[=] p1, p2, p3, p4: Set controller params to values given for LR400 & LR700: p1: Range, p2: Excitation for LK330 & LK340: p1: Gain, p2: Rate, p3: Reset, p4: Range for others: p1: Gain, p2: Rate, p3: Reset, p4: Power for LK340 autotune: set p1 to < 0 to indicate autotune gain only set each param to < 0 to autotune that param

SETP1

: Set temperature controller parameters for high temperatures:

Gain= 90; Rate= 40; Reset= 20; Power Range= 5;

SETP2

: Set temperature controller parameters for low temperatures:

Gain= 40; Rate= 20; Reset= 10; Power Range= 3

ST

Set Temperature Controller Setpoint

ST[=]f : Set the temperature setpoint to f.

ST[=] f,error, wait: Use only when "careful approach" option selected. Defaults for error and wait are 10

T+/$-$

Enable/disable Temperature Control

T+

: Enables the temperature control. With this feature enabled you get a temperature reading every time a point is finished during buffer execution. In order to access the temperature controller at all, T must be set to T+. If TDEV has not already been executed, it is called automatically by T+.

T$-$

: Disables the temperature control. No access to temperature controller when T is set to T$-$.

TC+/$-$

Enable/disable use of "Careful Approach" in Temperature Control

TDEV

Declare and initialize Temperature Controller

The TDEV command will call up a menu of recognized temp controllers. The controller currently connected to the instrument should be chosen from this list. It will be initialized by TDEV and available within control mode and executing buffers for changing and monitoring temperature. TDEV must be executed at least once whenever a controller is connected to the instrument. If ICP is exited for any reason, TDEV must be reexecuted. Temperature cannot be monitored or set until TDEV has been executed.

Un

Set Upper Limit n

Un[=] f : Set upper limit of angle n to value f. (n integer, f real) The appropriate upper limit for motor 4 is set when the monochromator is selected using the MONO= command.

VER

Set lower limit for the data file version.

Ver= n

W+/$-$

Enable/disable Writing Log File on disk

See LOGON and LOGOFF.

XDT

: XDT lists the possible calibration curves in the current Lakeshore temperature controller and the dip switch settings to select a particular curve. It also tells you which curves are suitable for which cryostat.

Zn

Set Zero-point n

Zn= f : Set zero-point of angle n to value f. (n integer, f real) Please do not use this command at BT-1; use the INI command instead.