Return to PSG Models documentation page

GEMINI output file .SUM

--- .SUM file contains lifetime statistics for each individual in
         cohort sample.

The GEMINI runNNNNN.sum file has no heading lines and no summary lines.
There is one line for each sampled individual in the cohort input file.
The statistics on a line are separated by the tab character.

NOTE: annual pretax benefits used to compute lifetime present values are not
      rounded down to zero when below 0.0005 thousand dollars per year.

The summary statistics on each line are as follows:
(***see SSASIM documentation, where same names are used, for more details***)
( 1) scenar: scenario number
( 2) ind_id: individual number (starts at 1 for each scenario)
( 3) gender: 0 ==> male, 1 ==> female
( 4) educat: 0 ==> no high school (died before entering high school)
             1 ==> high school dropout;    2 ==> high school graduate
             3 ==> attended some college;  4 ==> four-year college degree or
                                                 graduate degree
Lifetime PV measures for OASI program [.=r] and DI program [.=d] and pensions:
    - all earnings and benefits are pretax (i.e., before federal income tax)
    - monetary measures expressed in thousands of dollars [PV=present-value]
    - present values discounted to year in which cohort is 65 years old
    - present values expressed in SSASIM:COHORT.cpi_year dollars
    - present values calculated using Treasury bond yields as discount rates
( 5) pvearn: present value of ind lifetime earnings (thousands of dollars)
( 6) pvtaxr: present value of ind lifetime OASI DB taxes and DC contributions
( 7) pvbenr: present value of ind lifetime OASI DB benefits and DC withdrawals
( 8) pvtaxd: present value of ind lifetime DI taxes
( 9) pvbend: present value of ind lifetime DI DB benefits and DC withdrawals
(10) irrind: real IRR of ind lifetime OASDI benefits/withd & taxes/contr (%)
(11) irri_2: 0 ==> one IRR value, 1==> multiple IRRs [(10) from HP-12C rule]
(12) dieage: death occurs at end of year just before next birthday
(13) aprice: OASDI account annuity price (current dollars to buy $1/year)
(14)  aror%: lifetime gross rate of return on OASDI account assets (%)
(15)  imed%: indiv-market lifetime equity rate of return difference (%)
(16) do_age: disability onset age (999 ==> no disability onset)
(17) dr_age: disability recovery age (999 ==> no disability recovery)
(18) ownpen: earned own pension & saved it for retire (0=no;1=DB;2=DC;3=DB+DC)
(19) pvpenb: PV of ind lifetime employer-sponsored pretax pension benefits
(20) pbalda: pension rollover account balance at death (same $K as pv stats)
(21) lngmar: at least one marriage of ten or more years (0 ==> no; 1 ==> yes)
(22) survbs: survived by spouse (0 ==> no; 1 ==> yes)
(23) n_kids: number of own children ("own" means biological, not step, kids)
(24) im_age: immigration (at start of year) age (0 ==> native-born indiv)
(25) em_age: emigration (at start of year) age (999 ==> no emigration)
(26) earnAA: pretax earnings (in nominal thousands of dollars) at age AA
NOTE: age AA is equal to the specified value of STATS.earnAA_age.
(27) fpvern: pv of family(equiv-scale-adj) lifetime earnings ($K)
(28) fpvtri: pv of family(equiv-scale-adj) lifetime OASI taxes/contribs ($K)
(29) fpvbri: pv of family(equiv-scale-adj) lifetime OASI benefits/withds ($K)
(30) fpvtdi: pv of family(equivalence-scale-adjusted) lifetime DI taxes ($K)
(31) fpvbdi: pv of family(equivalence-scale-adjusted) lifetime DI benefits ($K)
(32) fpvpen: pv of family(equiv-scale-adj) lifetime e-s pension benefits ($K)
(33) irrfrc: real IRR of family lifetime OASDI benefits/withd & taxes/contr (%)
(34) irrf_2: 0 ==> one IRR value, 1==> multiple IRRs [(33) from HP-12C rule]
(35) ib_amt: real initial OASDI benefit amount ($K in COHORT.cpi_year dollars)
(36) ib_age: age of receipt of initial OASDI benefit (999 if ib_amt is zero)
(37) pvb1nr: DB (tier-1) portion of pvbenr; DC portion: pvb2nr=pvbenr-pvb1nr
(38) pvb1nd: DB (tier-1) portion of pvbend; DC portion: pvb2nd=pvbend-pvb1nd
(39) lobnar: low-benefit+earnings avoidance rate [like SSASIM .c?f lobnar] (%)
NOTE: benefits in lobnar include family OASDI benefits AND pension benefits;
      family wage and salary earnings are added to these retirement benefits
(40) siearn: steady own earnings at age 65 for individual
(41) fsiern: steady equiv-scale-adjusted earnings at age 65 for family
NOTE: the "steady indexed earnings" statistics [(40) and (41)] are the
      constant AWI-indexed earnings from age 21 thru 65 that produce
      the same present value of earnings as the individual's actual
      present value of AWI-indexed earnings, where the present values
      are computed using the fixed real discount rate specified by the
      GEMINI:STATS.siearn_dr input parameter.  The statistics are
      "steady indexed earnings" at age 65 and are expressed in
      thousands of real (SSASIM:COHORT.cpi_year) dollars.  These
      statistics are suitable as the denominator in a replacement rate
      if the benefits in the numerator are also expressed in thousands
      of real dollars where the real dollars are for the
      SSASIM:COHORT.cpi_year.
MORE: additional information about replacement rate calculations is in the
      EDA Toolkit Operations section of the "Getting Started with the EDA 
      Toolkit" document.
(42) icpvep: ind-to-cpl pvearn percentage ratio (%) (-1 ==> cpl pvearn is zero)
NOTE: the icpvep numerator is pvearn (5) and the denominator is similar to 
      fpvern (27) except no family-size (or equiv-scale) adjustment is made.
(43) docage: age at which gains USA immigration documentation
NOTE: the value of docage is 0 for native-born individuals.
(44) numQoC: quarters of coverage at last insured-status/PIA calculation
(45) undocpaytax: whether undocumented immigrant pays OASDI payroll taxes
NOTE: 0==>no, 1==>yes (meaningless at ages when not an undocumented immigrant).
(46) siearx: same as statistic (40) except uses steady CPI-indexed earnings.
(47) fsierx: same as statistic (41) except uses steady CPI-indexed earnings.
NOTE: the "steady indexed earnings" statistics [(46) and (47)] are the
      constant CPI-indexed earnings from age 21 thru 65 that produce
      the same present value of earnings as the individual's actual
      present value of CPI-indexed earnings, where the present values
      are computed using the fixed real discount rate specified by the
      GEMINI:STATS.siearn_dr input parameter.  The statistics are
      "steady indexed earnings" at age 65 and are expressed in
      thousands of real (SSASIM:COHORT.cpi_year) dollars.  These
      statistics are suitable as the denominator in a replacement rate
      if the benefits in the numerator are also expressed in thousands
      of real dollars where the real dollars are for the
      SSASIM:COHORT.cpi_year.
MORE: additional information about replacement rate calculations is in the
      EDA Toolkit Operations section of the "Getting Started with the EDA 
      Toolkit" document.
(48) eh_yrs: number of years with earnings above GEMINI STATS.eh_awi_pct
NOTE: read the STATS.eh_awi_pct input documentation for details.
(49) afsern: average final substantial real earnings (CBO-style rr denominator)
NOTE: read STATS.rr_aie_pct & STATS.rr_n_years input documentation for details;
      the value of afsern is zero in either of two cases:
      (a) AIME_at_age_62 was not computed (OAI-ineligible or other benefit),
      (b) number of substantial earnings years is less than STATS.rr_n_years;
      positive afsern values are expressed in thousands of age-62 dollars.
(50) aime62: AIME*12 at age 62 expressed in thousands of age-62 dollars
NOTE: aime62 will be zero if ind has no eligibility event at age 62 or is not
      eligible for retired-worker benefits at age 62.