StatisticalClassification ------------------------- A Statistical Classification is a set of categories which may be assigned to one or more variables registered in statistical surveys or administrative files, and used in the production and dissemination of statistics. The categories at each level of the classification structure must be mutually exclusive and jointly exhaustive of all objects/units in the population of interest. The categories are defined with reference to one or more characteristics of a particular population of units of observation. A Statistical Classification may have a flat, linear structure or may be hierarchically structured, such that all categories at lower Levels are sub-categories of categories at the next Level up. Categories in Statistical Classifications are represented in the information model as Classification Items. Properties ~~~~~~~~~~ .. csv-table:: :header: "Name","Type","","Description" :widths: 15,10,5,100 "ReleaseDate","cogsDate","0..1","Date on which the Statistical Classification was released." "TerminationDate","cogsDate","0..1","Date on which the Statistical Classification was superseded by a successor version or otherwise ceased to be valid." "IsCurrent","boolean","0..1","Indicates whether or not the Statistical Classification is currently valid." "MaintenanceUnitReference",":doc:`/item-types/Agent/index`","0..n","The unit or group of persons within the organization who are responsible for the Statistical Classification (i.e, for maintaining, updating and changing it). TypeOfObject should be set to Organization or Individual." "ContactPersonReference",":doc:`/item-types/Agent/index`","0..n","Person(s) who may be contacted for additional information about the Statistical Classification. TypeOfObject should be set to Organization or Individual." "LegalBase",":doc:`/composite-types/StructuredStringType/index`","0..n","Indicates that the Statistical Classification is covered by a legal act or by some other formal agreement. Supports the use of multiple languages and structured content." "Publication",":doc:`/composite-types/PublicationType/index`","0..n","A list of the publications, including print, PDF, HTML and other electronic formats, in which the Statistical Classification has been published." "Copyright",":doc:`/composite-types/InternationalStringType/index`","0..1","Statistical Classifications may have restricted copyrights. Such Statistical Classifications might be excluded from downloading. Notes the copyright statement that should be displayed in official publications to indicate the copyright owner." "IsDisseminationAllowed","boolean","0..1","Indicates whether or not the Statistical Classification may be published or otherwise disseminated (e.g. electronic dissemination)." "LevelContext",":doc:`/composite-types/LevelContextType/index`","0..n","Level Context provides the depth of a Level within a Statistical Classification together with its membership. Both depth and membership can be specified per Statistical Classification." "ClassificationIndexReference",":doc:`/item-types/ClassificationIndex/index`","0..n","A Statistical Classification can be associated with one or a number of Classification Indexes in which Classification Index Entries are linked to the appropriate Classification Item. Include here links to any relevant Classification Indexes. Allows for in-line entry of a Classification Indexes." "IsVersion","boolean","0..1","Indicates if the Statistical Classification is a version." "IsUpdate","boolean","0..1","Indicates if the Statistical Classification is an update." "IsFloating","boolean","0..1","Indicates if the Statistical Classification is a floating classification. In a floating statistical classification, a validity period should be defined for all Classification Items which will allow the display of the item structure and content at different points of time." "PredecessorReference",":doc:`/item-types/StatisticalClassification/index`","0..1","For those Statistical Classifications that are versions or updates, notes the preceding Statistical Classification of which the actual Statistical Classification is the successor. TypeOfObject should be set to StatisticalClassification." "SuccessorReference",":doc:`/item-types/StatisticalClassification/index`","0..1","Notes the Statistical Classification that superseded the actual Statistical Classification. TypeOfObject should be set to StatisticalClassification." "DerivedFromReference",":doc:`/item-types/StatisticalClassification/index`","0..1","A Statistical Classification can be derived from one of the classification versions of another Classification Series. The derived Statistical Classification can either inherit the structure of the classification version from which it is derived, usually adding more detail, or use a large part of its Classification Items, rearranging them in a different structure. Indicates the classification version from which the actual Statistical Classification is derived. TypeOfObject should be set to StatisticalClassification." "ChangesFromPreceding",":doc:`/composite-types/StructuredStringType/index`","0..1","A summary description of the nature and content of changes from the preceding version or update. Specific changes are recorded in the Classification Item object under the -Changes from previous version and updates- attribute. Supports the use of multiple languages and structured content." "UpdatesAllowed","boolean","0..1","Indicates whether or not updates are allowed within the classification version i.e. without leading to a new version." "PermissibleUpdates",":doc:`/composite-types/StructuredStringType/index`","0..1","If Updates are Allowed, Indicate here what structural changes, if any, are permissible within a version. Note whether Classification Items can be added to the structure and whether they can be revalidated or invalidated. Such changes are more likely to be permissible in floating classifications. Also indicate whether changes to such things as Classification Item names and explanatory notes that do not involve structural changes are permissible within a version. Supports the use of multiple languages and structured content." "Updates",":doc:`/composite-types/StructuredStringType/index`","0..1","Summary description of changes which have occurred since the most recent classification version or classification update came into force. Supports the use of multiple languages and structured content." "VariantOfReference",":doc:`/item-types/StatisticalClassification/index`","0..1","For those Statistical Classifications that are variants, notes the Statistical Classification on which it is based and any subsequent versions of that Statistical Classification to which it is also applicable. TypeOfObject should be set to StatisticalClassification." "VariantChangesFromBase",":doc:`/composite-types/StructuredStringType/index`","0..1","Describes the relationship between the variant and its base Statistical Classification, including regrouping, aggregations added and extensions. Supports the use of multiple languages and structured content." "VariantPurpose",":doc:`/composite-types/StructuredStringType/index`","0..1","If the Statistical Classification is a variant, notes the specific purpose for which it was developed. Supports the use of multiple languages and structured content." Properties Inherited from Describable ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. csv-table:: :header: "Name","Type","","Description" :widths: 15,10,5,100 "Name",":doc:`/composite-types/NameType/index`","0..n","A name for the item. May be expressed in multiple languages. Repeat the element to express names with different content, for example different names for different systems." "Label",":doc:`/composite-types/LabelType/index`","0..n","A display label for the item. May be expressed in multiple languages. Repeat for labels with different content, for example, labels with differing length limitations." "Description",":doc:`/composite-types/StructuredStringType/index`","0..1","A description of the content and purpose of the item. May be expressed in multiple languages and supports the use of structured content." Properties Inherited from Versionable ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. csv-table:: :header: "Name","Type","","Description" :widths: 15,10,5,100 "URN","string","1..1","" "Agency","string","1..1","" "ID","string","1..1","" "Version","string","1..1","" "UserID",":doc:`/composite-types/UserIDType/index`","0..n","Allows for the specification of identifiers other than the specified DDI identification of the object. This may be a legacy ID from DDI-C, a system specific ID such as for a database or registry, or a non-DDI unique identifier. As the identifier is specific to a system the system must be identified with the UserID structure." "UserAttributePair",":doc:`/composite-types/StandardKeyValuePairType/index`","0..n","A system specific user defined property of the object expressed as a key/value pair. As this is specific to an individual system the use of controlled vocabularies for the key is strongly recommended." "VersionResponsibility","string","0..1","Person or organization within the MaintenanceAgency responsible for the version change. If it is important to retain the affiliation between and individual responsible for the version and his/her agency, it may be included in this notation. This is primarily intended for internal use." "VersionResponsibilityReference",":doc:`/item-types/Agent/index`","0..1","Reference person or organization within the MaintenanceAgency responsible for the version change, as described in an OrganizationScheme. If it is important to retain the affiliation between and individual responsible for the version and his/her agency, a Relation should be created between the individual referenced here and his/her organization. This is primarily intended for internal use." "VersionRationale",":doc:`/composite-types/VersionRationaleType/index`","0..1","Textual description of the rationale/purpose for the version change and a coded value to provide an internal processing flag within and organization or system. Note that versioning can only take place on objects owned by the specified DDI Agency. If you are creating a local instance of an object from another agency for current or future modification use BasedOnObject. If the changes being made result in what you determine to be new object rather than a version of a previous object, i.e. the change is too extensive to consider it a version of the existing object, create a new object and use BasedOnObject to provide a link to the object or objects that were a basis for the new object." "BasedOnObject",":doc:`/composite-types/BasedOnObjectType/index`","0..1","Use when creating an object that is based on an existing object or objects that are managed by a different agency or when the new object is NOT simply a version change but you wish to maintain a reference to the object that served as a basis for the new object. BasedOnObject may contain references to any number of objects which serve as a basis for this object, a BasedOnRationalDescription of how the content of the referenced object was incorporated or altered, and a BasedOnRationalCode to allow for specific typing of the BasedOnReference according to an external controlled vocabulary." "RelatedOtherMaterialReference",":doc:`/item-types/OtherMaterial/index`","0..n","The inclusion of an existing OtherMaterial by reference. Use for any type of OtherMaterial not specifically addressed by an inline description for such as ExternalAid in QuestionItem." "VersionDate","cogsDate","0..1","Date of version using the union set BaseDateType. Duration should not be used in this field, even though allowed by the ISO format enforced by the parser." "IsPublished","boolean","0..1","Indicates that the maintainable will not be changed without versioning, and is a stable target for referencing." Item Type Hierarchy ~~~~~~~~~~~~~~~~~~~ * :doc:`/item-types/Versionable/index` * :doc:`/item-types/Describable/index` * **StatisticalClassification** Relationships ~~~~~~~~~~~~~ The following types reference this type. * :doc:`/item-types/ClassificationCorrespondenceTable/index` * :doc:`/item-types/ClassificationSeries/index` * :doc:`/composite-types/CodeRepresentationBaseType/index` .. container:: image |stub| .. |stub| image:: ../../images/StatisticalClassification.svg