DefineAcousticPSU: Define acoustic primary sampling unit

In StoXProject/RstoxTempDoc: Temporary package for documenting the RstoxFramework package

Description

The DefineAcousticPSU function is used to specify which acoustic elementary distance sampling units (EDSUs) the primary sampling units (PSUs) consist of.

Usage

DefineAcousticPSU()

Arguments

parameterName

Parameter descrption.

Details

The DefineAcousticPSU function is used to specify which acoustic elementary distance sampling units (EDSU, (Simmonds and MacLennan, 2005)) the primary sampling units (PSU) consist of. These definitions of the acoustic PSUs will be utilized in another process to aggregate the nautical area scattering coefficient (NASC, MacLennan et al, 2002) to PSU level by layer. Input data of type AcousticData contains the EDSUs records, and the data source is defined through a parameter with the same name as the input data type.

PSU represents the primary horizontal resolution for density calculations (as number per square nautical mile) in StoX. Typically, a PSU is an acoustic transect line, but exceptions exist (see below).

In most cases, the initial definitions of acoustic PSUs are performed interactively in the StoX graphical user interface (map and other windows). The output result is stored as process data associated with the DefineAcousticPSU process.

The following automated methods are available through the DefinitionMethod parameter:

UseProcessData

Use the definition of PSUs from the previous execution of the DefineAcousticPSU process. These are read from the process data.

EDSUToPSU

The method will automatically redefine all EDSUs of the input acoustic data as PSUs. This is done to perform some special calculations (e.q. models to split NASC for acoustic categories of more than one species into NASC by separate species using the biotic length distribution data). PSU playa a special role in StoX calculations, and several functions need PSU resolution and not EDSU.

References:

MacLennan, D. N., Fernandes, P. G., and Dalen, J. 2002. A consistent approach to definitions and symbols in fisheries acoustics. ICES Journal of Marine Science, 59: 365_369.

Simmonds, J., and MacLennan, D. 2005. Fisheries Acoustics. Theory and Practice, Blackwell Science, Oxford. 437 pp.

Value

A data.table is returned with awesome stuff.

See Also

roxygenize is used to generate the documentation.

Examples

x <- 1

StoXProject/RstoxTempDoc documentation built on Dec. 31, 2019, 1:50 p.m.