| All Element Summary | ||||||||||
| abstract | 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.
|
|||||||||
| accsPlac | Location of Data Collection Description Location where the data collection is currently stored.
|
|||||||||
| actMin | Actions to Minimize Losses Description Summary of actions taken to minimize data loss.
|
|||||||||
| algorithmSpecification |
|
|||||||||
| algorithmVersion |
|
|||||||||
| altTitl | Alternative Title Description A title by which the work is commonly referred, or an abbreviation of the title.
|
|||||||||
| anlyInfo | Data Appraisal Description Information on data appraisal.
|
|||||||||
| anlysUnit | Analysis Unit Description Provides information regarding whom or what the variable/nCube describes.
|
|||||||||
| anlyUnit | Unit of Analysis Description Basic unit of analysis or observation that the file describes: individuals, families/households, groups, institutions/organizations, administrative units, etc.
|
|||||||||
| attribute | Attribute Description Identifies an attribute within the element(s) identified by the selector or specificElements in which the controlled vocabulary is used.
|
|||||||||
| AuthEnty | Authoring Entity/Primary Investigator Description The person, corporate body, or agency responsible for the work's substantive and intellectual content.
|
|||||||||
| authorizationStatement | Authorization Statement Description The text of the authorization.
|
|||||||||
| authorizingAgency | Authorizing Agency Description Name of the agent or agency that authorized the study.
|
|||||||||
| avlStatus | Availability Status Description Statement of collection availability.
|
|||||||||
| backward | Backflow Description Contains a reference to IDs of possible preceding questions.
|
|||||||||
| biblCit | Bibliographic Citation Description Complete bibliographic reference containing all of the standard elements of a citation that can be used to cite the work.
|
|||||||||
| boundPoly | 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.
|
|||||||||
| caseQnty | Number of cases / Record Quantity Description Number of cases or observations.
|
|||||||||
| catgry | Category Description A description of a particular response.
|
|||||||||
| catgryGrp | Category Group Description A description of response categories that might be grouped together.
|
|||||||||
| catLevel | Category Level Description Used to describe the levels of the category hierarchy.
|
|||||||||
| catStat | Category Level Statistic Description May include frequencies, percentages, or crosstabulation results.
|
|||||||||
| catValu | Category Value Description The explicit response.
|
|||||||||
| citation | Bibliographic Citation Description This element encodes the bibliographic information for the work at the level specified: (1) Document Description, Citation (of Marked-up Document), (2) Document Description, Citation (of Marked-up Document Source), (3) Study Description, Citation (of Study), (4) Study Description, Other Material, and (5) Other Material for the study itself.
|
|||||||||
| citReq | 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.
|
|||||||||
| cleanOps | Cleaning Operations Description Methods used to "clean" the data collection, e.g., consistency checking, wild code checking, etc.
|
|||||||||
| codeBook | Codebook Description Every element in the DDI DTD/Schema has the following attributes:
|
|||||||||
| codeListAgencyName | Code List Agency Name Description Agency maintaining the code list.
|
|||||||||
| codeListID | Code List ID Description Identifies the code list that the value is taken from.
|
|||||||||
| codeListName | Code List Name Description Identifies the code list that the value is taken from with a human-readable name.
|
|||||||||
| codeListSchemeURN | Code List Scheme URN Description Identifies the code list scheme using a URN.
|
|||||||||
| codeListSchemeURN (in controlledVocabUsed) |
|
|||||||||
| codeListURN | Code List URN Description Identifies the code list that the value is taken from with a URN.
|
|||||||||
| codeListVersionID | Code List Version ID Description Version of the code list.
|
|||||||||
| codingInstructions | Coding Instructions Description Describe specific coding instructions used in data processing, cleaning, assession, or tabulation.
|
|||||||||
| codInstr | Coder Instructions Description Any special instructions to those who converted information from one form to another for a particular variable.
|
|||||||||
| cohort | 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.
|
|||||||||
| collDate | Date of Collection Description Contains the date(s) when the data were collected.
|
|||||||||
| collectorTraining | Collector Training Description Describes the training provided to data collectors including internviewer training, process testing, compliance with standards etc.
|
|||||||||
| collMode | Mode of Data Collection Description The method used to collect the data; instrumentation characteristics.
|
|||||||||
| collSitu | Characteristics of Data Collection Situation Description Description of noteworthy aspects of the data collection situation.
|
|||||||||
| collSize | 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.
|
|||||||||
| colspec | Column Specification
|
|||||||||
| command | Command Description Provide command code for the coding instruction.
|
|||||||||
| complete | 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.
|
|||||||||
| complianceDescription |
|
|||||||||
| concept | Concept Description The general subject to which the parent element may be seen as pertaining.
|
|||||||||
| conditions | Conditions Description Indicates any additional information that will assist the user in understanding the access and use conditions of the data collection.
|
|||||||||
| confDec | Confidentiality Declaration Description This element is used to determine if signing of a confidentiality declaration is needed to access a resource.
|
|||||||||
| ConOps | Control Operations Description Methods to facilitate data control performed by the primary investigator or by the data archive.
|
|||||||||
| contact | Contact Persons Description Names and addresses of individuals responsible for the work.
|
|||||||||
| controlledVocabUsed | Controlled Vocabulary Used Description Provides a code value, as well as a reference to the code list from which the value is taken.
|
|||||||||
| copyright | Copyright Description Copyright statement for the work at the appropriate level.
|
|||||||||
| CubeCoord | Description This is an empty element containing only the attributes listed below.
|
|||||||||
| custodian | Custodian Description Custodian identifies the agency or individual who is responsible for creating or maintaining the sample frame.
|
|||||||||
| dataAccs | Data Access Description This section describes access conditions and terms of use for the data collection.
|
|||||||||
| dataAppr | Other Forms of Data Appraisal Description Other issues pertaining to data appraisal.
|
|||||||||
| dataChck | Extent of Processing Checks Description Indicate here, at the file level, the types of checks and operations performed on the data file.
|
|||||||||
| dataColl | Data Collection Methdology Description Information about the methodology employed in a data collection.
|
|||||||||
| dataCollector | Data Collector Description The entity (individual, agency, or institution) responsible for administering the questionnaire or interview or compiling the data.
|
|||||||||
| dataDscr | Variable Description Description Description of variables.
|
|||||||||
| dataFingerprint | Data Fingerprint Description Allows for assigning a hash value (digital fingerprint) to the data or data file.
|
|||||||||
| dataItem | 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.
|
|||||||||
| dataKind | 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.
|
|||||||||
| dataMsng | 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.
|
|||||||||
| dataProcessing | Data Processing Description Describes various data processing procedures not captured elsewhere in the documentation, such as topcoding, recoding, suppression, tabulation, etc.
|
|||||||||
| dataSrc | 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.
|
|||||||||
| dataSrc (in resource) |
|
|||||||||
| defntn | Definition Description Rationale for why the group was constituted in this way.
|
|||||||||
| depDate | Date of Deposit Description The date that the work was deposited with the archive that originally received it.
|
|||||||||
| depositr | Depositor Description The name of the person (or institution) who provided this work to the archive storing it.
|
|||||||||
| deposReq | 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 | 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.
|
|||||||||
| description |
|
|||||||||
| developmentActivity |
|
|||||||||
| deviat | 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.
|
|||||||||
| digitalFingerprintValue |
|
|||||||||
| dimensns | File Dimensions Description Dimensions of the overall file.
|
|||||||||
| disclaimer | Disclaimer Description Information regarding responsibility for uses of the data collection.
|
|||||||||
| distDate | Date of Distribution Description Date that the work was made available for distribution/presentation.
|
|||||||||
| distrbtr | Distributor Description The organization designated by the author or producer to generate copies of the particular work including any necessary editions or revisions.
|
|||||||||
| distStmt | 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.
|
|||||||||
| div | Division Description Formatting element: marks a subdivision in a text.
|
|||||||||
| dmns | 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.
|
|||||||||
| docDscr | Document Description Description The Document Description consists of bibliographic information describing the DDI-compliant document itself as a whole.
|
|||||||||
| docSrc | Documentation Source Description Citation for the source document.
|
|||||||||
| docStatus | Documentation Status Description Use this field to indicate if the documentation is being presented/distributed before it has been finalized.
|
|||||||||
| drvcmd | Derivation Command Description The actual command used to generate the derived variable.
|
|||||||||
| drvdesc | Derivation Description Description A textual description of the way in which this variable was derived.
|
|||||||||
| eastBL | East Bounding Longitude Description The easternmost coordinate delimiting the geographic extent of the dataset.
|
|||||||||
| embargo | Embargo Description Provides information on variables/nCubes which are not currently available because of policies established by the principal investigators and/or data producers.
|
|||||||||
| emph | Emphasis Description Formatting element: marks words or phrases that are emphasized for rhetorical effect.
|
|||||||||
| entry | Table Entry
|
|||||||||
| EstSmpErr | Estimates of Sampling Error Description Measure of how precisely one can estimate a population value from a given sample.
|
|||||||||
| evaluationProcess | Evaluation Process Description Describes the evaluation process followed.
|
|||||||||
| evaluator | Evaluator Type Description The evaluator element identifies persons or organizations involved in the evaluation.
|
|||||||||
| exPostEvaluation | Post Evaluation Procedures Description Use this section to describe evaluation procedures not address in data evaluation processes.
|
|||||||||
| ExtLink | 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.
|
|||||||||
| fileCitation | File Citation Description The complex element fileCitation provides for a full bibliographic citation option for each data file described in fileDscr.
|
|||||||||
| fileCont | Contents of Files Description Abstract or description of the file.
|
|||||||||
| fileDscr | Data Files Description Description Information about the data file(s) that comprises a collection.
|
|||||||||
| fileName | 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.
|
|||||||||
| filePlac | Place of File Production Description Indicates whether the file was produced at an archive or produced elsewhere.
|
|||||||||
| fileQnty | Number of Files Description Total number of physical files associated with a collection.
|
|||||||||
| fileStrc | File Structure Description Type of file structure.
|
|||||||||
| fileTxt | File-by-File Description Description Provides descriptive information about the data file.
|
|||||||||
| fileType | 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.
|
|||||||||
| format | 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 | Forward Progression Description Contains a reference to IDs of possible following questions.
|
|||||||||
| frameUnit | Frame Unit Description Provides information about the sampling frame unit.
|
|||||||||
| frequenc | Frequency of Data Collection Description For data collected at more than one point in time, the frequency with which the data were collected.
|
|||||||||
| fundAg | Funding Agency/Sponsor Description The source(s) of funds for production of the work.
|
|||||||||
| geoBndBox | Geographic Bounding Box Description The fundamental geometric description for any dataset that models geography.
|
|||||||||
| geogCover | Geographic Coverage Description Information on the geographic coverage of the data.
|
|||||||||
| geogUnit | Geographic Unit Description Lowest level of geographic aggregation covered by the data.
|
|||||||||
| geoMap | Geographic Map Description This element is used to point, using a "URI" attribute, to an external map that displays the geography in question.
|
|||||||||
| grantNo | Grant Number Description The grant/contract number of the project that sponsored the effort.
|
|||||||||
| gringLat | G-Ring Latitude Description Latitude (y coordinate) of a point.
|
|||||||||
| gringLon | G-Ring Longitude Description Longitude (x coordinate) of a point.
|
|||||||||
| guide | Guide to Codebook Description List of terms and definitions used in the documentation.
|
|||||||||
| head | Head Description Formatting element: marks off a heading to a division, list, etc.
|
|||||||||
| hi | Highlight Description Formatting element: marks a word or phrase as graphically distinct from the surrounding text, while making no claim for the reasons.
|
|||||||||
| holdings | Holdings Information Description Information concerning either the physical or electronic holdings of the cited work.
|
|||||||||
| IDNo | Identification Number Description Unique string or number (producer's or archive's number).
|
|||||||||
| imputation | 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.
|
|||||||||
| instrumentDevelopment | Instrument Development Description Describe any development work on the data collection instrument.
|
|||||||||
| invalrng | Range of Invalid Data Values Description Values for a particular variable that represent missing data, not applicable responses, etc.
|
|||||||||
| item | Value Item Description The counterpart to Range; used to encode individual values.
|
|||||||||
| itm | Item Description Formatting element: marks entries (items) in a list.
|
|||||||||
| ivuInstr | Interviewer Instructions Description Specific instructions to the individual conducting an interview.
|
|||||||||
| key | Range Key Description This element permits a listing of the category values and labels.
|
|||||||||
| keyword | Keywords Description Words or phrases that describe salient aspects of a data collection's content.
|
|||||||||
| label | Label Description Formatting element: contains the label associated with an item in a list; in glossaries, marks the term being defined.
|
|||||||||
| labl | Label Description A short description of the parent element.
|
|||||||||
| Link | 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 | List Description Formatting element: contains any sequence of items (entries) organized as a list.
|
|||||||||
| location | Location Description This is an empty element containing only the attributes listed below.
|
|||||||||
| locMap | Location Map Description This element maps individual data entries to one or more physical storage locations.
|
|||||||||
| logRecL | Logical Record Length Description Logical record length, i.e., number of characters of data in the record.
|
|||||||||
| measure | Measure Description The element measure indicates the measurement features of the cell content: type of aggregation used, measurement unit, and measurement scale.
|
|||||||||
| method | Methodology and Processing Description This section describes the methodology and processing involved in a data collection.
|
|||||||||
| mi | Mathematical Identifier Description Token element containing the smallest unit in the mrow that carries meaning.
|
|||||||||
| mrow | Mathematical Row Description This element is a wrapper containing the presentation expression mi.
|
|||||||||
| nation | Country Description Indicates the country or countries covered in the file.
|
|||||||||
| nCube | nCube Description Describes the logical structure of an n-dimensional array, in which each coordinate intersects with every other dimension at a single point.
|
|||||||||
| nCubeGrp | 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.
|
|||||||||
| northBL | North Bounding Latitude Description The northernmost coordinate delimiting the geographic extent of the dataset.
|
|||||||||
| notes | Notes and comments Description For clarifying information/annotation regarding the parent element.
|
|||||||||
| origArch | Archive Where Study Originally Stored Description Archive from which the data collection was obtained; the originating archive.
|
|||||||||
| otherMat | 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).
|
|||||||||
| otherQualityStatement |
|
|||||||||
| othId | Other Identifications /Acknowledgments Description Statements of responsibility not recorded in the title and statement of responsibility areas.
|
|||||||||
| othRefs | Other References Notes Description Indicates other pertinent references.
|
|||||||||
| othrStdyMat | Other Study Description Materials Description Other materials relating to the study description.
|
|||||||||
| outcome |
|
|||||||||
| outcomes | Evaluation Outcomes Description Describe the outcomes of the evaluation.
|
|||||||||
| p | Paragraph Description Marks a paragraph.
|
|||||||||
| participant |
|
|||||||||
| parTitl | Parallel Title Description Title translated into another language.
|
|||||||||
| physLoc | Description This is an empty element containing only the attributes listed below.
|
|||||||||
| point | Point Description 0-dimensional geometric primitive, representing a position, but not having extent.
|
|||||||||
| polygon | 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.
|
|||||||||
| postQTxt | PostQuestion Text Description Text describing what occurs after the literal question has been asked.
|
|||||||||
| preQTxt | PreQuestion Text Description Text describing a set of conditions under which a question might be asked.
|
|||||||||
| ProcStat | Processing Status Description Processing status of the file.
|
|||||||||
| prodDate | 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).
|
|||||||||
| prodPlac | Place of Production Description Address of the archive or organization that produced the work.
|
|||||||||
| prodStmt | Production Statement Description 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.
|
|||||||||
| producer | 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.
|
|||||||||
| qstn | Question Description The question element may have mixed content.
|
|||||||||
| qstnLit | Literal Question Description Text of the actual, literal question asked.
|
|||||||||
| qualityStatement | Quality Statement Description This structure consists of two parts, standardsCompliance and otherQualityStatements.
|
|||||||||
| range | Value Range Description This is the actual range of values.
|
|||||||||
| recDimnsn | Dimensions (of record) Description Information about the physical characteristics of the record.
|
|||||||||
| recGrp | Record or Record Group Description Used to describe record groupings if the file is hierarchical or relational.
|
|||||||||
| recNumTot | Overall Number of Records Description Overall record count in file.
|
|||||||||
| recPrCas | Records per Case Description Records per case in the file.
|
|||||||||
| referencePeriod | Reference Period Description Indicates the period of time in which the sampling frame was actually used for the study in question.
|
|||||||||
| relMat | Related Materials Description Describes materials related to the study description, such as appendices, additional information on sampling found in other documents, etc.
|
|||||||||
| relPubl | Related Publications Description Bibliographic and access information aboutvarticles and reports based on the data in this collection.
|
|||||||||
| relStdy | 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.
|
|||||||||
| resInstru | Type of Research Instrument Description The type of data collection instrument used.
|
|||||||||
| resource |
|
|||||||||
| respRate | Response Rate Description The percentage of sample members who provided information.
|
|||||||||
| respUnit | Response Unit Description Provides information regarding who provided the information contained within the variable/nCube, e.g., respondent, proxy, interviewer.
|
|||||||||
| restrctn | Restrictions Description Any restrictions on access to or use of the collection such as privacy certification or distribution restrictions should be indicated here.
|
|||||||||
| row | Table Row
|
|||||||||
| rspStmt | Responsibility Statement Description 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.
|
|||||||||
| sampleFrame | Sample Frame Description Sample frame describes the sampling frame used for identifying the population from which the sample was taken.
|
|||||||||
| sampleFrameName | Sample Frame Name Description Name of the sample frame.
|
|||||||||
| sampleSize | Sample Size Description This element provides the targeted sample size in integer format.
|
|||||||||
| sampleSizeFormula | Sample Size Formula Description This element includes the formula that was used to determine the sample size.
|
|||||||||
| sampProc | Sampling Procedure Description The type of sample and sample design used to select the survey respondents to represent the population.
|
|||||||||
| security | Security Description Provides information regarding levels of access, e.g., public, subscriber, need to know.
|
|||||||||
| selector | Selector Description Identifies a collection of elements in which a controlled vocabulary is used.
|
|||||||||
| serInfo | Series Information Description Contains a history of the series and a summary of those features that apply to the series as a whole.
|
|||||||||
| serName | Series Name Description The name of the series to which the work belongs.
|
|||||||||
| serStmt | 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.
|
|||||||||
| setAvail | Data Set Availability Description Information on availability and storage of the collection.
|
|||||||||
| software | Software used in Production Description Software used to produce the work.
|
|||||||||
| sourceCitation | Source Citation Description This complex element allows the inclusion of a standard citation for the sources used in collecting and creating the dataset.
|
|||||||||
| sources | Sources Statement Description Description of sources used for the data collection.
|
|||||||||
| southBL | South Bounding Latitude Description The southernmost coordinate delimiting the geographic extent of the dataset.
|
|||||||||
| specificElements | 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.
|
|||||||||
| specPerm | Special Permissions Description This element is used to determine if any special permissions are required to access a resource.
|
|||||||||
| srcChar | Characteristics of Source Noted Description Assessment of characteristics and quality of source material.
|
|||||||||
| srcDocu | Documentation and Access to Sources Description Level of documentation of the original sources.
|
|||||||||
| srcOrig | 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 | Standard Description Describes a standard with which the study complies.
|
|||||||||
| standardName | Standard Name Description Contains the name of the standard with which the study complies.
|
|||||||||
| standardsCompliance | Standards Compliance Description This section lists all specific standards complied with during the execution of this study.
|
|||||||||
| stdCatgry | Standard Categories Description Standard category codes used in the variable, like industry codes, employment codes, or social class codes.
|
|||||||||
| stdyClas | 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.
|
|||||||||
| stdyDscr | Study Description Description The Study Description consists of information about the data collection, study, or compilation that the DDI-compliant documentation file describes.
|
|||||||||
| stdyInfo | Study Scope Description This section contains information about the data collection's scope across several dimensions, including substantive content, geography, and time.
|
|||||||||
| studyAuthorization | Study Authorization Description Provides structured information on the agency that authorized the study, the date of authorization, and an authorization statement.
|
|||||||||
| studyBudget | Study Budget Description Describe the budget of the project in as much detail as needed.
|
|||||||||
| studyDevelopment | Study Development Description Describe the process of study development as a series of development activities.
|
|||||||||
| subject | Subject Information Description Subject information describing the data collection's intellectual content.
|
|||||||||
| subTitl | Subtitle Description A secondary title used to amplify or state certain limitations on the main title.
|
|||||||||
| sumDscr | Summary Data Description Description Information about the and geographic coverage of the study and unit of analysis.
|
|||||||||
| sumStat | 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 | Table
|
|||||||||
| targetSampleSize | 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.
|
|||||||||
| tbody | Table Body
|
|||||||||
| tgroup | Table Group
|
|||||||||
| thead | Table Head
|
|||||||||
| timeMeth | Time Method Description The time method or time dimension of the data collection.
|
|||||||||
| timePrd | Time Period Covered Description The time period to which the data refer.
|
|||||||||
| titl | 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.
|
|||||||||
| titlStmt | Title Statement Description 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.
|
|||||||||
| topcClas | Topic Classification Description The classification field indicates the broad substantive topic(s) that the data cover.
|
|||||||||
| TotlResp | Total Responses Description The number of responses to this variable.
|
|||||||||
| txt | Descriptive Text Description Lengthier description of the parent element.
|
|||||||||
| undocCod | List of Undocumented Codes Description Values whose meaning is unknown.
|
|||||||||
| unitType | Unit Type Description Describes the type of sampling frame unit.
|
|||||||||
| universe | Universe Description The group of persons or other elements that are the object of research and to which any analytic results refer.
|
|||||||||
| updateProcedure | Instrument Development Description Description of how and with what frequency the sample frame is updated.
|
|||||||||
| usage | Usage Description Defines where in the instance the controlled vocabulary which is identified is utilized.
|
|||||||||
| useStmt | Use Statement Description Information on terms of use for the data collection.
|
|||||||||
| validPeriod | Valid Period Description Defines a time period for the validity of the sampling frame.
|
|||||||||
| valrng | Range of Valid Data Values Description Values for a particular variable that represent legitimate responses.
|
|||||||||
| var | Variable Description This element describes all of the features of a single variable in a social science data file.
|
|||||||||
| varFormat | Variable Format Description The technical format of the variable in question.
|
|||||||||
| varGrp | 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.
|
|||||||||
| varQnty | Overall Variable Count Description Number of variables.
|
|||||||||
| verResp | Version Responsibility Statement Description The organization or person responsible for the version of the work.
|
|||||||||
| version | Version Description Also known as release or edition.
|
|||||||||
| verStmt | 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.
|
|||||||||
| weight | Weighting Description The use of sampling procedures may make it necessary to apply weights to produce accurate statistical results.
|
|||||||||
| westBL | 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) 2014 DDI Alliance, DDI 2.5, 2014-01-28 This file is part of DDI 2.5 XML Schema. DDI 2.5 XML Schema is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. DDI 2.5 XML Schema is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with DDI 2.5 XML Schema. If not, see <http://www.gnu.org/licenses/>. --> <!-- DDI 2.5.1 XML Schema modifies DDI 2.5 by easing cardinality on many text entries to better support multi-language content. It provides the element dataFingerprint within fileTxt as a sub-minor, backward compatible bug correction. This element was intended to be included in DDI 2.5. Documentation of new objects was expanded. These changes do not effect the namespace. 2013-11-14. --> <xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="ddi:codebook:2_5" xmlns="ddi:codebook:2_5" 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> This is a w3c Schema "Technical Implementation" of the DDI Conceptual Specification. 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. </xs:documentation> </xs:annotation> <!-- Base Structures --> <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:annotation> </xs:attribute> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="archive"/> <xs:enumeration value="producer"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:annotation> </xs:annotation> </xs:attribute> <xs:annotation> Indicates version date for the element. Use YYYY-MM-DD, YYYY-MM, or YYYY formats. </xs:documentation> </xs:annotation> </xs:attribute> <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: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:attribute> </xs:attributeGroup> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Base Element Type</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Abstract Text Type</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> <xs:complexContent> <xs:sequence> <xs:any maxOccurs="unbounded" minOccurs="0" namespace="##targetNamespace http://www.w3.org/1999/xhtml"/> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Simple Text Type</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Conceptual Text Type</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Phrase Type</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">String Type</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> This type restricts the base abstractTextType to only allow for text (i.e. no child elements). </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> <xs:simpleContent> <xs:simpleType> <xs:restriction base="xs:string"/> </xs:simpleType> </xs:restriction> </xs:simpleContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Integer Type</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> <xs:simpleContent> <xs:simpleType> <xs:restriction base="xs:integer"/> </xs:simpleType> </xs:restriction> </xs:simpleContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Date Simple Type</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> <xs:union memberTypes="xs:dateTime xs:date xs:gYearMonth xs:gYear"/> </xs:simpleType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Date Type</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> <xs:simpleContent> <xs:simpleType> </xs:simpleType> </xs:restriction> </xs:simpleContent> </xs:complexType> <!-- PRHASE Elements --> <xs:choice> </xs:choice> </xs:group> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">External Link</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Link</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <!-- FORM Elements --> <xs:choice> </xs:choice> </xs:group> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Form Type</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Division</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Formatting element: marks a subdivision in a text. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Emphasis</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Formatting element: marks words or phrases that are emphasized for rhetorical effect. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Head</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Formatting element: marks off a heading to a division, list, etc. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Highlight</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="ordered"/> <xs:enumeration value="bulleted"/> <xs:enumeration value="simple"/> <xs:enumeration value="gloss"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">List</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Formatting element: contains any sequence of items (entries) organized as a list. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Item</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Formatting element: marks entries (items) in a list. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Label</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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> </xhtml:div> </xhtml:div> </xs:documentation> <xhtml:div> <xhtml:h1 class="element_title">Label</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> A short description of the parent element. Attribute "level" indicates the level to which the element applies (variable group, nCube group, variable, etc.). The "vendor" attribute allows for specification of different labels for use with different vendors' software. Attribute "country" allows specification of a different label by country for the same element to which it applies. Attribute "sdatrefs" allows pointing to specific dates, universes, or other information encoded in the study description. The attributes "country" and "sdatrefs" are intended to cover instances of comparative data, by retaining consistency in some elements over time and geography, but altering, as appropriate, information pertaining to date, language, and/or location. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <recGrp rectype="A" keyvar="H-SEQ" recidvar="PRECORD"> <labl>Person (A) Record</labl> </recGrp> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <varGrp> <labl>Study Procedure Information</labl> </varGrp> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <varGrp> <labl>Political Involvement and National Goals</labl> </varGrp> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <varGrp> <labl>Household Variable Section</labl> </varGrp> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <nCubeGrp> <labl>Sex by Work Experience in 1999 by Income in 1999</labl> </nCubeGrp> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <nCubeGrp> <labl>Tenure by Age of Householder</labl> </nCubeGrp> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <var> <labl>Why No Holiday-No Money</labl> </var> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <catgryGrp> <labl>Other Agricultural and Related Occupations</labl> </catgryGrp> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <catgry> <labl>Better</labl> </catgry> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <catgry> <labl>About the same</labl> </catgry> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <catgry> <labl>Inap.</labl> </catgry> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <nCube> <labl>Age by Sex by Poverty Status</labl> </nCube> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <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> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> <xs:choice maxOccurs="unbounded" minOccurs="0"> </xs:choice> </xs:sequence> </xs:restriction> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Paragraph</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description">Marks a paragraph.</xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <!-- Codebook Elements --> <xs:complexContent> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="abstract"/> <xs:enumeration value="purpose"/> <xs:enumeration value="mixed"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Abstract</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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 3 by describing where the content fits in that structure, or if is mixed in terms of what is contained. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <abstract date="1999-01-28" source="ICPSR"> 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> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Location of Data Collection</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Actions to Minimize Losses</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <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> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Alternative Title</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> A title by which the work is commonly referred, or an abbreviation of the title. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Data Appraisal</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description">Information on data appraisal.</xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Unit of Analysis</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Basic unit of analysis or observation that the file describes: individuals, families/households, groups, institutions/organizations, administrative units, etc. The "unit" attribute is included to permit the development of a controlled vocabulary for this element. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <anlyUnit>individuals</anlyUnit> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Analysis Unit</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Provides information regarding whom or what the variable/nCube describes. The element may be repeated only to support multiple language expressions of the content. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <var> <anlysUnit>This variable reports election returns at the constituency level.</anlysUnit> </var> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <nCube> <anlysUnit>Household</anlysUnit> </nCube> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Authoring Entity/Primary Investigator</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> <xhtml:p> The person, corporate body, or agency responsible for the work's substantive and intellectual content. Repeat the element for each author, and use "affiliation" attribute if available. Invert first and last name and use commas. Author of data collection (codeBook/stdyDscr/citation/rspStmt/AuthEnty) maps to Dublin Core Creator element. 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:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <AuthEnty>United States Department of Commerce. Bureau of the Census</AuthEnty> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <AuthEnty affiliation="European Commission">Rabier, Jacques-Rene</AuthEnty> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Availability Status</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <avlStatus>This collection is superseded by CENSUS OF POPULATION, 1880 [UNITED STATES]: PUBLIC USE SAMPLE (ICPSR 6460).</avlStatus> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Backflow</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Contains a reference to IDs of possible preceding questions. The "qstn" IDREFS may be used to specify the question IDs. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <var> <qstn> <backward qstn="Q12 Q13 Q14 Q15">For responses on a similar topic, see questions 12-15.</backward> </qstn> </var> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <var> <qstn> <backward qstn="Q143"/> </qstn> </var> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Bibliographic Citation</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Complete bibliographic reference containing all of the standard elements of a citation that can be used to cite the work. The "format" attribute is provided to enable specification of the particular citation style used, e.g., APA, MLA, Chicago, etc. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <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 Resarch [producer and distributor], 1981.</biblCit> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Geographic Bounding Polygon</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> <xhtml:p> 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. </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:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <geogCover>Nevada State</geogCover> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <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> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <geogCover>Norway</geogCover> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <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> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Number of cases / Record Quantity</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description">Number of cases or observations.</xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <caseQnty>1011</caseQnty> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="freq"/> <xs:enumeration value="percent"/> <xs:enumeration value="crosstab"/> <xs:enumeration value="other"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="wgtd"/> <xs:enumeration value="not-wgtd"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Category Level Statistic</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> May include frequencies, percentages, or crosstabulation results. This field can contain one of the following: 1. textual information (e.g., PCDATA), or 2. non-parseable character data (e.g., the statistics), or 3. some other form of external information (table, image, etc.) 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. The attribute "type" indicates the type of statistics presented - frequency, percent, or crosstabulation. If a value of "other" is used for this attribute, the "otherType" attribute 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> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <var> <catgryGrp> <catStat type="freq">256</catStat> </catgryGrp> </var> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Category Value</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description">The explicit response.</xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <var> <catgry missing="Y" missType="inap"> <catValu>9</catValu> </catgry> </var> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Category Level</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. A category level may be linked to one or more maps of the variable content. This id done by referencing the IDs of the appropriate geoMap elements in the attribute <xhtml:code>geoMap</xhtml:code> . </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <catlevel ID="Level1" levelnm="Broader sectors"/> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <catlevel ID="Level2" levelnm="Narrower sectors"/> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <catlevel ID="Level3" levelnm="Occupations" geoMap="GEO_1 GEO_2"/> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> </xs:sequence> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="Y"/> <xs:enumeration value="N"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="true"/> <xs:enumeration value="false"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Category</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> <xhtml:p>A description of a particular response.</xhtml:p> <xhtml:p> The attribute "missing" indicates whether this category group contains missing data or not. </xhtml:p> <xhtml:p> The attribute "missType" is used to specify the type of missing data, e.g., inap., don't know, no answer, etc. </xhtml:p> <xhtml:p> The attribute "country" allows for the denotation of country-specific category values. </xhtml:p> <xhtml:p> The "sdatrefs" attribute records the ID values of all elements within the summary data description that apply to this category. </xhtml:p> <xhtml:p> The exclusiveness attribute ("excls") should be set to "false" if the category can appear in more than one place in the classification hierarchy. </xhtml:p> <xhtml:p> The attribute "catgry" is an IDREF referencing any child categories of this category element. Used to capture nested hierarchies of categories. </xhtml:p> <xhtml:p> The attribute "level" is an IDREF referencing the catLevel ID in which this category exists. </xhtml:p> </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <catlevel ID="Level1" levelnm="Broader sectors"/> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <catlevel ID="Level2" levelnm="Narrower sectors"/> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <catlevel ID="Level3" levelnm="Occupations"/> ]]> </xhtml:samp> <!-- ... --> <xhtml:samp class="xml_sample"> <![CDATA[ <catgry ID="C1" catgry="C2" Level="Level1"> <catValu>0</catValu> <labl>Management, professional and related occupations</labl> </catgry> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <catgry ID="C2" catgry="C3, C4" Level="Level2"> <catValu>01</catValu> <labl>Management occupations</labl> </catgry> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <catgry ID="C3" Level="Level3"> <catValu>011</catValu> <labl>Top executives</labl> </catgry> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <catgry ID="C4" Level="Level3"> <catValu>012</catValu> <labl>Financial managers</labl> </catgry> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> </xs:sequence> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="Y"/> <xs:enumeration value="N"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="true"/> <xs:enumeration value="false"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="true"/> <xs:enumeration value="false"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Category Group</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> A description of response categories that might be grouped together. The attribute "missing" indicates whether this category group contains missing data or not. The attribute "missType" is used to specify the type of missing data, e.g., inap., don't know, no answer, etc. The attribute catGrp is used to indicate all the subsidiary category groups which nest underneath the current category group. This allows for the encoding of a hierarchical structure of category groups. The "levelno" attribute allows the addition of a level number, and "levelnm" allows the addition of a level name to the category group. The completeness attribute ("compl") should be set to "false" if the category group is incomplete (not a complete aggregate of all sub-nodes or children). The exclusiveness attribute ("excls") should be set to "false" if the category group can appear in more than one place in the classification hierarchy. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Citation Requirement</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <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> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Bibliographic Citation</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> <xhtml:p> This element encodes the bibliographic information for the work at the level specified: (1) Document Description, Citation (of Marked-up Document), (2) Document Description, Citation (of Marked-up Document Source), (3) Study Description, Citation (of Study), (4) Study Description, Other Material, and (5) Other Material for the study itself. 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> <xhtml:p> A MARCURI attribute is provided to link to the MARC record for the citation. </xhtml:p> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Cleaning Operations</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Methods used to "clean" the data collection, e.g., consistency checking, wild code checking, etc. The "agency" attribute permits specification of the agency doing the data cleaning. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <cleanOps>Checks for undocumented codes were performed, and data were subsequently revised in consultation with the principal investigator.</cleanOps> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Coder Instructions</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <var> <codInstr>Use the standard classification tables to present responses to the question: What is your occupation? into numeric codes.</codInstr> </var> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> <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:element> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Codebook</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> <xhtml:p> 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:a href="http://www.iso.org/">www.iso.org</xhtml:a> ) language codes is recommended. </xhtml:p> <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). </xhtml:p> <xhtml:p> The top-level element, codeBook, also includes a version attribute to specify the version number of the DDI specification. </xhtml:p> <xhtml:p> codeBookAgency - This attribute holds the agency name of the creator or maintainer of the codeBook instance as a whole, and 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:p> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Cohort</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. The attribute "catRef" is an IDREF to the actual category being used. The attribute "value" indicates the actual value attached to the category that is being used. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <dmns> <cohort catRef="CV24_1" value="1"/> </dmns> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="start"/> <xs:enumeration value="end"/> <xs:enumeration value="single"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Date of Collection</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Contains the date(s) when the data were collected. Use the event attribute to specify "start", "end", or "single" for each date entered. The ISO standard for dates (YYYY-MM-DD) is recommended for use with the "date" attribute. The "cycle" attribute permits specification of the relevant cycle, wave, or round of data. Maps to Dublin Core Coverage element. Inclusion of this element in the codebook is recommended. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <collDate event="single" date="1998-11-10">10 November 1998</collDate> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Mode of Data Collection</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> The method used to collect the data; instrumentation characteristics. XHTML formatting may be used in the txt element for forward-compatibility with DDI 3. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <collMode>telephone interviews</collMode> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <collMode>face-to-face interviews</collMode> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <collMode>mail questionnaires</collMode> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <collMode>computer-aided telephone interviews (CATI)</collMode> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Characteristics of Data Collection Situation</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <collSitu>There were 1,194 respondents who answered questions in face-to-face interviews lasting approximately 75 minutes each.</collSitu> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Extent of Collection</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <collSize>1 data file + machine-readable documentation (PDF) + SAS data definition statements</collSize> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="left"/> <xs:enumeration value="right"/> <xs:enumeration value="center"/> <xs:enumeration value="justify"/> <xs:enumeration value="char"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Column Specification</xhtml:h1> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Completeness of Study Stored</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <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> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Concept</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. The "vocab" attribute is provided to indicate the controlled vocabulary, if any, used in the element, e.g., LCSH (Library of Congress Subject Headings), MeSH (Medical Subject Headings), etc. The "vocabURI" attribute specifies the location for the full controlled vocabulary. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <nCubeGrp> <concept>Income</concept> </nCubeGrp> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <nCubeGrp> <concept vocab="LCSH" vocabURI="http://lcweb.loc.gov/catdir/cpso/lcco/lcco.html" source="archive">more experience</concept> </nCubeGrp> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <var> <concept>Income</concept> </var> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <var> <concept vocab="LCSH" vocabURI="http://lcweb.loc.gov/catdir/cpso/lcco/lcco.html" source="archive">SF: 311-312 draft horses</concept> </var> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Conditions</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <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> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="yes"/> <xs:enumeration value="no"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Confidentiality Declaration</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> This element is used to determine if signing of a confidentiality declaration is needed to access a resource. The "required" attribute is used to aid machine processing of this element, and the default specification is "yes". The "formNo" attribute indicates the number or ID of the form that the user must fill out. The "URI" attribute may be used to provide a URN or URL for online access to a confidentiality declaration form. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <confDec formNo="1">To download this dataset, the user must sign a declaration of confidentiality.</confDec> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <confDec URI="http://www.icpsr.umich.edu/HMCA/CTSform/contents.html"> To obtain this dataset, the user must complete a Restricted Data Use Agreement.</confDec> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Contact Persons</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. The URI attribute should be used to indicate a URN or URL for the homepage of the contact individual. The email attribute is used to indicate an email address for the contact individual. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <contact affiliation="University of Wisconsin" email="jsmith@...">Jane Smith</contact> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Control Operations</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. The "agency" attribute maybe used to refer to the agency that performed the control operation. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <ConOps source="ICPSR">Ten percent of data entry forms were reentered to check for accuracy.</ConOps> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Controlled Vocabulary Used</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Provides a code value, as well as a reference to the code list from which the value is taken. Note that the CodeValue can be restricted to reference an enumeration. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Code List ID</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Identifies the code list that the value is taken from. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <codeListID>TimeMethod</codeListID> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Code List Name</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Identifies the code list that the value is taken from with a human-readable name. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <codeListName>Time Method</codeListName> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Code List Agency Name</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description">Agency maintaining the code list.</xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <codeListAgencyName>DDI Alliance</codeListAgencyName> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Code List Version ID</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description">Version of the code list. (Default value is 1.0)</xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <codeListVersionID>1.1</codeListVersionID> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Code List URN</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Identifies the code list that the value is taken from with a URN. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <codeListURN>urn:ddi-cv:TimeMethod:1.1</codeListURN> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Code List Scheme URN</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description">Identifies the code list scheme using a URN.</xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <codeListSchemeURN>http://www.ddialliance.org/Specification/DDI-CV/TimeMethod_1.1_Genericode1.0_DDI-CVProfile1.0.xml</codeListSchemeURN> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Usage</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:sequence> <xs:choice> </xs:choice> </xs:sequence> </xs:complexType> <xs:restriction base="xs:string"> <xs:pattern value="((//|/)(([\i-[:]][\c-[:]]*:)?[\i-[:]][\c-[:]]*|\*|[\i-[:]][\c-[:]]*:\*))+"/> </xs:restriction> </xs:simpleType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Selector</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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 class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <selector>/codeBook/stdyDscr/method/dataColl/timeMeth</selector> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Specific Elements</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. The authorizedCodeValue attribute can be used to provide 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> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <specificElements refs="ICPSR4328timeMeth" authorizedCodeValue="CrossSection"/> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:restriction base="xs:string"> <xs:pattern value="@(([\i-[:]][\c-[:]]*:)?[\i-[:]][\c-[:]]*|\*|[\i-[:]][\c-[:]]*:\*)"/> </xs:restriction> </xs:simpleType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Attribute</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <attribute>type</attribute> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Copyright</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <copyright>Copyright(c) ICPSR, 2000</copyright> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1/> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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 giving the coordinate number ("coordNo") and coordinate value ("coordVal"). Coordinate value reference ("cordValRef") is an ID reference to the variable that carries the coordinate value. The attributes provide a complete coordinate location of a cell within the nCube. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <CubeCoord coordNo="1" coordVal="3"/> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <CubeCoord coordNo="2" coordVal="7"/> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <CubeCoord coordNo="3" coordVal="2"/> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Data Access</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. The access conditions applying to a study, file, variable group, or variable can be indicated by an IDREF attribute on the study, file, variable group, or variable elements called "access". </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Other Forms of Data Appraisal</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <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. Attribute type allows for optional typing of data appraisal processes and option for controlled vocabulary. </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <dataAppr>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> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Extent of Processing Checks</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Indicate here, at the file level, the types of checks and operations performed on the data file. A controlled vocabulary may be developed for this element in the future. The following examples are based on ICPSR's Extent of Processing scheme: </xhtml:div> </xhtml:div> <xhtml:div> <xhtml:h2 class="section_header">Example</xhtml:h2> <xhtml:div class="example"> <xhtml:samp class="xml_sample"> <![CDATA[ <dataChck>The archive produced a codebook for this collection.</dataChck> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <dataChck>Consistency checks were performed by Data Producer/ Principal Investigator.</dataChck> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <dataChck>Consistency checks performed by the archive.</dataChck> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <dataChck>The archive generated SAS and/or SPSS data definition statements for this collection.</dataChck> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <dataChck>Frequencies were provided by Data Producer/Principal Investigator.</dataChck> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <dataChck>Frequencies provided by the archive.</dataChck> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <dataChck>Missing data codes were standardized by Data Producer/ Principal Investigator.</dataChck> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <dataChck>Missing data codes were standardized by the archive.</dataChck> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <dataChck>The archive performed recodes and/or calculated derived variables. </dataChck> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <dataChck>Data were reformatted by the archive.</dataChck> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <dataChck>Checks for undocumented codes were performed by Data Producer/Principal Investigator.</dataChck> ]]> </xhtml:samp> <xhtml:samp class="xml_sample"> <![CDATA[ <dataChck>Checks for undocumented codes were performed by the archive.</dataChck> ]]> </xhtml:samp> </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType> <xs:annotation> <xhtml:div> <xhtml:h1 class="element_title">Data Collection Methdology</xhtml:h1> <xhtml:div> <xhtml:h2 class="section_header">Description</xhtml:h2> <xhtml:div class="description"> Information about the methodology employed in a data collection. </xhtml:div> </xhtml:div> </xhtml:div> </xs:documentation> </xs:annotation> </xs:element> <xs:complexContent> <xs:sequence> </xs:sequence> </xs:extension> </xs:complexContent> </xs:complexType> |