|
MODHKL
: Modify reflection data
Author: Syd Hall,
Crystallography Centre, University of Western Australia,
Nedlands 6907, Australia
MODHKL edits specific reflections in the bdf,
global changes to reflection codes, global deletion of
reflection items or the removal of reflection packets from
the bdf.
During the course of a structure analysis, it may be
necessary to make small changes to the reflection data.
This program facilitates easy modification of reflection
data stored in a bdf. Complicated changes such as the
inclusion of new information for every reflection, changes
in cell parameters, or expansion of the number of items
stored for every reflection will require the use of
programs such as
ADDREF
.
MODHKL may be used to make four different types of
changes to the reflection data. In all cases the items
accessed in a bdf reflection packet are identified by their
ID numbers listed in the BDF section at the back of the
manual. The user may modify any existing data in
lrrefl:
on the bdf. It is possible to reduce the size of
packets by eliminating items. However, expansion of the
packets is not possible.
The
rcode line enables the
global change of
reflection codes according to two
entered conditions. Each condition on the
rcode line is composed
of four input fields in the order: factor1, item1,
factor2, item2. The factors 1 and 2 are floating-point
multipliers, and items 1 and 2 are the bdf directory
numbers for the specified items. Values are applied for
each condition using the following expression to give a
TRUE or a
FALSE result:
factor1*item1 > factor2*item2
If both conditions are specified, then the new
rcode will replace the old rcode only if BOTH conditions
are
TRUE. If only condition 1 is
specified, then condition 2 will be ignored and the rcode
will be changed when condition 1 is
TRUE. When the new rcode is already
equal to the old rcode, the reflection is NOT listed as
changed even if the conditions are true. The
rcode line may be used
only if an rcode already exists on the bdf.
Only one
rcode line may be
entered.
The
remove line enables the
global removal of quantities from the reflection packets
of a bdf. The fields of the
remove line(s) must
contain valid reflection packet directory numbers for the
items to be removed from all packets. These numbers must
not be used again in the run. For example, if
purge lines follow, the
same directory numbers cannot appear in these
lines.
The
purge line is used to
remove reflection packets from the bdf according to the
specified conditions 1 and 2. The general form of these
conditions is identical to the
rcode line. If both
conditions are entered, then both must be true before a
reflection is purged. If only one condition is entered,
then a reflection is purged if this condition is true.
The
purge line acts to
remove reflections while the
remove line removes
items for every reflection whether some
purge condition is set
or not. It is not possible to set a purge condition based
upon an item which is specified to be removed.
Only one
purge line may be
entered.
Specific
modify and
delete Options
The
modify and
delete lines are used
to modify and to delete specific reflections.
modmul and
delmul are equivalent
commands suitable for editing macromolecule data where
there are multiple occurrences of the same reflection.
These have been sorted on hkl but not averaged.
The input lines
modify,
modmul,
delete, and
delmul
must be entered in the
same sort order as the reflections on the input bdf. If
this condition is not met an error will occur at the end
of processing.
The difference between
modify and
modmul (and between
delete and
delmul ) is that there
exists one additional field containing the occurrence
number. The occurrence number is the count of which
measurement for a given hkl is to be treated; one for the
first, two for the second, etc. With use of these lines
it is possible to remove reflection packets from the bdf
or to modify individual data stored on the bdf. If the
occurrence number is omitted, all occurrence will be
processed.
Note that neither the hkl nor the
multiplicity-epsilon items may be changed by use of
MODHKL. They are "packed" floating point words and are
outside the scope of this program.
In this example the items for the F(rel) and
F(rel) and their
Friedel mates will be remove from all packets. In addition,
the second occurance of the (1,1,1) reflection will be
dropped from the bdf.
|