# PerformanceMetric: Performance Metrics Methods In DLMtool: Data-Limited Methods Toolkit

## Description

Performance metric (PMs) methods for your management strategy evaluation.

## Usage

 ``` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17``` ```P10(MSEobj = NULL, Ref = 0.1, Yrs = NULL) P50(MSEobj = NULL, Ref = 0.5, Yrs = NULL) P100(MSEobj = NULL, Ref = 1, Yrs = NULL) PNOF(MSEobj = NULL, Ref = 1, Yrs = NULL) LTY(MSEobj = NULL, Ref = 0.5, Yrs = -10) STY(MSEobj = NULL, Ref = 0.5, Yrs = 10) Yield(MSEobj = NULL, Ref = 1, Yrs = NULL) AAVY(MSEobj = NULL, Ref = 0.2, Yrs = NULL) AAVE(MSEobj = NULL, Ref = 0.2, Yrs = NULL) ```

## Arguments

 `MSEobj` An object of class MSE `Ref` Reference point for calculating the performance metric. See details. `Yrs` Numeric vector of length 2 with year indices to summarize performance. If NULL, the performance is summarized over all projection years.

## Details

Performance Metric definitions:

 `P10` Probability B > 0.1 BMSY `P50` Probability B > 0.5 BMSY `P100` Probability B > BMSY `PNOF` Probability F < FMSY `LTY` Probability Long-Term Yield > 0.5 Relative Yield `STY` Probability Short-Term Yield > 0.5 Relative Yield `AAVY` Probability AAVY < 0.2 (Average Annual Variability in Yield) `AAVE` Probability AAVE < 0.2 (Average Annual Variability in Effort) `Yield` Average Yield (relative to Reference Yield)

Argument `Ref` provides the ratio relative to the reference point for calculating the performance metric. For biomass-based PMs (`P10`, `P50`, `P100`), this is the fraction of BMSY. For `PNOF`, the fraction of FMSY. For `Yield` (and `LTY`/`STY`), the fraction of the Reference Yield. For `AAVY` is it the maximum acceptable variability in yield (i.e, default for `AAVY` is `Ref=0.2`)

The `Yrs` argument defines the number of years to calculate the performance statistic over. A value of `NULL`, the default for `AAVY`, `AAVE`, `P10`, `P50`, `P100`, and `PNOF`, means that the performance metric is calculated over all projection years. A numeric vector of length two is used to specify the first and last year, e.g, if `Yrs=c(1,10)` the performance statistic is calculated over the first 10 projection years. A numeric vector of length one with positive or negative value respectively can be used to specify the first x or last x years, e.g, `Yrs=10` is first 10 years, and `Yrs=-10` is the last 10 years. See `ChkYrs` for more details.

By default Long-Term Yield (`LTY`) is the Yield in the last ten years of the projection period in the MSE, and Short-Term Yield (`STY`) is that in the first 10 years of the projection period.

## Value

An object of class `PMobj`

## Note

 ``` 1 2 3 4 5 6 7 8 9 10 11 12 13``` ```## Not run: myMSE <- runMSE() P10(myMSE) P50(myMSE) P100(myMSE) PNOF(myMSE) LTY(myMSE) STY(myMSE) AAVY(myMSE) AAVE(myMSE) Yield(myMSE) ## End(Not run) ```