Description: The Document Description consists of bibliographic information describing the DDI-compliant document itself as a whole. This Document Description can be considered the wrapper or header whose elements uniquely describe the full contents of the compliant DDI file. Since the Document Description section is used to identify the DDI-compliant file within an electronic resource discovery environment, this section should be as complete as possible. The author in the Document Description should be the individual(s) or organization(s) directly responsible for the intellectual content of the DDI version, as distinct from the person(s) or organization(s) responsible for the intellectual content of the earlier paper or electronic edition from which the DDI edition may have been derived. The producer in the Document Description should be the agency or person that prepared the marked-up document. Note that the Document Description section contains a Documentation Source subsection consisting of information about the source of the DDI-compliant file-- that is, the hardcopy or electronic codebook that served as the source for the marked-up codebook. These sections allow the creator of the DDI file to produce version, responsibility, and other descriptions relating to both the creation of that DDI file as a separate and reformatted version of source materials (either print or electronic) and the original source materials themselves.
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. 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).
A MARCURI attribute is provided to link to the MARC record for the citation.
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.
Description: Full authoritative title for the work at the appropriate level: marked-up document; marked-up document source; study; other material(s) related to study description; other material(s) related to study. The study title will in most cases be identical to the title for the marked-up document. A full title should indicate the geographic scope of the data collection as well as the time period covered. Title of data collection (2.1.1.1) maps to Dublin Core Title element. This element is required in the Study Description citation.
Example(s):
<titl>Domestic Violence Experience in Omaha, Nebraska, 1986-1987</titl> <titl>Census of Population, 1950 [United States]: Public Use Microdata Sample</titl> <titl>Monitoring the Future: A Continuing Study of American Youth, 1995</titl>
Description: A secondary title used to amplify or state certain limitations on the main title. It may repeat information already in the main title.
Example(s):
<titl>Monitoring the Future: A Continuing Study of American Youth, 1995</titl>
<subTitl>A Continuing Study of American Youth, 1995</subTitl>
<titl>Census of Population, 1950 [United States]: Public Use Microdata Sample</titl>
<subTitl>Public Use Microdata Sample</subTitl>
Description: A title by which the work is commonly referred, or an abbreviation of the title.
Description: Title translated into another language.
Example(s):
<titl>Politbarometer West [Germany], Partial Accumulation, 1977-1995</titl> <parTitl>Politbarometer, 1977-1995: Partielle Kumulation</parTitl>
Description: Unique string or number (producer's or archive's number). An "agency" attribute is supplied. Identification Number of data collection maps to Dublin Core Identifier element.
Example(s):
<IDNo agency="ICPSR">6678</IDNo> <IDNo agency="ZA">2010</IDNo>
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.
Description:
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 (2.1.2.1) maps to Dublin Core Creator element. Inclusion of this element in codebook is recommended.
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.
Example(s):
<AuthEnty>United States Department of Commerce. Bureau of the Census</AuthEnty>
<AuthEnty affiliation="European Commission">Rabier, Jacques-Rene</AuthEnty>
Description: Statements of responsibility not recorded in the title and statement of responsibility areas. Indicate here the persons or bodies connected with the work, or significant persons or bodies connected with previous editions and not already named in the description. For example, the name of the person who edited the marked-up documentation might be cited in 1.1.2.2, using the "role" and "affiliation" attributes. Other identifications/acknowledgements for data collection (2.1.2.2) maps to Dublin Core Contributor element.
Example(s):
<othId role="editor" affiliation="INRA">Jane Smith</othId>
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.
Description: The producer is the person or organization with the financial or administrative responsibility for the physical processes whereby the document was brought into existence. Use the "role" attribute to distinguish different stages of involvement in the production process, such as original producer. Producer of data collection (2.1.3.1) maps to Dublin Core Publisher element. The "producer" in the Document Description should be the agency or person that prepared the marked-up document.
Example(s):
<producer abbr="ICPSR" affiliation="Institute for Social Research">Inter-university Consortium for Political and Social Research</producer> <producer abbr="MNPoll" affiliation="Minneapolis Star Tibune Newspaper" role="original producer"> Star Tribune Minnesota Poll</producer> <producer abbr="MRDC" affiliation="University of Minnesota" role="final production">Machine Readable Data Center</producer>
Description: Copyright statement for the work at the appropriate level. Copyright for data collection (2.1.3.2) maps to Dublin Core Rights. Inclusion of this element is recommended element.
Example(s):
<copyright>Copyright(c) ICPSR, 2000</copyright>
Description: Date when the marked-up document/marked-up document source/data collection/other material(s) were produced (not distributed or archived). The ISO standard for dates (YYYY-MM-DD) is recommended for use with the date attribute. Production date for data collection (2.1.3.3) maps to Dublin Core Date element.
Example(s):
<prodDate date="1999-01-25">January 25, 1999</prodDate>
Description: Address of the archive or organization that produced the work.
Example(s):
<prodPlac>Ann Arbor, MI: Inter-university Consortium for Political and Social Research</prodPlac>
Description: Software used to produce the work. A "version" attribute permits specification of the software version number. The "date" attribute is provided to enable specification of the date (if any) for the software release. The ISO standard for dates (YYYY-MM-DD) is recommended for use with the date attribute.
Example(s):
<docDscr><citation><prodStmt><software version="1.0">MRDC Codebook Authoring Tool</software> </prodStmt></citation></docDscr> <docDscr><citation><prodStmt><software version="8.0">Arbortext Adept Editor</software> </prodStmt></citation></docDscr> <docDscr><docSrc><prodStmt><software version="4.0">PageMaker</software></prodStmt></docSrc></docDscr> <stdyDscr><citation><prodStmt><software version="6.12">SAS</software></prodStmt></citation></stdyDscr> <fileTxt><software version="6.12">The SAS transport file was generated by the SAS CPORT procedure. </software></fileTxt>
Description: The source(s) of funds for production of the work. If different funding agencies sponsored different stages of the production process, use the "role" attribute to distinguish them.
Example(s):
<fundAg abbr="NSF" role="infrastructure">National Science Foundation</fundAg> <fundAg abbr="SUN" role="equipment">Sun Microsystems</fundAg>
Description: The grant/contract number of the project that sponsored the effort. If more than one, indicate the appropriate agency using the "agency" attribute. If different funding agencies sponsored different stages of the production process, use the "role" attribute to distinguish the grant numbers.
Example(s):
<grantNo agency="Bureau of Justice Statistics">J-LEAA-018-77</grantNo>
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.
Description: The organization designated by the author or producer to generate copies of the particular work including any necessary editions or revisions. Names and addresses may be specified and other archives may be co-distributors. A URI attribute is included to provide an URN or URL to the ordering service or download facility on a Web site.
Example(s):
<distrbtr abbr="ICPSR" affiliation="Institute for Social Research" URI="http://www.icpsr.umich.edu">Ann Arbor, MI: Inter-university Consortium for Political and Social Research</distrbtr>
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.
Example(s):
<contact affiliation="University of Wisconsin" email="jsmith@...">Jane Smith</contact>
Description: The name of the person (or institution) who provided this work to the archive storing it.
Example(s):
<depositr abbr="BJS" affiliation="U.S. Department of Justice">Bureau of Justice Statistics </depositr>
Description: The date that the work was deposited with the archive that originally received it. The ISO standard for dates (YYYY-MM-DD) is recommended for use with the "date" attribute.
Example(s):
<depDate date="1999-01-25">January 25, 1999</depDate>
Description: Date that the work was made available for distribution/presentation. The ISO standard for dates (YYYY-MM-DD) is recommended for use with the "date" attribute.
Example(s):
<distDate date="1999-01-25">January 25, 1999</distDate>
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. The URI attribute is provided to point to a central Internet repository of series information.
Description: The name of the series to which the work belongs.
Example(s):
<serName abbr="CPS">Current Population Survey Series</serName>
Description: Contains a history of the series and a summary of those features that apply to the series as a whole.
Example(s):
<serInfo>The Current Population Survey (CPS) is a household sample survey conducted monthly by the Census Bureau to provide estimates of employment, unemployment, and other characteristics of the general labor force, estimates of the population as a whole, and estimates of various subgroups in the population. The entire non-institutionalized population of the United States is sampled to obtain the respondents for this survey series.</serInfo>
Description: Version statement for the work at the appropriate level: marked-up document; marked-up document source; study; study description, other material; other material for study. A version statement may also be included for a data file, a variable, or an nCube.
Example(s):
<verStmt><version type="version" date="1999-01-25">Second version</version>
Description: Also known as release or edition. If there have been substantive changes in the data/documentation since their creation, this statement should be used at the appropriate level. The ISO standard for dates (YYYY-MM-DD) is recommended for use with the "date" attribute.
Example(s):
<version type="edition" date="1999-01-25">Second ICPSR Edition</version> <var><verStmt><version type="version" date="1999-01-25">Second version of V25</version></verStmt> </var> <nCube><verStmt><version type="version" date="1999-01-25">Second version of N25</version></verStmt> </nCube>
Description: The organization or person responsible for the version of the work.
Example(s):
<verResp>Zentralarchiv fuer Empirische Sozialforschung</verResp> <verResp>Inter-university Consortium for Political and Social Research</verResp> <var><verStmt><verResp>Zentralarchiv fuer Empirische Sozialforschung</verResp></verStmt></var> <nCube><verStmt><verResp>Zentralarchiv fuer Empirische Sozialforschung</verResp></verStmt></nCube>
Description:
For clarifying information/annotation regarding the parent element.
The attributes for notes permit a controlled vocabulary to be developed ("type" and "subject"), indicate the "level" of the DDI to which the note applies (study, file, variable, etc.), and identify the author of the note ("resp").
Example(s):
<docDscr><verStmt><notes resp="Jane Smith">Additional information on derived variables has been added to this marked-up version of the documentation.</notes></verStmt></docDscr> <docDscr><citation><notes resp="Jane Smith">This citation was prepared by the archive based on information received from the markup authors.</notes></citation></docDscr> <docSrc><verStmt><notes resp="Jane Smith">The source codebook was produced from original hardcopy materials using Optical Character Recognition (OCR).</notes><verStmt> </docSrc> <docSrc><notes>A machine-readable version of the source codebook was supplied by the Zentralarchiv</notes></docSrc> <docDscr><notes>This Document Description, or header information, can be used within an electronic resource discovery environment.</notes></docDscr> <stdyDscr><verStmt><notes resp="Jane Smith">Data for 1998 have been added to this version of the data collection.</notes></verStmt></stdyDscr> <stdyDscr><citation><notes resp="Jane Smith">This citation was sent to ICPSR by the agency depositing the data.</notes></citation></stdyDscr> <stdyInfo><notes>Data on employment and income refer to the preceding year, although demographic data refer to the time of the survey.</notes></stdyInfo> <method><notes>Undocumented codes were found in this data collection. Missing data are represented by blanks.</notes></method> <method><notes>For this collection, which focuses on employment, unemployment, and gender equality, data from EUROBAROMETER 44.3: HEALTH CARE ISSUES AND PUBLIC SECURITY, FEBRUARY-APRIL 1996 (ICPSR 6752) were merged with an oversample.</notes></method> <setAvail><notes> Data from the Bureau of Labor Statistics used in the analyses for the final report are not provided as part of this collection.</notes></setAvail> <dataAccs><notes>Users should note that this is a beta version of the data. The investigators therefore request that users who encounter any problems with the dataset contact them at the above address.</notes></dataAccs> <fileStrc><notes>The number of arrest records for an individual is dependent on the number of arrests an offender had.</notes></fileStrc> <fileTxt><verStmt><notes>Data for all previously-embargoed variables are now available in this version of the file.</notes></verStmt></fileTxt> <fileDscr><notes>There is a restricted version of this file containing confidential information, access to which is controlled by the principal investigator.</notes> </fileDscr> <varGrp><notes>This variable group was created for the purpose of combining all derived variables.</notes></varGrp> <varGrp><notes source="archive" resp="John Data">This variable group and all other variable groups in this data file were organized according to a schema developed by the adhoc advisory committee. </notes></varGrp> <nCubeGrp><notes>This nCube Group was created for the purpose of presenting a cross- tabulation between variables "Tenure" and "Age of householder."</notes></nCubeGrp> <valrng><notes subject="political party">Starting with Euro-Barometer 2 the coding of this variable has been standardized following an approximate ordering of each country's political parties along a "left" to "right" continuum in the first digit of the codes. Parties coded 01-39 are generally considered on the "left", those coded 40-49 in the "center", and those coded 60-89 on the "right" of the political spectrum. Parties coded 50-59 cannot be readily located in the traditional meaning of "left" and "right". The second digit of the codes is not significant to the "left-right" ordering. Codes 90-99 contain the response "other party" and various missing data responses. Users may modify these codings or part of these codings in order to suit their specific needs. </notes> </valrng> <invalrng><notes>Codes 90-99 contain the response "other party" and various missing data responses. </notes></invalrng> <var><verStmt><notes>The labels for categories 01 and 02 for this variable, were inadvertently switched in the first version of this variable and have now been corrected.</notes></verStmt></var> <var><notes>This variable was created by recoding location of residence to Census regions.</notes></var> <nCube><verStmt><notes>The labels for categories 01 and 02 in dimension 1 were inadvertently switched in the first version of the cube, and have now been corrected. </notes></verStmt></nCube> <nCube><notes>This nCube was created to meet the needs of local low income programs in determining eligibility for federal funds.</notes></nCube> <dataDscr><notes>The variables in this study are identical to earlier waves. </notes> </dataDscr> <otherMat><notes>Users should be aware that this questionnaire was modified during the CAI process.</notes></otherMat>
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.
Example(s):
<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>
Description: Information concerning either the physical or electronic holdings of the cited work. Attributes include: location--The physical location where a copy is held; callno--The call number for a work at the location specified; and URI--A URN or URL for accessing the electronic copy of the cited work.
Example(s):
<holdings location="ICPSR DDI Repository" callno="inap." URI="http://www.icpsr.umich.edu/DDIrepository/"> Marked-up Codebook for Current Population Survey, 1999: Annual Demographic File</holdings> <holdings location="University of Michigan Graduate Library" callno="inap." URI="http://www.umich.edu/library/"> Codebook for Current Population Survey, 1999: Annual Demographic File </holdings>
Description:
For clarifying information/annotation regarding the parent element.
The attributes for notes permit a controlled vocabulary to be developed ("type" and "subject"), indicate the "level" of the DDI to which the note applies (study, file, variable, etc.), and identify the author of the note ("resp").
Example(s):
<docDscr><verStmt><notes resp="Jane Smith">Additional information on derived variables has been added to this marked-up version of the documentation.</notes></verStmt></docDscr> <docDscr><citation><notes resp="Jane Smith">This citation was prepared by the archive based on information received from the markup authors.</notes></citation></docDscr> <docSrc><verStmt><notes resp="Jane Smith">The source codebook was produced from original hardcopy materials using Optical Character Recognition (OCR).</notes><verStmt> </docSrc> <docSrc><notes>A machine-readable version of the source codebook was supplied by the Zentralarchiv</notes></docSrc> <docDscr><notes>This Document Description, or header information, can be used within an electronic resource discovery environment.</notes></docDscr> <stdyDscr><verStmt><notes resp="Jane Smith">Data for 1998 have been added to this version of the data collection.</notes></verStmt></stdyDscr> <stdyDscr><citation><notes resp="Jane Smith">This citation was sent to ICPSR by the agency depositing the data.</notes></citation></stdyDscr> <stdyInfo><notes>Data on employment and income refer to the preceding year, although demographic data refer to the time of the survey.</notes></stdyInfo> <method><notes>Undocumented codes were found in this data collection. Missing data are represented by blanks.</notes></method> <method><notes>For this collection, which focuses on employment, unemployment, and gender equality, data from EUROBAROMETER 44.3: HEALTH CARE ISSUES AND PUBLIC SECURITY, FEBRUARY-APRIL 1996 (ICPSR 6752) were merged with an oversample.</notes></method> <setAvail><notes> Data from the Bureau of Labor Statistics used in the analyses for the final report are not provided as part of this collection.</notes></setAvail> <dataAccs><notes>Users should note that this is a beta version of the data. The investigators therefore request that users who encounter any problems with the dataset contact them at the above address.</notes></dataAccs> <fileStrc><notes>The number of arrest records for an individual is dependent on the number of arrests an offender had.</notes></fileStrc> <fileTxt><verStmt><notes>Data for all previously-embargoed variables are now available in this version of the file.</notes></verStmt></fileTxt> <fileDscr><notes>There is a restricted version of this file containing confidential information, access to which is controlled by the principal investigator.</notes> </fileDscr> <varGrp><notes>This variable group was created for the purpose of combining all derived variables.</notes></varGrp> <varGrp><notes source="archive" resp="John Data">This variable group and all other variable groups in this data file were organized according to a schema developed by the adhoc advisory committee. </notes></varGrp> <nCubeGrp><notes>This nCube Group was created for the purpose of presenting a cross- tabulation between variables "Tenure" and "Age of householder."</notes></nCubeGrp> <valrng><notes subject="political party">Starting with Euro-Barometer 2 the coding of this variable has been standardized following an approximate ordering of each country's political parties along a "left" to "right" continuum in the first digit of the codes. Parties coded 01-39 are generally considered on the "left", those coded 40-49 in the "center", and those coded 60-89 on the "right" of the political spectrum. Parties coded 50-59 cannot be readily located in the traditional meaning of "left" and "right". The second digit of the codes is not significant to the "left-right" ordering. Codes 90-99 contain the response "other party" and various missing data responses. Users may modify these codings or part of these codings in order to suit their specific needs. </notes> </valrng> <invalrng><notes>Codes 90-99 contain the response "other party" and various missing data responses. </notes></invalrng> <var><verStmt><notes>The labels for categories 01 and 02 for this variable, were inadvertently switched in the first version of this variable and have now been corrected.</notes></verStmt></var> <var><notes>This variable was created by recoding location of residence to Census regions.</notes></var> <nCube><verStmt><notes>The labels for categories 01 and 02 in dimension 1 were inadvertently switched in the first version of the cube, and have now been corrected. </notes></verStmt></nCube> <nCube><notes>This nCube was created to meet the needs of local low income programs in determining eligibility for federal funds.</notes></nCube> <dataDscr><notes>The variables in this study are identical to earlier waves. </notes> </dataDscr> <otherMat><notes>Users should be aware that this questionnaire was modified during the CAI process.</notes></otherMat>
Description: List of terms and definitions used in the documentation. Provided to assist users in using the document correctly. This element was intended to reflect the section in OSIRIS codebooks that assisted users in reading and interpreting a codebook. Each OSIRIS codebook contained a sample codebook page that defined the codebook conventions.
Description: Use this field to indicate if the documentation is being presented/distributed before it has been finalized. Some data producers and social science data archives employ data processing strategies that provide for release of data and documentation at various stages of processing.
Example(s):
<docStatus>This marked-up document includes a provisional data dictionary and brief citation only for the purpose of providing basic access to the data file. A complete codebook will be published at a later date.</docStatus>
Description: Citation for the source document. This element encodes the bibliographic information describing the source codebook, including title information, statement of responsibility, production and distribution information, series and version information, text of a preferred bibliographic citation, and notes (if any). Information for this section should be taken directly from the source document whenever possible. If additional information is obtained and entered in the elements within this section, the source of this information should be noted in the source attribute of the particular element tag. A MARCURI attribute is provided to link to the MARC record for this citation.
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.
Description: Full authoritative title for the work at the appropriate level: marked-up document; marked-up document source; study; other material(s) related to study description; other material(s) related to study. The study title will in most cases be identical to the title for the marked-up document. A full title should indicate the geographic scope of the data collection as well as the time period covered. Title of data collection (2.1.1.1) maps to Dublin Core Title element. This element is required in the Study Description citation.
Example(s):
<titl>Domestic Violence Experience in Omaha, Nebraska, 1986-1987</titl> <titl>Census of Population, 1950 [United States]: Public Use Microdata Sample</titl> <titl>Monitoring the Future: A Continuing Study of American Youth, 1995</titl>
Description: A secondary title used to amplify or state certain limitations on the main title. It may repeat information already in the main title.
Example(s):
<titl>Monitoring the Future: A Continuing Study of American Youth, 1995</titl>
<subTitl>A Continuing Study of American Youth, 1995</subTitl>
<titl>Census of Population, 1950 [United States]: Public Use Microdata Sample</titl>
<subTitl>Public Use Microdata Sample</subTitl>
Description: A title by which the work is commonly referred, or an abbreviation of the title.
Description: Title translated into another language.
Example(s):
<titl>Politbarometer West [Germany], Partial Accumulation, 1977-1995</titl> <parTitl>Politbarometer, 1977-1995: Partielle Kumulation</parTitl>
Description: Unique string or number (producer's or archive's number). An "agency" attribute is supplied. Identification Number of data collection maps to Dublin Core Identifier element.
Example(s):
<IDNo agency="ICPSR">6678</IDNo> <IDNo agency="ZA">2010</IDNo>
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.
Description:
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 (2.1.2.1) maps to Dublin Core Creator element. Inclusion of this element in codebook is recommended.
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.
Example(s):
<AuthEnty>United States Department of Commerce. Bureau of the Census</AuthEnty>
<AuthEnty affiliation="European Commission">Rabier, Jacques-Rene</AuthEnty>
Description: Statements of responsibility not recorded in the title and statement of responsibility areas. Indicate here the persons or bodies connected with the work, or significant persons or bodies connected with previous editions and not already named in the description. For example, the name of the person who edited the marked-up documentation might be cited in 1.1.2.2, using the "role" and "affiliation" attributes. Other identifications/acknowledgements for data collection (2.1.2.2) maps to Dublin Core Contributor element.
Example(s):
<othId role="editor" affiliation="INRA">Jane Smith</othId>
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.
Description: The producer is the person or organization with the financial or administrative responsibility for the physical processes whereby the document was brought into existence. Use the "role" attribute to distinguish different stages of involvement in the production process, such as original producer. Producer of data collection (2.1.3.1) maps to Dublin Core Publisher element. The "producer" in the Document Description should be the agency or person that prepared the marked-up document.
Example(s):
<producer abbr="ICPSR" affiliation="Institute for Social Research">Inter-university Consortium for Political and Social Research</producer> <producer abbr="MNPoll" affiliation="Minneapolis Star Tibune Newspaper" role="original producer"> Star Tribune Minnesota Poll</producer> <producer abbr="MRDC" affiliation="University of Minnesota" role="final production">Machine Readable Data Center</producer>
Description: Copyright statement for the work at the appropriate level. Copyright for data collection (2.1.3.2) maps to Dublin Core Rights. Inclusion of this element is recommended element.
Example(s):
<copyright>Copyright(c) ICPSR, 2000</copyright>
Description: Date when the marked-up document/marked-up document source/data collection/other material(s) were produced (not distributed or archived). The ISO standard for dates (YYYY-MM-DD) is recommended for use with the date attribute. Production date for data collection (2.1.3.3) maps to Dublin Core Date element.
Example(s):
<prodDate date="1999-01-25">January 25, 1999</prodDate>
Description: Address of the archive or organization that produced the work.
Example(s):
<prodPlac>Ann Arbor, MI: Inter-university Consortium for Political and Social Research</prodPlac>
Description: Software used to produce the work. A "version" attribute permits specification of the software version number. The "date" attribute is provided to enable specification of the date (if any) for the software release. The ISO standard for dates (YYYY-MM-DD) is recommended for use with the date attribute.
Example(s):
<docDscr><citation><prodStmt><software version="1.0">MRDC Codebook Authoring Tool</software> </prodStmt></citation></docDscr> <docDscr><citation><prodStmt><software version="8.0">Arbortext Adept Editor</software> </prodStmt></citation></docDscr> <docDscr><docSrc><prodStmt><software version="4.0">PageMaker</software></prodStmt></docSrc></docDscr> <stdyDscr><citation><prodStmt><software version="6.12">SAS</software></prodStmt></citation></stdyDscr> <fileTxt><software version="6.12">The SAS transport file was generated by the SAS CPORT procedure. </software></fileTxt>
Description: The source(s) of funds for production of the work. If different funding agencies sponsored different stages of the production process, use the "role" attribute to distinguish them.
Example(s):
<fundAg abbr="NSF" role="infrastructure">National Science Foundation</fundAg> <fundAg abbr="SUN" role="equipment">Sun Microsystems</fundAg>
Description: The grant/contract number of the project that sponsored the effort. If more than one, indicate the appropriate agency using the "agency" attribute. If different funding agencies sponsored different stages of the production process, use the "role" attribute to distinguish the grant numbers.
Example(s):
<grantNo agency="Bureau of Justice Statistics">J-LEAA-018-77</grantNo>
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.
Description: The organization designated by the author or producer to generate copies of the particular work including any necessary editions or revisions. Names and addresses may be specified and other archives may be co-distributors. A URI attribute is included to provide an URN or URL to the ordering service or download facility on a Web site.
Example(s):
<distrbtr abbr="ICPSR" affiliation="Institute for Social Research" URI="http://www.icpsr.umich.edu">Ann Arbor, MI: Inter-university Consortium for Political and Social Research</distrbtr>
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.
Example(s):
<contact affiliation="University of Wisconsin" email="jsmith@...">Jane Smith</contact>
Description: The name of the person (or institution) who provided this work to the archive storing it.
Example(s):
<depositr abbr="BJS" affiliation="U.S. Department of Justice">Bureau of Justice Statistics </depositr>
Description: The date that the work was deposited with the archive that originally received it. The ISO standard for dates (YYYY-MM-DD) is recommended for use with the "date" attribute.
Example(s):
<depDate date="1999-01-25">January 25, 1999</depDate>
Description: Date that the work was made available for distribution/presentation. The ISO standard for dates (YYYY-MM-DD) is recommended for use with the "date" attribute.
Example(s):
<distDate date="1999-01-25">January 25, 1999</distDate>
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. The URI attribute is provided to point to a central Internet repository of series information.
Description: The name of the series to which the work belongs.
Example(s):
<serName abbr="CPS">Current Population Survey Series</serName>
Description: Contains a history of the series and a summary of those features that apply to the series as a whole.
Example(s):
<serInfo>The Current Population Survey (CPS) is a household sample survey conducted monthly by the Census Bureau to provide estimates of employment, unemployment, and other characteristics of the general labor force, estimates of the population as a whole, and estimates of various subgroups in the population. The entire non-institutionalized population of the United States is sampled to obtain the respondents for this survey series.</serInfo>
Description: Version statement for the work at the appropriate level: marked-up document; marked-up document source; study; study description, other material; other material for study. A version statement may also be included for a data file, a variable, or an nCube.
Example(s):
<verStmt><version type="version" date="1999-01-25">Second version</version>
Description: Also known as release or edition. If there have been substantive changes in the data/documentation since their creation, this statement should be used at the appropriate level. The ISO standard for dates (YYYY-MM-DD) is recommended for use with the "date" attribute.
Example(s):
<version type="edition" date="1999-01-25">Second ICPSR Edition</version> <var><verStmt><version type="version" date="1999-01-25">Second version of V25</version></verStmt> </var> <nCube><verStmt><version type="version" date="1999-01-25">Second version of N25</version></verStmt> </nCube>
Description: The organization or person responsible for the version of the work.
Example(s):
<verResp>Zentralarchiv fuer Empirische Sozialforschung</verResp> <verResp>Inter-university Consortium for Political and Social Research</verResp> <var><verStmt><verResp>Zentralarchiv fuer Empirische Sozialforschung</verResp></verStmt></var> <nCube><verStmt><verResp>Zentralarchiv fuer Empirische Sozialforschung</verResp></verStmt></nCube>
Description:
For clarifying information/annotation regarding the parent element.
The attributes for notes permit a controlled vocabulary to be developed ("type" and "subject"), indicate the "level" of the DDI to which the note applies (study, file, variable, etc.), and identify the author of the note ("resp").
Example(s):
<docDscr><verStmt><notes resp="Jane Smith">Additional information on derived variables has been added to this marked-up version of the documentation.</notes></verStmt></docDscr> <docDscr><citation><notes resp="Jane Smith">This citation was prepared by the archive based on information received from the markup authors.</notes></citation></docDscr> <docSrc><verStmt><notes resp="Jane Smith">The source codebook was produced from original hardcopy materials using Optical Character Recognition (OCR).</notes><verStmt> </docSrc> <docSrc><notes>A machine-readable version of the source codebook was supplied by the Zentralarchiv</notes></docSrc> <docDscr><notes>This Document Description, or header information, can be used within an electronic resource discovery environment.</notes></docDscr> <stdyDscr><verStmt><notes resp="Jane Smith">Data for 1998 have been added to this version of the data collection.</notes></verStmt></stdyDscr> <stdyDscr><citation><notes resp="Jane Smith">This citation was sent to ICPSR by the agency depositing the data.</notes></citation></stdyDscr> <stdyInfo><notes>Data on employment and income refer to the preceding year, although demographic data refer to the time of the survey.</notes></stdyInfo> <method><notes>Undocumented codes were found in this data collection. Missing data are represented by blanks.</notes></method> <method><notes>For this collection, which focuses on employment, unemployment, and gender equality, data from EUROBAROMETER 44.3: HEALTH CARE ISSUES AND PUBLIC SECURITY, FEBRUARY-APRIL 1996 (ICPSR 6752) were merged with an oversample.</notes></method> <setAvail><notes> Data from the Bureau of Labor Statistics used in the analyses for the final report are not provided as part of this collection.</notes></setAvail> <dataAccs><notes>Users should note that this is a beta version of the data. The investigators therefore request that users who encounter any problems with the dataset contact them at the above address.</notes></dataAccs> <fileStrc><notes>The number of arrest records for an individual is dependent on the number of arrests an offender had.</notes></fileStrc> <fileTxt><verStmt><notes>Data for all previously-embargoed variables are now available in this version of the file.</notes></verStmt></fileTxt> <fileDscr><notes>There is a restricted version of this file containing confidential information, access to which is controlled by the principal investigator.</notes> </fileDscr> <varGrp><notes>This variable group was created for the purpose of combining all derived variables.</notes></varGrp> <varGrp><notes source="archive" resp="John Data">This variable group and all other variable groups in this data file were organized according to a schema developed by the adhoc advisory committee. </notes></varGrp> <nCubeGrp><notes>This nCube Group was created for the purpose of presenting a cross- tabulation between variables "Tenure" and "Age of householder."</notes></nCubeGrp> <valrng><notes subject="political party">Starting with Euro-Barometer 2 the coding of this variable has been standardized following an approximate ordering of each country's political parties along a "left" to "right" continuum in the first digit of the codes. Parties coded 01-39 are generally considered on the "left", those coded 40-49 in the "center", and those coded 60-89 on the "right" of the political spectrum. Parties coded 50-59 cannot be readily located in the traditional meaning of "left" and "right". The second digit of the codes is not significant to the "left-right" ordering. Codes 90-99 contain the response "other party" and various missing data responses. Users may modify these codings or part of these codings in order to suit their specific needs. </notes> </valrng> <invalrng><notes>Codes 90-99 contain the response "other party" and various missing data responses. </notes></invalrng> <var><verStmt><notes>The labels for categories 01 and 02 for this variable, were inadvertently switched in the first version of this variable and have now been corrected.</notes></verStmt></var> <var><notes>This variable was created by recoding location of residence to Census regions.</notes></var> <nCube><verStmt><notes>The labels for categories 01 and 02 in dimension 1 were inadvertently switched in the first version of the cube, and have now been corrected. </notes></verStmt></nCube> <nCube><notes>This nCube was created to meet the needs of local low income programs in determining eligibility for federal funds.</notes></nCube> <dataDscr><notes>The variables in this study are identical to earlier waves. </notes> </dataDscr> <otherMat><notes>Users should be aware that this questionnaire was modified during the CAI process.</notes></otherMat>
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.
Example(s):
<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>
Description: Information concerning either the physical or electronic holdings of the cited work. Attributes include: location--The physical location where a copy is held; callno--The call number for a work at the location specified; and URI--A URN or URL for accessing the electronic copy of the cited work.
Example(s):
<holdings location="ICPSR DDI Repository" callno="inap." URI="http://www.icpsr.umich.edu/DDIrepository/"> Marked-up Codebook for Current Population Survey, 1999: Annual Demographic File</holdings> <holdings location="University of Michigan Graduate Library" callno="inap." URI="http://www.umich.edu/library/"> Codebook for Current Population Survey, 1999: Annual Demographic File </holdings>
Description:
For clarifying information/annotation regarding the parent element.
The attributes for notes permit a controlled vocabulary to be developed ("type" and "subject"), indicate the "level" of the DDI to which the note applies (study, file, variable, etc.), and identify the author of the note ("resp").
Example(s):
<docDscr><verStmt><notes resp="Jane Smith">Additional information on derived variables has been added to this marked-up version of the documentation.</notes></verStmt></docDscr> <docDscr><citation><notes resp="Jane Smith">This citation was prepared by the archive based on information received from the markup authors.</notes></citation></docDscr> <docSrc><verStmt><notes resp="Jane Smith">The source codebook was produced from original hardcopy materials using Optical Character Recognition (OCR).</notes><verStmt> </docSrc> <docSrc><notes>A machine-readable version of the source codebook was supplied by the Zentralarchiv</notes></docSrc> <docDscr><notes>This Document Description, or header information, can be used within an electronic resource discovery environment.</notes></docDscr> <stdyDscr><verStmt><notes resp="Jane Smith">Data for 1998 have been added to this version of the data collection.</notes></verStmt></stdyDscr> <stdyDscr><citation><notes resp="Jane Smith">This citation was sent to ICPSR by the agency depositing the data.</notes></citation></stdyDscr> <stdyInfo><notes>Data on employment and income refer to the preceding year, although demographic data refer to the time of the survey.</notes></stdyInfo> <method><notes>Undocumented codes were found in this data collection. Missing data are represented by blanks.</notes></method> <method><notes>For this collection, which focuses on employment, unemployment, and gender equality, data from EUROBAROMETER 44.3: HEALTH CARE ISSUES AND PUBLIC SECURITY, FEBRUARY-APRIL 1996 (ICPSR 6752) were merged with an oversample.</notes></method> <setAvail><notes> Data from the Bureau of Labor Statistics used in the analyses for the final report are not provided as part of this collection.</notes></setAvail> <dataAccs><notes>Users should note that this is a beta version of the data. The investigators therefore request that users who encounter any problems with the dataset contact them at the above address.</notes></dataAccs> <fileStrc><notes>The number of arrest records for an individual is dependent on the number of arrests an offender had.</notes></fileStrc> <fileTxt><verStmt><notes>Data for all previously-embargoed variables are now available in this version of the file.</notes></verStmt></fileTxt> <fileDscr><notes>There is a restricted version of this file containing confidential information, access to which is controlled by the principal investigator.</notes> </fileDscr> <varGrp><notes>This variable group was created for the purpose of combining all derived variables.</notes></varGrp> <varGrp><notes source="archive" resp="John Data">This variable group and all other variable groups in this data file were organized according to a schema developed by the adhoc advisory committee. </notes></varGrp> <nCubeGrp><notes>This nCube Group was created for the purpose of presenting a cross- tabulation between variables "Tenure" and "Age of householder."</notes></nCubeGrp> <valrng><notes subject="political party">Starting with Euro-Barometer 2 the coding of this variable has been standardized following an approximate ordering of each country's political parties along a "left" to "right" continuum in the first digit of the codes. Parties coded 01-39 are generally considered on the "left", those coded 40-49 in the "center", and those coded 60-89 on the "right" of the political spectrum. Parties coded 50-59 cannot be readily located in the traditional meaning of "left" and "right". The second digit of the codes is not significant to the "left-right" ordering. Codes 90-99 contain the response "other party" and various missing data responses. Users may modify these codings or part of these codings in order to suit their specific needs. </notes> </valrng> <invalrng><notes>Codes 90-99 contain the response "other party" and various missing data responses. </notes></invalrng> <var><verStmt><notes>The labels for categories 01 and 02 for this variable, were inadvertently switched in the first version of this variable and have now been corrected.</notes></verStmt></var> <var><notes>This variable was created by recoding location of residence to Census regions.</notes></var> <nCube><verStmt><notes>The labels for categories 01 and 02 in dimension 1 were inadvertently switched in the first version of the cube, and have now been corrected. </notes></verStmt></nCube> <nCube><notes>This nCube was created to meet the needs of local low income programs in determining eligibility for federal funds.</notes></nCube> <dataDscr><notes>The variables in this study are identical to earlier waves. </notes> </dataDscr> <otherMat><notes>Users should be aware that this questionnaire was modified during the CAI process.</notes></otherMat>
Description:
For clarifying information/annotation regarding the parent element.
The attributes for notes permit a controlled vocabulary to be developed ("type" and "subject"), indicate the "level" of the DDI to which the note applies (study, file, variable, etc.), and identify the author of the note ("resp").
Example(s):
<docDscr><verStmt><notes resp="Jane Smith">Additional information on derived variables has been added to this marked-up version of the documentation.</notes></verStmt></docDscr> <docDscr><citation><notes resp="Jane Smith">This citation was prepared by the archive based on information received from the markup authors.</notes></citation></docDscr> <docSrc><verStmt><notes resp="Jane Smith">The source codebook was produced from original hardcopy materials using Optical Character Recognition (OCR).</notes><verStmt> </docSrc> <docSrc><notes>A machine-readable version of the source codebook was supplied by the Zentralarchiv</notes></docSrc> <docDscr><notes>This Document Description, or header information, can be used within an electronic resource discovery environment.</notes></docDscr> <stdyDscr><verStmt><notes resp="Jane Smith">Data for 1998 have been added to this version of the data collection.</notes></verStmt></stdyDscr> <stdyDscr><citation><notes resp="Jane Smith">This citation was sent to ICPSR by the agency depositing the data.</notes></citation></stdyDscr> <stdyInfo><notes>Data on employment and income refer to the preceding year, although demographic data refer to the time of the survey.</notes></stdyInfo> <method><notes>Undocumented codes were found in this data collection. Missing data are represented by blanks.</notes></method> <method><notes>For this collection, which focuses on employment, unemployment, and gender equality, data from EUROBAROMETER 44.3: HEALTH CARE ISSUES AND PUBLIC SECURITY, FEBRUARY-APRIL 1996 (ICPSR 6752) were merged with an oversample.</notes></method> <setAvail><notes> Data from the Bureau of Labor Statistics used in the analyses for the final report are not provided as part of this collection.</notes></setAvail> <dataAccs><notes>Users should note that this is a beta version of the data. The investigators therefore request that users who encounter any problems with the dataset contact them at the above address.</notes></dataAccs> <fileStrc><notes>The number of arrest records for an individual is dependent on the number of arrests an offender had.</notes></fileStrc> <fileTxt><verStmt><notes>Data for all previously-embargoed variables are now available in this version of the file.</notes></verStmt></fileTxt> <fileDscr><notes>There is a restricted version of this file containing confidential information, access to which is controlled by the principal investigator.</notes> </fileDscr> <varGrp><notes>This variable group was created for the purpose of combining all derived variables.</notes></varGrp> <varGrp><notes source="archive" resp="John Data">This variable group and all other variable groups in this data file were organized according to a schema developed by the adhoc advisory committee. </notes></varGrp> <nCubeGrp><notes>This nCube Group was created for the purpose of presenting a cross- tabulation between variables "Tenure" and "Age of householder."</notes></nCubeGrp> <valrng><notes subject="political party">Starting with Euro-Barometer 2 the coding of this variable has been standardized following an approximate ordering of each country's political parties along a "left" to "right" continuum in the first digit of the codes. Parties coded 01-39 are generally considered on the "left", those coded 40-49 in the "center", and those coded 60-89 on the "right" of the political spectrum. Parties coded 50-59 cannot be readily located in the traditional meaning of "left" and "right". The second digit of the codes is not significant to the "left-right" ordering. Codes 90-99 contain the response "other party" and various missing data responses. Users may modify these codings or part of these codings in order to suit their specific needs. </notes> </valrng> <invalrng><notes>Codes 90-99 contain the response "other party" and various missing data responses. </notes></invalrng> <var><verStmt><notes>The labels for categories 01 and 02 for this variable, were inadvertently switched in the first version of this variable and have now been corrected.</notes></verStmt></var> <var><notes>This variable was created by recoding location of residence to Census regions.</notes></var> <nCube><verStmt><notes>The labels for categories 01 and 02 in dimension 1 were inadvertently switched in the first version of the cube, and have now been corrected. </notes></verStmt></nCube> <nCube><notes>This nCube was created to meet the needs of local low income programs in determining eligibility for federal funds.</notes></nCube> <dataDscr><notes>The variables in this study are identical to earlier waves. </notes> </dataDscr> <otherMat><notes>Users should be aware that this questionnaire was modified during the CAI process.</notes></otherMat>