skip to main content
OSTI.GOV title logo U.S. Department of Energy
Office of Scientific and Technical Information

Title: PitPro 1.1 User's Manual; Pit-tag to SURPH Data Translation Utility, Technical Manual 2003.

Technical Report ·
DOI:https://doi.org/10.2172/962976· OSTI ID:962976

This manual describes the use of Program PitPro to convert PIT-tag data files in PTAGIS (PIT Tag Information System, Pacific States Marine Fisheries Commission) to input files ready for survival analysis in Program SURPH 2.1. This utility converts the various PIT-tag detections at the multitude of detector coils within a juvenile bypass or at adult counting windows and ladders into capture histories. The capture histories indicate whether a tagged fish was detected, not detected, or detected and censored at the major hydroprojects in the Columbia Basin. A major update to this program is the inclusion of adult upstream detection histories. Adult detection histories include not only whether the fish was detected or not but also the year of detection for proper adult survival estimation. The SURPH program is a valuable tool for estimating survival and detection probabilities of fish migrating in the Snake and Columbia rivers. Using special input data files, SURPH computes reach-to-reach statistics for any release group passing a system of detection sites. However, PIT-tag data, as available from PTAGIS, comes in a form that is not ready for use as SURPH input. SURPH requires a capture history for each fish. A capture history consists of a series of fields, one for each detection site, that has a code for whether the fish was detected and returned to the river, detected and removed, or not detected. The data, as received from PTAGIS, has one line for each detection with information such as fish identification (id), detection date and time, number of coil hits and detector coil ids, etc. Because an individual fish may be detected at several coils within a detection site as well as at several detection sites, each fish is often represented by multiple lines in the PTAGIS data file. For the PTAGIS data to be usable by SURPH, it must be preprocessed. The data must be condensed down to one line per fish with the relevant detection information from the PTAGIS file represented compactly on each line. In addition, the PTAGIS coil information must be passed through a series of logic algorithms to determine whether or not a fish was returned to the river after detection. Program PitPro was developed to allow the user to properly preprocess the PTAGIS data files for input to program SURPH through a user friendly graphical user interface (GUI). This utility takes PTAGIS data files as input and creates a SURPH data file as well as other output including travel time records, detection date records, and a data error file. PitPro allows a user to download PTAGIS files and easily process the data for use with SURPH. Program PitPro is based on the command line utility CaptHist.

Research Organization:
Bonneville Power Administration (BPA), Portland, OR (United States)
Sponsoring Organization:
USDOE
DOE Contract Number:
12494
OSTI ID:
962976
Report Number(s):
DOE/BP-00012494-3; TRN: US200917%%431
Country of Publication:
United States
Language:
English