Author: Syd Hall,
Crystallography Centre, University of Western Australia,
Nedlands 6907, Australia
SHELIN reads a standard Shelx (Sheldrick, 1986)
input file and extracts those commands and data required to
perform the standard data initialization calculations
STARTX
,
ADDREF
and
ADDATM
. Any other XTAL calculations using the archive bdf
generated by these routines may directly follow the SHELIN
input. As well as the archive bdf, SHELIN generates a line
file for subsequent applications.
SHELIN originally worked by including the
SHELX.ins
instruction
file inline within the Xtal
.dat
input stream. To
aid and facilitate data exchange, this behaviour is now
activated only by use of the
old command line option.
The new default behaviour is to read external
.ins
and
.hkl
files, although
thereafter the behaviour is largely as documented below.
Any SHELX dummy
Q atom sites are now written as peaks
to a
compid.pek
file. These
can then be viewed within the Xtal molecular graphics
program PIG.
All Shelx commands and data may be input into SHELIN
but only the following commands are used to generate XTAL
input data. Shelx commands and data not listed below will
be ignored.
The lines
CELL
to
UNIT
must be entered first, and in this
order. They are used to initialize the STARTX
calculation.
The
HKLF
line is
used to initialize the
ADDREF
calculation. If
code
is blank
the format of the reflection data is assumed to
be'3I4,2F8.2'. If
code
is
nonblank the format is assumed to be '3I3,F7.2,F6.2'. The
reflection data input sequence is terminated by a
reflection with h=k=l=0
or h=k=l=99.
The
FVAR
line is
used to initialize the
ADDATM
calculation. The parameter K is the Frel scale
factor. Both formats of the standard atom lines may be
entered in any order (either with an isotropic U (one line)
or with anisotropic U's(two lines)). If anisotropic U's are
entered, it is assumed that U11 and U22 are on the first
line followed by an '='. An
END
line must
follow the last atom line,
and this
END
must be
the last line in the Shelx sequence.
The use of the
END
line in a
Shelx sequence has a special meaning for SHELIN. It is
assumed to close the SHELIN sequence. Be careful to remove
any superfluous
END
lines from
the SHELIN file.
SHELIN is a relatively special program within the
XTAL System in that it both
creates the input data for
STARTX
(and optionally
ADDREF
and/or
ADDATM
), and then directly
initiates the execution of these
routines.
The first stage of SHELIN is to read the SHELX
commands and data from the standard line file and converts
these into the equivalent XTAL control and data lines.
These are output to the formatted file
shx
.Only the selected
SHELX commands and data lines described above are
interpreted.
The second stage of SHELIN is to redirect the line
input stream from the file
shx.
This means that
after the
END
line
terminating the SHELIN lines, the nucleus starts to input
the generated XTAL lines from
shx
and these are used
to control the XTAL calculations
STARTX
,
ADDREF
and
ADDATM
.
The second last line in the
shx
file is the command
'
reset
inp <ioinp:>'. This command causes the line
input stream to be returned to normal line input
, so that additional XTAL commands may
be executed. It should also be noted that the lines in
shx
may also be used in
subsequent XTAL applications without having to use the
SHELIN sequence.
-
A SHELIN run sequence writes and reads archive
bdf's
-
Reads a SHELX
ins
input
file
-
Optionally reads a SHELX
hkl
reflection
file
-
Writes XTAL input lines to the line file
shx
-
Optionally writes dummy sites to the Xtal
binary
pek
file
The output line file
SHX
for the above
example follows: