Return to PSG Models documentation page

SSASIM input table POP

Contains highest level description of the starting population and its dynamics, consisting of both assumption parameters and foreign keys pointing to rows in child tables. Each row specifies a different starting population and assumed dynamics, which can vary across time.

Parent table is: RUN

Child table is: POP_DEL

Child table is: POP_GA0

Child table is: POPDYN

Go to SSASIM input parameters overview

SSASIM:   POP . id
Identifies set of population parameters specified on this row of table, so id value should be unique.

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

Source code: pop.h and pop.cpp

SSASIM:   POP . 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:   POP . tfr0
Specifies initial RUN.year_zero value of total fertility rate (tfr), which is one of model's stochastic variables whose future ultimate (or post-transition) values are determined by ASSUMP and child tables parameters (see above). Value of tfr0 is expressed as the natural logarithm of the average total number of children born per woman.

Valid values: any, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . tfr_kink
Specifies whether or not transition path from initial value of total fertility rate to its ultimate, post-transition values has a single kink (or bend) point or is linear (without a kink).

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

Source code: pop.h and pop.cpp

SSASIM:   POP . tfr_kvalue
Specifies tfr kink point value if tfr_kink is true. Value of tfr_kvalue is expressed as the log of the average total number of children born per woman in the kink year. If kink point is assumed, the tfr transition path is a linear interpolation from its initial year value to kink point value in every scenario. Scenario variation in transition path is restricted to years after tfr_kyear (see below), or after tfr_byear (if tfr_bend is true; see below), as tfr values are interpolated between tfr_kvalue (or tfr_bvalue) and the ultimate value of tfr, which is generated using ASSUMP and child tables parameters. Value is read only if tfr_kink is true.

Valid values: any, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . tfr_kyear
Specifies simulation year of tfr kink point value if tfr_kink is true. Value is read only if tfr_kink is true.

Valid values: 1 to ( RUN.num_years - 1 ), Integer

Source code: pop.h and pop.cpp

SSASIM:   POP . tfr_bend
Specifies whether or not transition path from kink value of total fertility rate to its ultimate, post-transition values has a bend point or is linear (without a bend).

Valid values: T (=1) or F (=0) (for true or false), Logical [True value is allowed only if tfr_kink is true.]

Source code: capmrkt.h and capmrkt.cpp

SSASIM:   POP . tfr_bvalue
Specifies tfr bend point value if tfr_bend is true. Value of tfr_bvalue is expressed as the natural logarithm of the decimal rate in the bend year. If bend point is assumed, the tfr transition path is a linear interpolation from its kink year value to bend point value in every scenario. Scenario variation in transition path is restricted to years after tfr_byear (see below) as tfr values are interpolated between tfr_bvalue and the ultimate value of tfr, which is generated using ASSUMP and child tables parameters. Value is read only if tfr_bend is true.

Valid values: any, Real

Source code: capmrkt.h and capmrkt.cpp

SSASIM:   POP . tfr_byear
Specifies simulation year of tfr bend point value if tfr_bend is true. Value is read only if tfr_bend is true.

Valid values: tfr_kyear+1 to ( RUN.num_years - 1 ), Integer

Source code: capmrkt.h and capmrkt.cpp

SSASIM:   POP . imm0
Specifies initial RUN.year_zero value of total net immigration (imm), which is one of model's stochastic variables whose future ultimate (or post-transition) values are determined by ASSUMP and child tables parameters (see above). Value of imm0 is expressed in millions of people per year.

Valid values: any, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . imm_kink
Specifies whether or not transition path from initial value of total net immigration to its ultimate, post-transition values has a single kink (or bend) point or is linear (without a kink).

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

Source code: pop.h and pop.cpp

SSASIM:   POP . imm_kvalue
Specifies imm kink point value if imm_kink is true. Value of imm_kvalue is expressed as the total net immigration in the kink year. If kink point is assumed, the transition path of imm is a linear interpolation from its initial year value to kink point value in every scenario. Scenario variation in transition path is restricted to years after imm_kyear (see below) as imm values are interpolated between imm_kvalue and ultimate value of imm, which is generated using ASSUMP and child tables parameters.

Valid values: any, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . imm_kyear
Specifies simulation year of imm kink point value if imm_kink is true.

Valid values: 1 to ( RUN.num_years - 1 ), Integer

Source code: pop.h and pop.cpp

SSASIM:   POP . mdr0
Specifies initial RUN.year_zero value of aggregate mortality decline rate (mdr), which is one of model's stochastic variables whose future ultimate (or post-transition) values are determined by ASSUMP and child tables parameters (see above). Value of mdr0 is expressed as an annual percentage rate of decline in mortality rates.

Valid values: any, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . mdr_kink
Specifies whether or not transition path from initial value of mdr to its ultimate, post-transition values has a single kink (or bend) point or is linear (without a kink).

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

Source code: pop.h and pop.cpp

SSASIM:   POP . mdr_kvalue
Specifies mdr kink point value if mdr_kink is true. Value of mdr_kvalue is expressed as the percentage rate of decline in mortality rates in the kink year. If kink point is assumed, the transition path of mdr is a linear interpolation from its initial year value to kink point value in every scenario. Scenario variation in transition path is restricted to years after mdr_kyear (see below) as mdr values are interpolated between mdr_kvalue and ultimate value of mdr, which is generated using ASSUMP and child tables parameters.

Valid values: any, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . mdr_kyear
Specifies simulation year of mdr kink point value if mdr_kink is true.

Valid values: 1 to ( RUN.num_years - 1 ), Integer

Source code: pop.h and pop.cpp

SSASIM:   POP . pop_del_id
Points to row(s) in child POP_DEL table.

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

Source code: pop.h and pop.cpp

SSASIM:   POP . pop_ga0_id
Points to row(s) in child POP_GA0 table.

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

Source code: pop.h and pop.cpp

SSASIM:   POP . popdyn_id
Points to row(s) in child POPDYN table.

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

Source code: pop.h and pop.cpp

SSASIM:   POP . maxage_yng
Specifies the maximum age assumed for the 'young' population. Note: the aged dependency ratio is defined as the ratio of 'old' population (those whose age is no less than POP.minage_old) to the 'non-old-non-young' population (those whose age is less than POP.minage_old and greater than POP.maxage_yng).

Valid values: 0 to 123, Integer

Source code: pop.h and pop.cpp

SSASIM:   POP . minage_old
Specifies the minimum age assumed for the 'old' population. Note: the aged dependency ratio is defined as the ratio of 'old' population (those whose age is no less than POP.minage_old) to the 'non-old-non-young' population (those whose age is less than POP.minage_old and greater than POP.maxage_yng).

Valid values: maxage_yng+2 to 124, Integer

Source code: pop.h and pop.cpp

SSASIM:   POP . minagevold
Specifies the minimum age assumed for the 'very old' population.

Valid values: minage_old+1 to 125, Integer

Source code: pop.h and pop.cpp

SSASIM:   POP . use_mrfile
Specifies whether or not to use a text file to provide mortality rate input when operating in CBA mode. When false (F), the normal logic of simulating mortality rates is used. The long-standing normal logic involves advancing RUN.year_zero mortality rates (see the HISTMR table) to subsequent years using the simulated aggregate mortality decline rate (see ASSUMP and child tables) combined with age/gender decline rate disaggregation information (see the MDR_GA table) is used. When true (T), the simulated mortality rates for years beyond RUN.year_zero are replaced with age/gender-specific mortality rates contained in a mortality rate text file, the name of which is specified in the POP.mrfilename field. See the documentation for that parameter for information about the format of the mortality rate input file. Notice that the phrase "for years beyond RUN.year_zero" implies that mortality rates in RUN.year_zero cannot be changed. NOTE: this parameter cannot be set to true when the PSG models are running under Unix-like operating systems like Mac OS X or Linux, and it cannot be set to true under Windows when operating in either the OLC, ESP, or RCS modes.

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

Source code: pop.h and pop.cpp

SSASIM:   POP . mrfilename
Specifies name of text file containing the mortality rates to be used in the simulation. This parameter is read only if the value of POP.use_mrfile is true (T). If the input file is located in the same directory as the SSASIM database, then the mrfilename can be something as simple as, for example, mrf00001. If the input file is located in some other directory, specify the complete file name including the path (for example, \df\mr\basecase.txt). Each row of the input file must be structured exactly like rows in the .mrd output file (see NOTE below for more on the order of the rows). See the documentation for that file for row details. The .mrd file documentation can be obtained by executing a run with OUTPUT.mrd set equal to true (T) and then the output file in the RSF Toolkit from the Analyze menu. This capability has been designed so that the following will be true: (a) execute a run with OUTPUT.mrd=T and POP.use_mrfile=F and rename the resulting .mrd file; (b) change the run specification to OUTPUT.mrd=F and POP.use_mrfile=T (specifying POP.mrfilename as the renamed file) and execute the run; (c) compare the results of the first run from step (a) and the second run from step (b) to see that they are identical, apart from the possibility of minor rounding errors. NOTE: Although the row content in the mrfile input file must be exactly the same as in the .mrd output file, there is some flexibility on the ordering of the rows. Because the age range is 0..125 (with all mortality rates equal to one at age 125), there will be 252 rows for each calendar year. There must be one of these year blocks of 252 rows for each year in the simulation, and these year blocks must be in ascending order. Within a year block, the 252 rows can appear in any order. There must be a year block in the file for each of the RUN.num_years simulation years after RUN.year_zero.

Valid values: Text [no embedded spaces allowed]

Source code: pop.h and pop.cpp

SSASIM:   POP . fbe_rate_a
Specifies basic annual emigration rate among foreign-born individuals whose duration (that is, years since immigration minus one) is less than or equal to four.

Valid values: 0.0 to 1.0, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . fbe_rate_b
Specifies basic annual emigration rate among foreign-born individuals whose duration (that is, years since immigration minus one) is in the five to nine range.

Valid values: 0.0 to 1.0, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . fbe_rate_c
Specifies basic annual emigration rate among foreign-born individuals whose duration (that is, years since immigration minus one) is in the ten to fourteen range.

Valid values: 0.0 to 1.0, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . fbe_rate_d
Specifies basic annual emigration rate among foreign-born individuals whose duration (that is, years since immigration minus one) is greater than or equal to fifteen.

Valid values: 0.0 to 1.0, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . fbe_sf_p_a
Specifies basic annual emigration rate multiplicative scaling factor applied to foreign-born individuals who are age fifteen to age thirty-five (that is, in prime age).

Valid values: 0.0 to 10.0, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . fbe_sf_o_a
Specifies basic annual emigration rate multiplicative scaling factor applied to foreign-born individuals who are outside the age fifteen to age thirty-five range.

Valid values: 0.0 to 10.0, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . mr0_sf_yng
Specifies scaling factor for RUN.year_zero mortality rates for individuals under age 65.

Valid values: 0.6 to 1.4, Real

Source code: pop.h and pop.cpp

SSASIM:   POP . mr0_sf_old
Specifies scaling factor for RUN.year_zero mortality rates for individuals age 65 and over.

Valid values: 0.6 to 1.4, Real

Source code: pop.h and pop.cpp