DefineAcousticTargetStrength: Acoustic target strength definition

In StoXProject/RstoxBase: Base StoX Functions

Acoustic target strength definition

Description

This function returns a table of parameters specifying the acoustic target strength as a function of length for different values of user selected variables in the NASC data.

Usage

DefineAcousticTargetStrength(
  processData,
  UseProcessData = FALSE,
  DefinitionMethod = c("ResourceFile", "Table"),
  AcousticTargetStrengthModel = c("LengthDependent", "LengthAndDepthDependent",
    "TargetStrengthByLength"),
  AcousticTargetStrengthTable = data.table::data.table(),
  FileName = character()
)

Arguments

processData	The current data produced by a previous instance of the function.
UseProcessData	Logical: If TRUE use the existing function output in the process.
DefinitionMethod	Character: A string naming the method to use, one of "Table" to define a table directly (in the GUI), and ResourceFile to read a file.
AcousticTargetStrengthModel	Character: The target strength model/function to use. Currently implemented are "LengthDependent", "LengthAndDepthDependent", "LengthExponent" and "TargetStrengthByLength". See Details.
AcousticTargetStrengthTable	A table holding the specification of the target strength function/table. The first two columns are AcousticCategory and Frequency. See details for other columns.
FileName	A file from which to read the AcousticTargetStrengthTable.

Details

The AcousticTargetStrengthModel has the following possible values:

1. LengthDependent, applying the logarithmic function TargetStrength = Targetstrength0 + LengthExponent * log10(Length). Required columns: Targetstrength0 and LengthExponent.

2. LengthAndDepthDependent, applying the logarithmic function TargetStrength = Targetstrength0 + LengthExponent * log10(Length) + DepthExponent * log10(1 + Depth/10). Required columns: Targetstrength0, LengthExponent and DepthExponent.

3. TargetStrengthByLength, applying a table of TargetStrength and TotalLength. Required columns: TargetStrength and TotalLength.

4. LengthExponent, applying the logarithmic function TargetStrength = LengthExponent * log10(Length). Required columns: LengthExponent.

The parameters/values can be given by tables with the first columns being AcousticCategory and Frequency, or as a csv file.

Value

An AcousticTargetStrength object.

See Also

AcousticDensity for applying the AcousticTargetStrength.

StoXProject/RstoxBase documentation built on July 14, 2024, 9:39 a.m.