PITcleanr is an R package for preparing PIT tag data for further
analysis. The package can help import complete tag histories from
PTAGIS, build a configuration file to help
assign each detection to a “node”, and compress those detections into a
smaller file. It contains functions to determine which detection
locations are upstream or downstream of each other, build a parent-child
relationship table describing whether detection locations are upstream
or downstream in relation to each other, and assign directionality of
movement between each detection location. For analyses that focus on
one-way directional movement (e.g., straightforward CJS models),
PITcleanr can help determine which detections fail to meet that
one-way movement assumption and should be examined more closely, and
which detections can be kept.
It was originally conceived as a companion to the
DABOM package for estimating
abundance of returning anadromous adult fish moving upstream.
PITcleanr was designed to prepare the raw PIT tag observations from
PTAGIS for use in the DABOM package.
The user can find more information related to installation and use of this package on the package website, https://kevinsee.github.io/PITcleanr.
The PITcleanr package can be installed as an R package from GitHub by
using Hadley Wickham’s devtools package:
# install and load remotes, if necessary
install.packages("devtools")
remotes::install_github("KevinSee/PITcleanr",
build_vignettes = TRUE)devtools may require a working development environment. Further
details around the installation of devtools can be found
here.
- For Windows, that will involve the downloading and installation of Rtools. The latest version of Rtools can be found here.
- For Mac OS, that may involve installing Xcode from teh Mac App Store.
- For Linux, that may involve installing a compiler and various development libraries, depending on the specific version of Linux.
To install the latest development version of PITcleanr:
remotes::install_github("KevinSee/PITcleanr@develop")Alternatively, the PITcleanr compendium can be downloaded as a zip
file from from this URL:
https://github.com/KevinSee/PITcleanr/archive/master.zip Once
extracted, the functions can be sourced individually, or a user can
build the R package locally.
Be sure to use the build_vignettes = TRUE argument, as this will build
all of the vignettes (i.e., user manuals) that are included with the
package. Further instructions on how to use PITcleanr can be found in
the vignettes, which can be accessed using:
browseVignettes(package = "PITcleanr")PITcleanr is a collaborative project, with the primary contributors being:
- Kevin See (Washington Department of Fish & Wildlife)
- Ryan N. Kinzer (Nez Perce Tribe - Fisheries Resources Management)
- Rick Orme (Nez Perce Tribe - Fisheries Resources Management)
- Mike Ackerman (Nez Perce Tribe - Fisheries Resources Management)
Text and figures : CC-BY-4.0
Code : See the DESCRIPTION file
Data : CC-0 attribution requested in reuse
We welcome contributions from everyone. Before you get started, please see our contributor guidelines. Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
Please feel free to post an issue to this repository for requested features, bug fixes, errors in documentation, etc.