Return to PSG Models documentation page

SSASIM input table IND

Contains specification of cohort individuals, including gender, education, family composition, and ages of certain life events, as well as a foreign key that points to rows in a child table specifying the individual's age-earnings profile. In addition, there are parameters that control whether a year-by-year trace of benefit calculation details is written to the computer screen for an individual. There is one table row for each individual.

Parent table is: INDS

Child table is: EARNPCT

Go to SSASIM input parameters overview

SSASIM:   IND . id
Identifies a cohort individual with specified attributes. Each individual should be different so id value is unique.

Valid values: 1 to 999999999 (nine digits), Integer

Source code: ind.h and ind.cpp

SSASIM:   IND . notes
Describes specification of table row in free-form note.

Valid values: any ASCII text (Note: do not copy and paste from a word processor because of the possibility of embedded non-ASCII characters.)

Source code: notes are not read by the model

SSASIM:   IND . male
Specifies gender of cohort individual with true (T) indicating that individual is male and false (F) indicating individual is female.

Valid values: T (=1) or F (=0) (for true or false), Logical

Source code: ind.h and ind.cpp

SSASIM:   IND . educ
Specifies education of cohort individual using the same values as in GEMINI output, which are: 0, no high school (died before entering school); 1, high school dropout; 2, high school graduate; 3, attended some college; 4, four-year college degree or graduate degree. The values of this parameter effect only the calculation of voluntary account participation rates (see the ACCTBEH table for more details).

Valid values: 0 to 4, Integer

Source code: ind.h and ind.cpp

SSASIM:   IND . earnpct_id
Identifies one set of rows in EARNPCT table that represent this individual's lifetime pattern of annual earnings measured relative to national average wage index (AWI).

Valid values: 1 to 999999999 (nine digits), Integer

Source code: ind.h and ind.cpp

SSASIM:   IND . disab_age
Specifies age at which this individual becomes disabled. Set disab_age to 999 if individual never becomes disabled.

Valid values: 25 to 999, Integer

Source code: ind.h and ind.cpp

SSASIM:   IND . retire_age
Specifies age at which individual plans to first receive retirement benefits. This age must be between earliest and latest retirement ages specified in OAIBEN policy table for individuals in this birth cohort. If individual does have an account, then at retire_age an annuity is purchased (if this behavior is specified by a positive value of ACCTDYN.annuity_bf for the year individual attains retire_age) and account withdrawals begin (if ACCTDYN.annuity_bf is less than one for the year individual attains retire_age).

Valid values: OAIBEN.era to OAIBEN.lra, Integer

Source code: ind.h and ind.cpp

SSASIM:   IND . death_age
Specifies age at which individual dies. Remember that in SSASIM the death event occurs at the end of the year, which means that a retire_age of 67 and a death_age of 67 implies the individual claims benefits at the beginning of the year and dies at the end of that year after receiving one year of benefits.

Valid values: 0 to 125, Integer

Source code: ind.h and ind.cpp

SSASIM:   IND . trace_db
Specifies whether or not year-by-year trace of OASDI defined-benefit calculations (including lifetime earnings, AIME, PIA, and retired-worker, spousal, survivors, and disability benefits) for the specified trace scenario (see trace_scen below) are written to computer screen during execution of model run. Large volume of information written to computer screen implies need to use the runlog option when starting SSASIM and to use an editor to browse or print the resulting run.log file. NOTE: no more than one individual can be traced in an ECI mode run.

Valid values: T (=1) or F (=0) (for true or false), Logical

Source code: ind.h and ind.cpp

SSASIM:   IND . trace_dc
Specifies whether or not year-by-year trace of OASDI defined-contribution calculations (including account contributions, investment returns, and withdrawals) for the specified trace scenario (see trace_scen below) are written to computer screen during execution of model run. Large volume of information written to computer screen implies need to use the runlog option when starting SSASIM and to use an editor to browse or print the resulting run.log file. NOTE: no more than one individual can be traced in an ECI mode run.

Valid values: T (=1) or F (=0) (for true or false), Logical

Source code: ind.h and ind.cpp

SSASIM:   IND . trace_scen
Specifies the simulation scenario for which a year-by-year trace of OASDI defined-benefit and/or defined-contribution calculations are written to computer screen during execution of model run. Active only when trace_db or trace_dc is true; see trace_db and trace_dc above for details.

Valid values: 1 to RUN.scenarios, Integer

Source code: ind.h and ind.cpp

SSASIM:   IND . spouse_id_
Specifies IND.id value of individual to whom this individual is married. Value of zero implies this individual never marries and never plans kids. Two married individuals must "point" to each other via this spouse_id_ field.

Valid values: 0 to 999999999, (nine digits) Integer [0 means not married]

Source code: couple.h and couple.cpp

SSASIM:   IND . age_kid1
Specifies parents' age at planned birth of first planned kid. As many as four planned kids are permitted; they must be listed in the correct birth order; multiple births are permitted; kids never die. Death of a parent at end of a year prevents planned conceptions in future years. So, last planned birth occurs in year after a parent's death. If couple is not planning to have a first kid, specify a value of 99.

Valid values: 17 to 40, Integer [99 is OK]

Source code: ind.h and ind.cpp

SSASIM:   IND . age_kid2
Specifies parents' age at planned birth of second planned kid. As many as four planned kids are permitted; they must be listed in the correct birth order; multiple births are permitted; kids never die. Death of a parent at end of a year prevents planned conceptions in future years. So, last planned birth occurs in year after a parent's death. If couple is not planning to have a second kid, specify a value of 99.

Valid values: 17 to 40, Integer [age_kid2 >= age_kid1] [99 is OK]

Source code: ind.h and ind.cpp

SSASIM:   IND . age_kid3
Specifies parents' age at planned birth of third planned kid. As many as four planned kids are permitted; they must be listed in the correct birth order; multiple births are permitted; kids never die. Death of a parent at end of a year prevents planned conceptions in future years. So, last planned birth occurs in year after a parent's death. If couple is not planning to have a third kid, specify a value of 99.

Valid values: 17 to 40, Integer [age_kid3 >= age_kid2] [99 is OK]

Source code: ind.h and ind.cpp

SSASIM:   IND . age_kid4
Specifies parents' age at planned birth of fourth planned kid. As many as four planned kids are permitted; they must be listed in the correct birth order; multiple births are permitted; kids never die. Death of a parent at end of a year prevents planned conceptions in future years. So, last planned birth occurs in year after a parent's death. If couple is not planning to have a fourth kid, specify a value of 99.

Valid values: 17 to 40, Integer [age_kid4 >= age_kid3] [99 is OK]

Source code: ind.h and ind.cpp