lifertable: Life and Fertility Table

In Lifertable: Life and Fertility Tables Specially for Insects

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,
  CI = 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, ...).
CI	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 repeating it each 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).

A similar situation applies to InitiationOfAdultStage: you can enter either a single value or a vector of values corresponding to the involved groups.

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 an estimate of the Confidence Interval 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. \Sexpr[results=rd]{tools:::Rd_expr_doi("https://doi.org/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). \Sexpr[results=rd]{tools:::Rd_expr_doi("https://doi.org/10.1016/B978-0-12-391453-8.00008-X")}

Examples

## The Insects database will be utilized:

lifertable(ColumnFemale = Female,
           ColumnAge = Age,
           ColumnEggs = Eggs,
           SexRate = Sexrate,
           Survival = Survival,
           ColumnGroups = Group,
           data = Insects,
           CI = TRUE,
           TotalEggs = TRUE)

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

## lifertable(ColumnFemale = Insects$Female,
##            ColumnAge = Insects$Age,
##            ColumnEggs = Insects$Eggs,
##            SexRate = Insects$Sexrate,
##            Survival = Insects$Survival,
##            ColumnGroups = Insects$Group,
##            CI = TRUE, TotalEggs = TRUE)

## lifertable(ColumnFemale = Insects$Female,
##            ColumnAge = Insects$Age,
##            ColumnEggs = Insects$Eggs,
##            SexRate = 0.7, Survival = 0.9,
##            ColumnGroups = Insects$Group,
##            CI = TRUE, TotalEggs = TRUE)

## lifertable(ColumnFemale = Insects$Female,
##            ColumnAge = Insects$Age,
##            ColumnEggs = Insects$Eggs,
##            SexRate = c(0.7, 0.7),
##            Survival = c(0.9, 0.9),
##            ColumnGroups = Insects$Group,
##            CI = TRUE, TotalEggs = TRUE)

Lifertable documentation built on April 12, 2025, 1:43 a.m.