Creates a function for a specific model based on definitions in Vigliola and Meekan (2009).

bcFuns(BCM)

Arguments

BCM

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

Value

A function that can be used to predict length at previous age (Li) given length-at-capture (Lcap), hard-part radius-at-age i (Ri), and hard-part radius-at-capture (Rcap). 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.

Details

The following models, based on definitions with abbreviations and model numbers from Vigliola and Meekan (2009), are supported.

AbbreviationNumberModel
DALE1Dahl-Lea
FRALE2Fraser-Lee
BI, LBI3(Linear) Biological Intercept
BPH, LBPH4(Linear) Body Proportional Hypothesis
TVG5Time-Varying Growth
SPH, LSPH6(Linear) Scale Proportional Hypothesis
AE, AESPH7(Age Effect) Scale Proportional Hypothesis
AEBPH8(Age Effect) Body Proportional Hypothesis
MONA9Monastyrsky
MONA-BPH10Monastyrsky Body Proportional Hypothesis
MONA-SPH11Monastyrsky Scale Proportional Hypothesis
WAKU12Watanabe and Kuroki
FRY13Fry
MF, ABI14Modified Fry, Allometric Biological Intercept
FRY-BPH, ABPH15Fry, Allometric Body Proportional Hypothesis
FRY-SPH, ASPH16Fry, Allometric Scale Proportional Hypothesis
QBPH17Quadratic Body Proportional Hypothesis
QSPH18Quadratic Scale Proportional Hypothesis
PBPH19Polynomial Body Proportional Hypothesis
PSPH20Polynomial Scale Proportional Hypothesis
EBPH21Exponential Body Proportional Hypothesis
ESPH22Exponential 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.]

Author

Derek H. Ogle, DerekOgle51@gmail.com

Examples

## Simple Examples
( bcm1 <- bcFuns(1) )
#> function (Lcap, Ri, Rcap, ..., verbose = TRUE) 
#> {
#>     if (verbose) 
#>         DONE("Using the Dahl-Lea model.")
#>     (Ri/Rcap) * Lcap
#> }
#> <bytecode: 0x000001b3c7d034f8>
#> <environment: 0x000001b3c469d568>
bcm1(20,10,40)
#>  Using the Dahl-Lea model.
#> [1] 5

## 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)
#>  Using the Dahl-Lea model.
#> [1]  25  50  75  75 125

( bcm2 <- bcFuns("FRALE") )
#> function (Lcap, Ri, Rcap, a, ..., verbose = TRUE) 
#> {
#>     if (verbose) 
#>         DONE("Using the Fraser-Lee model with a=", a, ".")
#>     a + (Lcap - a) * (Ri/Rcap)
#> }
#> <bytecode: 0x000001b3c7d02fb8>
#> <environment: 0x000001b3c220ea40>
bcm2(lencap,rad,radcap,2)  # demonstrated with a=2
#>  Using the Fraser-Lee model with a=2.
#> [1]  26.5000  51.0000  75.5000  76.0000 125.3333