SUPER Help

Getting_started

Words in caps are other help keywords. To move a single motor, the name of the motor plus its new absolute position is sufficient (MOVE). LINEUP scans are used to move a single motor around the present position. SETUP is used to define scans. SCAN #,#,# will scan whichever of the 20 scans you have defined in SETUP. In SETUP, scan types include ANGLE, MOTOR, ENERGY, XSCAN, INTEGER, TIME, SIMULTANEOUS, KSCAN, HSCAN. There is now a log file (NOTE) which records significant changes to the system. The parallel program SPLOT will plot the current scan (during the scan) or previous scans. Fitting of peaks (Gauss,Lorenz, Wertheim) available in SPLOT. SETUP, CALC, INVERS and NOTE are also active in SPLOT.

ABORT

^C (control C). This will stop all motors from moving. It will also abort a count if typed during a scan, without loss of data. Note that while the 4 diffractometer motors have ramp-downs on abort, the mono and table do not, so you are likely to lose steps if you abort a mono move. In general it is better not to abort a move if possible.

ABSORBER

One can have the computer monitor the data rate being collected by the I detector. If it exceeds a certain value the computer will insert a filter (If there is pneumatic filter cartidge mounted on the 2THETA arm of the diffractometer) and retake that data point. The computer also writes an integer corresponding to the positions of the filters as the last of the hex scaler values at each data point in the data file. When used without qualifier the command is a logical switch. When modified, it changes the parameter but doesn't change the logical switch setting. Thus typing ABSORBER will alternately enable and disable the feature, but ABSORBER/RATE=40000 will change the maximum count rate without changing whether the computer will actuate the absorbers or not. NOTE: ABS/SCALE is now COUNT/CALCULATED.

ABSORBER :

Manual_use

The absorbers can also be inserted manually using the paddle switches on the NIM module. The paddle switches and the computer control are ORed for the inserted position. One might want to set the absorbers manually and still record their positions without having the computer add additional absorbers. The way to achieve this is to disable ABSORBER and type COUNT/REGISTER, which reads channel 0 of the quad input register when it reads the hexscaler and stores the value at each data point. The filters are channels 17-20 of the input register. Of course, the computer thinks that channel 17 is actually 16, so having the first filter in results in an integer value of 65536.

ABSORBER :

Hardware

Channels 17-20 of the quad input register are tied to the 4 filter positions. A 1 in any of those positions corresponds to that filter being inserted, either under computer control or manually. Similarly, channels 17-20 of the output register are used to set the absorbers when under computer control. Of course, the computer thinks that channel 17 is actually 16, so having the first filter in results in an integer value of 65536.

ABSORBER :

Qualifiers

ABSORBER :

/ON

For those who don't remember the state of the ABS logical switch, one can explicitly set turn on automatic filter insertion with /ON.

ABSORBER :

/OFF

For those who don't remember the state of the ABS logical switch, one can explicitly set turn off automatic filter insertion with /OFF.

ABSORBER :

/CHANNEL

Which Hex scaler channel (1-6) should be used to determine the maximum count rate. Most of the time this should be channel 1, as that is assumed to be the I signal by other parts of the program. The only time you wouldn't use channel 1 is if you were using a solid state detector and wanted the elastic signal in channel 1 and the total signal in another channel. You would then monitor the total signal for insertion of filters. Note: For calculating the actual count rate (see count/calc) channel 1 is always used.

ABSORBER :

/DELAY

Set the delay time after inserting a filter before continuing. The default time has been recently (4/17/96) been set to 0.35 seconds, but can now be adjusted by this command. The problem is that the filter is set merely by setting some TTL levels, and the actuation of the pistons takes longer than that. Syntax: ABS/DELAY 0.35

ABSORBER :

/INSERT

This tells the computer to insert one or more filters. The parameter should set a 1 for an inserted filter and a zero, so ABS/INS 1010 would insert filters 1 and 3. Why is this command here? It may come in handy for indirect command files, for one. Also, it is logged to SUPER.LOG, which helps bookeeping.

ABSORBER :

/LENGTH

Define the absorption lengths for the particular set of filters you are using. Syntax: ABSORBER/LENGTH 1,10,100,1000 would tell the program that the absorbers in the filter set are 1 e-length, 10 e-lengths, etc. An e-length is the thickness which would reduce the intensity by 63%. Note that the e-lengths are energy dependent, so you should confirm that the values are correct for your photon energy. A good estimate of the length can be obtained using the ABSORPTION program, which should be installed on this machine and is definitely on SSRL.

ABSORBER :

/RATE

Defines the count rate above which the computer will try to reduce the rate by inserting a filter. It will iterate on the same data point until it has either reduced the count rate below the defined value or inserted all 4 filters. Syntax: ABSORBER/RATE 40000 which sets the maximum count rate to 40000 counts per second. When the count rate drops below 0.9*max_rate the program will recalculate the proper number of absorbers NOTE: The program assumes that the absorbers are installed in ascending order of thickness, i.e. the thinnest filter is listed first. Otherwise it won't calculate the right combination of filters to insert.

ABSORBER :

/SCALE

This has been replaced by COUNT/CALCULATED. In it's new version it can be turned on whether or not ABSORBER mode is turned on. Writes to disk (and screen) a scaled version of the signal as the last channel.

ADC

This will use a LeCroy 3512 ADC with a 3588 histogramming memory OR a XIA DXP module(s). If turned on, then any count will collect data from the ADC in addition to the hex scaler. Scans will also write a spectrum to disk for each data point. For a scan name of TEST.043, the ADC spectra will be TEST043_##.001->N, where ## is the element number. Lecroy modules aren't defined in bl_define.def, but in ls:define_slots.com

ADC :

Hist_Switches

Remember that the Histogram DIP switches are different for the ADC and TDC modules. The two choices are listed in the "Using the 3588 Data Bus" manual. Briefly, for the ADC you want the middle 4 rockers open (depressed on the right, looking at the back of the module).

ADC :

Qualifiers

ADC :

/BOTH

Save the adc spectrum both as a histogram and as regions of interest (ROI)'s defined using the ADC/ROI command. Alternatives are SPECTRUM and CHANNELS. For the DXP, SPECTRUM= BOTH.

ADC :

/CHANNELS

Save the data as integrals of regions of interest (ROI)'s defined using the ADC/ROI command. In this mode the entire histogram is NOT saved, only the ROI's. Alternatives are SPECTRUM and BOTH.

ADC :

/ON

Turns on the ADC mode.

ADC :

/OFF

Turns off the ADC mode.

ADC :

/END

Last channel to be plotted and recorded to disk. From 2 to 8192. For the DXP, max= 1024.

ADC :

/DISPLAY

For the DXP, changes which element is plotted after a count, and displays the current data for that element. Thus, after a count, you can review the data collected by multiple elements. Remember, though, that the last element viewed is the new default element for plotting after the next count. Example: ADC/DISPLAY/CHAN=channel

ADC :

/GAIN

The digitizing resolution. Choices are 250,500,1000,2000,4000,8000. A gain of 1000 puts an 8 volt signal at channel 1000. Only valid for the Lecroy 3588.

ADC :

/LOGROI

This will list the current ROI's for all the elements as well as write them to SUPER.LOG.

ADC :

/REFRESH

During a long count one can see the spectrum that has been collected. This defines the wait (in seconds) between plots. This is the same variable that is used in UPDATE/REPEAT=X, so it can be changed with that command as well.

ADC :

/ROI

Defines the first region_of_interest. This is the same as /1ROI

ADC :

/1ROI

Defines the first region_of_interest. Parameters are element #, starting bin, ending bin. If no parameters are given, a list of the ROI's for all elements is given. If 0 is given as the element number, then the start and stop bins are set the same for all elements. Example: ADC/1ROI 7,200,300 sets the first roi for element 7 from 200 to 300. ADC/ROI is equivalent.

ADC :

/2ROI

Defines the second region_of_interest. Parameters are element #, starting bin, ending bin. If no parameters are given, a list of the ROI's for all elements is given. If 0 is given as the element number, then the start and stop bins are set the same for all elements. Example: ADC/2ROI 7,200,300 sets the second roi for element 7 from 200 to 300.

ADC :

/3ROI

Defines the third region_of_interest. Parameters are element #, starting bin, ending bin. If no parameters are given, a list of the ROI's for all elements is given. If 0 is given as the element number, then the start and stop bins are set the same for all elements. Example: ADC/3ROI 7,200,300 sets the third roi for element 7 from 200 to 300.

ADC :

/SAVE

Saves the spectra collected with the most recent COUNT. Only saves channels between those defined by /START and /END. Also writes the hexscaler data at the top of the file. For the DXP, it also writes the DXP parameters ICR, OCR, Live_time (msec), SCA1, BG1, SCA2, BG2, SCA3,BG3. These parameters are the last nine of the hex scaler list.

ADC :

/SPECTRUM

The data collected by the ADC are saved as a histogram only, i.e. no regions of interest (ROI)'s are saved from the data. Alternatives are CHANNELS and BOTH. For the DXP module, SPECTRUM is the same as BOTH.

ADC :

/START

Starting channel to be plotted and recorded. From 1 to 8191. For the DXP module, start can be from 1- 1023.

ADC :

/DXPALIGN

This command serve two purposes: it set the DXP gains in such a way that the most frequent energy in the spectrum is converted into the requested channel of the internal ADC (this is known as the DXP "adc rule", typical adc rule values are between 5% and 10% of the ADC full scale), then it adjusts theveryfinegain so that all channels display the peak in the same MCA channel. It expects the energy of the most intense line in the spectrum, the adc rule (default is 5), and the acuisition time to be used in each iteration. Example: ADC/DXPALIGN Energy AdcRule Time/Iteration

ADC :

/DXPCALIBRATE

This run sequentially the RESET and TRACKRST calibration to ALL the DXP modules. The RESET calibration measure the pre-amp reset voltage range and find the input voltages in term of tracking DAC settings and computes the correct value for the parameter OFFDACVAL (the DAC Offset).The TRACKRST calibration measure the correct value to be set on the tracking DAC after a preamplifier reset (TRACKRST ~= standard "reset" voltage). Example: ADC/DXPCAL

ADC :

/DXPFWHM

This calculates the FWHM of the LARGEST peak in the last acquired DXP spectra. It requires the peak energy (default is Cu Kalpha 8048 eV) to convert the FWHM in channel into FWHM in eV. If the channel specified is 0 it will calculates it for all channels. If no arguments are given it will prompt for the calibration energy and it will calculate FWHM for all channels The output from DXPFWHM is also written to SUPER.LOG. Example: ADC/DXPFWHM Chan Energy

ADC :

/DXPFF

Set or read the DXP Fast Filter parameters. To SET the DXP Fast Filter parameters it expects an element # and 4 arguments. The parameters are respectively FASTLEN FASTGAP MINWIDTH MAXWIDTH. They represent respectively: the lenght of the Fast Filter averaging interval in 50 ns unit, the lenght of the gap of the Fast Filter in 50 ns unit, the minimum width a pulse must have to be accepted as a real pulse and not just a noise spike, the maximum width a pulse should not exceed to be accepted as single pulse instead of piled-up pulse. A reasonnable set to start with is Fastlen=4, Fastgap=0, Minwidth=3, Maxwidth=16. If the element number is 0 the same values are set for all elements. Example: ADC/DXPFF chan Fastlen Fastgap Minwidth Maxwidth To READ the current parameters, NO ARGUMENT is needed. You will get a listing of the current values for all elements. Example: ADC/DXPFF

ADC :

/DXPGAIN

Set or read the DXP Gain parameters. To SET the DXP gains parameters it expects an element # and 3 arguments. The parameters are respectively COARSEGAIN,FINEGAIN and VRYFINGAIN.See the DXP user manual to determine reasonnable gain settings for the preamplifer you are using. If the element number is 0 the same values are set for all elements. Example: ADC/DXPGAIN chan Coarsegain Finegain Vryfinegain To READ the current parameters, NO ARGUMENT is needed. You will get a listing of the current values for all elements. Example: ADC/DXPGAIN

ADC :

/DXPINIT

It download the FiPPi instruction for the requested decimation and the DSP executable code. After the DSP code is downloaded even if most parameters will not be erased from the DSP memory some will be set differently (e.g. the gains). Once parameters are reset to reasonnable value the DXP needs to be recalibrated (e.g. ADC/DXPCAL). Example: ADC/DXPINIT

ADC :

/DXPLOAD

This will load a new DXP.CONFIG file. Whichever file you enter, it first copies that file to your sys$login: directory, renaming it to DXP.CONFIG, then loads the file. You can give a path to the file if it isn't in your current default directory. Example: ADC/DXPLOAD SSRL$LOCAL:[DXP]CUEDGE_80KPS.CONFIG will copy that file to sys$login:, renaming it to DXP.CONFIG, and load that into the modules.

ADC :

/DXPMCA

Set or read the DXP MCA parameters. To SET the DXP MCA parameters it expects an element # and 2 argument. The parameters are respectively MCALOWBIN and BINPERADC. MCALOWBIN allows the spectrum to be offset (i.e. binning to start at some x-ray energy value other than zero). BINPERADC contorls the DSP conversion of the pulse height calculated in the FiPPi to the appropriate MCA bin. See DXP user manual for details on how to set this parameter. Typical values are 4096, 8192 and 16384. If the element number is 0 the same values are set for all elements. Example: ADC/DXPMCA chan Mcalowbin Binperadc To READ the current parameters, NO ARGUMENT is needed. You will get a listing of the current values for all elements. Example: ADC/DXPMCA

ADC :

/DXPPEAK

Set or read the peaking time of the DSP. To SET the peaking time 3 arguments are needed: the element number, the desired peaking time PkTime in musec, and the RiseTime of the preamplifier pulse in musec. If the requested risetime is -1 the program will assume a reasonnable value for risetime. The slow filter parameters are calculated from: PkTime(musec)=0.5*(2*SLOWLEN+SLOWGAP)*(2**DECIMATION)*.050 Risetime(musec)=SLOWGAP*(2**DECIMATION) PEAKINT=SLOWLEN+SLOWGAP (for DECIMATION =0) PEAKINT=SLOWLEN+SLOWGAP+1 (for DECIMATION =2 or 4) PEAKSAMP=SLOWLEN+SLOWGAP/2-2 (for DECIMATION=0) PEAKSAMP=SLOWLEN+SLOWGAP/2-1 (for DECIMATION=2) PEAKSAMP=SLOWLEN+SLOWGAP/2+1 (for DECIMATION=4) A DXP calibration should be run after the program as reset the values (i.e. ADC/DXPCAL) To READ the peaking time NO ARGUMENT is needed. You will get a listing of the current values for all elements.

ADC :

/DXPREAD

Read a generic DXP parameter. This expects the element # and the name of the parameter. If the element number is 0, you get the values of that parameter for all the elements.

ADC :

/DXPSET

Set a generic DXP parameter. This expects the element #, the name of the parameter and the new value. If the element # is 0, you set the value of that parameter for all the elements.

ADC :

/DXPSF

Set or read the DXP Slow Filter parameters. To SET the DXP Slow Filter parameters it expects an element # and 4 argument. The parameters are respectively SLOWLEN SLOWGAP PEAKINT PEAKSAMP. They represent respectively: the lenght of the Slow Filter averaging interval in 50*(2**DECIMATION) ns unit, the lenght of the gap of the Slowfilter Filter in 50*(2**DECIMATION) ns unit, the inspection interval time for slow channel pulse pile-up, the time interval for slow channel data capture in the FiPPi. A reasonnable set to start with can be obtained from ADC/DXPPEAK. If the element number is 0 the same values are set for all elements. Example: ADC/DXPSF chan Slowgap Slowlen Peakint Peaksamp To READ the current parameters, NO ARGUMENT is needed. You will get a listing of the current values for all elements. Example: ADC/DXPSF

ADC :

/DXPTHRESHOLD

Set or read the DXP energy Threshold parameter. To SET the DXP threshold parameter it expects an element # and 1 argument. A reasonnable set to start with is THRESHOLD = 30. If the element number is 0 the same values are set for all elements. Example: ADC/DXPTHRS chan Threshold To READ the current parameters, NO ARGUMENT is needed. You will get a listing of the current values for all elements. Example: ADC/DXPTHRs

ADC :

/DXPWIN

Display the ROIs in the spectrum, either as a coincidence (i.e. display only the contents of the bin that are within the ROI) or an anticoincidence (i.e. display only the contents of the bin that are not in the ROI). This expects the element # the gate chosen (0= ANTICOINCIDENCE 1= COINCIDENCE) and the roi chosen.

ADC :

/DXPWRITE

This will save the current DXP configuration file to disk, with the name you give it. That way if you have a set or ROI's that you like or you have tweaked a parameter you can save your work for next time. Example: ADC/DXPWRITE MY_BEAUTIFUL_ROIS.CONFIG

ADC :

/DXPYMEM

This command can be used to read the 0:512 Y memory area. The y-memory area will contain two different sets of information depending on what you have done prior to the DXPYMEM command. If you perform a COUNT first, the y-memory will contain the baseline histogram, but if you perform a ADC/DXPOFFSET, the y-memory will contain the offset(OFFDACVAL) histogram. When the system is working properly the baseline spectrum should be essentially Gaussian in nature since it represent the electronic noise spectrum of the preamplifier/ ASC (Analog Signal Conditioner - the input stage of the DXP module). It is useful to compute the FWHM of the baseline histogram as it is a measure of the electronic noise (use FIT to compute FWHM). The FWHM in channel can be converted to eV using the formula: FWHM(eV)=FWHM(channels)*(BINPERADC*SLOWLEN)/1728. There are two different uses of DXPYMEM, depending on your need: SUP> COUNT 1 SUP> ADC/DXPYMEM channel SUP> FIT For the ADC/DXPOFFSET case, the histogram will be centered if the OFFDACVAL parameter has been selected properly. Increasing the OFFDACVAL will shift the histogram towards lower values. Example: SUP> ADC/DXPOFFSET SUP> ADC/DXPYMEM channel

ADDFIL

Will add files together and write the sum out as a file. Useful primarily for EXAFS data. Just keep giving a file name at the prompt. When done, type CtrlZ and the sum file will be written with the name of the first file to be summed with an S appended to the extension, ie fred.028s. Note that the header of the resulting file is that of the last file to be summed, so one can get a sense of the extent of the files summed.

/ADC

Add ADC spectra. An S is appended to the extension of the first file summed.

/TDC

Add TDC spectra. An S is appended to the extension of the first file summed.

/EXAFSPAK

Write the output of the summing in a binary file format which can be read by Graham George's EXAFSPAK. The columns of data are just as they are in the SUPER file, energy followed by hex channel 1->n. The output file name is that of the first file with the extension changed to XAS, e.g. fred028.xas.

/CONCATENATE

Appends the contents of a second file to a first one. In case you want to make one very long file from several short ones. Note that Super/Splot can plot up to 16000 data, so if you concatenate a file longer than that you can no longer plot it in super.

ANGLE

Angle move combines a 2THETA and a THETA move. One must specify the new absolute scaled position of both motors, even if only one will move. The first specified angle is the 2THETA angle, the second is THETA. The syntax is ANGLE 15.,7.

ASSIGN

This is used to tell the program which motors to display on the screen. One can also change the number of digits after the decimal point with this facility. Certain motor names can cause problems. A motor name supercedes a command verb, so if you name a motor 'DISPLAY' you'll have a hard time plotting the data. Also motor names PSI,HVAL,KVAL,LVAL and RADIAL are dealt with in a non-standard way, so don't call your motors by those names unless you know what you're doing. You can have up to 24 motors in three banks of 8. If you want to have a combination motor as well as component motors assigned, always assign the combination motor (e.g. MONO) first. You can also change individual motors by using qualifiers (see below).

ASSIGN :

Qualifiers

ASSIGN :

/ADD

To append a motor onto the current list, use /ADD. The required fields are the FULL name of the new motor and the number of significant digits beyond the decimal. Thus SUP> ASSIGN/ADD HORZ 3 will add the HORZ motor and give it 3 digits after the decimal.

ASSIGN :

/INSERT

You can insert a motor into the existing list with the /INSERT command. In this case you need to give the position (1-24) where the new motor should be, the FULL name of the motor, and the number of significant digits beyond the decimal. Thus SUP> ASSIGN/INSERT 4,HORZ,3 will insert HORZ as the 4th motor, pushing the current 4-n motors up to 5-n+1.

ASSIGN :

/REMOVE

This will remove a motor from the list. You need only tell the program the name of the motor, e.g. SUP> ASSIGN/REMOVE HORZ

ASSIGN :

/REPLACE

This will replace a motor with a new motor. You need to tell it the position of the existing motor, the FULL name of the new motor, and the number of significant digits for the new motor, e.g. SUP> ASSIGN/REPLACE 5,VERT,3 will replace whoever is motor #5 with the VERT motor.

BACKLASH

To change the value of the motor backlash, type MOTOR_NAME/BACK new_val. The sign of the backlash is such that of the move removing the backlash, thus a positive backlash is employed on negative moves. For more information, see HELP MOVE.

BITPATTERN

This sets a bit pattern in Channel 0 of the Quad Output Register. Type the 1 and 0 settings for pins 1-16, e.g. BITPAT 110100011 sets pins 1,2,4,8,9 of channel 0 to be 0 Volts. All the other settings will be +5V. On some beam lines there is a patch panel from the output register which make the connections simple to make.

BRAGG

Bragg move moves the diffractometer motors to the H,K,L value entered as parameters in the command. The syntax is BRAGG 1.4,0.,0. If in PSI mode, BRAGG expects an angle as well, i.e. 0,0,2,30 means move to a 0,0,2 reflection with a PSI angle of 30 degrees.

BRAGG :

Qualifiers

BRAGG :

/ANGLE

to move all the diffractometer motors. In this case instead of entering HKL enter 2theta,theta,chi,phi.

BRAGG :

/YMAX

Move to the xvalue corresponding to the maximum of the previous scan. Not implemented for all scans.

BRAGG :

/CENTROID

Move to the xvalue corresponding to the centroid of the previous scan. Not implemented for all scans.

CALCULATE

Calculate the angles corresponding to a given h,k,l Syntax: CALCULATE 2,2,0 Note: calculate depends on what calculation mode the program is in. Which mode is listed on the screen next to the reciprocal lattice vector. See verb MODE for the different calculation choices. Note that if the PSI motor is inserted one needs to specify that in addition to the h,k,l values.

CALCULATE :

Qualifiers

CALCULATE :

/DSPACE

Will calculate the spacing between planes of a given h,k,l Syntax: CALCULATE/DSPACE 2 2 0

CHANNELS

To change the number of hex scaler channels recorded by the program, type COUNT/CHANNEL new_value.

CI

This is a synonym for INVERSECALCULATE

CIS

Do a constant initial state (CIS) scan. The input parameters are the Monochromator starting energy, the CMA starting energy (the difference being the initial state energy), The step-size (in eV), the number of points, and optionally, the time per point. If the time is omitted the default count time is used. This scan will only work if both MONO and CMA are assigned motors in your version of SUPER (See ASSIGN).

CLEAR

Clears the screen and updates the motor positions in the non-scrolling region.

COUNT

Count measures the countrate entering the detectors for the period specified by the TIME parameter (or entered with the count command) and the count mode. The count mode is one of /DOSE,/TIME,/ROCK. "Time" is interpreted differently for the three count modes, see the help for those qualifiers to understand the differences. When turning on a qualifier (e.g. /AUTO) the program will execute a count unless the /NOCOUNT qualifier is added. When turning off a qualifier (e.g. /NOSETBIT) a count is not executed. Exceptions are /SCALERS (/CHANNELS) and /READBIT, where counts do not occur.

COUNT :

More_than_one_hexscaler

If you are collecting data from more than one hexscaler, there is the problem of putting out the data to an 80 character screen. What I have chosen to do is to truncate the number of channels that are printed on the screen so that the lines don't wrap. On disk, of course, all the channels are written. Also, if LOG is turned on, all channels are written to SUPER.LOG.

COUNT :

Qualifiers

COUNT :

/AUTOMATIC

IF you have two clocks and you turn this switch on, then the program will interpret a "time" less than 10 seconds as seconds, and count in TIME mode, and a "time" of more than 10 seconds as a dose and count in DOSE mode. To turn this off, type COUNT/NOAUTOMATIC.

COUNT :

/BASE

Changes the time base which is used to convert hexscaler pulses to time. No count occurs when this command is entered. The syntax is COUNT/BASE 1000 If the output of the realtime clock is used as the input for the time count the BASE value is 262144. Note that the Hexscaler input must be changed to NIM if the signal will be collected directly from the RTC clock output.

COUNT :

/CALCULATED

This is a logical switch which, if turned on, will write the calculated actual count rate as the last column rather than the register data. It takes the count from channel 1 (ALWAYS!) and calculates the actual rate based on the absorption lengths you have entered. Thus, be sure to get them right. If the calculated rate exceeds 2E9 counts, the value printed (and written to disk) is negative and divided by 1.e6. Thus, a value of -34567 is actualy 34.567e9 counts. The plotting package knows how to interpret such numbers, so plots will appear normally. Turn off with COUNT/NOCALC

COUNT :

/CHANNELS

Changes the number of channels that will be read. Does not actually perform a count for this command. This is synonymous with /SCALERS. The syntax is COUNT/CHANNELS 4 Note, this value is independent of whether the input register is being recorded as well. One can have up to 42 channnels (given 7 hex scalers). For scattering experiments, channel 1 is expected to be the detector signal, Channel 2 is expected to be the time, Channel 3 is the monitor channel.

COUNT :

/DARK

This is used to measure the dark current for ion chambers. It will prompt you to hit a carriage return (after you close the shutter) and then will count. If you enter a time for this measurement it won't become the default count time. The data are recorded on disk as a count rate (signal/second), just as they are reported on the screen. This is also a logical switch for writing these offsets to disk at the top of the file just after the starting motor positions. To turn off this option, type COUNT/NODARK. NOTE: COUNT/OFFSET will subtract offsets from the data BEFORE writing to disk.

COUNT :

/DOSE

Tells the computer that you are counting for a # of pulses. This is recorded in the data file. Alternatives are TIME and ROCK. In this mode the input to the realtimeclock module (RTC) is from the I0 detector. For many beam lines there are 2 clocks, one for I0, the other for time. Time is interpreted as follows: 14= 1x10^4 monitor counts, 35= 3x10^5 monitor counts. Minimum is 11.

COUNT :

/OFFSET

This is a logical switch for subtracting offsets (determined with COUNT/DARK) from the data prior to writing to disk. To turn off, type COUNT/NOOFFSET. To set the offsets, use COUNT/DARK. The two switches are independent, i.e. one can either write offsets at the top of the file or subtract them from the data or both. Offsets are recorded on a per-second basis. If /OFFSET is turned on and a scan is performed in DOSE mode, the results will be incorrect.

COUNT :

/LOG

This is a logical switch which writes the results of a COUNT to SUPER.LOG. The first line is a time stamp, and the reciprocal lattice position (if any). The second line is the position of all the motors. The third line is the hex scaler values. Turn off with /NOLOG.

COUNT :

/NOADC

Turns off counting of the ADC for this one count.

COUNT :

/NOCOUNT

This will override the count when setting switches, e.g. COUNT/SETBIT/AUTO/NOCOUNT will turn on SETBIT and AUTOMATIC without executing a count.

COUNT :

/PAUSE

Sets the time delay after a move has finished before the counting starts. The default is 0.25 seconds. This delay allows for settling of the monochromator. Syntax: COUNT/PAUSE 0.25

COUNT :

/READBIT

With this set rather than counting for a certain dose or time counting will continue UNTIL a logical true is sent to the second bit of the input register. (TTL true= 0 Volts). This overrides the /TIME,/DOSE, or /ROCK switches. This can be used to handshake with an external device which is doing the data collection. (SEE /SETBIT). A count does not occur when this is turned on or off. To turn off, use COUNT/NOREADBIT.

COUNT :

/REGISTER

This command tells the program there is a quad input register in the CAMAC crate and that the zeroth register should be read and translated into an integer value and recorded as data. The logical QIR$1 needs to be defined to be the correct slot number. The program adds one to the number of scalers in the system. The integer value written to disk is the sum of 2^n for each input. On some beam lines there is a patch panel which connects a buss bar to the register, so merely connecting your inputs to the buss bar will suffice. A logical 1 is 0V, so your device should ground the input when it is "on". The filters are channels 17-20. Of course, the computer thinks that channel 17 is actually 16, so having the first filter in results in an integer value of 65536. Turn off with COUNT/NOREG

COUNT :

/ROCK

Tells the computer that you are counting while moving a motor. This is recorded in the data file. Alternatives are DOSE and TIME. The program will prompt you which motor it will rock if you don't include the motor in the command line. In ROCK mode the TIME value is parsed as follows. If the "time" is 25, then the hexscalers will collect data while the motor scans +/- 1 degree about the center position for 5 iterations. An iteration is defined as move positive 1/2 the value, move negative the full value, then move positive 1/2 the value again. Thus 5 iterations is actually 9 full sweeps back and forth and a 1/2 sweep to start and finish the move. After the motor has stopped moving, the hexscaler stops counting. There are small variations in time of counting, but by looking at I/I0 the signal should be properly normalized.

COUNT :

/SCALERS

Changes the number of channels that will be read. Does not actually perform a count for this command. This is synonymous with /CHANNELS. The syntax is COUNT/SCALERS 4 Note, this value is independent of whether the input register is being recorded as well. One can have up to 42 channnels (given 7 hex scalers). For scattering experiments, channel 1 is expected to be the detector signal, Channel 2 is expected to be the time, Channel 3 is the monitor channel.

COUNT :

/SCATTER

This changes whether the second channel of the hexscaler is reported as a "time" rather than as counts. To report as counts, type COUNT/NOSCATTER; to report as time, type COUNT/SCATTER.

COUNT :

/SETBIT

With this set the second bit of the output register is set just before counting starts and is lifted just after counting starts. This can be used to coordinate with some external device which is also counting data. The same "TTL pulse" occurs at the end of counting as well.

COUNT :

/TIME

Tells the computer that you are counting for a length of time. This is recorded in the data file. Alternatives are DOSE and ROCK. TIME mode expects the pulses into the realtimeclock to come from the 262khz clock in the RTC module. The user must change the input A of the RTC. In this mode, TIME is in seconds, e.g. TI=2 will mean count for 2 seconds. This mode change is recorded both to SUPER.LOG and in each data file.

CROSSHAIRS

This is a synonym for CURSOR

CT

This is a synonym for COUNT

CTRL_C

^C (control C). This will stop all motors from moving. It will also abort a count if typed during a scan, without loss of data. Note that while the 4 diffractometer motors have ramp-downs on abort, the mono and table do not, so you are likely to lose steps if you abort a mono move. In general it is better not to abort a move if possible.

CTRL_Z

^Z (control Z) is used to get back to the SUP> prompt if the program takes you somewhere you don't want to go. For instance, if you type in the wrong scan numbers and don't want to perform the scan, when the program asks for a file name type ^Z to get back to the prompt. You can also abort scan with a ^Z at the comment line, although an empty file will be written to disk.

CURSOR

Used after plotting a scan to determine the position of a peak for instance. Cursor works differently for Xwindows, VT125 and TK4100 modes.

CURSOR :

VT125

Use the arrow keys to move the crosshairs horizontally and vertically. By entering a number from the keypad one can change the step size that a single arrow key makes. 0 moves the crosshairs the least, 9 moves them the most. The current position of the crosshair is listed in the third row of the non-scrolling region on the right hand side.

CURSOR :

XWINDOWS

The mouse is used to position the cursor in the Xwindow, clicking on the left-hand button on the mouse will report the position in the decterm window. To finish, click on the right-hand button of the mouse.

CURSOR :

TK4100

The mouse is used to position the cursor in the TK4100 screen. To turn off, click in the VT220 screen and hit several carriage returns. This doesn't work as cleanly as I would like.

Data

The data from the hexscalers is written to disk as integer values. In the case of a very large count (larger than 2e9 counts) the value is recorded as a negative value which is multiplied by 1.e-6. that is, 1e10 would be written as -1e4 on the screen and in the data file. The plotting will interpret a negative value properly for a signal channel (and not as part of a meta-channel).

DARK

To set the dark current (offsets) for ion chambers, use COUNT/DARK.

DEFINE

One can create up to 24 aliases within SUPER. These can be used either to emulate other programs (SPEC, other versions of SUPER) or to concatenate commands. The latter is done by delimiting commands with the "+" key. So DEF BR BRAGG+COUNT will execute first the BRAGG move, then the COUNT command. Variables passed in the BR command are parsed by the first of the actual commands, so BR 1 0 0 will move to h,k,l of 1 0 0 and then count. When executing aliases the verb must exactly match the definition. Verbs limited to 8 letters, equivalences limited to 40 letters.

DEFINE :

Examples

Many people have found the following to be useful: DEF FLOOP DIPS/PR+FIT/AUT DEF PR DIS/PR+DIS/NOPL

DEFINE :

Undefining

To turn off an alias, use UNDEFINE, as in UNDEFINE BR.

DEFINE :

Current_definitions

SHOW ALIAS will show the current list of aliases

DELAY

Pauses the program for a certain number of seconds. This is primarily useful in INDIRECT command files, where one would like to pause between the execution of a command or set of commands. There is only one parameter, the number of seconds to wait. The maximum number of seconds is ~84000, the number in 24 hrs.

DISPLAY

Plot a previously collected scan on the screen. Program defaults to the most recently collected scan. Can plot up to 16k pts. To see the current plotting choices, type DISPLAY/NOPLOT. Some are logical switches and affect all files until turned off, others only affect the one file. Check each to see. Note that you can change the logical switches and not plot a new file by combining several qualifiers with the /NOPLOT qualifier, i.e. DIS/CHAN=2/RAT=3/NOTRAN/NOPLOT. See Parameters for more detail.

DISPLAY :

Parameters

The only parameter is a file name. The program defaults to the most recently collected file. For scans with the same file name but a different extension type ".123" rather than "file.123". By including directory specifications other files can be plotted. A "File not found" either means what it says or that you have insufficient privilege to read the file for plotting. If you would like to look at a set of old files (say, during a time while the machine is filling) you can change the default file name with the FILE FRED.100 command. Then you can look at all the FRED files by just typing the extension, e.g. .123. After you are done looking at old files return the default file to the right name (FILE MORTIMER.187) and the next scan will prompt you for the right default. If you would like to look at the last file of another series type the name without dot or extension and it will be plotted. Note that this doesn't change the default file name. The asterisk "*" is interpreted to mean the current default file.

DISPLAY :

Qualifiers

DISPLAY :

/ADD

Defines a second channel which will be added to the channel defined by /CHANNEL. The sum of the two channels is plotted. Turn off with /NOADD.

DISPLAY :

/ASCII

Writes a file of x,y pairs separated by commas. Concatenates the file name and adds .csv as the new extension. If there is a ratio channel, the output is multiplied by the average value of the monitor throughout the scan. If there isn't a ratio channel, you get the signal directly.

DISPLAY :

/BIN

Create output file of x,y values in binary (bien) format. This is not a logical switch, it only effects the current scan.

DISPLAY :

/CHANNEL

Is used to choose which channel is plotted as Y. Channels are from 1-6, not 0-5 as is listed on some hexscalers. Note, the program can deal with up to 7 hex scalers, 42 channels, so reference to chan 1-6 is merely illustrative for the first hexscaler. Syntax: DIS/CHA=3 will plot channel 3 from now on. To determine the present logical switch settings, type DISPLAY/NOPLOT

DISPLAY :

/DEFAULT

Resets the plotting values as: channel=1, no ratioed channel, no transmission channel, no add channel, line plots, linear scale, no fixed limits, plot full x-range, Integer scans plotted with largest delta as x-range.

DISPLAY :

/DERIVATIVE

Plots the derivative of the scan, using the current settings for /CHANNEL,/RAT,/TRAN, etc. Note that if LOGPLOT is set, you will get the log of the derivative, too. Note that the code takes a 15 point 1st derivative and a 17 point second derivative, so the scans need to be significantly longer than that to work. 50 seems like a good minimum.

DISPLAY :

/DIVIDE

This plots the ratio of the previous data set divided by this data set. A way of looking at the ratio between two scans, rather than the ratio of two channels within a scan. The two files must have the same number of data points. For looking at the ratio between two channels of a single file, use /RATIO.

DISPLAY :

/EXAFSPAK

This has been implemented as ADDFIL/EXAFSPAK, where a SUPER data file can be output in the binary file format readable by EXAFSPAK. For technical reasons, it was easier to put it as a qualifier for ADDFIL than to put it here in DISPLAY. Note that you can simultaneously sum spectra and output them in EXAFSPAK format.

DISPLAY :

/GSAS

Generate a datafile in a format acceptable to GSAS, the LANL Rietveld analysis package. The output file is the input file with an extension of .HIS, e.g. test.032=>test032.his. If you normalize the data (with RAT=n) the GSAS version will multiply the data by the average of the ratioed channel, so that the result will give reasonable esd's.

DISPLAY :

/HEADER

Types all the header lines of the file to the screen, without plotting the data. Useful for seeing the initial motor positions.

DISPLAY :

/ID

For integer scans, plots the largest of deltaH, deltaK or deltaL as the x-axis. This is the default integer plotting mode. It is a logical switch with the other choices (IH,IK,IL,IM).

DISPLAY :

/IH

For integer scans, plots deltaH as the x-axis. It is a logical switch with the other choices (ID,IK,IL,IM).

DISPLAY :

/IK

For integer scans, plots deltaK as the x-axis. It is a logical switch with the other choices (ID,IH,IL,IM).

DISPLAY :

/IL

For integer scans, plots deltaL as the x-axis. It is a logical switch with the other choices (ID,IH,IK,IM).

DISPLAY :

/IM

For integer scans, plots the magnitude of the vector in inverse angstroms as the x-axis. It is a logical switch with the other choices (ID,IH,IK,IL).

DISPLAY :

/LINE

Plots a line through the data points. The alternative is points enabled by /POINT. This is a logical switch setting, so it will remain in force until DIS/LINE is entered. To determine the present logical switch settings, type DISPLAY/NOPLOT

DISPLAY :

/LOGPLOT

Plots the y values as log10(y). This is a logical switch, so all successive plots will be plotted as log10(y) until the negated command "/NOLOG" is typed. To determine the present logical switch settings, type DISPLAY/NOPLOT

DISPLAY :

/NOPLOT

By including NOPLOT one can change plotting parameters without having to actually plot a file. This will also type the logical switch settings on the screen. If the ratioed channel=0, it means NORAT is in effect. If the Tran chan= 0, then NOTRAN is in effect. If an INDIRECT command file is being run, DISP/NOPLOT will change settings without listing them, so you can do an intricate set of overlays and return the settings to their original condition at the end. NOPLOT is also used to terminate a set of plots to be printed (with the DISPLAY/PRINT option).

DISPLAY :

/OVERLAY

Overlays a second plot on top of the first one, using the limits of the first plot. This is not a logical switch, it only effects the current scan.

DISPLAY :

/POINT

Plots the data as individual points. The alternative is enabled by /LINE. This is a logical switch setting, so it will remain in force until DIS/LINE is entered. To determine the present logical switch settings, type DISPLAY/NOPLOT

DISPLAY :

/PRINT

DISPLAY/PRINT has been replaced by PRINT. See HELP PRINT.

DISPLAY :

/RATIO

Plots the ratio of two channels. DIS/RAT=3 will plot (chanI/chan3). ChanI is changed using the /CHAN switch. To turn off ratio, type DIS/NORAT. Note that channel numbers are from 1-6 rather than 0-5, as is sometimes shown on the hexscaler. To look at the ratio between 2 files, use /DIVIDE. To determine the present logical switch settings, type DISPLAY/NOPLOT

DISPLAY :

/RESCALE

Overlays a plot on the current plot, rescaling the y values to fit the plot on the screen. This is not a logical switch, it only effects the current scan.

DISPLAY :

/SECOND

For A0 scans and SIMULTANEOUS (S) scans, plots the second motor as the x-axis rather than the first motor. As LINEUP/RADIAL looks like an S scan on disk, works for that scan as well.

DISPLAY :

/SUBTRACT

This will subtract the data from a file from the data of the previous file. This is not a logical switch. The number of points must be the same for both files. This only effects the plotted data, not the data file itself. Will work in conjunction with /ratio, etc.

DISPLAY :

/SUPPRESS

This has been superceded by /YMIN, as YMIN allows both 0. and other values. See /YMIN for details.

DISPLAY :

/SWITCH

This is the same as NOPLOT. It shows the current plotting switches without plotting a file.

DISPLAY :

/TK4100

One of the three display modes for plotting scans. The others are

DISPLAY :

/VT125 and /XWINDOWS. SCAN/UPDATE only works in /XWINDOWS mode.

DISPLAY :

/TRAN

Plots the natural log of the channel defined by /CHANNEL divided by the channel defined in /TRAN. This is useful for transmission EXAFS data. Syntax: DIS/TRAN=3 will plot the data as ln(chan3/chanI). ChanI can be changed by the /CHAN switch. If you would like to see ln(1/chanI) set the /CHAN channel equal to the /TRAN channel. To change back to regular plotting style, type DIS/NOTRAN. Note that channel numbers are from 1-6 rather than 0-5, as is sometimes shown on the hexscaler. To determine the present logical switch settings, type DISPLAY/NOPLOT

DISPLAY :

/TYPE

List the x,y values on the screen rather than plotting. This is not a logical switch, it only effects the current scan. If you want a hard copy of a listing, you can type CTRL-F2 and the vt240 will run in "print-along" mode, printing everything that is typed on the screen. Typing CTRL-F2 again will turn off print-along mode.

DISPLAY :

/UPDATE

To turn on or off automatic scan updating. This is the same command as SCAN/UPDATE or SCAN/NOUPDATE.

DISPLAY :

/VT125

Sets the display mode to be the terminal screen and uses REGIS graphics. This is the default mode, but you can't use SCAN/UPDATE in this mode. See DIS/XWINDOW to use SCAN/UPDATE. Another choice is /TK4100

DISPLAY :

/WRITE

Create output file of the x,y values in x,y ASCII format This is not a logical switch, it only effects the current scan. The first line is the number of points in the scan.

DISPLAY :

/XCHAN

This will plot one of the Y-channels as the X-array variable. One cannot take the ratio, or modify that channel in any way. It might be useful to plot signal vs. LVDT signal, or some such. Tom R. asked for it. Turn on with /XCHAN=n, Turn off with /NOXCHAN.

DISPLAY :

/XFULL

This is a logical switch between plotting the full x-range and plotting only the x-range collected so far. Useful for seeing narrow peaks that occur in the data early in the collection range. Turn off with /NOXFULL

DISPLAY :

/XLOG

This is a logical switch for changing between plotting the x-values linearly and log-based 10. Turn off with /NOXLOG.

DISPLAY :

/XMIN

Defines a minimum x-value for plotting which is constant from scan to scan. This is a logical switch which is turned off with /NOXMIN. Usage: DISPLAY/XMIN=2.5 To determine the present logical switch settings, type DISPLAY/NOPLOT

DISPLAY :

/XMAX

Defines a maximum x-value for plotting which is constant from scan to scan. This is a logical switch which is turned off with /NOXMAX. Usage: DISPLAY/XMAX=40. To determine the present logical switch settings, type DISPLAY/NOPLOT

DISPLAY :

/XWINDOW

If you are running from an X-terminal (and not set host 0), then you can plot your data in an X-window. Super uses the pgplot library for its xwindow plotting, so there is a separate icon which pops up on the screen, followed by the x-window. If DIS/XWIN is turned on, then you can get real-time plotting of your scan by turning on SCAN/UPDATE. The other choices for plotting are /VT125 and /TK4100. SCAN/UPDATE only works in /XWIN mode. It requires that the DECW$DISPLAY logical be defined, so if you set host 0 from a terminal, your new session won't have that automatically defined.

DISPLAY :

/YMIN

Defines a minimum Y-value for plotting which is constant from scan to scan. This is a logical switch which is turned off with /NOYMIN. Usage: DISPLAY/YMIN=2.5 SETTING YMIN=0 IS THE SAME AS THE OLD NOSUPPRESS QUALIFIER To determine the present logical switch settings, type DISPLAY/NOPLOT

DISPLAY :

/YMAX

Defines a maximum y-value for plotting which is constant from scan to scan. This is a logical switch which is turned off with /NOYMAX. Usage: DISPLAY/YMAX=1000. To determine the present logical switch settings, type DISPLAY/NOPLOT

EDIT

Edit a file using the EDT editor. Defaults to sys$login: for the directory and '.ind' for the extension. The editor used here, in NOTE/EDIT and IND/EDIT is EDT. The commands for exiting from the editor are: ^Z (Control-Z) gets you to the command prompt, which is a '*' at the bottom of the page. Typing 'exit' will write the contents of the buffer to the file. Typing 'quit' exits the editor without saving anything. EDT uses the keypad to select words and move around the screen. To learn how to use the EDT editor, check the VMS manuals. One can get by in EDT using the cursor keys; Once in EDT, typing the PF2 key will show the numeric keypad and its functions.

EXAFS

For the EXAFS user, you may want to modify SUPER to make it more friendly to your kind of experiment. First, you should turn off the diffractometer calculation mode, by typing MODE/NODIFF. This removes the HKL from the top of the screen. You may want to remove extraneous motors, using the ASSIGN command. Typically, you would have MONO, TABLE, HORZ and VERT (sample positioner motors) as the only motors in the system. For most users, 2 significant digits are sufficient for these motors.

EXAFS :

a_EXAFS

To move a motor without scanning, use the MOVE command. For scanning, typically, you will use 3 kinds of scans. M-scans, for moving individual motors to align them, E-scans (up to 3 regions with different delta-energy steps for each region) and X-scans (2 regions of constant delta-e, and one region of constant delta-k). For more info about these scans, see HELP SETUP ENERGY, HELP SETUP XSCAN, and HELP SETUP MOTOR. To check the count rate, type COUNT. To change the count time, either use COUNT or TIME. You can change the name of your data files using FILE. The header line of each data file includes the name of the file, the date and time, a SAMPLE name and comment. The SAMPLE name is for those things that don't change from scan to scan, whereas the comment is for those things that do.

EXAFS :

b_EXAFS

For scattering experiments, the second channel of the hex-scaler is typically a constant frequency input and is used as a clock. You may prefer to turn that feature off by typing COUNT/NOSCATTER, which reports the second channel as counts rather than as time. COUNT/CHANNEL sets the number of hex-scaler channels recorded to disk. You should also be sure that you are in TIME mode by typing COUNT/TIME. The alternative is DOSE mode, which is only a choice on scattering beam lines. Most beam lines only have a single real-time-clock, so they are set up for time mode.

EXAFS :

c_EXAFS

To display the data, run SPLOT in a separate Decterm window. SPLOT and SUPER talk to each other, and share the same plot parameters. Use DISPLAY to see an old file (or change plot parameters). Use UPDATE to see the current file. See DISPLAY/PRINT for how to print a hard copy of the curve. If you are running a transmission exafs experiment, you may want to look at the data as ln(I0/I). This can be done by (assuming I0 is in channel 3 and I is in channel 1) typing DISPLAY/CHAN=1/TRAN=3/NOPLOT. From then on, each time you plot data (either with UPDATE or with DISPLAY) the data will be plotted as ln(chan3/chan1). Warning!! Some hex scalers have channels listed from 0-5 rather than 1-6. These notes always refer to channels as if they were 1-6.

EXAFS :

d_EXAFS

One can determine the dark-current of the keithleys using the COUNT/DARK command. These results will be written as part of the header of each data file. COUNT/(NO)OFFSET will change whether the data written to disk has these offsets already subtracted or not. Most exafs users scan the same sample multiple times and want to see what the averaged data looks like. This can be done using the ADDFIL command. The resulting file will have the name of the first file in the series with an 'S' appended to the extention and the header of the last file in the series.

EXIT

Exits the program, writing variables to SUPER.PARAMETERS and recording current positions to SUPER.LOG. END and QUIT also work.

FILENAME

Changes the name used for the data files without having to run a scan. This is useful when changing samples so one doesn't forget to change the name as well. This way lineup scans can be run as the first scans for a new sample and have the proper name. If the file name is entered without an extension AND NO DOT and there are no files in the directory by that name the extension '.001' is chosen. If files already exist with that name, the filename with the highest numerical extension is chosen. Syntax FILE NEW_NAME.108 sets the default file to new_name.108. FILE NEW_NAME does a DIR and finds the latest version of NEW_NAME and chooses that. FILE NEW_NAME. (with a dot on the end) will result in the new file name being NEW_NAME.001. Note that FILE works in SPLOT as well, but it changes the name of the file for scanning as well, so use the command wisely.

FIT

Will fit a spectrum with up to 4 peaks and a linear background. Choices of peak shape include pure lorentzian, pure gaussian, or a sum of gaussian and lorentzian. There is also a fit to a linear background. What is printed out is the slope of the line and the value of the line at the peak position, i.e. y(xpos). One can also chose a constant peak width for multiple peak fits. Results are printed on the screen and optionally written to the log file. FIT must follow DISPLAY or UPDATE. FIT NOW IS THE SAME AS FIT/AUTO, i.e. IT ATTEMPTS TO FIT ONE PEAK. To fit up to 4 peaks, use FIT/NOAUTO.

FIT :

Qualifiers

FIT :

/AUTO

Will attempt to fit a peak, including linear background, without prompting for any parameters. Peak shape defined by /FUNCTION switch. THIS IS THE SAME AS FIT

FIT :

/NOAUTO

Will allow a fit of up to 4 peaks.

FIT :

/FUNCTION

Sets the curve shape for the auto fitting procedure. Choices are 0=Gauss, 1=Lorentz, 2= Voigt. Syntax requires an equal sign, e.g. FIT/FUN=2.

FIT :

/REFIT

Allows you to fix some of the previously fit variables and refit the remainder. There are 4 variables per peak, so an example of refitting would be to fit 3 peaks with pure gaussians, then on refit you would enter 1,2,3,5,6,7,9,10,11 to hold fixed the position,height and width and just allow the fraction Lorentzian to vary.

FOLLOW

Follow is used to tell the computer to monitor the positions of the motors continuously and update the screen with their positions. This is useful when performing a manual move of the motors using the toggle switch on the Stepper Motor Controller in the CAMAC Crate. I would suggest you use TWEAK instead.

Food

Pastrami/Swiss sandwiches and Anchor Steam at the Dutch Goose(854-3245) Su Hong(togo)(322-4631) esp. General's chicken, Dry-brazed beans, KunPao prawns; Ramona's(326-2220)(R'sToo=322-2181) or Applewood 324-3486 for Pizza, although Tony and Alba's(968-5089) is the best (albeit further). If really in hurry, Round Table(854-1140) on the Alameda across from the Goose. Luttikens(854-0291) for good big sandwiches (on the Alameda past the Goose). Mextogo (321-9669) good burritos. Casa Isabel on Park near California for sit-down Mexican. Marco Pollo (across from the Goose) for chicken&ribs to go(854-8244).

General_Hints

These are selected topics which you might want further info about.

General_Hints :

Home_directory

Each user is given two directories. The files which you would like to keep permanently between runs should be kept in your login directory. This is typically $USER:[B_YOUR_NAME] and is referenced as SYS$LOGIN:. SUPER.PARAMETERS, which contains the 20 scans in SETUP and options such as scan mode, plotting mode etc. is stored there and files used in SCAN/FILE and INDIRECT commands which you would like to save for the next run should be transfered from $DATA:[B_YOUR_NAME]: to SYS$LOGIN:. Note that there is limited permanent storage allowed in SYS$LOGIN: so be judicious about what is saved between runs.

General_Hints :

Data_directory

Each user is given two directories. One is on $USER: and the other is on $DATA:. All data files are written into $DATA: with the user's directory name. This has been assigned the logical name $SUPER_DATA:, so if you want to see what files are in that directory, typing $ DIR $SUPER_DATA: will show you a list of the files. SUPER.PARAMETERS is stored on $USER:[B_YOUR_NAME], which has the logical name SYS$LOGIN:. Files you would like to preserve between runs can be stored here. This account has only a small storage allocation so data can't be stored there. Data in $SUPER_DATA: is not saved after you leave. Be sure you backup your data before you leave. (See BACKUP).

General_Hints :

Default_directory

When you first log on the default directory is SYS$LOGIN:. To change between directories use the command $SET DEFAULT new_directory. All data files go into $SUPER_DATA: (which is $DATA:[B_YOUR_NAME]) as does SUPER.LOG. SUPER expects to find .IND files and SCAN/FILE files on $SUPER_DATA:, so most of the time you will want to have $SUPER_DATA: as your default directory. When prompted for an IND or SCAN/FILE file name you can include the directory if the file is not in $SUPER_DATA:. Note that one can add a LOGIN.COM account which is executed on logging in. commands such as SET DEFAULT can be placed there so one is automatically in the proper directory.

General_Hints :

Current

The SPEAR current is available on a database on SSRL. This has been implemented into the program by recording the current on the line preceding the header line of a scan in the SUPER.LOG file. There are times, however, when either the SPEAR computer or SSRL is down in which case the current is recorded would be the last updated value. If you suspect that has happened try exiting the program and re-entering it, as the initialization of this feature only occurs at program startup. If SUPER seems to hang during startup, it may be that the node where SUPER gets its information is down. If it is likely to be down for a while, you may want to turn off current reporting. You can do that by $deassign/sys/exec sibyl_node

General_Hints :

1Backup

One can (and should) back up data regularly. The most convenient way is to back up to SSRL. You should have an account on that machine as well. To back up your files, first log onto SSRL and $ CREATE/DIR $TEMP1:[B_YOURNAME] creates a directory on a temporary disk $temp1:. Then create a series of subdirectories, e.g. $ CREATE/DIR $TEMP1:[B_YOURNAME.BACK01] $ CREATE/DIR $TEMP1:[B_YOURNAME.BACK02] etc. Now log off, and

General_Hints :

2Backup

$ COPY $SUPER_DATA:*.*;* SSRL::$TEMP1:[B_YOURNAME.BACK01]*/LOG Record the date and time you did it. Next time you back up, $ COPY/SINCE=01-APR-1992:19:30 $SUPER_DATA:*.*;* SSRL::$TEMP1- _$ :[B_YOURNAME.BACK02]*/LOG And each subsequent time you back up, do a copy/since=date etc. If all goes well, At the end of the run you will still have all your data on the beam line machine and you can create one last directory [.backfinal] on SSRL and do a complete backup of all the files to it. Then use FTP to send the files from SSRL to your host machine. You may want to send copies of the interim directories to your host machine as well. FTP is quite fast.

Hardware

These are a list of topics concerning the electronics used by the system

Hardware :

Stepper_motors

The stepper motors are run using Joerger SMC 24-A controllers or E500 stepper motor controllers. VAXMOTORS is an underlaying program which figures out what commands work for each controller and motor.All calls to motors within SUPER are through VAXMOTORS. Type HELP VAXMOTORS from DCL level (ie from outside the program) to get more info. The 24-A controllers have a soft abort feature so that typing Ctrl/C causes the motor speed to ramp down slowly and then stop.

Hardware :

Ion_Chambers

Occasionally one will need to use ion chambers rather than photo-tubes for data collection. There is a separate Fluke high voltage power supply in the rack for that purpose. The ion chamber output is amplified and turned into a voltage by a Kiethley current amplifier, then fed to a Voltage to frequency (V-F) converter in the NimBin above the CAMAC crate. The Kiethley output voltage is also displayed on the DVMs above the NimBin. The output of the V-F is then put into the hex counter (typically in slot 9 of the camac crate). The ion chamber high voltage is typically run at -300 V.

Hardware :

Photomultipliers

Generally data is collected using photomultiplier tubes. Their voltage is typically 700 V or so. As of 4/90 the 7-2 tubes were negative HV.

Hardware :

Solid_State_Detectors

For Anomalous scattering experiments an intrinsic Ge detector is often used. This detector needs a special HV power supply which has a remote shutdown option to protect the detector in case it warms up. The high voltage is typically -1500 V, but is listed on the detector, so check! It uses a spectroscopy amplifier, unipolar output, gain 500+10.5 at ~7000 eV, 6microsec shaping time. This signal can be put into the SCA module for selecting the right window. To help in setting windows a delay amplifier and a linear gate are needed. The output of the spectroscopy amp is teed into the SCA and the delay amp set to 3microsec. The output of the delay amp is put into the linear gate, and the output of the linear gate goes to the MCA. The enable of the gate is taken from the SCA window of interest. Thus only pulses with the right energy are sent to the MCA to be processed.

Hardware :

Device_Off_Line

Occasionaly one of the camac modules may be put "Off line". This will typically be accompanied by an error message: SYSTEM-F-DEVOFFLINE, device is not in configuration or not available this will occur if the module has been generating too many LAMs. To fix the problem, figure out which slot the device is in, and from outside the program type: $ CAMAC/RESET CMAn: where n is the camac slot number. Motor controllers, Hex scalers, real time clocks and QOR modules are all capable of generating LAM's. If a $CAMAC/SHOW CMAn: results in a "Yellow LAM limit set", then that device needs to be reset. (fix the problem first BTW).

Hardware :

Real_time_Clock

The real time clock (RTC) is used to inhibit pulses into the hex scalers when the program doesn't want them. When the program wants pulses coming to the hex scaler to be counted it loads a value into the register. While this value is non-zero the inhibit to the hexscaler is lifted. There are two modes for collecting data. In the most often used mode (DOSE) the hexscaler counts pulses for a certain number of I0 pulses. The scans include as their last value the number of pulses to collect. The alternative mode is to use a clock generator (the Joerger clock generator with several lemo connectors on it) which sends out pulses at timed intervals. This is TIME mode. The pulses either from the I0 detector or the clock generator are put into the INPUT A of the RTC. The value loaded into the register at the start of a count cycle is decremented until zero is reached. Typical I0 counting rates are 10k/sec, so the 10cps channel from the Joerger is a good choice for TIME mode. See COUNT for more info.

Hardware :

Calc_assumptions

For efficiency sake the subroutines performing the angle calculations between real and reciprocal space make certain assumptions about the motors. For the 4-circle calculations it assumes 2theta=motor 1, theta= motor 2, chi= motor 3 and phi= motor 4. In Psi mode, Psi= motor 5. For Z-axis calculations it assumes motors 1-5 are 2theta, theta, alpha, beta and stage, where stage is the translation of the beta rotary table. It also assumes alpha is fixed by the experimenter and sets beta to achieve the correct l value.

HELP

Lists these commands. To print out a hard copy of this file, type (from outside the program) $ print/queue=s07_ln03p ssrl$local:[super]super.hlp Note, if you are in bldg 131 you might prefer one of the printers in that building.

HISTORY

Use RECALL instead.

HVAL

This command treats a motion in the h-direction in reciprocal space as if it were a motor. One can type HVAL 2.3 to move to 2.3 in the h-direction, leaving k and l fixed. HVAL/REL .1 will move relative that amount. SEE KVAL AND LVAL.

INDIRECT

Executes an indirect command file. Most commands can be executed in this manner except for FOLLOW, etc. The default directory for the file to be executed is your login directory, (SYS$LOGIN:) The default extension is .IND. Syntax: IND SILICON.IND Up to 500 commands can be executed within a single ind command file. This is not a real limitation, as the last command can be to open the next .IND file. NOTE: This works in SPLOT as well as SUPER. Recursion is now possible, although the 500 line limit still holds. A variable can be passed into the ind file with @ (see /EDIT).

INDIRECT :

Qualifiers

INDIRECT :

/EDIT

Will put you into a full screen editor to create an IND file. Uses the EDT editor. (SEE Editor). One can pass a variable into the IND file by using the @ symbol. Thus, an ind file TEST.IND that says COUNT @ can have a different count time, e.g IND TEST 3 will result in a count for 3 seconds.

INDIRECT :

/TEST

This will check the grammar of an IND file to make sure there are no typos. Will NOT check whether a scan will hit limits.

INVERSECAL

Calculate h,k,l values given 2theta, theta, phi and chi values. If values are not entered will prompt, using the current values as defaults. Syntax: INVERSECAL 20,10,.1,.1

KVAL

This command treats a motion in the k-direction in reciprocal space as if it were a motor. One can type KVAL 2.3 to move to 2.3 in the k-direction, leaving h and l fixed. KVAL/REL .1 will move relative that amount. SEE HVAL AND LVAL.

LIMIT

Lists the upper and lower limits of all the motors. To change a limit, use the switch /HIGHLIMIT or /LOWLIMIT on a motor, e.g. THETA/LOWLIMIT 2. If you have (shame on you!!!) run into a hardware limit, you first have to move off the limit condition using the toggle switch on the Joerger SMC. Once the limit condition has been turned off you need to reset the hardware limit condition with, e.g. THETA/CLEAR to clear the hardware limit on the THETA motor.

LINEUP

Lineup scans quick scans for finding maximum signal by varying a single motor about the present position with all the other motors at their present positions. Parameters are motor name, step size, and number of steps on one side of present position that you want to start. Will scan 2n+1 times that number of steps. If time is specified as last parameter, uses it and accepts that as the new default time, otherwise assumes time value as specified by TIME parameter. Auto-increments file name and sample header. Syntax: LINE PHI,.02,10 will move PHI .2 degrees below its present position, and scan through to .2 degrees above the present position. Returns to the present position when done. The file format for an LINE scan is identical to an M(n) scan, so LINE PHI... looks on file like an M4 scan with the correct initial motor positions.

LINEUP :

RADIAL

One can do a radial lineup scan (moving both THETA and 2THETA) by telling LINEUP to move the RADIAL motor. You should enter the 2THETA delta angle and the program will move THETA by half that amount. The disk file looks like a simultaneous (S) scan.

LINEUP :

HVAL

One can scan in reciprocal space, making a pure h-direction scan, by LINE HVAL

LINEUP :

KVAL

One can scan in reciprocal space, making a pure k-direction scan, by LINE KVAL

LINEUP :

LVAL

One can scan in reciprocal space, making a pure l-direction scan, by LINE LVAL

LINEUP :

Qualifiers

LINEUP :

/CENTER

Logical switch between returning to starting position after the scan or returning to the centroid as calculated within the scan. The centroid is reported at the end of the scan. Turn off with /NOCENTER.

LINEUP :

/RETURN

This will return motors to their starting position if the previous command was a LINEUP command. Useful if you ctrlC out of a scan and want to get back to the starting point. This is not a logical switch

LINEUP :

/ROCK

Logical switch which if set writes the scan header as an R scan rather than an M scan. This only occurs for the diffractometer motors, not for the others (e.g. TABLE). Useful for recording HKL where the scan was performed instead of merely the single motor value. Turn off with /NOROCK.

Log_file

The program writes a log file on $SUPER_DATA:SUPER.LOG which records important events that occur in the program. Whenever a motor position is changed using /RESET the old and new values are recorded in the log file along with a time stamp. The header line and scan parameter line from each scan is logged. The SPEAR current is read from a database on SSRL and recorded just prior to the header line of each scan. Any changes to the orientation matrix are logged. You can also write comments to the log file (see NOTE). I have found this log file to be extremely useful in "playing back" a run afterwords. Each day the program is run the previous SUPER.LOG is renamed to be the creation date of that log file followed by .LOG. That is, on January 7, if SUPER is run, the log file from January 6 will be renamed 6_JAN_1992.LOG and a new SUPER.LOG will be created.

LUP

This is a synonym for LINEUP

LVAL

This command treats a motion in the L-direction in reciprocal space as if it were a motor. One can type LVAL 2.3 to move to 2.3 in the l-direction, leaving h and k fixed. LVAL/REL .1 will move relative that amount. SEE HVAL AND KVAL.

MODE

Changes calculation mode. A 4circle diffractometer has a variety of calculation modes because there is one extra degree of freedom in positioning the sample. Generally /Omega mode is used, which limits the theta axis to be 1/2 of 2theta. Alternatives are 2circle mode and phi mode. Also possible is Zaxis mode and Psi mode, for a rotation about a reciprocal lattice vector.

MODE :

Qualifiers

MODE :

/OMEGA

Omega=0 mode choses theta to be 1/2 of 2theta and uses phi to equal omega.

MODE :

/PHI

Phi=0 mode, sets theta=1/2(2theta)+ omega

MODE :

/2CIRCLE

Only considers the positions of 2theta and theta. As a result, only can calculate h,k,0 type reflections, and if you enter a non-0 l-value will calculate the zeroed version of it. Has a predefined orientation matrix with (1 0 0) at 0,0,0 and (0 1 0) at 90,0,0.

MODE :

/POWDER

Only considers the positions of 2theta and theta, but assumes the sample is a powder, so has no orientation matrix and calculates the 2theta value from all 3 of h,k,l, and sets theta to be 2theta/2. Thus one can BRAGG to a (2 2 1) reflection or calculate the 2theta position for a (3 3 3) reflection, but only 2theta and theta move. Note that what is reported at the top of the page is Q [A^-1], not h or k or l (or all 3), even though the ca and br commands are in reciprocal lattice units, not A^-1.

MODE :

/ZAXIS

For z-axis spectrometers consisting of incident angle(alpha), theta, 2theta and detector take-off angle(beta). If beta is an offset rotation it must be specified (MOVE/OFFSET_ROTATION). The distance of the translation table from the theta axis is a variable (See PARA/STAGE). In this geometry the alpha value is assumed fixed, and beta is set by the program to achieve the correct l value.

MODE :

/ZAXNOBETA

In some cases only 2theta, theta and alpha are present. In those cases an imaginary beta axis is assumed which is equal to alpha. In this case alpha is moved by the program such that alpha and the imaginary beta combined achieve the correct l value.

MODE :

/PSI

Calculates a rotation angle about a reciprocal lattice vector (RLV) depending on a reference RLV. It assumes the current RLV is the vector about which the rotation should occur. It will prompt you for the reference RLV (the direction Psi=0) which defaults to the current RLV with theta= theta+90. In Psi mode one can change the RLV that the Psi rotation refers to on the fly, but the reference RLV (the direction Psi=0) can only be changed explicitly, by typing MODE/PSI again and entering a new reference RLV. Note that the reference RLV doesn't have to be orthogonal to the rotation RLV, but it cannot be parallel.

MODE :

/NODIFF

This mode doesn't display the h,k,l values at the top of the screen nor does it do calculations for you. One can still move motors and do motor and angle scans, but integer scans don't work.

MODE :

/ALPHA

Calculates how to get to a reciprocal lattice vector based on keeping the angle of incidence on the crystal surface at a fixed value. This mode prompts you for a specific value of alpha. It works in concert with PSI mode, and the PSI motor is inserted into the motor list. Typical PSI values will be -90+/-1 degrees. The program prompts for the values of CHI and PHI which correspond to the surface normal aligned with the THETA axis. These are stored on disk and remembered.

MODE :

/BETA

Calculates how to get to a reciprocal lattice vector based on keeping the take-off angle from the crystal surface at a fixed value. This mode prompts you for a specific value of beta. It works in concert with PSI mode, and the PSI motor is inserted into the motor list. Typical PSI values will be -90+/-1 degrees. The program prompts for the values of CHI and PHI which correspond to the surface normal aligned with the THETA axis. These are stored on disk and remembered.

MODE :

/PWCHI90

Calculates how to get to a reciprocal lattice vector with Chi= 90. and Omega added to Theta. This is the "second setting" of Busing and Levy.

MODE :

/NWCHI90

Calculates how to get to a reciprocal lattice vector with Chi= 90. and Omega subtracted from Theta. This is the "first setting" of Busing and Levy.

MODE :

/ALEQBE

This mode fixes PSI equal to -90 degrees.

MODE :

/NOCELL

This mode forces a0,b0 and c0 to 2*pi and only reports Q, not h,k,l. If working with an amorphous material, this is the best "calculation" mode. Note that this also changes the orientation matrix, so don't go into this mode unless you have written down your old values.

MODE :

/OMFIXED

Fix omega to be a specific value. This is a generalization of the Omega= 0. mode.

MODE :

/PHFIXED

Fix Phi to be a specific value. This is a generalization of the Phi=0. mode.

MODE :

/THFIXED

Fix the theta axis to be a specific value. This is a variation of the OMFIXED switch, but in this case the physical axis doesn't move, whereas with OMFIXED THETA changes when 2THETA does.

MOVE

This is the command for moving a motor. The MOVE verb is not actually necessary, but is available as an option. One can either type MOVE 2THETA 10. or 2THETA 10. and the 2THETA motor will be moved to the absolute position of 10 Deg. If a motor name is typed without the MOVE or the position, the current position will be typed on the screen. Any of the motors listed across the top of the screen can be moved using this command. Three letters are sufficient to distinguish between various motors. There are a number of qualifiers, all of which change the database of the motor, such as changing its position or its limits.

MOVE :

Special Names

There are 4 special names for "pseudomotors". These are RADIAL, HVAL, KVAL and LVAL. For the RADIAL motor, you enter the 2THETA value, and the program moves the THETA motor 1/2 that value. For the HVAL motor, you give the h of h,k,l and it will move all four (for 4-circle modes) motors to change h to the new value. the k and l values are unchanged. For the KVAL motor, you give the k of h,k,l and it will move all four (for 4-circle modes) motors to change k to the new value. the h and l values are unchanged. For the LVAL motor, you give the l of h,k,l and it will move all four (for 4-circle modes) motors to change l to the new value. the h and k values are unchanged.

MOVE :

Qualifiers

MOVE :

/BACKLASH

Backlash defines the number of additional steps taken by the motor so that moves always end up going one direction. The value is scaled, not steps. The sign of the backlash is such that of the move removing the backlash, thus a positive backlash is employed on negative moves. The syntax is 2THETA/BACKLASH 0.1

MOVE :

/CIRCLE

Tells the computer that this is a circular motor, i.e. that 340= -20. This allows motors to take the shortest direction from one position to another. This is incompatible with having limits on the motor.

MOVE :

/CLEAR

If a motor runs into a hardware limit it must be cleared before it can be moved again. Due to inertia you are likely to have lost your position, so the first rule is: Don't run into hardware limits. The syntax is 2THETA/CLEAR

MOVE :

/DISABLE_LIMITS

To turn off limits for a motor, you use this switch. To turn back on, use /ENABLE_LIMITS

MOVE :

/ENABLE_LIMITS

To turn on limits for a motor, use this switch. To turn off, use /DISABLE_LIMITS

MOVE :

/HIGHLIMIT

Highlimit defines the software high limit of the motor. The program can be set to test each position of a scan before the scan starts to see whether limits are surpassed. See SCAN/TEST The syntax is 2THETA/HIGHLIMIT 3.

MOVE :

/INFLECTION

Only valid for the Mono motor, will go to the zero crossing of the second derivative of the mono scan of the previous scan. The inflection point is only calculated during E or X scans, and is calculated looking at the signal going into the channel defined PARAMETER/I1EDGE, which defaults to the same channel as the OPTIMIZE/CHANNEL channel. One can have a normalized signal by defining PARAMETER/I0EDGE, at which point the ratio I1EDGE/I0EDGE is used to determine the inflection point. The zero crossing is also reported after a DISPLAY/DERIVATIVE command. To protect against a beam dump, a minimum number of counts is needed, the same number used in OPTIMIZE/MINIMUM. Note that the code takes a 15 point first derivative and a 17 point second derivative, so a minimum of 50 points is needed for a good scan.

MOVE :

/LOCK

Lock tells VAXMOTORS not to accept any move commands for a particular motor. If one needs a critical motor to not be moved by accident this command becomes useful. The syntax is 2THETA/LOCK

MOVE :

/LOG

If this switch is specified the next move will be recorded in SUPER.LOG. This will look similar to an optimize, e.g. it will have a date and time stamp, list the motor name and the old and new values of the motor. This is not a logical switch, but most be specified each time you want it.

MOVE :

/LOWLIMIT

Lowlimit defines the software lower limit of the motor. The program can be set to test each position of a scan before the scan starts to see whether limits are surpassed. See SCAN/TEST The syntax is 2THETA/LOWLIMIT 3.

MOVE :

/OFFSET_ROTATION

Defines an axis as the rotation of a 2-motor offset rotation. Assumes that the next motor in the list is the translation of the offset rotation. Turn off with /NOOFFSET_ROTATION.

MOVE :

/PARAMETERS

Lists the Backlash, Scale, Low and High limits for that motor.

MOVE :

/RADIANS

This will move a motor in relative radians rather than absolute position, ie 2THETA/RADIANS -.01 will move 2theta - .01 radians with respect to its present position.

MOVE :

/RELATIVE

Move the motor a relative numbe of degrees. MOVE/RELATIVE THETA .1 will move THETA .1 degree from its present position.

MOVE :

/RESET

Reset is used to take the current physical position of the motor and redefine it to be a new scaled value. The syntax is 2THETA/RESET 23.871 One can do a reset without moving to the position to be reset by giving that value as the second parameter. Thus if you wanted to reset theta from 19.5 to 19, but were actually at 23 degrees, you could type: THETA/RESET 19 19.5 and 23 would be reset to 22.5 degrees, that is, the current position is reset by -0.5 degrees (19-19.5 added to the current position). NOTE: The new value must be within the limits of the motor.

MOVE :

/SCALE

Scale provides the conversion factor from steps to whatever your useful units are. This is typically Steps/Degree. For the most part this value will be 2000., but other gear/reducer or 1/2-step combinations are possible. The syntax is 2THETA/SCALE 2000. WARNING!!! CHANGING THE SCALE CHANGES THE POSITION, THE BACKLASH, THE LIMITS. BE VERY CAREFUL WHEN CHANGING THE SCALE.

MOVE :

/SECONDS

This will move a motor in relative seconds rather than absolute position, ie 2THETA/SECONDS 10 will move 2theta + 10 seconds from its present position

MOVE :

/STEPS

This will move a motor in relative steps rather than absolute position, ie 2THETA/STEPS 10 will move 2theta + 10 steps from its present position.

MOVE :

/STRING

This command only works for Serial motors. It will pass the string directly to the rs232 port. The other way to do this is by SET HOST TTA0:/DTE at the prompt.

MOVE :

/UNLOCK

Unlock tells VAXMOTORS that move commands to a particular motor are now allowed. (c.f. /LOCK). The syntax is 2THETA/UNLOCK

MOVE :

/VERBOSE

Reports the final position of the motor on the screen after the move. This is helpful for people running SUPER remotely.

MV

This is a synonym for MOVE

NOTE

Writes a time stamped comment into the log file, upto 60 characters long. Will prompt you for a comment. Syntax: NOTE This is a useful comment line

/EDIT

Will allow you to write an extended note for the log file using the EDT editor. If you are not familiar with the EDT editor, please consult the VMS manual for more information. See EDITOR for simple explanation.

OFFSETS

The offsets for the ion chambers are set by the command COUNT/DARK

OPTIMIZE

This is a table lineup scan which looks for a maximum in the monitor signal (channel 3 of the hex scaler). It starts 0.5 mm below the current table position and scans through to 0.5 above the current position. If it finds a monitor signal larger than it previously found, it repositions the table to the average of the centroid and the position of the maximum count. It also records the old and new positions in SUPER.LOG along with a time stamp.

OPTIMIZE :

Qualifiers

OPTIMIZE :

/CHANNEL

This defines which channel of the hex scaler (1-6) is monitored. For scattering experiments this is typically channel 3, but for non-scattering experiments I0 is often channel 1. This is also the channel monitored by SCAN/BEAMDUMP.

OPTIMIZE :

/STEPSIZE

This defaults to 0.1 mm, but can be changed by this command. Note that one has to specify the stepsize each time if one wants something other than 0.1 mm.

OPTIMIZE :

/MINIMUM

This is the minimum number of counts in the optimize channel that the program must see to actually do the optimize. The program won't allow a value less than 50.

Orientation

To calculate the h,k,l values for a crystal the program needs to know how the crystal is mounted on the goniometer head. The information it needs to do this is: The real space unit cell parameters: (A0,B0,C0,Alpha,Beta,Gamma) and two reflections, called the primary and secondary reflections. (There is a second method, involving three reflections and not needing the unit cell parameters. That has not been installed on this program yet). The primary and secondary reflections are typically chosen to be along major orthogonal directions. What the program needs is the h,k,l for a particular reflection and the Omega,Chi and Phi values associated with that. (Note that Omega is the difference between Theta and 0.5(2theta).

Orientation :

Cubic_Example

Consider a GaAs (001) wafer which is mounted with its optic axis roughly aligned along the Phi axis. Find one of the 4 (400) reflections in the plane of the crystal surface and call that a (4,0,0) reflection. That would be the primary reflection. The angles associated with that reflection would be Omega=0, set Phi=0 for that reflection and Chi would be close to 0. The secondary reflection could then be a (0,4,0) reflection and would have a Phi close to 90, a chi still near 0 and Omega=0. Thus all "symmetric Bragg" reflections would be of the type (0,0,l), with Chi close to 90. This example assumes that the calculation mode is Omega=0. The unit cell parameters would then be: A B C ALFA BETA GAMMA DIR: 5.65340 5.65340 5.65340 90.000 90.000 90.000 REC: 1.11140 1.11140 1.11140 90.000 90.000 90.000

Orientation :

Hex_Example

Consider a Si(111) wafer which is mounted with its optic axis roughly aligned along the Phi axis. Find one of the 6 (220) in-plane reflections and call that a (1,0,0) reflection. 60 degrees away would be the secondary (220). Change the lattice parameters as well, calling the (220) distance as a0 and b0, and set c0 as being the 111 spacing, ie: A B C ALFA BETA GAMMA DIR: 1.92017 1.92017 3.13559 90.000 90.000 120.000 REC: 3.77841 3.77841 2.00383 90.000 90.000 60.000 Note that if Omega,Chi,Phi for the primary reflection is set to 0.,0.,0. then the Omega,Chi,Phi for the secondary reflection might not be exactly 0.,0.,60.

Orientation :

2Circle example

When operating in 2Circle mode the convention is that L=0. The program automatically fixes the primary reflection as a (1,0,0) reflection with Omega= 0. and the secondary reflection a (0,1,0) reflection with Omega=90. If one returns to Omega=0 mode you must reset the primary and secondary reflections to their previous values.

PARAMETER

With no qualifiers this lists the current values of the parameters used for calculating (h,k,l) from the angles. If one includes a qualifier and a parameter it loads the new value of the parameter into the system. Syntax: PARAMETER/A0 5.6534 The wavelength is also listed, but this can only be changed if there is not a monochromator motor in the system, and then with the WAVELENGTH command. Note: to have h,k,l reported in reciprocal angstroms, set PARAMETER/CUBIC 6.283185

PARAMETER :

Qualifiers

PARAMETER :

/A0

Unit cell dimension in the a direction

PARAMETER :

/B0

Unit cell dimension in the b direction

PARAMETER :

/C0

Unit cell dimension in the c direction

PARAMETER :

/DIRECT

Define a0,b0,c0,alpha,beta,gamma in one command.

PARAMETER :

/CUBIC

Unit cell dimension: a0=b0=c0; alpha=beta=gamma=90.

PARAMETER :

/NOCELL

Unit cell dimension= 2pi, so calculations are in inverse angstroms rather than in reduced inverse angstroms.

PARAMETER :

/ALPHA

Angle between B0 and C0

PARAMETER :

/BETA

Angle between C0 and A0

PARAMETER :

/GAMMA

Angle between A0 and B0

PARAMETER :

/PRIMARY

This is the first of the two reflections upon which the h,k,l calculations are based. This tells the computer how the crystal is mounted on the goniometer head. The program prompts you for the h,k,l and omega,chi,phi values associated with this reflection, assuming that the current values are correct. You can hit a carriage return, accepting those values, or enter your own.

PARAMETER :

/SECONDARY

This is the second of two reflections which the program uses to determine how the crystal is mounted on the goniometer head. Again, it assumes that the current values of h,k,l and omega,chi,phi are correct and prompts them as the default values.

PARAMETER :

/SWAP

This interchanges the primary and secondary reflections. Anneli asked for this.

PARAMETER :

/STAGE

Sets the distance of the BETA translation stage (in mm) from the Theta axis in a z-axis geometry. The CVD chamber has a distance of 422.3 mm Make sure BETA is defined as an offset rotation (See MOVE/OFFSET_ROTATION)

PARAMETER :

/DSPACING

Sets the dspacing of the monochromator. Syntax: SUP>para/dsp 3.13555

PARAMETER :

/ENERGY

Calculate the incident photon energy from two reflections. You need d-spacings [angstroms] and theta values [deg] for 2 reflections. Syntax: SUP> para/energy 1.92 23.65 3.1355 14.22 Returns delta theta [deg] and energy [eV].

PARAMETER :

/I0EDGE

This is the normalizing channel used for calculating the derivative in Energy and Xscans. See MOVE/INFLECTION for more details.

PARAMETER :

/I1EDGE

This is the channel used to calculate the derivative in Energy and Xscans. See MOVE/INFLECTION for more details.

PARAMETER :

/REEFER

If you have a displex on you might prefer getting to a reflection with the displex remaining clear of the diffractometer. Due to the wonders of geometry the same reflection can be found two different ways. If /REEFER is set, it will keep chi between 90 and 270. If /NOREEFER, CHI is mostly 0-180.

PARAMETER :

/TOLERANCE

This can be set to keep SUPER from sending out a move to VAXMOTORS if the change in position is smaller than the tolerance value. The same tolerance is used for all motors in the system. The default tolerance is 1.e-6.

PARAMETER :

/UBn

Enter the UB matrix directly. Needs to be done as 3 different commands, /UB1 is the first row, /UB2 is the second row and /UB3 is the third row of the 3x3 UB matrix. The UB matrix is expected to be in Busing & Levy format, with UB(1,1) ~= 2*pi/a0.

PLANE

Plane move combines a CHI and a PHI move. One must specify the new absolute scaled position of both motors, even if only one will move. The first specified angle is CHI, the second is PHI. This follows the sequence of motors on the screen, 2THETA,THETA,CHI,PHI The syntax is PLANE 45.,90.

PRINT

Send a copy of the graphics on the screen to the printer. The program buffers up to 10 curves and creates a postscript file which it then sends to the printer defined by the logical name SUPER$PRINT_PLOT. For s072 that logical translates to S07_PS and goes to the postscript queue on the S07 printer. The important difference between the PRINT command and the old DISPLAY/PRINT command is that the former can be done ex-post-facto, i.e. you can just be plotting along merrily and decide to get a hardcopy of what is on the screen, rather than having to know a-priori that you are going to want a hardcopy of the following plots.

PRINT :

Qualifiers

PRINT :

/HALFSIZE

Print the figure in portrait mode on 1/2 a piece of paper. This is a logical switch which stays until switched back by typing PRINT/FULLSIZE

PRINT :

/FULLSIZE

Print the figure in landscape mode on a full piece of paper This is a logical switch which stays until switched back by typing PRINT/HALFSIZE

PRINT :

/NOPRINT

If you want to change from /HALFSIZE to /FULLSIZE without actually printing a figure, you can append /NOPRINT and just the switch will be changed.

PROBLEMS

Here are some answers to so some of the more common questions that users ask: Q: Why can't I count in time mode for more than 10 seconds? A: In COUNT/AUTO, a time <= 10 is treated as a time, and a time > 10 is treated as a dose. To turn off, type COUNT/NOAUTO. Q: When I COUNT, it seems to take twice as long as it should. A: See if ABSORBER mode is turned on. If the count rate is too high, it will insert filters and recount. Type ABSORBER again to turn off. Q: When I COUNT, it never stops counting Why? A: Two possibilities: Either you're in Dose mode, and you have no counts coming into the monitor channel, or you are in beam dump mode, and again, you have no counts going into the monitor channel. CO/TIME will fix the first, and scan/nobeamdump will fix the second.

RECALL

Recalls previous commands for execution. To see the last 20 commands, type RECALL/ALL. To recall a particular command for execution include that number in the command, e.g. RECALL 7 will recall the 7th command for re-execution.

RECENT

Recent additions to the program include: DISPLAY/XWIN plus SCAN/UPDATE to get automatic plotting during a scan. DISPLAY/EXAFSPAK write binary output file format readable by EXAFSPAK. DISPLAY/HEADER will type the comment, scan and motor values on the screen DISPLAY/SUBTRACT will subtract the data of this scan from the previous one and plot the result. Does not affect data on disk. DISPLAY/DERIVATIVE will plot the 15pt average derivative of the data. FIT is now the same as FIT/AUTO. Use FIT/NOAUTO to fit more than 1 peak RADIAL,HVAL,KVAL,LVAL are new "motors" that can be moved. HVAL/REL also works IND/TEST will do a grammar check on an indirect command file LINE HVAL or KVAL or LVAL will do a lineup in reciprocal space MONO/INFLECTION move mono to inflection point after E or X scan. PARA/ENERGY Solve for energy from theta and d-spacing of 2 reflections. SCAN/SWEEPS will do multiple passes of the same scan integrating data

RESCALE

Used for entering new plot limits in the order xmin, xmax, ymin, ymax. The program will prompt you for all four values if you don't enter any variables with the command. Syntax: RESCALE .9,1.9,0,2000.

RESET

To reset a motor position, type MOTOR_NAME/RESET new_value. For more information, see HELP MOVE.

SAMPLE

The header line for the data files is split into 4 components. It consists of the file name, the date and time, the "Sample name", and the comment. The Sample name is the part of the comment which won't change over a set of files, but would change say, for a new sample. The Sample string can be up to 20 characters long. SYNTAX: SAMPLE GaAs-InGaAs SLS #438

/HKL

If the qualifier /HKL is added, then the current value of h,k,l is loaded into the sample name. This is useful if you are doing a series of Lineup or B-scans at different hkl values (e.g. in an IND file). This only works in SUPER or SCALC. In SPLOT, hkl is set to zeros. The last HKL loaded will remain there until a new string is loaded.

SCALE

To change the scale factor (steps/mm or steps/deg) the command is MOTOR_NAME/SCALE new_value. For more information, see HELP MOVE.

SCAN

Perform from 1 to 20 of the scans listed in Setup. If more than one scan is entered, the file name is incremented automatically for subsequent scans. At the prompt for the file name one has several choices. Typing increments the extension of the current filename. Typing a full file name and extension will result in that name being used. Just typing a new file name without dot or extension will result in the extension being the next one after the most recently collected in that name series. One can also type and be returned to the SUP> prompt. This is also possible at the comment line, although a file will have been created on disk. Normally the scan must be one of those listed in the setup file. Scan number can be entered on the scan line or it will prompt you for a value.

SCAN :

Skipping_Setup

Occasionally you might want to run a scan without saving the scan parameters as one of the 20 stored in the SETUP list. You can do so by entering a valid SETUP string after the scan prompt, e.g. SCAN A0,10,5,90,0,.1,100,14 The program will run the scan just as if you had entered the string into the SETUP as scan 21 and then run scan 21. It doesn't save that string as one of the 20 scans available in SETUP.

SCAN :

Qualifiers

SCAN :

/BEAMDUMP

This logical switch controls whether the program checks the monitor intensity of each point in a scan. If the value of the monitor intensity is less than 100 cts, it will wait 10 minutes and try counting again. Once a monitor value > 100 cts is again observed, it will wait 20 more minutes, then continue the scan. Note that DOSE mode effectively waits for beam to return, but doesn't wait the additional 20 minutes. The channel monitored can be set with OPTIMIZE/CHANNEL, but defaults to channel 3. Turn off with /NOBEAMDUMP

SCAN :

/CONTINUOUS

Will scan a single scan number up to 1000 times. Useful for monitoring a scan while something else is happening. Syntax: SCAN/CO 2 Will perform scan#2 up to 1000 times.

SCAN :

/GRID

Will perform a two-dimensional scan. Command accepts 2 scan numbers; the second scan is performed at each point of the first scan. A grid file is created which writes the sum, ymax and centroid of each scan as a data point of the grid file. The grid file has the same name as the first of the scans, with a "g" appended to the extension, ie fred.028g.

SCAN :

/FILE

Will read in a file of motor positions, go to those positions and write a data file with the resulting data. Default extension is .DAT, default directory is $SUPER_DATA:. The first line of the file is a comment line, the second should consist of: number of data points, the monitor counts/point (or time in seconds, depending on current count mode), the position of the motor in data file which should be plotted, the total number of motors moved and the motor number of each motor, to be moved, e.g: (Note: % signs would not be there, but are necessary for this file) %Comment describing file %100, 14, 2, 3, 1, 3, 4 %2.0, 20.0, 23.45 %2.01,20.2, 23.5 means 100 data points, 10000 cts/pt, plot the 2nd motor of the 3 motors, 3 motors total, motors to move are 1, 3 and 4. After that the absolute motor positions should be listed line by line, etc. Syntax: SCAN/FILE SILICON.DAT

SCAN :

/NOREPORT

The results of each data point are not listed on the screen. This is not a logical switch, it only is in effect for this scan. Not reporting at present is only available for time scans. It is especially useful in short time scans where the latency of printing to the screen and writing to disk can be significant. Probably important for count times of less than ~0.5 seconds.

SCAN :

/PROMPT

This is a logical switch whether a scan command will prompt you for a new file name or automatically assume you want to increment the extension. In either case it still asks for a comment. For the NOPROMPT case typing CtrlZ at the comment prompt will not write a file to disk, but for the PROMPT case it will write a zero length file to disk.

SCAN :

/SWEEPS

In this mode the scan repeats several times, and each data point is the integral of the data from all the sweeps. This works like UPDATE/REPEAT, in that you set it once (e.g. SCAN/SWEEPS=10) and then you don't need to define the number of sweeps, SCAN/SWEEP remembers that nsweeps= 10. It is not a logical switch, in that SCAN (without /SWEEPS) will run as a normal scan. Works with a maximum of 16 channels of data.

SCAN :

/TEST

Will tell the program to test that a scan is within motor limits. This is done without doing the scan, ie SCAN/TEST 9 will test that no limits are hit in scan 9, then return to the SUP> prompt. This is not a logical switch, so each time you want to test a scan you must use the /TEST quailfier.

SCAN :

/UPDATE

If turned on, will plot the data after each point in a separate X-window. This only works if you are running SUPER from an X-terminal. This also works much better if you have autofocus turned on. All the plotting switches defined in SPLOT control here. If the program is run from a non-Xterm or if DECW$DISPLAY is undefined, this switch is turned off and must be explicitly turned back on. Note, if you $SET HOST 0 to run super even in an xwindow environment, then decw$display is not defined.

SETUP

There are twenty numbered scans that are stored within the program and can be executed using the SCAN command. They are numbered 1-20, and if one changes a scan one must identify it by its number as the first parameter. There are a large number of scan types available and each is signified by a letter (and possibly a number). For specific information on each of these consult one of the SETUP subtopics. Syntax for M(otor) scan: SUP> SETUP 7,M1,5,.01,5,1 MAXIMUM NPTS= 16383

SETUP :

Saved_scans

The scan parameters are saved in your SUPER.PARAMETERS file which is stored in $user:[b_your_account]. See SETUP/SAVE for additional sets of scans that can be saved. See SETUP/RESTORE to bring in other sets of scans.

SETUP :

Qualifiers

SETUP :

/EXCHANGE

If you would like to rearrange the positions of two of the scans you can with SET/EXCHANGE 1,11 which puts scan 11 in the first position and scan 1 in the 11th position. If you exchange a scan that is being currently run, it will switch to the new scan, so be careful out there!

SETUP :

/SAVE

Saves the current 20 scan parameter sets to disk. Default is SYS$LOGIN: with a default extension of .SCN. The resulting file is direct access, so the only way to read it is through SUPER or SPLOT.

SETUP :

/REPLACE

LINEUP scan parameters are stored in a temporary array (scan 21). Similarly a scan entered on the fly will end up in the temporary array. If you decide you would like to keep that scan, you can replace one of the 20 saved scans with the parameter set in the temporary array. Syntax: SET/REPLACE 18 Replaces scan 18 with the scan that was in the temporary array. Note that each time you do a lineup you overwrite the scan parameters stored in the temporary buffer.

SETUP :

/RESTORE

Restores a scan parameter file from disk to memory. Default is SYS$LOGIN: with a default extension of .SCN. The current set of scans is overwritten, so if you like the current set, save that to disk before restoring a new set.

SETUP :

Angle

A(n) scans will scan the nth motor (1 motors with the other motor positions also defined. Consists of 7 parameters; the initial positions of the 4 diffractometer motor positions, the delta of the motor to be moved, the number of steps and the time: 4,a1,20,10,3.45,4.987,.01,100,14 will scan 2theta from 20 to 21 deg. after putting theta, chi and phi at 10., 3.45, and 4.987 deg, respectively. Note: An A0 scan is a symmetric 2theta-theta scan. Parameter #5 is delta 2theta, and theta will be moved 1/2 that amount.

SETUP :

Background

B(n) scan is like a lineup scan, but has two step-sizes. Thus it is useful for looking on a fine scale at a peak and on a coarse scale at the background around the peak. The parameters are central stepsize, npts, background stepsize, npts, time. Note that, as with a lineup scan, npts is 1/2 the total, as it is a scan about the current position: 4,B2,.01,10,.1,10,14 will start 1.1 degrees below the current value of theta, scan 10 steps at .1 degrees, then 21 steps at .01 degrees, then 10 steps at .1 degrees, and return to the starting position, with a count time(dose) of 14. A B0 scan is like a line radial scan, both 2theta and theta move. The deltas are for 2theta.

SETUP :

Energy(range)

E(n) scan is for moving the monochromator with up to three ranges. This scan is unusual because one does not enter the number of points, although it is calculated within the program and listed as part of the scan. The parameters are initial energy, delta energy for the first range, final energy (if only one range) or ending energy of first range, delta energy for second range (if needed) final energy for second range, etc) followed by time: 4,E3,8900,5.,8980,2.,9500,4.,10500,14. will scan from 8900 to 8980 in 5eV steps, then 8980 to 9500 in 2eV steps, then 9500 to 10500 in 4eV steps, with a time of 14.

SETUP :

Hscan

H0 scan is a 2theta scan stepping in constant k rather than constant angle. The parameters are initial k value, delta k, npts and time: 4,H0,1.,.01,200,24 will move 2theta starting at k from 1. to 3. in 0.01 steps. To truly emulate a K-scan with steps in 4pisin(theta)/lambda, a0,b0,c0 MUST equal 2pi. The easiest way to do this is to type MODE/NOCELL, which changes a0,b0,c0 to 2pi and only reports Q on the 3rd line rather than h,k,l.

SETUP :

Integer

I0 scans are for scanning from an initial h,k,l value to a final h,k,l value. Consists of 8 parameters, the initial h,k,l; the delta h,k,l; number of steps and time: 4,i0, 1.0,1.0,0.0,.001,.001,0,100,14 Will tell the program to change scan#4 to be an integer scan starting at (1,1,0) and scanning 100 points, 10**4 monitor counts per point, to (1.1,1.1,0) An I1 scan difers in that you give the beginning and final points and have the program calculate the deltas. It is stored as an I0, however. An I2 scan expects the central h,k,l the delta h, k, l and the # steps on one side of the scan. The program converts it to an I0 scan.

SETUP :

I3

An I3 scan is enough different from I0, I1 and I2 to warrant its own help entry. An I3 scan defines delta H, delta K and delta L without defining the initial HKL, so it can be used in conjunction with either a Bragg move or in a grid scan. The parameters are delta h,k,l, number of points on one side of the scan, and count time: 4,i3,.001,.002,.003,10,14 The mechanics are that when you run scan 4, it converts it to an I0 scan and loads those values into setup 21 and runs it there. Thus on disk the scan looks like an I0 scan, the program treats it like an I0 scan, but it can be re-used because the values in SETUP 4 aren't changed.

SETUP :

Kscan

K0 scan is a theta-2theta scan with the energy at which the scan is run defined as well. The parameters are the energy, the initial k value, the delta k, npts, and time: 4,K0,8975.,1.,.01,200,24 would set the monochromator to 8975. eV, and scan from 1 to 3 in reciprocal space. In 4-circle parlance this would be an H scan, but in 2-circle parlance this is a k-space scan (as different from an angle scan). If the energy is omitted in entering the scan the current energy is inserted as the energy of the scan. To truly emulate a K-scan with steps in 4pisin(theta)/lambda, a0,b0,c0 MUST equal 2pi. The easiest way to do this is to type MODE/NOCELL, which changes a0,b0,c0 to 2pi and only reports Q on the 3rd line rather than h,k,l.

SETUP :

Motor

M(n) scan is similar to a LINEUP scan. It scans a single motor from a defined position, leaving all other motors where they are presently. The parameters are which motor, initial position, delta angle, npts and time: 4,M5,37.34,.02,100,14 will move motor 5 to 37.34, and then step .02 deg for 100 steps.

SETUP :

N(E) scan

An Nscan is a photoemission scan which allows for multiple scan regions separated by an arbitrary distance. It is hardwired for the CMA motor. The parameters are the Initial, delta and Final energies for each region defined. N1 has a single range, N2 has two regions and N3 has three regions. NOTE: the #pts is calculated by the program, so don't include in the scan line. 4,N3,100,.2,110,130,.1,135,150,.1,160,1 NOTE: If two regions are contiguous, don't repeat the energy, e.g. 4,N3,100,.2,110,.02,115,130,.3,142,1 If all the regions are contiguous, you can have 4 of them, e.g. 4,N4,18,.1,20,.2,22,.02,25,.1,29,1

SETUP :

Psi

P0 scans the PSI motor about a the defined reciprocal lattice vector. Consists of 7 parameters, the h,k,l of the reflection about which the rotation should occur, the initial psi value, the delta-psi value, number of points and the dose(time) per point: 4,P0,0,0,2,30,1,60,14 will move to the 0,0,2 reflection at an initial psi value of 30 degrees, then scan psi by 60 1 degree steps, counting for 14 monitor counts. Zero of psi is defined by the reference vector, which is requested when you set mode/psi. You can change the reciprocal lattice vector about which the rotation occurs "on the fly" but the reference vector for zero of psi must be explicitly changed.

SETUP :

Rocking

R(n) scans rock a motor about a particular h,k,l value. Consists of 6 parameters, initial h,k,l, delta angle, The number of steps on one side of the central value, and time: 4,R2,1,1,1,.001,20,14 will scan Theta from .02 degrees on one side of the 1,1,1 reflection to .02 degrees on the other side. Note that total number of points in the scan is 2n+1. This is a recent change for this scan to make it consistent with LINEUP scans. Rscans are unusual because the motor returns to its initial position after the scan is done, similar to a LINEUP scan, but unlike any other scan defined by SETUP.

SETUP :

Simultaneous

S(n) scans move two or 3 motors simultaneously, assuming the present positions for all the other motors. The n of S(n) defines whether there are two or 3 motors moving. effect. The first motor is plotted as default. To plot the second motor, use DISPLAY/SECOND. The parameters are similar to that for a motor scan, only repeated 2 or 3 times: motor #, initial position, delta position. 4,S3,1,20,.1,3,37.5,.1,8,200.3,0.22,10,14 would move motor 1 from 20 to 21, motor 3 from 37.5 to 38.5 and motor 8 from 200.3 to 202.5 and count for 1e4 monitor counts.

SETUP :

Time

T0 scans are time scans. No motors move. In addition to hex scaler values the elapsed time since the beginning of the scan is recorded as a real variable. There are 3 parameters, delay between points, number of steps and time per point: 4,T0,5,200,14 will count 10000 monitor counts (if count mode= DOSE) 200 times with 5 seconds between points. MAXIMUM NPTS= 16384. One can add a 4th and 5th parameter which are a second npts and time.

SETUP : Time

T1

A T1 scan will clear bit 1 of the output register 1 second before starting, and set bit 1 of the output register just before it starts the scan.

SETUP : Time

T2

A T2 scan waits for bit 1 of the input register to go from zero to 1 before starting the scan.

SETUP : Time

T3

A T3 scan combines T1 and T2, clearing and setting bit 1 of the output register, then waiting until the input register flips bit 1 before starting the scan.

SETUP :

Xscan

An Xscan is an EXAFS scan. One has two regions with steps of constant delta energy, and the third region is in constant delta k. The count time is constant for the first two regions and into the third region until the count time calculated from a power of k and a maximum count time exceeds the minimum count time. The example parameters are: 1,x0,8000,5,8930,1,9030,8980.3,.05,10,2.,1,10 Would run from 8000 to 8930 in 5 eV steps, then to 9030 in 1 eV steps, then would go in steps of 0.05 in k based on an E0 of 8980.3 out to a k_max of 10. The count time would start at 1 second and in the third region would rise with k**2.0 up to a maximum count time of 10 seconds.

SHOW

Used to display various logicals in the system.

SHOW :

SWITCH

This is the same as SWITCH. Shows the settings of all the logical switches for program options.

SHOW :

DEFINITIONS

Will list the currently defined aliases.

SHOW :

ALIAS

Will list the currently defined aliases.

SHUTTER

Shutter uses the pneumatic filter box. The older style of shutter using a stepper motor has been removed. SHUTTER/ENABLE enables it, SHUTTER/DISABLE turns it off. When /ENABLED, the shutter only opens during a count. One can also do a timed exposure with SHUTTER 3.3 where 3.3 is the number of seconds of the exposure. The time resolution is 0.01 seconds and the maximum time is 86400. seconds (24 hrs). To open the shutter for an indefinite period while it is enabled, type SHUTTER/OPEN. To close again, SHUTTER/ENABLE.

SHUTTER :

Mechanics

The way the shutter works is to have a long paddle in piston #4 of the pneumatic filter box which blocks the beam in the "closed" position and requires that the filter be activated to let beam pass. piston #3 has another paddle which blocks the beam when activated. This way the exposure is the same for the entire vertical height of the beam.

SHUTTER :

Qualifiers

SHUTTER :

/ENABLE

Turns on the shutter. This means that filter #4 blocks the beam unless it is inserted. See Mechanics for a description of which pistons get lead paddles and how they should look.

SHUTTER :

/DISABLE

Turns off the shutter, i.e. shutter isn't moved during count,etc. Note that if piston #4 has the lead paddle installed, /DISABLE won't let you see beam all the time. It merely doesn't actuate the shutters during a count. To expose your sample continuously with the paddle installed you need to /OPEN the shutter.

SHUTTER :

/OPEN

Opens the shutter, which means inserting filter #4.

SPAWN

If you want to execute a command at DCL level without leaving the program type SPAWN followed by the command you want executed. After the command has been executed you are returned to the program. Syntax: SPAWN dir [mydirectory]mydata.* If you want to execute more than one command, type SPAWN without a command and you will be placed in a subprocess with the prompt SPAWN>. When finished, LOGOFF from the subprocess to be returned to SUPER.

SWITCH

Lists the current values for the various logical switches such as Calculation mode linear vs. log plotting point vs. line plotting shutter closed when not taking data

TDC

This uses the LeCroy 4204 Time-to-Digital Converter, in combination with the LeCroy 3588 Histogramming memory module. These commands work very differently from, e.g, the ADC commands, in that there are separate commands for starting and stopping the TDC, and in between starting and stopping the whole range of SUPER commands are available. Thus there is nothing to keep the user from moving motors during a TDC count. Remember that the Histogram DIP switches are different for the ADC and TDC modules. The two choices are listed in the "Using the 3588 Data Bus" manual. Briefly, for the TDC you want all rockers closed (depressed on the left, looking at the back of the module).

TDC :

Qualifiers

TDC :

/NSPECTRA

Number of spectra recorded. Max of 32. The total amount of memory is fixed, so the more spectra, the smaller memory per spectrum

TDC :

/PLOT

After you have finished collecting the data, you can review the various spectra with TDC/PLOT. To look at a different spectrum, use TDC/PLOT=SPEC#.

TDC :

/RANGE

Define the maximum timelength of an event. If the TDC doesn't see a stop pulse after this length of time, it resets and starts looking for another start pulse.

TDC :

/RESOLUTION

Define the minimum time resolution of the TDC. Events occuring on time scales faster than that will not be recorded.

TDC :

/SAVE

Save the spectrum just collected to disk.

TDC :

/START

Start the counting process. This command is unusual in that you get back the SUP> prompt immediately. You must explicitly turn off the counting with TDC/STOP. In the mean time, you can do most other commands available to SUPER, so be aware of what you are doing.

TDC :

/STOP

Stop the counting process.

TDC :

/UPDATE

While collecting a spectrum, will do a non-destructive read on the histogram and plot those data. If you want to look at a different spectrum, type TDC/UPDATE=SPEC#.

TEMPERATURE

This can be used to record sample temperature in the header of the scan file. This presumes that whatever temperature measuring instrument you have has a voltage output which is linearly proportional to the temperature. This voltage can be feed into the V/F converter and then into the Hexscaler. If this option is turned on (TEMP/RECORD) then of the hexscaler is read and the resulting integer value is converted to a real using the values used for OFFSET and SCALE (see below) such that Temp= offset + value*scale. This option can be turned off with TEMP/NORECORD.

TEMPERATURE :

Qualifiers

TEMPERATURE :

/CALIBRATE

This will calculate the offset and scale, given two temperatures. It prompts you for the current temperature, asks you to change temperature, and prompts you for the new temperature. It then calculates the proper parameters.

TEMPERATURE :

/CHANNEL

Allows you to set the hexscaler channel where the signal comes from. Defaults to channel 6

TEMPERATURE :

/LOG

Records the temperature in SUPER.LOG. Works whether TEMP/RECORD is working or not.

TEMPERATURE :

/OFFSET

This is the Intercept of the linear relationship between frequency into the scaler and temperature. Usage: TEMP/OFFSET 4.213

TEMPERATURE :

/RECORD

This turns the option on. To turn off this option, TEMP/NORECORD.

TEMPERATURE :

/SCALE

This is the slope of the linear relationship between frequency into the scaler and temperature. Usage: TEMP/SCALE 20.123

TIME

Time is used to define the default counting time. If in 'TIME' mode, the variable is interpreted to mean seconds. If in 'DOSE' mode then it is interpreted to mean numbers of monitor counts. If in 'ROCK' mode, it is interpreted to mean number of oscillations of the rock motor. In TIME mode, the range of values can be from 0.01 sec or larger. Times greater than 1 second are treated as integer. In DOSE mode, a shorthand is used, so 14= 1x10^4 monitor counts, 35=3x10^5 monitor counts. In ROCK mode, 14 means +/- 1/2 degree for 4 iterations, 25 means +/- 1 degree for 5 iterations.

TWEAK

This command can be used to change the position of a single motor a small amount either forwards or backwords with the up and down arrows. The command is: SUP> TWEAK PHI .01 and the phi motor will move 0.01 degrees every time you hit the up_arrow and down 0.01 degrees every time you hit the down arrow. It may get confused if you hit it to fast, so watch the screen to make sure it has finished a move before typing another (or the same) key again. A carriage return will finish the exercise.

TXRF

Analyze an alpha scan to determine the alpha offset. Reset the alpha motor to the correct value. There is one input parameter, the name of the alpha scan, e.g. TXRF ALPHA.123. Note: The channel to be fit is defined by the plotting parameters in DISPLAY.

TXRF :

Qualifiers

TXRF :

/ZED

This command has been disabled. If zed is defined, then the program will calculate alpha, beta and mu using the value of energy that the monochromator gives it. If the mono-motor is not defined, this won't work. If any of alpha, beta, or mu are individually entered, it zeros out the value of zed. At present, zed is single-valued only. Once zed is zeroed out, the program accepts alpha, beta and mu as they are.

TXRF :

/ALPHA

This is the real part of the index of refraction, n=alpha+i*beta NOTE: ALPHA, BETA, MU and ENERGY are all inter-related and must be changed together!!!

TXRF :

/BETA

This is the imaginary part of the index of refraction, n=alpha+i*beta NOTE: ALPHA, BETA, MU and ENERGY are all inter-related and must be changed together!!!

TXRF :

/DALPHA

Starting value for fit of delta alpha (degrees) of alpha scan.

TXRF :

/ENERGY

Energy (in eV) at which the refractive index is defined. NOTE: ALPHA, BETA, MU and ENERGY are all inter-related and must be changed together!!!

TXRF :

/MOTOR

Name of alpha motor. (Just in case).

TXRF :

/MU

Absorption of the material, in 1/microns. NOTE: ALPHA, BETA, MU and ENERGY are all inter-related and must be changed together!!!

TXRF :

/RESET

After a reset has occured, TXRF/RESET will tell you the value the motor was reset to. If the TXRF command was unsuccessful, this is set to 0. This allows Matlab to decide whether to perform another alpha scan+ txrf command.

TXRF :

/ROISTART

Bin number for start of region to be summed in ADC scan.

TXRF :

/ROIEND

Bin number for end of region to be summed in ADC scan.

TXRF :

/SCALE

Starting value for scale factor for fit of alpha scan.

UNDEFINE

Used to turn off an alias. The string must match exactly to the alias name. (See DEFINE to define an alias).

UPDATE

Will plot the most recently collected data file without further prompt. This is most useful if SPLOT is running in a separate window, as one can see the results of the current scan as they are being collected. Plot parameters are defined using DISPLAY. To have this happen periodically and automatically, type UPDATE/REPEAT. UPDATE NOW TAKES MOST OF THE SAME QUALIFIERS AS DISPLAY, E.G. /CHAN,/RAT,/LOG, etc. (See HELP DISPLAY). Todd asked for this.

/REPEAT=n

For the SPLOT program, this switch is an option. If included in the command the file will be updated every n seconds until a ^C is typed. The number of seconds between updates is saved, so need only be specified when you want to change it. Unfortunately, now that /RATIO is an option within UPDATE, UP/RE is now the minimum command.

WAITBIT

If you are handshaking with an external computer you can have SUPER poll a particular bit (or pattern of bits) on the input register until that pattern has been set by the external computer. SUPER will poll the input register once a second forever. So WAIT 1 will wait until bit 0 of the input register is grounded. The external program will need to ground that bit for at least one second to make sure that SUPER sees the change of state. If you wanted to set bit 1 of the input register, you would enter WAIT 01 in a manner similar to the way BITPATTERN works. You can Ctrl^C out of the wait state.

WAVELENGTH

Changes the value of the wavelength Syntax: WAVELENGTH 1.54 Note that if MONO is one of the motors, this command is disabled.

/ENERGY

This allows one to enter the energy in electron volts Syntax: WAVE/ENERGY 8048.

XSW

Command for x-ray standing wave scans. Based on a lineup scan, it does a centered scan with multiple sweeps. If ADC mode is turned on, will collect spectra and integrate those over the number of sweeps. The centroid of each sweep is compared to that of the first sweep. If the difference between centroids is sufficiently small, the most recent set of data is added to the previous data. Otherwise, it is thrown out. Command sequence: Motor name, delta angle, # steps on one side, # sweeps. Optional fifth parameter is the time per point. example: XSW PHI .1 10 20 will result in 20 sweeps of phi +/- 1 degree about the current value. Maximum of 100 points allowed in an XSW scan (+/-50). One can adjust the Centroid test with /DELTA

/DELTA

Set the test value of the centroid comparison, e.g. XSW/DELTA=0.001 means that for the current sweep to be integrated with the previous ones, the difference between the centroid of the current sweep and that of the previous sweeps has to be less than 0.001.

ZERO

To Zero a motor position (or reset it to a new value, use MOTOR_NAME/RESET new_value. For more information, see HELP MOVE.

ZOOM

You can rescale a figure using the cursor. Give the lower left and upper right positions of the new figure.