outbreak_stats {dfoliatR}

Outbreak statistics

Description

Summary statistics for inferred outbreaks

Usage

outbreak_stats(x)

Arguments

x

An obr object after running outbreak()

Value

A data frame with descriptive statistics for each outbreak event determined by outbreak(), including:

• "start" – first year of outbreak

• "end" – last year of outbreak

• "duration" – length of outbreak (in years)

• "n_df_start" – number of trees defoliated at the start

• "perc_df_start" – percent of trees defoliated at the start

• "max_df_obr" – maximum number of trees in the outbreak during a single year

• "yr_max_df" – year with the maximum number of trees defoliated

• "yr_min_ngsi" – year with the lowest mean normalized growth suppression index (NGSI)

• "min_gsi" – minimum growth suppression index

• "min_ngsi" – minimum normalized gsi

Note

Certain statistics will be set to NA for the final outbreak event if there was an ongoing defoliation event (in which series_end_event = TRUE in defoliate_trees()). This is because the end of the outbreak remains unknown, so statistics such as duration cannot be calculated. Statistics pertaining to the start of the event are provided.

Examples

data("dmj_obr")
outbreak_stats(dmj_obr)