20.5 Some practicalities 325
other codes – see the appropriate page inthe IUCrjournalswebsite
for the full list.
(b) Certain trivial errors occur frequently and can cause a great deal
of annoyance because the CIF processing software does exactly
what you tell it to, rather than what you want. CIF checking
software (see below) will strive to return helpful reports on the
location of errors in the data file, but sometimes the results of the
fault are so pervasive, or appear so far removed from the orig-
inal error, that a manual search is necessary. Some of the most
common and irritating faults arise from the simplest of causes,
such as the failure to have matching subscript and superscript
codes: forgetting to ‘switch off’ these features means that subse-
quent information in the CIF is misinterpreted. Another frequent
mistake is not terminating text strings or text blocks correctly.
(c) Within a CIF, the selection of molecular geometry parameters for
publication depends on the setting of the _geom_type_publ_
flag for each parameter, where type is bond, angle or
torsion. Setting a flag to Yes (or y) indicates that the corre-
sponding parameter should be published: anything else (No, n or
?, for example) means that it will not. Make sure that this editing
does not disrupt the number of data items (including placehold-
ers), as doing so will create problems for any program attempting
to read the CIF.
20.5.3 Checking the CIF
Before a CIF is used, for whatever purpose, it is essential to sub-
mit it for automated checking. The checkCIF procedure tests for valid
CIF data names, correct syntax, missing IUCr Journals Commission
requirements, consistency of crystal data, correct space group, unusual
atomic displacement parameter values, completeness of diffraction
data, etc. It is available through the IUCr website (www.iucr.org), and
the current version returns reports within a few seconds. Depending on
the intended purpose of the CIF, failure to satisfy certain of these tests
(e.g. missing Journals Commission requirements) may not be impor-
tant as they are designed primarily as a check on a data file before
electronic submission to Acta Crystallographica. If you have a way of
reading PDF files, such as the free program Adobe Reader, you should
take advantage of another utility: printCIF, also available through the
IUCr website, returns a preprint of your paper for checking. This is
valuable because some errors, especially formatting ones, may not be
detected by checkCIF but they are usually horribly obvious on a preprint.
The IUCr program publCIF (Westrip, 2009) includes the same function-
ality as printCIF but, like enCIFer, it is interactive, offering an HTML
representation of the required CIF publication data. You can also carry
out useful additional checks with programs such as PLATON (Spek,
2003) running on your own computer: these include not only numerical
checks but also visual checks of conformation, ellipsoid plots and other