popdemo-deprecated: Deprecated functions in the popdemo package
In popdemo: Demographic Modelling Using Projection Matrices

Deprecated functions in the popdemo package

Cohen.cumulative(...)
convergence.time(...)
inertia.tfa(...)
inertia.tfamatrix(...)
inertia.tfsens(...)
inertia.tfsensmatrix(...)
is.matrix_ergodic(...)
is.matrix_irreducible(...)
is.matrix_primitive(...)
Keyfitz.delta(...)
projection.distance(...)
tfa(...)
tfamatrix(...)
tfsens(...)
tfsensmatrix(...)
minCS(...)
reactivity(...)
firststepatt(...)

...

Parameters to be passed to the new function versions

Many functions have become deprecated as of popdemo_1.0-0 (meaning they will stop working at some point in the future). In most cases, this is because functions needed to be re-named. For now the older function names will work but issue a warning, but you should use the new function names wherever possible. Please update your code, and I'm sorry for the inconvenience!

Avoiding S3 troubles

Most deprecated functions needed to be renamed because they included a period in the function name: the new function names don't use periods, which is a better approach for playing nicely with the S3 object-oriented system (see Hadley Wickham's OO field guide for more info). These are:

`Cohen.cumulative`	now called `CohenD`
`convergence.time`	now called `convt`
`inertia.tfa`	now called `tfa_inertia`
`inertia.tfamatrix`	now called `tfam_inertia`
`inertia.tfsens`	now called `tfs_inertia`
`inertia.tfsensmatrix`	now called `tfsm_inertia`
`is.matrix_ergodic`	now called `isErgodic`
`is.matrix_irreducible`	now called `isIrreducible`
`is.matrix_primitive`	now called `isPrimitive`
`Keyfitz.delta`	now called `KeyfitzD`
`projection.distance`	now called `projectionD`

Consistency

Some other functions have been renamed to keep consistency with new functions, and also to further avoid problems with S3 methods by making sure classes and functions don't have the same names:

`tfa`	now called `tfa_lambda`
`tfamatrix`	now called `tfam_lambda`
`tfsens`	now called `tfs_lambda`
`tfsensmatrix`	now called `tfsm_lambda`

Hidden functions

Some functions have been made internal (they're "hidden" but you can still use them):

`minCS`	now called `.minCS`
`tf`	now called `.tf`

Merged functions

Two functions are deprecated because they have been merged into one:

`reactivity,firststepatt`	now handled by `reac`.

Before, reactivity handled first-timestep amplification and firststepatt handled first-timestep attenuation. This is silly, because a projection EITHER amplifies OR attenuates in the first timestep. Desptite the semantics, reac now deals with both amplification and attenuation in the first timestep, everything that was calculable in the previous two functions is also calculable in the one new function.

popdemo documentation built on Nov. 16, 2021, 5:06 p.m.