Skip to content

R package containing data and estimates generated by the Kuskokwim River in-season subsistence salmon harvest monitoring program

License

Notifications You must be signed in to change notification settings

bstaton1/KuskoHarvData

Repository files navigation

KuskoHarvData

R package that stores data collected by the Lower Kuskokwim River In-season Subsistence Salmon Harvest Monitoring Program. In addition to the raw data, included are compiled estimates of harvest (by species and area) and effort (by area) for each monitored drift gillnet subsistence opener (estimates generated using the 'KuskoHarvEst' R package).

Prior to the development of 'KuskoHarvData', these data had been stored in separate places and in various formats. This new standardized and comprehensive format facilitates analyses that may provide greater insights about fishery management in the lower Kuskokwim River, such as those contained in the 'KuskoHarvPred' R package.

Installation

After installing R and RStudio Desktop (accept all defaults when prompted), run this code from the R console:

install.packages("remotes")
remotes::install_github("bstaton1/KuskoHarvData", build_vignettes = TRUE)

Data Sets

'KuskoHarvData' ships with several data sets, which are all described in the vignette:

vignette("datasets", package = "KuskoHarvData")

Briefly, these include:

Data Set Description
openers_all Meta data for each drift gillnet subsistence fishery opener.
harv_est_all Compiled estimates of salmon harvest by drift gillnet boats by opener, species, and geographic stratum. Includes point estimates and bootstrap 95% confidence intervals.
effort_est_all Compiled estimates of the number of drift gillnet trips by opener and geographic stratum.
interview_data_all Completed trip interview records documenting interview location, start/end times of the trip, gear and drift characteristics, and salmon catch by species.
flight_data_all Instantaneous aerial counts of active drift gillnet trips by geographic stratum.
btf_data_all Daily Bethel Test Fishery catch-per-unit-effort by species.
PABE_data_all Daily summaries of weather variables, as measured at the Bethel Airport (PABE).
Source information for each data set can be found in the package help files, for example, to learn about where the interview data come from, run:
?KuskoHarvData::interview_data_all

Accessing the Data

A data set can be loaded into the R session as a data object. For example, to load the estimates of harvest by opener, stratum, and species, run:

data("harv_est_all", package = "KuskoHarvData")

And refer to the object as harv_est_all in your session.

Another useful feature is the KuskoHarvData::prepare_regression_data() function, which creates the data set used in the regression analyses found in 'KuskoHarvPred'.

Updating the Data

It is the intent of the package developer that the data sets be updated with the most current data. Following the conclusion of each season and after the data sets are finalized, the package should be updated such that it contains the same information as is used in the season-wide final report.

Please see the vignette for instructions about how this should be done.

vignette("updating-data", package = "KuskoHarvData")

Related Packages

'KuskoHarvData' is a member of a family of packages:

  • 'KuskoHarvEst' contains tools for producing estimates (and PDF reports for distribution) for a single opener.
  • 'KuskoHarvPred' contains tools for predicting outcomes of future openers based on past data.
  • 'KuskoHarvUtils' contains features that support the other packages.

Publications

A description of the sampling methodology and estimation framework can be found in the manuscript:

In-season monitoring of harvest and effort from a large-scale subsistence salmon fishery in western Alaska by B. A. Staton, W. R. Bechtol, L. G. Coggins Jr., G. Decossas, and J. Esquible, submitted to the Canadian Journal of Fisheries and Aquatic Sciences (analysis repository: bstaton1/KuskoHarvEst-ms-analysis; archived under DOI 10.5281/zenodo.10369148).

An approach for predicting outcomes of future openers based on past data can be found in the manuscript:

In-season predictions of daily harvest for lower Kuskokwim River subsistence salmon fisheries by B. A. Staton, W. R. Bechtol, L. G. Coggins Jr., and G. Decossas, submitted to the North American Journal of Fisheries Management (analysis repository: bstaton1/KuskoHarvPred-ms-analysis; archived under DOI 10.5281/zenodo.13293677).

Contact

Questions or feedback about the data sets or how to use the 'KuskoHarvData' package may be directed to Ben Staton (bstaton.qes@gmail.com).

Acknowledgements

Many organizations and people have collected the data that are contained in this package. These include staff from: the Orutsararmiut Native Council (interviews at the Bethel boat harbor and surrounding fish camps), the Kuskokwim River Inter-Tribal Fish Commission (interviews at various villages), the Alaska Department of Fish and Game (interviews at various villages, 2018 only; Bethel Test Fishery), and the Yukon Delta National Wildlife Refuge/USFWS (aerial counts). The graphic of the salmon caught in the gillnet in the 'KuskoHarvData' package logo was created by N. Tamburello.

Funding for the compilation of existing data sets into this package was provided by the Arctic-Yukon-Kuskokwim Sustainable Salmon Initiative, administered by the Bering Sea Fisherman's Association under project #AC-2106.

About

R package containing data and estimates generated by the Kuskokwim River in-season subsistence salmon harvest monitoring program

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages