Section 5.3.5.3.1.3. The ancillary map file

The translation between a CIF data name and its replacement text in the output file is defined in the external map file. The format of the translation is very simple, as illustrated in Fig. 5.3.5.7.

Figure 5.3.5.7 | top | pdf | Example map file for use with ciftex.

Each line starts with a CIF data name, which is terminated by a space character. The next character is either ` T' or ` N' to indicate whether the output should be tabulated or not. The next character is an arbitrary character from the ASCII character set, and is chosen to collect together data that will appear in the same logical section of the output file. This locator character may be associated, in another ancillary file described below, with additional text for output. The remainder of the line is the replacement text.

In the example supplied, the cell-length parameters map to the macros \cella, \cellb and \cellc (each preceded by a standard macro forbidding a page break immediately before the contents are printed). The details of the publication authors are described by a set of macros that will occur in two different locations in the output file (the authors' names and addresses may be looped together in the location labelled by the character a; any explanatory footnotes and email addresses will be printed elsewhere in the paper, at the location labelled X). The anisotropic displacement parameters U^ij will be printed in a table and the replacement text consists of the codes that will be printed at the head of each column in the table.

The initial text on the line need not be a CIF data name; it may be any other single word. In this case, every occurrence of that word in the input CIF will be replaced by the replacement text.

If the initial character of the line is a hash mark #, the line is treated as a comment and discarded.