XML Schema "physicalinstance.xsd"
Target Namespace:
ddi:physicalinstance:3_2
Defined Components:
elements (29 global + 9 local), complexTypes (18), simpleTypes (2)
Default Namespace-Qualified Form:
Local Elements: qualified; Local Attributes: unqualified
Schema Location:
D:\XMLSchema\DDI\DDI_3_2_2014-02-05_Documentation_XMLSchema\XMLSchema\physicalinstance.xsd; see XML source
Imports Schemas (1):
reusable.xsd [src]
Imported by Schemas (3):
group.xsd [src], instance.xsd [src], studyunit.xsd [src]
All Element Summary
AlgorithmSpecification
Specifies the type of the fingerprint (what algorithm or scheme).
Type:
xs:string
Content:
simple
Defined:
locally within DataFingerprintType complexType; see XML source
AlgorithmVersion
Contains the version of the algorithm.
Type:
xs:string
Content:
simple
Defined:
locally within DataFingerprintType complexType; see XML source
ByteOrder
Contains a term indicating the byte ordering.
Type:
Content:
simple, 7 attributes
Defined:
globally; see XML source
Used:
CaseQuantity
Number of cases or observations in the data file.
Type:
xs:integer
Content:
simple
Defined:
locally within GrossFileStructureType complexType; see XML source
CategoryStatistic
The value of a statistic associated with the category value indicated in the sibling CategoryValue element.
Type:
Content:
complex, 2 elements
Defined:
globally; see XML source
Used:
CategoryValue
References a specific Code within the variable if using a CodeRepresentation.
Type:
Content:
complex, 2 elements
Defined:
globally; see XML source
Used:
CreationSoftware
Describes a specific software package.
Type:
Content:
complex, 1 attribute, 6 elements
Defined:
globally; see XML source
Used:
DataFileIdentification
Identifies the data file documented in the physical instance and provides information about its location.
Type:
Content:
complex, 1 attribute, 2 elements
Defined:
globally; see XML source
Used:
DataFileURI
A URN or URL for the data file with a flag to indicate if it is a public copy.
Type:
Content:
simple, 1 attribute
Defined:
globally; see XML source
Used:
DataFileVersion
Provides the version information for the data file related to this physical instance.
Type:
Content:
complex, 2 attributes, 4 elements
Defined:
globally; see XML source
Used:
DataFingerprint
Allows for assigning a hash value (digital fingerprint) to the data or data file.
Type:
Content:
complex, 1 attribute, 3 elements
Defined:
globally; see XML source
Used:
DefaultMissingValuesReference
Identifies the default missing value parameter for the this physical instance by referencing a ManagedMissingValuesRepresentation plus flag to identify it as a system missing value.
Type:
Content:
complex, 8 attributes, 6 elements
Defined:
globally; see XML source
Used:
DigitalFingerprintValue
The DigitalFingerprintValue expressed as an xs:string.
Type:
xs:string
Content:
simple
Defined:
globally; see XML source
Used:
FilterCategoryValue
Provides the specific value of the variable being used as a filter.
Type:
xs:anyType
Content:
any
Defined:
FilterCategoryValueType
Provides the specific value of the variable being used as a filter.
Type:
Content:
complex, 2 elements
Defined:
globally; see XML source
Used:
never
FilteredCategoryStatistics
Category statistics filtered by the value of a second variable.
Type:
Content:
complex, 2 elements
Defined:
globally; see XML source
Used:
FilterVariableCategory
Category statistics for the variable when the filter variable contains the specified value.
Type:
Content:
complex, 2 elements
Defined:
globally; see XML source
Used:
FilterVariableReference
Reference to an existing Variable using the Reference structure.
Type:
Content:
complex, 7 attributes, 6 elements
Defined:
globally; see XML source
Used:
GrossFileStructure
Includes information about the file structure, as well as other characteristics that are specific to the physical instance.
Type:
Content:
complex, 5 attributes, 12 elements
Defined:
globally; see XML source
Used:
MissingValuesReference
Reference to an existing MissingValuesRepresentation using the Reference structure.
Type:
Content:
complex, 7 attributes, 6 elements
Defined:
globally; see XML source
Used:
OverallRecordCount
Overall record count in the data file.
Type:
xs:integer
Content:
simple
Defined:
locally within GrossFileStructureType complexType; see XML source
PhysicalInstance
Includes information about the physical instance of a data product (an actual data file).
Type:
Content:
complex, 9 attributes, 27 elements
Defined:
globally; see XML source
Used:
PlaceOfProduction
Indicates the place where the physical instance was produced expressed as a simple string.
Type:
xs:string
Content:
simple
Defined:
locally within GrossFileStructureType complexType; see XML source
ProcessingCheck
Processing Check provided using a StructuredString to support multiple language versions of the same content as well as optional formatting of the content.
Type:
Content:
complex, 1 element
Defined:
globally; see XML source
Used:
ProcessingStatus
Processing status of the data file.
Type:
Content:
simple, 7 attributes
Defined:
locally within GrossFileStructureType complexType; see XML source
StandardWeightReference
Reference to an existing StandardWeight using the Reference structure.
Type:
Content:
complex, 7 attributes, 6 elements
Defined:
globally; see XML source
Used:
Statistic
The value of the statistics and whether it is weighted and/or includes missing values.
Type:
Content:
simple, 2 attributes
Defined:
globally; see XML source
Used:
StatisticalDataLocation
References a PhysicalInstance module that describes a data file containing the summary and/or category statistics OR contains the statistics in-line.
Type:
Content:
complex, 1 attribute, 1 element
Defined:
globally; see XML source
Used:
StatisticalSummary
Provides a statistical summary of the data in the related file as a set of variable level and category level statistics.
Type:
Content:
complex, 3 elements
Defined:
globally; see XML source
Used:
SummaryStatistic
Describes a summary statistic for a variable.
Type:
Content:
complex, 2 elements
Defined:
globally; see XML source
Used:
TotalResponses
The total number of responses to this variable.
Type:
xs:integer
Content:
simple
Defined:
locally within VariableStatisticsType complexType; see XML source
TypeOfCategoryStatistic
A classification of the type of category statistic provided.
Type:
Content:
simple, 7 attributes
Defined:
globally; see XML source
Used:
TypeOfSummaryStatistic
A classification of the type of summary statistic provided.
Type:
Content:
simple, 7 attributes
Defined:
globally; see XML source
Used:
TypeOfVersionNumber
This is the name of the versioning scheme as defined by the user's system, in cases where the user's system employs more than one versioning scheme.
Type:
xs:string
Content:
simple
Defined:
locally within DataFileVersionType complexType; see XML source
UnfilteredCategoryStatistics
The unfiltered values of any number of statistics by category value representing the full response distribution of the variable.
Type:
Content:
complex, 1 element
Defined:
globally; see XML source
Used:
VariableCategory
A category value for which one or more statistics are recorded.
Type:
Content:
complex, 2 elements
Defined:
globally; see XML source
Used:
VariableStatistics
Contains summary and category level statistics for the referenced variable.
Type:
Content:
complex, 6 attributes, 19 elements
Defined:
globally; see XML source
Used:
VariableStatisticsReference
Inclusion of a VariableStatistics by reference TypeOfObject should be set to VariableStatistics.
Type:
Content:
complex, 7 attributes, 6 elements
Defined:
globally; see XML source
Used:
Complex Type Summary
The value of a statistic associated with the category value.
Content:
complex, 2 elements
Defined:
globally; see XML source
Includes:
definitions of 2 elements
Used:
A category value for which one or more statistics are recorded.
Content:
complex, 2 elements
Defined:
globally; see XML source
Includes:
definitions of 2 elements
Used:
Identifies the data file documented in the physical instance and provides information about its location.
Content:
complex, 1 attribute, 2 elements
Defined:
globally; see XML source
Includes:
definitions of 1 attribute, 2 elements
Used:
Provides the version information for the data file related to this physical instance.
Content:
complex, 2 attributes, 4 elements
Defined:
globally; see XML source
Includes:
definitions of 2 attributes, 4 elements
Used:
Allows for assigning a hash value (digital fingerprint) to the data or data file.
Content:
complex, 1 attribute, 3 elements
Defined:
globally; see XML source
Includes:
definitions of 1 attribute, 3 elements
Used:
Identifies the default missing value parameter for the this physical instance by referencing a ManagedMissingValuesRepresentation.
Content:
complex, 8 attributes, 6 elements
Defined:
globally; see XML source
Includes:
definition of 1 attribute
Used:
Category statistics filtered by the value of a second variable.
Content:
complex, 2 elements
Defined:
globally; see XML source
Includes:
definitions of 2 elements
Used:
Category statistics for the variable when the filter variable contains the specified value.
Content:
complex, 2 elements
Defined:
globally; see XML source
Includes:
definitions of 2 elements
Used:
Includes information about the file structure, as well as other characteristics that are specific to the physical instance.
Content:
complex, 5 attributes, 12 elements
Defined:
globally; see XML source
Includes:
definitions of 6 elements
Used:
Includes information about the physical instance of a data product (an actual data file).
Content:
complex, 9 attributes, 27 elements
Defined:
globally; see XML source
Includes:
definitions of 14 elements
Used:
References a PhysicalInstance module that describes a data file containing the summary and/or category statistics OR contains the statistics in-line.
Content:
complex, 1 attribute, 1 element
Defined:
globally; see XML source
Includes:
definitions of 1 attribute, 1 element
Used:
Provides a statistical summary of the data in the related file as a set of variable level and category level statistics.
Content:
complex, 3 elements
Defined:
globally; see XML source
Includes:
definitions of 3 elements
Used:
The value of the statistics and whether it is weighted and/or includes missing values.
Content:
simple, 2 attributes
Defined:
globally; see XML source
Includes:
definitions of 2 attributes
Used:
Describes a summary statistic for a variable.
Content:
complex, 2 elements
Defined:
globally; see XML source
Includes:
definitions of 2 elements
Used:
The unfiltered values of any number of statistics by category value representing the full response distribution of the variable.
Content:
complex, 1 element
Defined:
globally; see XML source
Includes:
definition of 1 element
Used:
A URN or URL for a file with a flag to indicate if it is a public copy.
Content:
simple, 1 attribute
Defined:
globally; see XML source
Includes:
definition of 1 attribute
Used:
A category value for which one or more statistics are recorded.
Content:
complex, 2 elements
Defined:
globally; see XML source
Includes:
definitions of 2 elements
Used:
Contains summary and category level statistics for the referenced variable.
Content:
complex, 6 attributes, 19 elements
Defined:
globally; see XML source
Includes:
definitions of 8 elements
Used:
Simple Type Summary
Defines the cases included in determining the statistic.
Defined:
globally; see XML source
Used:
Declares if the DataFingerprint is for a data file or for the data content.
Defined:
globally; see XML source
Used:
XML Source
<?xml version="1.0" encoding="UTF-8"?>
<!--

Copyright (c) 2014 DDI Alliance, DDI 3.2 release, 2014-02-05

This file is part of DDI 3.2 XML Schema.

DDI 3.2 XML Schema is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version.

DDI 3.2 XML Schema is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
for more details.

You should have received a copy of the GNU Lesser General Public License along
with DDI 3.2 XML Schema. If not, see <http://www.gnu.org/licenses/>.

-->
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="ddi:physicalinstance:3_2" xmlns="ddi:physicalinstance:3_2" xmlns:r="ddi:reusable:3_2" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:import namespace="ddi:reusable:3_2" schemaLocation="reusable.xsd"/>
<xs:element name="PhysicalInstance" type="PhysicalInstanceType">
<xs:annotation>
<xs:documentation>
Includes information about the physical instance of a data product (an actual data file). It completes the documentation contained in the Physical Data Product module that is specific to the individual file and serves as a descriptive record of the external data file. Physical Instance provides a citation for the data file, a link to the RecordLayout(s) used by the files records, a description of it coverage (as a constraint if different from the study), check figures for quality control (e.g. digital fingerprint, record count, etc.), and a statistical summary of the data in the file at both the variable and category level.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="PhysicalInstanceType">
<xs:annotation>
<xs:documentation>
Includes information about the physical instance of a data product (an actual data file). It completes the documentation contained in the Physical Data Product module that is specific to the individual file and serves as a descriptive record of the external data file. Physical Instance provides a citation for the data file, a link to the RecordLayout(s) used by the files records, a description of it coverage (as a constraint if different from the study), check figures for quality control (e.g. digital fingerprint, record count, etc.), and a statistical summary of the data in the file at both the variable and category level.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="r:MaintainableType">
<xs:sequence>
<xs:element minOccurs="0" ref="r:Citation">
<xs:annotation>
<xs:documentation>
A citation for the physical instance of a data set. Note that a DOI or similar unique identifier for the data file should be placed in InternationalIdentifier. It is strongly recommended that use of a Citation in this location includes the use of the optional sub-element Title.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="DataFingerprint">
<xs:annotation>
<xs:documentation>
Allows for assigning a hash value (digital fingerprint) to the data or data file. Set the attribute flag to "data" when the hash value provides a digital fingerprint to the data contained in the file regardless of the storage format (ASCII, SAS, binary, etc.). One approach to compute a data fingerprint is the Universal Numerical Fingerprint (UNF). Set the attribute flag to "dataFile" if the digital fingerprint is only for the data file in its current storage format.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" ref="r:Coverage">
<xs:annotation>
<xs:documentation>
Includes information about the topical, spatial, and temporal coverage of the physical instance. May be expressed as a restriction of the parent study coverage.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="r:OtherMaterial">
<xs:annotation>
<xs:documentation>
Provides information about other resources related to the physical instance.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="r:DataRelationshipReference">
<xs:annotation>
<xs:documentation>
Reference to the DataRelationship containing the LogicalRecord to which the RecordLayout refers. Repeat for cases where LogicalRecords are described in multiple DataRelationship structures. Note that this does not imply that all of the LogicalRecords described in the DataRelationship are contained, wholly or in part in the PhysicalInstance. This reference allows for a direct path between the PhysicalInstance and the related content found in a LogicalProduct.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="r:RecordLayoutReference">
<xs:annotation>
<xs:documentation>
References the record layout of the data documented in the physical instance.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" ref="DefaultMissingValuesReference">
<xs:annotation>
<xs:documentation>
References the content of the default missing values used in the file. The content of this file overrides default missing value information provided in the LogicalRecord. Allows for the specification that is a Systems Missing Value.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="DataFileIdentification">
<xs:annotation>
<xs:documentation>
Identifies the data file documented in the physical instance and provides information about its location.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" ref="DataFileVersion">
<xs:annotation>
<xs:documentation>
Provides the version information for the data file related to this physical instance. Note that while Physical Instance allows for multiple copies of the same data file (such as backup copies) the assumption is that they are identical in terms of content, layout, format and version.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="r:QualityStatementReference">
<xs:annotation>
<xs:documentation>
A reference to a Quality Statement pertaining to the quality of the study methodology, metadata, or data to which it is associated. Quality statements may be related to external quality standards.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" ref="GrossFileStructure">
<xs:annotation>
<xs:documentation>
Includes information about the file structure, as well as other characteristics that are specific to the physical instance.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" ref="r:ProprietaryInfo">
<xs:annotation>
<xs:documentation>
Contains information proprietary to the software package which produced the data file. This is expressed as a set of name-value pairs. The value may be taken from a controlled vocabulary.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" ref="StatisticalSummary">
<xs:annotation>
<xs:documentation>
Includes variable and category statistics data documented in the physical instance, or a reference to a physical instance where the statistics are described or located in line.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" ref="ByteOrder">
<xs:annotation>
<xs:documentation>
Contains a term from a controlled vocabulary indicating the byte ordering.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:element name="DataFileVersion" type="DataFileVersionType">
<xs:annotation>
<xs:documentation>
Provides the version information for the data file related to this physical instance. Note that while Physical Instance allows for multiple copies of the same data file (such as backup copies) the assumption is that they are identical in terms of content, layout, format and version.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="DataFileVersionType">
<xs:annotation>
<xs:documentation>
Provides the version information for the data file related to this physical instance. Note that while Physical Instance allows for multiple copies of the same data file (such as backup copies) the assumption is that they are identical in terms of content, layout, format and version. The minimum information required is the versionNumber. Additional information on the versionDate, the type of version number when multiple types are supported by an agency, as well as information on VersionResponsibility (inline or by reference) and VersionRationale are available to provide additional information for process tracking and/or informing users of the differences between this and the previous version of the file.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element minOccurs="0" name="TypeOfVersionNumber" type="xs:string">
<xs:annotation>
<xs:documentation>
This is the name of the versioning scheme as defined by the user's system, in cases where the user's system employs more than one versioning scheme.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:choice minOccurs="0">
<xs:annotation>
<xs:documentation>
Allows for identification of the person or organization within the maintenance agency responsible for the new version. This is primarily intended for internal use.
</xs:documentation>
</xs:annotation>
<xs:element ref="r:VersionResponsibility">
<xs:annotation>
<xs:documentation>
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.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:annotation>
<xs:documentation>
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.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:choice>
<xs:element minOccurs="0" ref="r:VersionRationale">
<xs:annotation>
<xs:documentation>
Textual description of the rationale/purpose for a version change.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:attribute name="versionNumber" type="xs:string" use="required">
<xs:annotation>
<xs:documentation>
The version number of the data file identified by this physical instance.
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="versionDate" type="r:BaseDateType" use="optional">
<xs:annotation>
<xs:documentation>
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.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:element name="ByteOrder" type="r:CodeValueType">
<xs:annotation>
<xs:documentation>
Contains a term indicating the byte ordering. Supports the use of a controlled vocabulary. DDI strongly recommends the use of a controlled vocabulary.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="DataFingerprint" type="DataFingerprintType">
<xs:annotation>
<xs:documentation>
Allows for assigning a hash value (digital fingerprint) to the data or data file.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="DataFingerprintType">
<xs:annotation>
<xs:documentation>
Allows for assigning a hash value (digital fingerprint) to the data or data file. Set the attribute flag to "data" when the hash value provides a digital fingerprint to the data contained in the file regardless of the storage format (ASCII, SAS, binary, etc.). One approach to compute a data fingerprint is the Universal Numerical Fingerprint (UNF). Set the attribute flag to "dataFile" if the digital fingerprint is only for the data file in its current storage format.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element ref="DigitalFingerprintValue">
<xs:annotation>
<xs:documentation>
Contains the value of the specified digital fingerprint.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="AlgorithmSpecification" type="xs:string">
<xs:annotation>
<xs:documentation>
Specifies the type of the fingerprint (what algorithm or scheme).
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="AlgorithmVersion" type="xs:string">
<xs:annotation>
<xs:documentation>Contains the version of the algorithm.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:attribute name="type" type="DataFingerprintObjectType" use="required">
<xs:annotation>
<xs:documentation>
Brief identification of the type of data fingerprint used. The data fingerprint may be for the data file (storage format specific) or data (format neutral).
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:simpleType name="DataFingerprintObjectType">
<xs:annotation>
<xs:documentation>
Declares if the DataFingerprint is for a data file or for the data content.
</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="data">
<xs:annotation>
<xs:documentation>
The data fingerprint applies to the data content(format neutral).
</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="dataFile">
<xs:annotation>
<xs:documentation>
The data fingerprint applies to a specific file format of the data.
</xs:documentation>
</xs:annotation>
</xs:enumeration>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="GrossFileStructureType">
<xs:annotation>
<xs:documentation>
Includes information about the file structure, as well as other characteristics that are specific to the physical instance. Information includes place of production, processing checks to validate the content, processing status, the software used to create the data file, and check sums for the number of cases and overall record count.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="r:IdentifiableType">
<xs:sequence>
<xs:element minOccurs="0" name="PlaceOfProduction" type="xs:string">
<xs:annotation>
<xs:documentation>
Indicates the place where the physical instance was produced expressed as a simple string.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="ProcessingCheck">
<xs:annotation>
<xs:documentation>
Documents processing checks and other operations performed on the data file.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="ProcessingStatus" type="r:CodeValueType">
<xs:annotation>
<xs:documentation>
Processing status of the data file. Supports the use of an external controlled vocabulary.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" ref="CreationSoftware">
<xs:annotation>
<xs:documentation>
Indicates the software that was used to create the data file.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="CaseQuantity" type="xs:integer">
<xs:annotation>
<xs:documentation>
Number of cases or observations in the data file. Caution in using optional checksums is recommended. Conflict between checksums and the items being counted can cause problems with warning flags during processing. If using checksum to capture information for internal processing purposes, the use of automatically generated check sums is strongly urged.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="OverallRecordCount" type="xs:integer">
<xs:annotation>
<xs:documentation>
Overall record count in the data file. Caution in using optional checksums is recommended. Conflict between checksums and the items being counted can cause problems with warning flags during processing. If using checksum to capture information for internal processing purposes, the use of automatically generated check sums is strongly urged.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="DataFileIdentificationType">
<xs:annotation>
<xs:documentation>
Identifies the data file documented in the physical instance and provides information about its location.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element minOccurs="0" ref="r:Location">
<xs:annotation>
<xs:documentation>
Documents the location of the data file as a description. Supports the multi-language content.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element ref="DataFileURI">
<xs:annotation>
<xs:documentation>
A URN or URL for the data file with a flag to indicate if it is a public copy.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:attribute name="isMaster" type="xs:boolean" use="optional">
<xs:annotation>
<xs:documentation>
Set to "true" when this file is the master file (in the case that there are multiple, i.e. backup, copies).
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:element name="DataFileURI" type="URIType">
<xs:annotation>
<xs:documentation>
A URN or URL for the data file with a flag to indicate if it is a public copy.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="URIType">
<xs:annotation>
<xs:documentation>
A URN or URL for a file with a flag to indicate if it is a public copy.
</xs:documentation>
</xs:annotation>
<xs:simpleContent>
<xs:extension base="xs:anyURI">
<xs:attribute default="true" name="isPublic" type="xs:boolean">
<xs:annotation>
<xs:documentation>
Set to "true" (default value) if this file is publicly available. This does not imply that there are not restrictions to access. Set to "false" if this is not publicly available, such as a backup copy, an internal processing data file, etc.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:complexType name="StatisticalSummaryType">
<xs:annotation>
<xs:documentation>
Provides a statistical summary of the data in the related file as a set of variable level and category level statistics. May refer to a set of statistics provided in another physical instance (for example if the same data is held in multiple storage formats) or if the summary statistics are held as a separate data set.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="StatisticalDataLocation">
<xs:annotation>
<xs:documentation>
Reference to a PhysicalInstance that describes a data file containing the summary and/or category statistics OR contains the statistics in-line as in the case of the same data stored as an ASCII file and as an ORACLE file where the summary and category statistics are listed only in one of the physical instance files.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:choice maxOccurs="unbounded" minOccurs="0">
<xs:element ref="VariableStatistics">
<xs:annotation>
<xs:documentation>
One or more statistical measures that describe the responses to a particular variable. Include both variable and category level statistics.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element ref="VariableStatisticsReference">
<xs:annotation>
<xs:documentation>Inclusion of a VariableStatistics by reference.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="StatisticalDataLocationType">
<xs:annotation>
<xs:documentation>
References a PhysicalInstance module that describes a data file containing the summary and/or category statistics OR contains the statistics in-line. For example, when the same data are stored as an ASCII file and as an ORACLE file, the summary and category statistics would only be listed in one of the physical instance files, and referenced in the other(s).
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element ref="r:PhysicalInstanceReference">
<xs:annotation>
<xs:documentation>
References a physical instance containing the statistics inline or that identifies the data file which contains the statistics.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
<xs:attribute name="isInline" type="xs:boolean" use="required">
<xs:annotation>
<xs:documentation>
Set to "true" if the summary/category statistics are found inline in the referenced physical instance. Set to "false" if they are in the data file associated with the physical instance.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:complexType>
<xs:complexType name="VariableStatisticsType">
<xs:annotation>
<xs:documentation>
Contains summary and category level statistics for the referenced variable. Includes information on the total number of responses, the weights in calculating the statistics, variable level summary statistics, and category statistics. The category statistics may be provided as unfiltered values or filtered through a single variable. For example the category statistics for Sex filtered by the variable Country for a multi-national data file. Note that if no weighting factor is identified, all of the statistics provided are unweighted.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="r:VersionableType">
<xs:sequence>
<xs:element ref="r:VariableReference">
<xs:annotation>
<xs:documentation>
Reference to the variable to which the statistics apply.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="TotalResponses" type="xs:integer">
<xs:annotation>
<xs:documentation>
The total number of responses to this variable. This element is especially useful if the number of responses does not match added case counts. It may also be used to sum the frequencies for variable categories.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:choice minOccurs="0">
<xs:element ref="StandardWeightReference">
<xs:annotation>
<xs:documentation>
Reference to the StandardWeight value provided in Weighting.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element ref="r:WeightVariableReference">
<xs:annotation>
<xs:documentation>
Reference to a variable to use for weight in calculating the statistic.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:choice>
<xs:element minOccurs="0" ref="MissingValuesReference">
<xs:annotation>
<xs:documentation>
Indicates the missing values that were excluded from the statistic by referencing the ManagedMissingValuesRepresentation used by the Variable.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="SummaryStatistic">
<xs:annotation>
<xs:documentation>A summary statistic for the referenced variable.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="UnfilteredCategoryStatistics">
<xs:annotation>
<xs:documentation>
The unfiltered values of any number of statistics by category value representing the full response distribution of the variable.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="FilteredCategoryStatistics">
<xs:annotation>
<xs:documentation>
Includes category-level statistic for the referenced variable using another variable to filter the categories through. For example, the Eurobarometer may filter its category statistics by country as represented in a variable "CountryCode".
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="UnfilteredCategoryStatisticsType">
<xs:annotation>
<xs:documentation>
The unfiltered values of any number of statistics by category value representing the full response distribution of the variable.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="VariableCategory">
<xs:annotation>
<xs:documentation>
A structure that is repeated for each category value for which one or more statistics are recorded. Each VariableCategory has one category value and any number of associated statistics.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="VariableCategoryType">
<xs:annotation>
<xs:documentation>
A category value for which one or more statistics are recorded. Each VariableCategory has one category value and any number of associated statistics.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element ref="CategoryValue">
<xs:annotation>
<xs:documentation>The value of the category.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" ref="CategoryStatistic">
<xs:annotation>
<xs:documentation>
The value of a statistic associated with the category value indicated in the sibling CategoryValue element.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:element name="CategoryValue" type="CategoryValueType">
<xs:annotation>
<xs:documentation>
References a specific Code within the variable if using a CodeRepresentation. May alternately provide the Value of the Category.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="FilterCategoryValueType" type="CategoryValueType">
<xs:annotation>
<xs:documentation>
Provides the specific value of the variable being used as a filter. References a specific Code within the variable if using a CodeRepresentation. May alternately provide the Value of the Category.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="CategoryValueType">
<xs:annotation>
<xs:documentation>
A category value for which one or more statistics are recorded. Each VariableCategory has one category value and any number of associated statistics.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:choice>
<xs:element ref="r:CodeReference">
<xs:annotation>
<xs:documentation>
A reference to the coded value of the category as used by a CodeRepresentation.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element ref="r:Value">
<xs:annotation>
<xs:documentation>The value of the category.</xs:documentation>
</xs:annotation>
</xs:element>
</xs:choice>
</xs:sequence>
</xs:complexType>
<xs:complexType name="CategoryStatisticType">
<xs:annotation>
<xs:documentation>
The value of a statistic associated with the category value.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element ref="TypeOfCategoryStatistic">
<xs:annotation>
<xs:documentation>
Type of category statistic. Supports the use of an external controlled vocabulary. DDI strongly recommends the use of a controlled vocabulary.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element ref="Statistic">
<xs:annotation>
<xs:documentation>
The value of the statistics and whether it is weighted and/or includes missing values.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:element name="TypeOfCategoryStatistic" type="r:CodeValueType">
<xs:annotation>
<xs:documentation>
A classification of the type of category statistic provided. Supports the use of an external controlled vocabulary. DDI strongly recommends the use of a widely shared controlled vocabulary to support interoperability.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="FilteredCategoryStatisticsType">
<xs:annotation>
<xs:documentation>
Category statistics filtered by the value of a second variable. Essentially a cross tabulation of one variable by another. For example variable may be crossed with country as is done in the Eurobarometer when reporting category statistics. For example, the Eurobarometer may filter its category statistics by country as represented in a variable "CountryCode".
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element minOccurs="0" ref="FilterVariableReference">
<xs:annotation>
<xs:documentation>
Reference to the variable used to filter the category level statistics.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="FilterVariableCategory">
<xs:annotation>
<xs:documentation>
Provides filtered category statistics for the specified filter variable category.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="FilterVariableCategoryType">
<xs:annotation>
<xs:documentation>
Category statistics for the variable when the filter variable contains the specified value.
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="FilterCategoryValue">
<xs:annotation>
<xs:documentation>
Provides the specific value of the variable being used as a filter. References a specific Code within the variable if using a CodeRepresentation. May alternately provide the Value of the Category.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="VariableCategory">
<xs:annotation>
<xs:documentation>
Category statistics for the specified value of the variable (when the filter variable contains the specified value). Repeat for each value of the variable.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="SummaryStatisticType">
<xs:annotation>
<xs:documentation>Describes a summary statistic for a variable.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element ref="TypeOfSummaryStatistic">
<xs:annotation>
<xs:documentation>
Type of summary statistic, such as count, mean, mode, median, etc. Supports the use of an external controlled vocabulary. DDI strongly recommends the use of a controlled vocabulary.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" ref="Statistic">
<xs:annotation>
<xs:documentation>
The value of the statistics and whether it is weighted and/or includes missing values.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="StatisticType">
<xs:annotation>
<xs:documentation>
The value of the statistics and whether it is weighted and/or includes missing values.
</xs:documentation>
</xs:annotation>
<xs:simpleContent>
<xs:extension base="xs:decimal">
<xs:attribute name="isWeighted" type="xs:boolean">
<xs:annotation>
<xs:documentation>
Set to "true" if the statistic is weighted using the weight designated in VariableStatistics.
</xs:documentation>
</xs:annotation>
</xs:attribute>
<xs:attribute name="computationBase" type="ComputationBaseType">
<xs:annotation>
<xs:documentation>
Defines the cases included in determining the statistic. The options are total=all cases, valid and missing (invalid); validOnly=Only valid values, missing (invalid) are not included in the calculation; missingOnly=Only missing (invalid) cases included in the calculation.
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
<xs:element name="TypeOfSummaryStatistic" type="r:CodeValueType">
<xs:annotation>
<xs:documentation>
A classification of the type of summary statistic provided. Supports the use of an external controlled vocabulary. DDI strongly recommends the use of a widely shared controlled vocabulary to support interoperability.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="Statistic" type="StatisticType">
<xs:annotation>
<xs:documentation>
The value of the statistics and whether it is weighted and/or includes missing values.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="StatisticalSummary" type="StatisticalSummaryType">
<xs:annotation>
<xs:documentation>
Provides a statistical summary of the data in the related file as a set of variable level and category level statistics.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="SummaryStatistic" type="SummaryStatisticType">
<xs:annotation>
<xs:documentation>Describes a summary statistic for a variable.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:annotation>
<xs:documentation>
The unfiltered values of any number of statistics by category value representing the full response distribution of the variable.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:annotation>
<xs:documentation>
Category statistics filtered by the value of a second variable.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="CategoryStatistic" type="CategoryStatisticType">
<xs:annotation>
<xs:documentation>
The value of a statistic associated with the category value indicated in the sibling CategoryValue element.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="StandardWeightReference" type="r:ReferenceType">
<xs:annotation>
<xs:documentation>
Reference to an existing StandardWeight using the Reference structure. TypeOfObject should be set to StandardWeight.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="MissingValuesReference" type="r:ReferenceType">
<xs:annotation>
<xs:documentation>
Reference to an existing MissingValuesRepresentation using the Reference structure. TypeOfObject should be set to ManagedMissingValuesRepresentation.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:annotation>
<xs:documentation>
Identifies the data file documented in the physical instance and provides information about its location.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="GrossFileStructure" type="GrossFileStructureType">
<xs:annotation>
<xs:documentation>
Includes information about the file structure, as well as other characteristics that are specific to the physical instance.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="CreationSoftware" type="r:SoftwareType">
<xs:annotation>
<xs:documentation>Describes a specific software package.</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="VariableStatistics" type="VariableStatisticsType">
<xs:annotation>
<xs:documentation>
Contains summary and category level statistics for the referenced variable.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="FilterVariableReference" type="r:ReferenceType">
<xs:annotation>
<xs:documentation>
Reference to an existing Variable using the Reference structure. TypeOfObject should be set to Variable.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="ProcessingCheck" type="r:StructuredStringType">
<xs:annotation>
<xs:documentation>
Processing Check provided using a StructuredString to support multiple language versions of the same content as well as optional formatting of the content.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="DigitalFingerprintValue" type="xs:string">
<xs:annotation>
<xs:documentation>
The DigitalFingerprintValue expressed as an xs:string.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:annotation>
<xs:documentation>
Category statistics for the variable when the filter variable contains the specified value.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="VariableCategory" type="VariableCategoryType">
<xs:annotation>
<xs:documentation>
A category value for which one or more statistics are recorded.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:annotation>
<xs:documentation>
References a PhysicalInstance module that describes a data file containing the summary and/or category statistics OR contains the statistics in-line.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:annotation>
<xs:documentation>
Identifies the default missing value parameter for the this physical instance by referencing a ManagedMissingValuesRepresentation plus flag to identify it as a system missing value. TypeOfObject should be set to ManagedMissingValuesRepresentation.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="VariableStatisticsReference" type="r:ReferenceType">
<xs:annotation>
<xs:documentation>
Inclusion of a VariableStatistics by reference TypeOfObject should be set to VariableStatistics.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:complexType name="DefaultMissingValuesReferenceType">
<xs:annotation>
<xs:documentation>
Identifies the default missing value parameter for the this physical instance by referencing a ManagedMissingValuesRepresentation. Note that this MissingValues declaration overrides the value found in the LogicalRecord if it conflicts. The assumption is that this is a System Missing Value declaration, specific to the storage format of the file. If not, change the value of isSystemMissingValue to "false". TypeOfObject should be set to ManagedMissingValuesRepresentation.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="r:ReferenceType">
<xs:attribute default="true" name="isSystemMissingValue" type="xs:boolean">
<xs:annotation>
<xs:documentation>
The assumption is that this is a System Missing Value declaration, specific to the storage format of the file (default value of "true"). If not, change the value to "false".
</xs:documentation>
</xs:annotation>
</xs:attribute>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:simpleType name="ComputationBaseType">
<xs:annotation>
<xs:documentation>
Defines the cases included in determining the statistic.
</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:enumeration value="total">
<xs:annotation>
<xs:documentation>All cases, both valid and missing (invalid).</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="validOnly">
<xs:annotation>
<xs:documentation>
Only valid values, missing (invalid) are not included in the calculation.
</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="missingOnly">
<xs:annotation>
<xs:documentation>
Only missing (invalid) cases included in the calculation.
</xs:documentation>
</xs:annotation>
</xs:enumeration>
</xs:restriction>
</xs:simpleType>
</xs:schema>

XML schema documentation generated with DocFlex/XML RE 1.9.0 using DocFlex/XML XSDDoc 2.8.0 template set