Skip to contents

Calculate mechanical shape factor

Source: R/csf.R
csf.Rd

Calculates mechanical vulnerability of rigid, cantilever-type structural elements.

Usage

csf(mesh, z_min, res, keep_data = FALSE)

Arguments

mesh

A triangular mesh of class mesh3d.

z_min

The z plane about which csf should be calculated. Defaults to min(z).

res

The resolution to be used for the calculation. Defaults to the resolution of the mesh.

keep_data

Logical. Return list with supplemental info? Defaults to FALSE.

Value

A value for csf or if keep_data = TRUE, a list containing the colony shape factor (csf), the parallel to flow (dy) and perpendicular (dx) diameters of the cantilever base, and the bending moment (mom).

Details

This function calculates the mechanical vulnerability of a structural element, like a hard coral colony, to fluid flow. While developed for corals, and originally called the Colony Shape Factor (CSF), the function is applicable to any attached, rigid cantilever type structure. CSF is dimensionless and can be used to compare the vulnerability among structures. Mechanistically, if the CSF of a structure becomes greater than the dislodgement mechanical threshold, breakage occurs. This threshold is a function of material tensile strength and inversely related to fluid velocity and density (Madin & Connolly 2006).

Note

The orientation of the 3D mesh is important for this function. The function assumes the fluid flow is parallel with the y-axis. The function also assumes the base of the cantilever over which the bending moment acts can be approximated as an ellipse with the diameter on the y-axis parallel with flow (dy). You can set a z_min if the base of your mesh is not flat at the base (i.e., shift the plane upon which the cantilever is attached upwards). The function output includes dy and dx for monitoring anticipated values.

References

Madin JS & Connolly SR (2006) Ecological consequences of major hydrodynamic disturbances on coral reefs. Nature. 444:477-480.

Examples

csf(mcap, z_min = -3.65)
#> resolution set to 0.00783124724167033
#> [1] 0.2059624
csf(mcap, z_min = -3.65, keep_data = TRUE)
#> resolution set to 0.00783124724167033
#> $csf
#> [1] 0.2059624
#> 
#> $dy
#> [1] 0.3608775
#> 
#> $dx
#> [1] 0.3490938
#> 
#> $mom
#> [1] 0.001838568
#>