FSA (version 0.8.6)

bcFuns: Creates a function for a specific back-calculation model.

Description

Creates a function for a specific back-calculation model based on definitions in Vigloila and Meekan (2009).

Usage

bcFuns(BCM, msg = FALSE)

Arguments

BCM

A single numeric between 1 and 22 or a string that indicates which back-calculation model to use (based on numbers and names in Vigliola and Meekan (2009)).

msg

A logical that indicates whether a message about the model and parameter definitions should be output.

Value

• A function that can be used to predict length at previous age (Li) given length-at-capture (Lc), hard-part radius-at-age i (Ri), and hard-part radius-at-capture (Rc). In addition, some functions/models may require the previous age (agei) and the age-at-capture (agec), certain parameters related to the biological intercept (R0p & L0p), or certain parameters estimated from various regression models (a,b,c,A,B,C). See source for more information.

IFAR Supplement

http://derekogle.com/IFAR/supplements/backcalculation/

Details

The following back-calculation models, based on definitions with abbreviations and model numbers from Vigloila and Meekan (2009), are supported. ccl{ Abbreviation Number Model DALE 1 Dahl-Lea FRALE 2 Fraser-Lee BI, LBI 3 (Linear) Biological Intercept BPH, LBPH 4 (Linear) Body Proportional Hypothesis TVG 5 Time-Varying Growth SPH, LSPH 6 (Linear) Scale Proportional Hypothesis AE, AESPH 7 (Age Effect) Scale Proportional Hypothesis AEBPH 8 (Age Effect) Body Proportional Hypothesis MONA 9 Monastyrsky MONA-BPH 10 Monastyrsky Body Proportional Hypothesis MONA-SPH 11 Monastyrsky Scale Proportional Hypothesis WAKU 12 Watanabe and Kuroki FRY 13 Fry MF, ABI 14 Modified Fry, Allometric Biological Intercept FRY-BPH, ABPH 15 Fry, Allometric Body Proportional Hypothesis FRY-SPH, ASPH 16 Fry, Allometric Scale Proportional Hypothesis QBPH 17 Quadratic Body Proportional Hypothesis QSPH 18 Quadratic Scale Proportional Hypothesis PBPH 19 Polynomial Body Proportional Hypothesis PSPH 20 Polynomial Scale Proportional Hypothesis EBPH 21 Exponential Body Proportional Hypothesis ESPH 22 Exponential Scale Proportional Hypothesis }

References

Vigliola, L. and M.G. Meekan. 2009. The back-calculation of fish growth from otoliths. pp. 174-211. in B.S. Green et al. (editors). Tropical Fish Otoliths: Information for Assessment, Management and Ecology. Review: Methods and Technologies in Fish Biology and Fisheries 11. Springer. [Was (is?) available from https://www.researchgate.net/publication/226394736_The_Back-Calculation_of_Fish_Growth_From_Otoliths.]

Examples

## Simple Examples
( bcm1 <- bcFuns(1) )
bcm1(20,10,40)

## Example with dummy length-at-cap, radii-at-cap, and radii-at-age
lencap <- c(100,100,100,150,150)
radcap <- c(20,20,20,30,30)
rad    <- c( 5,10,15,15,25)
bcm1(lencap,rad,radcap)

( bcm2 <- bcFuns("FRALE") )
bcm2(lencap,rad,radcap,2)  # demonstrated with a=2