element <nCubeGrp> (global)
Namespace:
Type:
Content:
complex, 17 attributes, 6 elements
Defined:
globally in codebook.xsd; see XML source
Used:
XML Representation Summary
<nCubeGrp
   
 = 
xs:ID
 = 
xs:NMTOKEN
 = 
xs:language
 = 
("archive" | "producer") : "producer"
 = 
xs:string
 = 
(xs:dateTime | xs:date | xs:gYearMonth | xs:gYear)
 = 
xs:anyURI
 = 
xs:anyURI
 = 
("section" | "multipleResp" | "grid" | "display" | "repetition" | "subject" | "version" | "iteration" | "analysis" | "pragmatic" | "record" | "file" | "randomized" | "other") : "other"
 = 
xs:NMTOKEN
 = 
xs:IDREFS
 = 
xs:IDREFS
 = 
xs:string
 = 
xs:IDREFS
 = 
xs:IDREFS
 = 
xs:IDREFS
 = 
xs:IDREFS
    >
   
Content: 
labl*, txt*, concept*, defntn*, universe*, notes*
</nCubeGrp>
Content model elements (6):
concept, defntn, labl, notes, txt, universe
Included in content model of elements (1):
dataDscr
Known Usage Locations
Annotation

nCube Group

Description

A group of nCubes that may share a common subject, arise from the interpretation of a single question, or are linked by some other factor. This element makes it possible to identify all nCubes derived from a simple presentation table, and to provide the original table title and universe, as well as reference the source. Specific nesting patterns can be described using the attribute nCubeGrp.

nCube groups are also created this way in order to permit nCubes to belong to multiple groups, including multiple subject groups, without causing overlapping groups. nCubes that are linked by the same use of the same variable need not be identified by an nCubeGrp element because they are already linked by a common variable element. Note that as a result of the strict sequencing required by XML, all nCube Groups must be marked up before the Variable element is opened. That is, the mark-up author cannot mark up a nCube Group, then mark up its constituent nCubes, then mark up another nCube Group.

The "type" attribute refers to the general type of grouping of the nCubes. Specific nCube Groups, included within the 'type' attribute, are:

Display: nCubes that are part of the same presentation table.

Subject: nCubes that address a common topic or subject, e.g., income, poverty, children.

Iteration: nCubes that appear in different sections of the data file measuring a common subject in different ways, e.g., using different universes, units of measurement, etc.

Pragmatic: An nCube group without shared properties.

Record: nCubes from a single record in a hierarchical file.

File: nCube from a single file in a multifile study.

Other: nCubes that do not fit easily into any of the categories listed above, e.g., a group of nCubes whose documentation is in another language. A term from a controlled vocabulary may be placed into the otherType attribute if this value is used.

The otherType attribute should only be used when applying a controlled vocabulary, and when the type attribute has been given a value of "other". Use the complex element controlledVocabUsed to identify the controlled vocabulary to which the selected term belongs.

The "nCube" attribute is used to reference all the IDs of the nCubes belonging to the group.

The "nCubeGrp" attribute is used to reference all the subsidiary nCube groups which nest underneath the current nCubeGrp. This allows for encoding of a hierarchical structure of nCube groups.

The attribute "name" provides a name, or short label, for the group.

The "sdatrefs" are summary data description references that record the ID values of all elements within the summary data description section of the Study Description that might apply to the group. These elements include: time period covered, date of collection, nation or country, geographic coverage, geographic unit, unit of analysis, universe, and kind of data.

The "methrefs" are methodology and processing references which record the ID values of all elements within the study methodology and processing section of the Study Description which might apply to the group. These elements include information on data collection and data appraisal (e.g., sampling, sources, weighting, data cleaning, response rates, and sampling error estimates).

The "pubrefs" attribute provides a link to publication/citation references and records the ID values of all citations elements within Section codeBook/stdyDscr/othrStdyMat or codeBook/otherMat that pertain to this nCube group.

The "access" attribute records the ID values of all elements in codeBook/stdyDscr/dataAccs of the document that describe access conditions for this nCube group.

XML Source (w/o annotations (1); see within schema source)
<xs:element name="nCubeGrp" type="nCubeGrpType"/>
Attribute Detail (all declarations; 17/17)
access
Type:
xs:IDREFS, predefined
Use:
optional
Defined:
locally within nCubeGrpType complexType
XML Source (see within schema source)
<xs:attribute name="access" type="xs:IDREFS"/>

ddiCodebookUrn
Type:
xs:anyURI, predefined
Use:
optional
Defined:
locally within GLOBALS attributeGroup
Used to capture the DDI-Codebook type URN for the element. This is used to assign a DDI-Codebook specific URN to the element, according the format prescribed by the DDI-Codebook standard.
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="ddiCodebookUrn" type="xs:anyURI" use="optional"/>

ddiLifecycleUrn
Type:
xs:anyURI, predefined
Use:
optional
Defined:
locally within GLOBALS attributeGroup
Used to capture the DDI-Lifecycle type URN for the element. This may be captured during translation from DDI-Lifecycle to DDI-Codebook structure or in preparation for transferring to a DDI-Lifecycle structure.
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="ddiLifecycleUrn" type="xs:anyURI" use="optional"/>

elementVersion
Type:
xs:string, predefined
Use:
optional
Defined:
locally within GLOBALS attributeGroup
Captures version of the element
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="elementVersion" type="xs:string" use="optional"/>

elementVersionDate
Type:
Use:
optional
Defined:
locally within GLOBALS attributeGroup
Indicates version date for the element. Use YYYY-MM-DD, YYYY-MM, or YYYY formats.
Attribute Value
xs:dateTime | xs:date | xs:gYearMonth | xs:gYear
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="elementVersionDate" type="dateSimpleType" use="optional"/>

ID
Type:
xs:ID, predefined
Use:
optional
Defined:
locally within GLOBALS attributeGroup
XML Source (see within schema source)
<xs:attribute name="ID" type="xs:ID" use="optional"/>

methrefs
Type:
xs:IDREFS, predefined
Use:
optional
Defined:
locally within nCubeGrpType complexType
XML Source (see within schema source)
<xs:attribute name="methrefs" type="xs:IDREFS"/>

name
Type:
xs:string, predefined
Use:
optional
Defined:
locally within nCubeGrpType complexType
XML Source (see within schema source)
<xs:attribute name="name" type="xs:string"/>

nCube
Type:
xs:IDREFS, predefined
Use:
optional
Defined:
locally within nCubeGrpType complexType
XML Source (see within schema source)
<xs:attribute name="nCube" type="xs:IDREFS"/>

nCubeGrp
Type:
xs:IDREFS, predefined
Use:
optional
Defined:
locally within nCubeGrpType complexType
XML Source (see within schema source)
<xs:attribute name="nCubeGrp" type="xs:IDREFS"/>

otherType
Type:
xs:NMTOKEN, predefined
Use:
optional
Defined:
locally within nCubeGrpType complexType
XML Source (see within schema source)
<xs:attribute name="otherType" type="xs:NMTOKEN" use="optional"/>

pubrefs
Type:
xs:IDREFS, predefined
Use:
optional
Defined:
locally within nCubeGrpType complexType
XML Source (see within schema source)
<xs:attribute name="pubrefs" type="xs:IDREFS"/>

sdatrefs
Type:
xs:IDREFS, predefined
Use:
optional
Defined:
locally within nCubeGrpType complexType
XML Source (see within schema source)
<xs:attribute name="sdatrefs" type="xs:IDREFS"/>

source
Type:
anonymous simpleType (restriction of xs:NMTOKEN)
Use:
optional
Defined:
locally within GLOBALS attributeGroup
Attribute Value
enumeration of xs:NMTOKEN
Enumeration:
"archive", "producer"
Default:
"producer"
Anonymous simpleType
Type Derivation Tree
xs:NMTOKEN (restriction)
  simpleType
Derivation:
restriction of xs:NMTOKEN
Facets:
enumeration:
"archive", "producer"
XML Source (see within schema source)
<xs:attribute default="producer" name="source">
<xs:simpleType>
<xs:restriction base="xs:NMTOKEN">
<xs:enumeration value="archive"/>
<xs:enumeration value="producer"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>

type
Type:
anonymous simpleType (restriction of xs:NMTOKEN)
Use:
optional
Defined:
locally within nCubeGrpType complexType
Attribute Value
enumeration of xs:NMTOKEN
Enumeration:
"section", "multipleResp", "grid", "display", "repetition", "subject", "version", "iteration", "analysis", "pragmatic", "record", "file", "randomized", "other"
Default:
"other"
Anonymous simpleType
Type Derivation Tree
xs:NMTOKEN (restriction)
  simpleType
Derivation:
restriction of xs:NMTOKEN
Facets:
enumeration:
"section", "multipleResp", "grid", "display", "repetition", "subject", "version", "iteration", "analysis", "pragmatic", "record", "file", "randomized", "other"
XML Source (see within schema source)
<xs:attribute default="other" name="type">
<xs:simpleType>
<xs:restriction base="xs:NMTOKEN">
<xs:enumeration value="section"/>
<xs:enumeration value="multipleResp"/>
<xs:enumeration value="grid"/>
<xs:enumeration value="display"/>
<xs:enumeration value="repetition"/>
<xs:enumeration value="subject"/>
<xs:enumeration value="version"/>
<xs:enumeration value="iteration"/>
<xs:enumeration value="analysis"/>
<xs:enumeration value="pragmatic"/>
<xs:enumeration value="record"/>
<xs:enumeration value="file"/>
<xs:enumeration value="randomized"/>
<xs:enumeration value="other"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>

xml-lang
Type:
xs:NMTOKEN, predefined
Use:
optional
Defined:
locally within GLOBALS attributeGroup
DO NOT USE THIS ATTRIBUTE. Its inclusion is an error that was persisted to retain backward compatibility. If this attribute has been used, transfer the content to xml:lang.
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="xml-lang" type="xs:NMTOKEN" use="optional"/>

xml:lang
Type:
xs:language, predefined
Use:
optional
Defined:
by reference within GLOBALS attributeGroup
XML Source (see within schema source)
<xs:attribute ref="xml:lang" use="optional"/>
Content Element Detail (all declarations; 6/6)
concept
Type:
conceptType, mixed content
Defined:
by reference within nCubeGrpType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="concept"/>

defntn
Type:
simpleTextType, mixed content
Defined:
by reference within nCubeGrpType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="defntn"/>

labl
Type:
lablType, mixed content
Defined:
by reference within nCubeGrpType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="labl"/>

notes
Type:
notesType, mixed content
Defined:
by reference within nCubeGrpType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="notes"/>

txt
Type:
txtType, mixed content
Defined:
by reference within nCubeGrpType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="txt"/>

universe
Type:
universeType, mixed content
Defined:
by reference within nCubeGrpType complexType
XML Source (see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="universe"/>

XML schema documentation generated with DocFlex/XML 1.8.7 using DocFlex/XML XSDDoc 2.7.0 template set