Skip to contents

Survey Design

Build a creel survey design object and attach observational data. All estimation functions accept a creel_design object as their first argument.

creel_design()
Create a creel survey design
add_counts()
Attach count data to a creel design
prep_counts_daily_effort()
Standardize sampled-day effort rows for count-based workflows
prep_counts_boat_party()
Standardize boat-party sampled-day effort rows
add_interviews()
Attach interview data to a creel design
prep_interviews_trips()
Standardize trip/interview rows for interview-based workflows
prep_interview_catch()
Standardize long catch-table rows for interview-based workflows
add_catch()
Attach species-level catch data to a creel design
add_lengths()
Attach fish length frequency data to a creel design
add_sections()
Register spatial sections for a creel survey design
as_survey_design()
Extract internal survey design object for advanced use
est_effort_camera()
Estimate angler effort from camera/time-lapse count data
as_hybrid_svydesign() experimental
Construct a hybrid access + roving survey design
print(<creel_hybrid_svydesign>)
Print a creel_hybrid_svydesign
compute_effort()
Resolve fishing effort from timestamps or self-reported time
compute_angler_effort()
Normalize fishing effort to angler-hours
creel_schema()
Column-mapping contract for tidycreel data sources
validate_creel_schema()
Validate a creel_schema object

Estimation

Design-based estimators for effort, catch rates, and totals. Functions dispatch automatically on survey type.

estimate_effort()
Estimate total effort from a creel survey design
estimate_effort_aerial_glmm()
GLMM-based aerial effort estimation with diurnal correction
estimate_catch_rate()
Estimate CPUE (Catch Per Unit Effort) from a creel survey design
estimate_harvest_rate()
Estimate harvest (HPUE: Harvest Per Unit Effort) from a creel survey design
estimate_release_rate()
Estimate release rate (RPUE: Released fish Per Unit Effort) from a creel survey design
estimate_total_catch()
Estimate total catch by combining effort and CPUE
estimate_total_harvest()
Estimate total harvest by combining effort and HPUE
estimate_total_release()
Estimate total extrapolated release by combining effort and release rate
estimate_exploitation_rate()
Estimate exploitation rate using the Pollock et al. moment estimator
est_length_distribution()
Estimate a weighted length distribution from creel interview data

Reporting & Diagnostics

Summarize interview data by angler characteristics, validate designs, check data completeness, and inspect estimate output.

summarize_trips()
Summarize trip metadata for interview data
summarize_refusals()
Tabulate refused vs accepted interviews by month
summarize_by_day_type()
Tabulate interviews by day type and month
summarize_by_angler_type()
Tabulate interviews by angler type and month
summarize_by_method()
Tabulate interviews by fishing method and month
summarize_by_species_sought()
Tabulate interviews by species sought and month
summarize_by_trip_length()
Tabulate interviews by trip length bin
summarize_cws_rates()
Compute caught-while-sought (CWS) rates by group
summarize_hws_rates()
Compute harvested-while-sought (HWS) rates by group
summarize_length_freq()
Compute length frequency distribution from creel interview data
summarize_successful_parties()
Tabulate successful parties by angler type and species sought
season_summary()
Assemble pre-computed creel estimates into a report-ready wide tibble
summary(<creel_estimates>)
Summarise creel survey estimates as a formatted table
flag_outliers()
Flag outliers in a creel interview data column
write_estimates()
Export creel survey estimates to a file
validate_incomplete_trips()
Validate incomplete trip estimates using TOST equivalence testing
validate_design()
Validate a proposed creel survey design against sample size targets
check_completeness()
Check post-season data completeness for a creel design
compare_variance()
Compare Taylor linearization vs. replicate variance for creel estimates
adjust_nonresponse()
Adjust a creel design for nonresponse bias
validate_creel_data()
Validate creel survey data frames
print(<creel_data_validation>)
Print a creel_data_validation result
as.data.frame(<creel_data_validation>)
Coerce a creel_data_validation to a plain data frame
standardize_species()
Standardize species names to AFS codes
validation_report()
Generate a validation summary report
print(<creel_validation_report>)
Print a creel_validation_report
as.data.frame(<creel_validation_report>)
Coerce a creel_validation_report to a plain data frame

Planning & Sample Size

Pre-survey tools for sample size determination, power analysis, and design comparison.

power_creel()
Unified sample-size and power interface for creel surveys
creel_n_effort()
Calculate sampling days required to achieve a target CV on effort
creel_n_cpue()
Calculate interviews required to achieve a target CV on CPUE
creel_power()
Estimate statistical power to detect a change in CPUE between seasons
cv_from_n()
Compute the expected CV achievable with a known sample size
compare_designs() experimental
Compare multiple survey design estimates side by side
print(<creel_design_comparison>)
Print a creel_design_comparison
autoplot(<creel_design_comparison>)
Autoplot a creel_design_comparison as a forest plot
as.data.frame(<creel_design_comparison>)
Coerce a creel_design_comparison to a plain data frame

Scheduling

Generate, validate, read, and write creel survey schedules.

generate_schedule()
Generate a creel survey sampling schedule
generate_bus_schedule()
Generate a bus-route sampling frame
generate_count_times()
Generate within-day count time windows
attach_count_times()
Attach count time windows to a daily sampling schedule
new_creel_schedule()
Create a creel_schedule S3 object
validate_creel_schedule()
Validate a creel_schedule object
read_schedule()
Read a schedule file into a validated creel_schedule object
write_schedule()
Write a creel schedule to a CSV or xlsx file

Bus-Route Helpers

Exported helpers for bus-route Horvitz-Thompson estimation components. For advanced users who need direct access to enumeration values.

get_enumeration_counts()
Get enumeration counts from a bus-route creel design with interviews
get_inclusion_probs()
Get inclusion probabilities from a bus-route design
get_sampling_frame()
Extract the sampling frame from a bus-route creel design
get_site_contributions()
Extract per-site effort contributions from a bus-route estimate

Camera Survey

Preprocessing for camera-monitored creel surveys.

preprocess_camera_timestamps()
Preprocess camera ingress-egress timestamps

Visualisation

ggplot2-based plotting methods for creel designs, estimates, and schedules.

plot_design()
Plot a creel survey design
autoplot(<creel_estimates>)
Plot creel survey estimates with ggplot2
autoplot(<creel_length_distribution>)
Plot a weighted length distribution with ggplot2
autoplot(<creel_schedule>)
Plot a creel schedule as a ggplot2 tile calendar
theme_creel()
Package-standard ggplot2 theme for tidycreel plots
creel_palette()
Package-standard colour palette for tidycreel plots

Example Datasets

Simulated datasets illustrating each supported survey type. Used in vignettes and function examples.

example_calendar
Example calendar data for creel survey
example_counts
Example count data for creel survey
example_interviews
Example interview data for creel survey
example_catch
Example species catch data for creel survey
example_lengths
Example fish length data for creel survey
example_sections_calendar
Example calendar for spatially stratified creel survey
example_sections_counts
Example effort counts for spatially stratified creel survey
example_sections_interviews
Example interview data for spatially stratified creel survey
example_ice_sampling_frame
Example sampling frame for ice fishing creel survey
example_ice_interviews
Example interview data for ice fishing creel survey
example_camera_counts
Example camera counts dataset (counter mode)
example_camera_timestamps
Example camera timestamps dataset (ingress-egress mode)
example_camera_interviews
Example interview data for camera-monitored creel survey
example_aerial_counts
Example aerial angler count dataset
example_aerial_interviews
Example angler interview data for aerial creel survey
example_aerial_glmm_counts
Example multi-flight aerial count data for GLMM effort estimation
creel_counts_toy
Toy count data for data validation examples
creel_interviews_toy
Toy interview data for data validation examples