#\#CIF_2.0
##############################################################################
#                                                                            #
#                      DDLm REFERENCE DICTIONARY                             #
#                                                                            #
##############################################################################
data_DDL_DIC

    _dictionary.title            DDL_DIC
    _dictionary.class            Reference
    _dictionary.version          3.11.09
    _dictionary.date             2015-05-07
    _dictionary.uri              www.iucr.org/cif/dic/ddl.dic
    _dictionary.ddl_conformance  3.11.09
    _dictionary.namespace        DdlDic
    _description.text                   
;
     This dictionary contains the definitions of attributes that
     make up the DDLm dictionary definition language.  It provides 
     the meta meta data for all CIF dictionaries.
;

save_ATTRIBUTES

    _definition.id               ATTRIBUTES
    _definition.scope            Category
    _definition.class            Head
    _definition.update           2011-07-27
    _description.text                   
;
     This category is parent of all other categories in the DDLm
     dictionary.
;
    _name.object_id              ATTRIBUTES

save_

#============================================================================

save_ALIAS

    _definition.id               ALIAS
    _definition.scope            Category
    _definition.class            Loop
    _definition.update           2013-09-08
    _description.text                   
;
     The attributes used to specify the aliased names of definitions.
;
    _name.category_id            ATTRIBUTES
    _name.object_id              ALIAS
    _category.key_id             '_alias.definition_id'
    loop_
    _category_key.name
                                 '_alias.definition_id' 

save_


save_alias.definition_id

    _definition.id               '_alias.definition_id'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     Identifier tag of an aliased definition.
;
    _name.category_id            alias
    _name.object_id              definition_id
    _type.purpose                Key
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Tag

save_


save_alias.deprecation_date

    _definition.id               '_alias.deprecation_date'
    _definition.class            Attribute
    _definition.update           2013-09-08
    _description.text                   
;
     Date that the aliased tag was deprecated as a definition tag.
;
    _name.category_id            alias
    _name.object_id              deprecation_date
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Date

save_


save_alias.dictionary_uri

    _definition.id               '_alias.dictionary_uri'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     Dictionary URI in which the aliased definition belongs.
;
    _name.category_id            alias
    _name.object_id              dictionary_uri
    _type.purpose                Identify
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Uri

save_

#============================================================================

save_CATEGORY

    _definition.id               CATEGORY
    _definition.scope            Category
    _definition.class            Set
    _definition.update           2013-09-08
    _description.text                   
;
     The attributes used to specify the properties of a
     "category" of data items.
;
    _name.category_id            ATTRIBUTES
    _name.object_id              CATEGORY

save_


save_category.key_id

    _definition.id               '_category.key_id'
    _definition.class            Attribute
    _definition.update           2011-07-27
    _description.text                   
;
     Tag of a single data item in a Loop category which is the generic key
     to access other items in the category. The value of this
     item must be unique in order to provide unambiguous access to
     a packet (row) in the table of values.  This may be assumed to be a function
     of the datanames listed in category_key.name.
;
    _name.category_id            category
    _name.object_id              key_id
    _type.purpose                Identify
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Tag

save_

#============================================================================

save_CATEGORY_KEY

    _definition.id               CATEGORY_KEY
    _definition.scope            Category
    _definition.class            Loop
    _definition.update           2014-09-18
    _description.text                   
;
     The attributes used to specify (possibly multiple) 
     keys for a given category.
;
    _name.category_id            CATEGORY
    _name.object_id              CATEGORY_KEY
    _category.key_id             '_category_key.name'

save_


save_category_key.name

    _definition.id               '_category_key.name'
    _definition.class            Attribute
    _definition.update           2014-09-18
    _description.text                   
;
     A minimal list of tag(s) that together constitute a compound key
     to access other items in a Loop category. In other words, the combined values of the
     datanames listed in this loop must be unique, so that unambiguous access 
     to a packet (row) in the table of values is possible.  The dataname associated with
     category.key_id is only included in this loop if no other set of datanames can form
     a compound key.
;
    _name.category_id            category_key
    _name.object_id              name
    _type.purpose                Identify
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Tag

save_

#============================================================================

save_DEFINITION

    _definition.id               DEFINITION
    _definition.scope            Category
    _definition.class            Set
    _definition.update           2011-06-20
    _description.text                   
;
     The attributes for classifying dictionary definitions.
;
    _name.category_id            ATTRIBUTES
    _name.object_id              DEFINITION

save_


save_definition.class

    _definition.id               '_definition.class'
    _definition.class            Attribute
    _definition.update           2013-03-08
    _description.text                   
;
     The nature and the function of a definition or definitions.
;
    _name.category_id            definition
    _name.object_id              class
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Attribute     
;                 Item used as an attribute in the definition
                  of other data items in DDLm dictionaries. 
                  These items never appear in data instance files.
;        
              Functions     
;                 Category of items that are transient function
                  definitions used only in dREL methods scripts.
                  These items never appear in data instance files.
;        
              Datum         
;                 Item defined in a domain-specific dictionary.  
                  These items appear only in data instance files.
;        
              Head          
;                 Category of items that is the parent of
                  all other categories in the dictionary.
;        
              Loop          
;                 Category of items that in a data file must
                  reside in a loop-list with a key item defined.
;        
              Set           
;                 Category of items that form a set (but not a
                  loopable list). These items may be referenced 
                  as a class of items in a dREL methods expression.
;        
              Ref-loop      
;                 A category containing one item that identifies the     
                  a category of items that is repeated in a sequence
                  of save frames. The item, which is specifies as a
                  as a Ref-table value (see type.container), is looped. 
                  This construction is for loop categories that contain 
                  child categories.
                  If in the instance file, the child items have only
                  one set of values, the Ref-loop item need not be used
                  and child items need not be placed in a save frame.
; 
    _enumeration.default         Datum

save_


save_definition.id

    _definition.id               '_definition.id'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     Identifier name of the Item or Category definition contained 
     within a save frame.
;
    _name.category_id            definition
    _name.object_id              id
    _type.purpose                Identify
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Tag

save_


save_definition.scope

    _definition.id               '_definition.scope'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     The extent to which a definition affects other definitions.
;
    _name.category_id            definition
    _name.object_id              scope
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Dictionary    'applies to all defined items in the dictionary'   
              Category      'applies to all defined items in the category'     
              Item          'applies to a single item definition' 
    _enumeration.default         Item

save_


save_definition.update

    _definition.id               '_definition.update'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     The date that a definition was last changed.
;
    _name.category_id            definition
    _name.object_id              update
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Date

save_


save_definition.xref_code

    _definition.id               '_definition.xref_code'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     Code identifying the equivalent definition in the dictionary
     referenced by the DICTIONARY_XREF attributes.
;
    _name.category_id            definition
    _name.object_id              xref_code
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code

save_

#============================================================================

save_DESCRIPTION

    _definition.id               DESCRIPTION
    _definition.scope            Category
    _definition.class            Set
    _definition.update           2011-06-20
    _description.text                   
;
     The attributes of descriptive (non-machine parseable) parts of
     definitions.
;
    _name.category_id            ATTRIBUTES
    _name.object_id              DESCRIPTION

save_


save_description.common

    _definition.id               '_description.common'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     Commonly-used identifying name for the item.
;
    _name.category_id            description
    _name.object_id              common
    _type.purpose                Describe
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Text
    _description.common          'common name'

save_


save_description.key_words

    _definition.id               '_description.key_words'
    _definition.class            Attribute
    _definition.update           2013-03-06
    _description.text                   
;
     List of key-words categorising the item.
;
    _name.category_id            description
    _name.object_id              key_words
    _type.purpose                Encode
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Text
    _description.common          'key words'

save_


save_description.text

    _definition.id               '_description.text'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     The text description of the defined item.
;
    _name.category_id            description
    _name.object_id              text
    _type.purpose                Describe
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Text
    _description.common          description

save_

#============================================================================

save_DESCRIPTION_EXAMPLE

    _definition.id               DESCRIPTION_EXAMPLE
    _definition.scope            Category
    _definition.class            Loop
    _definition.update           2013-09-08
    _description.text                   
;
     The attributes of descriptive (non-machine parseable) examples of
     values of the defined items.
;
    _name.category_id            DESCRIPTION
    _name.object_id              DESCRIPTION_EXAMPLE
    _category.key_id             '_description_example.case'
    loop_
    _category_key.name
                                 '_description_example.case' 

save_


save_description_example.case

    _definition.id               '_description_example.case'
    _definition.class            Attribute
    _definition.update           2013-03-08
    _description.text                   
;
     An example case of the defined item.
;
    _name.category_id            description_example
    _name.object_id              case
    _type.purpose                Key
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Implied

save_


save_description_example.detail

    _definition.id               '_description_example.detail'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     A description of an example case for the defined item.
;
    _name.category_id            description_example
    _name.object_id              detail
    _type.purpose                Describe
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Text

save_

#============================================================================

save_DICTIONARY

    _definition.id               DICTIONARY
    _definition.scope            Category
    _definition.class            Set
    _definition.update           2011-06-20
    _description.text                   
;
     Attributes for identifying and registering the dictionary. The items
     in this category are NOT used as attributes of INDIVIDUAL data items.
;
    _name.category_id            ATTRIBUTES
    _name.object_id              DICTIONARY

save_


save_dictionary.class

    _definition.id               '_dictionary.class'
    _definition.class            Attribute
    _definition.update           2012-05-07
    _description.text                   
;
     The nature, or field of interest, of data items defined in the dictionary.
;
    _name.category_id            dictionary
    _name.object_id              class
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Reference     'DDLm reference attribute definitions'   
              Instance      'domain-specific data instance definitions'        
              Template      'domain-specific attribute/enumeration templates'  
              Function      'domain-specific method function scripts' 
    _enumeration.default         Instance

save_


save_dictionary.date

    _definition.id               '_dictionary.date'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     The date that the last dictionary revision took place.
;
    _name.category_id            dictionary
    _name.object_id              date
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Date

save_


save_dictionary.ddl_conformance

    _definition.id               '_dictionary.ddl_conformance'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     The version number of the DDL dictionary that this dictionary
     conforms to.
;
    _name.category_id            dictionary
    _name.object_id              ddl_conformance
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Version

save_


save_dictionary.namespace

    _definition.id               '_dictionary.namespace'
    _definition.class            Attribute
    _definition.update           2006-12-05
    _description.text                   
;
     The namespace code that may be prefixed (with a trailing colon
     ":") to an item tag defined in the defining dictionary when used 
     in particular applications. Because tags must be unique, namespace
     codes are unlikely to be used in data files.
;
    _name.category_id            dictionary
    _name.object_id              namespace
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code

save_


save_dictionary.title

    _definition.id               '_dictionary.title'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     The common title of the dictionary. Will usually match the name
     attached to the data_ statement of the dictionary file.
;
    _name.category_id            dictionary
    _name.object_id              title
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code

save_


save_dictionary.uri

    _definition.id               '_dictionary.uri'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     The universal resource indicator of this dictionary.
;
    _name.category_id            dictionary
    _name.object_id              uri
    _type.purpose                Identify
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Uri

save_


save_dictionary.version

    _definition.id               '_dictionary.version'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     A unique version identifier for the dictionary.
;
    _name.category_id            dictionary
    _name.object_id              version
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Version

save_

#============================================================================

save_DICTIONARY_AUDIT

    _definition.id               DICTIONARY_AUDIT
    _definition.scope            Category
    _definition.class            Loop
    _definition.update           2013-09-08
    _description.text                   
;
     Attributes for identifying and registering the dictionary. The items
     in this category are NOT used as attributes of individual data items.
;
    _name.category_id            DICTIONARY
    _name.object_id              DICTIONARY_AUDIT
    _category.key_id             '_dictionary_audit.version'
    loop_
    _category_key.name
                                 '_dictionary_audit.version' 

save_


save_dictionary_audit.date

    _definition.id               '_dictionary_audit.date'
    _definition.class            Attribute
    _definition.update           2011-06-27
    _description.text                   
;
     The date of each dictionary revision.
;
    _name.category_id            dictionary_audit
    _name.object_id              date
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Date

save_


save_dictionary_audit.revision

    _definition.id               '_dictionary_audit.revision'
    _definition.class            Attribute
    _definition.update           2011-06-27
    _description.text                   
;
     A description of the revision applied for the _dictionary_audit.version.
;
    _name.category_id            dictionary_audit
    _name.object_id              revision
    _type.purpose                Describe
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Text

save_


save_dictionary_audit.version

    _definition.id               '_dictionary_audit.version'
    _definition.class            Attribute
    _definition.update           2011-06-27
    _description.text                   
;
     A unique version identifier for each revision of the dictionary.
;
    _name.category_id            dictionary_audit
    _name.object_id              version
    _type.purpose                Key
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Version

save_

#============================================================================

save_DICTIONARY_VALID

    _definition.id               DICTIONARY_VALID
    _definition.scope            Category
    _definition.class            Loop
    _definition.update           2013-09-08
    _description.text                   
;
     Data items which are used to specify the contents of definitions in
     the dictionary in terms of the _definition.scope     and the required
     and prohibited attributes.
;
    _name.category_id            DICTIONARY
    _name.object_id              DICTIONARY_VALID
    _category.key_id             '_dictionary_valid.application'
    loop_
    _category_key.name
                                 '_dictionary_valid.application' 

save_


save_dictionary_valid.application

    _definition.id               '_dictionary_valid.application'
    _definition.class            Attribute
    _definition.update           2013-02-12
    _description.text                   
;
     Provides the information identifying the definition scope (
     from the _definition.scope enumeration list) and the validity 
     options (from the _dictionary_valid.option enumeration list), 
     as a two element list. This list signals the validity of applying
     the attributes given in _dictionary_valid.attributes.
;
    _name.category_id            dictionary_valid
    _name.object_id              application
    _type.purpose                Key
    _type.source                 Assigned
    _type.container              List
    _type.contents               Code
    _type.dimension              [2]
    loop_
    _method.purpose
    _method.expression
     Definition    
;
     _dictionary_valid.application 
                      = [_dictionary_valid.scope,_dictionary_valid.option]
; 

save_


save_dictionary_valid.attributes

    _definition.id               '_dictionary_valid.attributes'
    _definition.class            Attribute
    _definition.update           2013-03-06
    _description.text                   
;
     A list of the attribute names and categories that are assessed
     for application in the item, category and dictionary definitions.
;
    _name.category_id            dictionary_valid
    _name.object_id              attributes
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              List
    _type.contents               Name
    _type.dimension              []

save_

save_dictionary_valid.scope

    _definition.id               '_dictionary_valid.scope'
    _definition.class            Attribute
    _definition.update           2015-01-28
    _description.text                   
;
     The scope to which the specified restriction on usable
     attributes applies.  
;
    _name.category_id            dictionary_valid
    _name.object_id              scope
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Dictionary    'restriction applies to dictionary definition data frame'   
              Category      'restriction applies to a category definition save frame'     
              Item          'restriction applies to an item definition save frame' 

save_

save_dictionary_valid.option

    _definition.id               '_dictionary_valid.option'
    _definition.class            Attribute
    _definition.update           2013-03-06
    _description.text                   
;
     Option codes for applicability of attributes in definitions.
;
    _name.category_id            dictionary_valid
    _name.object_id              option
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Mandatory     'attribute must be present in definition frame'    
              Recommended   'attribute is usually in definition frame'         
              Prohibited    'attribute must not be used in definition frame' 
    _enumeration.default         Recommended

save_

#============================================================================

save_DICTIONARY_XREF

    _definition.id               DICTIONARY_XREF
    _definition.scope            Category
    _definition.class            Loop
    _definition.update           2013-09-08
    _description.text                   
;
     Data items which are used to cross reference other dictionaries that
     have defined the same data items. Data items in this category are NOT 
    o used as attributes of individual data items.
;
    _name.category_id            DICTIONARY
    _name.object_id              DICTIONARY_XREF
    _category.key_id             '_dictionary_xref.code'
    loop_
    _category_key.name
                                 '_dictionary_xref.code' 

save_


save_dictionary_xref.code

    _definition.id               '_dictionary_xref.code'
    _definition.class            Attribute
    _definition.update           2006-11-27
    _description.text                   
;
     A code identifying the cross-referenced dictionary.
;
    _name.category_id            dictionary_xref
    _name.object_id              code
    _type.purpose                Key
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code

save_


save_dictionary_xref.date

    _definition.id               '_dictionary_xref.date'
    _definition.class            Attribute
    _definition.update           2011-06-27
    _description.text                   
;
     Date of the cross-referenced dictionary.
;
    _name.category_id            dictionary_xref
    _name.object_id              date
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Date

save_


save_dictionary_xref.format

    _definition.id               '_dictionary_xref.format'
    _definition.class            Attribute
    _definition.update           2011-06-27
    _description.text                   
;
     Format of the cross referenced dictionary.
;
    _name.category_id            dictionary_xref
    _name.object_id              format
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Text

save_


save_dictionary_xref.name

    _definition.id               '_dictionary_xref.name'
    _definition.class            Attribute
    _definition.update           2011-06-27
    _description.text                   
;
     The name and description of the cross-referenced dictionary.
;
    _name.category_id            dictionary_xref
    _name.object_id              name
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Text

save_


save_dictionary_xref.uri

    _definition.id               '_dictionary_xref.uri'
    _definition.class            Attribute
    _definition.update           2011-06-27
    _description.text                   
;
     The source URI of the cross referenced dictionary data.
;
    _name.category_id            dictionary_xref
    _name.object_id              uri
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Uri

save_

#============================================================================

save_ENUMERATION

    _definition.id               ENUMERATION
    _definition.scope            Category
    _definition.class            Set
    _definition.update           2011-06-20
    _description.text                   
;
     The attributes for restricting the values of defined data items.
;
    _name.category_id            ATTRIBUTES
    _name.object_id              ENUMERATION

save_


save_enumeration.def_index_id

    _definition.id               '_enumeration.def_index_id'
    _definition.class            Attribute
    _definition.update           2012-05-07
    _description.text                   
;
     Specifies the data name with a value used as an index to the 
     DEFAULT enumeration list (in category enumeration_default)
     in order to select the default enumeration value for the 
     defined item. The value of the identified data item must match 
     one of the _enumeration_default.index values.
;
    _name.category_id            enumeration
    _name.object_id              def_index_id
    _type.purpose                Identify
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Tag

save_


save_enumeration.default

    _definition.id               '_enumeration.default'
    _definition.class            Attribute
    _definition.update           2013-03-08
    _description.text                   
;
     The default value for the defined item if it is not specified explicitly.
;
    _name.category_id            enumeration
    _name.object_id              default
    _type.purpose                Encode
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Implied

save_


save_enumeration.mandatory

    _definition.id               '_enumeration.mandatory'
    _definition.class            Attribute
    _definition.update           2012-05-07
    _description.text                   
;   
     Yes or No flag on whether the enumerate states specified for an
     item in the current definition (in which item appears) MUST be
     used on instantiation.
;
    _name.category_id            enumeration
    _name.object_id              mandatory
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Yes           'Use of state is mandatory'    
              No            'Use of state is unnecessary' 
    _enumeration.default         Yes

save_


save_enumeration.range

    _definition.id               '_enumeration.range'
    _definition.class            Attribute
    _definition.update           2013-04-17
    _description.text                   
;
     The inclusive range of values "from:to" allowed for the defined item.
;
    _name.category_id            enumeration
    _name.object_id              range
    _type.purpose                Encode
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Range

save_

#============================================================================

save_ENUMERATION_DEFAULT

    _definition.id               ENUMERATION_DEFAULT
    _definition.scope            Category
    _definition.class            Loop
    _definition.update           2013-09-08
    _description.text                   
;
     Loop of pre-determined default enumeration values indexed to a 
     data item by the item _enumeration.def_index_id.
;
    _name.category_id            ENUMERATION
    _name.object_id              ENUMERATION_DEFAULT
    _category.key_id             '_enumeration_default.index'
    loop_
    _category_key.name
                                 '_enumeration_default.index' 

save_


save_enumeration_default.index

    _definition.id               '_enumeration_default.index'
    _definition.class            Attribute
    _definition.update           2013-04-17
    _description.text                   
;
     Index key in the list default values referenced to by the value
     of _enumeration.def_index_id .
;
    _name.category_id            enumeration_default
    _name.object_id              index
    _type.purpose                Key
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code

save_


save_enumeration_default.value

    _definition.id               '_enumeration_default.value'
    _definition.class            Attribute
    _definition.update           2013-04-17
    _description.text                   
;
     Default enumeration value in the list referenced by the value of
     _enumeration.def_index_id. The reference index key is given by
     the value of _enumeration_default.index value.
;
    _name.category_id            enumeration_default
    _name.object_id              value
    _type.purpose                Encode
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Implied

save_

#============================================================================

save_ENUMERATION_SET

    _definition.id               ENUMERATION_SET
    _definition.scope            Category
    _definition.class            Loop
    _definition.update           2013-09-08
    _description.text                   
;
     Attributes of data items which are used to define a
     set of unique pre-determined values.
;
    _name.category_id            ENUMERATION
    _name.object_id              ENUMERATION_SET
    _category.key_id             '_enumeration_set.state'
    loop_
    _category_key.name
                                 '_enumeration_set.state' 

save_


save_enumeration_set.detail

    _definition.id               '_enumeration_set.detail'
    _definition.class            Attribute
    _definition.update           2011-06-27
    _description.text                   
;
     The meaning of the code (identified by _enumeration_set.state)
     in terms of the value of the quantity it describes.
;
    _name.category_id            enumeration_set
    _name.object_id              detail
    _type.purpose                Describe
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Text

save_


save_enumeration_set.state

    _definition.id               '_enumeration_set.state'
    _definition.class            Attribute
    _definition.update           2011-06-27
    _description.text                   
;
     Permitted value state for the defined item.
;
    _name.category_id            enumeration_set
    _name.object_id              state
    _type.purpose                Key
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code

save_


save_enumeration_set.xref_code

    _definition.id               '_enumeration_set.xref_code'
    _definition.class            Attribute
    _definition.update           2011-06-27
    _description.text                   
;
     Identity of the equivalent item in the dictionary
     referenced by the DICTIONARY_XREF attributes.
;
    _name.category_id            enumeration_set
    _name.object_id              xref_code
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code

save_


save_enumeration_set.xref_dictionary

    _definition.id               '_enumeration_set.xref_dictionary'
    _definition.class            Attribute
    _definition.update           2011-06-27
    _description.text                   
;
     Code identifying the dictionary in the DICTIONARY_XREF 
     list.
;
    _name.category_id            enumeration_set
    _name.object_id              xref_dictionary
    _type.purpose                Audit
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code

save_

#============================================================================

save_IMPORT

    _definition.id               IMPORT
    _definition.scope            Category
    _definition.class            Set
    _definition.update           2011-06-27
    _description.text                   
;   
     Used to import the values of specific attributes from other dictionary 
     definitions within and without the current dictionary.
;
    _name.category_id            ATTRIBUTES
    _name.object_id              IMPORT

save_

save_import.get

    _definition.id               '_import.get'
    _definition.class            Attribute
    _definition.update           2015-01-06
    _description.text                   
;
     A list of tables of attributes defined individually in the category IMPORT_DETAILS,  
     used to import definitions from other dictionaries. 
;
    _name.category_id            import
    _name.object_id              get
    _type.purpose                Import
    _type.source                 Assigned
    _type.container              List
    _type.contents               ByReference
    _type.contents_referenced_id '_import_details.single'
    loop_
    _method.purpose
    _method.expression
     Evaluation    
;
     imp_order_list = []
     loop id as import_details {
         imp_order_list ++= id.order
     } 
     sort(imp_order_list)
     final_val = []
     for ord in imp_order_list {
         final_val ++= import_details[ord].single
     }
    _import.get = final_val
; 

save_

save_IMPORT_DETAILS
    _definition.id              IMPORT_DETAILS
    _definition.scope           Category
    _name.category_id           IMPORT
    _name.object_id             IMPORT_DETAILS
    _definition.class           Loop
    _category.key_id		  '_import_details.order'
    loop_
        _category_key.name     '_import_details.order'
    _description.text
;
    Items in IMPORT_DETAILS describe individual attributes of an import operation.
;
save_


save_import_details.file_id

    _definition.id               '_import_details.file_id'
    _definition.class            Attribute
    _definition.update           2015-05-06
    _description.text                   
;
     The file name/URI of the source dictionary
;
    _name.category_id            import_details
    _name.object_id              file_id
    _type.purpose                Identify
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Uri

save_

save_import_details.frame_id

    _definition.id               '_import_details.frame_id'
    _definition.class            Attribute
    _definition.update           2015-05-06
    _description.text                   
;
     The framecode of the definition frame to be imported.
;
    _name.category_id            import_details
    _name.object_id              frame_id
    _type.purpose                Identify
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code

save_


save_import_details.order
	_definition.id			'_import_details.order'
	_definition.class		Attribute
        _definition.update              2015-05-07
	_description.text			
;
     	The order in which the import described by the referenced row should be      	
        executed.
;
	_name.category_id	        'import_details'
	_name.object_id		        'order'
	_type.container	                Single
        _type.contents	 		Integer
        _type.source                    Assigned
        _type.purpose                   Key
        
save_

save_import_details.if_dupl

    _definition.id               '_import_details.if_dupl'
    _definition.class            Attribute
    _definition.update           2015-05-06
    _description.text                   
;
     Code identifying the action taken if the requested definition block 
     already exists within the importing dictionary.
;
    _name.category_id            import_details
    _name.object_id              if_dupl
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Ignore        'ignore imported definitions if id conflict'       
              Replace       'replace existing with imported definitions'       
              Exit          'issue error exception and exit' 
    _enumeration.default         Exit

save_


save_import_details.if_miss

    _definition.id               '_import_details.if_miss'
    _definition.class            Attribute
    _definition.update           2015-05-06
    _description.text                   
;
     Code identifying the action taken if the requested definition block 
     is missing from the source dictionary.
;
    _name.category_id            import_details
    _name.object_id              if_miss
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Ignore        'ignore import'      
              Exit          'issue error exception and exit' 
    _enumeration.default         Exit

save_


save_import_details.mode

    _definition.id               '_import_details.mode'
    _definition.class            Attribute
    _definition.update           2015-05-06
    _description.text                   
;
     Code identifying how a definition save frame is to be imported.
     "Full" imports the entire definition frame including the leading 
            and trailing save statements.
     "Contents" imports only the lines within the save frame.
;
    _name.category_id            import_details
    _name.object_id              mode
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Full          'import requested definition with frame'           
              Contents      'import contents of requested defn frame' 
    _enumeration.default         Contents

save_

save_import_details.single
    _definition.id             '_import_details.single' 
    _definition.update           2015-04-24 
    _definition.class            Attribute 
    _description.text 
; 
     A Table mapping attributes defined individually in category IMPORT to
     their values; used to import definitions from other dictionaries.  
; 
    _name.category_id            import_details
    _name.object_id              single
    _type.purpose                Internal
    _type.container              Table
    _type.contents               Text
    _type.indices                 ByReference
    _type.indices_referenced_id    '_import_details.single_index'
    loop_
	_method.purpose
	_method.expression
	Evaluation
;
	with id as import_details
	_import_details.single = {"file":id.file_id, 
 					"save":id.frame_id,
					"mode":id.mode,
					"dupl":id.if_dupl, 
					"miss":id.if_miss}
;
     save_

save_import_details.single_index
    _definition.id             '_import_details.single_index' 
    _definition.update           2015-04-24 
    _definition.class            Attribute 
    _description.text 
; 
     One of the indices permitted in the entries of values of attribute _import_details.single.
; 
    _name.category_id            import_details
    _name.object_id              single_index
    _type.purpose                Internal
    _type.container              Single
    _type.contents               Code
     loop_
    _enumeration_set.state
    _enumeration_set.detail
       file 'filename/URI of source dictionary'
       save 'save framecode of source definition'
       mode 'mode for including save frames'
       dupl 'option for duplicate entries'
       miss 'option for missing duplicate entries'
     save_

#============================================================================

save_LOOP

    _definition.id               LOOP
    _definition.scope            Category
    _definition.class            Set
    _definition.update           2011-06-20
    _description.text                   
;
     Attributes for looped lists.
;
    _name.category_id            ATTRIBUTES
    _name.object_id              LOOP

save_


save_loop.level

    _definition.id               '_loop.level'
    _definition.class            Attribute
    _definition.update           2012-05-07
    _description.text                   
;
     Specifies the level of the loop structure in which a defined
     item must reside if it used in a looped list.
;
    _name.category_id            loop
    _name.object_id              level
    _type.purpose                Number
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Index
    _enumeration.default         1
    _enumeration.range           1:

save_

#============================================================================

save_METHOD

    _definition.id               METHOD
    _definition.scope            Category
    _definition.class            Loop
    _definition.update           2013-09-08
    _description.text                   
;
     Methods used for evaluating, validating and defining items.
;
    _name.category_id            ATTRIBUTES
    _name.object_id              METHOD
    _category.key_id             '_method.purpose'
    loop_
    _category_key.name
                                 '_method.purpose' 

save_


save_method.expression

    _definition.id               '_method.expression'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     The method expression for the defined item.
;
    _name.category_id            method
    _name.object_id              expression
    _type.purpose                Method
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Text

save_


save_method.purpose

    _definition.id               '_method.purpose'
    _definition.class            Attribute
    _definition.update           2006-11-16
    _description.text                   
;
     The purpose and scope of the method expression.
;
    _name.category_id            method
    _name.object_id              purpose
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Evaluation    'method evaluates an item from related item values'         
              Definition    'method generates attribute value(s) in the definition'     
              Validation    'method compares an evaluation with existing item value'
    _enumeration.default         Evaluation

save_

#============================================================================

save_NAME

    _definition.id               NAME
    _definition.scope            Category
    _definition.class            Set
    _definition.update           2011-06-20
    _description.text                   
;
     Attributes for identifying items and item categories.
;
    _name.category_id            ATTRIBUTES
    _name.object_id              NAME

save_


save_name.category_id

    _definition.id               '_name.category_id'
    _definition.class            Attribute
    _definition.update           2011-07-27
    _description.text                   
;
     The name of the category in which a category or item resides.
;
    _name.category_id            name
    _name.object_id              category_id
    _type.purpose                Identify
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Name

save_


save_name.linked_item_id

    _definition.id               '_name.linked_item_id'
    _definition.class            Attribute
    _definition.update           2011-12-08
    _description.text                   
;
     Dataname of an equivalent item in another category which has a 
     common set of values, or, in the definition of a type Su
     item is the name of the associated Measurement item to 
     which the standard uncertainty applies.
;
    _name.category_id            name
    _name.object_id              linked_item_id
    _type.purpose                Identify
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Tag

save_


save_name.object_id

    _definition.id               '_name.object_id'
    _definition.class            Attribute
    _definition.update           2011-07-27
    _description.text                   
;
     The object name of a category or name unique within the 
     category or family of categories.
;
    _name.category_id            name
    _name.object_id              object_id
    _type.purpose                Identify
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Name

save_

#============================================================================

save_TYPE

    _definition.id               TYPE
    _definition.scope            Category
    _definition.class            Set
    _definition.update           2011-06-26
    _description.text                   
;
    Attributes which specify the 'typing' of data items.
;
    _name.category_id            ATTRIBUTES
    _name.object_id              TYPE

save_


save_type.container

    _definition.id               '_type.container'
    _definition.class            Attribute
    _definition.update           2013-04-07
    _description.text                   
;
     The CONTAINER type of the defined data item value. 
;
    _name.category_id            type
    _name.object_id              container
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Single        'single value'       
              Multiple      'values as List or by boolean ,|&!* or range : ops'         
              List        '''ordered set of values bounded by [] and separated by
                             commas. Elements need not be of same contents type.'''
              Array       '''ordered set of numerical values bounded by [] and 
                             separated by commas. Operations across arrays are
                             equivalent to operations across elements of the Array.'''
              Matrix      '''ordered set of numerical values for a tensor bounded by 
                             [] and separated by commas. Tensor operations such as
                             dot and cross products, are valid cross matrix objects.'''       
              Table         'id:value elements bounded by {}; separated by commas'      
              Ref-table   '''a STAR construction with key:value elements bounded
                             by ${..}$ and separated by commas.
                             The id tags below are privileged and optional.
                             source  - filename or URI
                             block   - data blockname
                             frame   - framecode or [framecode,framecode,..]
                             item    - dataname or [dataname,dataname,..]
                             key     - key value if item is in a list'''
    _enumeration.default         Single

save_


save_type.contents

    _definition.id               '_type.contents'
    _definition.class            Attribute
    _definition.update           2013-04-24
    _description.text                   
;
     Syntax of the value elements within the container type. 
     This may be a single enumerated code, or, in the case of a list, 
     a comma-delimited sequence of codes, or, if there are alternate 
     types, a boolean-linked (or range) sequence of codes.
     The typing of elements is determined by the replication 
     of the minimum set of states declared.   Where the definition is of
     a 'Table' container this attribute describes
     the construction of the value elements within those (Table) values.
;
    _name.category_id            type
    _name.object_id              contents
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Multiple
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Text          'case-sens strings or lines of STAR characters'    
              Code          'case-insens contig. string of STAR characters'    
              Name          'case-insens contig. string of alpha-num chars or underscore'         
              Tag           'case-insens contig. STAR string with leading underscore'   
              Filename      'case-sens string indentifying an external file'   
              Uri           'case-sens string as universal resource indicator of a file'          
              Date          'ISO standard date format <yyyy>-<mm>-<dd>'        
              Version       'version digit string of the form <major>.<version>.<update>'         
              Dimension     'integer limits of an Array/Matrix/List in square brackets' 
              Range         'inclusive range of numerical values min:max'      
              Count         'unsigned integer number'      
              Index         'unsigned non-zero integer number'       
              Integer       'positive or negative integer number'    
              Real          'floating-point real number'   
              Imag          'floating-point imaginary number'        
              Complex       'complex number <R>+j<I>'      
              Binary        'binary number \b<N>'          
              Hexadecimal   'hexadecimal number \x<N>'     
              Octal         'octal number \o<N>'           
              Implied       'implied by the context of the attribute' 
              ByReference
                            """The contents have the same form as those of the attribute referenced by
                            _type.contents_referenced_id."""
    _enumeration.default         Text
    loop_
    _description_example.case
    _description_example.detail
            "Integer"            'content is a single or multiple integer(s)'  
            "Real,Integer"       'List elements of a real number and an integer'        
            "List(Real,Code)"    'List of Lists of a real number and a code'   
            "Text|Real"          'content is either text OR a real number' 

save_

save_type.contents_referenced_id
    _definition.id            '_type.contents_referenced_id'
    _definition.update          2015-04-24
    _definition.class           Attribute
    _description.text
;
     The value of the _definition.id attribute of an attribute definition
     whose type is to be used also as the type of this item.  Meaningful only
     when this item's _type.contents attribute has value 'ByReference'.
;
    _name.category_id           type
    _name.object_id             contents_referenced_id
    _type.purpose               Identify
    _type.container             Single
    _type.contents              Tag
     save_

save_type.dimension

    _definition.id               '_type.dimension'
    _definition.class            Attribute
    _definition.update           2013-04-17
    _description.text                   
;
     The dimensions of a list or matrix of elements as a text string 
     within bounding square brackets.
;
    _name.category_id            type
    _name.object_id              dimension
    _type.purpose                Encode
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Dimension
    loop_
    _description_example.case
    _description_example.detail
            "[3,3]"              '3x3 matrix of elements'  
            "[6]"                'list of 6 elements'      
            "[]"                 'unknown number of list elements' 

save_

save_type.indices
    _definition.id            '_type.indices'
    _definition.update          2015-04-24
    _definition.class           Attribute
    _description.text
;
     Used to specify the syntax construction of indices of the entries in the
     defined object when the defined object has 'Table' as its
     _type.container attribute.  Values are a subset of the codes and
     constructions defined for attribute _type.contents, accounting
     for the fact that syntactically, indices are always case-sensitive
     quoted strings.

     Meaningful only when the defined item has _type.container 'Table'.
;
    _name.category_id           type
    _name.object_id             indices
    _type.purpose               State
    _type.container             Single
    _type.contents              Code
     loop_
    _enumeration_set.state
    _enumeration_set.detail
     Text         'a case-sensitive string/lines of text'
     Filename     'name of an external file'
     Code         'code used for indexing data or referencing data resources'
     Date         'ISO date format yyyy-mm-dd'
     Uri          'an universal resource identifier string, per RFC 3986'
     Version      'version digit string of the form <major>.<version>.<update>'
     ByReference
;
     Indices have the same form as the contents of the attribute identified by
     _type.indices_referenced_id
;
    _enumeration.default        Text
     loop_
    _description_example.case
    _description_example.detail
     'Code' 'indices belong to an enumerated set of pre-defined codes'
     'Uri'  'indices have the form of URIs'
     save_

save_type.indices_referenced_id
    _definition.id            '_type.indices_referenced_id'
    _definition.update          2015-04-24
    _definition.class           Attribute
    _description.text
;
     The _definition.id attribute of a definition whose type describes the
     form and construction of the indices of entries in values of the present item.

     Meaningful only when the defined item's _type.container attribute has
     value 'Table', and its _type.indices attribute has value 'ByReference'.
;
    _name.category_id           type
    _name.object_id             indices_referenced_id
    _type.purpose               Identify
    _type.container             Single
    _type.contents              Tag
     save_

save_type.purpose

    _definition.id               '_type.purpose'
    _definition.class            Attribute
    _definition.update           2013-03-06
    _description.text                   
;
     The primary purpose or function the defined data item serves in a
     dictionary or a specific data instance.
;
    _name.category_id            type
    _name.object_id              purpose
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Import        
;                  >>> Applied ONLY in the DDLm Reference Dictionary <<<
                   Used to type the SPECIAL attribute "_import.get" that
                   is present in dictionaries to instigate the importation
                   of external dictionary definitions.
;        
              Method        
;                  >>> Applied ONLY in the DDLm Reference Dictionary <<<
                   Used to type the attribute "_method.expression" that 
                   is present in dictionary definitions to provide the 
                   text method expressing the defined item in terms of
                   other defined items.
;        
              Audit         
;                  >>> Applied ONLY in the DDLm Reference Dictionary <<<
                   Used to type attributes employed to record the audit 
                   definition information (creation date, update version and
                   cross reference codes) of items, categories and files.
;        
              Identify      
;                  >>> Applied ONLY in the DDLm Reference Dictionary <<<
                   Used to type attributes that identify an item tag (or
                   part thereof), save frame or the URI of an external file. 
;        
              Extend        
;                  *** Used to EXTEND the DDLm Reference Dictionary ***
                   Used in a definition, residing in the "extensions" 
                   save frame of a domain dictionary, to specify a new
                   enumeration state using an Evaluation method.
;        
              Describe      
;                  Used to type items with values that are descriptive
                   text intended for human interpretation.
;        
              Encode        
;                  Used to type items with values that are text or codes 
                   that are formatted to be machine parsible.
;        
              State         
;                  Used to type items with values that are restricted to 
                   codes present in their "enumeration_set.state" lists.
;        
              Key           
;                  Used to type an item with a value that is unique within   
                   the looped list of these items, and may be used as a
                   reference "key" to identify a specific packet of items 
                   within the category.
;        
              Link          
;                  Used to type an item with a value that is unique within
                   a looped list of items belonging to another category.
                   The definition of this item must contain the attribute
                   "_name.linked_item_id" specifying the data name of the
                   key item for this list. The defined item represents a
                   a foreign key linking packets in this category list to 
                   packets in another category.
;        
              Composite     
;                  Used to type items with value strings composed of
                   separate parts. These will usually need to be separated 
                   and parsed for complete interpretation and application.
;        
              Number        
;                  Used to type items that are numerical and exact (i.e. 
                   no standard uncertainty value). 
;        
              Measurand     
;                  Used to type an item with a numerically estimated value 
                   that has been recorded by measurement or derivation. This 
                   value must be accompanied by its standard uncertainty 
                   (SU) value, expressed either as:
                     1) appended integers, in parentheses (), at the
                        precision of the trailing digits,       or
                     2) a separately defined item with the same name as the 
                        measurand item but with an additional suffix '_su'.
;        
              SU            
;                  Used to type an item with a numerical value that is the 
                   standard uncertainty of an item with the identical name
                   except for the suffix '_su'. The definition of an SU item 
                   must include the attribute "_name.linked_item_id" which
                   explicitly identifies the associated measurand item.
; 
              Internal
;                  Used to type items that serve only internal purposes of the dictionary
                   in which they appear.  The particular purpose served is not defined by
                   this state.
;
    _enumeration.default         Describe

save_


save_type.source

    _definition.id               '_type.source'
    _definition.class            Attribute
    _definition.update           2013-04-16
    _description.text                   
;
     The origin or source of the defined data item, indicating by what 
     recording process it has been added to the domain instance.
;
    _name.category_id            type
    _name.object_id              source
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    loop_
    _enumeration_set.state
    _enumeration_set.detail
              Recorded      
;               A value (numerical or otherwise) recorded by
                observation or measurement during the experimental 
                collection of data. This item is PRIMITIVE.
;        
              Assigned      
;               A value (numerical or otherwise) assigned as part of
                the data collection, analysis or modelling required
                for a specific domain instance. These assignments 
                often represent a decision made that determines the
                course of the experiment (and therefore may be deemed
                PRIMITIVE) or a particular choice in the way the data
                was analysed (and therefore may be considered NOT
                PRIMITIVE). 
;        
              Related       
;               A value or tag used in the construction of looped   
                lists of data. Typically identifying an item whose
                unique value is the reference key for a loop category
                and/or an item which as values in common with those 
                of another loop category and is considered a Link
                between these lists.
;        
              Derived       
;               A quantity derived from other data items within the 
                domain instance. This item is NOT PRIMITIVE.
; 
    _enumeration.default         Selected

save_

#============================================================================

save_UNITS

    _definition.id               UNITS
    _definition.scope            Category
    _definition.class            Set
    _definition.update           2013-03-06
    _description.text                   
;
    The attributes for specifying units of measure.
;
    _name.category_id            ATTRIBUTES
    _name.object_id              UNITS

save_


save_units.code

    _definition.id               '_units.code'
    _definition.class            Attribute
    _definition.update           2012-01-25
    _description.text                   
;
     A code which identifies the units of measurement.
;
    _name.category_id            units
    _name.object_id              code
    _type.purpose                State
    _type.source                 Assigned
    _type.container              Single
    _type.contents               Code
    _enumeration.default         Arbitrary

    _import.get [{'save':units_code  'file':templ_enum.cif}]

save_

#=============================================================================
#  The attribute validation criteria for application to a domain dictionary
#============================================================================

    loop_
    _dictionary_valid.application
    _dictionary_valid.attributes
  [Dictionary  Mandatory]       ['_dictionary.title'  '_dictionary.class'  
                                 '_dictionary.version'  '_dictionary.date'  
                                 '_dictionary.uri'  
                                 '_dictionary.ddl_conformance'  
                                 '_dictionary.namespace'] 
  [Dictionary  Recommended]     ['_description.text'  
                                 '_dictionary_audit.version'  
                                 '_dictionary_audit.date'  
                                 '_dictionary_audit.revision'] 
  [Dictionary  Prohibited]      [ALIAS  CATEGORY  DEFINITION  ENUMERATION  LOOP  
                                 METHOD  NAME  TYPE  UNITS] 
  [Category  Mandatory]         ['_definition.id'  '_definition.scope'  
                                 '_definition.class'  '_name.category_id'  
                                 '_name.object_id'] 
  [Category  Recommended]       ['_category.key_id'  '_category_key.name'  
                                 '_description.text'] 
  [Category  Prohibited]        [ALIAS  DICTIONARY  ENUMERATION  IMPORT  LOOP  
                                 TYPE  UNITS] 
  [Item  Mandatory]             ['_definition.id'  '_definition.update'  
                                 '_name.object_id'  '_name.category_id'  
                                 '_type.container'  '_type.contents'] 
  [Item  Recommended]           ['_definition.scope'  '_definition.class'  
                                 '_type.source'  '_type.purpose'  
                                 '_description.text'  '_description.common'] 
  [Item  Prohibited]            [CATEGORY  DICTIONARY] 

#=============================================================================
#  The dictionary's audit trail and creation history.
#============================================================================

    loop_
    _dictionary_audit.version
    _dictionary_audit.date
    _dictionary_audit.revision
         3.3.00    2004-11-09           
;
   Change definition.import_id to definition_import.id in many defs.
   Insert category DEFINITION_IMPORT and the items .id, .conflict,
   .protocol and .source.
;        
         3.3.01    2004-11-10           
;
   Make further changes to the DEFINITION_IMPORT definitions and
   introduce the DEFINITION_TEMPLATE category.
;        
         3.3.02    2004-11-11           
;
   Introduce an IMPORT category containing IMPORT_DICTIONARY, 
   IMPORT_DEFINITION, IMPORT_CATEGORY, IMPORT_ATTRIBUTE.
   Change DEFINITION_TEMPLATE to IMPORT_TEMPLATE.
;        
         3.3.03    2004-11-12           
;
   Major changes to all the new attributes. Introduce categories
   DEFINITION_CONTEXT.
;        
         3.3.04    2004-11-13           
;
   Cleaned up the IMPORT changes and cases of enumerates.
;        
         3.3.05    2004-11-16           
;
   Further changes to IMPORT definitions.
;        
         3.3.06    2004-11-18           
;
  Some minor correction of typos
;        
         3.3.07    2005-11-22           
;
  Changed _dictionary.name to _dictionary.filename
  Changed _dictionary_xref.name to _dictionary_xref.filename
  Added _dictionary.title to describe the common name of the dictionary
;        
         3.3.08    2005-12-12           
;
  Changed ddl to ddl_attr
  Added Template and Function to _dictionary.class
;        
         3.3.09    2006-02-02           
;
  Add the definition of _dictionary_xref.source.
;        
         3.3.10    2006-02-07           
;
  Add import attribute definitions
;        
         3.4.01    2006-02-12           
;
  Remove save frames from dictionary attributes.
  Change the attribute _dictionary.parent_name to _dictionary.parent_id
;        
         3.4.02    2006-02-16           
;
  In the import_*.conflict definitions change the enumeration state Unique 
  to Ignore, and change the default state to Error.
  In the import_*.missing definitions change default enumeration state to
  Error.
;        
         3.5.01    2006-03-07           
;
  Structural changes to the file to conform with the import model 3.
  Move the template file for *.relational_id to com_att.dic
  Change all references to *.relational_id into the tuple format.
  Move the _codes_ddl.units_code to enum_set.dic and insert the
  import_enum_set.id tuples.
;        
         3.5.02    2006-03-22           
;
  Rename _enumeration.default_index_id to _enumeration.def_index_id.
  Correct the attributes _enumeration_default.index and *.value.
;        
         3.5.03    2006-05-09           
;
  Reword many of the import attributes.
  Correct the tuple description for import_dictionary.
  Insert all of the definitions for import_defaults attributes.
  Update _dictionary.class definition - change "Template" to "Import".
  Remove _enumeration.scope "open" from _definition_context.domain.
;        
         3.6.01    2006-06-16           
;
  Major revamp of TYPE attributes... changed:
     _type.value to _type.contents and expand enumeration list.
     _type.purpose has new role and different enumeration states.
  _name.object_id changed to _name.object_id.
  _enumeration_set.code becomes _enumeration_set.state.
  Changed the _type.value (now .contents) states to match expanded list.
  Added _dictionary.ddl_conformance attribute.
  Changed _category.join_set_id to _category.join_cat_id.
  Remove _enumeration.scope definition.
;        
         3.6.02    2006-06-17           
;
  Change the states of _type.purpose.        
;        
         3.6.03    2006-06-18           
;
  Correct _type.contents value in import_dictionary.id.        
;        
         3.6.04    2006-06-20           
;
  Change state 'Point' to 'Link' in _type.contents definition.
  Add Formula to _type.contents
;        
         3.6.05    2006-06-27           
;
  Change all IMPORT attributes and apply.
  Add _dictionary.namespace attribute and apply.
  Add states to _definition.class and apply.
  Add _enumeration_set.scope.
  Add .context to ENUMERATE_SET, ENUMERATE_DEFAULT, DESCRIPTION_EXAMPLE
;        
         3.6.06    2006-07-18           
;
  Change the descriptions of the _type.container states.
  The _enumeration_set.scope removed (enumeration.mandatory used).
  In _type_array.dimension change _type.contents to List.
;        
         3.6.07    2006-08-30           
;
  Change 'att' to 'sta' in the imports of _type.contents and _units.code.
  Replace states 'vector' and 'matrix' in _type.container with 'array'.
  In _type.purpose change 'model' to 'assigned'; 'observe' to 'observed';
  and 'measure' to 'measured'.
;        
         3.6.08    2006-08-31           
;
  Remove the category TYPE_ARRAY and insert _type.dimension
  Replace _description.compact with _description.common
  Replace _description.abbreviated with _description.key_words
;        
         3.6.09    2006-10-31           
;
  Remove all attributes and categories referring to 'context'.
;        
         3.6.10    2006-11-09           
;
  Replace _method.id with method.purpose.
  Redefine the DICTIONARY_VALID values.
;        
         3.7.01    2006-11-16           
;
  Apply _definition.scope changes.
  Add _category.parent_join.    
  Add _dictionary.xref_code.            
  Add _enumeration_set.xref_dictionary.
  Remove all relational keys.
;        
         3.7.02    2006-12-05           
;
  Rewording of description.text in DDL_ATTR and definition.namespace
  Rewording of category_mandatory.item_id
  Reworded descriptions of definition.class descriptions.
  Removed dictionary.filename.
  Corrected examples in type.dimension.
  Remove dictionary.parent_id and dictionary.parent_uri.
;        
         3.7.03    2006-12-21           
;
  Default for _category.parent_join is now "No"
;        
         3.7.04    2007-02-06           
;
  Change _category_key.item_id to _category_key.generic
  Add _category_key.primitive
;        
         3.7.05    2007-02-08           
;
  Change the _type.purpose of _category_key.generic and .primitive
  to Identify
;        
         3.7.06    2007-03-18           
;
  Change the description for _name.linked_item_id
;        
         3.7.07    2007-10-11           
;
  Correct the _type.dimension assignments to [n[m]].
  Remove _type_array.dimension from _type.dimension definition.
;        
         3.7.08    2008-01-17           
;
  Change 'Definition' to 'Evaluation' in import_list.id.      
  Changed import.scope entries to leading uc character.
;        
         3.7.09    2008-02-12           
;
  Change 'Itm' to 'Def' in import.scope.
;        
         3.7.10    2008-03-28           
;
  Update the definition of _type.dimension.
;        
         3.7.11    2008-05-18           
;
  Changed 2 type.contents values from "Implied" to "Inherited"
  Change import_list.id to be ((.....))

;        
         3.7.12    2008-08-05           
;
  Correct _type.dimension definition.
;        
         3.7.13    2011-01-27           
;
  Change definition scope of Head category to "Dictionary"
  Remove all tabs and replace with blank string
;        
         3.7.14    2011-03-25           
;
  In the attribute import_list.id
  Change _type.contents  Tuple(Code,Tag,Uri,Code,Code)  
  To     _type.contents  Tuple(Code,Ctag,Uri,Code,Code)
 In the attribute import.block
  Change _type.contents    Tag
  To     _type.contents    Ctag
  And change the case examples
;        
         3.8.01    2011-06-07           
;
  Remove the Tuple and Array enumerations from _type.container
  Change category class enumeration from List to Loop; and change
  all invocations of _category.class in the definitions
  Introduce nested save frames for expressing nested categories.
;        
         3.8.02    2011-06-21           
;
Reconfigure _dictionary_valid attribures into lists, and reset the
attribute application criteria at the rear of the DDL dictionary.
;        
         3.8.03    2011-06-22           
;
Change IMPORT_LIST to IMPORT_TABLE. Change the IMPORT arguments to
match this. Change the import_list.id invocations to import_table
equivalents. Add _enumeration_set.table_tag.
;        
         3.8.04    2011-06-23           
;
Remove IMPORT_TABLE. Change the IMPORT to a set category.
Insert a import.get attribute to replace import_table.id
Rename the DDL_ATTR category as ATTRIBUTES
;        
         3.8.05    2011-06-27           
;
Change the _name.category_id value to reflect the parent category.
;        
         3.8.06    2011-06-29           
;
Change Reference in _type.purpose to Ref-key
;        
         3.8.07    2011-06-30           
;
Change Reference in _definition.class to Ref-loop.
Remove import from type.contents and insert enumeration_set list.
Insert name.category_id into every category definition.
;        
         3.8.08    2011-07-28           
;
Add name.category_id and name.object_id to category definitions.
Remove category.parent_id from category definitions.
Remove definitions for category.parent_id and the CATEGORY_KEY
and CATEGORY_MANDATORY definitions. Define category.key_id
;        
         3.8.08    2011-08-15           
;
Add the state "Extend" to the type.purpose" attribute.
;        
         3.9.01    2011-12-08           
;
Add types "Array" and "Matrix" to type.container attribute definition.
Add type "Su" to the type.purpose attribute definition.
;        
         3.9.02    2012-01-25           
;
For import.get change the key "fram" to "save".
;        
         3.10.01   2012-05-07           
;
Revamp the type.purpose states. Remove state "Limit"
Add the new attribute type.source
Change dictionary.class "Attribute" to "Reference"
Removed attribute enumeration_set.construct
;        
         3.10.02   2012-10-16           
;
Correct enum states for type.contents and type.container
;        
         3.10.03   2012-11-20           
;
Remove "Implied" as an enumeration state for type.contents 
;        
         3.10.04   2013-02-12           
;
Added missing loop statement to methods of dictionary_valid.application.
Corrected the definition of the enumeration state 'Code' in type.contents.
;        
         3.10.05   2013-02-22           
;
Add state value to enum_set loop of import.get defn as the key 
;        
         3.10.06   2013-02-25           
;
Remove the quotes from Multiple string in type.container definition 
Add 'Functions' to the enumeration states of definition.class
;        
         3.10.07   2013-03-03           
;
Added type.contents enum state "Implied" for category key definitions
;        
         3.10.08   2013-03-06           
;
Added various attributes to conform with ALIGN requirements
;        
         3.11.01   2013-04-11           
;
Added type.source to all definitions
Change type.contents state "Table" to "Pairs"
;        
         3.11.02   2013-04-16           
;
Removed 'Measured' as a state for type.source
;        
         3.11.03   2013-04-24           
;
   Changed type.source 'Quantity' to 'Number' or 'Encode'
   State 'Float' in type.contents removed.
;        
         3.11.04   2013-09-08           
;
   Attribute _alias.deprecation_date added.
   Attribute _category.key_list      added.
   The attribute _category.key_list added to all Loop category defs.
;        
         3.11.05   2014-09-18           
;
   Looped category _category_key replaces _category.key_list
   Added _category_key.name and changed all occurrences of 
   _category.key_list to _category_key.name
   Changed _type.source and _type.purpose to Recommended (JRH)
;        
         3.11.06   2015-01-27           
;
   Replaced stub category names with full category names in _name.category_id
   and _name.object_id.
   Corrected all _category.key_name to _category_key.name (JRH)
; 
         3.11.07   2015-01-27
;
   Converted to CIF2 format using automatic tool and post-editing for 
   presentation (JRH). 
;
         3.11.08   2015-01-28
;
   Created _dictionary_valid.scope and corrected dREL method for 
   _dictionary_valid.application. 
;
         3.11.09   2015-05-07
;
   Removed _enumerated.table_id and replaced with ByReference attributes
   _type.contents_referenced_id and _type.indices_referenced_id. Updated
   _type.contents and _type.purpose to describe the ByReference approach.
   Fixed _import.get dREL methods by moving individual table entries into
   a sub-category and adding reference and order attributes. (James Hester/
   John Bollinger)
;
