All Element Summary |
||||||||||
|
Abstract Description An unformatted summary describing the purpose, nature, and scope of the data collection, special characteristics of its contents, major subject areas covered, and what questions the PIs attempted to answer when they conducted the study.
|
||||||||||
|
Location of Data Collection Description Location where the data collection is currently stored.
|
||||||||||
|
Actions to Minimize Losses Description Summary of actions taken to minimize data loss.
|
||||||||||
|
||||||||||
|
||||||||||
|
Alternative Title Description A title by which the work is commonly referred, or an abbreviation of the title.
|
||||||||||
|
Data Appraisal Description Information on data appraisal.
|
||||||||||
|
Analysis Unit Description Provides information regarding whom or what the variable/nCube describes.
|
||||||||||
|
Unit of Analysis Description Basic unit of analysis or observation that the file describes: individuals, families/households, groups, institutions/organizations, administrative units, etc.
|
||||||||||
|
Attribute Description Identifies an attribute within the element(s) identified by the selector or specificElements in which the controlled vocabulary is used.
|
||||||||||
|
Authoring Entity/Primary Investigator Description The person, corporate body, or agency responsible for the works substantive and intellectual content.
|
||||||||||
|
Authorization Statement Description The text of the authorization.
|
||||||||||
|
Authorizing Agency Description Name of the agent or agency that authorized the study.
|
||||||||||
|
Availability Status Description Statement of collection availability.
|
||||||||||
|
Backflow Description Contains a reference to IDs of possible preceding questions.
|
||||||||||
|
Bibliographic Citation Description Complete bibliographic reference containing all of the standard elements of a citation that can be used to cite the work.
|
||||||||||
|
Geographic Bounding Polygon Description This field allows the creation of multiple polygons to describe in a more detailed manner the geographic area covered by the dataset.
|
||||||||||
|
Number of cases / Record Quantity Description Number of cases or observations.
|
||||||||||
|
Category Description A description of a particular response.
|
||||||||||
|
Category Group Description A description of response categories that might be grouped together.
|
||||||||||
|
Category Level Description Used to describe the levels of the category hierarchy.
|
||||||||||
|
Category Level Statistic Description May include frequencies, percentages, or crosstabulation results.
|
||||||||||
|
Category Value Description The explicit response option for a category.
|
||||||||||
|
Bibliographic Citation Description This element encodes the bibliographic information for the work at the level specified
|
||||||||||
|
Citation Requirement Description Text of requirement that a data collection should be cited properly in articles or other publications that are based on analysis of the data.
|
||||||||||
|
Cleaning Operations Description Methods used to "clean" the data collection, e.g., consistency checking, wild code checking, etc.
|
||||||||||
|
Codebook Description Every element in the DDI DTD/Schema has the following attributes
|
||||||||||
|
Code List Agency Name Description Agency maintaining the code list.
|
||||||||||
|
Code List ID Description Identifies the code list that the value is taken from.
|
||||||||||
|
Code List Name Description Identifies the code list that the value is taken from with a human-readable name.
|
||||||||||
|
Code List Scheme URN Description Identifies the code list scheme using a URN.
|
||||||||||
|
Code List URN Description Identifies the code list that the value is taken from with a URN.
|
||||||||||
|
Code List Version ID Description Version of the code list.
|
||||||||||
|
Coding Instructions Description Describe specific coding instructions used in data processing, cleaning, acquisition, or tabulation.
|
||||||||||
|
Coder Instructions Description Any special instructions to those who converted information from one form to another for a particular variable.
|
||||||||||
|
Cohort Description The element cohort is used when the nCube contains a limited number of categories from a particular variable, as opposed to the full range of categories.
|
||||||||||
|
Date of Collection Description Contains the date(s) when the data were collected.
|
||||||||||
|
Collector Training Description Describes the training provided to data collectors including interviewer training, process testing, compliance with standards etc.
|
||||||||||
|
Mode of Data Collection Description The method used to collect the data; instrumentation characteristics.
|
||||||||||
|
Characteristics of Data Collection Situation Description Description of noteworthy aspects of the data collection situation.
|
||||||||||
|
Extent of Collection Description Summarizes the number of physical files that exist in a collection, recording the number of files that contain data and noting whether the collection contains machine-readable documentation and/or other supplementary files and information such as data dictionaries, data definition statements, or data collection instruments.
|
||||||||||
|
Column Specification
|
||||||||||
|
Command Description Provide command code for the coding instruction.
|
||||||||||
|
Completeness of Study Stored Description This item indicates the relationship of the data collected to the amount of data coded and stored in the data collection.
|
||||||||||
|
||||||||||
|
Concept Description The general subject to which the parent element may be seen as pertaining.
|
||||||||||
|
Conditions Description Indicates any additional information that will assist the user in understanding the access and use conditions of the data collection.
|
||||||||||
|
Confidentiality Declaration Description This element is used to determine if signing of a confidentiality declaration is needed to access a resource.
|
||||||||||
|
Control Operations Description Methods to facilitate data control performed by the primary investigator or by the data archive.
|
||||||||||
|
Contact Persons Description Names and addresses of individuals responsible for the work.
|
||||||||||
|
Controlled Vocabulary Used Description Provides information on the use of a controlled vocabulary by the DDI instance.
|
||||||||||
|
Copyright Description Copyright statement for the work at the appropriate level.
|
||||||||||
|
Cube Coordinate Description This is an empty element containing only the attributes listed below.
|
||||||||||
|
Custodian Description Custodian identifies the agency or individual who is responsible for creating or maintaining the sample frame.
|
||||||||||
|
Data Access Description This section describes access conditions and terms of use for the data collection.
|
||||||||||
|
Other Forms of Data Appraisal Description Other issues pertaining to data appraisal.
|
||||||||||
|
Extent of Processing Checks Description Indicate here, at the file level, the types of checks and operations performed on the data file.
|
||||||||||
|
Data Collection Methodology Description Information about the methodology employed in a data collection.
|
||||||||||
|
Data Collector Description The entity (individual, agency, or institution) responsible for administering the questionnaire or interview or compiling the data.
|
||||||||||
|
Variable Description Description Description of variables, variable groups, nCubes, and nCube groups.
|
||||||||||
|
Data Fingerprint Description Allows for assigning a hash value (digital fingerprint) to the data or data file.
|
||||||||||
|
Data Item Description Identifies a physical storage location for an individual data entry, serving as a link between the physical location and the logical content description of each data item.
|
||||||||||
|
Kind of Data Description The type of data included in the file: survey data, census/enumeration data, aggregate data, clinical data, event/transaction data, program source code, machine-readable text, administrative records data, experimental data, psychological test, textual data, coded textual, coded documents, time budget diaries, observation data/ratings, process-produced data, etc.
|
||||||||||
|
Missing Data Description This element can be used to give general information about missing data, e.g., that missing data have been standardized across the collection, missing data are present because of merging, etc.
|
||||||||||
|
Data Processing Description Describes various data processing procedures not captured elsewhere in the documentation, such as topcoding, recoding, suppression, tabulation, etc.
|
||||||||||
|
Data Sources Description Used to list the book(s), article(s), serial(s), and/or machine-readable data file(s)--if any--that served as the source(s) of the data collection.
|
||||||||||
|
Definition Description Rationale for why the group was constituted in this way.
|
||||||||||
|
Date of Deposit Description The date that the work was deposited with the archive that originally received it.
|
||||||||||
|
Depositor Description The name of the person (or institution) who provided this work to the archive storing it.
|
||||||||||
|
Deposit Requirement Description Information regarding user responsibility for informing archives of their use of data through providing citations to the published work or providing copies of the manuscripts.
|
||||||||||
|
Derivation Description Used only in the case of a derived variable, this element provides both a description of how the derivation was performed and the command used to generate the derived variable, as well as a specification of the other variables in the study used to generate the derivation.
|
||||||||||
|
||||||||||
|
Development Activity Description Information on the development activity including a "description" of the activity, name of each "participant", each "resource" used, and each "outcome" of the activity.
|
||||||||||
|
Major Deviations from the Sample Design Description Information indicating correspondence as well as discrepancies between the sampled units (obtained) and available statistics for the population (age, sex-ratio, marital status, etc.) as a whole.
|
||||||||||
|
||||||||||
|
File Dimensions Description Dimensions of the overall file.
|
||||||||||
|
Disclaimer Description Information regarding responsibility for uses of the data collection.
|
||||||||||
|
Date of Distribution Description Date that the work was made available for distribution/presentation.
|
||||||||||
|
Distributor Description The organization designated by the author or producer to generate copies of the particular work including any necessary editions or revisions.
|
||||||||||
|
Distributor Statement Description Distribution statement for the work at the appropriate level: marked-up document; marked-up document source; study; study description, other material; other material for study.
|
||||||||||
|
Division Description Formatting element: marks a subdivision in a text.
|
||||||||||
|
Dimension Description This element defines a variable as a dimension of the nCube, and should be repeated to describe each of the cube's dimensions.
|
||||||||||
|
Document Description Description The Document Description consists of bibliographic information describing the DDI-compliant document itself as a whole.
|
||||||||||
|
Documentation Source Description Citation for the source document.
|
||||||||||
|
Documentation Status Description Use this field to indicate if the documentation is being presented/distributed before it has been finalized.
|
||||||||||
|
Derivation Command Description The actual command used to generate the derived variable.
|
||||||||||
|
Derivation Description Description A textual description of the way in which this variable was derived.
|
||||||||||
|
East Bounding Longitude Description The easternmost coordinate delimiting the geographic extent of the dataset.
|
||||||||||
|
Embargo Description Provides information on variables/nCubes which are not currently available because of policies established by the principal investigators and/or data producers.
|
||||||||||
|
Emphasis Description Formatting element: marks words or phrases that are emphasized for rhetorical effect.
|
||||||||||
|
Table Entry
|
||||||||||
|
Estimates of Sampling Error Description Measure of how precisely one can estimate a population value from a given sample.
|
||||||||||
|
Evaluation Process Description Describes the evaluation process followed.
|
||||||||||
|
Evaluator Type Description The evaluator element identifies persons or organizations involved in the evaluation process.
|
||||||||||
|
Post Evaluation Procedures Description Use this section to describe evaluation procedures not address in data evaluation processes.
|
||||||||||
|
External Link Description This element permits encoders to provide links from any arbitrary element containing ExtLink as a subelement to electronic resources outside the codebook.
|
||||||||||
|
File Citation Description The complex element fileCitation provides for a full bibliographic citation option for each data file described in fileDscr.
|
||||||||||
|
File Command Description The element allows for the description of the file command by capturing a textual description of the command including the capture of pseudo code in "drvdesc" as well as the specific command using "drvcmd".
|
||||||||||
|
Contents of Files Description Abstract or description of the file.
|
||||||||||
|
File Derivation Description The element allows for the description of the file commands used to creation the file derivation.
|
||||||||||
|
File Derivation Variables Description Empty element consisting only of its attributes.
|
||||||||||
|
Data Files Description Description Information about the data file(s) that comprises a collection.
|
||||||||||
|
File Name Description Contains a short title that will be used to distinguish a particular file/part from other files/parts in the data collection.
|
||||||||||
|
Place of File Production Description Indicates where the file was produced.
|
||||||||||
|
Number of Files Description Total number of physical files associated with a collection.
|
||||||||||
|
File Structure Description Type of file structure.
|
||||||||||
|
File-by-File Description Description Provides descriptive information about the data file.
|
||||||||||
|
Type of File Description Types of data files include raw data (ASCII, EBCDIC, etc.) and software-dependent files such as SAS datasets, SPSS export files, etc.
|
||||||||||
|
Data Format Description Physical format of the data file: Logical record length format, card-image format (i.e., data with multiple records per case), delimited format, free format, etc.
|
||||||||||
|
Forward Progression Description Contains a reference to IDs of possible following questions.
|
||||||||||
|
Frame Unit Description Provides information about the sampling frame unit.
|
||||||||||
|
Frequency of Data Collection Description For data collected at more than one point in time, the frequency with which the data were collected.
|
||||||||||
|
Funding Agency/Sponsor Description The source(s) of funds for production of the work including abbreviation and affiliation.
|
||||||||||
|
General Data Format Description Expresses the variety of data formats covered i.e.
|
||||||||||
|
Geographic Bounding Box Description The fundamental geometric description for any dataset that models geography.
|
||||||||||
|
Geographic Coverage Description Information on the geographic coverage of the data.
|
||||||||||
|
Geographic Unit Description Lowest level of geographic aggregation covered by the data.
|
||||||||||
|
Geographic Map Description Empty element consisting only of its attributes.
|
||||||||||
|
Grant Number Description The grant/contract number of the project that sponsored the effort.
|
||||||||||
|
G-Ring Latitude Description Latitude (y coordinate) of a point.
|
||||||||||
|
G-Ring Longitude Description Longitude (x coordinate) of a point.
|
||||||||||
|
Guide to Codebook Description List of terms and definitions used in the documentation.
|
||||||||||
|
Head Description Formatting element: marks off a heading to a division, list, etc.
|
||||||||||
|
Highlight Description Formatting element: marks a word or phrase as graphically distinct from the surrounding text, while making no claim for the reasons.
|
||||||||||
|
Holdings Information Description Information concerning either the physical or electronic holdings of the cited work.
|
||||||||||
|
Identification Number Description Unique string or number (producer's or archive's number).
|
||||||||||
|
Imputation Description According to the Statistical Terminology glossary maintained by the National Science Foundation, this is "the process by which one estimates missing values for items that a survey respondent failed to provide," and if applicable in this context, it refers to the type of procedure used.
|
||||||||||
|
Instrument Development Description Describe any development work on the data collection instrument.
|
||||||||||
|
Range of Invalid Data Values Description Values for a particular variable that represent missing data, not applicable responses, etc.
|
||||||||||
|
Value Item Description The counterpart to Range; used to encode individual values when the values cannot be expressed as a min/max range or when specification of the values is desired.
|
||||||||||
|
Item Description Formatting element: marks entries (items) in a list.
|
||||||||||
|
Interviewer Instructions Description Specific instructions to the individual conducting an interview.
|
||||||||||
|
Range Key Description This element permits a listing of the category values and labels.
|
||||||||||
|
Keywords Description Words or phrases that describe salient aspects of a data collection's content.
|
||||||||||
|
Label Description Formatting element: contains the label associated with an item in a list; in glossaries, marks the term being defined.
|
||||||||||
|
Label Description A short description of the parent element.
|
||||||||||
|
Language Description A brief textual identification of the language of the cited object.
|
||||||||||
|
License Description A legal document giving official permission to something with the resource.
|
||||||||||
|
Link Description This element permits encoders to provide links from any arbitrary element containing Link as a subelement to other elements in the codebook.
|
||||||||||
|
List Description Formatting element: contains any sequence of items (entries) organized as a list.
|
||||||||||
|
Location Description Empty element consisting only of its attributes.
|
||||||||||
|
Location Map Description This element maps individual dataItems to one or more physical storage locations.
|
||||||||||
|
Logical Record Length Description Logical record length, i.e., number of characters of data in the record.
|
||||||||||
|
Measure Description Empty element consisting only of its attributes.
|
||||||||||
|
Metadata Access Description This section describes access conditions and terms of use for the metadata.
|
||||||||||
|
Methodology and Processing Description This section describes the methodology and processing involved in a data collection.
|
||||||||||
|
Mathematical Identifier Description Token element containing the smallest unit in the mrow that carries meaning expressed by the attribute varRef.
|
||||||||||
|
Mathematical Row Description This element is a wrapper containing the presentation expression mi.
|
||||||||||
|
Country Description Indicates the country or countries covered in the file.
|
||||||||||
|
nCube Description Describes the logical structure of an n-dimensional array, in which each coordinate intersects with every other dimension at a single point.
|
||||||||||
|
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.
|
||||||||||
|
North Bounding Latitude Description The northernmost coordinate delimiting the geographic extent of the dataset.
|
||||||||||
|
Notes and comments Description For clarifying information/annotation regarding the parent element.
|
||||||||||
|
Archive Where Study Originally Stored Description Archive from which the data collection was obtained; the originating archive.
|
||||||||||
|
Other Study-Related Materials Description This section allows for the inclusion of other materials that are related to the study as identified and labeled by the DTD/Schema users (encoders).
|
||||||||||
|
||||||||||
|
Other Identifications /Acknowledgments Description Statements of responsibility not recorded in the title and statement of responsibility areas (collaborators).
|
||||||||||
|
Other References Notes Description Indicates other pertinent references.
|
||||||||||
|
Other Study Description Materials Description Other materials relating to the study description.
|
||||||||||
|
||||||||||
|
Evaluation Outcomes Description Describe the outcomes of the evaluation.
|
||||||||||
|
Paragraph Description Marks a paragraph.
|
||||||||||
|
Participant Description Name of "participant" in the activity being described in the parent element.
|
||||||||||
|
Parallel Title Description Title translated into another language.
|
||||||||||
|
Physical Location Description Empty element consisting only of its attributes.
|
||||||||||
|
Point Description 0-dimensional geometric primitive, representing a position, but not having extent.
|
||||||||||
|
Polygon Description The minimum polygon that covers a geographical area, and is delimited by at least 4 points (3 sides), in which the last point coincides with the first point.
|
||||||||||
|
PostQuestion Text Description Text describing what occurs after the literal question has been asked.
|
||||||||||
|
PreQuestion Text Description Text describing a set of conditions under which a question might be asked.
|
||||||||||
|
Processing Status Description Processing status of the file.
|
||||||||||
|
Date of Production Description Date when the marked-up document/marked-up document source/data collection/other material(s) were produced (not distributed or archived).
|
||||||||||
|
Place of Production Description Address of the archive or organization that produced the work.
|
||||||||||
|
Production Statement Description Part of citation including language, producer, copyright, license, prodDate, prodPlac, software, fundAg, and grantNo.
|
||||||||||
|
Producer Description The producer is the person or organization with the financial or administrative responsibility for the physical processes whereby the document was brought into existence.
|
||||||||||
|
Purpose Description Explains the purpose for which a particular nCube was created.
|
||||||||||
|
Question Description The question element may have mixed content.
|
||||||||||
|
Literal Question Description Text of the actual, literal question asked.
|
||||||||||
|
Quality Statement Description This structure consists of two parts, "standardsCompliance" and "otherQualityStatements".
|
||||||||||
|
Value Range Description Empty element consisting only of its attributes, containing the actual range of values.
|
||||||||||
|
Dimensions (of record) Description Information about the physical characteristics of the record including the number of variables (varQnty), number of cases (caseQnty), and record length (logRecL).
|
||||||||||
|
Record or Record Group Description Used to describe record groupings if the file is hierarchical or relational.
|
||||||||||
|
Overall Number of Records Description Overall record count in file.
|
||||||||||
|
Records per Case Description Records per case in the file.
|
||||||||||
|
Reference Period Description Indicates the period of time in which the sampling frame was actually used for the study in question.
|
||||||||||
|
Related Materials Description Describes materials related to the study description, such as appendices, additional information on sampling found in other documents, etc.
|
||||||||||
|
Related Publications Description Bibliographic and access information about articles and reports based on the data in this collection.
|
||||||||||
|
Related Studies Description Information on the relationship of the current data collection to others (e.g., predecessors, successors, other waves or rounds) or to other editions of the same file.
|
||||||||||
|
Type of Research Instrument Description The type of data collection instrument used.
|
||||||||||
|
Resource Description Resource provides the means of describing an external data source including a "typeOfDataSrc" which supports othe use of an external controllec vocabulary.
|
||||||||||
|
Response Rate Description The percentage of sample members who provided information.
|
||||||||||
|
Response Unit Description Provides information regarding who is intended to provide the information contained within the variable/nCube, e.g., respondent, proxy, interviewer.
|
||||||||||
|
Restrictions Description Any restrictions on access to or use of the collection such as privacy certification or distribution restrictions should be indicated here.
|
||||||||||
|
Table Row
|
||||||||||
|
Responsibility Statement Description Part of citation covering author (AuthEnty) and collaborators (othID).
|
||||||||||
|
Sample Frame Description Sample frame describes the sampling frame used for identifying the population from which the sample was taken.
|
||||||||||
|
Sample Frame Name Description Name of the sample frame.
|
||||||||||
|
Sample Size Description This element provides the targeted sample size in integer format.
|
||||||||||
|
Sample Size Formula Description This element includes the formula that was used to determine the sample size.
|
||||||||||
|
Sampling Procedure Description The type of sample and sample design used to select the survey respondents to represent the population.
|
||||||||||
|
Security Description Provides information regarding levels of access, e.g., public, subscriber, need to know.
|
||||||||||
|
Selector Description Identifies a collection of elements in which a controlled vocabulary is used.
|
||||||||||
|
Series Information Description Contains a history of the series and a summary of those features that apply to the series as a whole.
|
||||||||||
|
Series Name Description The name of the series to which the work belongs.
|
||||||||||
|
Series Statement Description Series statement for the work at the appropriate level: marked-up document; marked-up document source; study; study description, other material; other material for study.
|
||||||||||
|
Data Set Availability Description Information on availability and storage of the collection.
|
||||||||||
|
Software used in Production Description Software used to produce the work.
|
||||||||||
|
Source Citation Description This complex element allows the inclusion of a standard citation for the sources used in collecting and creating the dataset.
|
||||||||||
|
Sources Statement Description Description of sources used for the data collection.
|
||||||||||
|
South Bounding Latitude Description The southernmost coordinate delimiting the geographic extent of the dataset.
|
||||||||||
|
Specific Elements Description Identifies a collection of specific elements via their identifiers in the refs attribute, which allows for a tokenized list of identifier values which must correspond to identifiers which exist in the instance.
|
||||||||||
|
Special Permissions Description This element is used to determine if any special permissions are required to access a resource.
|
||||||||||
|
Characteristics of Source Noted Description Assessment of characteristics and quality of source material.
|
||||||||||
|
Documentation and Access to Sources Description Level of documentation of the original sources.
|
||||||||||
|
Origins of Sources Description For historical materials, information about the origin(s) of the sources and the rules followed in establishing the sources should be specified.
|
||||||||||
|
Standard Description Describes a standard with which the study complies.
|
||||||||||
|
Standard Name Description Contains the name of the standard with which the study complies.
|
||||||||||
|
Standards Compliance Description This section lists all specific standards complied with during the execution of this study.
|
||||||||||
|
Standard Categories Description Standard category codes used in the variable, like industry codes, employment codes, or social class codes.
|
||||||||||
|
Class of the Study Description Generally used to give the data archive's class or study status number, which indicates the processing status of the study.
|
||||||||||
|
Study Description Description The Study Description consists of information about the data collection, study, or compilation that the DDI-compliant documentation file describes.
|
||||||||||
|
Study Scope Description This section contains information about the data collection's scope across several dimensions, including substantive content, geography, and time.
|
||||||||||
|
Study Authorization Description Provides structured information on the agency that authorized the study, the date of authorization, and an authorization statement.
|
||||||||||
|
Study Budget Description Describe the budget of the project in as much detail as needed.
|
||||||||||
|
Study Development Description Describe the process of study development as a series of development activities.
|
||||||||||
|
Subject Information Description Subject information describing the data collection's intellectual content.
|
||||||||||
|
Subtitle Description A secondary title used to amplify or state certain limitations on the main title.
|
||||||||||
|
Summary Data Description Description Information about the collection situation, data format, universe, geographic coverage of the study, and unit of analysis.
|
||||||||||
|
Summary Statistics Description One or more statistical measures that describe the responses to a particular variable and may include one or more standard summaries, e.g., minimum and maximum values, median, mode, etc.
|
||||||||||
|
Table
|
||||||||||
|
Target Sample Size Description Provides both the target size of the sample (this is the number in the original sample, not the number of respondents) as well as the formula used for determining the sample size.
|
||||||||||
|
Table Body
|
||||||||||
|
Table Group
|
||||||||||
|
Table Head
|
||||||||||
|
Time Method Description The time method or time dimension of the data collection.
|
||||||||||
|
Time Period Covered Description The time period to which the data refer.
|
||||||||||
|
Title Description Full authoritative title for the work at the appropriate level: marked-up document; marked-up document source; study; other material(s) related to study description; other material(s) related to study.
|
||||||||||
|
Title Statement Description Title statement covers title (titl), subtitle (subTitl), alternative title (altTitl), parallel title (parTitl), and ID Number (IDNo).
|
||||||||||
|
Topic Classification Description The classification field indicates the broad substantive topic(s) that the data cover.
|
||||||||||
|
Total Responses Description The number of responses to this variable.
|
||||||||||
|
Descriptive Text Description Lengthier description of the parent element.
|
||||||||||
|
Type of Access Description The applied use of the element is found in the parent item.
|
||||||||||
|
Type of Codeing Instruction Description The applied use of the element is found in the parent item.
|
||||||||||
|
Type of Data Source Description The applied use of the element is found in the parent item.
|
||||||||||
|
Type of Development Activity Description The applied use of the element is found in the parent item.
|
||||||||||
|
Type of ExPost Evaluation Description The applied use of the element is found in the parent item.
|
||||||||||
|
Type of Other Material Description The applied use of the element is found in the parent item.
|
||||||||||
|
Type of Set Availability Description The applied use of the element is found in the parent item.
|
||||||||||
|
List of Undocumented Codes Description Values whose meaning is unknown.
|
||||||||||
|
Unit Type Describes the type of sampling frame unit using a conceptualText structure supporting a description and the use of an external controlled Vocabulary.
|
||||||||||
|
Universe Description The group of persons or other elements that are the object of research and to which any analytic results refer.
|
||||||||||
|
Instrument Development Description Description of how and with what frequency the sample frame is updated.
|
||||||||||
|
Usage Description Defines where in the instance the controlled vocabulary which is identified is utilized.
|
||||||||||
|
Use Statement Description Information on terms of use for the data collection.
|
||||||||||
|
Valid Period Description Defines a time period for the validity of the sampling frame.
|
||||||||||
|
Range of Valid Data Values Description Values for a particular variable that represent legitimate responses.
|
||||||||||
|
Variable Description This element describes all of the features of a single variable in a social science data file.
|
||||||||||
|
Variable Format Description The technical format of the variable in question.
|
||||||||||
|
Variable Group Description A group of variables that may share a common subject, arise from the interpretation of a single question, or are linked by some other factor.
|
||||||||||
|
Overall Variable Count Description Number of variables.
|
||||||||||
|
Variable Range Description Reference to the ID of the first and last variable (start and end) of the range of variables used by the derivation.
|
||||||||||
|
Version Responsibility Statement Description The organization or person responsible for the version of the work.
|
||||||||||
|
Version Description Also known as release or edition.
|
||||||||||
|
Version Statement Description Version statement for the work at the appropriate level: marked-up document; marked-up document source; study; study description, other material; other material for study.
|
||||||||||
|
Weighting Description The use of sampling procedures may make it necessary to apply weights to produce accurate statistical results.
|
||||||||||
|
West Bounding Longitude Description The westernmost coordinate delimiting the geographic extent of the dataset.
|
||||||||||
Complex Type Summary |
||||||||||||
|
Abstract Text Type Description This type forms the basis for all textual elements.
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
Base Element Type Description This type forms the basis for all elements.
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
Conceptual Text Type Description This type forms this basis for a textual element which may also provide for a conceptual (see concept) description of the element a longer description (see txt).
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
Date Type Description This type restricts the base abstractTextType to allow for only the union of types defined in dateSimpleType as text content.
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
Form Type Description This type defines the basis for all elements in the FORM content group.
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
Integer Type Description This type restricts the base abstractTextType to only allow for an integer as text content.
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
Phrase Type Description This type restricts the simpleTextType to allow for only child elements from the PHRASE content group.
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
Simple Text Type Description This type forms the basis of most textual elements.
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
String Type Description This type restricts the base abstractTextType to only allow for text (i.e. no child elements).
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
|
||||||||||||
Simple Type Summary |
||||||
|
||||||
|
Date Simple Type Description This simple type is a union of the various XML Schema date formats.
|
||||||
|
||||||
Element Group Summary |
||||||||||
|
||||||||||
|
||||||||||
Attribute Group Summary |
||||||||||
|
||||||||||
|
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2026 DDI Alliance, DDI-Codebook 2.6 publication version, 2026-04-15 This file is part of DDI-Codebook 2.6 XML Schema. Publication Edition DDI-Codebook 2.6 XML Schema is licensed under the terms of the Creative Commons Attribution 4.0 International (CC BY 4.0) License. This is a human-readable summary of (and not a substitute for) the license (https://creativecommons.org/licenses/by/4.0/legalcode) You are free to: Share — copy and redistribute the material in any medium or format Adapt — remix, transform, and build upon the material for any purpose, even commercially. The licensor cannot revoke these freedoms as long as you follow the license terms. Under the following terms: Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use. No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits. Notices: You do not have to comply with the license for elements of the material in the public domain or where your use is permitted by an applicable exception or limitation. No warranties are given. The license may not give you all of the permissions necessary for your intended use. For example, other rights such as publicity, privacy, or moral rights may limit how you use the material. DDI-Codebook 2.6 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. --> <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="ddi:codebook:2_6" xmlns="ddi:codebook:2_6" xmlns:dc="http://purl.org/dc/terms/" xmlns:fn="http://www.w3.org/2005/xpath-functions" xmlns:saxon="http://xml.apache.org/xslt" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:documentation>
</xs:annotation>
This is a w3c Schema "Technical Implementation" of the DDI Conceptual Specification.
</xs:documentation>
This schema is intended for use in producing electronic versions of codebooks for quantitative social science data. Please note that the attribute xml-lang in the a.globals group is an error that was persisted to retain backward compatibility. DO NOT USE THIS ATTRIBUTE. If this attribute has been used, transfer the content to xml:lang. <!-- Base Structures -->
<xs:attribute name="ID" type="xs:ID" use="optional"/>
</xs:attributeGroup>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
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.
</xs:documentation>
<xs:simpleType>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="archive"/>
</xs:restriction>
<xs:enumeration value="producer"/>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
Indicates version date for the element. Use YYYY-MM-DD, YYYY-MM, or YYYY formats.
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
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.
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
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.
</xs:documentation>
<xs:annotation>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Base Element Type</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This type forms the basis for all elements. Every element may contain the attributes defined the GLOBALS attribute group.
</xhtml:div>
<xs:annotation>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Abstract Text Type</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This type forms the basis for all textual elements. Textual elements may contain text or a mix of select elements. This type is abstract and is refined by more specific types which will limit the allowable elements and attributes. Any textual element will be a subset of this type and can be processed as such. The following attributes are available on all text elements: "isTranslated" indicates whether content is a translation (true) or an original (false). "isTranslatable" indicates whether content is translatable (true) or not (false). An example of something that is not translatable would be a MNEMONIC of an object or a number. "translationSourceLanguage" allows you to list the language or language codes in a space delimited array. The language original may or may not be provided in this bundle of language specific strings. "translationDate" provides the date the content was translated. Provision of translation date allows user to verify if translation was available during data collection or other time linked activity.
</xhtml:div>
<xs:complexContent>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:extension>
<xs:any maxOccurs="unbounded" minOccurs="0" namespace="##targetNamespace http://www.w3.org/1999/xhtml"/>
</xs:sequence>
<xs:annotation>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Simple Text Type</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This type forms the basis of most textual elements. Elements using this type may have mixed content (text and child elements). The child elements are from the PHRASE, FORM, and xhtml:BlkNoForm.mix (a specific subset of XHTML) content groups. Note that if elements from the PHRASE and FORM groups must not be used with elements from the xhtml:BlkNoForm.mix group; one can use either elements from xhtml:BlkNoForm.mix or elements from the PHRASE and FORM groups. This type is extended in some cases to include additional attributes.
</xhtml:div>
<xs:complexContent>
<xs:restriction base="abstractTextType">
</xs:complexContent>
<xs:sequence>
</xs:restriction>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:sequence>
<xs:annotation>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Conceptual Text Type</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This type forms this basis for a textual element which may also provide for a conceptual (see concept) description of the element a longer description (see txt). If the concept and/or txt elements are used, then the element should contain no other child elements or text. Note that if elements from the PHRASE and FORM groups must not be used with elements from the xhtml:BlkNoForm.mix group; one can use either elements from xhtml:BlkNoForm.mix or elements from the PHRASE and FORM groups.
</xhtml:div>
<xs:complexContent>
<xs:restriction base="abstractTextType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:restriction>
<xs:complexContent>
</xs:complexType>
<xs:restriction base="abstractTextType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:restriction>
<xs:complexContent>
</xs:complexType>
<xs:restriction base="abstractTextType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:restriction>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="date" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates the date of the content, should follow ISO convention of YYYY-MM-DD.
</xhtml:div>
<xs:annotation>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Phrase Type</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This type restricts the simpleTextType to allow for only child elements from the PHRASE content group. It still allows for mixed content (text and child elements).
</xhtml:div>
<xs:complexContent>
</xs:complexContent>
<xs:annotation>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">String Type</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This type restricts the base abstractTextType to only allow for text (i.e. no child elements).
</xhtml:div>
<xs:simpleContent>
<xs:restriction base="abstractTextType">
</xs:simpleContent>
<xs:simpleType>
</xs:restriction>
<xs:restriction base="xs:string"/>
</xs:simpleType>
<xs:annotation>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Integer Type</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This type restricts the base abstractTextType to only allow for an integer as text content. No child elements are allowed.
</xhtml:div>
<xs:simpleContent>
<xs:restriction base="abstractTextType">
</xs:simpleContent>
<xs:simpleType>
</xs:restriction>
<xs:restriction base="xs:integer"/>
</xs:simpleType>
<xs:annotation>
</xs:simpleType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Date Simple Type</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This simple type is a union of the various XML Schema date formats. Using this type, a date can be expressed as a year (YYYY), a year and month (YYYY-MM), a date (YYYY-MM-DD) or a complete date and time (YYYY-MM-DDThh:mm:ss). All of these formats allow for an optional timezone offset to be specified.
</xhtml:div>
<xs:union memberTypes="xs:dateTime xs:date xs:gYearMonth xs:gYear"/>
<xs:annotation>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Date Type</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This type restricts the base abstractTextType to allow for only the union of types defined in dateSimpleType as text content. No child elements are allowed.
</xhtml:div>
<xs:simpleContent>
</xs:simpleContent>
<!-- PRHASE Elements -->
</xs:group>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">External Link</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This element permits encoders to provide links from any arbitrary element containing ExtLink as a subelement to electronic resources outside the codebook. The use of this element has be deprecated and the use of various othrMat types is recommended. A parent element can frequently use sdatrefs, methrefs, or pubrefs to refer to the appropriate other material type with which can hold the title, description, and URI for the external source.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Link</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This element permits encoders to provide links from any arbitrary element containing Link as a subelement to other elements in the codebook. The use of this element has be deprecated and the use of provided object references such as varRefs, sdatrefs, methrefs, and pubrefs is recommended. Internal references within texts in structured content can be done with xhml options.
</xhtml:div>
<!-- FORM Elements -->
</xs:group>
<xs:annotation>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Form Type</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This type defines the basis for all elements in the FORM content group. This is derived from the abstractTextType. The content may still be mixed (text and child elements), but the child elements are restricted to be those from the PHRASE and FORM content groups, or the itm and label elements. Further, the possible attributes are restricted. This type is abstract, so specific form elements will further refine this type, but all elements in the FORM content group will conform to this structure and may be processed as such.
</xhtml:div>
<xs:complexContent>
<xs:restriction base="abstractTextType">
</xs:complexContent>
<xs:sequence>
</xs:restriction>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:sequence>
<xs:complexContent>
</xs:complexContent>
</xs:complexType>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Division</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Formatting element: marks a subdivision in a text.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:restriction base="formType">
</xs:complexContent>
<xs:sequence>
</xs:restriction>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:sequence>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Emphasis</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Formatting element: marks words or phrases that are emphasized for rhetorical effect.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:restriction base="formType">
</xs:complexContent>
<xs:sequence>
</xs:restriction>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:sequence>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Head</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Formatting element: marks off a heading to a division, list, etc.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:restriction base="formType">
</xs:complexContent>
<xs:sequence>
</xs:restriction>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:sequence>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Highlight</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Formatting element: marks a word or phrase as graphically distinct from the surrounding text, while making no claim for the reasons.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:restriction base="formType">
</xs:complexContent>
<xs:sequence>
</xs:restriction>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:sequence>
<xs:simpleType>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="ordered"/>
</xs:restriction>
<xs:enumeration value="bulleted"/>
<xs:enumeration value="simple"/>
<xs:enumeration value="gloss"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">List</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Formatting element: contains any sequence of items (entries) organized as a list.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:restriction base="formType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:restriction>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Item</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Formatting element: marks entries (items) in a list.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:restriction base="formType">
</xs:complexContent>
<xs:sequence>
</xs:restriction>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:sequence>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Label</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Formatting element: contains the label associated with an item in a list; in glossaries, marks the term being defined.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:restriction base="formType">
</xs:complexContent>
<xs:sequence>
</xs:restriction>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:sequence>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Paragraph</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Marks a paragraph.</xhtml:div>
<!-- Codebook Elements -->
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextAndDateType">
</xs:complexContent>
<xs:attribute name="contentType" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Provides forward-compatibility with DDI Lifecycle by describing where the content fits in that structure, or if is "mixed" in terms of what is contained.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="abstract"/>
</xs:restriction>
<xs:enumeration value="purpose"/>
<xs:enumeration value="mixed"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Abstract</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
An unformatted summary describing the purpose, nature, and scope of the data collection, special characteristics of its contents, major subject areas covered, and what questions the PIs attempted to answer when they conducted the study. A listing of major variables in the study is important here. In cases where a codebook contains more than one abstract (for example, one might be supplied by the data producer and another prepared by the data archive where the data are deposited), the "source" and "date" attributes may be used to distinguish the abstract versions. Maps to Dublin Core Description element. Inclusion of this element in the codebook is recommended. The "date" attribute should follow ISO convention of YYYY-MM-DD. The contentType attribute provides forward-compatibility with DDI Lifecycle by describing where the content fits in that structure, or if is mixed [abstract | purpose | mixed] in terms of what is contained.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<abstract date="1999-01-28" source="ICPSR" contentType="abstract">Data on labor force activity for the week prior to the survey are supplied in this collection. Information is available on the employment status, occupation, and industry of persons 15 years old and over. Demographic variables such as age, sex, race, marital status, veteran status, household relationship, educational background, and Hispanic origin are included. In addition to providing these core data, the May survey also contains a supplement on work schedules for all applicable persons aged 15 years and older who were employed at the time of the survey. This supplement focuses on shift work, flexible hours, and work at home for both main and second jobs.</abstract>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="URI" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">The URI of the access location.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the authoring entity with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the authoring entity.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the authoring entity.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of authoring entity: organization or individual.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Location of Data Collection</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Location where the data collection is currently stored. Use the URI attribute to provide a URN or URL for the storage site or the actual address from which the data may be downloaded. Supports the standard set of agency identifiers.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<accsPlac URI="https://international.ipums.org" affiliation="University of Minnesota" abbr="IPUMSI" agentType="organization">IPUMS International</accsPlac>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Actions to Minimize Losses</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Summary of actions taken to minimize data loss. Includes information on actions such as follow-up visits, supervisory checks, historical matching, estimation, etc. This element contains the sub-element "concept" to support the use of an external controlled vocabulary. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of "concept" now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. The attribute "vocabInstanceCodeTerm" has been added to accommodate the code term as it appears in the controlled vocabulary. See the high level documentation for a complete description of usage. Additional textual description is entered in the mixed text content or using the sub-element "txt".
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<actMin>To minimize the number of unresolved cases and reduce the potential nonresponse bias, four follow-up contacts were made with agencies that had not responded by various stages of the data collection process.</actMin>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Alternative Title</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
A title by which the work is commonly referred, or an abbreviation of the title.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<altTitl>PISA</altTitl>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Data Appraisal</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Information on data appraisal.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<anlyInfo>Data meets FAIR criteria.</anlyInfo>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="unit" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Used to facilitate the development of a controlled vocabulary for this element. DEPRECATED.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Unit of Analysis</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Basic unit of analysis or observation that the file describes: individuals, families/households, groups, institutions/organizations, administrative units, etc. This element has been changed into a conceptualTextType supporting the use of external controlled vocabularies. Use the internal concept element to reference a controlled vocabulary. DDI provides a Controlled Vocabulary for this location: "AnalysisUnit".
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<anlyUnit>individuals</anlyUnit>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<anlyUnit><concept vocabURI="urn:ddi.cv:analysisunit:1.0">Individual</concept></anlyUnit>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Analysis Unit</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Provides information regarding whom or what the variable/nCube describes. DDI provides a Controlled Vocabulary for this location: "AnalysisUnit" PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of "concept" now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. The attribute "vocabInstanceCodeTerm" has been added to accommodate the code term as it appears in the controlled vocabulary. See the high level documentation for a complete description of usage. The full element may be repeated only to support multiple language expressions of the content.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<anlysUnit> <concept vocabInstanceCodeTerm="constituency">constituency level</concept> This variable reports election returns at the constituency level. </anlysUnit> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCube>
<anlysUnit>Household</anlysUnit> </nCube> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="affiliation" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the authoring entity with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the authoring entity.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the authoring entity.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of authoring entity: organization or individual.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Authoring Entity/Primary Investigator</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
The person, corporate body, or agency responsible for the works substantive and intellectual content. Repeat the element for each author, and use "abbr" and/or "affiliation" attribute if available. Invert first and last name and use commas.
</xhtml:p>
<xhtml:p>
Author of data collection (codeBook/stdyDscr/citation/rspStmt/AuthEnty) maps to Dublin Core element "Creator". Inclusion of this element in codebook is recommended.
</xhtml:p>
<xhtml:p>
The "author" in the Document Description should be the individual(s) or organization(s) directly responsible for the intellectual content of the DDI version, as distinct from the person(s) or organization(s) responsible for the intellectual content of the earlier paper or electronic edition from which the DDI edition may have been derived.
</xhtml:p>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<AuthEnty>United States Department of Commerce. Bureau of the Census</AuthEnty>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<AuthEnty abbr="Insee">National Institute of Statistics and Economic Studies</AuthEnty>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<AuthEnty affiliation="European Commission">Rabier, Jacques-Rene</AuthEnty>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<AuthEnty agentIdentifier="0000-0002-4402-9644" typeOfAgentIdentifier="ORCID">Shepherdson, John</AuthEnty>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Availability Status</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Statement of collection availability. An archive may need to indicate that a collection is unavailable because it is embargoed for a period of time, because it has been superseded, because a new edition is imminent, etc. It is anticipated that a controlled vocabulary will be developed for this element. This element contains the sub-element "concept" to support the use of an external controlled vocabulary. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of "concept" now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. The attribute "vocabInstanceCodeTerm" has been added to accommodate the code term as it appears in the controlled vocabulary. See the high level documentation for a complete description of usage. Additional textual description is entered in the mixed text content or using the sub-element "txt".
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<avlStatus>This collection is superseded by CENSUS OF POPULATION, 1880 [UNITED STATES]: PUBLIC USE SAMPLE (ICPSR 6460).</avlStatus>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<avlStatus>
<concept vocab="ICPSR_Access_Restricted" vocabURI="https://www.icpsr.umich.edu/web/pages/ICPSR/access/restricted/" vocabInstanceCodeTerm="1">Secure Download</concept> Upon approval, researchers will receive an encrypted file via e-mail which they may download to the secure location specified in the application. </avlStatus> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="qstn" type="xs:IDREFS" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Specifies the question ID(s), space delimited.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Backflow</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Contains a reference to IDs of possible preceding questions.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<qstn> <backward qstn="Q12 Q13 Q14 Q15">For responses on a similar topic, see questions 12-15.</backward> </qstn> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<qstn> <backward qstn="Q143"/> </qstn> </var> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="format" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Enables specification of the particular citation style used, e.g., APA, MLA, Chicago, etc.
</xhtml:div>
<xs:annotation>
</xs:element>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Bibliographic Citation</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Complete bibliographic reference containing all of the standard elements of a citation that can be used to cite the work.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<biblCit format="MRDF">Rabier, Jacques-Rene, and Ronald Inglehart. EURO-BAROMETER 11: YEAR OF THE CHILD IN EUROPE, APRIL 1979 [Codebook file]. Conducted by Institut Francais D'Opinion Publique (IFOP), Paris, et al. ICPSR ed. Ann Arbor, MI: Inter-university Consortium for Political and Social Research [producer and distributor], 1981.</biblCit>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Geographic Bounding Polygon</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
This field allows the creation of multiple polygons to describe in a more detailed manner the geographic area covered by the dataset. It should only be used to define the outer boundaries of a covered area. For example, in the United States, such polygons can be created to define boundaries for Hawaii, Alaska, and the continental United States, but not interior boundaries for the contiguous states. This field is used to refine a coordinate-based search, not to actually map an area. It is also useful in identifying the boundaries of non-contiguous countries or data collection areas within a larger bounding box. Note that in this case each combined geogCover and boundPoly should appear in a separate sumDscr to clearly associate the name of the geographic area and it's polygon description.
</xhtml:p>
<xhtml:p>
If the boundPoly element is used, then geoBndBox MUST be present, and all points enclosed by the boundPoly MUST be contained within the geoBndBox. Elements westBL, eastBL, southBL, and northBL of the geoBndBox should each be represented in at least one point of the boundPoly description.
</xhtml:p>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<sumDscr>
<geogCover>Nevada State</geogCover> <boundPoly> <polygon> <point> <gringLat>42.002207</gringLat> <gringLon>-120.005729004</gringLon> </point> <point> <gringLat>42.002207</gringLat> <gringLon>-114.039663</gringLon> </point> <point> <gringLat>35.9</gringLat> <gringLon>-114.039663</gringLon> </point> <point> <gringLat>36.080</gringLat> <gringLon>-114.544</gringLon> </point> <point> <gringLat>35.133</gringLat> <gringLon>-114.542</gringLon> </point> <point> <gringLat>35.00208499998</gringLat> <gringLon>-114.63288</gringLon> </point> <point> <gringLat>35.00208499998</gringLat> <gringLon>-114.63323</gringLon> </point> <point> <gringLat>38.999</gringLat> <gringLon>-120.005729004</gringLon> </point> <point> <gringLat>42.002207</gringLat> <gringLon>-120.005729004</gringLon> </point> </polygon> </boundPoly> </sumDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<sumDscr>
<geogCover>Norway</geogCover> <boundPoly> <polygon> <point> <gringLat>80.76416</gringLat> <gringLon>33.637497</gringLon> </point> <point> <gringLat>80.76416</gringLat> <gringLon>10.2</gringLon> </point> <point> <gringLat>62.48395</gringLat> <gringLon>4.789583</gringLon> </point> <point> <gringLat>57.987915</gringLat> <gringLon>4.789583</gringLon> </point> <point> <gringLat>57.987915</gringLat> <gringLon>11.8</gringLon> </point> <point> <gringLat>61.27794</gringLat> <gringLon>13.2336</gringLon> </point> <point> <gringLat>63.19012</gringLat> <gringLon>13.2336</gringLon> </point> <point> <gringLat>67.28615</gringLat> <gringLon>17.24580</gringLon> </point> <point> <gringLat>68.14297</gringLat> <gringLon>21.38362</gringLon> </point> <point> <gringLat>68.14297</gringLat> <gringLon>25.50054</gringLon> </point> <point> <gringLat>69.39685</gringLat> <gringLon>27.38137</gringLon> </point> <point> <gringLat>68.76991</gringLat> <gringLon>28.84424</gringLon> </point> <point> <gringLat>68.76991</gringLat> <gringLon>31.31021</gringLon> </point> <point> <gringLat>71.42</gringLat> <gringLon>31.31021</gringLon> </point> <point> <gringLat>71.42</gringLat> <gringLon>33.637497</gringLon> </point> <point> <gringLat>80.76416</gringLat> <gringLon>33.637497</gringLon> </point> </polygon> </boundPoly> </sumDscr> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Number of cases / Record Quantity</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Number of cases or observations.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<caseQnty>1011</caseQnty>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute default="freq" name="type">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates the type of statistics presented - frequency, percent, or crosstabulation.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="freq"/>
</xs:restriction>
<xs:enumeration value="percent"/>
<xs:enumeration value="crosstab"/>
<xs:enumeration value="other"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Specifies the other type, if "type" is "other". It should take a value from a controlled vocabulary. This option should only be used when applying a controlled vocabulary to this attribute. Use the complex element controlledVocabUsed to identify the controlled vocabulary to which the selected term belongs.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Refers to the external object containing the information.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Methodology and processing references that record the ID values of all elements within the study methodology and processing section of the Study Description that might apply to this element.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Type of statistic: weighted or not weighted.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="wgtd"/>
</xs:restriction>
<xs:enumeration value="not-wgtd"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Reference to the variable(s) containing the weight used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">The value of a standard weight.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
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 this element.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID values of all elements in the Data Access and Metadata Access section that describe access conditions.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Category Level Statistic</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
May include frequencies, percentages, or crosstabulation results. This field can contain one of the following:
</xhtml:p>
<xhtml:p>1. textual information (e.g., PCDATA), or</xhtml:p>
<xhtml:p>
2. non-parseable character data (e.g., the statistics), or
</xhtml:p>
<xhtml:p>
3. some other form of external information (table, image, etc.)
</xhtml:p>
<xhtml:p>
In case 1, the tag can be used to mark up character data; tables can also be included in the actual markup. In cases 2 or 3, the element can be left empty and the "URI" attribute used to refer to the external object containing the information.
</xhtml:p>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<catStat type="freq" wgtd="not-wgtd">256</catStat>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Category Value</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">The explicit response option for a category.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<catgry missing="Y" missType="inap">
<catValu>9</catValu> </catgry> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:attribute name="levelnm" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
IDs of the appropriate geoMap elements, since a category level may be linked to one or more maps of the variable content.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Category Level</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Used to describe the levels of the category hierarchy. Note that we do not indicate nesting levels or roll-up structures here. This is done to be able to support ragged hierarchies. The attribute "levelnm" provides the levelname. A category level may be linked to one or more maps of the variable content using "geoMap". This is done by referencing the IDs of the appropriate geoMap elements in the attribute "geoMap".
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<catLevel ID="Level1" levelnm="Broader sectors"/>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catLevel ID="Level2" levelnm="Narrower sectors"/>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catLevel ID="Level3" levelnm="Occupations" geoMap="GEO_1 GEO_2"/>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates whether this category group contains missing data or not.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="Y"/>
</xs:restriction>
<xs:enumeration value="N"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of missing data, e.g., inap., don't know, no answer, etc.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Allows for the denotation of country-specific category values
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Records the ID values of all elements within the summary data description that apply to this element.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID values of all elements within the Data Access and etadata Access sections description that apply to this element.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Exclusiveness, should be set to "false" if the category can appear in more than one place in the classification hierarchy.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="true"/>
</xs:restriction>
<xs:enumeration value="false"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
References any child categories of this category element. Used to capture nested hierarchies of categories.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Reference to the catLevel ID in which this category exists.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Category</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">A description of a particular response.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<catLevel ID="Level1" levelnm="Broader sectors"/>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catLevel ID="Level2" levelnm="Narrower sectors"/>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catLevel ID="Level3" levelnm="Occupations"/>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catgry ID="C1" catgry="C2" level="Level1">
<catValu>0</catValu> <labl>Management, professional and related occupations</labl> </catgry> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catgry ID="C2" catgry="C3 C4" level="Level2">
<catValu>01</catValu> <labl>Management occupations</labl> </catgry> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catgry ID="C3" level="Level3">
<catValu>011</catValu> <labl>Top executives</labl> </catgry> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catgry ID="C4" level="Level3">
<catValu>012</catValu> <labl>Financial managers</labl> </catgry> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates whether this category group contains missing data or not
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="Y"/>
</xs:restriction>
<xs:enumeration value="N"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Specifies the type of missing data, e.g., inap., don't know, no answer, etc.
</xhtml:div>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates all the subsidiary category groups which nest underneath the current category group. This allows for the encoding of a hierarchical structure of category groups.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Adds a level number</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Specifies a level name to the category group</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Completeness, should be set to "false" if the category group is incomplete (not a complete aggregate of all sub-nodes or children).
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="true"/>
</xs:restriction>
<xs:enumeration value="false"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Exclusiveness, should be set to "false" if the category group can appear in more than one place in the classification hierarchy.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="true"/>
</xs:restriction>
<xs:enumeration value="false"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Category Group</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
A description of response categories that might be grouped together.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Citation Requirement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Text of requirement that a data collection should be cited properly in articles or other publications that are based on analysis of the data.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<citReq>Publications based on ICPSR data collections should acknowledge those sources by means of bibliographic citations. To ensure that such source attributions are captured for social science bibliographic utilities, citations must appear in footnotes or in the reference section of publications.</citReq>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
MAchine Readable Citation URI, link to the MARC record for the citation
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Bibliographic Citation</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
This element encodes the bibliographic information for the work at the level specified:
</xhtml:p>
<xhtml:p>
(1) Document Description, Citation (of Marked-up Document),
</xhtml:p>
<xhtml:p>
(2) Document Description, Citation (of Marked-up Document Source),
</xhtml:p>
<xhtml:p>(3) Study Description, Citation (of Study),</xhtml:p>
<xhtml:p>(4) Study Description, Other Material, and</xhtml:p>
<xhtml:p>(5) Other Material for the study itself.</xhtml:p>
<xhtml:p>
The elements sourceCitation and fileCitation use this structure to provide citations for a source or data file respectively. Bibliographic information includes title information, statement of responsibility, production and distribution information, series and version information, text of a preferred bibliographic citation, and notes (if any).
</xhtml:p>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="agency" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Specifies the agency doing the data cleaning.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Cleaning Operations</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Methods used to "clean" the data collection, e.g., consistency checking, wild code checking, etc.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<cleanOps agency="NHGIS">Checks for undocumented codes were performed, and data were subsequently revised in consultation with the principal investigator.</cleanOps>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Coder Instructions</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Any special instructions to those who converted information from one form to another for a particular variable. This might include the reordering of numeric information into another form or the conversion of textual information into numeric information.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<codInstr>Use the standard classification tables to present responses to the question: What is your occupation? into numeric codes.</codInstr> </var> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:extension>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="docDscr"/>
</xs:sequence>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
This should be used for materials that are primarily descriptions of the content and use of the study, such as appendices, sampling information, weighting details, methodological and technical details, publications based upon the study content, related studies or collection of studies, etc. This section is intended to include or to link to materials used in the production of the study or useful in the analysis of the study.
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Version number of the DDI specification.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Agency name of the creator or maintainer of the codeBook instance as a whole. This is designed to support forward compatibility with DDI-Lifecycle. Recommend the agency name as filed with the DDI Agency ID Registry with optional additional sub-agency extensions.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Records the ID values of all elements in the Data Access and Metadata Access section that describe access conditions for this codebook instance.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Codebook</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
Every element in the DDI DTD/Schema has the following attributes:
</xhtml:p>
<xhtml:p>ID - This uniquely identifies each element.</xhtml:p>
<xhtml:p>
xml-lang - Use of this attribute is deprecated, and it will no longer be supported in the next major version of the DDI specification. For newly created XML documents, please use xml:lang.
</xhtml:p>
<xhtml:p>
xml:lang - This attribute specifies the language used in the contents and attribute values of any element in the XML document. Use of ISO (
</xhtml:p>
<xhtml:a href="http://www.iso.org/">www.iso.org</xhtml:a>
) language codes is recommended.
<xhtml:p>
source - This attribute identifies the source that provided information in the element. If the documentation contains two differing sets of information on Sampling Procedure -- one provided by the data producer and one by the archive where the data is deposited -- this information can be distinguished through the use of the source attribute.
</xhtml:p>
<xhtml:p>
Note also that the DDI contains a linking mechanism permitting arbitrary links between internal elements (See Link) and from internal elements to external sources (See ExtLink). Note that the use of these two elements has be DEPRECATED in version 2.6.
</xhtml:p>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
References the ID of the actual category being used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates the actual value attached to the category that is being used.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Cohort</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The element cohort is used when the nCube contains a limited number of categories from a particular variable, as opposed to the full range of categories.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dmns>
<cohort catRef="CV24_1" value="1"/> </dmns> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextAndDateType">
</xs:complexContent>
<xs:attribute default="single" name="event">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Specify "start", "end", or "single" for each date entered.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="start"/>
</xs:restriction>
<xs:enumeration value="end"/>
<xs:enumeration value="single"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Specifies the relevant cycle, wave, or round of data.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Date of Collection</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Contains the date(s) when the data were collected. Maps to Dublin Core element "Coverage". Inclusion of this element in the codebook is recommended.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<collDate event="single" date="1998-11-10">10 November 1998</collDate>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Mode of Data Collection</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The method used to collect the data; instrumentation characteristics. As of version 2.6 this element is a conceptualText type and supports the use of a controlled vocabulary. To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". DDI provides a Controlled Vocabulary for this location: "ModeOfCollection". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept.XHTML formatting may be used in the txt element for forward-compatibility with DDI Lifecycle.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<collMode>telephone interviews</collMode>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<collMode><concept vocab="ModeOfCollection" vocabURI="http://rdf-vocabulary.ddialliance.org/cv/ModeOfCollection:3.0" vocabInstanceCodeTerm="Interview.FaceToFace">Face-to-Face Interview</concept></collMode>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<collMode>mail questionnaires</collMode>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<collMode>computer-aided telephone interviews (CATI)</collMode>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Characteristics of Data Collection Situation</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Description of noteworthy aspects of the data collection situation. Includes information on factors such as cooperativeness of respondents, duration of interviews, number of call-backs, etc.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<collSitu>There were 1,194 respondents who answered questions in face-to-face interviews lasting approximately 75 minutes each.</collSitu>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Extent of Collection</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Summarizes the number of physical files that exist in a collection, recording the number of files that contain data and noting whether the collection contains machine-readable documentation and/or other supplementary files and information such as data dictionaries, data definition statements, or data collection instruments.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<collSize>1 data file + machine-readable documentation (PDF) + SAS data definition statements</collSize>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:attribute name="colnum" type="xs:string" use="optional"/>
</xs:extension>
<xs:simpleType>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="left"/>
</xs:restriction>
<xs:enumeration value="right"/>
<xs:enumeration value="center"/>
<xs:enumeration value="justify"/>
<xs:enumeration value="char"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Column Specification</xhtml:h1>
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Completeness of Study Stored</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This item indicates the relationship of the data collected to the amount of data coded and stored in the data collection. Information as to why certain items of collected information were not included in the data file stored by the archive should be provided. This supports the use of a controlled vocabulary. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<complete>Because of embargo provisions, data values for some variables have been masked. Users should consult the data definition statements to see which variables are under embargo. A new version of the collection will be released by ICPSR after embargoes are lifted.</complete>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="vocab" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates the name of the controlled vocabulary, if any, used in the element, e.g., LCSH (Library of Congress Subject Headings), MeSH (Medical Subject Headings), etc.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Specifies the location for the full controlled vocabulary.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Specifies the identification URI of the term/code within the controlled vocabulary if available.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Another form of identification (do not use for URI).
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Agency managing the controlled vocabulary.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Version of controlled vocabulary, if needed</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
If the controlled vocabulary term is "other", provide a more specific value.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">The URN of the controlled vocabulary.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Added to accommodate the code term as it appears in the controlled vocabulary.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Concept</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The general subject to which the parent element may be seen as pertaining. This element serves the same purpose as the keywords and topic classification elements, but at the data description level. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<nCubeGrp>
<concept>Income</concept> </nCubeGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCubeGrp>
<concept vocab="LCSH" vocabURI="http://lcweb.loc.gov/catdir/cpso/lcco/lcco.html" source="archive">more experience</concept> </nCubeGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<concept>Income</concept> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<concept vocab="LCSH" vocabURI="http://lcweb.loc.gov/catdir/cpso/lcco/lcco.html" vocabInstanceURI="http://lcweb.loc.gov/catdir/cpso/lcco#SF311-312" vocabInstanceCodeTerm="SF311-312" source="archive">Draft Horses</concept> </var> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Conditions</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Indicates any additional information that will assist the user in understanding the access and use conditions of the data collection.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<conditions>The data are available without restriction. Potential users of these datasets are advised, however, to contact the original principal investigator Dr. J. Smith (Institute for Social Research, The University of Michigan, Box 1248, Ann Arbor, MI 48106), about their intended uses of the data. Dr. Smith would also appreciate receiving copies of reports based on the datasets.</conditions>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute default="yes" name="required">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Aids machine processing of this element, default specification is "yes".
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="yes"/>
</xs:restriction>
<xs:enumeration value="no"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates the number or ID of the form that the user must fill out.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Provides a URN or URL for online access to a confidentiality declaration form.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Confidentiality Declaration</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This element is used to determine if signing of a confidentiality declaration is needed to access a resource.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<confDec formNo="1">To download this dataset, the user must sign a declaration of confidentiality.</confDec>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<confDec URI="http://www.icpsr.umich.edu/HMCA/CTSform/contents.html" required="yes"> To obtain this dataset, the user must complete a Restricted Data Use Agreement.</confDec>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="affiliation" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the authoring entity with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates a URN or URL for the homepage of the contact individual.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates an email address for the contact individual.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the authoring entity.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of authoring entity: organization or individual.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Contact Persons</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Names and addresses of individuals responsible for the work. Individuals listed as contact persons will be used as resource persons regarding problems or questions raised by the user community.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<contact affiliation="University of Wisconsin" email="jsmith@wisc.edu" URI="wisc.edu" agentIdentifier="0000-0003-1294-0000" typeOfAgentIdentifier="orcid">Jane Smith</contact>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="agency" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Reference to the agency that performed the control operation.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Control Operations</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Methods to facilitate data control performed by the primary investigator or by the data archive. Specify any special programs used for such operations.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<ConOps source="archive" agency="ICPSR">Ten percent of data entry forms were reentered to check for accuracy.</ConOps>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Controlled Vocabulary Used</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Provides information on the use of a controlled vocabulary by the DDI instance. The controlled vocabulary is identified by a codelistID, codelistName, codelistAgencyName, codelistVersionID, codelistURN, and codelistSchemeURN. The use of the controlled vocabulary is defined by the usage element.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Code List ID</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Identifies the code list that the value is taken from. If this is a URN or URI place in codeListURN.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<codeListID>TimeMethod</codeListID>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Code List Name</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Identifies the code list that the value is taken from with a human-readable name.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<codeListName>Time Method</codeListName>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Code List Agency Name</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Agency maintaining the code list. This name should be registered in the DDI Agency Registry.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<codeListAgencyName>DDI Alliance</codeListAgencyName>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Code List Version ID</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Version of the code list. (Default value is 1.0)</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<codeListVersionID>1.1</codeListVersionID>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Code List URN</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Identifies the code list that the value is taken from with a URN.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<codeListURN>urn:ddi-cv:TimeMethod:1.1</codeListURN>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Code List Scheme URN</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Identifies the code list scheme using a URN.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<codeListSchemeURN>http://www.ddialliance.org/Specification/DDI-CV/TimeMethod_1.1_Genericode1.0_DDI-CVProfile1.0.xml</codeListSchemeURN>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Usage</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Defines where in the instance the controlled vocabulary which is identified is utilized. A controlled vocabulary may occur either in the content of an element or in an attribute on an element. The usage can either point to a collection of elements using an XPath via the selector element or point to a more specific collection of elements via their identifier using the specificElements element. If the controlled vocabulary occurs in an attribute within the element, the attribute element identifies the specific attribute. When specific elements are specified, an authorized code value may also be provided. If the current value of the element or attribute identified is not in the controlled vocabulary or is not identical to a code value, the authorized code value identifies a valid code value corresponding to the meaning of the content in the element or attribute.
</xhtml:div>
<xs:sequence>
</xs:complexType>
<xs:choice>
</xs:choice>
</xs:sequence>
<xs:restriction base="xs:string">
</xs:simpleType>
<xs:pattern value="((//|/)(([\i-[:]][\c-[:]]*:)?[\i-[:]][\c-[:]]*|\*|[\i-[:]][\c-[:]]*:\*))+"/>
</xs:restriction>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Selector</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Identifies a collection of elements in which a controlled vocabulary is used. This is a simplified XPath which must correspond to the actual instance in which it occurs, which is to say that the fully qualified element names here must correspond to those in the instance. This XPath can only identify elements and does not allow for any predicates. The XPath must either be rooted or deep.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<selector>/codeBook/stdyDscr/method/dataColl/timeMeth</selector>
]]>
<xs:attribute name="refs" type="xs:IDREFS" use="required">
</xs:complexType>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">IDs of the specific elements.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
A valid code value corresponding to the meaning of the content in the element or attribute when the identified element or attribute does not use an actual valid value from the controlled vocabulary.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Specific Elements</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Identifies a collection of specific elements via their identifiers in the refs attribute, which allows for a tokenized list of identifier values which must correspond to identifiers which exist in the instance.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<specificElements refs="ICPSR4328timeMeth" authorizedCodeValue="CrossSection"/>
]]>
<xs:restriction base="xs:string">
</xs:simpleType>
<xs:pattern value="@(([\i-[:]][\c-[:]]*:)?[\i-[:]][\c-[:]]*|\*|[\i-[:]][\c-[:]]*:\*)"/>
</xs:restriction>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Attribute</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Identifies an attribute within the element(s) identified by the selector or specificElements in which the controlled vocabulary is used. The fully qualified name used here must correspond to that in the instance, which is to say that if the attribute is namespace qualified, the prefix used here must match that which is defined in the instance.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<attribute>type</attribute>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Copyright</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Copyright statement for the work at the appropriate level. Copyright for data collection (codeBook/stdyDscr/citation/prodStmt/copyright) maps to Dublin Core Rights. Inclusion of this element is recommended.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<copyright>Copyright(c) ICPSR, 2000</copyright>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:attribute name="coordNo" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Coordinate number.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Coordinate value reference, an ID reference to the variable that carries the coordinate value.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Cube Coordinate</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This is an empty element containing only the attributes listed below. It is used to identify the coordinates of the data item within a logical nCube describing aggregate data. CubeCoord is repeated for each dimension of the nCube. The attributes provide a complete coordinate location of a cell within the nCube.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<CubeCoord coordNo="1" coordVal="3"/>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<CubeCoord coordNo="2" coordVal="7"/>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<CubeCoord coordNo="3" coordVal="2" coordValRef="AGE-3"/>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Data Access</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This section describes access conditions and terms of use for the data collection. In cases where access conditions differ across individual files or variables, multiple access conditions can be specified. In cases where access conditions differ across individual files, variables, or categories multiple access conditions can be specified. The access conditions applying to a study, file, variable group, variable or category can be indicated by an IDREF attribute on the study, file, variable group, nCube group, variable, category, or data item elements called "access". The member element "typeOfAccess" is of the type "concept" and is intended to provide a specific type of access. If a license applies to the data access, use the optional "license" element.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="type" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Used to specify a controlled vocabulary concept. DEPRECATED.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Other Forms of Data Appraisal</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Other issues pertaining to data appraisal. Describe here issues such as response variance, nonresponse rate and testing for bias, interviewer and response bias, confidence levels, question bias, etc. The use of the attribute "type" as a means of specifying a controlled vocabulary concept is DEPRECATED. To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dataAppr>
<concept vocab="IPUMS" vocabInstanceCodeType="ProducerAppraised">Appraised by Producer</concept> These data files were obtained from the United States House of Representatives, who received them from the Census Bureau accompanied by the following caveats: "The numbers contained herein are not official 1990 decennial Census counts. The numbers represent estimates of the population based on a statistical adjustment method applied to the official 1990 Census figures using a sample survey intended to measure overcount or undercount in the Census results. On July 15, 1991, the Secretary of Commerce decided not to adjust the official 1990 decennial Census counts (see 56 Fed. Reg. 33582, July 22, 1991). In reaching his decision, the Secretary determined that there was not sufficient evidence that the adjustment method accurately distributed the population across and within states. The numbers contained in these tapes, which had to be produced prior to the Secretary's decision, are now known to be biased. Moreover, the tapes do not satisfy standards for the publication of Federal statistics, as established in Statistical Policy Directive No. 2, 1978, Office of Federal Statistical Policy and Standards. Accordingly, the Department of Commerce deems that these numbers cannot be used for any purpose that legally requires use of data from the decennial Census and assumes no responsibility for the accuracy of the data for any purpose whatsoever. The Department will provide no assistance in interpretation or use of these numbers." </dataAppr> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Extent of Processing Checks</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Indicate here, at the file level, the types of checks and operations performed on the data file. Use the internal "concept" to make use of a controlled vocabulary The following examples, except for the last, are based on ICPSR's Extent of Processing scheme:
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dataChck>The archive produced a codebook for this collection.</dataChck>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataChck>
<concept vocab="GSBPM" vocabAgency="UNECE" vocabVersionID="5.1" vocabInstanceCodeTerm="5.3">Review & validate</concept> Consistency checks were performed by Data Producer/ Principal Investigator. </dataChck> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataChck>The archive generated SAS and/or SPSS data definition statements for this collection.</dataChck>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataChck>Frequencies were provided by Data Producer/Principal Investigator.</dataChck>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataChck>Frequencies provided by the archive.</dataChck>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataChck>Missing data codes were standardized by Data Producer/ Principal Investigator.</dataChck>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataChck>Missing data codes were standardized by the archive.</dataChck>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataChck>The archive performed recodes and/or calculated derived variables. </dataChck>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataChck>Data were reformatted by the archive.</dataChck>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataChck>Checks for undocumented codes were performed by Data Producer/Principal Investigator.</dataChck>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataChck>Checks for undocumented codes were performed by the archive.</dataChck>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataChck>
<concept vocab="EOSDIS" vocabURI="https://ghrc.nsstc.nasa.gov/uso/proc_level.html" vocabInstanceCodeTerm="2">Level 2</concept> Derived geophysical variables at the same resolution and location as the Level 1 source data. </dataChck> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Data Collection Methodology</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Information about the methodology employed in a data collection.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Sample Frame</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Sample frame describes the sampling frame used for identifying the population from which the sample was taken. For example, a telephone book may be a sample frame for a phone survey. In addition to the name, label and text describing the sample frame, this structure lists who maintains the sample frame, the period for which it is valid, a use statement, the universe covered, the type of unit contained in the frame as well as the number of units available, the reference period of the frame and procedures used to update the frame. Use multiple use statements to provide different uses under different conditions. Repeat elements within the use statement to support multiple languages.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Sample Frame Name</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Name of the sample frame.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<sampleFrameName>City of St. Paul Directory</sampleFrameName>
]]>
<xs:simpleContent>
</xs:complexType>
<xs:extension base="dateType">
</xs:simpleContent>
<xs:attribute name="event">
</xs:extension>
<xs:simpleType>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="start"/>
</xs:restriction>
<xs:enumeration value="end"/>
<xs:enumeration value="single"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Valid Period</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Defines a time period for the validity of the sampling frame. Enter dates in YYYY-MM-DD format.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<sampleFrame>
<validPeriod event="start">2009-07-01</validPeriod> <validPeriod event="end">2011-06-30</validPeriod> </sampleFrame> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Reference Period</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Indicates the period of time in which the sampling frame was actually used for the study in question. Use ISO 8601 date/time formats to enter the relevant date(s).
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<referencePeriod event="single">2009-06-01</referencePeriod>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Boolean, indicates whether the unit is primary or not.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Frame Unit</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Provides information about the sampling frame unit.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<frameUnit isPrimary="true">
<unitType numberOfUnits="150000">Primary listed owners of published phone numbers in the City of St. Paul</unitType> </frameUnit> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="numberOfUnits" type="xs:integer" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Number of units in the sampling frame.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Unit Type</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:div class="description">
</xhtml:div>
Describes the type of sampling frame unit using a conceptualText structure supporting a description and the use of an external controlled Vocabulary. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of "concept" now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<unitType numberOfUnits="150000">
<concept vocab="SampleFrame_UnitType" vocabInstanceCodeTerm="telephoneNumber">Telephone Number</concept> Primary listed owners of published phone numbers in the City of St. Paul </unitType> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Target Sample Size</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Provides both the target size of the sample (this is the number in the original sample, not the number of respondents) as well as the formula used for determining the sample size.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Sample Size</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This element provides the targeted sample size in integer format.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<sampleSize>385</sampleSize>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Sample Size Formula</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This element includes the formula that was used to determine the sample size.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<sampleSizeFormula>n0=Z2pq/e2=(1.96)2(.5)(.5)/(.05)2=385 individuals</sampleSizeFormula>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">General Data Format</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Expresses the variety of data formats covered i.e. Numeric, Text, Audio, Visual, Geospatial, StillImage, Software, 3D, other. Supports the use of an external controlled vocabulary. DDI provides a Controlled Vocabulary for this location: "GeneralDataFormat"
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<generalDataFormat vocab="GeneralDataFormat" vocabURI="urn:ddi:int.ddi.cv:GeneralDataFormat:2.0.3" vocabInstanceURI="http://rdf-vocabulary.ddialliance.org/cv/GeneralDataFormat/2.0.3/c9347b7">Geospatial</generalDataFormat>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="type" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Used to specify a controlled vocabulary concept. DEPRECATED.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Instrument Development</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Describe any development work on the data collection instrument. The use of the attribute "type" as a means of specifying a controlled vocabulary concept is DEPRECATED. To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<instrumentDevelopment>
<concept vocab="123surveys" vocabURI="http://123surveys.com/internal/developmentProtocal" vocabInstanceURI="http://123surveys.com/internal/developmentProtocal#Pretest.SplitPanel">Pretest.SplitPanel</concept> The questionnaire was pre-tested with split-panel tests, as well as an analysis of non-response rates for individual items, and response distributions. </instrumentDevelopment> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Instrument Development</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Description of how and with what frequency the sample frame is updated. This element contains the sub-element "concept" to support the use of an external controlled vocabulary. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of "concept" now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. The attribute "vocabInstanceCodeTerm" has been added to accommodate the code term as it appears in the controlled vocabulary. See the high level documentation for a complete description of usage. Additional textual description is entered in the mixed text content or using the sub-element "txt".
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<updateProcedure>Changes are collected as they occur through registration and loss of phone number from the specified geographic area. Data are compiled for the date June 1st of odd numbered years, and published on July 1st for the following two-year period.</updateProcedure>
]]>
<xs:simpleContent>
</xs:complexType>
<xs:extension base="stringType">
</xs:simpleContent>
<xs:attribute name="affiliation" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the custodian with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the custodian.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Role of the person / agency responsible with creating or maintaining the sample frame.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the custodian.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Type of custodian: organization or individual.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Custodian</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Custodian identifies the agency or individual who is responsible for creating or maintaining the sample frame.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<custodian abbr="DEX">DEX Publications</custodian>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="type" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Used to specify a controlled vocabulary concept. DEPRECATED.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Collector Training</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Describes the training provided to data collectors including interviewer training, process testing, compliance with standards etc. This is repeatable for language and to capture different aspects of the training process. The use of the attribute "type" as a means of specifying a controlled vocabulary concept is DEPRECATED. To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<collectorTraining>
<concept vocab="TrainingObject" vocabURI="http://xyzdatacollection.org/vocabularies/TrainingObject" vocabInstanceURI="http://xyzdatacollection.org/vocabularies/TrainingObject#InterviewerTraining">InterviewerTraining</concept> Describe research project, describe population and sample, suggest methods and language for approaching subjects, explain questions and key terms of survey instrument. </collectorTraining> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="abbr" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the data collector.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the data collector with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Role of person in the data collection process.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the data collector.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of data collector: organization or individual.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Data Collector</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The entity (individual, agency, or institution) responsible for administering the questionnaire or interview or compiling the data. This refers to the entity collecting the data, not to the entity producing the documentation.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dataCollector abbr="SRC" affiliation="University of Michigan" role="questionnaire administration">Survey Research Center</dataCollector>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Records the ID values of all elements in the Data Access and Metadata Access section that describe access conditions for this description of the data.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Variable Description</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Description of variables, variable groups, nCubes, and nCube groups.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Reference to the ID of a discrete variable description.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Points to the appropriate nCube and the element CubeCoord to identify the coordinates of the data item within the nCube.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID values of all elements in the Data Access and Metadata Access section that describe access conditions for this cell.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Data Item</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Identifies a physical storage location for an individual data entry, serving as a link between the physical location and the logical content description of each data item. If the data item is located within an nCube (aggregate data), use the attribute "nCubeRef"
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dataItem varRef="AGE_2" access="restricition_1">
<physLoc recRef="Rec_1" startPos="5" width="4" endPos="8"/> </dataItem> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataItem nCubeRef="AGE_SEX" access="restricition_1">
<CubeCoord coordNo="1" coordVal="3"/> <CubeCoord coordNo="2" coordVal="1"/> <physLoc recRef="Rec_3" startPos="5" width="4" endPos="8"/> </dataItem> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="type" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Kind of Data</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The type of data included in the file: survey data, census/enumeration data, aggregate data, clinical data, event/transaction data, program source code, machine-readable text, administrative records data, experimental data, psychological test, textual data, coded textual, coded documents, time budget diaries, observation data/ratings, process-produced data, etc. This element maps to Dublin Core Type element. The type attribute has been DEPRECATED. For consistent use of conceptualTextType use the included content "concept" and related attributes to provide a reference to a controlled vocabulary.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dataKind>
<concept vocab="KindOfData" vocabURI="urn:ddi:int.ddi.cv:KindOfData:1.0">Survey</concept> survey data </dataKind> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Missing Data</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This element can be used to give general information about missing data, e.g., that missing data have been standardized across the collection, missing data are present because of merging, etc.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dataMsng>Missing data are represented by blanks.</dataMsng>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataMsng>The codes "-1" and "-2" are used to represent missing data.</dataMsng>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Data Sources</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Used to list the book(s), article(s), serial(s), and/or machine-readable data file(s)--if any--that served as the source(s) of the data collection.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dataSrc> "Voting Scores." CONGRESSIONAL QUARTERLY ALMANAC 33 (1977), 487-498.</dataSrc>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataSrc>United States Internal Revenue Service Quarterly Payroll File</dataSrc>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Definition</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Rationale for why the group was constituted in this way.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<varGrp>
<defntn>The following eight variables were only asked in Ghana.</defntn> </varGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCubeGrp>
<defntn>The following four nCubes form a single presentation table.</defntn> </nCubeGrp> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Date of Deposit</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The date that the work was deposited with the archive that originally received it. The focus of this element is on the original archive, differentiating between the designated depository and any locally held copies obtained to support local use.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<depDate date="1999-01-25">January 25, 1999</depDate>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Deposit Requirement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Information regarding user responsibility for informing archives of their use of data through providing citations to the published work or providing copies of the manuscripts.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<deposReq>To provide funding agencies with essential information about use of archival resources and to facilitate the exchange of information about ICPSR participants' research activities, users of ICPSR data are requested to send to ICPSR bibliographic citations for, or copies of, each completed manuscript or thesis abstract. Please indicate in a cover letter which data were used.</deposReq>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="abbr" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the depositor.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the depositor with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the depositor.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Type of depositor: organization or individual.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Depositor</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The name of the person (or institution) who provided this work to the archive storing it.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<depositr abbr="BJS" affiliation="U.S. Department of Justice">Bureau of Justice Statistics</depositr>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Provides the ID values of the other variables in the study used to generate this derived variable.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Derivation</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Used only in the case of a derived variable, this element provides both a description of how the derivation was performed and the command used to generate the derived variable, as well as a specification of the other variables in the study used to generate the derivation. Alternatively the variables may be expressed as a range using the varRange element. Note that use of varRange is implementation dependent. Since the order of variables can change during the execution of a script, it is computationally difficult to identify which variables belong to a variable range. It has been provided to support the automated creation of derivation information. Order should be determined by the physical order expressed in location as opposed to the order expressed in the metadata document. varRange should only be used when the physical order of variables is available and machine-actionable.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<derivation var="V4 V9">
<drvdesc>Taxible Income (V10) expressed as a combination of wage and salary income (V4) plus interest income (V9)</drvdesc> <drvcmd syntax="SPSS">V10=V4+V9</drvcmd> </derivation> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Major Deviations from the Sample Design</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Information indicating correspondence as well as discrepancies between the sampled units (obtained) and available statistics for the population (age, sex-ratio, marital status, etc.) as a whole. XHTML formatting may be used in this element for forward-compatibility with DDI Lifecycle.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<deviat>The suitability of Ohio as a research site reflected its similarity to the United States as a whole. The evidence extended by Tuchfarber (1988) shows that Ohio is representative of the United States in several ways: percent urban and rural, percent of the population that is African American, median age, per capita income, percent living below the poverty level, and unemployment rate. Although results generated from an Ohio sample are not empirically generalizable to the United States, they may be suggestive of what might be expected nationally.</deviat>
]]>
<xs:sequence>
</xs:sequence>
</xs:complexType>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
<xhtml:p>Set this attribute to:</xhtml:p>
</xhtml:div>
<xhtml:p>
- "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.).
</xhtml:p>
<xhtml:p>
- "dataFile" if the digital fingerprint is only for the data file in its current storage format.
</xhtml:p>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="data"/>
</xs:restriction>
<xs:enumeration value="dataFile"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Data Fingerprint</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Allows for assigning a hash value (digital fingerprint) to the data or data file. One approach to compute a data fingerprint is the Universal Numerical Fingerprint (UNF). Provide the digital fingerprint in "digitalFingerprintValue" and identify the algorithm specification used in "algorithmSpecification" (adding a version number in "algorithmVersion" as a separate entry if it is not part of the specification entry).
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dataFingerprint type="data">
<digitalFingerprintValue>UNF:3:DaYlT6QSX9r0D50ye+tXpA==</digitalFingerprintValue> <algorithmSpecification>UNF v5.0 Calculation Production [http://thedata.org/book/unf-version-5-0]</algorithmSpecification> <algorithmVersion>UNF V5</algorithmVersion> </dataFingerprint> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">File Dimensions</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Dimensions of the overall file. Including the case quantity, variable quantity, logical record length, records per case, and total number of records.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Disclaimer</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Information regarding responsibility for uses of the data collection. This element may be repeated to support multiple language expressions of the content.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<disclaimer>The original collector of the data, ICPSR, and the relevant funding agency bear no responsibility for uses of this collection or for interpretations or inferences based upon such uses.</disclaimer>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Date of Distribution</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Date that the work was made available for distribution/presentation. If using a text entry in the element content, the element may be repeated to support multiple language expressions.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<distDate date="1999-01-25">January 25, 1999</distDate>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Distributor Statement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Distribution statement for the work at the appropriate level: marked-up document; marked-up document source; study; study description, other material; other material for study. Includes information on the distributor, contact, depositor, deposit date, and distribution date.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="abbr" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the institution.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the distributor with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
URN or URL to the ordering service or download facility on a Web site.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the distributor.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Type of distributor: organization or individual.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Distributor</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The organization designated by the author or producer to generate copies of the particular work including any necessary editions or revisions. Names and addresses may be specified and other archives may be co-distributors.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<distrbtr abbr="ICPSR" affiliation="Institute for Social Research" URI="http://www.icpsr.umich.edu">Ann Arbor, MI: Inter-university Consortium for Political and Social Research</distrbtr>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<distrbtr abbr="UMICH" URI="https://www.umich.edu/" agentIdentifier="grid.214458.e" typeOfAgentIdentifier="GRID">University of Michigan - Ann Arbor</distrbtr>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Coordinate order (rank="1", rank="2", etc.)</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Points to the variable that makes up this dimension of the nCube.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Dimension</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This element defines a variable as a dimension of the nCube, and should be repeated to describe each of the cube's dimensions.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dmns rank="3" varRef="V24">
<cohort catRef="CV24_1" value="1"/> </dmns> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Document Description</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The Document Description consists of bibliographic information describing the DDI-compliant document itself as a whole. This Document Description can be considered the wrapper or header whose elements uniquely describe the full contents of the compliant DDI file. Since the Document Description section is used to identify the DDI-compliant file within an electronic resource discovery environment, this section should be as complete as possible. The author in the Document Description should be the individual(s) or organization(s) directly responsible for the intellectual content of the DDI version, as distinct from the person(s) or organization(s) responsible for the intellectual content of the earlier paper or electronic edition from which the DDI edition may have been derived. The producer in the Document Description should be the agency or person that prepared the marked-up document. Note that the Document Description section contains a Documentation Source subsection consisting of information about the source of the DDI-compliant file-- that is, the hardcopy or electronic codebook that served as the source for the marked-up codebook. These sections allow the creator of the DDI file to produce version, responsibility, and other descriptions relating to both the creation of that DDI file as a separate and reformatted version of source materials (either print or electronic) and the original source materials themselves. The attribute "access" records the ID values of all elements in the Data Access and Metadata Access section that describe access conditions for this document description.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
MAchine Readable Citation URI, link to the MARC record for the citation.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Documentation Source</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Citation for the source document. This element encodes the bibliographic information describing the source codebook, including title information, statement of responsibility, production and distribution information, series and version information, text of a preferred bibliographic citation, and notes (if any). Information for this section should be taken directly from the source document whenever possible. If additional information is obtained and entered in the elements within this section, the source of this information should be noted in the source attribute of the particular element tag.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Documentation Status</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Use this field to indicate if the documentation is being presented/distributed before it has been finalized. Some data producers and social science data archives employ data processing strategies that provide for release of data and documentation at various stages of processing. The element may be repeated to support multiple language expressions of the content. This supports the use of a controlled vocabulary. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<docStatus>This marked-up document includes a provisional data dictionary and brief citation only for the purpose of providing basic access to the data file. A complete codebook will be published at a later date.</docStatus>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="syntax" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates the command language employed (e.g., R, SPSS, SAS, Fortran, etc.).
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Derivation Command</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The actual command used to generate the derived variable. The element may be repeated to support multiple language expressions of the content.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<derivation> <drvcmd syntax="SPSS">RECODE V1 TO V3 (0=1) (1=0) (2=-1) INTO DEFENSE WELFAREHEALTH. </drvcmd> </derivation> </var> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Derivation Description</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
A textual description of the way in which this variable was derived. The element may be repeated to support multiple language expressions of the content.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<derivation> <drvdesc> VAR215.01 "Outcome of first pregnancy" (1988 NSFG=VAR611 PREGOUT1) If R has never been pregnant (VAR203 PREGNUM EQ 0) then OUTCOM01 is blank/inapplicable. Else, OUTCOM01 is transferred from VAR225 OUTCOME for R's 1st pregnancy. </drvdesc> </derivation> </var> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">East Bounding Longitude</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The easternmost coordinate delimiting the geographic extent of the dataset. A valid range of values, expressed in decimal degrees (positive east and positive north), is: -180,0 <= East Bounding Longitude Value <= 180,0
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<eastBL>33.637497</eastBL>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextAndDateType">
</xs:complexContent>
<xs:attribute default="notBefore" name="event">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Specifies when will the embargo end, or begin its effect.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="notBefore"/>
</xs:restriction>
<xs:enumeration value="notAfter"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Ensures the information in this element will be machine-processable, and specifies a format for the embargo element. This attribute could be used to specify other conventions for the way that information within the embargo element is set out, if conventions for encoding embargo information were established in the future.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Embargo</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
Provides information on variables/nCubes which are not currently available because of policies established by the principal investigators and/or data producers.
</xhtml:p>
<xhtml:p>
This element may be repeated to support multiple language expressions of the content.
</xhtml:p>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<embargo event="notBefore" date="2001-09-30"> The data associated with this variable/nCube will not become available until September 30, 2001, because of embargo provisions established by the data producers.</embargo> </var> ]]>
<xs:simpleContent>
</xs:complexType>
<xs:extension base="stringType">
</xs:simpleContent>
<xs:attribute name="colname" type="xs:NMTOKEN" use="optional"/>
</xs:extension>
<xs:simpleType>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="left"/>
</xs:restriction>
<xs:enumeration value="right"/>
<xs:enumeration value="center"/>
<xs:enumeration value="justify"/>
<xs:enumeration value="char"/>
<xs:simpleType>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="top"/>
</xs:restriction>
<xs:enumeration value="middle"/>
<xs:enumeration value="bottom"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Table Entry</xhtml:h1>
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Estimates of Sampling Error</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Measure of how precisely one can estimate a population value from a given sample.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<EstSmpErr> To assist NES analysts, the PC SUDAAN program was used to compute sampling errors for a wide-ranging example set of proportions estimated from the 1996 NES Pre-election Survey dataset. For each estimate, sampling errors were computed for the total sample and for twenty demographic and political affiliation subclasses of the 1996 NES Pre-election Survey sample. The results of these sampling error computations were then summarized and translated into the general usage sampling error table provided in Table 11. The mean value of deft, the square root of the design effect, was found to be 1.346. The design effect was primarily due to weighting effects (Kish, 1965) and did not vary significantly by subclass size. Therefore the generalized variance table is produced by multiplying the simple random sampling standard error for each proportion and sample size by the average deft for the set of sampling error computations.</EstSmpErr>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">File Command</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
The element allows for the description of the file command by capturing a textual description of the command including the capture of pseudo code in "drvdesc" as well as the specific command using "drvcmd". Follow the same convention as the variable derivation; source="producer" holds original and source="archive" holds the SDTD.
</xhtml:p>
<xhtml:p>
Provide linkage to source and target variables that were involved in this derivation command in "fileDerivationVars". Basically, any dropped variable from the source will only be identified and referenced here. A variable that is kept and unchanged, will have a derivation pointing to it source, but the specific command which led to its retention will only be identified here at the file level. Variables created by a file level command will be linked here, and their derivation elements will repeat the command.
</xhtml:p>
<xhtml:p>
If applicable, use the values "add" or "drop" in the attribute "fileDerivationCasesAction" if this command added or dropped cases from the referenced source files.
</xhtml:p>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
If applicable, provide information about added or dropped cases from the referenced source files.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="add"/>
</xs:restriction>
<xs:enumeration value="drop"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">File Derivation</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
The element allows for the description of the file commands used to creation the file derivation.
</xhtml:p>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<fileDerivation sourceFiles="F1">
<fileCommand> <drvdesc>Delete AGE, MARITAL from the dataset.</drvdesc> <drvcmd source="producer" syntax="spss">delete variables AGE MARITAL.</drvcmd> <drvcmd source="archive" syntax="sdtl-pojo"> { "$type" : "DeleteVariables", "command" : "delete", "sourceInformation" : { "lineNumberStart" : 3, "lineNumberEnd" : 3, "sourceStartIndex" : 70, "sourceStopIndex" : 98, "originalSourceText" : "delete variables AGE MARITAL." }, "unknownProperties" : [ ], "canChangeData" : false, "variables" : [ { "$type" : "VariableSymbolExpression", "unknownProperties" : [ ], "variableName" : "AGE" }, { "$type" : "VariableSymbolExpression", "unknownProperties" : [ ], "variableName" : "MARITAL" } ], "$type" : "DeleteVariables" } </drvcmd> <fileDerivationVars drop="AGE MARITAL"/> </fileCommand> </fileDerivation> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Space delimited list of the "fileTxt" IDs used as the source(s) of the derivation.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">File Derivation Variables</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Empty element consisting only of its attributes. This element is used to capture the variables that were kept, dropped, or added as part of a file level command.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<fileCommand>
<fileDerivationsVars keep="V1 V2 V5" drop="V3" add="V16"/> </fileCommand> ]]>
<xs:attribute name="keep" type="xs:IDREFS" use="optional">
</xs:complexType>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Space delimited ID references to the target variables that were kept as part of this file level command.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Space delimited ID references to the source variables that were dropped as part of this file level command.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Space delimited ID references to the target variables that were created as part of this file level command.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Contents of Files</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Abstract or description of the file. A summary describing the purpose, nature, and scope of the data file, special characteristics of its contents, major subject areas covered, and what questions the PIs attempted to answer when they created the file. A listing of major variables in the file is important here. In the case of multi-file collections, this uniquely describes the contents of each file. The element may be repeated to support multiple language expressions of the content.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<fileCont>Part 1 contains both edited and constructed variables describing demographic and family relationships, income, disability, employment, health insurance status, and utilization data for all of 1987.</fileCont>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
URN or a URL that can be used to retrieve the file.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
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 file. These elements include: time period covered, date of collection, nation or country, geographic coverage, geographic unit, unit of analysis, universe, and kind of data.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Methodology and processing references that record the ID values of all elements within the study methodology and processing section of the Study Description that might apply to the file. These elements include information on data collection and data appraisal (e.g., sampling, sources, weighting, data cleaning, response rates, and sampling error estimates).
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Provides a link to publication/citation references and records the ID values of all citations elements within Other Study Description Materials or Other Study-Related Materials that pertain to this file.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Records the ID values of all elements in the Data Access section that describe access conditions for this file.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Data Files Description</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
Information about the data file(s) that comprises a collection. This section can be repeated for collections with multiple files.
</xhtml:p>
<xhtml:p>
Remarks: when a codebook documents two different physical instantiations of a data file, e.g., logical record length (or OSIRIS) and card-image version, the Data File Description should be repeated to describe the two separate files. An ID should be assigned to each file so that in the Variable section the location of each variable on the two files can be distinguished using the unique file IDs.
</xhtml:p>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<fileDscr ID="CARD-IMAGE" URI="www.icpsr.umich.edu/cgi-bin/archive.prl?path=ICPSR&num=7728"/>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<fileDscr ID="LRECL" URI="www.icpsr.umich.edu/cgi-bin/archive.prl?path=ICPSR&num=7728"/>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">File Name</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Contains a short title that will be used to distinguish a particular file/part from other files/parts in the data collection. The element may be repeated to support multiple language expressions of the content.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<fileName ID="File1">Second-Generation Children Data</fileName>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Place of File Production</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Indicates where the file was produced. In the case of an added format version this could be the archive.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<filePlac>Washington, DC: United States Department of Commerce, Bureau of the Census</filePlac>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Number of Files</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Total number of physical files associated with a collection.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<fileQnty>5 files</fileQnty>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Type of structure, predefined options.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="rectangular"/>
</xs:restriction>
<xs:enumeration value="hierarchical"/>
<xs:enumeration value="relational"/>
<xs:enumeration value="nested"/>
<xs:enumeration value="other"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Value specifying the other type. This attribute should only be used when the value of the attribute "type" is equal to "other". Use the complex element controlledVocabUsed to identify the controlled vocabulary to which the selected term belongs.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Allows for multiple data files with different coverage but the same file structure to share a single fileStrc. The file structure is fully described in the first fileTxt within the fileDscr and then the fileStrc in subsequent fileTxt descriptions would reference the first fileStrcRef rather than repeat the details.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">File Structure</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Type of file structure. The attribute "type" is used to indicate hierarchical, rectangular, relational, or nested (the default is rectangular). If the file is rectangular, the next relevant element is File Dimensions.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Indicate the MIME type of the file.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">File-by-File Description</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Provides descriptive information about the data file. A file name and a full bibliographic citation for the file may be entered, as well as a data fingerprint, if available. Information about the physical properties of the data file is also supported. Make sure to fill out topcClass for the study as these can be used by the data file. Note coverage constraints in fileCont.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">File Citation</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The complex element fileCitation provides for a full bibliographic citation option for each data file described in fileDscr. To support accurate citation of a data file the minimum element set includes: titl, IDNo, AuthEnty, producer, and prodDate. If a DOI is available for the data file enter this in the IDNo (this element is repeatable). If a hash value (digital fingerprint) has been created for the data file enter the information regarding its value and algorithm specification in digitalFingerprint.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<fileCitation>
<titlStmt> <titl>ABC News/Washington Post Monthly Poll, December 2010</titl> <IDNo>http://dx.doi.org/10.3886/ICPSR32547.v1</IDNo> </titlStmt> <rspStmt> <AuthEnty>ABC News</AuthEnty> <AuthEnty>The Washington Post</AuthEnty> </rspStmt> <prodStmt> <producer>ABC News</producer> <prodDate>2011</prodDate> </prodStmt> </fileCitation> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="charset" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Character set used in the file, e.g., US-ASCII, EBCDIC, UNICODE UTF-8, etc. The use of a standard term from a controlled vocabulary for this attribute is recommended even though its structure does not allow for the declaration of the controlled vocabulary used. DDI provides a Controlled Vocabulary for this location: "CharacterSet"
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Type of File</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Types of data files include raw data (ASCII, EBCDIC, etc.) and software-dependent files such as SAS datasets, SPSS export files, etc. If the data are of mixed types (e.g., ASCII and packed decimal), state that here. Note that the element varFormat permits specification of the data format at the variable level. The element may be repeated to support multiple language expressions of the content.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<fileType charset="US-ASCII">ASCII data file</fileType>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Data Format</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Physical format of the data file: Logical record length format, card-image format (i.e., data with multiple records per case), delimited format, free format, etc. The element may be repeated to support multiple language expressions of the content. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<format vocab="EU Vocabularies: File Type" vocabURI="http://publications.europa.eu/resource/authority/file-type” vocabINstanceURI="http://publications.europa.eu/resource/authority/file-type/CSV" vocabIntanceCodeTerm="CSV" xml:lang="en">Comma separated values</format>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="qstn" type="xs:IDREFS">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Space delimited question IDs.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Forward Progression</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Contains a reference to IDs of possible following questions.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<qstn> <forward qstn="Q120 Q121 Q122 Q123 Q124">If yes, please ask questions 120-124.</forward> </qstn> </var> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="freq" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Used to specify a controlled vocabulary concept. DEPRECATED.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Frequency of Data Collection</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
For data collected at more than one point in time, the frequency with which the data were collected. The use of the attribute "freq" is DEPRECATED. To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". DDI provides a Controlled Vocabulary for this location: "TypeOfFrequency". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<frequenc>
<concept vocabURI="https://www.loc.gov/standards/valuelist/marcfrequency.html">Monthly</concept> </frequenc> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<frequenc>
<concept vocabURI="https://www.loc.gov/standards/valuelist/marcfrequency.html">Quarterly</concept> </frequenc> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="affiliation" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the funding agency with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the funding agency.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Role played, if different funding agencies sponsored different stages of the production process.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the funding agency.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of funding agency: organization or individual.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Funding Agency/Sponsor</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The source(s) of funds for production of the work including abbreviation and affiliation.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<fundAg abbr="NSF" role="infrastructure">National Science Foundation</fundAg>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<fundAg abbr="NICHD" affiliation="NIH" role="infrastructure">Eunice Kennedy Shriver Institute for Child Health and Human Development</fundAg>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<fundAg abbr="SUN" role="equipment">Sun Microsystems</fundAg>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Geographic Bounding Box</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
The fundamental geometric description for any dataset that models geography. GeoBndBox is the minimum box, defined by west and east longitudes and north and south latitudes, that includes the largest geographic extent of the dataset's geographic coverage. This element is used in the first pass of a coordinate-based search. If the boundPoly element is included, then the geoBndBox element MUST be included.
</xhtml:p>
<xhtml:p>
Replication of the element geoBndBox is NOT recommended. The purpose of a bounding box is to support high level geographic point search systems. Most search systems of this type do not handle multiple instances of a bounding box. The bounding box should represent the full geographic coverage extent of the of the overall datasets being described by the Codebook instance. If there is a desire to provide the equivalent of a bounding box for each of multiple summary descriptions, use of the boundPoly is recommended. First provide a geoBndBox for the full area covered by the study. Then provide a boundPoly for each geographic area defined with a separate sumDscr. Note that when describing a bounding box using a boundPoly description the four corner points are described. The starting point and end point should match (closing the polygon).
</xhtml:p>
<xhtml:p>
The examples shown here show bounding box specifications for the coverage of two different data files.
</xhtml:p>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<stdyInfo>
<sumDscr> <geogCover>Nevada State</geogCover> <geoBndBox> <westBL>-120.005729004</westBL> <eastBL>-114.039663</eastBL> <southBL>35.00208499998</southBL> <northBL>42.002207</northBL> </geoBndBox> </sumDscr> </stdyInfo> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<stdyInfo>
<sumDscr> <geogCover>Norway</geogCover> <geoBndBox> <westBL>4.789583</westBL> <eastBL>33.637497</eastBL> <southBL>57.987915</southBL> <northBL>80.76416</northBL> </geoBndBox> </sumDscr> </stdyInfo> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:attribute name="URI" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Points to the URN or URL of the external map that displays the geography in question.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Indicates the format of the map.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates the level of the geographic hierarchy relayed in the map.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Geographic Map</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Empty element consisting only of its attributes. This element is used to provide a link to an external map that displays the geography in question.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<geoMap URI="https://www.dol.gov/agencies/wb/data/lfp-rate-sex-state-county" mapformat="raster" levelno="050"/>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Geographic Coverage</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Information on the geographic coverage of the data. Includes the total geographic scope of the data, and any additional levels of geographic coding provided in the variables. Maps to Dublin Core Coverage element. Inclusion of this element in the codebook is recommended. To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept. For forward-compatibility, DDI Lifecycle XHTML tags may be used in this element.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<sumDscr>
<geogCover>State of California</geogCover> </sumDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<sumDscr>
<geogCover><concept vocab="USPS" vocabInstanceCodeTerm="CA">California</concept></geogCover> </sumDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Geographic Unit</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Lowest level of geographic aggregation covered by the data.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<geogUnit>state</geogUnit>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="agency" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Name of the agency, if more than one agency is listed.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Reference to the ID of the funding agency issuing this grant. If more than one agency provide all of the ID's in a space delimited list. Use of this attribute requires the related fundAg to contain an ID.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
List the program within an agency, if appropriate.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
URN or URL for the agency or specific funding program. If both are available provide the more specific, funding program URI.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Specific grant name, if existing.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Role in the production process to distinguish the grant numbers, if different funding agencies sponsored different stages of the production process.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Grant Number</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The grant/contract number of the project that sponsored the effort. Note that regional and country differences may make direct comparison difficult. The attributes are intended to allow for differences in grant organization in different countries.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<grantNo agency="Bureau of Justice Statistics">J-LEAA-018-77</grantNo>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<grantNo agency="Academy of Finland. Strategic Research Council" fundingProgramme="SRC 2016 Health, welfare and lifestyles" grantName="Inclusive Promotion of Health and Wellbeing">303654</grantNo>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">G-Ring Latitude</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Latitude (y coordinate) of a point. Valid range expressed in decimal degrees is as follows: -90,0 to 90,0 degrees (latitude)
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<gringLat>35.00208499998</gringLat>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">G-Ring Longitude</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Longitude (x coordinate) of a point. Valid range expressed in decimal degrees is as follows: -180,0 to 180,0 degrees (longitude)
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<gringLon>-114.039663</gringLon>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Guide to Codebook</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
List of terms and definitions used in the documentation. Provided to assist users in using the document correctly. This element was intended to reflect the section in OSIRIS codebooks that assisted users in reading and interpreting a codebook. Each OSIRIS codebook contained a sample codebook page that defined the codebook conventions. The element may be repeated to support multiple language expressions of the content.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="location" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Physical location where a copy is held.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
The call number for a work at the location specified.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
URN or URL for accessing the electronic copy of the cited work.
</xhtml:div>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Holdings Information</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Information concerning either the physical or electronic holdings of the cited work.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<holdings location="ICPSR DDI Repository" callno="inap." URI="http://www.icpsr.umich.edu/DDIrepository/">Marked-up Codebook for Current Population Survey, 1999: Annual Demographic File</holdings>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<holdings location="University of Michigan Graduate Library" callno="inap." URI="http://www.umich.edu/library/">Codebook for Current Population Survey, 1999: Annual Demographic File </holdings>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="agency" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Indicates the managing agency for the identifier.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identification number is a persistent identifer.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Specifies the level (study, file, or project) to which the identification number applies.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="study"/>
</xs:restriction>
<xs:enumeration value="file"/>
<xs:enumeration value="project"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Identification Number</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Unique string or number (producer's or archive's number). Identification Number of data collection maps to Dublin Core element "Identifier".
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<IDNo agency="ICPSR">6678</IDNo>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<IDNo agency="ZA">2010</IDNo>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<IDNo agency="DOI" isPersistentIdentifier="true" level="project">10.18128/D010.V7.0</IDNo>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Imputation</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
According to the Statistical Terminology glossary maintained by the National Science Foundation, this is "the process by which one estimates missing values for items that a survey respondent failed to provide," and if applicable in this context, it refers to the type of procedure used. When applied to an nCube, imputation takes into consideration all of the dimensions that are part of that nCube. This element may be repeated to support multiple language expressions of the content. This supports the use of a controlled vocabulary. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<imputation>This variable contains values that were derived by substitution.</imputation> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<imputation vocab="The Analysis Factor" vocabURI="https://www.theanalysisfactor.com/seven-ways-to-make-up-data-common-methods-to-imputing-missing-data/" vocabInstanceTerm="Substitution">Substitution</imputation> </var> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:extension>
<xs:choice maxOccurs="unbounded" minOccurs="1">
</xs:choice>
</xs:sequence>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID values of all elements in the Data Access and Metadata Access section that describe access conditions for this range.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Range of Invalid Data Values</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Values for a particular variable that represent missing data, not applicable responses, etc.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<invalrng access="DA_4">
<range UNITS="INT" min="98" max="99"/> <key> 98 DK 99 Inappropriate </key> </invalrng> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:attribute default="INT" name="UNITS">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Specifies if numbers are integer or real.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="INT"/>
</xs:restriction>
<xs:enumeration value="REAL"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Specifies the actual value.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Value Item</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The counterpart to Range; used to encode individual values when the values cannot be expressed as a min/max range or when specification of the values is desired. This is an empty element consisting only of its attributes.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<valrng>
<item UNITS="INT" VALUE="10"/> <item UNITS="INT" VALUE="15"/> <item UNITS="INT" VALUE="22"/> </valrng> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<valrng>
<item VALUE="1"/> <item VALUE="2"/> <item VALUE="3"/> </valrng> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Interviewer Instructions</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Specific instructions to the individual conducting an interview.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<qstn> <ivuInstr>Please prompt the respondent if they are reticent to answer this question.</ivuInstr> </qstn> </var> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Range Key</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This element permits a listing of the category values and labels. While this information is coded separately in the Category element, there may be some value in having this information in proximity to the range of valid and invalid values. A table is permissible in this element.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<valrng>
<range UNITS="INT" min="05" max="80"/> <key> 05 (PSU) Parti Socialiste Unifie et extreme gauche (Lutte Ouvriere) [United Socialists and extreme left (Workers Struggle)] 50 Les Verts [Green Party] 80 (FN) Front National et extreme droite [National Front and extreme right] </key> </valrng> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<valrng>
<range UNITS="REAL" minExclusive="0" maxExclusive="10"/> <key>Responses fall between 0 and 10 but may not include those two values.</key> </valrng> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Keywords</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Words or phrases that describe salient aspects of a data collection's content. Can be used for building keyword indexes and for classification and retrieval purposes. A controlled vocabulary can be employed. Maps to Dublin Core Subject element. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<keyword vocab="ICPSR Subject Thesaurus" vocabURI="http://www.icpsr.umich.edu/thesaurus/subject.html" vocabInstanceURI="http://www.icpsr.umich.edu/thesaurus/subject#qualityOfLife">quality of life</keyword>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<keyword vocab="ICPSR Subject Thesaurus" vocabURI="http://www.icpsr.umich.edu/thesaurus/subject.html" vocabInstanceURI="http://www.icpsr.umich.edu/thesaurus/subject#family">family</keyword>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<keyword vocab="ICPSR Subject Thesaurus" vocabURI="http://www.icpsr.umich.edu/thesaurus/subject.html" vocabInstanceURI="http://www.icpsr.umich.edu/thesaurus/subject#careerGoals">career goals</keyword>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="level" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Coding of the level to which the label applies, i.e. record group, variable group, variable, category group, category, nCube group, nCube, or other study-related materials.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Specifies the different labels for use with different vendors' software.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Denotation of country-specific labels.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID values of all elements within the Summary Data Description section of the Study Description that might apply to the label. These elements include: time period covered, date of collection, nation or country, geographic coverage, geographic unit, unit of analysis, universe, and kind of data.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Label</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
A short description of the parent element. In the variable label, the length of this phrase may depend on the statistical analysis system used (e.g., some versions of SAS permit 40-character labels, while some versions of SPSS permit 120 characters), although the DDI itself imposes no restrictions on the number of characters allowed.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<recGrp rectype="A" keyvar="H-SEQ" recidvar="PRECORD">
<labl>Person (A) Record</labl> </recGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<varGrp>
<labl>Study Procedure Information</labl> </varGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCubeGrp>
<labl>Tenure by Age of Householder</labl> </nCubeGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<labl>Why No Holiday-No Money</labl> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catgryGrp>
<labl>Other Agricultural and Related Occupations</labl> </catgryGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catgry>
<labl>Better</labl> </catgry> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<otherMat type="SAS data definition statements" level="study" URI="http:// www.icpsr.umich.edu">
<labl>SAS Data Definition Statements for ICPSR 6837</labl> </otherMat> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catgry>
<labl level="catgry" country="US">Pharmacist</labl> <labl level="catgry" country="CA">Chemist</labl> </catgry> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCube>
<labl level="nCube" vendor="SAS">Employment. race, age, sex, age 16-64</labl> <labl level="nCube" vendor="SPSS">Employment status by race by age by gender for persons ages 16 to 64 years of age</labl> </nCube> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="typeOfLanguageCode" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Type of language code used.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Language</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
A brief textual identification of the language of the cited object. DDI strongly recommend the use of language codes supported by xs:language which include the 2 and 3 character and extended structures defined by RFC5646 or its successors. Repeat for multiple languages.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<language typeOfLanguageCode="RFC5646" languageCode="en-CA">English as used in Canada</language>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<language typeOfLanguageCode="RFC5646" languageCode="fr-CA">French as used in Canada</language>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="URI" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">URN or URL to the legal document.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="data"/>
</xs:restriction>
<xs:enumeration value="metadata"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Allows specification of the scope of the license. If the scope is something else do not use this attribute
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="study"/>
</xs:restriction>
<xs:enumeration value="question"/>
<xs:annotation>
</xs:element>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">License</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
A legal document giving official permission to something with the resource. Recommendation is to provide the license document URI. Equates to https://www.dublincore.org/specifications/dublin-core/dcmi-terms/terms/license/
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<license type="metadata" scope="study" URI="https://creativecommons.org/licenses/by/4.0/legalcode">CC by 4.0</license>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Location Map</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This element maps individual dataItems to one or more physical storage locations. It is used to describe the physical location of aggregate/tabular data in cases where the nCube model is employed. May also be used for var location description and is useful when the physical location of a key variable is located in different positions in different record types or when the file contains a mixture of variable and nCube description. Always use the ID attribute to support the reference from the var or nCube.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<locMap ID="LM_1">
<dataItem>...</dataItem> <dataItem>...</dataItem> </locMap> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:attribute name="StartPos" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Starting position of variable</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">End position of variable</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Number of columns the variable occupies</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Segment number, deck or card number the variable is located on
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID reference to the fileDscr element for the file that this location is within (this is necessary in cases where the same variable may be coded in two different files, e.g., a logical record length type file and a card image type file).
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID reference to the element locMap and serves as a pointer to indicate that the location information for the nCube's cells (aggregate data) is located in that section.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Location</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Empty element consisting only of its attributes.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<location StartPos="55" EndPos="57" width="3" RecSegNo="2" fileid="CARD-IMAGE"/> <location StartPos="167" EndPos="169" fileid="LRECL"/> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCube>
<location locMap="LM"/> </nCube> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Logical Record Length</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Logical record length, i.e., number of characters of data in the record.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<logRecL>27</logRecL>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:attribute name="varRef" type="xs:IDREF">
</xs:extension>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Indicates the type of aggregation method used.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="sum"/>
</xs:restriction>
<xs:enumeration value="average"/>
<xs:enumeration value="count"/>
<xs:enumeration value="mode"/>
<xs:enumeration value="median"/>
<xs:enumeration value="maximum"/>
<xs:enumeration value="minimum"/>
<xs:enumeration value="percent"/>
<xs:enumeration value="other"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Other aggregation method from a controlled vocabulary. The complex element controlledVocabUsed should be used to specify the controlled vocabulary.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Measurement unit, for example 'km', 'miles', etc.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Unit of scale, for example 'x1', 'x1000'.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Point of origin for anchored scales.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates whether an aggregate is a stock (like the population at a given point in time) or a flow (like the number of births or deaths over a certain period of time). The non-additive flag is to be used for measures that for logical reasons cannot be aggregated to a higher level - for instance, data that only make sense at a certain level of aggregation, like a classification.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="stock"/>
</xs:restriction>
<xs:enumeration value="flow"/>
<xs:enumeration value="non-additive"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Measure</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Empty element consisting only of its attributes. Two nCubes may be identical except for their measure - for example, a count of persons by age and percent of persons by age.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<measure source="producer" measUnit="Persons" varRef="V_PER" scale="x1" additivity="stock" aggrMeth="count"/>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Metadata Access</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This section describes access conditions and terms of use for the metadata. In cases where access conditions differ across individual files, variables, or categories multiple access conditions can be specified. The access conditions applying to a study, file, variable group, variable or category can be indicated by an IDREF attribute on the study, file, variable group, nCube group, variable, category, or data item elements called "access". The member element "typeOfAccess" is of the type "concept" and is intended to provide a specific type of access. If a license applies to the data access, use the optional "license" element.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Methodology and Processing</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This section describes the methodology and processing involved in a data collection. This includes use of methods such as survey, experiment, secondary analysis, field research, sampling methods, etc. Processing covers the data collection processes, aggregation, imputation, and other post-collection data processing.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Used to specify the type of coding instruction. DEPRECATED.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Allows linking a coding instruction to one or more processes such as dataProcessing, dataAppr, cleanOps, etc.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Coding Instructions</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Describe specific coding instructions used in data processing, cleaning, acquisition, or tabulation. Use the txt element to describe instructions in a human readable form. The type attribute has been DEPRECATED. Use the typeOfCodingInstruction to indicate the type of instruction with or without the use of a controlled vocabulary. Repeat if multiple language labels are being provided directly within the documentation.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<codingInstructions relatedProcesses="cleanOps_7334">
<typeOfCodingInstruction>recode</typeOfCodingInstruction> <txt>recode undocumented/wild codes to missing, i.e., 0.</txt> <command formalLanguage="SPSS">RECODE V1 TO V100 (10 THROUGH HIGH = 0)</command> </codingInstructions> ]]>
<xs:simpleContent>
</xs:complexType>
<xs:extension base="stringType">
</xs:simpleContent>
<xs:attribute name="formalLanguage" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifies the language of the command code.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Command</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Provide command code for the coding instruction.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<command formalLanguage="SPSS">RECODE V1 TO V100 (10 THROUGH HIGH = 0)</command>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="type" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Used to specify a controlled vocabulary concept. DEPRECATED.
</xhtml:div>
<xs:annotation>
</xs:element>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Data Processing</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Describes various data processing procedures not captured elsewhere in the documentation, such as topcoding, recoding, suppression, tabulation, etc. The use of the attribute "type" as a means of specifying a controlled vocabulary concept is DEPRECATED. To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". If the dataProcessing involves translations, DDI provides a Controlled Vocabulary for this location: "TypeOfTranslationMethod". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dataProcessing><concept>topcoding</concept>The income variables in this study (RESP_INC, HHD_INC, and SS_INC) were topcoded to protect confidentiality.</dataProcessing>
]]>
<xs:annotation>
</xs:element>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Mathematical Identifier</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Token element containing the smallest unit in the mrow that carries meaning expressed by the attribute varRef. This is an element taken from MathML.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<mi varRef="STATE"/>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Mathematical Row</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This element is a wrapper containing the presentation expression mi. It creates a single string without spaces consisting of the individual elements described within it. It can be used to create a single variable by concatenating other variables into a single string. It is used to create linking variables composed of multiple non-contiguous parts, or to define unique strings for various category values of a single variable. This is an element taken from MathML. The example shows the use of mrow in the context of a code based on two separate variables.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<catgry>
<labl>Unique county code</labl> <txt>Complete county code including the content of the variables STATE (2ch) and COUNTY (3ch) creating a unique identifying code for an individual county</txt> <mrow> <mi varRef="STATE"/> <mi varRef="CNTY"/> </mrow> </catgry> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Short label for the nCube. Following the rules of many statistical analysis systems such as SAS and SPSS, names are usually up to eight characters long.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Summary data description references which record the ID values of all elements within the summary data description section of the Study Description which might apply to the nCube. These elements include: time period covered, date of collection, nation or country, geographic coverage, geographic unit, unit of analysis, universe, and kind of data.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
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 nCube. These elements include information on data collection and data appraisal (e.g., sampling, sources, weighting, data cleaning, response rates, and sampling error estimates).
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Link to publication/citation references and records the ID values of all citations elements in Other Study Description Materials or Other Study-Related Materials that pertain to this nCube.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID values of all elements in the Data Access section that describe access conditions for this nCube.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Number of dimensions in the nCube.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Total number of cells in the nCube.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">nCube</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:div class="description">
</xhtml:div>
Describes the logical structure of an n-dimensional array, in which each coordinate intersects with every other dimension at a single point. The nCube has been designed for use in the markup of aggregate data. Repetition of the following elements is provided to support multi-language content: anlysUnit, embargo, imputation, purpose, respUnit, and security.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
<xhtml:p>
</xhtml:div>
General type of grouping of the nCubes. Specific nCube Groups, included within the 'type' attribute, are:
</xhtml:p>
<xhtml:p>
- display: nCubes that are part of the same presentation table.
</xhtml:p>
<xhtml:p>
- subject: nCubes that address a common topic or subject, e.g., income, poverty, children.
</xhtml:p>
<xhtml:p>
- 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.
</xhtml:p>
<xhtml:p>
- pragmatic: An nCube group without shared properties.
</xhtml:p>
<xhtml:p>
- record: nCubes from a single record in a hierarchical file.
</xhtml:p>
<xhtml:p>
- file: nCube from a single file in a multifile study.
</xhtml:p>
<xhtml:p>
- 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.
</xhtml:p>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="section"/>
</xs:restriction>
<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:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
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.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Space delimited list of the IDs of all the nCubes that are immediate children of the nCube group.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Space delimited list of the IDs of all the nCube groups that are immediate children of the nCube group. The inclusion of a nCubeGrp brings in all of its members. Members of the included nCubeGrp should not be separately listed in either "nCube" or "nCubeGrp".
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">A name, or short label, for the group.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
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.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
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).
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
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.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID values of all elements in codeBook/stdyDscr/dataAccs of the document that describe access conditions for this nCube group.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">nCube Group</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
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.
</xhtml:p>
<xhtml:p>
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.
</xhtml:p>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="vocab" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates the name of the controlled vocabulary, if any, used in the element, e.g., LCSH (Library of Congress Subject Headings), MeSH (Medical Subject Headings), etc.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Specifies the location for the full controlled vocabulary.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Specifies the identification URI of the term/code within the controlled vocabulary if available.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Another form of identification (do not use for URI).
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Agency managing the controlled vocabulary.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Version of controlled vocabulary, if needed</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
If the controlled vocabulary term is "other", provide a more specific value.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">The URN of the controlled vocabulary.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Added to accommodate the code term as it appears in the controlled vocabulary.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Country abbreviation; use of ISO country codes is recommended
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Country</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Indicates the country or countries covered in the file. Attribute "abbr" may be used to list common abbreviations. Maps to Dublin Core element "Coverage". Inclusion of this element is recommended. For forward-compatibility, DDI Lifecycle XHTML tags may be used in this element. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<nation vocab="ISO 3166-1 alpha-2" vocabURI="http://www.iso.org/ISO_3166-1/alpha-2" vocabInstanceURI="http://www.iso.org/ISO_3166-1/alpha-2#FI" vocabInstanceCodeTerm="FI" abbr="FI" xml:lang="en">Finland</nation>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nation vocab="ISO 3166-1 alpha-2" vocabURI="http://www.iso.org/ISO_3166-1/alpha-2" vocabInstanceURI="http://www.iso.org/ISO_3166-1/alpha-2#FI" vocabInstanceCodeTerm="FI" abbr="FI" xml:lang="fi">Suomi</nation>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">North Bounding Latitude</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The northernmost coordinate delimiting the geographic extent of the dataset. A valid range of values, expressed in decimal degrees (positive east and positive north), is: -90,0 <= North Bounding Latitude Value <= 90,0 ; North Bounding Latitude Value = South Bounding Latitude Value
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<northBL>80.76416</northBL>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="tableAndTextType">
</xs:complexContent>
<xs:attribute name="type" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Note type. It uses the complex element controlledVocabUsed to identify the controlled vocabulary to which the selected term belongs. DDI provides a Controlled Vocabulary for this location: "TypeOfNote".
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Note subject, also allowing a controlled vocabulary to be developed.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
DDI level to which the note applies (study, file, variable, etc.)
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Author responsible with the note.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
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.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Captures information obtained while preparing files for translation to DDI Lifecycle. It provides the ID(s) of the element this note is structurally related to by nesting.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Provide information for the translation of codebook content to DDI Lifecycle. If the same note is used multiple times all the parent IDs can be captured in a single note and all duplicate notes can reference the note containing the related to references in the attribute sameNote.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Notes and comments</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
For clarifying information/annotation regarding the parent element.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<docDscr>
<verStmt> <notes resp="Jane Smith">Additional information on derived variables has been added to this marked-up version of the documentation.</notes> </verStmt> </docDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<docDscr>
<citation> <notes resp="Jane Smith">This citation was prepared by the archive based on information received from the markup authors.</notes> </citation> </docDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<docSrc>
<verStmt> <notes resp="Jane Smith">The source codebook was produced from original hardcopy materials using Optical Character Recognition (OCR).</notes> </verStmt> </docSrc> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<docSrc>
<notes>A machine-readable version of the source codebook was supplied by the Zentralarchiv</notes> </docSrc> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<docDscr>
<notes>This Document Description, or header information, can be used within an electronic resource discovery environment.</notes> </docDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<stdyDscr>
<verStmt> <notes resp="Jane Smith">Data for 1998 have been added to this version of the data collection.</notes> </verStmt> </stdyDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<stdyDscr>
<citation> <notes resp="Jane Smith">This citation was sent to ICPSR by the agency depositing the data.</notes> </citation> </stdyDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<stdyInfo>
<notes>Data on employment and income refer to the preceding year, although demographic data refer to the time of the survey.</notes> </stdyInfo> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<method>
<notes>Undocumented codes were found in this data collection. Missing data are represented by blanks.</notes> </method> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<method>
<notes>For this collection, which focuses on employment, unemployment, and gender equality, data from EUROBAROMETER 44.3: HEALTH CARE ISSUES AND PUBLIC SECURITY, FEBRUARY-APRIL 1996 (ICPSR 6752) were merged with an oversample.</notes> </method> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<setAvail>
<notes> Data from the Bureau of Labor Statistics used in the analyses for the final report are not provided as part of this collection.</notes> </setAvail> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataAccs>
<notes>Users should note that this is a beta version of the data. The investigators therefore request that users who encounter any problems with the dataset contact them at the above address.</notes> </dataAccs> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<fileStrc>
<notes>The number of arrest records for an individual is dependent on the number of arrests an offender had.</notes> </fileStrc> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<fileTxt>
<verStmt> <notes>Data for all previously-embargoed variables are now available in this version of the file.</notes> </verStmt> </fileTxt> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<fileDscr>
<notes>There is a restricted version of this file containing confidential information, access to which is controlled by the principal investigator.</notes> </fileDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<varGrp>
<notes>This variable group was created for the purpose of combining all derived variables.</notes> </varGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<varGrp>
<notes source="archive" resp="John Data">This variable group and all other variable groups in this data file were organized according to a schema developed by the adhoc advisory committee.</notes> </varGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCubeGrp>
<notes>This nCube Group was created for the purpose of presenting a cross-tabulation between variables "Tenure" and "Age of householder."</notes> </nCubeGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<valrng>
<notes subject="political party">Starting with Euro-Barometer 2 the coding of this variable has been standardized following an approximate ordering of each country's political parties along a "left" to "right" continuum in the first digit of the codes. Parties coded 01-39 are generally considered on the "left", those coded 40-49 in the "center", and those coded 60-89 on the "right" of the political spectrum. Parties coded 50-59 cannot be readily located in the traditional meaning of "left" and "right". The second digit of the codes is not significant to the "left-right" ordering. Codes 90-99 contain the response "other party" and various missing data responses. Users may modify these codings or part of these codings in order to suit their specific needs.</notes> </valrng> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<invalrng>
<notes>Codes 90-99 contain the response "other party" and various missing data responses. </notes> </invalrng> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<verStmt> <notes>The labels for categories 01 and 02 for this variable, were inadvertently switched in the first version of this variable and have now been corrected.</notes> </verStmt> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<notes>This variable was created by recoding location of residence to Census regions.</notes> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCube>
<verStmt> <notes>The labels for categories 01 and 02 in dimension 1 were inadvertently switched in the first version of the cube, and have now been corrected.</notes> </verStmt> </nCube> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCube>
<notes>This nCube was created to meet the needs of local low income programs in determining eligibility for federal funds.</notes> </nCube> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<dataDscr>
<notes>The variables in this study are identical to earlier waves. </notes> </dataDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<otherMat ID="OM_1">
<notes ID="Note_1" parent="OM_1">Users should be aware that this questionnaire was modified during the CAI process.</notes> </otherMat> <otherMat ID="OM_2"> <notes parent="OM_2" sameNote="Note_1">Users should be aware that this questionnaire was modified during the CAI process.</notes> </otherMat> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="affiliation" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the originating archive with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the originating archive.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">URN or URL to the original archive.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the originating archive.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of originating archive: organization or individual.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Archive Where Study Originally Stored</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Archive from which the data collection was obtained; the originating archive.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<origArch abbr="GESIS" URI="gesis.org" agentIdentifier="018afyw53" typeOfAgentIdentifier="ROR">GESIS Leibniz-Institut für Sozialwissenschaften</origArch>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="type" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Role of the person / agency responsible with editing of the marked up documentation.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the authoring entity.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the authoring entity with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the authoring entity.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of authoring entity: organization or individual.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Other Identifications /Acknowledgments</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Statements of responsibility not recorded in the title and statement of responsibility areas (collaborators). Indicate here the persons or bodies connected with the work, or significant persons or bodies connected with previous editions and not already named in the description. For example, the name of the person who edited the marked-up documentation might be cited in codeBook/docDscr/rspStmt/othId, using the "role" and "affiliation" attributes. DDI provides a Controlled Vocabulary for the attriubte "role": "ContributorRole". Other identifications/acknowledgments for data collection (codeBook/stdyDscr/citation/rspStmt/othId) maps to Dublin Core element "Contributor".
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<othId role="editor" affiliation="INRA" agentIdentifier="0000-0003-1294-0000" typeOfAgentIdentifier="orcid">Jane Smith</othId>
]]>
<xs:complexContent>
</xs:complexType>
<xs:restriction base="abstractTextType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:restriction>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Other References Notes</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Indicates other pertinent references. Can take the form of bibliographic citations.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<othRefs>Part II of the documentation, the Field Representative's Manual, is provided in hardcopy form only.</othRefs>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<othRefs>
<citation> <titlStmt> <titl>Work flows - Data Discovery and Dissemination: User Perspective</titl> <IDNo agency="DOI">10.3886/DDIBestPractices02</IDNo> </titlStmt> <biblCit>Work flows - Data Discovery and Dissemination: User Perspective. Dinkelmann, Karl, Michelle Edwards, Jane Fry, Chuck Humphrey, Ron Nakao, and Wendy Thomas.</biblCit> </citation> </othRefs> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:choice>
</xs:extension>
<xs:sequence>
</xs:sequence>
</xs:choice>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Relationship of the other materials to components of the study. Suggested values for level include specifications of the item level to which the element applies: e.g. "data","datafile", "studydsc", "study".
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
URN or URL to the location of the other study-related materials. It needs not be used in every case; it is intended for capturing references to other materials separate from the codebook itself.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Other Study-Related Materials</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
This section allows for the inclusion of other materials that are related to the study as identified and labeled by the DTD/Schema users (encoders). The materials may be entered as PCDATA (ASCII text) directly into the document (through use of the "txt" element). This section may also serve as a "container" for other electronic materials such as setup files by providing a brief description of the study-related materials accompanied by the attributes "type" and "level" defining the material further. Note that the use of the attribute "type" has been DEPRECATED and the element "typeOfOtherMaterial" should be used instead. This element provide support for the use of a controlled vocabulary.
</xhtml:p>
<xhtml:p>
Other Study-Related Materials may include: questionnaires, coding notes, SPSS/SAS/Stata setup files (and others), user manuals, continuity guides, sample computer software programs, glossaries of terms, interviewer/project instructions, maps, database schema, data dictionaries, show cards, coding information, interview schedules, missing values information, frequency files, variable maps, etc.
</xhtml:p>
<xhtml:p>
In Section 5, Other Material is recursively defined.
</xhtml:p>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Other Study Description Materials</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Other materials relating to the study description. This section describes other materials that are related to the study description that are primarily descriptions of the content and use of the study, such as appendices, sampling information, weighting details, methodological and technical details, publications based upon the study content, related studies or collections of studies, etc. This section may point to other materials related to the description of the study through use of the generic citation element, which is available for each element in this section. This maps to Dublin Core Relation element. Note that codeBook/otherMat (Other Study-Related Materials), should be used for materials used in the production of the study or useful in the analysis of the study. The materials in codeBook/otherMat may be entered as PCDATA (ASCII text) directly into the document (through use of the txt element). That section may also serve as a "container" for other electronic materials by providing a brief description of the study-related materials accompanied by the "type" and "level" attributes further defining the materials. Other Study-Related Materials in codeBook/otherMat may include: questionnaires, coding notes, SPSS/SAS/Stata setup files (and others), user manuals, continuity guides, sample computer software programs, glossaries of terms, interviewer/project instructions, maps, database schema, data dictionaries, show cards, coding information, interview schedules, missing values information, frequency files, variable maps, etc.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Parallel Title</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Title translated into another language.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<titl>Politbarometer West [Germany], Partial Accumulation, 1977-1995</titl>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<parTitl>Politbarometer, 1977-1995: Partielle Kumulation</parTitl>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:attribute name="type" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of file structure: rectangular, hierarchical, two-dimensional, relational.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Link to the appropriate file or recGrp element within a file.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Starting position of variable or data item.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Number of columns the variable/data item occupies.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">End position of variable or data item.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Physical Location</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>Empty element consisting only of its attributes.</xhtml:p>
</xhtml:div>
<xhtml:p>
Remarks: Where the same variable is coded in two different files, e.g., a fixed format file and a relational database file, simply repeat the physLoc element with the alternative location information. Note that if there is no width or ending position, then the starting position should be the ordinal position in the file, and the file would be described as free-format. New attributes will be added as other storage formats are described within the DDI.
</xhtml:p>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<physLoc type="rectangular" recRef="R1" startPos="55" endPos="57" width="3"/>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<physLoc type="hierarchical" recRef="R6" startPos="25" endPos="25" width="1"/>
]]>
<xs:annotation>
</xs:element>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Point</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
0-dimensional geometric primitive, representing a position, but not having extent. In this declaration, point is limited to a longitude/latitude coordinate system.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<point>
<gridLat>-15.8</gridLat> <gridLon>24.0</gridLon> </point> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Polygon</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The minimum polygon that covers a geographical area, and is delimited by at least 4 points (3 sides), in which the last point coincides with the first point.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<polygon>
<point> <gridLat>-15.8</gridLat> <gridLon>24.0</gridLon> </point> <point> <gridLat>-41.0</gridLat> <gridLon>10.8</gridLon> </point> <point> <gridLat>-15.8</gridLat> <gridLon>10.8</gridLon> </point> <point> <gridLat>-15.8</gridLat> <gridLon>24.0</gridLon> </point> </polygon> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">PostQuestion Text</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Text describing what occurs after the literal question has been asked. This may include forward routing information.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<qstn> <postQTxt>The next set of questions will ask about your financial situation.</postQTxt> </qstn> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<qstn> <postQTxt>If you answered "NO" skip questions 11-14 and go to question 15.</postQTxt> </qstn> </var> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">PreQuestion Text</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Text describing a set of conditions under which a question might be asked. Instructions on cardinality and routing may also be located here, in particular when these instructions are to be read by the interviewee (self-administered questionnaire). The second two examples show this usage.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<qstn> <preQTxt>For those who did not go away on a holiday of four days or more in 1985...</preQTxt> </qstn> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<qstn> <preQTxt>Select only one option.</preQTxt> </qstn> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<qstn> <preQTxt>Answer question number 10, only if Finnish is not your mother tongue.</preQTxt> </qstn> </var> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Processing Status</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Processing status of the file. Some data producers and social science data archives employ data processing strategies that provide for release of data and documentation at various stages of processing. This supports the use of a controlled vocabulary. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<ProcStat>Available from the DDA. Being processed.</ProcStat>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<ProcStat>The principal investigator notes that the data in Public Use Tape 5 are released prior to final cleaning and editing, in order to provide prompt access to the NMES data by the research and policy community.</ProcStat>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Date of Production</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Date when the marked-up document/marked-up document source/data collection/other material(s) were produced (not distributed or archived). The ISO standard for dates (YYYY-MM-DD) is recommended for use with the date attribute. Production date for data collection (codeBook/stdyDscr/citation/prodStmt/prodDate) maps to Dublin Core Date element.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<prodDate date="1999-01-25">January 25, 1999</prodDate>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Place of Production</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Address of the archive or organization that produced the work.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<prodPlac>Ann Arbor, MI: Inter-university Consortium for Political and Social Research</prodPlac>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Production Statement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Part of citation including language, producer, copyright, license, prodDate, prodPlac, software, fundAg, and grantNo. Production statement for the work at the appropriate level: marked-up document; marked-up document source; study; study description, other material; other material for study.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="abbr" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the producer.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the producer with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Distinguishes different stages of involvement in the production process, such as original producer
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the producer.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Type of producer: organization or individual.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Producer</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The producer is the person or organization with the financial or administrative responsibility for the physical processes whereby the document was brought into existence. Use the "role" attribute to distinguish different stages of involvement in the production process, such as original producer. Producer of data collection (codeBook/stdyDscr/citation/prodStmt/producer) maps to Dublin Core Publisher element. The "producer" in the Document Description should be the agency or person that prepared the marked-up document. If the attribute "agentIdentifier" is used, "typeOfAgentIdentifier" should also be provided. Use "isPersistentIdentifier" (true|false) to indicate if this is intended to be a persistent identifier. Use "agentType" to indicate if the agent is an organization or an individual.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<producer abbr="ICPSR" affiliation="Institute for Social Research">Inter-university Consortium for Political and Social Research</producer>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<producer abbr="MNPoll" affiliation="Minneapolis Star Tribune Newspaper" role="original producer">Star Tribune Minnesota Poll</producer>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<producer abbr="MRDC" affiliation="University of Minnesota" role="final production">Machine Readable Data Center</producer>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="sdatrefs" type="xs:IDREFS">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Summary data description references which record the ID values of all elements within the summary data description section of the Study Description which might apply to the nCube. These elements include: time period covered, date of collection, nation or country, geographic coverage, geographic unit, unit of analysis, universe, and kind of data.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
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 nCube. These elements include information on data collection and data appraisal (e.g., sampling, sources, weighting, data cleaning, response rates, and sampling error estimates).
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Link to publication/citation references and records the ID values of all citations elements in Other Study Description Materials or Other Study-Related Materials that pertain to this nCube.
</xhtml:div>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Purpose</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Explains the purpose for which a particular nCube was created.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<nCube>
<purpose>Meets reporting requirements for the Federal Reserve Board</purpose> </nCube> ]]>
<xs:complexContent>
</xs:complexType>
<xs:restriction base="abstractTextType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:restriction>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Directly references a description of the question if entered in another variable.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Used to list the IDs of variables resulting from the question.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Sequence number of the question.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
References the elements in the summary data description section of the Study Description which might apply to this question.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Records the ID values of all elements in the Data Access and Metadata Access section that describe access conditions for this question. These elements include: time period covered, date of collection, nation or country, geographic coverage, geographic unit, unit of analysis, universe, and kind of data.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Added to capture the specific DDI Lifecycle response domain type to facilitate translation between DDI 2 and DDI Lifecycle.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="text"/>
</xs:restriction>
<xs:enumeration value="numeric"/>
<xs:enumeration value="code"/>
<xs:enumeration value="category"/>
<xs:enumeration value="datetime"/>
<xs:enumeration value="geographic"/>
<xs:enumeration value="multiple"/>
<xs:enumeration value="geographicLocationCode"/>
<xs:enumeration value="geographicStructureCode"/>
<xs:enumeration value="scale"/>
<xs:enumeration value="externalCategory"/>
<xs:enumeration value="nominal"/>
<xs:enumeration value="location"/>
<xs:enumeration value="ranking"/>
<xs:enumeration value="distribution"/>
<xs:enumeration value="other"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
A term from a controlled vocabulary, if responseDomainType is given a value of "other".
</xhtml:div>
<xs:annotation>
</xs:element>
</xs:complexType>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Question</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
The question element may have mixed content. The element itself may contain text for the question, with the sub-elements being used to provide further information about the question. Alternatively, the question element may be empty and only the sub-elements used. This is the recommended approach.
</xhtml:p>
<xhtml:p>
The global attribute "ID" (common to all elements) contains a unique identifier for the question. Use of the "ID" is required if you make use of any attribute "qstn" to support a reference from multiple variables, or the backward or forward flow of a questionnaire.
</xhtml:p>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<qstn ID="Q125">When you get together with your friends, would you say you discuss political matters frequently, occasionally, or never?</qstn> </var> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Literal Question</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Text of the actual, literal question asked.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<qstn> <qstnLit>Why didn't you go away in 1985?</qstnLit> </qstn> </var> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:attribute default="INT" name="UNITS">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Integer or real numbers</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="INT"/>
</xs:restriction>
<xs:enumeration value="REAL"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Lowest value that is part of the range</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Lowest value immediately outside the range</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Highest value that is part of the range</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Highest value immediately outside the range</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Value Range</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Empty element consisting only of its attributes, containing the actual range of values.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
For example, x < 1 or 10 <= x < 20 would be expressed as:
</xhtml:div>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<range maxExclusive="1"/>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<range min="10" maxExclusive="20"/>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Should be set to "record".</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Dimensions (of record)</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Information about the physical characteristics of the record including the number of variables (varQnty), number of cases (caseQnty), and record length (logRecL).
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
IDs of the subsidiary record groups which nest underneath; this allows for the encoding of a hierarchical structure of record groups.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of record, e.g., "A records" or "Household records."
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Link to other record types. In a hierarchical study consisting of individual and household records, the "keyvar" on the person record will indicate the household to which it belongs.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Starting column location of the record type indicator variable on each record of the data file.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Width, for files with many different record types.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Type of the indicator variable.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="numeric"/>
</xs:restriction>
<xs:enumeration value="character"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Variable that identifies the record group.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Record or Record Group</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Used to describe record groupings if the file is hierarchical or relational.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<fileStrc type="hierarchical">
<recGrp rectype="Person" keyvar="HHDID"> <labl>CPS 1999 Person-Level Record</labl> <recDimnsn> <varQnty>133</varQnty> <caseQnty>1500</caseQnty> <logRecL>852</logRecL> </recDimnsn> </recGrp> </fileStrc> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Overall Number of Records</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Overall record count in file. Particularly helpful in instances such as files with multiple cards/decks or records per case.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dimensns>
<recNumTot>2400</recNumTot> </dimensns> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Records per Case</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Records per case in the file. This element should be used for card-image data or other files in which there are multiple records per case.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<dimensns>
<recPrCas>5</recPrCas> </dimensns> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="materialReferenceType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Related Materials</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Describes materials related to the study description, such as appendices, additional information on sampling found in other documents, etc. Can take the form of bibliographic citations. This element can contain either PCDATA or a citation or both, and there can be multiple occurrences of both the citation and PCDATA within a single element. May consist of a single URI or a series of URIs comprising a series of citations/references to external materials which can be objects as a whole (journal articles) or parts of objects (chapters or appendices in articles or documents).
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<relMat>Full details on the research design and procedures, sampling methodology, content areas, and questionnaire design, as well as percentage distributions by respondent's sex, race, region, college plans, and drug use, appear in the annual ISR volumes MONITORING THE FUTURE: QUESTIONNAIRE RESPONSES FROM THE NATION'S HIGH SCHOOL SENIORS.</relMat>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<relMat>Current Population Survey, March 1999: Technical Documentation includes an abstract, pertinent information about the file, a glossary, code lists, and a data dictionary. One copy accompanies each file order. When ordered separately, it is available from Marketing Services Office, Customer Service Center, Bureau of the Census, Washington, D.C. 20233.</relMat>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<relMat>A more precise explanation regarding the CPS sample design is provided in Technical Paper 40, The Current Population Survey: Design and Methodology. Chapter 5 of this paper provides documentation on the weighting procedures for the CPS both with and without supplement questions.</relMat>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Related Publications</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Bibliographic and access information about articles and reports based on the data in this collection. Can take the form of bibliographic citations.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<relPubl>Economic Behavior Program Staff. SURVEYS OF CONSUMER FINANCES. Annual volumes 1960 through 1970. Ann Arbor, MI: Institute for Social Research.</relPubl>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<relPubl>Data from the March Current Population Survey are published most frequently in the Current Population Reports P- 20 and P- 60 series. These reports are available from the Superintendent of Documents, U. S. Government Printing Office, Washington, DC 20402. They also are available on the INTERNET at http://www. census. gov. Forthcoming reports will be cited in Census and You, the Monthly Product Announcement (MPA), and the Bureau of the Census Catalog and Guide.</relPubl>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Related Studies</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Information on the relationship of the current data collection to others (e.g., predecessors, successors, other waves or rounds) or to other editions of the same file. This would include the names of additional data collections generated from the same data collection vehicle plus other collections directed at the same general topic. Can take the form of bibliographic citations.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<relStdy>ICPSR distributes a companion study to this collection titled FEMALE LABOR FORCE PARTICIPATION AND MARITAL INSTABILITY, 1980: [UNITED STATES] (ICPSR 9199).</relStdy>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="type" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Used to specify a controlled vocabulary concept. DEPRECATED.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Type of Research Instrument</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The type of data collection instrument used. "Structured" indicates an instrument in which all respondents are asked the same questions/tests, possibly with precoded answers. If a small portion of such a questionnaire includes open-ended questions, provide appropriate comments. "Semi-structured" indicates that the research instrument contains mainly open-ended questions. "Unstructured" indicates that in-depth interviews were conducted. The use of the attribute "type" as a means of specifying a controlled vocabulary concept is DEPRECATED. To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". DDI provides a Controlled Vocabulary for this location: "TypeOfInstrument". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<resInstru>
<concept vocab="TypeOfInstrument" vocabURI="http://rdf-vocabulary.ddialliance.org/cv/TypeOfInstrument/1.1.2/" vocabInstanceCodeTerm="Questionnaire.Structured" xml:lang="it">Questionario strutturato</concept> A structured questionnaire developed by ISTAT </resInstru> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Response Rate</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The percentage of sample members who provided information. This may include a broader description of stratified response rates, information affecting response rates etc.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<respRate>For 1993, the estimated inclusion rate for TEDS-eligible providers was 91 percent, with the inclusion rate for all treatment providers estimated at 76 percent (including privately and publicly funded providers).</respRate>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<respRate>The overall response rate was 82%, although retail firms with an annual sales volume of more than $5,000,000 were somewhat less likely to respond.</respRate>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Response Unit</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Provides information regarding who is intended to provide the information contained within the variable/nCube, e.g., respondent, proxy, interviewer. This element contains the sub-element "concept". DDI provides a Controlled Vocabulary for this location: "ResponseUnit". PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of "concept" now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage. Additional textual description is entered in the mixed text content or using the sub-element "txt".
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<respUnit><concept vocab="IPUMS_ResponseUnit" vocabAgency="IPUMS" vocabInstanceCodeTerm="HouseholdHead">Head of household</concept>If the Head of Household is unavailable the information may be provided by the proxy respondent.</respUnit> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCube>
<respUnit>Head of household</respUnit> </nCube> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Restrictions</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Any restrictions on access to or use of the collection such as privacy certification or distribution restrictions should be indicated here. These can be restrictions applied by the author, producer, or disseminator of the data collection. If the data are restricted to only a certain class of user, specify which type.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<restrctn>In preparing the data file(s) for this collection, the National Center for Health Statistics (NCHS) has removed direct identifiers and characteristics that might lead to identification of data subjects. As an additional precaution NCHS requires, under Section 308(d) of the Public Health Service Act (42 U.S.C. 242m), that data collected by NCHS not be used for any purpose other than statistical analysis and reporting. NCHS further requires that analysts not use the data to learn the identity of any persons or establishments and that the director of NCHS be notified if any identities are inadvertently discovered. ICPSR member institutions and other users ordering data from ICPSR are expected to adhere to these restrictions.</restrctn>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<restrctn>ICPSR obtained these data from the World Bank under the terms of a contract which states that the data are for the sole use of ICPSR and may not be sold or provided to third parties outside of ICPSR membership. Individuals at institutions that are not members of the ICPSR may obtain these data directly from the World Bank.</restrctn>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:simpleType>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="top"/>
</xs:restriction>
<xs:enumeration value="middle"/>
<xs:enumeration value="bottom"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Table Row</xhtml:h1>
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Responsibility Statement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Part of citation covering author (AuthEnty) and collaborators (othID). Responsibility for the creation of the work at the appropriate level: marked-up document; marked-up document source; study; study description, other material; other material for study.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Sampling Procedure</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The type of sample and sample design used to select the survey respondents to represent the population. May include reference to the target sample size and the sampling fraction.To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". DDI provides a Controlled Vocabulary for this location: "SamplingProcedure". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<sampProc>National multistage area probability sample</sampProc>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<sampProc>
<concept vocab="SamplingProcedure" vocabAgency="DDI" vocabURI="http://rdf-vocabulary.ddialliance.org/cv/SamplingProcedure/1.1.4/" vocabInstanceCodeTerm="Probability.SimpleRandom">Simple random sample</concept> </sampProc> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<sampProc>Stratified random sample</sampProc>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<sampProc>Quota sample</sampProc>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<sampProc>The 8,450 women interviewed for the NSFG, Cycle IV, were drawn from households in which someone had been interviewed for the National Health Interview Survey (NHIS), between October 1985 and March 1987.</sampProc>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<sampProc>Samples sufficient to produce approximately 2,000 families with completed interviews were drawn in each state. Families containing one or more Medicaid or uninsured persons were oversampled. XHTML content may be used for formatting.</sampProc>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Security</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Provides information regarding levels of access, e.g., public, subscriber, need to know.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<security date="1998-05-10"> This variable has been recoded for reasons of confidentiality. Users should contact the archive for information on obtaining access.</security> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<security date="1998-05-10">Variable(s) within this nCube have been recoded for reasons of confidentiality. Users should contact the archive for information on obtaining access.</security> </var> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Series Information</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Contains a history of the series and a summary of those features that apply to the series as a whole.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<serInfo>The Current Population Survey (CPS) is a household sample survey conducted monthly by the Census Bureau to provide estimates of employment, unemployment, and other characteristics of the general labor force, estimates of the population as a whole, and estimates of various subgroups in the population. The entire non-institutionalized population of the United States is sampled to obtain the respondents for this survey series.</serInfo>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="abbr" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the series name.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Series Name</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">The name of the series to which the work belongs.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<serName abbr="CPS">Current Population Survey Series</serName>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
A central Internet repository for information on the series.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Series Statement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Series statement for the work at the appropriate level: marked-up document; marked-up document source; study; study description, other material; other material for study. Repeat this field if the study is part of more than one series. Repetition of the internal content should be used to support multiple languages only.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Data Set Availability</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Information on availability and storage of the collection. The "media" attribute may be used in combination with any of the sub-elements. See Location of Data Collection. Use of the "type" attribute has been DEPRECATED. Use the element typeOfSetAvailability.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptType">
</xs:complexContent>
<xs:attribute name="version" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Software version number.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Date (if any) for the software release. ISO standard for dates (YYYY-MM-DD) is recommended
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Software used in Production</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Software used to produce the work. Supports the use of an external controlled vocabulary. DDI provides a Controlled Vocabulary for this location: "SoftwarePackage".
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<docDscr>
<citation> <prodStmt> <software version="1.0">MRDC Codebook Authoring Tool</software> </prodStmt> </citation> </docDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<docDscr>
<citation> <prodStmt> <software version="8.0">Arbortext Adept Editor</software> </prodStmt> </citation> </docDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<docDscr>
<docSrc> <prodStmt> <software version="4.0">PageMaker</software> </prodStmt> </docSrc> </docDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<stdyDscr>
<citation> <prodStmt> <software version="6.12">SAS</software> </prodStmt> </citation> </stdyDscr> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<fileTxt>
<software version="6.12">The SAS transport file was generated by the SAS CPORT procedure.</software> </fileTxt> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:choice>
</xs:choice>
</xs:extension>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Sources Statement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Description of sources used for the data collection. The element is nestable so that the sources statement might encompass a series of discrete source statements, each of which could contain the facts about an individual source. Provides the type of data source used such as Register Records Accounts, Research Data, Biological Samples, etc. Use of an external controlled vocabulary is recommended. DDI provides a Controlled Vocabulary for this location: "DataSourceType". This element maps to Dublin Core Source element.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Source Citation</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This complex element allows the inclusion of a standard citation for the sources used in collecting and creating the dataset.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<sourceCitation>
<titlStmt> <titl>Tenth Decennial Census of the United States, 1880. Volume I. Statistics of the Population of the United States at the Tenth Census.</titl> </titlStmt> <rspStmt> <AuthEnty affiliation="U.S. Department of Commerce">United States Census Bureau</AuthEnty> </rspStmt> <prodStmt> <producer>Government Printing Office</producer> <prodDate>1883</prodDate> </prodStmt> </sourceCitation> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">South Bounding Latitude</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The southernmost coordinate delimiting the geographic extent of the dataset. A valid range of values, expressed in decimal degrees (positive east and positive north), is: -90,0 <=South Bounding Latitude Value <= 90,0 ; South Bounding Latitude Value <= North Bounding Latitude Value
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<southBL>57.987915</southBL>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute default="yes" name="required">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Facilitates machine processing of this element</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="yes"/>
</xs:restriction>
<xs:enumeration value="no"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Number or ID of the form that the user must fill out.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
URN or URL for online access to a special permissions form.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Special Permissions</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This element is used to determine if any special permissions are required to access a resource.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<specPerm formNo="4">The user must apply for special permission to use this dataset locally and must complete a confidentiality form.</specPerm>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Characteristics of Source Noted</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Assessment of characteristics and quality of source material. May not be relevant to survey data. This element may be repeated to support multiple language expressions of the content.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<srcChar>Print source document. Page 26 torn causing loss of some definitional material. Related sources were used to make up for this loss.</srcChar>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Documentation and Access to Sources</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Level of documentation of the original sources. May not be relevant to survey data. This element may be repeated to support multiple language expressions of the content.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Origins of Sources</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
For historical materials, information about the origin(s) of the sources and the rules followed in establishing the sources should be specified. May not be relevant to survey data. To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept. This element may be repeated to support multiple language expressions of the content.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextAndDateType">
</xs:complexContent>
<xs:attribute name="URI" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
URN or URL that can be used to obtain an electronic list of the category codes.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID values of all elements in the Data Access and Metadata Access section that describe access conditions.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Standard Categories</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Standard category codes used in the variable, like industry codes, employment codes, or social class codes. The attribute "date" is provided to indicate the version of the code in place at the time of the study.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<stdCatgry date="1981" source="producer">U. S. Census of Population and Housing, Classified Index of Industries and Occupations </stdCatgry> </var> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="type" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Used to specify a controlled vocabulary concept. DEPRECATED.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Class of the Study</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Generally used to give the data archive's class or study status number, which indicates the processing status of the study. May also be used as a text field to describe processing status. This element may be repeated to support multiple language expressions of the content. The use of the attribute "type" as a means of specifying a controlled vocabulary concept is DEPRECATED. To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<stdyClas>
<concept vocab="ICPSR" vocabURI="http://icpar.umich.edu/ICPSRvocabularies/StudyClass" vocabInstanceURI="http://icpar.umich.edu/ICPSRvocabularies/StudyClass#Class_II">Class_II</concept> ICPSR Class II </stdyClas> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<stdyClas>
<concept vocab="DDA-StudyClass" vocabURI="http://dda.dk/DDAvocabularies/StudyClass" vocabInstanceURI="http://dda.dk/DDAvocabularies/StudyClass#Class_C">Class_C</concept> DDA Class C </stdyClas> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<stdyClas>
<concept vocab="DDA-Processing" vocabURI="http://dda.dk/DDAvocabularies/Processing" vocabInstanceURI="http://dda.dk/DDAvocabularies/Processing#inProcess">inProcess</concept> Available from the DDA. Being processed. </stdyClas> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Study Description</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The Study Description consists of information about the data collection, study, or compilation that the DDI-compliant documentation file describes. This section includes information about how the study should be cited, who collected or compiled the data, who distributes the data, keywords about the content of the data, summary (abstract) of the content of the data, data collection methods and processing, etc. Note that some content of the Study Description's Citation -- e.g., Responsibility Statement -- may be identical to that of the Documentation Citation. This is usually the case when the producer of a data collection also produced the print or electronic codebook for that data collection.
</xhtml:div>
<xs:complexContent>
</xs:complexContent>
</xs:complexType>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Study Development</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Describe the process of study development as a series of development activities. These activities can be typed using a controlled vocabulary. Describe the activity, listing participants with their role and affiliation, resources used (sources of information), and the outcome of the development activity.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:p>
This would allow you to provide inputs for a number of development activities you wanted to capture using separate entry screens and tagged storage of developmentActivity using the type attribute. For example if there was an activity related to data availability the developmentActivity might be as follows:
</xhtml:p>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<developmentActivity type="checkDataAvailability">
<description>A number of potential sources were evaluated for content, consistency and quality</description> <participant affiliation="NSO" role="statistician">John Doe</participant> <resource> <dataSrc>Study S</dataSrc> <srcOrig>Collected in 1970 using unknown sampling method</srcOrig> <srcChar>Information incomplete missing X province</srcChar> </resource> <outcome>Due to quality issues this was determined not to be a viable source of data for the study</outcome> </developmentActivity> ]]>
<xhtml:p>
This generic structure would allow you to designate additional design activities etc.
</xhtml:p>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Used to specify a controlled vocabulary concept. DEPRECATED.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Development Activity</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Information on the development activity including a "description" of the activity, name of each "participant", each "resource" used, and each "outcome" of the activity. Use of the "type" attribute has been DEPRECATED. Use the element "typeOfSetAvailability" which supports the use of a controlled vocabulary. Repeat if multiple language labels are being provided directly within the documentation.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<developmentActivity>
<typeOfDevelopmentActivity vocab="LifecycleEventType" vocabURI="http://rdf-vocabulary.ddialliance.org/cv/LifecycleEventType/1.0.2/">QuestionnaireTranslation</typeOfDevelopmentActivity> <typeOfDevelopmentActivity vocab="DIME Questionnaire Translation" vocabURI="https://dimewiki.worldbank.org/index.php?title=Questionnaire_Translation&oldid=8152">Forward Translation</typeOfDevelopmentActivity> <description>Translation from language A to language B of question and response text. Language experts are used. Translation is tested through round-trip translation practices. Translated question will be tested for response consistency with original language text.</description> <participant affiliation="ISRDI" role="language exert">Ragi Yousef</participant> <resource> <srcCitation> <titlStmt> <titl>Labor Force Survey 2017-2018</titl> </titlStmt> <holding> <URI>https://www.ilo.org/surveyLib/index.php/catalog/2549/related-materials</URI> </holding> </srcCitation> </resource> <outcome>Translated question resulted in valid replication of original language in the round trip test. Translated question resulted in statistically similar results as original language question following testing.</outcome> </developmentActivity> ]]>
<xs:simpleContent>
</xs:complexType>
<xs:extension base="stringType">
</xs:simpleContent>
<xs:attribute name="affiliation" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the participant with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the participant.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Role of the participant.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the participant.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Type of participant: organization or individual.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Participant</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Name of "participant" in the activity being described in the parent element.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Resource</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Resource provides the means of describing an external data source including a "typeOfDataSrc" which supports othe use of an external controllec vocabulary. DDI provides a Controlled Vocabulary for this location: "DataSourceType". Describe the data source using the "dataSrc" field, describe the original data source in "dataOrig" for secondary use data, source characteristics in "scrChar" to identify any particularities of the data source that may affect analysis, and the ability to provide the document source in "srcDocu".
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Date of authorization.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Study Authorization</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Provides structured information on the agency that authorized the study, the date of authorization, and an authorization statement.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<studyAuthorization date="2010-11-04">
<authorizingAgency affiliation="University of Georgia" abbr="HSO">Human Subjects Office</authorizingAgency> <authorizationStatement>Statement of authorization issued by OUHS on 2010-11-04</authorizationStatement> </studyAuthorization> ]]>
<xs:simpleContent>
</xs:complexType>
<xs:extension base="stringType">
</xs:simpleContent>
<xs:attribute name="affiliation" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Institutional affiliation of the authorizing agent or agency.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Abbreviation for the authorizing agent's or agency's name
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the authorizing agency.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of authorizing agency: organization or individual.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Authorizing Agency</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Name of the agent or agency that authorized the study.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<authorizingAgency affiliation="Purdue University" abbr="OUHS">Office for Use of Human Subjects</authorizingAgency>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Authorization Statement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The text of the authorization. Use XHTML to capture significant structure in the document.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<authorizationStatement>Required documentation covering the study purpose, disclosure information, questionnaire content, and consent statements was delivered to the OUHS on 2010-10-01 and was reviewed by the compliance officer. Statement of authorization for the described study was issued on 2010-11-04</authorizationStatement>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Study Scope</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This section contains information about the data collection's scope across several dimensions, including substantive content, geography, and time.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:extension>
<xs:element maxOccurs="unbounded" minOccurs="0" ref="standardsCompliance"/>
</xs:sequence>
<xs:element maxOccurs="unbounded" minOccurs="0" name="otherQualityStatement" type="simpleTextType"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Quality Statement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This structure consists of two parts, "standardsCompliance" and "otherQualityStatements". In "standardsCompliance" list all specific standards complied with during the execution of this study. Note the standard name and producer and how the study complied with the standard. Enter any additional quality statements in "otherQualityStatement".
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:extension>
<xs:element ref="standard"/>
</xs:sequence>
<xs:element maxOccurs="unbounded" minOccurs="0" name="complianceDescription" type="simpleTextType"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Standards Compliance</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This section lists all specific standards complied with during the execution of this study. Specify the standard(s)' name(s) and producer(s) in the complex element "standard" and describe how the study complied with each standard in "complianceDescription". Enter any additional quality statements in "otherQualityStatement" of the parent element.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<standardsCompliance>
<standard> <standardName>Data Documentation Initiative</standardName> <producer>DDI Alliance</producer> </standard> <complianceDescription>Study metadata was created in compliance with the Data Documentation Initiative (DDI) standard</complianceDescription> </standardsCompliance> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Standard</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Describes a standard with which the study complies. Specify the name of the standard using "standardName" and producer of the standard with "producer.
</xhtml:div>
<xs:simpleContent>
</xs:complexType>
<xs:extension base="stringType">
</xs:simpleContent>
<xs:attribute name="date" type="dateSimpleType" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Specifies the date when the standard was published
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Includes the specific version of the standard with which the study is compliant.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">URI for the actual standard.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Standard Name</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Contains the name of the standard with which the study complies.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<standardName date="2009-10-18" version="3.1" URI="http://www.ddialliance.org/Specification/DDI-Lifecycle/3.1/">Data Documentation Initiative</standardName>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Holds the date the evaluation was completed.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Post Evaluation Procedures</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Use this section to describe evaluation procedures not address in data evaluation processes. These may include issues such as timing of the study, sequencing issues, cost/budget issues, relevance, institutional or legal arrangements etc. of the study. The type attribute has been DEPRECATED. Use the element typeOfExPostEvaluation to identify the type of evaluation with or without the use of a controlled vocabulary.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<exPostEvaluation completionDate="2003" type="comprehensive">
<typeOfExPostEvaluation>comprehensive</typeOfExPostEvaluation> <evaluator affiliation="United Nations" abbr="UNSD" role="consultant">United Nations Statistical Division</evaluator> <evaluationProcess>In-depth review of pre-collection and collection procedures</evaluationProcess> <outcomes>The following steps were highly effective in increasing response rates, and should be repeated in the next collection cycle...</outcomes> </exPostEvaluation> ]]>
<xs:simpleContent>
</xs:complexType>
<xs:extension base="stringType">
</xs:simpleContent>
<xs:attribute name="affiliation" type="xs:string" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the evaluator with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Abbreviation for the evaluator.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
The role played by the individual or organization in the evaluation process.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the evaluator.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Type of evaluator: organization or individual.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Evaluator Type</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The evaluator element identifies persons or organizations involved in the evaluation process.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<evaluator affiliation="United Nations" abbr="UNSD" role="consultant">United Nations Statistical Division</evaluator>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Evaluation Process</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Describes the evaluation process followed. Use the contained "concept" element when a controlled vocabulary is used.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<evaluationProcess>
<concept>meta-evaluation</concept> An evaluation of the quality of this series of evaluations and its adherence to established good practice in evaluation. It is based on and presents summaries of existing evaluations of each instrument. </evaluationProcess> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Evaluation Outcomes</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Describe the outcomes of the evaluation.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<outcomes>The following steps were highly effective in increasing response rates, and should be repeated in the next collection cycle...</outcomes>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Study Budget</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Describe the budget of the project in as much detail as needed. Use XHTML structure elements to identify discrete pieces of information in a way that facilitates direct transfer of information on the study budget between DDI 2 and DDI Lifecycle structures.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<studyBudget>The budget for the study covers a 5 year award period distributed between direct and indirect costs including: Staff, ...</studyBudget>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Subtitle</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
A secondary title used to amplify or state certain limitations on the main title. It may repeat information already in the main title.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<titl>Monitoring the Future: A Continuing Study of American Youth, 1995</titl>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<subTitl>A Continuing Study of American Youth, 1995</subTitl>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<titl>Census of Population, 1950 [United States]: Public Use Microdata Sample</titl>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<subTitl>Public Use Microdata Sample</subTitl>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Subject Information</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Subject information describing the data collection's intellectual content. Supports the use of a list of keyword and a list of topic classifications.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Summary Data Description</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
Information about the collection situation, data format, universe, geographic coverage of the study, and unit of analysis.
</xhtml:p>
<xhtml:p>
Replication of the element geoBndBox is NOT recommended. The purpose of a bounding box is to support high level geographic point search systems. Most search systems of this type do not handle multiple instances of a bounding box. The bounding box should represent the full geographic coverage extent of the of the overall datasets being described by the Codebook instance. If there is a desire to provide the equivalent of a bounding box for each of multiple summary descriptions, use of the boundPoly is recommended. First provide a geoBndBox for the full area covered by the study. Then provide a boundPoly for each geographic area defined with a separate sumDscr. Note that when describing a bounding box using a boundPoly description the four corner points are described. The starting point and end point should match (closing the polygon).
</xhtml:p>
<xhtml:p>
Replication of sumDscr within the parent stdyInfo is useful when bundling specifics like timePrd, nation, and universe for specific samples within a larger project. A clear example of this is description for the various IPUMS project that harmonize multiple samples of census, health, and related data. IPUMS identified the coverage of individual samples within a project using a combination of these three elements to be able to differentiate between samples.
</xhtml:p>
<xhtml:p>
The examples in this description show the use of sumDscr to bundle specifics regarding timePrd, nation, and universe. A new sumDscr is used for each bundle.
</xhtml:p>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<stdyInfo>
<sumDscr> <timePrd date="2014">2014</timePrd> <nation>Burkino Faso</nation> <universe>Women</universe> </sumDscr> <sumDscr> <timePrd date="2014">2014</timePrd> <nation>Burkino Faso</nation> <universe>Children</universe> </sumDscr> <sumDscr> <timePrd date="2018">2018</timePrd> <nation>Burkino Faso</nation> <universe>Women</universe> </sumDscr> <sumDscr> <timePrd date="2018">2018</timePrd> <nation>India</nation> <universe>Women</universe> </sumDscr> </stdyInfo> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute default="not-wgtd" name="wgtd">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Statistics are weighted or not.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="wgtd"/>
</xs:restriction>
<xs:enumeration value="not-wgtd"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Reference to the variable(s) containing the weight used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID of the weight element(s) in the data collection description where multiple variables use the same weight (such as a 10% sample).
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of statistics being shown: mean, median, mode, valid cases, invalid cases, minimum, maximum, or standard deviation.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="mean"/>
</xs:restriction>
<xs:enumeration value="medn"/>
<xs:enumeration value="mode"/>
<xs:enumeration value="vald"/>
<xs:enumeration value="invd"/>
<xs:enumeration value="min"/>
<xs:enumeration value="max"/>
<xs:enumeration value="stdev"/>
<xs:enumeration value="other"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID values of all elements in the Data Access and Metadata Access section that describe access conditions for this statistic.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
A value taken from a controlled vocabulary, if option for type is given a value of "other". This option should only be used when applying a controlled vocabulary to this attribute. Use the complex element controlledVocabUsed to identify the controlled vocabulary to which the selected term belongs.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Summary Statistics</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:div class="description">
</xhtml:div>
One or more statistical measures that describe the responses to a particular variable and may include one or more standard summaries, e.g., minimum and maximum values, median, mode, etc.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<sumStat type="min">0</sumStat> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<sumStat type="max">9</sumStat> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<sumStat type="median">4</sumStat> </var> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:simpleType>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="top"/>
</xs:restriction>
<xs:enumeration value="bottom"/>
<xs:enumeration value="topbot"/>
<xs:enumeration value="all"/>
<xs:enumeration value="sides"/>
<xs:enumeration value="none"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Table</xhtml:h1>
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:simpleType>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="top"/>
</xs:restriction>
<xs:enumeration value="middle"/>
<xs:enumeration value="bottom"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Table Body</xhtml:h1>
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:simpleType>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="left"/>
</xs:restriction>
<xs:enumeration value="right"/>
<xs:enumeration value="center"/>
<xs:enumeration value="justify"/>
<xs:enumeration value="char"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Table Group</xhtml:h1>
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:simpleType>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="top"/>
</xs:restriction>
<xs:enumeration value="middle"/>
<xs:enumeration value="bottom"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Table Head</xhtml:h1>
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="method" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Used to specify a controlled vocabulary concept. DEPRECATED.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Time Method</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The time method or time dimension of the data collection. The use of the attribute "method" as a means of specifying a controlled vocabulary concept is DEPRECATED. To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept. DDI provides a Controlled Vocabulary for this location: "TimeMethod". For forward-compatibility, DDI Lifecycle XHTML tags may be used in this element.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<timeMeth>
<concept vocab="TimeMethod" vocabURI="http://rdf-vocabulary.ddialliance.org/cv/TimeMethod/1.2.3/" vocabInstanceURI="http://rdf-vocabulary.ddialliance.org/cv/TimeMethod/1.2.3/91403e2" vocabInstanceCodeTerm="Longitudinal.Panel">Longitudinal: Panel</concept> panel survey </timeMeth> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<timeMeth>
<concept vocab="TimeMethod" vocabURI="http://rdf-vocabulary.ddialliance.org/cv/TimeMethod/1.2.3/" vocabInstanceURI="http://rdf-vocabulary.ddialliance.org/cv/TimeMethod/1.2.3/01558f3" vocabInstanceCodeTerm="CrossSection">Cross-Section</concept> cross-section </timeMeth> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<timeMeth>
<concept vocab="TimeMethod" vocabURI="http://rdf-vocabulary.ddialliance.org/cv/TimeMethod/1.2.3/" vocabInstanceURI="http://rdf-vocabulary.ddialliance.org/cv/TimeMethod/1.2.3/8470cc4" vocabInstanceCodeTerm="Longitudinal.TrendRepeatedCrossSection">Longitudinal: Trend/Repeated cross-section</concept> trend study </timeMeth> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<timeMeth>
<concept vocab="TimeMethod" vocabURI="http://rdf-vocabulary.ddialliance.org/cv/TimeMethod/1.2.3/" vocabInstanceURI="http://rdf-vocabulary.ddialliance.org/cv/TimeMethod/1.2.3/c4efcd7" vocabInstanceCodeTerm="TimeSeries">Time Series</concept> time-series </timeMeth> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextAndDateType">
</xs:complexContent>
<xs:attribute default="single" name="event">
</xs:extension>
<xs:annotation>
</xs:annotation>
</xs:attribute>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="start"/>
</xs:restriction>
<xs:enumeration value="end"/>
<xs:enumeration value="single"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Relevant cycle, wave, or round of data.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Time Period Covered</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The time period to which the data refer. This item reflects the time period covered by the data, not the dates of coding or making documents machine-readable or the dates the data were collected. Also known as span. Maps to Dublin Core element "Coverage". Inclusion of this element is recommended.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<timePrd event="start" date="1998-05-01">May 1, 1998</timePrd>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<timePrd event="end" date="1998-05-31">May 31, 1998</timePrd>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Title</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Full authoritative title for the work at the appropriate level: marked-up document; marked-up document source; study; other material(s) related to study description; other material(s) related to study. The study title will in most cases be identical to the title for the marked-up document. A full title should indicate the geographic scope of the data collection as well as the time period covered. Title of data collection (codeBook/stdyDscr/citation/titlStmt/titl) maps to Dublin Core Title element. This element is required in the Study Description citation.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<titl>Domestic Violence Experience in Omaha, Nebraska, 1986-1987</titl>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<titl>Census of Population, 1950 [United States]: Public Use Microdata Sample</titl>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<titl>Monitoring the Future: A Continuing Study of American Youth, 1995</titl>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Title Statement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Title statement covers title (titl), subtitle (subTitl), alternative title (altTitl), parallel title (parTitl), and ID Number (IDNo). Title statement for the work at the appropriate level: marked-up document; marked-up document source; study; study description, other materials; other materials for study.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Topic Classification</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The classification field indicates the broad substantive topic(s) that the data cover. Library of Congress subject terms may be used here. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<topcClas vocab="LOC Subject Headings" vocabURI="http://www.loc.gov/catdir/cpso/lcco/lcco.html" vocabInstanceURI="http://www.loc.gov/catdir/cpso/lcco/lcco#PublicOpinion--California--Statistics">Public opinion -- California -- Statistics</topcClas>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<topcClas vocab="LOC Subject Headings" vocabURI="http://www.loc.gov/catdir/cpso/lcco/lcco.html" vocabInstanceURI="http://www.loc.gov/catdir/cpso/lcco/lcco#Elections--California">Elections -- California</topcClas>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Total Responses</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The number of responses to this variable. This element might be used if the number of responses does not match added case counts. It may also be used to sum the frequencies for variable categories.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<TotlResp>1,056</TotlResp> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<TotlResp>There are only 725 responses to this question since it was not asked in Tanzania.</TotlResp> </var> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="tableAndTextType">
</xs:complexContent>
<xs:attribute name="level" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Level to which the element applies.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Points to information in the study description such as specific dates, universes, or other identifiable information in a space delimited array of IDs.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Descriptive Text</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Lengthier description of the parent element.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<varGrp type="subject">
<txt>The following five variables refer to respondent attitudes toward national environmental policies: air pollution, urban sprawl, noise abatement, carbon dioxide emissions, and nuclear waste.</txt> </varGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCubeGrp type="subject">
<txt>The following four nCubes are grouped to present a cross tabulation of the variables Sex, Work experience in 1999, and Income in 1999.</txt> </nCubeGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<txt>Total population for the agency for the year reported.</txt> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catgryGrp>
<txt>When the respondent indicated his political party reference, his response was coded on a scale of 1-99 with parties with a left-wing orientation coded on the low end of the scale and parties with a right-wing orientation coded on the high end of the scale. Categories 90-99 were reserved miscellaneous responses.</txt> </catgryGrp> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<catgry>
<txt>Inap., question not asked in Ireland, Northern Ireland, and Luxembourg.</txt> </catgry> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCube>
<txt>Detailed poverty status for age cohorts over a period of five years, to be used in determining program eligibility.</txt> </nCube> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<otherMat URI="http://www.icpsr.umich.edu/..">
<txt>This is a PDF version of the original questionnaire provided by the principal investigator.</txt> </otherMat> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<otherMat>
<txt>Glossary of Terms. Below are terms that may prove useful in working with the technical documentation for this study.</txt> </otherMat> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<otherMat>
<txt>This is a PDF version of the original questionnaire provided by the principal investigator.</txt> </otherMat> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Type of Access</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The applied use of the element is found in the parent item. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Type of Codeing Instruction</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The applied use of the element is found in the parent item. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Type of Data Source</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The applied use of the element is found in the parent item. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Type of Development Activity</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The applied use of the element is found in the parent item. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Type of ExPost Evaluation</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The applied use of the element is found in the parent item. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Type of Other Material</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The applied use of the element is found in the parent item. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Type of Set Availability</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The applied use of the element is found in the parent item. PLEASE NOTE A CHANGE IN USAGE INSTRUCTIONS: The string content of the element now contains the language specific label obtained from the controlled vocabulary. This allows for multiple languages through the repeated entry of the "concept" element. See the high level documentation for a complete description of usage.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">List of Undocumented Codes</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Values whose meaning is unknown.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<undocCod>Responses for categories 9 and 10 are unavailable.</undocCod> </var> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="conceptualTextType">
</xs:complexContent>
<xs:attribute name="level" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Coding of the level to which universe applies, i.e., the study level, the file level (if different from study), the record group, the variable group, the nCube group, the variable, or the nCube level.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Groups included (I) in or excluded (E) from the universe.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="I"/>
</xs:restriction>
<xs:enumeration value="E"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Universe</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The group of persons or other elements that are the object of research and to which any analytic results refer. Age, nationality, and residence commonly help to delineate a given universe, but any of a number of factors may be involved, such as sex, race, income, veteran status, criminal convictions, etc. The universe may consist of elements other than persons, such as housing units, court cases, deaths, countries, etc. In general, it should be possible to tell from the description of the universe whether a given individual or element (hypothetical or real) is a member of the population under study. If all the variables/nCubes described in the data documentation relate to the same population, e.g., the same set of survey respondents, this element would be unnecessary at data description level. In this case, universe can be fully described at the study level. For forward-compatibility, DDI Lifecycle XHTML tags may be used in this element. This element may be repeated only to support multiple language expressions of the content. To specify the use of a Controlled Vocabulary or standard concept use the internal element "concept". If multiple concepts are needed the parent element should be replicated. Internal text related to each concept should be allocated to accompany the relevant concept.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<universe clusion="I">
<concept>Persons</concept><concept>15-19 years of age</concept> Individuals 15-19 years of age. </universe> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<universe clusion="E">Individuals younger than 15 and older than 19 years of age.</universe>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Use Statement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Information on terms of use for the data collection. This element may be repeated only to support multiple language expressions of the content.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:extension>
<xs:choice maxOccurs="unbounded" minOccurs="1">
</xs:choice>
</xs:sequence>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID values of all elements in the Data Access and Metadata Access section that describe access conditions for this range.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Range of Valid Data Values</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Values for a particular variable that represent legitimate responses. The attribute "access" records the ID values of all elements in the Data Access and Metadata Access section that describe access conditions for this range.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<valrng>
<range min="1" max="3"/> </valrng> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<valrng>
<item VALUE="1"/> <item VALUE="2"/> <item VALUE="3"/> </valrng> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Contains the so-called "short label" for the variable, limited to eight characters in many statistical analysis systems such as SAS or SPSS.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Whether the variable is a weight.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="wgt"/>
</xs:restriction>
<xs:enumeration value="not-wgt"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Reference to the variable(s) containing the weight used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
References the weight description(s) from dataColl for this variable. Use when a specific overall weight is designated such as with a 10% sample where all items are weighted x10.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Reference to the question ID when the question itself is entered in another variable.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">ID of the file(s) to which the variable belongs.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Origin of the proprietary format and includes SAS, SPSS, ANSI, and ISO.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Number of decimal points in the variable.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Interval type; options are discrete or continuous.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="contin"/>
</xs:restriction>
<xs:enumeration value="discrete"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID of the record type to which the variable belongs.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Summary data description references which record the ID values of all elements within the summary data description section of the Study Description which might apply to the variable. These elements include: time period covered, date of collection, nation or country, geographic coverage, geographic unit, unit of analysis, universe, and kind of data.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
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 variable. These elements include information on data collection and data appraisal (e.g., sampling, sources, weighting, data cleaning, response rates, and sampling error estimates).
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Link to publication/citation references and records the ID values of all citations elements within Other Study Description Materials or Other Study-Related Materials that pertain to this variable.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID values of all elements in the Data Access and Metadata Access section that describe access conditions for this variable.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of aggregation method used, for example 'sum', 'average', 'count'. If a value of "other" is given a term from a controlled vocabulary should be used in the "otherAggrMeth" attribute.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="sum"/>
</xs:restriction>
<xs:enumeration value="average"/>
<xs:enumeration value="count"/>
<xs:enumeration value="mode"/>
<xs:enumeration value="median"/>
<xs:enumeration value="maximum"/>
<xs:enumeration value="minimum"/>
<xs:enumeration value="percent"/>
<xs:enumeration value="other"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
A value from a controlled vocabulary when the aggrMeth attribute has a value of "other".This option should only be used when applying a controlled vocabulary to this attribute. Use the complex element controlledVocabUsed to identify the controlled vocabulary to which the selected term belongs. DDI provides a Controlled Vocabulary for this location: "AggregationMethod"
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Measurement unit, for example 'km', 'miles', etc.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Unit of scale, for example 'x1', 'x1000', etc.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Point of origin for anchored scales.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Nature (measurement level) of the variable.</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="nominal"/>
</xs:restriction>
<xs:enumeration value="ordinal"/>
<xs:enumeration value="interval"/>
<xs:enumeration value="ratio"/>
<xs:enumeration value="percent"/>
<xs:enumeration value="other"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
A value from a controlled vocabulary. Use the complex element controlledVocabUsed to identify the controlled vocabulary to which the selected term belongs.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Type of additivity</xhtml:div>
</xs:documentation>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="stock"/>
</xs:restriction>
<xs:enumeration value="flow"/>
<xs:enumeration value="non-additive"/>
<xs:enumeration value="other"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
A value from a controlled vocabulary, used only when the "additivity" attribute has a value of "other". Use the complex element controlledVocabUsed to identify the controlled vocabulary to which the selected term belongs.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Whether the variable relays time-related information.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="Y"/>
</xs:restriction>
<xs:enumeration value="N"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Whether the variable relays geographic information.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="Y"/>
</xs:restriction>
<xs:enumeration value="N"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates the name of the controlled vocabulary, if any, used in the element, e.g., LCSH (Library of Congress Subject Headings), MeSH (Medical Subject Headings), etc.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Number of categories found in the variable, and is used primarily for aggregate data files for verifying cell counts in nCubes.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Captures the specific DDI Lifecycle representation type to facilitate translation between DDI 2 and DDI Lifecycle. If the "other" value is used, a term from a controlled vocabulary may be supplied in the otherRepresentationType attribute.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="text"/>
</xs:restriction>
<xs:enumeration value="numeric"/>
<xs:enumeration value="code"/>
<xs:enumeration value="datetime"/>
<xs:enumeration value="geographicLocationCode"/>
<xs:enumeration value="geographicStructureCode"/>
<xs:enumeration value="scale"/>
<xs:enumeration value="other"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
A value from a controlled vocabulary, should be used when the representationType attribute has a value of "other". Use the complex element controlledVocabUsed to identify the controlled vocabulary to which the selected term belongs.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Variable</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
This element describes all of the features of a single variable in a social science data file. The following elements are repeatable to support multi-language content: anlysUnit, embargo, imputation, respUnit, security, TotlResp.
</xhtml:div>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute default="numeric" name="type">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicates if the variable is character or numeric.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="character"/>
</xs:restriction>
<xs:enumeration value="numeric"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
In some cases, it may provide the name of the particular, proprietary format actually used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Identifies the vendor or standards body that defined the format.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="SAS"/>
</xs:restriction>
<xs:enumeration value="SPSS"/>
<xs:enumeration value="IBM"/>
<xs:enumeration value="ANSI"/>
<xs:enumeration value="ISO"/>
<xs:enumeration value="XML-Data"/>
<xs:enumeration value="other"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
A value from a controlled vocabulary, if the schema attribute is given a value of "other". The complex element controlledVocabUsed should be used to identify the controlled vocabulary to which the selected term belongs.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Describes what kind of data the format represents.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="date"/>
</xs:restriction>
<xs:enumeration value="time"/>
<xs:enumeration value="currency"/>
<xs:enumeration value="other"/>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
A value from a controlled vocabulary, if the category attribute is given a value of "other". The complex element controlledVocabUsed should be used to identify the controlled vocabulary to which the selected term belongs. DDI provides several Controlled Vocabularies for this location dependent upon the data being described: "DataType", "DateType", and "NumericType".
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">A network identifier for the format definition.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Variable Format</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">The technical format of the variable in question.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<var>
<varFormat type="numeric" schema="SAS" formatname="DATE" category="date">The number in this variable is stored in the form 'ddmmmyy' in SAS format.</varFormat> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<varFormat type="numeric" formatname="date.iso8601" schema="XML-Data" category="date" URI="http://www.w3.org/TR/1998/NOTE-XML-data/">19541022</varFormat> </var> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:sequence>
</xs:sequence>
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
<xhtml:p>
</xhtml:div>
General type of grouping of the variables, e.g., subject, multiple response. Use the value of "other" if the value is to come from an external controlled vocabulary, and place the term into the otherType attribute.
</xhtml:p>
<xhtml:p>
Specific variable groups, included included in this attribute, are:
</xhtml:p>
<xhtml:p>
- section: Questions which derive from the same section of the questionnaire, e.g., all variables located in Section C.
</xhtml:p>
<xhtml:p>
- multiple response: Questions where the respondent has the opportunity to select more than one answer from a variety of choices, e.g., what newspapers have you read in the past month (with the respondent able to select up to five choices).
</xhtml:p>
<xhtml:p>
- grid: Sub-questions of an introductory or main question but which do not constitute a multiple response group, e.g., I am going to read you some events in the news lately and you tell me for each one whether you are very interested in the event, fairly interested in the fact, or not interested in the event.
</xhtml:p>
<xhtml:p>
- display: Questions which appear on the same interview screen (CAI) together or are presented to the interviewer or respondent as a group.
</xhtml:p>
<xhtml:p>
- repetition: The same variable (or group of variables) which are repeated for different groups of respondents or for the same respondent at a different time.
</xhtml:p>
<xhtml:p>
- subject: Questions which address a common topic or subject, e.g., income, poverty, children.
</xhtml:p>
<xhtml:p>
- version: Variables, often appearing in pairs, which represent different aspects of the same question, e.g., pairs of variables (or groups) which are adjusted/unadjusted for inflation or season or whatever, pairs of variables with/without missing data imputed, and versions of the same basic question.
</xhtml:p>
<xhtml:p>
- iteration: Questions that appear in different sections of the data file measuring a common subject in different ways, e.g., a set of variables which report the progression of respondent income over the life course.
</xhtml:p>
<xhtml:p>
- analysis: Variables combined into the same index, e.g., the components of a calculation, such as the numerator and the denominator of an economic statistic.
</xhtml:p>
<xhtml:p>
- pragmatic: A variable group without shared properties.
</xhtml:p>
<xhtml:p>
- record: Variable from a single record in a hierarchical file.
</xhtml:p>
<xhtml:p>
- file: Variable from a single file in a multifile study.
</xhtml:p>
<xhtml:p>
- randomized: Variables generated by CAI surveys produced by one or more random number variables together with a response variable, e.g., random variable X which could equal 1 or 2 (at random) which in turn would control whether Q.23 is worded "men" or "women", e.g., would you favor helping [men/women] laid off from a factory obtain training for a new job?
</xhtml:p>
<xhtml:p>
- other: Variables which do not fit easily into any of the categories listed above, e.g., a group of variables whose documentation is in another language.
</xhtml:p>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="section"/>
</xs:restriction>
<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:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
A value from a controlled vocabulary, if the type attribute was given a value of "other". This option should only be used when applying a controlled vocabulary to this attribute. Use the complex element controlledVocabUsed to identify the controlled vocabulary to which the selected term belongs.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Space delimited list of the IDs of all the variables that are immediate children of the variable group.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Space delimited list of the IDs of all the variable groups that are immediate children of the variable group. The inclusion of a varGrp brings in all of its members. Members of the included varGrp should not be separately listed in either "var" or "varGrp".
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">A name, or short label, for the group.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
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.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
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).
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Link to publication/citation references and records the ID values of all citations elements within codeBook/stdyDscr/othrStdyMat or codeBook/otherMat that pertain to this variable group.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
ID values of all elements in codeBook/stdyDscr/dataAccs or codeBook/stdyDscr/metadataAccs of the document that describe access conditions for this variable group.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Included in 2.0 and subsequent versions in ERROR. DO NOT USE THIS ATTRIBUTE. It is retained only for purposes of backward-compatibility. DEPRECATED.
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Variable Group</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
A group of variables that may share a common subject, arise from the interpretation of a single question, or are linked by some other factor.
</xhtml:p>
<xhtml:p>
Variable groups are created this way in order to permit variables to belong to multiple groups, including multiple subject groups such as a group of variables on sex and income, or to a subject and a multiple response group, without causing overlapping groups. Variables that are linked by use of the same question need not be identified by a Variable Group element because they are linked by a common unique question identifier in the Variable element. Note that as a result of the strict sequencing required by XML, all Variable Groups must be marked up before the Variable element is opened. That is, the mark-up author cannot mark up a Variable Group, then mark up its constituent variables, then mark up another Variable Group.
</xhtml:p>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:complexContent>
<xs:attribute name="start" type="xs:IDREF" use="optional">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">ID of the first variable.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">ID of the last variable.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Variable Range</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
<xhtml:p>
</xhtml:div>
Reference to the ID of the first and last variable (start and end) of the range of variables used by the derivation.
</xhtml:p>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<varRange start="V1" end="V3"/>
]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Overall Variable Count</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">Number of variables.</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<varQnty>27</varQnty>
]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextType">
</xs:complexContent>
<xs:attribute name="affiliation" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Affiliation of the authoring entity with an agency or organization.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">Identifier of the authoring entity.</xhtml:div>
</xs:documentation>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of identifier, should be provided if agentIdentifier is used.
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Indicate if the agent identifier is intended to be a persistent identifier
</xhtml:div>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Type of authoring entity: organization or individual.
</xhtml:div>
<xs:restriction base="xs:NMTOKEN">
</xs:simpleType>
<xs:enumeration value="organization"/>
</xs:restriction>
<xs:enumeration value="individual"/>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Version Responsibility Statement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The organization or person responsible for the version of the work.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<verResp>Zentralarchiv fuer Empirische Sozialforschung</verResp>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<verResp>Inter-university Consortium for Political and Social Research</verResp>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<verStmt> <verResp>Zentralarchiv fuer Empirische Sozialforschung</verResp> </verStmt> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCube>
<verStmt> <verResp>Zentralarchiv fuer Empirische Sozialforschung</verResp> </verStmt> </nCube> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="baseElementType">
</xs:extension>
</xs:complexContent>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Version Statement</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Version statement for the work at the appropriate level: marked-up document; marked-up document source; study; study description, other material; other material for study. A version statement may also be included for a data file, a variable, or an nCube.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<verStmt>
<version type="version" date="1999-01-25">Second version</version> </verStmt> ]]>
<xs:complexContent>
</xs:complexType>
<xs:extension base="simpleTextAndDateType">
</xs:complexContent>
<xs:attribute name="type" type="xs:string">
</xs:extension>
<xs:annotation>
</xs:attribute>
<xs:documentation>
</xs:annotation>
<xhtml:div class="description">
</xs:documentation>
Identifies a specific type of version. This does not support the use of a controlled vocabulary
</xhtml:div>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Version</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
Also known as release or edition. If there have been substantive changes in the data/documentation since their creation, this statement should be used at the appropriate level.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<version type="edition" date="1999-01-25">Second ICPSR Edition</version>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<var>
<verStmt> <version type="development" date="1999-01-25">Second version of V25</version> </verStmt> </var> ]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<nCube>
<verStmt> <version type="update" date="1999-01-25">Second version of N25</version> </verStmt> </nCube> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">Weighting</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The use of sampling procedures may make it necessary to apply weights to produce accurate statistical results. Describe here the criteria for using weights in analysis of a collection. If a weighting formula or coefficient was developed, provide this formula, define its elements, and indicate how the formula is applied to data.
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<weight>The 1996 NES dataset includes two final person-level analysis weights which incorporate sampling, nonresponse, and post-stratification factors. One weight (variable #4) is for longitudinal micro-level analysis using the 1996 NES Panel. The other weight (variable #3) is for analysis of the 1996 NES combined sample (Panel component cases plus Cross-section supplement cases). In addition, a Time Series Weight (variable #5) which corrects for Panel attrition was constructed. This weight should be used in analyses which compare the 1996 NES to earlier unweighted National Election Study data collections.</weight>
]]>
<xhtml:samp class="xml_sample">
<![CDATA[
</xhtml:samp>
<weight>
<concept>PropensityWeighting</concept> The weight was determined using the online opt-in sample, the entire population of a synthetic dataset, and a statistical model to estimate the probability of a case occurring in either the synthetic or opt-in dataset. </weight> ]]>
<xs:annotation>
</xs:element>
<xs:documentation>
</xs:annotation>
<xhtml:div>
</xs:documentation>
<xhtml:h1 class="element_title">West Bounding Longitude</xhtml:h1>
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Description</xhtml:h2>
</xhtml:div>
<xhtml:div class="description">
The westernmost coordinate delimiting the geographic extent of the dataset. A valid range of values, expressed in decimal degrees (positive east and positive north), is: -180,0 <=West Bounding Longitude Value <= 180,0
</xhtml:div>
<xhtml:div>
<xhtml:h2 class="section_header">Example</xhtml:h2>
</xhtml:div>
<xhtml:div class="example">
<xhtml:samp class="xml_sample">
</xhtml:div>
<![CDATA[
</xhtml:samp>
<westBL>4.789583</westBL>
]]>
</xs:schema>
|
XML schema documentation generated with DocFlex/XML 1.12 using DocFlex/XML XSDDoc 2.9.0 template set |