Discussion List Archives

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

CIF dictionary register dictionary

  • To: comcifs@iucr.org
  • Subject: CIF dictionary register dictionary
  • From: Brian McMahon <bm@iucr.org>
  • Date: Sat, 19 Mar 2005 16:29:51 +0000
In considering the inclusion of the CIF dictionary register
(ftp://ftp.iucr.org/pub/cifdics/cifdic.register)
on the Volume G CD-ROM, I noticed that there is no formal
description of the tags used in that file to identify the
CIF dictionaries. I have therefore constructed a dictionary
of the data names in that file, which I attach below for your
information and comment. This dictionary can also be found at

  loop_
    _cifdic_dictionary.name
    _cifdic_dictionary.version
    _cifdic_dictionary.DDL_compliance
    _cifdic_dictionary.reserved_prefix
    _cifdic_dictionary.URL
    _cifdic_dictionary.description
  cif_register.dic   .   1.4  .
      ftp://ftp.iucr.org/pub/cifdics/cif_register.dic
      'Data items used within the register of published CIF dictionaries'
  cif_register.dic   1.0   1.4  .
      ftp://ftp.iucr.org/pub/cifdics/cif_register_1.0.dic
      'Data items used within the register of published CIF dictionaries'

and this information will of course be added to the version of the
dictionary registered issued upon publication of Volume G.

Regards
Brian


#------------------------------------------------------------------------------

##############################################################################
#                                                                            #
#                   CIF DICTIONARY REGISTER DEFINITIONS                      #
#                   -----------------------------------                      #
#                                                                            #
# This dictionary contains the names and definitions of data items           #
# recognised by the International Union of Crystallography for identifying   #
# and locating public CIF dictionaries in a standard dictionary register.    #
#                                                                            #
# Copyright 2005 International Union of Crystallography                      #
##############################################################################


data_on_this_dictionary
    _dictionary_name            cif_register.dic
    _dictionary_version         1.0
    _dictionary_update          2005-03-19
    _dictionary_history
;
   2005-03-19  First version formalises the data items in the
               register of CIF dictionaries located at
               ftp://ftp.iucr.org/pub/cifdics/cifdic.register
               (Brian McMahon)
;

#######################
## CIFDIC_DICTIONARY ##
#######################

data_cifdic_dictionary_[]
    _name                      '_cifdic_dictionary_[]'
    _category                    category_overview
    _type                        null
    loop_ _example
          _example_detail
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
;
    loop_
      _cifdic_dictionary.name
      _cifdic_dictionary.version
      _cifdic_dictionary.DDL_compliance
      _cifdic_dictionary.reserved_prefix
      _cifdic_dictionary.URL
      _cifdic_dictionary.description
        cif_core.dic    .    1.4   .
          ftp://ftp.iucr.org/pub/cifdics/cif_core.dic
          'Core CIF Dictionary'
        cif_core.dic   1.0   1.4   .
          ftp://ftp.iucr.org/pub/cifdics/cifdic.C91
          'Original Core CIF Dictionary'
        cif_core.dic  2.0.1  1.4   .
          ftp://ftp.iucr.org/pub/cifdics/cif_core_2.0.1.dic
          'Core CIF Dictionary'
        cif_core.dic  2.1    1.4   .
          ftp://ftp.iucr.org/pub/cifdics/cif_core_2.1.dic
          'Core CIF Dictionary'
        cif_core.dic  2.2    1.4   .
          ftp://ftp.iucr.org/pub/cifdics/cif_core_2.2.dic
          'Core CIF Dictionary'
        cif_core.dic  2.3    1.4   .
          ftp://ftp.iucr.org/pub/cifdics/cif_core_2.3.dic
          'Core CIF Dictionary'
;
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
;    Example 1 - extract from the IUCr CIF dictionary register identifying
                 several revisions of the core CIF dictionary.
;
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    _definition
;              The single category CIFDIC_DICTIONARY contains all the 
               attributes required to identify and locate an individual
               public CIF dictionary file. Although the primary version
               of this dictionary is maintained as a DDL1 dictionary,
               the data names have an embedded period character after the
               category prefix to allow strict isomorphism with a DDL2
               equivalent.
;

data_cifdic_dictionary.DDL_compliance
    _name                      '_cifdic_dictionary.DDL_compliance'
    _category                    cifdic_dictionary
    _type                        char
    _list                        yes
    _definition
;              The version string of the CIF dictionary definition language
               (DDL) used to record data item attributes in the dictionary.
;

data_cifdic_dictionary.description
    _name                      '_cifdic_dictionary.description'
    _category                    cifdic_dictionary
    _type                        char
    _list                        yes
    _definition
;              A succinct textual description of the dictionary.
;

data_cifdic_dictionary.name
    _name                      '_cifdic_dictionary.name'
    _category                    cifdic_dictionary
    _type                        char
    _list                        yes
    _list_mandatory              yes
    _definition
;              The string used as an identifying label within the dictionary
               file (as data item _dictionary_name for DDL1 dictionaries
               or _dictionary.title for DDL2 dictionaries).
;

data_cifdic_dictionary.reserved_prefix
    _name                      '_cifdic_dictionary.reserved_prefix'
    _category                    cifdic_dictionary
    _type                        char
    _list                        yes
    _definition
;              A prefix reserved for use within a dictionary not maintained
               directly by COMCIFS. The value of this data item must match
               an entry in the register of reserved prefixes maintained by
               COMCIFS (http://www.iucr.org/iucr-top/cif/spec/reserved.html).
               The special CIF value '.' ('inapplicable') is used in the
               case of COMCIFS-maintained dictionaries.
;

data_cifdic_dictionary.URL
    _name                      '_cifdic_dictionary.URL'
    _category                    cifdic_dictionary
    _type                        char
    _list                        yes
    _list_mandatory              yes
    _definition
;              The uniform resource locator (URL) at which the dictionary
               may be found on the web.
;

data_cifdic_dictionary.version
    _name                      '_cifdic_dictionary.version'
    _category                    cifdic_dictionary
    _type                        char
    _list                        yes
    _list_mandatory              yes
    _definition
;              The string used as a version identifier within the dictionary
               file (as data item _dictionary_version for DDL1 dictionaries
               or _dictionary.version for DDL2 dictionaries). This may be
               any legitimate string, but COMCIFS practice recommends a
               version identifier of the form n.m.l..., where n, m, l, ...
               are integers referring to progressively less significant
               revision levels. The special CIF value '.' is used to indicate
               the current version.
;

#------------------------------------------------------------------------------

cifregister.pdf


Reply to: [list | sender only]