getCatchForkLenth: getCatchForkLength - Retrieve catch data with fork length...

View source: R/getCatchForkLength.R

getCatchForkLenthR Documentation

getCatchForkLength - Retrieve catch data with fork length information attaches.

Description

Retrieve a data frame from the CAMP Access dBAse containing catches and fork length. This routine includes fish from both includeCatch = TRUE and includeCatch = FALSE catches.

Usage

getCatchForkLenth(site, taxon, run, min.date, max.date)

Arguments

site

The identification number of the site for which estimates are required.

taxon

The species identifier indicating the type of fish of interest. This is always 161980; i.e., Chinook Salmon.

run

The run code. This is an integer value that corresponds to a run listed in table luRun which is housed inside the Access database. At the time of this writing, the luRun table translated run codes as:

  • 1 = Spring

  • 2 = Summer

  • 3 = Fall

  • 4 = Winter

  • 5 = Late fall

  • 6 = Mixed

Normally, the translation from text (e.g., "fall") to code (e.g., 3) is done by the camp interface.

min.date

The start date for data to include. This is a text string in the format %Y-%m-%d, or YYYY-MM-DD.

max.date

The end date for data to include. Same format as min.date.

Value

Either a single histogram, if variable by.lifestage is set to FALSE. Otherwise, a histogram for each individual life stage present within the data.

Details

This routine compiles fish from the CAMP Access dBase using function F.get.indiv.fish.data. Fish are included from both "valid" and "invalid" trapping instances where "valid" means includeCatchID = TRUE. Thus, resulting graphs can display both valid and invalid fishing instances if both types of trapping instances took place between min.date and max.date.

Observations in the output graph are jittered slightly when plotted to show the number of measurements on each date.

When no valid catch records are found, a blank png is returned.

Author

Trent McDonald and Jason Mitchell

See Also

F.get.indiv.fish.data

Examples

## Not run: 
#   ---- Obtain graphical histograms for the American. 
site <- 57000
taxon <- 161980
run <- 3
min.date <- "2014-01-01"
max.date <- "2014-06-06"
output.file <- "American"
by.lifestage <- TRUE

F.length.frequency(site,taxon,run,min.date,max.date,output.file,by.lifestage)

## End(Not run)

tmcd82070/CAMP_RST documentation built on April 6, 2022, 12:07 a.m.