IHSN Template

Study Description

File Description

Variable Description

Name Path Description

Document Description

Metadata Preparation
Metadata Producer DocumentDescription_Citation_ProductionStatement_Producers
Name of the person(s) or organization(s) who documented the dataset. Use the "role" attribute to distinguish different stages of involvement in the production process. 

Examples:
Name: National Statistics Office (NSO)	
Role: Documentation of the study	

Name: International Household Survey Network (IHSN)  
Role: Review of the metadata	

Date of Production DocumentDescription_Citation_ProductionStatement_ProductionDate
This is the date (in ISO format YYYY-MM-DD) the DDI document was produced (not distributed or archived). This date will be automatically imputed when you save the file.
DDI Document Version DocumentDescription_Citation_Version_Text
Documenting a dataset is not a trivial exercise. Producing "perfect" metadata is probably impossible. It may therefore happen that, having identified errors in a DDI document or having received suggestions for improvement, you decide to modify the Document even after a first version has been disseminated. This element is used to identify and describe the current version of the document. It is good practice to provide a version number (and date), and information on what distinguishes this version from the previous one(s) if relevant. 

Example:
Version 1.1 (July 2006). This version is identical to version 1.0, except for the section on Data Appraisal which was updated.
DDI Document ID Number DocumentDescription_Citation_TitleStatement_IDNumber
The ID number of a DDI document is a unique number that is used to identify this DDI file. Define and use a consistent scheme to use. Such an ID could be constructed as follows: DDI-country-producer-survey-year where
- country is the 3-letter ISO country abbreviation
- producer is the abbreviation of the producing agency
- survey is the survey abbreviation 
- year is the reference year (or the year the survey started)
- DDI document version number

Example: 

The DDI file related to the Demographic and Health Survey documented by staff from the Uganda Bureau of Statistics in 2005 would have the following ID: 
DDI-UGA-UBOS-DHS-2005-v01. 

If the same survey is documented by a staff from the IHSN, this would be DDI-UGA-IHSN-DHS-205-v01.
DocumentDescription_Citation_Holdings_URI
Collection(s) DocumentDescription_Citation_Acknowledgments
Identification
Title StudyDescription_Citation_TitleStatement_Title
The title is the official name of the survey as it is stated on the questionnaire or as it appears in the design documents. The following items should be noted:
- Include the reference year(s) of the survey in the title. 
- Do not include the abbreviation of the survey name in the title.
- As the survey title is a proper noun, the first letter of each word should be capitalized (except for prepositions or other conjunctions). 
- Including the country name in the title is optional.

The title will in most cases be identical to the Document Title (see above). 

Examples: 	
- National Household Budget Survey 2002-2003
- Popstan Multiple Indicator Cluster Survey 2002
Subtitle StudyDescription_Citation_TitleStatement_SubTitle
Subtitle is optional and rarely used. A subtitle can be used to add information usually associated with a sequential qualifier for a survey. 

Example: 
	
Title: Welfare Monitoring Survey 2007
Subtitle: Fifth round
Abbreviation StudyDescription_Citation_TitleStatement_AlternativeTitle
The abbreviation of a survey is usually the first letter of each word of the titled survey. The survey reference year(s) may be included.

Examples: 	
- DHS 2000 for "Demographic and Health Survey 2005"
- HIES 2002-2003 for "Household Income and Expenditure Survey 2003"

Study Type StudyDescription_Citation_SeriesName
The study type or survey type is the broad category defining the survey. 

This item has a controlled vocabulary (you may customize the IHSN template to adjust this controlled vocabulary if needed).
Series Information StudyDescription_Citation_SeriesInformation
A survey may be repeated at regular intervals (such as an annual labour force survey), or be part of an international survey program (such as the MICS, CWIQ, DHS, LSMS and others). The Series information is a description of this "collection" of surveys. A brief description of the characteristics of the survey, including when it started, how many rounds were already implemented, and who is in charge would be provided here. If the survey does not belong to a series, leave this field empty.

Example:

The Multiple Indicator Cluster Survey, Round 3 (MICS3) is the third round of MICS surveys, previously conducted around 1995 (MICS1) and 2000 (MICS2).  MICS surveys are designed by UNICEF, and implemented by national agencies in participating countries. MICS was designed to monitor various indicators identified at the World Summit for Children and the Millennium Development Goals. 
Many questions and indicators in MICS3 are consistent and compatible with the prior round of MICS (MICS2) but less so with MICS1, although there have been a number of changes in definition of indicators between rounds. 
Round 1 covered X countries, round 2 covered Y countries, and Round Z covered N countries. 
Translated Title StudyDescription_Citation_TitleStatement_ParallelTitle
In countries with more than one official language, a translation of the title may be provided. Likewise, the translated title may simply be a translation into English from a country's own language. Special characters should be properly displayed (such as accents and other stress marks or different alphabets).
ID Number StudyDescription_Citation_TitleStatement_IDNumber
The ID number of a dataset is a unique number that is used to identify a particular survey. Define and use a consistent scheme to use. Such an ID could be constructed as follows: country-producer-survey-year-version where
- country is the 3-letter ISO country abbreviation
- producer is the abbreviation of the producing agency
- survey is the survey abbreviation 
- year is the reference year (or the year the survey started)
- version is the number dataset version number (see Version Description below)

Example: 
The Demographic and Health Survey implemented by the Uganda Bureau of Statistics in 2005 could have the following ID: UGA-UBOS-DHS-2005-v01. 
Version
Description StudyDescription_Citation_Version_Text
The version description should contain a version number followed by a version label. The version number should follow a standard convention to be adopted by the institute. We recommend that larger series be defined by a number to the left of a decimal and iterations of the same series by a sequential number that identifies the release. Larger series will typically include (0) the raw, unedited dataset; (1) the edited dataset, non anonymized, for internal use at the data producing agency; and (2) the edited dataset, prepared for dissemination to secondary users (possibly anonymized). 

Examples:
- v0.1:  Basic raw data, obtained from data entry (before editing).
- v1.2:  Edited data, second version, for internal use only.
- v2.1:  Edited, anonymous dataset for public distribution.

A brief description of the version should follow the numerical identification.
Production Date StudyDescription_Citation_Version_Date
This is the date in ISO format (yyyy-mm-dd) of actual and final production of the data. Production dates of all versions should be carefully tracked. Provide at least the month and year. Use the calendar icon in the Metadata editor to assure that the date selected is in compliance with the ISO format.
Notes StudyDescription_Citation_Version_Notes
Version notes should provide a brief report on the changes made through the versioning process. The note should indicate how this version differs from other versions of the same dataset.
Overview
Abstract StudyDescription_Scope_Abstract
The abstract should provide a clear summary of the purposes, objectives and content of the survey. It should be written by a researcher or survey statistician aware of the survey.
Kind of Data StudyDescription_Scope_SummaryDataDescription_DataKind
This field is a broad classification of the data and it is associated with a drop down box providing controlled vocabulary. That controlled vocabulary includes 9 items but is not limited to them.
Unit of Analysis StudyDescription_Scope_SummaryDataDescription_AnalysisUnit
Basic unit(s) of analysis or observation that the study describes: individuals, families/households, groups, facilities, institutions/organizations, administrative units, physical locations, etc.

Examples:
- A living standards survey with community-level questionnaire would have the following units of analysis: individuals, households, and communities.
- An economic survey could have the firm and establishment as units of analysis.

Scope
Description of Scope StudyDescription_Scope_Notes
The scope is a description of the themes covered by the survey. It can be viewed as a summary of the modules that are included in the questionnaire. The scope does not deal with geographic coverage. 

Example:

The scope of the Multiple Indicator Cluster Survey includes:
- HOUSEHOLD: Household characteristics, household listing, orphaned and vulnerable children, education, child labour, water and sanitation, household use of insecticide treated mosquito nets, and salt iodization, with optional modules for child discipline, child disability, maternal mortality and security of tenure and durability of housing.
- WOMEN: Women's characteristics, child mortality, tetanus toxoid, maternal and newborn health, marriage, polygyny, female genital cutting, contraception, and HIV/AIDS knowledge, with optional modules for unmet need, domestic violence, and sexual behavior.
- CHILDREN: Children's characteristics, birth registration and early learning, vitamin A, breastfeeding, care of illness, malaria, immunization, and anthropometry, with an optional module for child development.
Topics Classifications StudyDescription_Scope_TopicClassifications
A topic classification facilitates referencing and searches in electronic survey catalogs. Topics should be selected from a standard thesaurus, preferably an international, multilingual thesaurus. 

The IHSN recommends the use of the thesaurus used by the Council of European Social Science Data Archives (CESSDA). The CESSDA thesaurus has been introduced as a controlled vocabulary in the IHSN Study Template version 1.3 (available at www.surveynetwork.org/toolkit <http://www.surveynetwork.org/toolkit>).
Keywords StudyDescription_Scope_Keywords
Keywords summarize the content or subject matter of the survey. As topic classifications, these are used to facilitate referencing and searches in electronic survey catalogs. 

Keywords should be selected from a standard thesaurus, preferably an international, multilingual thesaurus. Entering a list of keywords is tedious. This option is provided for advanced users only.
Coverage
Country StudyDescription_Scope_SummaryDataDescription_Countries
Enter the country name, even in cases where the survey did not cover the entire country. In the field "Abbreviation", we recommend that you enter the 3-letter ISO code of the country. If the dataset you document covers more than one country, enter all in separate rows.

Geographic Coverage StudyDescription_Scope_SummaryDataDescription_GeographicCoverage
This filed aims at describing at what geographic level the data are representative. Typical entries will be "National coverage", "Urban (or rural) areas only", "State of ...", "Capital city", etc. 

Note that we do not describe here where the data was collected. For example, as sample survey could be declared as "national coverage" even in cases where some districts where not included in the sample, as long as the sampling strategy was such that the representativity is national. 
Universe StudyDescription_Scope_SummaryDataDescription_Universe
We are interested here in the survey universe (not the universe of particular sections of the questionnaires or variables), i.e. in the identification of the population of interest in the survey. The universe will rarely be the entire population of the country. Sample household surveys, for example, usually do not cover homeless, nomads, diplomats, community households. Population censuses do not cover diplomats. Try to provide the most detailed information possible on the population covered by the survey/census.

Example:

The survey covered all de jure household members (usual residents), all women aged 15-49 years resident in the household, and all children aged 0-4 years (under age 5) resident in the household.
Producers and Sponsors
Primary Investigator StudyDescription_Citation_Authors
The primary investigator will in most cases be an institution, but could also be an individual in the case of small-scale academic surveys. The two fields to be completed are the Name and the Affiliation fields. 

Generally, in a survey, the Primary Investigator will be the institution implementing the survey. If various institutions have been equally involved as main investigators, then all should be mentioned. This only includes the agencies responsible for the implementation of the survey, not its funding or technical assistance. 

The order in which they are listed is discretionary. It can be alphabetic or by significance of contribution. Individual persons can also be mentioned. If persons are mentioned use the appropriate format of Surname, First name. 
Other Producers StudyDescription_Citation_ProductionStatement_Producers
This field is provided to list other interested parties and persons that have played a significant but not the leading technical role in implementing and producing the data. The specific fields to be competed are: Name of the organization, Abbreviation, Affiliation and Role. If any of the fields are not applicable these can be left blank. The abbreviations should be the official abbreviation of the organization.  

The role should be a short and succinct phrase or description on the specific assistance provided by the organization in order to produce the data. 

The roles should be standard vocabulary such as:
- [Technical assistance in] questionnaire design
- [Technical assistance in] sampling methodology / selection
- [Technical assistance in] data collection
- [Technical assistance in] data processing
- [Technical assistance in] data analysis

Do not include here the financial sponsors.
Funding StudyDescription_Citation_ProductionStatement_Fundings
List the organizations (national or international) that have contributed, in cash or in kind, to the financing of the survey. 

The government institution that has provided funding should not be forgotten.
Other Acknowledgments StudyDescription_Citation_Acknowledgments
This optional field can be used to acknowledge any other people and institutions that have in some form contributed to the survey. 


Sampling
Sampling Procedure StudyDescription_Methodology_Sampling
This field only applies to sample surveys. Information on sampling procedure is crucial (although not applicable for censuses and administrative datasets). This section should include summary information that includes though is not limited to:
- Sample size
- Selection process (e.g., probability proportional to size or over sampling)
- Stratification (implicit and explicit)
- Stages of sample selection
- Design omissions in the sample
- Level of representation
- Strategy for absent respondents/not found/refusals (replacement or not) 
- Sample frame used, and listing exercise conducted to update it

It is useful also to indicate here what variables in the data files identify the various levels of stratification and the primary sample unit. These are crucial to the data users who want to properly account for the sampling design in their analyses and calculations of sampling errors. 

This section accepts only text format; formulae cannot be entered. In most cases, technical documents will exist that describe the sampling strategy in detail. In such cases, include here a reference (title/author/date) to this document, and make sure that the document is provided in the External Resources. 

Example:

5000 households were selected for the sample. Of these, 4996 were occupied households and 4811 were successfully interviewed for a response rate of 96.3%.  Within these households, 7815 eligible women aged 15-49 were identified for interview, of which 7505 were successfully interviewed (response rate 96.0%), and 3242 children aged 0-4 were identified for whom the mother or caretaker was successfully interviewed for 3167 children (response rate 97.7%). These give overall response rates (household response rate times individual response rate) for the women's interview of 92.5% and for the children's interview of 94.1%.
Deviations from Sample Design StudyDescription_Methodology_Deviations
This field only applies to sample surveys.

Sometimes the reality of the field requires a deviation from the sampling design (for example due to difficulty to access to zones due to weather problems, political instability, etc). If for any reason, the sample design has deviated, this should be reported here. 


Response Rates StudyDescription_Methodology_ResponseRate
Response rate provides that percentage of households (or other sample unit) that participated in the survey based on the original sample size. Omissions may occur due to refusal to participate, impossibility to locate the respondent, or other.  Sometimes, a household may be replaced by another by design. Check that the information provided here is consistent with the sample size indicated in the "Sampling procedure" field and the number of records found in the dataset (for example, if the sample design mention a sample of 5,000 households and the data on contain data on 4,500 households, the response rate should not be 100 percent).

Provide if possible the response rates by stratum. If information is available on the causes of non-response (refusal/not found/other), provide this information as well.

This field can also in some cases be used to describe non-responses in population censuses.
Weighting StudyDescription_Methodology_Weighting
This field only applies to sample surveys.

Provide here the list of variables used as weighting coefficient. If more than one variable is a weighting variable, describe how these variables differ from each other and what the purpose of each one of them is. 

Example:

Sample weights were calculated for each of the data files.
Sample weights for the household data were computed as the inverse of the probability of selection of the household, computed at the sampling domain level (urban/rural within each region). The household weights were adjusted for non-response at the domain level, and were then normalized by a constant factor so that the total weighted number of households equals the total unweighted number of households. The household weight variable is called HHWEIGHT and is used with the HH data and the HL data.
Sample weights for the women's data used the un-normalized household weights, adjusted for non-response for the women's questionnaire, and were then normalized by a constant factor so that the total weighted number of women's cases equals the total unweighted number of women's cases.
Sample weights for the children's data followed the same approach as the women's and used the un-normalized household weights, adjusted for non-response for the children's questionnaire, and were then normalized by a constant factor so that the total weighted number of children's cases equals the total unweighted number of children's cases.
Data Collection
Dates of Collection StudyDescription_Scope_SummaryDataDescription_CollectionDates
Enter the dates (at least month and year) of the start and end of the data collection. 

DATE MUST BE ENTERED IN THE ISO FORMAT YYYY-MM-DD

In some cases, data collection for a same survey can be conducted in waves. In such case, you should enter the start and end date of each wave separately, and identify each wave in the "cycle" field. 
Time Periods StudyDescription_Scope_SummaryDataDescription_TimePeriods
This field will usually be left empty. Time period differs from the dates of collection as they represent the period for which the data collected are applicable or relevant. 

NOTE: DATE MUST BE ENTERED IN THE FORMAT YYYY-MM-DD
Mode of Data Collection StudyDescription_Methodology_CollectionMethod
The mode of data collection is the manner in which the interview was conducted or information was gathered. This field is a controlled vocabulary field. 

Use the drop-down button in the Toolkit to select one option. In most cases, the response will be "face to face interview". But for some specific kinds of datasets, such as for example data on rain falls, the response will be different.




Notes on Data Collection StudyDescription_Methodology_CollectionSituation
This element is provided in order to document any specific observations, occurrences or events during data collection. Consider stating such items like:
- Was a training of enumerators held? (elaborate)
- Any events that could have a bearing on the data quality?
- How long did an interview take on average?
- Was there a process of negotiation between households, the community and the implementing agency?
- Are anecdotal events recorded?
- Have the field teams contributed by supplying information on issues and occurrences during data collection? 
- In what language was the interview conducted?
- Was a pilot survey conducted? 
- Were there any corrective actions taken by management when problems occurred in the field?

Example:

The pre-test for the survey took place from August 15, 2006 - August 25, 2006 and included 14 interviewers who would later become supervisors for the main survey.

Each interviewing team comprised of 3-4 female interviewers (no male interviewers were used due to the sensitivity of the subject matter), together with a field editor and a supervisor and a driver. A total of 52 interviewers, 14 supervisors and 14 field editors were used. Data collection took place over a period of about 6 weeks from September 2, 2006 until October 17, 2006. Interviewing took place everyday throughout the fieldwork period, although interviewing teams were permitted to take one day off per week. 

Interviews averaged 35 minutes for the household questionnaire (excluding salt testing), 23 minutes for the women's questionnaire, and 27 for the under five children's questionnaire (excluding the anthropometry).  Interviews were conducted primarily in English and Mumbo-jumbo, but occasionally used local translation in double-Dutch, when the respondent did not speak English or Mumbo-jumbo.

Six staff members of GenCenStat provided overall fieldwork coordination and supervision.  The overall field coordinator was Mrs. Doe.
 

Questionnaires StudyDescription_Methodology_ResearchInstrument
This element is provided to describe the questionnaire(s) used for the data collection. The following should be mentioned:
- List of questionnaires and short description of each (all questionnaires must be provided as External Resources)
- In what language were the questionnaires published?
- Information on the questionnaire design process (based on a previous questionnaire, based on a standard model questionnaire, review by stakeholders). If a document was compiled that contains the comments provided by the stakeholders on the draft questionnaire, or a report prepared on the questionnaire testing, a reference to these documents should be provided here and the documents should be provided as External Resources.

Example:

The questionnaires for the Generic MICS were structured questionnaires based on the MICS3 Model Questionnaire with some modifications and additions. A household questionnaire was administered in each household, which collected various information on household members including sex, age, relationship, and orphanhood status. The household questionnaire includes household characteristics, support to orphaned and vulnerable children, education, child labour, water and sanitation, household use of insecticide treated mosquito nets, and salt iodization, with optional modules for child discipline, child disability, maternal mortality and security of tenure and durability of housing.

In addition to a household questionnaire, questionnaires were administered in each household for women age 15-49 and children under age five. For children, the questionnaire was administered to the mother or caretaker of the child. 

The women's questionnaire include women's characteristics, child mortality, tetanus toxoid, maternal and newborn health, marriage, polygyny, female genital cutting, contraception, and HIV/AIDS knowledge, with optional modules for unmet need, domestic violence, and sexual behavior.

The children's questionnaire includes children's characteristics, birth registration and early learning, vitamin A, breastfeeding, care of illness, malaria, immunization, and anthropometry, with an optional module for child development.

The questionnaires were developed in English from the MICS3 Model Questionnaires, and were translated into Mumbo-jumbo. After an initial review the questionnaires were translated back into English by an independent translator with no prior knowledge of the survey. The back translation from the Mumbo-jumbo version was independently reviewed and compared to the English original. Differences in translation were reviewed and resolved in collaboration with the original translators.
The English and Mumbo-jumbo questionnaires were both piloted as part of the survey pretest.

All questionnaires and modules are provided as external resources.
Data Collectors StudyDescription_Methodology_DataCollectors
This element is provided in order to record information regarding the persons and/or agencies that took charge of the data collection. This element includes 3 fields: Name, Abbreviation and the Affiliation. In most cases, we will record here the name of the agency, not the name of interviewers. Only in the case of very small-scale surveys, with a very limited number of interviewers, the name of person will be included as well. The field Affiliation is optional and not relevant in all cases.

Example:

Name: Central Statistics Office
Abbreviation: CSO
Affiliation: Ministry of Planning 
Supervision StudyDescription_Methodology_MinimizeLossActions
This element will provide information on the oversight of the data collection. The following should be considered:
- Were the enumerators organized in teams that included a controller and a supervisor? With how many controllers/supervisors per interviewer?
- What were the main roles of the controllers/supervisors?
- Were there visits to the field by upper management? How often?

Example:

Interviewing was conducted by teams of interviewers. Each interviewing team comprised of 3-4 female interviewers, a field editor and a supervisor, and a driver.  Each team used a 4 wheel drive vehicle to travel from cluster to cluster (and where necessary within cluster).

The role of the supervisor was to coordinator field data collection activities, including management of the field teams, supplies and equipment, finances, maps and listings, coordinate with local authorities concerning the survey plan and make arrangements for accommodation and travel. Additionally, the field supervisor assigned the work to the interviewers, spot checked work, maintained field control documents, and sent completed questionnaires and progress reports to the central office.  

The field editor was responsible for reviewing each questionnaire at the end of the day, checking for missed questions, skip errors, fields incorrectly completed, and checking for inconsistencies in the data.  The field editor also observed interviews and conducted review sessions with interviewers.

Responsibilities of the supervisors and field editors are described in the Instructions for Supervisors and Field Editors, together with the different field controls that were in place to control the quality of the fieldwork.

Field visits were also made by a team of central staff on a periodic basis during fieldwork. The senior staff of GenCenStat also made 3 visits to field teams to provide support and to review progress.
Data Processing
Data Editing StudyDescription_Methodology_CleaningOperations
The data editing should contain information on how the data was treated or controlled for in terms of consistency and coherence. This item does not concern the data entry phase but only the editing of data whether manual or automatic. 
- Was a hot deck or a cold deck technique used to edit the data?
- Were corrections made automatically (by program), or by visual control of the questionnaire?
- What software was used?  

If materials are available (specifications for data editing, report on data editing, programs used for data editing), they should be listed here and provided as external resources. 

Example:

Data editing took place at a number of stages throughout the processing, including:
a) Office editing and coding
b) During data entry
c) Structure checking and completeness
d) Secondary editing
e) Structural checking of SPSS data files
Detailed documentation of the editing of data can be found in the "Data processing guidelines" document provided as an external resource.
Other Processing StudyDescription_Methodology_Notes
Use this field to provide as much information as possible on the data entry design. This includes such details as:
- Mode of data entry (manual or by scanning, in the field/in regions/at headquarters)
- Computer architecture (laptop computers in the field, desktop computers, scanners, PDA, other; indicate the number of computers used)
- Software used 
- Use (and rate) of double data entry 
- Average productivity of data entry operators; number of data entry operators involved and their work schedule

Information on tabulation and analysis can also be provided here. 

All available materials (data entry/tabulation/analysis programs; reports on data entry) should be listed here and provided as external resources.

Example:

Data were processed in clusters, with each cluster being processed as a complete unit through each stage of data processing.  Each cluster goes through the following steps:
1) Questionnaire reception
2) Office editing and coding
3) Data entry
4) Structure and completeness checking
5) Verification entry
6) Comparison of verification data
7) Back up of raw data
8) Secondary editing
9) Edited data back up

After all clusters are processed, all data is concatenated together and then the following steps are completed for all data files:
10) Export to SPSS in 4 files (hh - household, hl - household members, wm - women, ch - children under 5)
11) Recoding of variables needed for analysis
12) Adding of sample weights
13) Calculation of wealth quintiles and merging into data
14) Structural checking of SPSS files
15) Data quality tabulations
16) Production of analysis tabulations
 
Details of each of these steps can be found in the data processing documentation, data editing guidelines, data processing programs in CSPro and SPSS, and tabulation guidelines.

Data entry was conducted by 12 data entry operators in tow shifts, supervised by 2 data entry supervisors, using a total of 7 computers (6 data entry computers plus one supervisors' computer).  All data entry was conducted at the GenCenStat head office using manual data entry.  For data entry, CSPro version 2.6.007 was used with a highly structured data entry program, using system controlled approach that controlled entry of each variable.  All range checks and skips were controlled by the program and operators could not override these.  A limited set of consistency checks were also included in the data entry program.  In addition, the calculation of anthropometric Z-scores was also included in the data entry programs for use during analysis. Open-ended responses ("Other" answers) were not entered or coded, except in rare circumstances where the response matched an existing code in the questionnaire.   

Structure and completeness checking ensured that all questionnaires for the cluster had been entered, were structurally sound, and that women's and children's questionnaires existed for each eligible woman and child. 
100% verification of all variables was performed using independent verification, i.e. double entry of data, with separate comparison of data followed by modification of one or both datasets to correct keying errors by original operators who first keyed the files. 

After completion of all processing in CSPro, all individual cluster files were backed up before concatenating data together using the CSPro file concatenate utility.
For tabulation and analysis SPSS versions 10.0 and 14.0 were used.  Version 10.0 was originally used for all tabulation programs, except for child mortality.  Later version 14.0 was used for child mortality, data quality tabulations and other analysis activities.

After transferring all files to SPSS, certain variables were recoded for use as background characteristics in the tabulation of the data, including grouping age, education, geographic areas as needed for analysis.  In the process of recoding ages and dates some random imputation of dates (within calculated constraints) was performed to handle missing or "don't know" ages or dates.  Additionally, a wealth (asset) index of household members was calculated using principal components analysis, based on household assets, and both the score and quintiles were included in the datasets for use in tabulations.
Data Appraisal
Estimates of Sampling Error StudyDescription_Methodology_SamplingErrorEstimates
For sampling surveys, it is good practice to calculate and publish sampling error. This field is used to provide information on these calculations. This includes:
- A list of ratios/indicators for which sampling errors were computed. 
- Details regarding the software used for computing the sampling error, and reference to the programs used (to be provided as external resources) as the program used to perform the calculations.
- Reference to the reports or other document where the results can be found (to be provided as external resources). 

Example:

Estimates from a sample survey are affected by two types of errors: 1) non-sampling errors and 2) sampling errors. Non-sampling errors are the results of mistakes made in the implementation of data collection and data processing.  Numerous efforts were made during implementation of the 2005-2006 MICS to minimize this type of error, however, non-sampling errors are impossible to avoid and difficult to evaluate statistically.

 If the sample of respondents had been a simple random sample, it would have been possible to use straightforward formulae for calculating sampling errors.  However, the 2005-2006 MICS sample is the result of a multi-stage stratified design, and consequently needs to use more complex formulae. The SPSS complex samples module has been used to calculate sampling errors for the 2005-2006 MICS.  This module uses the Taylor linearization method of variance estimation for survey estimates that are means or proportions. This method is documented in the SPSS file CSDescriptives.pdf found under the Help, Algorithms options in SPSS. 

Sampling errors have been calculated for a select set of statistics (all of which are proportions due to the limitations of the Taylor linearization method) for the national sample, urban and rural areas, and for each of the five regions.  For each statistic, the estimate, its standard error, the coefficient of variation (or relative error -- the ratio between the standard error and the estimate), the design effect, and the square root design effect (DEFT -- the ratio between the standard error using the given sample design and the standard error that would result if a simple random sample had been used), as well as the 95 percent confidence intervals (+/-2 standard errors).

Details of the sampling errors are presented in the sampling errors appendix to the report and in the sampling errors table presented in the external resources.
Other Forms of Data Appraisal StudyDescription_Methodology_DataAppraisal
This section can be used to report any other action taken to assess the reliability of the data, or any observations regarding data quality. This item can include:
- For a population census, information on the post enumeration survey (a report should be provided in external resources and mentioned here). 
- For any survey/census, a comparison with data from another source.
- Etc.

Example:

A series of data quality tables and graphs are available to review the quality of the data and include the following:
- Age distribution of the household population
- Age distribution of eligible women and interviewed women
- Age distribution of eligible children and children for whom the mother or caretaker was interviewed
- Age distribution of children under age 5 by 3 month groups
- Age and period ratios at boundaries of eligibility
- Percent of observations with missing information on selected variables
- Presence of mother in the household and person interviewed for the under 5 questionnaire
- School attendance by single year age
- Sex ratio at birth among children ever born, surviving and dead by age of respondent
- Distribution of women by time since last birth
- Scatter plot of weight by height, weight by age and height by age
- Graph of male and female population by single years of age
- Population pyramid
 
The results of each of these data quality tables are shown in the appendix of the final report and are also given in the external resources section.
 
The general rule for presentation of missing data in the final report tabulations is that a column is presented for missing data if the percentage of cases with missing data is 1% or more. Cases with missing data on the background characteristics (e.g. education) are included in the tables, but the missing data rows are suppressed and noted at the bottom of the tables in the report (not in the SPSS output, however).
Data Access
Access Authority StudyDescription_AccessConditions_UseStatement_Contacts
This section is composed of various sections: Name-Affiliation-email-URI. This information provides the contact person or entity to gain authority to access the data. It is advisable to use a generic email contact such as data@popstatsoffice.org <mailto:data@popstatsoffice.org> whenever possible to avoid tying access to a particular individual whose functions may change over time.
Confidentiality StudyDescription_AccessConditions_UseStatement_ConfidentialityDeclaration_Text
If the dataset is not anonymized, we may indicate here what Affidavit of Confidentiality must be signed before the data can be accessed. Another option is to include this information in the next element (Access conditions). If there is no confidentiality issue, this field can be left blank.

An example of statement could be the following:
Confidentiality of respondents is guaranteed by Articles N to NN of the National Statistics Act of [date]. 
Before being granted access to the dataset, all users have to formally agree: 
1. To make no copies of any files or portions of files to which s/he is granted access except those authorized by the data depositor. 
2. Not to use any technique in an attempt to learn the identity of any person, establishment, or sampling unit not identified on public use data files. 
3. To hold in strictest confidence the identification of any establishment or individual that may be inadvertently revealed in any documents or discussion, or analysis. Such inadvertent identification revealed in her/his analysis will be immediately brought to the attention of the data depositor.

This statement does not replace a more comprehensive data agreement (see Access condition).   
Access Conditions StudyDescription_AccessConditions_UseStatement_Conditions
Each dataset should have an "Access policy" attached to it. The IHSN recommends three levels of accessibility:
- Public use files, accessible to all
- Licensed datasets, accessible under conditions
- Datasets only accessible in a data enclave, for the most sensitive and confidential data.

The IHSN has formulated standard, generic policies and access forms for each one of these three levels (which each country can customize to its specific needs). One of the three policies may be copy/pasted in this field once it has been edited as needed and approved by the appropriate authority. Before you fill this field, a decision has to be made by the management of the data depositor agency. Avoid writing a specific statement for each dataset. 
If the access policy is subject to regular changes, you should enter here a URL where the user will find detailed information on access policy which applies to this specific dataset. If the datasets are sold, pricing information should also be provided on a website instead of being entered here.

If the access policy is not subject to regular changes, you may enter more detailed information here. For a public use file for example, you could enter information like:
The dataset has been anonymized and is available as a Public Use Dataset. It is  accessible to all for statistical and research purposes only, under the following terms and conditions:
1. The data and other materials will not be redistributed or sold to other individuals, institutions, or organizations without the written agreement of the [National Data Archive]. 
2. The data will be used for statistical and scientific research purposes only. They will be used solely for reporting of aggregated information, and not for investigation of specific individuals or organizations. 
3. No attempt will be made to re-identify respondents, and no use will be made of the identity of any person or establishment discovered inadvertently. Any such discovery would immediately be reported to the [National Data Archive]. 
4. No attempt will be made to produce links among datasets provided by the [National Data Archive], or among data from the [National Data Archive] and other datasets that could identify individuals or organizations. 
5. Any books, articles, conference papers, theses, dissertations, reports, or other publications that employ data obtained from the [National Data Archive] will cite the source of data in accordance with the Citation Requirement provided with each dataset. 
6. An electronic copy of all reports and publications based on the requested data will be sent to the [National Data Archive]. 

The original collector of the data, the [National Data Archive], and the relevant funding agencies bear no responsibility for use of the data or for interpretations or inferences based upon such uses. 
Citation Requirement StudyDescription_AccessConditions_UseStatement_CitationRequirement
Citation requirement is the way that the dataset should be referenced when cited in any publication. Every dataset should have a citation requirement. This will guarantee that the data producer gets proper credit, and that analytical results can be linked to the proper version of the dataset. The Access Policy should explicitly mention the obligation to comply with the citation requirement. The citation should include at least the primary investigator, the name and abbreviation of the dataset, the reference year, and the version number. Include also a website where the data or information on the data is made available by the official data depositor.

Example:

"National Statistics Office of Popstan, Multiple Indicators Cluster Survey 2000 (MICS 2000), Version 1.1 of the public use dataset (April 2001), provided by the National Data Archive. www.nda_popstan.org"
Disclaimer and Copyright
Disclaimer StudyDescription_AccessConditions_UseStatement_Disclaimer
A disclaimer limits the liability that the Statistics Office has regarding the use of the data. A standard legal statement should be used for all datasets from a same agency. The IHSN recommends the following formulation:

The user of the data acknowledges that the original collector of the data, the authorized distributor of the data, and the relevant funding agency bear no responsibility for use of the data or for interpretations or inferences based upon such uses. 
Copyright StudyDescription_Citation_ProductionStatement_Copyright
Include here a copyright statement on the dataset, such as:
(c) 2007, Popstan Central Statistics Agency
Contacts
Contact Persons StudyDescription_Citation_DistributorStatement_Contacts
Users of the data may need further clarification and information. This section may include the name-affiliation-email-URI of one or multiple contact persons. Avoid putting the name of individuals. The information provided here should be valid for the long term. It is therefore preferable to identify contact persons by a title. The same applies for the email field. Ideally, a "generic" email address should be provided. It is easy to configure a mail server in such a way that all messages sent to the generic email address would be automatically forwarded to some staff members.

Example:

Name: Head, Data Processing Division
Affiliation: National Statistics Office
Email: dataproc@cso.org
URI: www.cso.org/databank 
Data Files
Contents FileDescription_FileContents
A data filename usually provides little information on its content. Provide here a description of this content. This description should clearly distinguish collected variables and derived variables. It is also useful to indicate the availability in the data file of some particular variables such as the weighting coefficients. If the file contains derived variables, it is good practice to refer to the computer program that generated it.

Examples:

- The file contains data related to section 3A of the household survey questionnaire (Education of household members aged 6 to 24 years). It also contains the weighting coefficient, and various recoded variables on levels of education.

- The file contains derived data on household consumption, annualized and aggregated by category of products and services. The file also contains a regional price deflator variable and the household weighting coefficient. The file was generated using a Stata program named "cons_aggregate.do" available in the external resources.
Producer FileDescription_ProductionPlace
Put the name of the agency that produced the data file. Most data files will have been produced by the survey primary investigator. In some cases however, auxiliary or derived files from other producers may be released with a data set. This may for example include CPI data generated by a different agency, or files containing derived variables generated by a researcher.
Version FileDescription_Version_Text
A data file may undergo various changes and modifications. These file specific versions can be tracked in this element. This field will in most cases be left empty. It is more important to fill the field identifying the version of the dataset (see above).
Processing Checks FileDescription_ProcessingChecks
Use this element if needed to provide information about the types of checks and operations that have been performed on the data file to make sure that the data are as correct as possible, e.g. consistency checking, wildcode checking, etc. Note that the information included here should be specific to the data file. Information about data processing checks that have been carried out on the data collection (study) as a whole should be provided in the "Data editing" element at the study level.

You may also provide here a reference to an external resource that contains the specifications for the data processing checks (that same information may be provided also in the "Data Editing" filed in the Study Description section). 
Missing Data FileDescription_MissingData
Missing data can be given certain coding. A common convention is to iterate the number "9"to fill a field. This value needs to be defined as missing in the data set and can be explained in detail in this element.
Notes FileDescription_Notes
This field, aiming to provide information to the user on items not covered elsewhere, will in most cases be left empty.
Description
Definition VarDoc_Text
This element provides a space to describe the variable in detail. Not all variables require definition. The following variables should always be defined when available in a questionnaire:
- Household (attach this definition to the "household ID" variable
- Head of household (attach this definition to the variable "relationship to the head"
- Urban/rural
Universe VarDoc_Universe
The universe at the variable level reflects skip patterns within-records in a questionnaire. This information can typically be copy/pasted from the survey questionnaire. Try to be as specific as possible. This information is very useful for the analyst.

In many cases, a block of variables will have the same universe (for example, a block of variables on education can all relate to the population aged 6 to 24 year). The Toolkit allows you to select multiple variables and enter the universe information to all variables at once. 
Source of Information VarDoc_ResponseUnit
Enter information regarding who provided the information contained within the variable. In most cases, the source will be "Head of household" or "Household member". But it may also be 
- GPS measure (for geographic position)
- Interviewer's visual observation (for type of dwelling)
- Best informant in community
- Etc.


Concepts VarDoc_Concepts
Greater description on the nature of the variable can be placed in this element. For example this element can provide a clearer definition for certain variables (i.e. a variable that provides information on whether a person is a household member). In the case of household membership, a conceptual definition can be provided. 

Example: 

A household member is defined as any person who has been resident in the household for six months or more in a given year and takes meals together OR by default the head of household, infants under 6 months, newly wedded couples etc. 

Question
Pre-Question Text VarDoc_PreQuestion
The pre-question texts are the instructions provided to the interviewers and printed in the questionnaire before the literal question. This does not apply to all variables. Do not confuse this with instructions provided in the interviewer's manual. With this and the next two fields, one should be able to understand how the question was asked during the interview. See example below.

The literal question is the full text of the questionnaire as the enumerator is expected to ask it when conducting the interview. This does not apply to all variables (it does not apply to derived variables).

The post-question texts are instructions provided to the interviewers, printed in the questionnaire after the literal question. Post-question can be used to enter information on skips provided in the questionnaire. This does not apply to all variables. Do not confuse this with instructions provided in the interviewer's manual. With this and the next two fields, one should be able to understand how the question was asked during the interview. See example above.

Example:

- Pre-question: Check age. If child is 3 years old or more, ask:
- Literal question: Does (name) attend any organized learning or early childhood education programme, such as private or government facility, including kindergarten or community child care?
- Post-question: If answer is 2 or 9 > Goto next module
Literal Question VarDoc_LiteralQuestion
The pre-question texts are the instructions provided to the interviewers and printed in the questionnaire before the literal question. This does not apply to all variables. Do not confuse this with instructions provided in the interviewer's manual. With this and the next two fields, one should be able to understand how the question was asked during the interview. See example below.

The literal question is the full text of the questionnaire as the enumerator is expected to ask it when conducting the interview. This does not apply to all variables (it does not apply to derived variables).

The post-question texts are instructions provided to the interviewers, printed in the questionnaire after the literal question. Post-question can be used to enter information on skips provided in the questionnaire. This does not apply to all variables. Do not confuse this with instructions provided in the interviewer's manual. With this and the next two fields, one should be able to understand how the question was asked during the interview. See example above.

Example:

- Pre-question: Check age. If child is 3 years old or more, ask:
- Literal question: Does (name) attend any organized learning or early childhood education programme, such as private or government facility, including kindergarten or community child care?
- Post-question: If answer is 2 or 9 > Goto next module

Post-Question Text VarDoc_PostQuestion
The pre-question texts are the instructions provided to the interviewers and printed in the questionnaire before the literal question. This does not apply to all variables. Do not confuse this with instructions provided in the interviewer's manual. With this and the next two fields, one should be able to understand how the question was asked during the interview. See example below.

The literal question is the full text of the questionnaire as the enumerator is expected to ask it when conducting the interview. This does not apply to all variables (it does not apply to derived variables).

The post-question texts are instructions provided to the interviewers, printed in the questionnaire after the literal question. Post-question can be used to enter information on skips provided in the questionnaire. This does not apply to all variables. Do not confuse this with instructions provided in the interviewer's manual. With this and the next two fields, one should be able to understand how the question was asked during the interview. See example above.

Example:

- Pre-question: Check age. If child is 3 years old or more, ask:
- Literal question: Does (name) attend any organized learning or early childhood education programme, such as private or government facility, including kindergarten or community child care?
- Post-question: If answer is 2 or 9 > Goto next module
Interviewer Instructions VarDoc_InterviewerInstructions
Copy/paste the instructions provided to the interviewers in the interviewer's manual. In cases where some instructions relate to multiple variables, repeat the information in all variables. The Toolkit allows you to select multiple variables and enter the information to all these variables at once.
Imputation and Derivation
Imputation VarDoc_Imputation
The field is provided to record any imputation or replacement technique used to correct inconsistent or unreasonable data.  

It is recommended that this field provide a summary of what was done and include a reference to a file in the external resources section.
Recoding and Derivation VarDoc_CodingInstructions
This element applies to data that were obtained by recoding collected variables, or by calculating new variables that were not directly obtained from data collection. It is very important to properly document such variables. Poorly documented variables cannot (or should not) be used by researchers. In cases where the recoding or derivation method was very simple, a full description can be provided here. For example, if variable AGE_GRP was obtained by recoding variable S1Q3, we could simply mention "Variable obtained by recoding the age in years provided in variable S1Q3 into age groups for years 0-4, 5-9, ..., 60-64, 65 and over. Code 99 indicates unknown age."

When the derivation method is more complex, provide here a reference to a document (and/or computer program) to be provided as an External Resource. This will be the case for example for a variable "TOT_EXP" containing the household annual total expenditure, obtained from a household budget survey. In such case, the information provided here could be:
"This variable provides the annual household expenditure. It was obtained by aggregating expenditure data on all goods and services, available in sections 4 to 6 of the household questionnaire. It contains imputed rental values for owner-occupied dwellings. The values have been deflated by a regional price deflator available in variable REG_DEF". All values are in local currency. Outliers have been fixed. Details on the calculations are available in Appendix 2 of the Report on Data Processing, and in the Stata program "aggregates.do" available in external resources. 
Others
Security VarDoc_Security
This field will be left empty in most cases. It can be used to identify variables that are direct identifiers of the respondents (or highly identifying indirect identifiers), and that should not be released.
Notes VarDoc_Notes
This element is provided in order to record any additional or auxiliary information related to the specific variable.