R: Life and Fertility Table

lifertable {Lifertable}

R Documentation

Life and Fertility Table

Description

This function enables users to obtain life and fertility tables, offering various configuration options for optimal usage. See "Details" section.

Usage

lifertable(
  ColumnFemale,
  ColumnAge,
  ColumnEggs,
  SexRate,
  Survival = 1,
  ColumnGroups,
  data,
  InitiationOfAdultStage = 0,
  jackknife = FALSE,
  TotalEggs = FALSE
)

## S3 method for class 'lifertable'
print(x, ...)

## S3 method for class 'lifertableCI'
print(x, title = TRUE, ...)

## S3 method for class 'lifertableLFT'
print(x, ...)

## S3 method for class 'lifertableParmEst'
print(x, ...)

## S3 method for class 'lifertableTest'
print(x, ...)

## S3 method for class 'lifertableTotEggs'
print(x, ...)

Arguments

`ColumnFemale`	Data vector containing information on Females.
`ColumnAge`	Data vector containing information on Age.
`ColumnEggs`	Data vector containing information on the Number of Eggs Laid.
`SexRate`	Sex rate of eggs laid by the female at a certain age.
`Survival`	Percent of offspring females alive until adulthood. By default, the value is set to 1, assuming that all offspring will survive to adulthood.
`ColumnGroups`	Optional data vector containing information on the Groups. It is optional if the database only contains information about one group.
`data`	An optional data frame containing the variables. If not found in `data`, the variables are taken from environment.
`InitiationOfAdultStage`	Age at which females became adults. If the database contains records from birth, entering this value is unnecessary. ONLY ENTER THIS VALUE if the database begins from the adult stage, and the values in `ColumnAge` do not reflect the preceding stage (i.e. they contain the ages: 1, 2, 3, ...).
`jackknife`	Logical. If `TRUE`, Jackknife estimations will be conducted to obtain Confidence Intervals for the Parameters and, if necessary, to compare between groups. Default is FALSE
`TotalEggs`	Logical. If `TRUE`, the calculation of the number of eggs laid by each female during the entire experiment will be conducted. Default is FALSE.
`x`	Object to be displayed.
`...`	Additional arguments to be passed to or from methods.
`title`	If `TRUE` (the default), displays the title of the object (this is for internal use only).

Details

ColumnFemale and ColumnGroups can be either a numeric vector or a character vector. This means they may contain either numerical values or labels corresponding to the female and to their respective group assignments.

The standard approach for storing the Sex Rate and Survival rate during the experiment is to input this information into the corresponding columns for each variable. If this information remains consistent within a group, you can input that value without the need to repeat it every time. If your database encompasses a single experimental group, simply enter the corresponding value in the SexRate and Survival arguments. In the case of having more than one group, you can input the values of SexRate and Survival correspondingly into a vector containing as many elements as there are groups (one sex ratio and one survival rate for each group).

Estimated Parameters:

Net Reproductive Rate (Ro): Mean net contribution per female to the next generation.
Intrinsic Rate of Increase (Rm): Rate of natural increase in a closed population that has been subject to a constant age-specific schedule of fertility and mortality for a long period, and has converged to be a stable population.
Mean Generation Time (GT): Mean time span between the birth of individuals of a generation and that of the next generation.
Doubling Time (DT): Time span necessary for doubling the initial population.
Finite Rate of Increase (Lambda): It is a multiplication factor of the original population at each time period.

Rm it was determined by analytical approximation using Lotka’s (1907, 1913) equation:

\sum_{x=0}^{\infty}{\exp^{-R_{m}x}l_x m_x} = 1

Value

lifertable returns an object of class "lifertable".

An object of class "lifertable" is a list containing the following components:

`LIFERTABLE`	An object of class `lifertableLFT` containing the Life and Fertility Table.
`PARAMETERS`	An object of class `lifertableParmEst` containing the Parameter Estimations
`TOTAL.EGGS`	If requested, an object of class `lifertableTotEggs` containing the total number of eggs laid by each female throughout the entire experiment.
`CI`	If requested, an object of class `lifertableCI` containing the Confidence Intervals for the Parameter Estimates.
`T.TEST`	An object of class `lifertableTest` containing the Student t-test for pairwise group comparison. This component only appears if the experiment in question contains more than one group and a Jackknife estimation has been performed.
`PSEUDOS`	A list containing the pseudo values generated from the Jackknife estimation
`GROUPS`	A list of the groups involved in the experiment.

Methods (by generic)

print(lifertable): Print a lifertable object

Functions

print(lifertableCI): Print a lifertableCI object, this is the object showing the Confidence Interval
print(lifertableLFT): Print a lifertableLFT object, this is the object showing the Life and Fertility Table
print(lifertableParmEst): Print a lifertableParmEst object, this is the object showing the Estimated Parameters
print(lifertableTest): Print a lifertableTest object, this is the object showing the Student t - test
print(lifertableTotEggs): Print a lifertableTotEggs object, this is the object showing the Eggs laid per Female

References

Maia, A. H., Luis, A. J., & Campanhola, C. (2000). "Statistical Inference on Associated Fertility Life Table Parameters Using Jackknife Technique: Computational Aspects". Journal of Economic Entomology, 93(2), 511-518. doi:10.1603/0022-0493-93.2.511

Portilla, M., Morales-Ramos, J. A., Guadalupe Rojas, M., & Blanco, C. A. (2014). "Chapter 8 - Life Tables as Tools of Evaluation and Quality Control for Arthropod Mass Production". Mass Production of Beneficial Organisms (241-275). doi:10.1016/B978-0-12-391453-8.00008-X

Examples

## The Insects database will be utilized:

lifertable(Female, Age, Eggs, Sexrate, Survival, Group, data = Insects,
           jackknife = TRUE, TotalEggs = TRUE)

## The following expressions will yield the same result as above:

## lifertable(Insects$Female, Insects$Age, Insects$Eggs, Insects$Sexrate,
##            Insects$Survival, Insects$Group, jackknife = TRUE,
##            TotalEggs = TRUE)

## lifertable(Insects$Female, Insects$Age, Insects$Eggs,
##            SexRate = 0.7, Survival = 0.9, Insects$Group,
##            jackknife = TRUE, TotalEggs = TRUE)

## lifertable(Insects$Female, Insects$Age, Insects$Eggs,
##            SexRate = c(0.7, 0.7), Survival = c(0.9, 0.9),
##            Insects$Group, jackknife = TRUE, TotalEggs = TRUE)

[Package Lifertable version 0.0.1 Index]