Tabulate interviews by species sought and month

Counts the number of interviews for each species sought within each calendar month. Species sought is taken from the column set via add_interviews(species_sought = ...).

Usage

summarize_by_species_sought(design)

Arguments

design

A creel_design object with interviews attached and species_sought column set via add_interviews(species_sought = ...).

Value

A data.frame with class c("creel_summary_species_sought", "data.frame") and columns: month, species, N, percent.

Details

Interview-based summary, not pressure-weighted. This function tabulates raw interview records without applying survey weighting by sampling effort or effort stratum. For pressure-weighted extrapolated estimates, use estimate_catch_rate or estimate_harvest_rate.

Unrecorded grouping values

An interview whose grouping value was not recorded is reported under "Unknown", sorted last, rather than dropped. The interview is real and its grouping value is missing, which is not the same as the interview not existing, so sum(N) always equals the number of interviews attached to the design. "Unknown" is a label for the absence, never a category anyone selected. This matches summarize_by_zip and summarize_by_county; the survey-weighted estimators use <unknown> instead.

A column holding both unrecorded values and the literal value "Unknown" warns: the two are pooled into one row and cannot be told apart in the output. Missingness is tracked internally, so a category genuinely named "Unknown" keeps its own counts.

See also

Other "Reporting & Diagnostics": adjust_nonresponse(), check_completeness(), compare_variance(), flag_outliers(), season_summary(), standardize_species(), summarize_boat_composition(), summarize_by_angler_type(), summarize_by_county(), summarize_by_day_type(), summarize_by_method(), summarize_by_trip_length(), summarize_by_zip(), summarize_cws_rates(), summarize_hws_rates(), summarize_length_freq(), summarize_refusals(), summarize_successful_parties(), summarize_trips(), summary.creel_estimates(), tidy.creel_estimates(), validate_creel_data(), validate_design(), validate_incomplete_trips(), validation_report(), write_estimates()

Examples

data(example_calendar)
data(example_interviews)
d <- creel_design(example_calendar, date = date, strata = day_type)
d <- add_interviews(d, example_interviews,
  catch = catch_total, effort = hours_fished, harvest = catch_kept,
  trip_status = trip_status, species_sought = species_sought
)
#> Warning: ! No `n_anglers` provided — assuming 1 angler per interview.
#> ℹ Pass `n_anglers = <column>` to use actual party sizes for angler-hour
#>   normalization.
#> ℹ If the interviews really are one angler each, pass `n_anglers = 1` to state
#>   that and silence this warning.
#> ℹ Added 22 interviews: 17 complete (77%), 5 incomplete (23%)
summarize_by_species_sought(d)
#>   month species  N percent
#> 1  June    bass  6    27.3
#> 2  June panfish  5    22.7
#> 3  June walleye 11    50.0