Learn R Programming

NestedCategBayesImpute (version 1.2.1)

checkSZ: The new implementation of checkconstraints and will evently replace checkconstraints.

Description

Checking a data matrix of households for the possible/impossible status under a predefined set of structural zeros.

Usage

checkSZ(Data_to_check, h)

Arguments

Data_to_check

The household data matrix that is to be checked for structure zero constriants.

h

The household size for the households to be checked.

Value

A list containing information on checking result.

outcome

An indicator vector for the possible/impossible household status under constraints.

Households

A data matrix for impossible households.

Index

A vector for the original indexes of households when possible households are found. Generally not to be used.

synHouseholds

A data matrix for possible households.

possible

The actual number of possible households returned.

Details

Given an input household data matrix, these functions will check the possible/impossible status of each household and also output the desired number of possible and impossible households separately. checkconstraints checks constraints when the household head is included as an individual within the household.

The predefined list of structural zeros currently included should be viewed as an example of a system of constraints. It was derived by treating a subset of the 2012 American Community Survey as a population, and identifying combinations involving the relationship variable that do not appear in the data. This list should not be interpreted as a ``true'' list of impossible combinations in the target population. We force the combinations of variables in this list to have zero probability to be consistent with the 2012 ACS public use file that we used in the example.

The structural zeros included are:

  • Each household must contain exactly one head and he/she must be at least 16 years old.

  • Each household cannot contain more than one spouse and he/she must be at least 16 years old.

  • Married couples are of opposite sex, and age difference between individuals in the couples cannot exceed 49.

  • The household head must be older than the oldest child by at least 7.

  • The youngest parent must be older than the household head by at least 10.

  • The youngest parent-in-law must be older than the household head by at least 4.

  • The age difference between the household head and siblings cannot exceed 37.

  • The household head must be at least 34 years old. Also, the household head must be older than the oldest grandchild by at least 26.

Users can modify the list of structural zeros by downloading the package source, making changes only to the checkconstraints_imp.cpp file and re-building the package. Please note that the structural zeros have been specified according to the structure of our example data so that the specific column indexes and levels of age, gender and relationship to household head variables in subsequent data sets must match those in our example data. For more information on the structure of the data, see the documentation of the RunModel function.