| NONIUS
CAD4/MACH3
User manual |
![]() |
![]() |
|
Introduction
The reflection list
Command format
of reflection list operations
List entry operations
Status code operations
The list group consists of a set of commands allowing the operator to operate on the list of reflections (the CRYSTAL file). The CRYSTAL file may contain data (setting angles, intensity and control parameters) of 25 reflections and it is used in the orientation and data-collection stages.
List group commands give the operator access to the information stored in the CRYSTAL file. Commands are provided which enable lines to be entered, changed, deleted or printed on the terminal. List group commands can be divided into two groups:
2. Status code operations
Commands Function LO List Output kappa angles LK List Kill LI List Input by indices and angles LH List input by HKL's LPH List input from polaroid Photo LG List Get LD List Dump
The reflection list
Commands Function LCH List Change HKL status code LCT List Change Theta status code LCA List Change Angle status code LCO List Change Orientation control status code LCI List Change Intensity control status code LCS List Change Scan information status code LCL List Change Learnt profile status code
The CRYSTAL file consists of 28 records of 512 bytes of which the first 25 records hold a list of up to 25 reflections and the last 3 records contain parameters used during operation of the CAD4-program, such as wavelengths, orientation matrix elements, datcol values etc.. The data of these reflections are used for orientation matrix determination and intensity and orientation control during data collection. The CRYSTAL file information may be supplied by the operator or may be generated via SEARCH. The reflection centering routines and data collection modify the list as necessary. Each record of 512 bytes is used to store binary information pertaining to one reflection and, if required, information on 7 equivalent reflections used during the alignment procedure. Information relating to one reflection may be manipulated using any of the list entry operations described in Section D of this Chapter. The list may be printed as ASCII characters using LO. Other list group commands modify the various parameters.
In the CAD4 system the crystal file is linked to logical unit number 1. For file preparation see Initiating the CAD4 system. The contents of the first part of each record can be displayed alpha numerically on the terminal by the "LO" command. The example below is used to identify all parameters by their value.
Example:
CD0> LO<CR>
From to: 12<CR>
12 H 0 5 0 T 12.67 S 77.71 12.82 -3.31 OIS -3 0.59 9370.4
CD0>
| Explanation: | ||
| Internal code | Value | Function |
| LISTNR | 12 | Line number in the CRYSTAL file |
| IRSIND | H | Status of the indices |
| RH | 0 | |
| RK | 5 | The three indices |
| RL | 0 | |
| IRSTH | T | Status of the THETA angle |
| RTHETA | 12.67 | The THETA angle |
| IRSANG | S | Status of PHIK, OMK, KAPPA and THETA angles |
| RPHIK | 77.71 | PHIK |
| ROMK | 13.82 | The Kappa geometry angles OMK |
| RKAPPA | -3.31 | KAPPA |
| IRSCOR | 0 | Indicator for orientation control |
| IRSCIN | I | Indicator for intensity control |
| IRSSCN | S | Status of the scan information |
| IRNPI | -3 | Attenuator setting, scan speed parameter |
| RSCANG | 0.59 | Scan angle |
| RSCINT | 9370.4 | Net intensity |
A detailed description of the parameters identified in the example given
above is given here.
| LISTNR | The line number in the CRYSTAL file where this reflection is stored, range 1 - 25. |
| IRSIND | The status of the indices.
* - There is no valid index information present.
Index status is determined by a flag used by the geometry commands. IRSIND can be modified by LCH. |
| RH, RK, RL | The indices of the reflection.
These indices are stored as real rather than integer values. When they are calculated by INDEX, LS and REIND they are converted to the nearest integer. They are stored as floating point numbers because all calculations involving them are floating point calculations. |
| IRSTH | The status of the THETA angle.
* - The THETA angle was not determined by DETTH.
T inhibits redetermination of the THETA angle during subsequent recentering. IRSTH can be modified by LCT. |
| RTHETA | The THETA angle in degrees.
2 THETA is twice as much |
| IRSANG | The status of all of the angles.
* - No valid angle information is present; the line is empty. Not printed
with LO.
IRSANG can be modified by LCA.
|
| RPHIK | Kappa geometry angle PHIK. |
| ROMK | Kappa geometry angle OMEGAK. |
| RKAPPA | Kappa geometry angle KAPPA |
| IRSCOR | Indicator for orientation control.
* - This reflection is not used for orientation control or orientation
redetermination during data collection.
IRSCOR can be modified by LCO. |
| IRSCIN | Indicator for intensity control.
* - This reflection is not used for intensity control during data collection.
1. The reflection was "WEAK" when first measured at the start of data collection.IRSCIN can be modified by LCI. |
| IRSSCN | The status of the scan information.
* - No valid scan information is present.
IRSSCN can be modified by LCS. |
| IRNPI | The scan speed and attenuator setting. A minus sign indicates that the attenuator was used to measure this reflection. Scan speed = 16.49/IRNPI degree/min in omega. |
| RSCANG | The scan angle for OMEGA axis.
This scan angle is three times the width of the peak as determined by subroutine PEAKD. See the description of PEAK ANALYSIS under SCAN (see Crystal orientation: Peak analysis). |
| RSCINT | The net intensity of the peak when measured using IRNPI and RSCANG.
When IRSSCN = S, the net intensity is determined by subroutine PEAKD
after the final OMEGA scan.
|
Command format of reflection list operations
1. List entry operations (Cf. the section on List entry operations of this page)
From the seven commands of this group the commands LD, LI, LH and LPH are used by the operator to fill the list. These commands do not need a line number, but fill the first empty line in reflection list (the CRYSTAL file). Apart from the command LD they all prompt for input.
The remaining commands require an line number or a line number range as input. The operator should specify, in the line following the command, the line number or numbers (inclusive) of the lines in reflection list (the CRYSTAL file) on which the command will operate, e.g.,
2. Status code operations (Cf. the section on Status code operations of this page)
CD0> LO<CR>
From to: 1<CR>line 1 from reflection list (the CRYSTAL file) is printed
CD0>
CD0> LO<CR>
From to: 2,6<CR>lines 2 to and inclusive 6 from reflection list(the CRYSTAL file) are printed
CD0>
The program will print, on a single line, the specified status code for the lines being examined/or modified, followed by "OK?". The operator may respond with "Y" if the status codes are correct, or may modify some or all of them by typing, on a single line, the correct sequence of codes. Empty lines included in the set examined are flagged with a "K". This "K" code cannot be changed. The examination cycle will be repeated until the operator is satisfied and types "Y" or "YES". The new codes will then be stored in the list.
General CAD4 input rules apply, including "/" to retain a code; "Q" may be used to escape the loop without effecting any changes.
CD0> LCH<CR>
From to: 1,7<CR>
H*H*NHH OK?
/HH//N<CR>
H*H*NNH OK?
////H//<CR>
H*H*HNH OK?
Y<CR>
CD0> LCA<CR>
From to: 1 10<CR>
ASASSPSSSS OK?
//////A***A<CR>
ASASSPA*** OK?
Y<CR>
CD0>
Seven commands enable the operator to modify the status codes of single
or multiple lines of the CRYSTAL file. Only modifications which make sense
are permitted.
| LCH | Modify IRSIND, the index status code.
* - There is no valid index information present. H - Index information is present. N - Index information is present but this relection may not be used by INDEX, LS, REIND. Valid modifications are:
|
| LCT | Modify IRSTH, the THETA angle status code.
* - The THETA angle was not determined by DETTH.
Valid modifications are: T to * |
| LCA | Modify IRSANG, the status of the angles.
* - No valid angle information is present; the line is empty.
Valid modifications are: S to A Enables recentering by SETANG, DETTH or SET4.
|
| LCO | Modify IRSCOR, the data collection orientation control indicator.
* - This reflection is not to be used for orientation control or orientation
redetermination.
Valid modifications are: -everything is allowed-
|
| LCI | Modify IRSCIN, the data collection intensity control indicator.
* - This reflection is not to be used for intensity control
1. Reflection was "WEAK" when first measured.Valid modifications are: * to I I to * F to I F to * |
| LCS | Modify IRSSCN, the status of the scan information.
* - No scan information is present. Non valid scan information may exist and may be printed, however. Default values from SETPAR will be used by SETANG. S - Scan information is present and was determined by the reflection centering routine. I - Scan information is present and was determined by DATCOL, when the reflection was measured for the first time as an intensity control reflection. C - During centering a hardware collission occurred. If this happened the HKL-status is reset to N simultaneously. D - During centering the detector limit switch was sensed. If this happened the HKL-status is reset to N simultaneously. N - During centering noise was detected. If this happened the HKL-status is reset to N simultaneously. W - During centering the reflection was found weak. If this happened the HKL-status is reset to N simultaneously. X - During centering chi became too high. If this happened the HKL-status is reset to N simultaneously. LCS:(contd) Valid modifications are: S to *
|
| LCL | Modify the learnt profile indicator and print the currently stored
profile
* - This reflection has not been used in the learnt profile routine
Valid modifications are: L - *
|