Report summary statistics for landed catches from MCMC simulations using Reca. This function reports estimated total catch, mean length, mean weight, and mean age.
If 'RecaCatchAtAge' contains estimate for a set of aggregation variables, such as area, gear, stock, etc., summary statistics will be presented similarly.
The units considered valid for mean lengths are those listed for quantity 'length' in StoxUnits
The units considered valid for weights are those listed for quantity 'mass' in StoxUnits
The units considered valid for total catch in numbers are those listed for quantity 'cardinality' in StoxUnits
Summary statistics are obtained from the posterior distribution, and the interval is reported as equal-tailed credible intervals are reported.
Rounding of numbers according to the argument 'Decimals' is done with round
,
so that negative numbers specify rounding to powers of ten, and rounding of the digit 5 is towards the even digit.
Usage
ReportRecaCatchStatistics(
RecaCatchAtAge,
IntervalWidth = numeric(),
UseDefaultDecimalOptions = TRUE,
DecimalTotalNumber = integer(),
DecimalTotalWeight = integer(),
DecimalMeanAge = integer(),
DecimalMeanWeight = integer(),
DecimalMeanLength = integer(),
UseDefaultUnitOptions = TRUE,
UnitTotalNumber = RstoxData::getUnitOptions("cardinality", conversionRange = c(1,
1e+12)),
UnitTotalWeight = RstoxData::getUnitOptions("mass", conversionRange = c(1, 1e+12)),
UnitMeanWeight = RstoxData::getUnitOptions("mass", conversionRange = c(1e-04, 10)),
UnitMeanLength = RstoxData::getUnitOptions("length", conversionRange = c(1e-04, 10))
)
Arguments
- RecaCatchAtAge
Results from MCMC simulations (
RecaCatchAtAge
).- IntervalWidth
The width of the reported credible interval. A value to 0.9 gives 90 per cent credible intervals. Defaults to 0.9.
- UseDefaultDecimalOptions
logical determining whether to use default decimal options.
- DecimalTotalNumber
integer specifying the number of decimals to report for 'TotalNumber', and the corresponding 'SD', 'Low' and 'High'. Defaults to 0.
- DecimalTotalWeight
integer specifying the number of decimals to report for 'TotalWeightDefaults', and the corresponding 'SD', 'Low' and 'High'. Defaults to 0.
- DecimalMeanAge
integer specifying the number of decimals to report for 'MeanIndividualAge', and the corresponding 'SD', 'Low' and 'High'. 1.
- DecimalMeanWeight
integer specifying the number of decimals to report for 'MeanIndividualWeight', and the corresponding 'SD', 'Low' and 'High'. 3.
- DecimalMeanLength
integer specifying the number of decimals to report for 'MeanIndividualLength', and the corresponding 'SD', 'Low' and 'High'.3.
- UseDefaultUnitOptions
logical determining whether to use default unit options.
- UnitTotalNumber
unit for total catch in numbers. 10^6 individuals.
- UnitTotalWeight
unit for weight of total catch. kiloton.
- UnitMeanWeight
unit for mean weight. kg.
- UnitMeanLength
unit for mean length. cm.
See also
RunRecaModels
for running Reca-analysis
ReportRecaCatchAtAge
for reporting catch, mean length and mean weight by age groups
ReportRecaCatchAtLength
for reporting length distributions
ReportRecaCatchAtLengthAndAge
for reporting catch by age-group and length-group combinations.
Examples
catchStats <- ReportRecaCatchStatistics(RstoxFDA::RecaCatchAtAgeExample)
catchStats$MeanAge
#> MeanIndividualAge SD Low High
#> 1: 6.9 0.1 6.7 7.1
catchStats$MeanWeight
#> MeanIndividualWeight SD Low High
#> 1: 2.943 0.104 2.775 3.085
catchStats$MeanLength
#> MeanIndividualLength SD Low High
#> 1: 64.827 0.71 63.707 65.855
#Note that there is no error on the total weight estimate, when there are no grouping variables
catchStats$TotalWeight
#> TotalWeight SD Low High
#> 1: 66 0 66 66
catchStats$TotalNumber
#> TotalNumber SD Low High
#> 1: 23 1 22 24