areaovate: Area Calculation for an Ovate Polygon

In biogeom: Biological Geometries

Area Calculation for an Ovate Polygon

Description

areaovate is used to calculate the area of an ovate polygon made from combing two symmetrical curves generated by a performance equation (e.g., MLRFE).

Usage

areaovate(expr, P, simpver = NULL,  
          subdivisions = 100L,
          rel.tol = .Machine$double.eps^0.25, 
          abs.tol = rel.tol, stop.on.error = TRUE, 
          keep.xy = FALSE, aux = NULL)

Arguments

expr	a performance equation or one of its simplified versions.
P	the parameters of the performance equation or one of its simplified versions.
simpver	an optional argument to use the simplfied version of the performance equation.
subdivisions	please see the arguments for the integrate function in package stats.
rel.tol	please see the arguments for the integrate function in package stats.
abs.tol	please see the arguments for the integrate function in package stats.
stop.on.error	please see the arguments for the integrate function in package stats.
keep.xy	please see the arguments for the integrate function in package stats.
aux	please see the arguments for the integrate function in package stats.

Details

The performance equations denote MbetaE, MBriereE, MLRFE, and their simplified versions. The arguments of P and simpver should correspond to expr (i.e., MbetaE or MBriereE or MLRFE).

Value

The area of two symmetrical curves along the x-axis generated by a performance equation or one of its simplified versions.

Note

Here, the user can define other performance equations, but new equations or their simplified versions should include the lower and upper thresholds in the x-axis corresponding to y = 0, whose indices should be the same as those in MbetaE or MBriereE or MLRFE.

Author(s)

Peijian Shi [e-mail], Johan Gielis [e-mail], Brady K. Quinn [e-mail].

References

Jin, J., Quinn, B.K., Shi, P. (2022) The modified Brière equation and its applications. Plants 11, 1769. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.3390/plants11131769")}

Shi, P., Fan, M., Ratkowsky, D.A., Huang, J., Wu, H., Chen, L., Fang, S., Zhang, C. (2017) Comparison of two ontogenetic growth equations for animals and plants. Ecological Modelling 349, 1-10. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1016/j.ecolmodel.2017.01.012")}

Shi, P., Gielis, J., Quinn, B.K., Niklas, K.J., Ratkowsky, D.A., Schrader, J., Ruan, H., Wang, L., Niinemets, Ü. (2022) 'biogeom': An R package for simulating and fitting natural shapes. Annals of the New York Academy of Sciences 1516, 123-134. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1111/nyas.14862")}

Shi, P., Yu, K., Niklas, K.J., Schrader, J., Song, Y., Zhu, R., Li, Y., Wei, H., Ratkowsky, D.A. (2021) A general model for describing the ovate leaf shape. Symmetry 13, 1524. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.3390/sym13081524")}

See Also

curveovate, fitovate, MbetaE, MBriereE, MLRFE, MPerformanceE, sigmoid

Examples

Par1 <- c(1.8175, 2.7795, 7.1557, 1.6030)
areaovate(MbetaE, P = Par1, simpver = 1)

Par2 <- c(0.0550, 0.3192, 7.1965, 0.5226)
areaovate(MBriereE, P = Par2, simpver = 1)

Par3 <- c(1.8168, 2.7967, 7.2623, 0.9662)
areaovate(MLRFE, P = Par3, simpver = 1)

Par4 <- c(2.4, 0.96, 0.64, 7.75, 1.76, 3.68)
areaovate(MPerformanceE, P = Par4, simpver = 1)

biogeom documentation built on May 29, 2024, 8:52 a.m.