
Seagrass coverage outcome by bay segment and year
Source:R/anlz_hab_seagrass_coverage.R
anlz_hab_seagrass_coverage.RdSeagrass coverage outcome by bay segment and year
Usage
anlz_hab_seagrass_coverage(
sgsegest,
yr_max = max(sgsegest$year),
smooth = "ramp",
pct = 0.1
)Arguments
- sgsegest
data.frame of seagrass coverage estimates by bay segment and year, e.g.
sgsegest- yr_max
integer, the last year to carry estimates forward to, defaults to the last year
sgsegestactually has an estimate for (max(sgsegest$year))- smooth
passed to
util_outcome. One of"ramp"(the default),"logistic", or"none"."ramp"gives an outcome of 1 for any acreage at or above a segment's target, decaying toward 0 the further short of it a segment falls.- pct
numeric, passed to
util_outcomeas the fraction of each acreage target used for the transition's steepness whensmoothis"ramp"or"logistic". Defaults to0.1(10% of the target).
Value
A data.frame with columns bay_segment (abbreviated, e.g.
"OTB"), yr, acres (carried forward in non-survey
years), and outcome (0-1, 1 = best, also carried forward in
non-survey years)
Details
Seagrass coverage maps are not produced every year. They're
flown approximately biennially (sgsegest has estimates for
most even years). To get a value for every calendar year, this fills the gaps by
carrying the most recent actual estimate (and the outcome derived from
it) forward via complete +
fill. For example, a year with no survey repeats the
prior survey year's acreage and outcome unchanged, until the next actual
survey year updates it. This means acres/outcome in a
non-survey year are not a new estimate, just a repeat of the last known
one.
Coverage is compared against a fixed per-segment acreage target with
util_outcome (type = "threshold", op = ">=").
By default (smooth = "ramp"), meeting or exceeding the target
gives an outcome of 1, decaying toward 0 the further short of it a
segment falls. Targets (acres):
- Old Tampa Bay
11,100
- Hillsborough Bay
1,751
- Middle Tampa Bay
9,400
- Lower Tampa Bay
7,400
- Boca Ciega Bay
8,800
- Terra Ceia Bay
1,100
- Manatee River
449
These targets are derived from the baywide 40,000-acre seagrass coverage target apportioned to each segment's share of total bay area.
Examples
anlz_hab_seagrass_coverage(sgsegest)
#> # A tibble: 259 × 4
#> bay_segment yr acres outcome
#> <chr> <dbl> <dbl> <dbl>
#> 1 BCB 1988 6259. 0.0557
#> 2 BCB 1989 6259. 0.0557
#> 3 BCB 1990 6805. 0.104
#> 4 BCB 1991 6805. 0.104
#> 5 BCB 1992 6952. 0.123
#> 6 BCB 1993 6952. 0.123
#> 7 BCB 1994 7129. 0.150
#> 8 BCB 1995 7129. 0.150
#> 9 BCB 1996 7716. 0.292
#> 10 BCB 1997 7716. 0.292
#> # ℹ 249 more rows