- Added missing issing doc files
This commit is contained in:
76
doc/manager/rs232.htm
Normal file
76
doc/manager/rs232.htm
Normal file
@ -0,0 +1,76 @@
|
||||
<HTML>
|
||||
<HEAD>
|
||||
<TITLE>Direct Access to RS232 Controllers</TITLE>
|
||||
</HEAD>
|
||||
<BODY>
|
||||
<H1>Direct Access to RS232 Controllers</H1>
|
||||
<P>
|
||||
Usually serial ports are accessed by SICS through David Maden's
|
||||
SerPortServer program which then communicates with a terminal server
|
||||
box through the TCP/IP network. This limits the amount of control over
|
||||
the controller. If more control is required, the RS232 controllers can
|
||||
be accessed directly from SICS through the terminal server, thereby
|
||||
bypassing the SerPortServer program. Please note, that these two modes
|
||||
of operation are mutually exclusive: a given port can either be
|
||||
accessed through the mechanism described here OR through
|
||||
SerPortServer.
|
||||
</P>
|
||||
Before being able to use this system, the RS232 controller has to be
|
||||
configured into SICS as described in the hardware initialization
|
||||
section through the following command in the initialization file:
|
||||
<pre>
|
||||
MakeRS232Controller name terminalserver port
|
||||
</pre>
|
||||
For example:
|
||||
<pre>
|
||||
MakeRS232Controller hugo psts213 3004
|
||||
</pre>
|
||||
name is the SICS name for the controller, terminalserver is the name
|
||||
of the terminal server the device is connected to and port is the port
|
||||
number at which the terminal server publishes the RS232 channel to
|
||||
which the device is connected. This is usally the port number plus 3000.
|
||||
</p>
|
||||
<p>
|
||||
Now various commands are available for interfacing with the RS232
|
||||
controller. In the following description the SICS name of the
|
||||
controller is replaced by the symbol rs232name.
|
||||
<dl>
|
||||
<dT>rs232name sendterminator
|
||||
<dD>prints the current terminator used when sending data to the device
|
||||
as hexadecimal numbers.
|
||||
<dT>rs232name sendterminator h1h2..hn
|
||||
<dD>sets the current terminator used when sending data to the device
|
||||
to the characters described by the hexadecimal numbers h1 to hn. The
|
||||
numbers are in the format 0xval, where val is the hex number.
|
||||
<dT>rs232name replyterminator
|
||||
<dD>prints the current terminator expected to terminate a response
|
||||
from the device as a hexadecimal number.
|
||||
<dT>rs232name replyterminator h1h2..hn
|
||||
<dD>sets the current terminator expected to terminate a response from
|
||||
the device to the characters described by the hexadecimal numbers h1
|
||||
to hn.
|
||||
The numbers are in the format 0xval, where val is the hex number.
|
||||
<dt>rs232name timeout
|
||||
<dd>prints the current timeout when waiting for a reponse from the
|
||||
device.
|
||||
<dt>rs232name timeout val
|
||||
<dd>sets the timeout for waiting for responses from the device. The
|
||||
value is in microseconds.
|
||||
<dt>rs232name send data data data
|
||||
<dd>sends the remainder of the line to the RS232 device and waits for
|
||||
a response terminated with the proper reply terminator specified. This
|
||||
commands waits at maximum timeout microseconds for a response. If a
|
||||
valid response is obtained it is printed, otherwise an error message
|
||||
occurs.
|
||||
<dt>rs232name write data data data
|
||||
<dd>writes the remainder of the line after write to the device without
|
||||
waiting for a response.
|
||||
<dt>rs232 available
|
||||
<dd>checks if data is pending to be read from the device.
|
||||
<dt>rs232 read
|
||||
<dd>reads data from the device.
|
||||
</dl>
|
||||
</p>
|
||||
|
||||
</BODY>
|
||||
</HTML>
|
151
doc/user/autocloud.htm
Normal file
151
doc/user/autocloud.htm
Normal file
@ -0,0 +1,151 @@
|
||||
<HTML>
|
||||
<HEAD>
|
||||
<TITLE>Autocloud</TITLE>
|
||||
</HEAD>
|
||||
<BODY>
|
||||
<H1>Autocloud</H1>
|
||||
<P>
|
||||
With the advent of position sensitive detectors in X-ray and neutron
|
||||
diffraction the problem arises how integrated reflection intensities
|
||||
may be extratcted from the collected volumes of data. Typically a
|
||||
series of frames is measured while rotating the crystal under
|
||||
investigation in omega. Autocloud implements a novel approach for the
|
||||
extraction of reflection intensities from such data. Other currently
|
||||
used integration packages use a UB-matrix to predict the position of a
|
||||
reflection on the detector and then integrate the intensity in a box
|
||||
around the predicted position. In contrast autocloud tries to
|
||||
determine reflection
|
||||
positions and intensities directly from the data. In order to do so a
|
||||
template matching algorithm is used. One advantage of this approach is
|
||||
that crystals with magnetic or incommensurate structures can be easily
|
||||
analysed. Typically packages for intensity integration do not have
|
||||
facilities for predicting such reflections. The other advantage is ease
|
||||
of use. Data analysis with autocloud requires only two steps:
|
||||
Integration followed by indexing.
|
||||
</P>
|
||||
|
||||
<h2>Running Autocloud</h2>
|
||||
<p>
|
||||
The syntax is:
|
||||
<pre>autocloud options datafile
|
||||
</pre>
|
||||
The following options are known:
|
||||
<dL>
|
||||
<dt>-a val
|
||||
<dd>Selects the algorithm to use. The following algorithms are
|
||||
currently supported:
|
||||
<dl>
|
||||
<dt>max
|
||||
<dd>perform only a local maximum search
|
||||
<dt>template
|
||||
<dd>Perform template matching. This is the default.
|
||||
<dt>cross
|
||||
<dd>Perform template matching using the cross correlation function.
|
||||
</dl>
|
||||
<dt>-b AAxBBxCC
|
||||
<dd>For the evaluation of the initial template a preliminary box size
|
||||
is needed. This can be specified through this option. Three values
|
||||
separated by the character 'x' are required, one for each dimension in
|
||||
the order x, y, z.
|
||||
<dt>-d val
|
||||
<dd>After the correlation of the data volume with the template another
|
||||
maximum search is started in order to locate the reflections. In order
|
||||
to suppress spurious peaks, a minimum steepness of the candidate peak
|
||||
can be set with the -d option.
|
||||
<dt>-e val
|
||||
<dd>Some systems store frames a single files. With the -e option the
|
||||
end file number of the frame files can be set.
|
||||
<dt>-m val
|
||||
<dd>When the maximum search only option is set a, a threshold is
|
||||
required for suppressing spurious peaks. This threshold can be set
|
||||
with the -m option.
|
||||
<dt>-o file
|
||||
<dd>Redirects output to the file name specified. By default all output
|
||||
is written to stdout.
|
||||
<dt>-s val
|
||||
<dd>Some systems store frames a single files. With the -s option the
|
||||
start file number of the frame files can be set.
|
||||
<dt>-t type
|
||||
<dd>This option sets the type of the data file. Currently understood
|
||||
are:
|
||||
<dl>
|
||||
<dt>sxd
|
||||
<dd>For NeXus data from SXD at ISIS.
|
||||
<dt>trics
|
||||
<dd>For NeXus data files from TRICS, SINQ
|
||||
<dt>debug
|
||||
<dd>An internal format used during software testing.
|
||||
</dl>
|
||||
<dt>-v val
|
||||
<dd>Increases the verbosity of the output.
|
||||
</dl>
|
||||
</p>
|
||||
|
||||
<h2>The Autocloud Algorithm</h2>
|
||||
<p>
|
||||
The autocloud algorithm has the following steps:
|
||||
<ol>
|
||||
<li>Location of strong peaks for template evaluation.
|
||||
<li>Background Subtraction.
|
||||
<li>Evaluation of a template for volume matching.
|
||||
<li>Correlation of the template with the data volume.
|
||||
<li>Location of maxima in the correlated data.
|
||||
<li>Integration of the reflections found.
|
||||
</ol>
|
||||
</p>
|
||||
<h3>Location of Strong Peaks for Template Evaluation</h3>
|
||||
<p>
|
||||
This is basically a local maximum detection scheme. A local maxima
|
||||
must be the strongest intensity within a 7 by 7 by 7 volume. All
|
||||
maxima smaller then 10% of the largest maximum found are discarded.
|
||||
</p>
|
||||
|
||||
<h3>Background Subtraction</h3>
|
||||
<p>
|
||||
Background subtraction is done with essentially the same algorithm XDS
|
||||
uses. For each x, y coordinate in the frame values are summed along
|
||||
the third dimension. Points belonging to a local maimum are
|
||||
excluded. The background
|
||||
for this x,y coordinate is then the average of the values
|
||||
summed. The data volume is then corrected for the background with
|
||||
these values. This works well as long as the assumption holds that the
|
||||
background varies mostly across the detector and not much with the
|
||||
third dimension.
|
||||
</p>
|
||||
|
||||
<h3>Template Evaluation</h3>
|
||||
<p>
|
||||
The template to be used for template matching later on is calculated
|
||||
by summing all local maxima first. Then the limits of the reflection
|
||||
are calculated for each scanline using the Lehmann-Larsen
|
||||
algorithm. The reflection thus found is scaled to a value of 1 and
|
||||
used as the template.
|
||||
</p>
|
||||
|
||||
<h3>Template Matching</h3>
|
||||
<p>
|
||||
For the actual correlation of the template with the data two variantes
|
||||
can be used: Normal simple correlation or cross correlation.
|
||||
</p>
|
||||
|
||||
<h3>Peak Detection</h3>
|
||||
<p>
|
||||
This is again a local maximum detection within a 7 by 7 by 7
|
||||
box. Another criterium for the supression of wrong identifications is
|
||||
a minimum steepness. This means that the candidate local maximum must
|
||||
at least be higher by a certain amount (the steepness) then the points
|
||||
at the border of its 7 by 7 by 7 box.
|
||||
</p>
|
||||
|
||||
<h3>Peak Integration</h3>
|
||||
<p>
|
||||
A scale factor is calculated for each candidate reflection between the
|
||||
data and the template. The intensity is derived from this scale factor
|
||||
and the standard deviation is calculated as the squared difference
|
||||
between the scaled template and the data. This scheme is the same as
|
||||
learnt profile fitting as described by Ford for the 1- and 2d cases.
|
||||
</p>
|
||||
|
||||
</BODY>
|
||||
</HTML>
|
||||
|
98
doc/user/peaksearch.htm
Normal file
98
doc/user/peaksearch.htm
Normal file
@ -0,0 +1,98 @@
|
||||
<HTML>
|
||||
<HEAD>
|
||||
<TITLE>TRICS PSD Peak Search</TITLE>
|
||||
</HEAD>
|
||||
<BODY>
|
||||
<H1>TRICS PSD Peak Search</H1>
|
||||
<P>
|
||||
For almost any measurement at TRICS a UB matrix has to be determined
|
||||
beforehand. In order to do this a couple of peak must be located by
|
||||
some means. This section describes how the computer can help in
|
||||
finding an initial set of peaks.
|
||||
</P>
|
||||
<p>
|
||||
The algorithm is quite simple: It consists of a big loop over ranges
|
||||
of the four circle angles two theta, omega, chi and phi. At each
|
||||
position a counting operation is performed. Then peaks are located on
|
||||
all three detectors through a local maximum search. For this, the
|
||||
<a href="lowmax.htm">local maximum search</a> module is used.
|
||||
If a candidate
|
||||
peak is found, it is refined in omega and written to a file. The
|
||||
tricky bit is the adjustement of the local maximum search parameters
|
||||
in order to minimize false maxima caused by a spicky background or
|
||||
powder lines.
|
||||
</p>
|
||||
<p>
|
||||
The peak search facility need a lot of parameters in order to
|
||||
operate. This includes angle ranges, count parameters and the maximum
|
||||
search parameters. Commands are provided for adjusting these
|
||||
parameters. The general operation of these commands follow a pattern:
|
||||
typing the command alone prints the current values of the
|
||||
parameters. In order to set new values the command name must be typed
|
||||
plus new values for all the parameters listed by this command. An
|
||||
Example:
|
||||
<pre>
|
||||
ps.sttrange
|
||||
</pre>
|
||||
prints the range in two theta for the peaksearch.
|
||||
<pre>
|
||||
ps.sttrange startval endval step
|
||||
</pre>
|
||||
sets new values for the two theta range and prints them afterwards.
|
||||
The following commands are provided:
|
||||
<dl>
|
||||
<dt>ps.sttrange
|
||||
<dd>adjustment of the two theta range for the peak search.
|
||||
<dt>ps.omrange
|
||||
<dd>adjustment of the omega range for the peak search.
|
||||
<dt>ps.chirange
|
||||
<dd>adjustment of the chi range for the peak search.
|
||||
<dt>ps.phirange
|
||||
<dd>adjustment of the phi range for the peak search.
|
||||
<dt>ps.countpar
|
||||
<dd>adjustment of the counting parameters for the peak search.
|
||||
<dt>ps.scanpar
|
||||
<dd>adjustment of the parameters used by ps.scanlist for scanning
|
||||
located peaks. See below.
|
||||
<dt>ps.maxpar
|
||||
<dd>Adjusts the maximum finding parameters for the peak search. These
|
||||
parameters need some explanation:
|
||||
<dl>
|
||||
<dt>window
|
||||
<dd>window is the size of the quadratic area which will be searched
|
||||
around each point in order to determine if it is a local maximum.
|
||||
<DT>threshold
|
||||
<dd>This is a minimum intensity a candidate local maximum must have
|
||||
before it is accepted as a peak. The value given is multiplied
|
||||
with the average counst on the data frame before use. This threshold
|
||||
is the strongest selection parameter.
|
||||
<dt>steepness
|
||||
<dd> A candidate peak should drop of towards the sides. This is
|
||||
tested for by checking if the pixels on the borders of the local
|
||||
maximum detection window are below maximum value - steepness.
|
||||
<dt>cogwindow
|
||||
<dd>In order to refine the peaks position a center of gravity
|
||||
calculation is perfomed. For this calculation pixels within the
|
||||
cogwindow around the candidate peak position are considered.
|
||||
<dt>cogcontour
|
||||
<dd>In order not to base the COG calculation on background pixels,
|
||||
only pixels above cogcontour * maxvalue are used for the
|
||||
calculation. With the spicky background at TRICS .5 seems a good value.
|
||||
</dl>
|
||||
<dt>ps.list
|
||||
<dd>lists all parameters for the peak search.
|
||||
<dt>ps.listpeaks
|
||||
<dd> lists all the peaks already found.
|
||||
<dt>ps.run filename
|
||||
<dd>starts the peak search and stores peaks identified in file
|
||||
filename.
|
||||
<dt>ps.continue
|
||||
<dd>continues a peak search which was interrupted for one reason or
|
||||
another.
|
||||
<dt>ps.scanlist
|
||||
<dd>performs an omega scan for each reflection found in the current
|
||||
peak list.
|
||||
</dl>
|
||||
</P>
|
||||
</BODY>
|
||||
</HTML>
|
16
doc/user/psddata.htm
Normal file
16
doc/user/psddata.htm
Normal file
@ -0,0 +1,16 @@
|
||||
<HTML>
|
||||
<HEAD>
|
||||
<TITLE>TRICS PSD Data Analysis</TITLE>
|
||||
</HEAD>
|
||||
<BODY>
|
||||
<h1>TRICS PSD Data Analysis</h1>
|
||||
<p>
|
||||
As of now two packages are provided:
|
||||
<ul>
|
||||
<li>A data analysis package based on <a href="xds.htm">XDS</a>.
|
||||
<li>An experimental package based on a
|
||||
novel <a href="auto.htm">volume matching </a> approach.
|
||||
</ul>
|
||||
</P>
|
||||
</BODY>
|
||||
</HTML>
|
1
doc/user/tascommands.html
Normal file
1
doc/user/tascommands.html
Normal file
@ -0,0 +1 @@
|
||||
<h2><a name="Commands">TASMAD Commands</a></h2>
|
1
doc/user/tasvariables.html
Normal file
1
doc/user/tasvariables.html
Normal file
File diff suppressed because one or more lines are too long
34
doc/user/trscan.htm
Normal file
34
doc/user/trscan.htm
Normal file
@ -0,0 +1,34 @@
|
||||
<HTML>
|
||||
<HEAD>
|
||||
<TITLE>TRICS specific Count and Scan Command </TITLE>
|
||||
</HEAD>
|
||||
<BODY>
|
||||
<H1>PSD-TRICS Count and Tricsscan Command</H1>
|
||||
<P>
|
||||
Two special commands have been defined for TRICS with a PSD:
|
||||
<dl>
|
||||
<dt>count <tt>mode preset </tt>
|
||||
<dd>counts with all three detectors. The parameter mode defines which
|
||||
counting mode is used, supported are <b>preset</b> for counting up to a
|
||||
preset monitor or <b>timer</b> for counting for a specified time intervall.
|
||||
The second prameter preset is either the preset monitor or the preset
|
||||
counting time, depending on the mode choosen. Both parameters are
|
||||
optional, if they are notc specified values from the last run will be used.
|
||||
count does not store any data.
|
||||
<dt>tricsscan <tt>start step np mode preset</tt>
|
||||
<dd>This command creates a new data file and then performs a scan in omega,
|
||||
storing meausured data after each step. <tt>start step np</tt> define the
|
||||
scan range in omega. Start is the start position, step the step width to
|
||||
use and np is the number of steps to do. The optional parameters mode and
|
||||
preset have the same meaning as in the count command described above.
|
||||
Mode and preset how data is collected at each step in omega.
|
||||
<dt>psdrefscan filename step np mode preset
|
||||
<dd>reads reflection HKL values from file filename and performs
|
||||
tricsscans for each reflection. These will be done eith step width
|
||||
step, the number of steps np with counting mode mode and a preset of
|
||||
preset. These parameters have the same meaning as described above.
|
||||
</dl>
|
||||
</P>
|
||||
|
||||
</BODY>
|
||||
</HTML>
|
359
doc/user/xds.htm
Normal file
359
doc/user/xds.htm
Normal file
@ -0,0 +1,359 @@
|
||||
<HTML>
|
||||
<HEAD>
|
||||
<TITLE>TRICS Data Analysis with XDS</TITLE>
|
||||
</HEAD>
|
||||
<BODY>
|
||||
<H1>TRICS Data Analysis with XDS</H1>
|
||||
<P>
|
||||
A set of programs exist for TRICS data analysis which have been derived from
|
||||
the XDS package designed and written by Wolfgang Kabsch. Due to the different
|
||||
diffraction geometry at TRICS the program had to be subdivided. Data Analysis
|
||||
with this system requires four steps:
|
||||
<ol>
|
||||
<li>Location of strong diffraction spots with the program <b>spots</b>.
|
||||
<li>Indexing of diffraction spots and refining of a UB matrix with programs of
|
||||
your choice.
|
||||
<li>Integration of the diffraction spots with the program <b>reflex</b>.
|
||||
<li>Optionally, reflections collected in various runs can be merged
|
||||
with the program <b>xscale</b>.
|
||||
</ol>
|
||||
The main limitation of this software is that only reflections at normal
|
||||
lattice positions can be analysed. Magnetic or superstructure reflections
|
||||
will not be integrated due to the fact that XDS uses predicted reflection
|
||||
positions for integration and has no facilities to predict either magnetic
|
||||
or superstructure reflections.
|
||||
</P>
|
||||
<h2>LEGAL STUFF</h2>
|
||||
<p>
|
||||
The programs <b>spots</b>, <b>reflex</b>and <b>xscale</b> are no
|
||||
official versions of XDS. The responsability for these programs lies
|
||||
with PSI and not with Wolfang
|
||||
Kabsch. Binaries of the above mentioned programs may be distributed, but
|
||||
according to an agreement with Wolgang Kabsch the source code may not be
|
||||
redistributed. If you are interested in an official version of XDS, please
|
||||
contact Wolgang Kabsch directly.
|
||||
</p>
|
||||
|
||||
<h2><b>Spots</b> and <b>reflex</b> Control File</h2>
|
||||
<p>
|
||||
The programs <b>spots</b> and <b>reflex</b> both require a control file
|
||||
to be specified as a command line parameter. The format of this control
|
||||
file resembles a Windows .ini file and is common for both programs. The syntax
|
||||
is: keyword = value.
|
||||
</p>
|
||||
|
||||
<h2>Running <b>spots</b></h2>
|
||||
<p>
|
||||
The purpose of <b>spots</b> is to search for strong diffraction spots
|
||||
in the data and write them out in a format suitable for
|
||||
indexing. spots can be started by typing:
|
||||
<pre>
|
||||
spots controlfile
|
||||
</pre>
|
||||
at the unix command prompt. All necessary parameters live in the
|
||||
control file. spots recognizes the following keywords in the control
|
||||
file:
|
||||
<dl>
|
||||
<dt>numfiles
|
||||
<dd>The number of files to process.
|
||||
<dt>fileXX
|
||||
<dd>Replace XX by the number of the file. For instance file00 is the
|
||||
first file to process. The value for this keyword is the filename to
|
||||
process.
|
||||
<dt>numdetectors
|
||||
<dd>The number of detectors to process. TRICS can have up to three
|
||||
detector banks, if the electronics group finally makes them available
|
||||
by an act of grace.
|
||||
<dt>det1dist, det2dist, det3dist
|
||||
<dd> The respective distances of the detectors from the sample
|
||||
positions.
|
||||
<dt>det1x, det2x, det3x
|
||||
<dd>The number of pixels each detector supports in the x-direction.
|
||||
<dt>det1y, det2y, det3y
|
||||
<dd>The number of pixels each detector supports in the y-direction.
|
||||
<dt>
|
||||
<dt>det1pixx, det2pixx,det3pixx
|
||||
<dd>The size of a detector pixel in x-direction in mm for each detector.
|
||||
<dt>det1pixy, det2pixy,det3pixy
|
||||
<dd>The size of a detector pixel in y-direction in mm for each
|
||||
detector.
|
||||
<dt>wavelength
|
||||
<dd>The neutron wavelength.
|
||||
<dt>bifile
|
||||
<dd>Switches on the writing of reflection positions converted to
|
||||
bissecting positions as from a normal four circle diffractometer. The
|
||||
value is the name of the file to which to write the list.
|
||||
<dt>nbfile
|
||||
<dd>Switches on the writing of reflection positions converted to
|
||||
normal beam positions as from a normal beamdiffractometer. The
|
||||
value is the name of the file to which to write the list.
|
||||
<dt>xyzfile
|
||||
<dd>Switches on the writing of reflection positions in XYZ format. The
|
||||
value is the name of the file to which to write the list.
|
||||
</dl>
|
||||
bifile, nbfile or xyzfile are choices. Chhose the one which fits best
|
||||
with your preferred indexing program.
|
||||
</p>
|
||||
<h2>Indexing and UB Matrix Refinement</h2>
|
||||
<p>
|
||||
For indexing a variety of programs are available:
|
||||
<ul>
|
||||
<li>The ancient combination of index and rafin from ILL. For a
|
||||
description see the four circle single detector section.
|
||||
<li><b>orient</b> A modern indexing program extracted from Difrac. It
|
||||
has originally been written by R. A. Jacobsen, Ames Research
|
||||
laboratory. orient will not only index the reflections found and
|
||||
determine a UB matrix. It will also refine the UB matrix based on the
|
||||
reflections given to it and tries to determine the space group as
|
||||
well.
|
||||
</ul>
|
||||
</p>
|
||||
<h3>Running <b>orient</b></h3>
|
||||
<p>
|
||||
In order to start orient, type <b>orient</b> at the unix prompt. A
|
||||
selection dialog for the file type will show up. Select 2, then give
|
||||
the path to the file created with the spots option bifile. You will
|
||||
also be asked for the neutron wavelength. The following dialogs are
|
||||
self explaining. When orient finishes, the new UB matrix can be found
|
||||
in either the LPT1 or printer.out file.
|
||||
</p>
|
||||
|
||||
<h2>Running <b>reflex</b></h2>
|
||||
<p>
|
||||
<b>reflex</b> is controlled through the same style control.ini file as
|
||||
used by spots. The options specified for <b>spots</b> have to be
|
||||
present in the control file for reflex as well. Additionally the
|
||||
following options are required:
|
||||
<dl>
|
||||
<dt>ub1, ub2, ub3
|
||||
<dd>The three rows of the UB-matrix as determined by one of the
|
||||
indexing programs.
|
||||
<dt>axis=0 0 -1
|
||||
<dd>These are the coordinates of the rotation axis in XDS's own
|
||||
coordinate system. Leave this at the values stated,
|
||||
everything else is shit if you are using TRICS.
|
||||
<dt>beam=0 1 0
|
||||
<dd>These are the coordinates of the incoming neutron beam in XDS's own
|
||||
coordinate system. Leave this at the values stated,
|
||||
everything else is shit if you are using TRICS.
|
||||
<dt>polarisation=.5 1 0 0
|
||||
<DD>Some values for handling X-ray polarisation. Leave at the values
|
||||
given.
|
||||
<dt>spacegroup
|
||||
<dd>Set this to the space group selected. Expected is the number of
|
||||
the space group as given in the international tables.
|
||||
<dt>divergence
|
||||
<dd>The beam divergence. See below for a comment.
|
||||
<dt>mosaic
|
||||
<dd>The crystal mosaic. mosaic and divergence together determine the
|
||||
size of the box in reciprocal space which will be integrated for each
|
||||
reflection. reflex writes a representation of the integration box and
|
||||
of the reflection to its output file (PROFIT.LP). Inspect this
|
||||
carefully. If reflections are cut of in the reflection box or the
|
||||
reflection box is to large, modify these values in order to achieve a
|
||||
good fit. As more experience is gathered, the instrument scientist
|
||||
will be able to provide you with reasonable defaults for these values.
|
||||
</dl>
|
||||
reflex is run by typing <b> reflex control.ini</b> at the unix
|
||||
prompt. control.ini is the name of the control file. PROFIT.LP is the
|
||||
main log file which shows what has been done. PROFIT.HKL is a binary
|
||||
file holding the reflections integrated.
|
||||
</p>
|
||||
|
||||
<h2>Running <b>xscale</b></h2>
|
||||
<p>
|
||||
xscale has not been modified since it has been received from
|
||||
W. Kabsch. Therefore the original documentation, reproduced below is
|
||||
still valid.
|
||||
<pre>
|
||||
C***********************************************************************
|
||||
C********************** DESCRIPTION OF FILES ***************************
|
||||
C***********************************************************************
|
||||
C *
|
||||
C XSCALE.INP (formatted sequential) *
|
||||
C ========== *
|
||||
C *
|
||||
C This file contains the input parameters you have to provide to run *
|
||||
C the XSCALE program.(free format) *
|
||||
C *
|
||||
C line # DESCRIPTION OF INPUT PARAMETERS *
|
||||
C *
|
||||
C 1 Resolution shell limits (Angstrom). Only the high resolution*
|
||||
C limit of each shell is given. Up to NRES (20) resolution *
|
||||
C shells will be accepted. The shell limits must be specified *
|
||||
C in decreasing order. The resolution shells are used to *
|
||||
C report statistical properties of the data sets as a function*
|
||||
C of resolution. *
|
||||
C 2 Space group number and unit cell parameters *
|
||||
C (Angstrom and degrees) *
|
||||
C 3... Each line describes a reflection file used for scaling *
|
||||
C and contains the following items: *
|
||||
C >Optional control character - or * of the following meaning *
|
||||
C -: ignore this data set (this line will be skipped) *
|
||||
C *: put all data sets to the same scale as this one; *
|
||||
C default is the first data set. *
|
||||
C >File name of data set used for scaling. *
|
||||
C The name must not be longer than 50 characters and *
|
||||
C intervening blanks are not allowed. *
|
||||
C >File type must be one of the three following keywords *
|
||||
C DIRECT: the file is of type XDS.HKL as generated by XDS. *
|
||||
C UNIQUE: the file is of type UNIQUE.HKL as produced by XDS.*
|
||||
C OLDHKL: the ASCII file consists of free format records *
|
||||
C H,K,L,INTENSITY,SIGMA *
|
||||
C The standard deviation SIGMA may be omitted and *
|
||||
C is estimated then as SIGMA=0.1*INTENSITY *
|
||||
C Reflection data files of type UNIQUE or OLDHKL *
|
||||
C may be unsorted and the reflection indices need *
|
||||
C not be the asymmetric indices. This simplifies *
|
||||
C the scaling of data sets generated by other *
|
||||
C programs than XDS. *
|
||||
C >Resolution window for accepting reflections from this file *
|
||||
C low resolution limit (Angstrom) *
|
||||
C high resolution limit (Angstrom) *
|
||||
C >Frame separation (mandatory for data sets of type DIRECT) *
|
||||
C specifying the maximum number of frames between FRIEDEL- *
|
||||
C pairs to be included in the estimated anomalous intensity *
|
||||
C difference. *
|
||||
C >Number of batches (optional for data sets of type DIRECT) *
|
||||
C This number gives the number of subdivisions of the *
|
||||
C rotation range covering the data set. Typically, it is *
|
||||
C the total rotation range divided by 2.5...5 degrees, but *
|
||||
C should not exceed a value of 36. This leads to at most *
|
||||
C 9*36=324 scaling factors for a single data set. The total *
|
||||
C number of scaling factors from all data sets together *
|
||||
C must not exceed the value given by "MAXFAC" (1000). *
|
||||
C >SAVE=file-name (optional); default file-name is XSCALE.HKL *
|
||||
C The type of the SAVE-file produced is UNIQUE. Symmetry *
|
||||
C related reflections from input data sets sharing the same *
|
||||
C SAVE-file are used after scaling to estimate a mean *
|
||||
C intensity, an anomalous intensity difference, and their *
|
||||
C standard deviations. Scaling factors for each data set *
|
||||
C are determined from all symmetry related reflections *
|
||||
C regardless whether they go to different SAVE-files. *
|
||||
C *
|
||||
C***********************************************************************
|
||||
C *
|
||||
C XSCALE.LP (formatted sequential) *
|
||||
C ========= *
|
||||
C *
|
||||
C This file contains the printed messages and results from running the *
|
||||
C XSCALE-program. *
|
||||
C *
|
||||
C***********************************************************************
|
||||
C *
|
||||
C Description of XSCALE input file format of type DIRECT as produced *
|
||||
C by XDS. *
|
||||
C *
|
||||
C XDS.HKL (unformatted direct access) *
|
||||
C ======= *
|
||||
C *
|
||||
C The corrected reflection intensities are saved on this unformatted *
|
||||
C direct access file of record length 68 bytes for each reflection. *
|
||||
C The file is sorted with respect to the unique reflection indices. *
|
||||
C This means: *
|
||||
C For each reflection with the original indices H,K,L all symmetry *
|
||||
C equivalent indices are generated including Friedel related ones. *
|
||||
C Among all these indices we choose the unique reflection indices *
|
||||
C HA,KA,LA in the following order: HA is the largest H-index, among *
|
||||
C those with the same HA-value select those with the largest K-index *
|
||||
C which is KA, and finally the largest L-index which is called LA. *
|
||||
C The unique indices HA,KA,LA thus found are packed into a 32-bit *
|
||||
C word KEY=(LA+511)+(KA+511)*1024+(HA+511)*1048576 . *
|
||||
C The reflections are then sorted in growing values of KEY. *
|
||||
C *
|
||||
C Record structure *
|
||||
C *
|
||||
C 16bit-WORD # CONTENTS *
|
||||
C 1 HA (The last record is indicated by HA=10000) *
|
||||
C 2 KA HA,KA,LA are the unique reflection indices. *
|
||||
C 3 LA Any two reflections have the same unique *
|
||||
C indices if and only if they are related by *
|
||||
C symmetry. (HA,KA,LA are integer*2) *
|
||||
C 4 H Original reflection indices H,K,L. *
|
||||
C 5 K H,K,L are integer*2. *
|
||||
C 6 L *
|
||||
C 7 S Identifying number of symmetry operator used *
|
||||
C to go from original to unique indices. *
|
||||
C (integer*2). A negative sign indicates that *
|
||||
C a mirror operation has been applied. This *
|
||||
C information may be useful if a special *
|
||||
C treatment for anomalous differences is *
|
||||
C required which goes beyond the method of *
|
||||
C the XDS-program. *
|
||||
C 8 IPEAK Percentage of observed reflection intensity. *
|
||||
C A value less than 100 indicates either a *
|
||||
C reflection overlap or bad spots in the profile*
|
||||
C 9 ICORR Percentage of correlation (integer*2) between *
|
||||
C observed and expected reflection profile. *
|
||||
C 10,11 FFADD LP-corrected intensity of this reflection *
|
||||
C obtained by straight summation of counts *
|
||||
C within spot region ( background subtracted). *
|
||||
C The intensity is also corrected for radiation *
|
||||
C damage and absorption. (real*4) *
|
||||
C 12,13 SDADD Standard deviation of FFADD.(real*4) *
|
||||
C 14,15 RLP Reciprocal LP-correction factor (real*4) *
|
||||
C 16 ABSCAY Combined absorption and decay correction *
|
||||
C factor*1000 (integer*2). *
|
||||
C In case you want to remove this calculated *
|
||||
C correction, divide intensities and standard *
|
||||
C deviations by ABSCAY/1000.0 . *
|
||||
C 17 IALFA IALFA and IBETA (both integer*2) are polar- *
|
||||
C 18 IBETA coordinates of the spindle axis in units of a *
|
||||
C hundreth of a degree. The lab coordinates of *
|
||||
C the spindle axis are: *
|
||||
C Ux=sin(BETA)*cos(ALPHA) *
|
||||
C Uy=sin(BETA)*sin(ALPHA) *
|
||||
C Uz=cos(BETA) *
|
||||
C where ALPHA=IALFA/5729.578, *
|
||||
C BETA =IBETA/5729.578. *
|
||||
C 19 IFRM Frame number at diffraction of this reflection*
|
||||
C (integer*2) *
|
||||
C 20 PHI Calculated spindle position for this *
|
||||
C reflection at diffraction in units of a *
|
||||
C hundreth of a degree. (integer*2) *
|
||||
C 21 IX, Calculated detector x- and y-coordinates for *
|
||||
C 22 IY this reflection at diffraction in units of a *
|
||||
C tenth of a pixel times 512.0/NX and 512.0/NY, *
|
||||
C respectively. NX, NY are the numbers of pixels*
|
||||
C along the detector X- and Y-axis. *
|
||||
C IX,IY are integer*2. *
|
||||
C 23-28 S0 Laboratory coordinates of direct beam wave- *
|
||||
C vector ( rec. Angstroem). S0 points from the *
|
||||
C x-ray source towards the crystal. *
|
||||
C 29-34 S1 Laboratory coordinates of scattered beam wave-*
|
||||
C vector. Length is 1.0/lambda (rec. Angstroem) *
|
||||
C S0 and S1 are real*4 arrays of length 3. S1 *
|
||||
C points from the crystal towards the detector. *
|
||||
C At diffraction, laboratory coordinates of the *
|
||||
C reflection H,K,L are: S1(.)-S0(.) *
|
||||
C *
|
||||
C***********************************************************************
|
||||
C *
|
||||
C Description of XSCALE input file format of type UNIQUE as produced *
|
||||
C by XDS. *
|
||||
C *
|
||||
C UNIQUE.HKL (formatted sequential) *
|
||||
C ========== *
|
||||
C *
|
||||
C DESCRIPTION OF SHORT OUTPUT FILE *
|
||||
C *
|
||||
C Symmetry related reflections are averaged and written with *
|
||||
C FORMAT(3I5,4E12.4). Each record consists of *
|
||||
C *
|
||||
C HA,KA,LA,INTENSITY,STANDARD DEVIATION OF INTENSITY, *
|
||||
C ANOMALOUS INTENSITY DIFFERENCE,STANDARD DEVIATION OF DIFFERENCE *
|
||||
C *
|
||||
C where HA,KA,LA are the unique reflection indices. The file is sorted *
|
||||
C with respect to these unique reflection indices. The last record *
|
||||
C is indicated by HA=10000. *
|
||||
C Unobserved ANOMALOUS INTENSITY DIFFERENCE and its STANDARD DEVIATION *
|
||||
C are both set to zero. *
|
||||
C *
|
||||
C***********************************************************************
|
||||
</pre>
|
||||
xscale can be started by typing <b>xscale</b> at the unix
|
||||
prompt. Please note that xscale expects an input file named XSCALE.INP
|
||||
in the current directory.
|
||||
</p>
|
||||
</BODY>
|
||||
</HTML>
|
Reference in New Issue
Block a user