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.
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)
'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
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'.
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")
'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.
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).
Questions or feedback about the data sets or how to use the 'KuskoHarvData' package may be directed to Ben Staton (bstaton.qes@gmail.com).
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.