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.
DefineAcousticTargetStrength(
processData,
UseProcessData = FALSE,
DefinitionMethod = c("ResourceFile", "Table"),
AcousticTargetStrengthModel = c("LengthDependent", "LengthAndDepthDependent",
"TargetStrengthByLength"),
AcousticTargetStrengthTable = data.table::data.table(),
FileName = character()
)
The current data produced by a previous instance of the function.
Logical: If TRUE use the existing function output in the process.
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.
Character: The target strength model/function to use. Currently implemented are "LengthDependent", "LengthAndDepthDependent", "LengthExponent" and "TargetStrengthByLength". See Details.
A table holding the specification of the target strength function/table. The first two columns are AcousticCategory and Frequency. See details for other columns.
A file from which to read the AcousticTargetStrengthTable
.
An AcousticTargetStrength
object.
The AcousticTargetStrengthModel
has the following possible values:
LengthDependent, applying the logarithmic function TargetStrength = Targetstrength0 + LengthExponent * log10(Length). Required columns: Targetstrength0 and LengthExponent.
LengthAndDepthDependent, applying the logarithmic function TargetStrength = Targetstrength0 + LengthExponent * log10(Length) + DepthExponent * log10(1 + Depth/10). Required columns: Targetstrength0, LengthExponent and DepthExponent.
TargetStrengthByLength, applying a table of TargetStrength and TotalLength. Required columns: TargetStrength and TotalLength.
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.
AcousticDensity
for applying the AcousticTargetStrength.