Import Free-Form (.inp) File [File menu or button in Startup or Control Window]
See the Import File dialog for general aspects of importing atomic-structure data files.
This type of ASCII or text file may be used in either the Input Atoms dialog in the Input menu, or the the Import option in the File menu, to read in atomic coordinates alone, or to supply complete structure information. Such files are written by the program CRYSCON (Shape Software) which can be used to perform various types of crystallographic conversions, such as sub/supercell, change of origin, change of symmetry, etc. Listings of atomic coordinates from almost any source can be used as the basis of a free-form file.
All or part of the parameters for each input atom, namely label, fractional coordinates, type, radius and display colors and pattern numbers, can be read in. You can also supply default values for some parameters, so that the parameters neither need to be present on every line of the file, nor need to supplied through the dialog.
Except for the TITL line, keywords and actual values to be read in should be separated by spaces or commas, and there should be no spaces within keywords or values. There is no need for alignment by column.
The input file may contain two overall types of lines; General and crystallographic information lines; and actual data or atomic parameter lines.
General and crystallographic information lines. These lines should all precede the atomic parameter lines. Each line consists of a keyword followed by one or more values or character constants. The keyword should start in the first column and be followed by at least one space before the actual values. Where more than one value is called for, they are separated by spaces. All of these lines are optional - when a free-form file is used for import (File menu), if any lines are absent, default values will be supplied. When a free-form file is read through the Input Atoms dialog in the Input menu, current values are kept if the corresponding line is absent.
TITL line. Up to 76 characters (may contain spaces).
CELL line. The unit-cell lengths in Angstroms and the interaxial angles in degrees (6 floating-point values). If the atomic coordinates are Cartesian, the axes should be 1.0 and the angles 90.0.
SPGP line. The Hermann-Maughin or standard International symbol for the space group. There should be no spaces in the symbol, although there may be underscores (which are ignored when the symbol is interpreted.
HALL line. The Hall symbol for the space group. There should be no spaces in the symbol, although there may be underscores (which are ignored when the symbol is interpreted. If this line comes after the SPGP line (or that line is absent), the Hall symbol will be used in the Space Group Symmetry option.
SYMM lines. These give symmetry operators in "xyz" form, that is in the form in which the coordinates of the general position are listed in the International Tables for X-Ray Crystallography. Fractions must be given as integers separated by a slash ("1/2", "2/3"), rather than decimals ("0.5", "0.333"). The x, y and z positions must be separated by commas and there should be no spaces in the operator. There should be one line for each operator. If the space group is centrosymmetric, only half the operators need be given, if the origin is on a center of inversion. If the origin is not on a center, all operators must be given and the space group should be denoted non-centric in the LATT line. If these lines come after the SPGP and HALL lines (if present), the Custom Symmetry option will be used.
LATT line. This gives the Bravais lattice type (single capital character), followed by a space and 0 if the space group is centrosymmetric or 1 if it is non-centric.
FACTOR line. A single (floating-point) factor which multiplies all the fractional or atomic coordinates.
Atomic parameter lines:
The file should have all the information for each atom, except for temperature factors, on a single line with a maximum of 80 characters per line, and the values must be in fields, which are set off or delineated with either spaces or commas. There can be no spaces or commas within fields. The names of fields are given in the following in capitals, but in the actual input they may be lower case; all letters are converted to upper case when the line is read in.
DEFAULT lines supply values to the parameters, such as colors, which are not read in for each atom. If default values are not entered in this way, default values are obtained from the separate ELEMENTS file, using the chemical symbol of the atom which is assumed to be in the first two characters of the atom label. See the further description of DEFAULT lines and the ELEMENTS file below.
FIELDS lines. These lines set up the ATOMS input parameters which are to be read from the file, and the order in which they are to be read.. This is followed by the keywords giving the order of the fields. The allowed keywords are as follows (INTEGER fields may not contain a decimal point) - some of these fields are not used by VIBRATZ, but are given here in case they are seen in a file written by another program:
1) LAB - (6 characters maximum). Any label for the input atom may be used, but the label normally begins with the chemical symbol for the element. The first two characters may be used to determine default values for some of the parameters, as described below. The characters may be upper or lower case, but they are all converted to upper case after input. This is a required field.
2) COO - This actually denotes three floating-point fields giving the fractional atomic coordinates for crystals, or the absolute coordinates for molecules. After input, the coordinates are multiplied by the number in the FACTOR line, if this line is present. These are required fields.
3) TYP - This is the type which is used in force specifications - normally the atomic number. INTEGER
4) RAD - This is the radius used when the atom is plotted as a sphere. FLOATING-POINT ***IGNORED in VIBRATZ
5) RMC - This is the color for the atom rim or edge, in terms of three RGB components 0-255. 3 INTEGERS ***IGNORED in VIBRATZ
6) FLC - This is the color for the atom fill, in terms of three RGB components 0-255. 3 INTEGERS ***IGNORED in VIBRATZ
7) RMP - This is the pattern number or gray shade used in black-and-white display or output. This number is used only for wide lines. INTEGER ***IGNORED in VIBRATZ
8) FLP - This is the b/w pattern number for fills. This is used only if shading is off or the initial pattern number option is on. INTEGER ***IGNORED in VIBRATZ
9) PEN - This is the pen number used for atom outlines in pen plots. INTEGER ***IGNORED in VIBRATZ
10) TFB - Temperature factors in B or bij (beta) form, types 0 (anisotropic) or 6 (isotropic) in ORTEP. If this keyword is present, the temperature factor(s) are present on a second line for each atom, in up to six fields The order is 11, 22, 33, 12, 13, 23. If the second value is absent or zero, the temperature factor will be read as isotropic. Note that ATOMS will save temperature factors only if at least one atom has non-zero for the first value or b11. ***IGNORED in VIBRATZ
11) TFU - Temperature factors in U or uij form, for anisotropic type 8 in ORTEP. Similar to TFB. Isotropic U values will be converted to B values (type 6 in ORTEP). ***IGNORED in VIBRATZ
12) VEC - Atomic vectors, e.g. for magnetic spins or vibrational displacements. If this keyword is present, the vector coefficients are present on a second line, in four fields. The first three are the relative components in the structure axes, and the fourth is the length. Vectors and temperature factors may not both be present. ***IGNORED in VIBRATZ
13) DUM - This designates a field (character, integer or floating-point) that exists in the input data line, but should be ignored by ATOMS.
Note that the actual atom data lines do not contain any keywords. The keywords in the FIELDS lines set up the sequence of parameters in each data line.
An example FIELDS line:
FIELDS DUM LAB COO TYP RAD
Some corresponding data lines:
1 C1 0.1234 0.2345 0.3456 6 1.2
2 H2 0.4321 0.5432 0.6543 1 0.1
Here the first field, which is simply a sequence number, must be ignored by ATOMS, and is designated with a DUM. The last field, RAD, is not used in VIBRATZ - atomic radius is fixed for each atomic type (not for each input atom) and specified in the Atom Types dialog.
Here is an example of some lines copied from an (old) ATOMS.STR file (spinel):
FIELDS DUM LAB TYP COO RAD
1 MG1 12 .12500 .12500 .12500 .000
2 AL2 13 .50000 .50000 .50000 .000
3 O3 8 .26200 .26200 .26200 .000
There should normally be a FIELDS line at the beginning of the atomic parameter lines, but additional FIELDS lines can be inserted at any point to redefine the fields. If there is no FIELDS line, the fields are by default; LAB and COO.
In the actual data lines, fields denoted INTEGER above should not be more than 6 characters; the COO and RAD fields (floating-point) should not be more than 20 characters.
DEFAULT line. This is used to set particular default values for fields other than LAB or COO. DEFAULT must be the first 7 characters. Then the default values are indicated with the name of the field connected with an equals sign (with no intervening spaces) to an appropriate value. Example default line:
DEFAULT TYP=1 RAD=0.95 FLC=15
ELEMENTS.DAT file. This file, in the VIBRATZ folder, gives the default values for atom types as shown in the Atom Types dialog. These are used for import, or when defaults are selected in the Atom Types dialog. The first field in each line is the atomic number or other designated type number. The second field consisting of one or two characters, is usually the normal elemental symbol. The remaining fields give the default values for the radius, color (R, G and B values 0-255), a dummy (not used), weight and charge.