DDI 3.1 XML Schema Documentation (2009-10-18)
© DDI Alliance 2009 - licensed under the terms of the GNU Lesser General Public License
complexType "SubGroupType"
Namespace:
Content:
complex, 16 attributes, 23 elements
Defined:
globally in group.xsd, see XML source
Includes:
definitions of 9 attributes and 20 elements
Used:
XML Representation Summary
<...
    action
 = 
("Add" | "Update" | "Delete")
    dataSet
 = 
("D0" | "D1" | "D2" | "D3" | "D4")
    geography
 = 
("G0" | "G1" | "G2" | "G3" | "G4")
    groupInherits
 = 
xs:boolean : "true"
    id
 = 
xs:string
    instrument
 = 
("I0" | "I1" | "I2" | "I3")
    isVersionable
 = 
"true"
    language
 = 
("L0" | "L1" | "L2" | "L3" | "L4" | "L5" | "L6" | "L7")
    objectSource
 = 
xs:anyURI
    panel
 = 
("P0" | "P1" | "P2" | "P3" | "P4")
    time
 = 
("T0" | "T1" | "T2" | "T3" | "T4" | "T5")
    urn
 = 
xs:anyURI
    userDefinedGroupProperty
 = 
xs:string
    userDefinedGroupPropertyValue
 = 
xs:string
    version
 = 
xs:string
    versionDate
 = 
(xs:dateTime | xs:date | xs:gYearMonth | xs:gYear | xs:duration)
    >
   
Content: 
UserID*, VersionResponsibility?, VersionRationale*, r:Citation?, Abstract*, Purpose+, r:SeriesStatement?, r:FundingInformation*, r:Coverage?, r:UniverseReference?, r:OtherMaterial*, a:Archive?, r:Note*, Concepts*, DataCollection*, LogicalProduct*, PhysicalDataProduct*, cm:Comparison?, pr:DDIProfile*, DDIProfileReference*, StudyUnit*, SubGroup*, Reference*
</...>
Content Model Elements (23):
All Direct / Indirect Based Elements (1):
Known Usage Locations
Annotation
The subgroup element is a container for a group that is a child of a higher-level group described in this module, but may also be a parent to other (subordinate) groups. A group can be fully described, or just referenced, within its subgroup container.
Type Definition Detail
Type Derivation Tree
      r:VersionableType (extension)
          SubGroupType (extension)
XML Source (w/o annotations (30); see within schema source)
<xs:complexType name="SubGroupType">
<xs:complexContent>
<xs:extension base="r:VersionableType">
<xs:sequence>
<xs:element minOccurs="0" ref="r:Citation"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="Abstract"/>
<xs:element maxOccurs="unbounded" ref="Purpose"/>
<xs:element minOccurs="0" ref="r:SeriesStatement"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="r:FundingInformation"/>
<xs:element minOccurs="0" ref="r:Coverage"/>
<xs:element minOccurs="0" ref="r:UniverseReference"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="r:OtherMaterial"/>
<xs:element minOccurs="0" ref="a:Archive"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="r:Note"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="Concepts"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="DataCollection"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="LogicalProduct"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="PhysicalDataProduct"/>
<xs:element minOccurs="0" ref="cm:Comparison"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="pr:DDIProfile"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="DDIProfileReference"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="StudyUnit"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="SubGroup"/>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="Reference"/>
</xs:sequence>
<xs:attribute name="time" type="TimeGroupCodeType" use="required"/>
<xs:attribute name="instrument" type="InstrumentGroupCodeType" use="required"/>
<xs:attribute name="panel" type="PanelGroupCodeType" use="required"/>
<xs:attribute name="geography" type="GeographyGroupCodeType" use="required"/>
<xs:attribute name="dataSet" type="DataSetGroupCodeType" use="required"/>
<xs:attribute name="language" type="LanguageGroupCodeType" use="required"/>
<xs:attribute name="userDefinedGroupProperty" type="xs:string" use="optional"/>
<xs:attribute name="userDefinedGroupPropertyValue" type="xs:string" use="optional"/>
<xs:attribute default="true" name="groupInherits" type="xs:boolean"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
Attribute Detail (defined in this component only; 9/16)
dataSet
Type:
Use:
required
Indicates how all members of the group are related in terms of physical data products in relation to data collection efforts.
Attribute Value
enumeration of xs:NMTOKEN
Enumeration:
"D0"
 - 
No specified relationship
"D1"
 - 
Single data file from a data collection
"D2"
 - 
Multiple data products from a single data collection
"D3"
 - 
Integration of multiple data sets into a single integrated structure
"D4"
 - 
Multiple data files each from a different data collection
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="dataSet" type="DataSetGroupCodeType" use="required"/>

geography
Type:
Use:
required
Indicates how all members of the group are related along the dimension of geography.
Attribute Value
enumeration of xs:NMTOKEN
Enumeration:
"G0"
 - 
No specified relationship
"G1"
 - 
Single geography surveyed multiple times
"G2"
 - 
Single geography surveyed once
"G3"
 - 
Rolling geography
"G4"
 - 
Different geography each survey
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="geography" type="GeographyGroupCodeType" use="required"/>

groupInherits
Type:
xs:boolean, predefined
Use:
optional
Default is true, and allows for inheritance of all properties and modules, and the use of lower-level over-rides. If set to false, inheritance is switched off for specific groups.
Attribute Value
Default:
"true"
XML Source (w/o annotations (1); see within schema source)
<xs:attribute default="true" name="groupInherits" type="xs:boolean"/>

instrument
Type:
Use:
required
Indicates how all members of the group are related in terms of the instruments used to collect data (single, multiple, etc.).
Attribute Value
enumeration of xs:NMTOKEN
Enumeration:
"I0"
 - 
No specified relationship
"I1"
 - 
Single
"I2"
 - 
Multiple: Integrated set of 2 or more instruments used for different subpopulations
"I3"
 - 
Multiple: Base with Topical changes
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="instrument" type="InstrumentGroupCodeType" use="required"/>

language
Type:
Use:
required
Indicates how all members of the group are related in terms of physical data products in relation to data collection efforts.
Attribute Value
enumeration of xs:NMTOKEN
Enumeration:
"L0"
 - 
No formal relationship - not a factor of grouping
"L1"
 - 
Single language
"L2"
 - 
All original languages with full language equivalence
"L3"
 - 
Original language(s) plus translation(s) with full language equivalence
"L4"
 - 
Translations from external original; full language equivalence
"L5"
 - 
Translations from a non-included original and have full language equivalence
"L6"
 - 
Original languages(s) plus translation(s) with partial relationship
"L7"
 - 
Translations from external original; partial relationships
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="language" type="LanguageGroupCodeType" use="required"/>

panel
Type:
Use:
required
Indicates how all members of the group are related in terms of type of panel (single, rolling, etc.).
Attribute Value
enumeration of xs:NMTOKEN
Enumeration:
"P0"
 - 
No specified relationship
"P1"
 - 
Single panel surveyed multiple times
"P2"
 - 
Single panel surveyed once
"P3"
 - 
Rolling panel
"P4"
 - 
Different panel each survey
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="panel" type="PanelGroupCodeType" use="required"/>

time
Type:
Use:
required
Indicates how all members of the group are related along the dimension of time (for example single occurrence, multiple occurrence, etc.).
Attribute Value
enumeration of xs:NMTOKEN
Enumeration:
"T0"
 - 
No specified relationship
"T1"
 - 
Single Occurrence
"T2"
 - 
Multiple Occurrence: Regular Occurrence: Continuing
"T3"
 - 
Multiple Occurrence: Regular Occurrence: Limited time
"T4"
 - 
Multiple Occurrence: Irregular Occurrence: Continuing
"T5"
 - 
Multiple Occurrence: Irregular Occurrence: Limited time
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="time" type="TimeGroupCodeType" use="required"/>

userDefinedGroupProperty
Type:
xs:string, predefined
Use:
optional
Provides a user-defined group property, different from those supplied in other attributes.
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="userDefinedGroupProperty" type="xs:string" use="optional"/>

userDefinedGroupPropertyValue
Type:
xs:string, predefined
Use:
optional
Provides a value for the user-defined group property supplied in userDefinedGroupProperty.
XML Source (w/o annotations (1); see within schema source)
<xs:attribute name="userDefinedGroupPropertyValue" type="xs:string" use="optional"/>
Content Element Detail (defined in this component only; 20/23)
a:Archive
Type:
a:ArchiveType, complex content
Provides archive-specific information, including a listing of items.
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" ref="a:Archive"/>

Abstract
Type:
Human-readable summary of the grouped material.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="Abstract"/>

cm:Comparison
Type:
cm:ComparisonType, complex content
Provides documentation regarding the comparability of study units or subgroups within the containing group.
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" ref="cm:Comparison"/>

Concepts
Type:
ConceptType, complex content
Lists, or references, the concepts describing the data that are being documented.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="Concepts"/>

DataCollection
Type:
DataCollectionType, complex content
Shared documentation regarding data collection for all members of the group, subject to over-rides at a lower level.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="DataCollection"/>

DDIProfileReference
Type:
r:ReferenceType, complex content
References a DDI Profile used by the group or resource package.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="DDIProfileReference"/>

LogicalProduct
Type:
LogicalProductType, complex content
Shared documentation regarding the logical data products of all members of the group, subject to over-rides at a lower level.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="LogicalProduct"/>

PhysicalDataProduct
Type:
PhysicalDataProductType, complex content
Shared documentation regarding physical data products of all members of the group, subject to over-rides at a lower level.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="PhysicalDataProduct"/>

pr:DDIProfile
Type:
pr:DDIProfileType, complex content
Contains a DDI Profile which is used by the group, and which can be referenced externally. If contained in a ResourcePackage, it is intended only for re-use elsewhere.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="pr:DDIProfile"/>

Purpose
Type:
Human-readable explanation of why the creator grouped these objects together. Example: Grouping of Longitudinal Survey elements. Example: Collection of StudyUnits to be used by class SOC1257- Impact of Aging on Social Services. Use this element to describe the nature of a series and/or the reason for treating the studyunits as a group. Include information on the limitations of the grouping and intended usage if applicable.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" ref="Purpose"/>

r:Citation
Type:
r:CitationType, complex content
Includes bibliographic citation information for the group.
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" ref="r:Citation"/>

r:Coverage
Type:
r:CoverageType, complex content
Documents the topical, spatial, and temporal coverage of the group.
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" ref="r:Coverage"/>

r:FundingInformation
Type:
r:FundingInformationType, complex content
Provides information about the agency and grant(s) which funded the group.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="r:FundingInformation"/>

r:Note
Type:
r:NoteType, complex content
Notes regarding the group as a whole, or pertaining to all members of the group.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="r:Note"/>

r:OtherMaterial
Type:
r:OtherMaterialType, complex content
References other materials related to the group.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="r:OtherMaterial"/>

r:SeriesStatement
Type:
r:SeriesStatementType, complex content
Information regarding the official series of which a study unit or group of study units is a part. You may point to the URL of a series repository and then use the Name field to indicate the series itself as identified in that repository. Fields also exist for describing the series and providing abbreviations.
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" ref="r:SeriesStatement"/>

r:UniverseReference
Type:
r:ReferenceType, complex content
References the universe or sub-universe of the group.
XML Source (w/o annotations (1); see within schema source)
<xs:element minOccurs="0" ref="r:UniverseReference"/>

Reference
Type:
r:ReferenceType, complex content
References a sub-group that is the child of a higher-level group or sub-group described in this module.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="Reference"/>

StudyUnit
Type:
StudyUnitType, complex content
Description of an individual study being documented as a member of the group. The study unit description inherits all metadata found at higher levels - that is, all metadata and documentation describing the groups and subgroups of which the study unit is a member. This metadata and documentation may be over-ridden within the study unit.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="StudyUnit"/>

SubGroup
Type:
SubGroupType, complex content
Includes fully detailed, in-line information about a group that is the child of a higher-level group described in this module.
XML Source (w/o annotations (1); see within schema source)
<xs:element maxOccurs="unbounded" minOccurs="0" ref="SubGroup"/>

XML schema documentation generated with DocFlex/XML SDK 1.7.2 using DocFlex/XML XSDDoc 2.1.0 template set