Return to PSG Models documentation page

GEMINI input table STATS

Contains specification of which output files are produced by GEMINI.

Parent table is: SAMPLE

There are no child tables.

Go to GEMINI input parameters overview

GEMINI:   STATS . id
Identifies desired output files specified on this row of table, so id value should be unique.

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

GEMINI:   STATS . notes
Describes specification of table row in free-form note.

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

GEMINI:   STATS . sum
Specifies whether or not output statistics are written to the .sum file.

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

GEMINI:   STATS . arc
Specifies whether or not output statistics are written to the .arc file. IMPORTANT NOTE: when using the educational version of GEMINI with RUN.use_inctax=T (in order to estimate after-tax pension benefits), writing of the .arc output file is suppressed.

Documentation information on output statistics in this result file is available by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

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

GEMINI:   STATS . adq
Specifies whether or not output statistics are written to the .adq file.

Documentation information on output statistics in this result file is available by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

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

GEMINI:   STATS . adq_dc_pen
Specifies whether or not .adq DC output statistics are for employer-sponsored pensions or for social security individual accounts. For details, see the documentation on .adq output statistics by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

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

GEMINI:   STATS . equivs_p
Specifies value of the P parameter in the National Academy equivalence scale formula: s=(A+PK)^F, "where A is the number of adults in the family, K is the number of children [aged STATS.max_k_age or less], each of whom is treated as a proportion P of an adult, and F is the scale economy factor. The formula calculates the number of adult equivalents (A+PK) and raises the result to a power F that reflects economies of scale for larger families. We recommend values for both P and F near 0.70; to be specific, we recommend setting P at 0.70 (i.e., each child is treated as 70% of an adult) and F in the range of 0.65 to 0.75." (C.Citro and R.Michael, editors, Measuring Poverty: A New Approach, Washington, DC: National Academy Press, 1995, pages 161-162.

The above recommended parameter value is appropriate when equivalent consumption levels across different families are desired. If, on the other hand, equivalent incomes are not desired, it would be appropriate to set STATS.equivs_p equal to zero and STATS.equivs_f to one, which implements simple fifty-fifty sharing of individual income plus spouse income.

Note that this equivalence scale formula is applied in each year of an individual's life, using the number of adults and the number of children in the individual's family for that year. The total family income for a year is divided by the value of the formula for that year to compute a family-size-adjusted income for the individual in that year. These family-size-adjusted annual income amounts are often summarized into lifetime statistics, such as present value.

Valid values: 0.0 to 1.0, Real

GEMINI:   STATS . max_k_age
Specifies the maximum age for family children to be counted as part of the K total in the the National Academy equivalence scale formula: s=(A+PK)^F, "where A is the number of adults in the family, K is the number of children [aged STATS.max_k_age or less], each of whom is treated as a proportion P of an adult, and F is the scale economy factor. The formula calculates the number of adult equivalents (A+PK) and raises the result to a power F that reflects economies of scale for larger families. We recommend values for both P and F near 0.70; to be specific, we recommend setting P at 0.70 (i.e., each child is treated as 70% of an adult) and F in the range of 0.65 to 0.75." (C.Citro and R.Michael, editors, Measuring Poverty: A New Approach, Washington, DC: National Academy Press, 1995, pages 161-162.

Valid values: 17 to 21, Integer

GEMINI:   STATS . equivs_f
Specifies value of the F parameter in the National Academy equivalence scale formula: s=(A+PK)^F, "where A is the number of adults in the family, K is the number of children [aged STATS.max_k_age or less], each of whom is treated as a proportion P of an adult, and F is the scale economy factor. The formula calculates the number of adult equivalents (A+PK) and raises the result to a power F that reflects economies of scale for larger families. We recommend values for both P and F near 0.70; to be specific, we recommend setting P at 0.70 (i.e., each child is treated as 70% of an adult) and F in the range of 0.65 to 0.75." (C.Citro and R.Michael, editors, Measuring Poverty: A New Approach, Washington, DC: National Academy Press, 1995, pages 161-162.

The above recommended parameter value is appropriate when equivalent consumption levels across different families are desired. If, on the other hand, equivalent incomes are not desired, it would be appropriate to set STATS.equivs_p equal to zero and STATS.equivs_f to one, which implements simple fifty-fifty sharing of individual income plus spouse income.

Note that this equivalence scale formula is applied in each year of an individual's life, using the number of adults and the number of children in the individual's family for that year. The total family income for a year is divided by the value of the formula for that year to compute a family-size-adjusted income for the individual in that year. These family-size-adjusted annual income amounts are often summarized into lifetime statistics, such as present value.

Valid values: 0.0 to 1.0, Real

GEMINI:   STATS . calc_irr
Specifies whether or not IRR statistics are calculated for each sample individual. If set to false (F), both the irrfrc and irrind statistic in the .sum output file have a value of -inf. If set to true (T), the irrfrc statistic is a real IRR calculated using family (equivalence-scale-adjusted) OASDI benefits (and account withdrawals including annuity payments) and payroll taxes (and account contributions), and the irrind statistic is a real IRR calculated using individual OASDI benefits (and account withdrawals including annuity payments) and payroll taxes (and account contributions). In both cases, the real IRR is expressed in percentage terms. The presence of multiple IRR values is reported in the irrf_2 and irri_2 statistics in the .sum output results file. In the case of multiple IRR values, the value of the reported statistic is computed using an algorithm similar to that used by the HP-12C calculator.

IMPORTANT NOTE: the default value of this parameter is false (F). If IRR statistics are desired for each sample individual, the value of this parameter must be set to true (T) in the run specification file.

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

GEMINI:   STATS . scn
Specifies whether or not output statistics are written to the .scn file.

Documentation information on output statistics in this result file is available by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

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

GEMINI:   STATS . sid
Specifies whether or not output statistics are written to the .sid file. IMPORTANT NOTE: the value of the STATS.scn parameter must be true whenever the value of STATS.sid is true.

Documentation information on output statistics in this result file is available by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

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

GEMINI:   STATS . scnsid_ind
Specifies whether individual or adult-equivalent-couple benefits and earnings are used to compute statistics included in the scn and sid output files. A value of T (=1) implies individual benefits and earnings are used in the calculations. A value of F (=0) implies adult-equivalent-couple benefits and earnings are used in the calculations.

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

GEMINI:   STATS . scnsid_ra
Specifies constant relative risk aversion (crra) parameter used in utility function used to compute expected-utility certainty-equivalent statistics for the .sid output file. A crra value of zero implies no risk aversion, which means that the certainty-equivalent is equal to the mean. A crra value of one implies a log utility function.

Valid values: 0.0 to 10.0, Real

GEMINI:   STATS . cpi
Specifies whether or not output statistics are written to the .cpi file. IMPORTANT NOTE: the value of the STATS.cpi parameter must always be true.

Documentation information on output statistics in this result file is available by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

Valid values: T (for true=yes), Logical

GEMINI:   STATS . bta
Specifies whether or not output statistics are written to the .bta file, which is required input for the Willingness-To-Pay CALCulator (wtpcalc) that compute aggregate OASDI money's worth statistics for the native-born individuals in a cohort sample.

IMPORTANT NOTE: the value of the STATS.bta parameter can be true only if scenarios=1 in a PSG model run operating in RCS mode (and not in OLC mode) where GEMINI:RUN.only_esp=F (that is, OASDI benefits and taxes are being calculated).

IMPORTANT NOTE: be sure that each run that writes .bta results is simulating a solvent OASDI program over the life of the birth cohort, otherwise the money's worth statistics computed from the .bta output file using the Willingness-To-Pay CALCulator (wtpcalc) will be meaningless.

IMPORTANT NOTE: when using the educational version of GEMINI with RUN.use_inctax=T (in order to estimate after-tax pension benefits), writing of the .bta output file is suppressed.

Documentation information on output statistics in this result file is available by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

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

GEMINI:   STATS . bti
Specifies whether or not output statistics are written to the .bti file, which provides individual level detail for the aggregate statistics in the .bta output file (see above). IMPORTANT NOTE: the value of the STATS.bti parameter can be true only if STATS.bta=T. IMPORTANT NOTE: when using the educational version of GEMINI with RUN.use_inctax=T (in order to estimate after-tax pension benefits), writing of the .bti output file is suppressed.

Documentation information on output statistics in this result file is available by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

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

GEMINI:   STATS . bti_drate
Specifies constant nominal annual discount rate (expressed in percentage terms) used to compute the present value statistics in the .bti output file (see above).

Valid values: 0.0 to 9.0, Real

GEMINI:   STATS . atx
Specifies whether or not output statistics are written to the .atx file, which contains an after-federal-income-tax family income statistic, and federal-income-tax liability, for living cohort sample individuals at age STATS.atx_age.

IMPORTANT NOTE: the value of the STATS.atx parameter can be true only if GEMINI:RUN.use_inctax=T and either GEMINI:RUN.iti_write=T or GEMINI:RUN.iti_read=T.

Documentation information on output statistics in this result file is available by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

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

GEMINI:   STATS . atx_age
Specifies age for which statistics are collected in the .atx output file. The atx_age value is read only if STATS.atx=T.

Valid values: 20 to 100, Integer

GEMINI:   STATS . xsa_olc
Specifies whether or not information is written to an xsa output file when GEMINI is operating in support of a SSASIM OLC mode run. This information is collected from a set of survey questions posed to all simulated cohort sample individuals who are alive and have immigrated by the time of the scheduled interview, which is conducted in the calendar year specified by the STATS.xsa_year field. This cross-sectional survey consists of a set of core questions and an optional set of supplementary questions, which is specified by the STATS.xsa_suppl field. See the documentation (out_xsa.h) of the .xsa output file for the core and supplement questions.

The output file is named xsaNNNNN.YYY, where NNNNN denotes the run number and YYY denotes the last three digits of the cohort birth year. Many birth cohort will be alive in the survey year resulting in many xsaNNNNN.YYY files. These files are combined into one all-cohort cross-section file by pressing the GEMINI Data button in the EDA Toolkit. The resulting combined file is named runNNNNN.xsa and the component files are erased. The number of individuals included in the runNNNNN.xsa file is controlled by the value of the SSASIM:OLC.sample_pct field. Remember that OLC mode runs never simulate cohorts born before 1935.

Documentation information on output statistics in this result file is available by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

Valid values: T (=1) or F (=0) (for true or false), Logical [if not operating in OLC model, xsa_olc=T generates an error]

GEMINI:   STATS . xsa_year
Specifies the calendar year in which the cross-section survey is conducted: see STATS.xsa_olc for details. Remember that the oldest birth cohort simulated by GEMINI is born in 1935, which means that if you want the xsa cross-section survey sample to include all cohorts alive (maximum age is 125), you must set xsa_year equal to be no less than 2060 (1935+125).

Valid values: 1995 to 2099, Integer

GEMINI:   STATS . xsa_suppl
Specifies which set of supplementary questions are included in the cross-section survey: see STATS.xsa_olc for details. A value of zero implies only the core questions are included in the survey. See the documentation (out_xsa.h) of the .xsa output results file for the core and supplement questions.

IMPORTANT NOTE: the value of STATS.xsa_suppl can be 4 only if GEMINI:RUN.use_inctax=T and either GEMINI:RUN.iti_write=T or GEMINI:RUN.iti_read=T.

Valid values: 0 to 4, Integer

GEMINI:   STATS . xsb_olc
Specifies whether or not information is written to an xsb output file when GEMINI is operating in support of a SSASIM OLC mode run. This information is collected from a set of survey questions posed to all simulated cohort sample individuals who are alive and have immigrated by the time of the scheduled interview, which is conducted in the calendar year specified by the STATS.xsb_year field. This cross-sectional survey consists of a set of core questions and an optional set of supplementary questions, which is specified by the STATS.xsb_suppl field. See the documentation (out_xsb.h) of the .xsb results file for the core and supplement questions.

The output file is named xsbNNNNN.YYY, where NNNNN denotes the run number and YYY denotes the last three digits of the cohort birth year. Many birth cohort will be alive in the survey year resulting in many xsbNNNNN.YYY files. These files are combined into one all-cohort cross-section file by pressing the GEMINI Data button in the EDA Toolkit. The resulting combined file is named runNNNNN.xsb and the component files are erased. The number of individuals included in the runNNNNN.xsb file is controlled by the value of the SSASIM:OLC.sample_pct field. Remember that OLC mode runs never simulate cohorts born before 1935.

Documentation information on output statistics in this result file is available by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

Valid values: T (=1) or F (=0) (for true or false), Logical [if not operating in OLC model, xsb_olc=T generates an error]

GEMINI:   STATS . xsb_year
Specifies the calendar year in which the cross-section survey is conducted: see STATS.xsb_olc for details. Remember that the oldest birth cohort simulated by GEMINI is born in 1935, which means that if you want the xsb cross-section survey sample to include all cohorts alive (maximum age is 125), you must set xsb_year equal to be no less than 2060 (1935+125).

Valid values: 1995 to 2099, Integer

GEMINI:   STATS . xsb_suppl
Specifies which set of supplementary questions are included in the cross-section survey: see STATS.xsb_olc for details. A value of zero implies only the core questions are included in the survey. See the documentation (out_xsb.h) of the .xsb output results file for the core and supplement questions.

IMPORTANT NOTE: the value of STATS.xsb_suppl can be 4 only if GEMINI:RUN.use_inctax=T and either GEMINI:RUN.iti_write=T or GEMINI:RUN.iti_read=T.

Valid values: 0 to 4, Integer

GEMINI:   STATS . xsc_olc
Specifies whether or not information is written to an xsc output file when GEMINI is operating in support of a SSASIM OLC mode run. This information is collected from a set of survey questions posed to all simulated cohort sample individuals who are alive and have immigrated by the time of the scheduled interview, which is conducted in the calendar year specified by the STATS.xsc_year field. This cross-sectional survey consists of a set of core questions and an optional set of supplementary questions, which is specified by the STATS.xsc_suppl field. See the documentation (out_xsc.h) of the .xsc output file for the core and supplement questions.

The output file is named xscNNNNN.YYY, where NNNNN denotes the run number and YYY denotes the last three digits of the cohort birth year. Many birth cohort will be alive in the survey year resulting in many xscNNNNN.YYY files. These files are combined into one all-cohort cross-section file by pressing the GEMINI Data button in the EDA Toolkit. The resulting combined file is named runNNNNN.xsc and the component files are erased. The number of individuals included in the runNNNNN.xsc file is controlled by the value of the SSASIM:OLC.sample_pct field. Remember that OLC mode runs never simulate cohorts born before 1935.

Documentation information on output statistics in this result file is available by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

Valid values: T (=1) or F (=0) (for true or false), Logical [if not operating in OLC model, xsc_olc=T generates an error]

GEMINI:   STATS . xsc_year
Specifies the calendar year in which the cross-section survey is conducted: see STATS.xsc_olc for details. Remember that the oldest birth cohort simulated by GEMINI is born in 1935, which means that if you want the xsc cross-section survey sample to include all cohorts alive (maximum age is 125), you must set xsc_year equal to be no less than 2060 (1935+125).

Valid values: 1995 to 2099, Integer

GEMINI:   STATS . xsc_suppl
Specifies which set of supplementary questions are included in the cross-section survey: see STATS.xsc_olc for details. A value of zero implies only the core questions are included in the survey. See the documentation (out_xsc.h) of the .xsc output results file for the core and supplement questions.

IMPORTANT NOTE: the value of STATS.xsc_suppl can be 4 only if GEMINI:RUN.use_inctax=T and either GEMINI:RUN.iti_write=T or GEMINI:RUN.iti_read=T.

Valid values: 0 to 4, Integer

GEMINI:   STATS . dct
Specifies whether or not output statistics are written to the .dct file, which contains the sum of DC pension plan contributions and federal income tax liability for the family of each sample individual at each age for which there is a positive DC (employee or employer) contribution.

IMPORTANT NOTE: the value of the STATS.dct parameter can be true only if GEMINI:RUN.use_inctax=T and either GEMINI:RUN.iti_write=T or GEMINI:RUN.iti_read=T.

Documentation information on output statistics in this result file is available by selecting the 'Viewing documentation' item on the Help menu of the RSF Toolkit.

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

GEMINI:   STATS . siearn_dr
Specifies constant real annual discount rate (expressed in percentage terms) used in the steady-indexed-earnings present-value calculations. For more information about steady-indexed-earnings, see documentation for the siearn (40) and fsiern (41) steady-AWI-indexed-earnings statistics, and for the siearx (46) and fsierx (47) steady-CPI-indexed-earnings statistics in the GEMINI .sum output file.

Valid values: 0.0 to 5.0, Real

GEMINI:   STATS . eh_awi_pct
Specifies the percent of AWI that covered earnings received by a documented resident must exceed in order to count as a year of earnings in the tabulation of the statistic eh_yrs in the GEMINI .sum output file.

Valid values: 0 to 20, Integer

GEMINI:   STATS . rr_aie_pct
Specifies the percent of AIME*12 at age 62 that CPI-indexed-to-age-62 covered earnings received by a documented resident must equal or exceed in order to be included (as substantial) in the average final substantial earnings that is used as a CBO-style replacement-rate denominator, which is statistic afsern in the GEMINI .sum output file.

Valid values: 1 to 80, Integer

GEMINI:   STATS . rr_n_years
Specifies the number of substantial annual covered annual earnings received by a documented resident to be averaged in order to compute a CBO-style replacement-rate denominator, which is statistic afsern in the GEMINI .sum output file.

Valid values: 1 to 10, Integer

GEMINI:   STATS . earnAA_age
Specifies the age for which nominal individual earnings are shown in the earnAA statistic in the .sum output file.

Valid values: 45 to 55, Integer