Returns a vector with the five Gabelhouse lengths for a chosen species.

psdVal(species = "List", units = c("mm", "cm", "in"),
  incl.zero = TRUE, addLens = NULL, addNames = NULL)

Arguments

species

A string that contains the species name for which to find Gabelhouse lengths. See details.

units

A string that indicates the units for the returned lengths. Choices are mm for millimeters (DEFAULT), cm for centimeters, and in for inches.

incl.zero

A logical that indicates if a zero is included in the first position of the returned vector (DEFAULT) or not. This position will be named “substock”. See details.

addLens

A numeric vector that contains minimum length definitions for additional categories. See details.

addNames

A string vector that contains names for the additional length categories added with addLens. See details.

Value

A vector of minimum values for length categories for the chosen species.

Details

Finds the Gabelhouse lengths from data(PSDlit) for the species given in species. The species name must be spelled exactly (within capitalization differences) as it appears in data(PSDlit). Type psdVal() to see the list of species and how they are spelled.

A zero is included in the first position of the returned vector if incl.zero=TRUE. This is useful when computing PSD values with a data.frame that contains fish smaller than the stock length.

Additional lengths may be added to the returned vector with addLens. Names for these lengths can be included in addNames. If addNames is non-NULL, then it must be of the same length as addLens. If addLens is non-NULL but addNames is NULL, then the default names will be the same as the lengths in addLens. The addLens argument is useful for calculating PSD values that are different from the Gabelhouse lengths.

IFAR Chapter

6-Size Structure.

References

Ogle, D.H. 2016. Introductory Fisheries Analyses with R. Chapman & Hall/CRC, Boca Raton, FL.

Guy, C.S., R.M. Neumann, and D.W. Willis. 2006. New terminology for proportional stock density (PSD) and relative stock density (RSD): proportional size structure (PSS). Fisheries 31:86-87. [Was (is?) from http://pubstorage.sdstate.edu/wfs/415-F.pdf.]

Guy, C.S., R.M. Neumann, D.W. Willis, and R.O. Anderson. 2006. Proportional size distribution (PSD): A further refinement of population size structure index terminology. Fisheries 32:348. [Was (is?) from http://pubstorage.sdstate.edu/wfs/450-F.pdf.]

Willis, D.W., B.R. Murphy, and C.S. Guy. 1993. Stock density indices: development, use, and limitations. Reviews in Fisheries Science 1:203-222. [Was (is?) from http://web1.cnre.vt.edu/murphybr/web/Readings/Willis%20et%20al.pdf.]

See also

See psdCalc, psdPlot, psdAdd, PSDlit, tictactoe, lencat, and rcumsum for related functionality.

Examples

# List all of the species psdVal()
#> #> Species name must be one of following. Be careful of spelling and capitalization.
#> [1] "Arctic Grayling" "Bighead Carp" #> [3] "Bigmouth Buffalo" "Black Bullhead" #> [5] "Black Carp" "Black Crappie" #> [7] "Blue Catfish" "Bluegill" #> [9] "Brook Trout" "Brook Trout (lentic)" #> [11] "Brook Trout (lotic)" "Brown Bullhead" #> [13] "Brown Trout (lentic)" "Brown Trout (lotic)" #> [15] "Bull Trout" "Burbot" #> [17] "Chain Pickerel" "Channel Catfish" #> [19] "Chinook Salmon (landlocked)" "Common Carp" #> [21] "Cutthroat Trout" "Flathead Catfish" #> [23] "Freshwater Drum" "Gizzard Shad" #> [25] "Golden Trout" "Grass Carp" #> [27] "Green Sunfish" "Kokanee" #> [29] "Lake Trout" "Largemouth Bass" #> [31] "Longnose Gar" "Muskellunge" #> [33] "Northern Pike" "Paddlefish" #> [35] "Palmetto Bass" "Palmetto Bass (original)" #> [37] "Pumpkinseed" "Rainbow Trout" #> [39] "Redear Sunfish" "River Carpsucker" #> [41] "Rock Bass" "Ruffe" #> [43] "Sauger" "Saugeye" #> [45] "Shorthead Redhorse" "Silver Carp" #> [47] "Smallmouth Bass" "Smallmouth Buffalo " #> [49] "Splake" "Spotted Bass" #> [51] "Spotted Gar" "Striped Bass (landlocked)" #> [53] "Suwannee Bass" "Walleye" #> [55] "Warmouth" "White Bass" #> [57] "White Catfish" "White Crappie" #> [59] "White Perch" "White Sucker" #> [61] "Yellow Bass" "Yellow Bullhead" #> [63] "Yellow Perch"
# Demonstrate typical usages psdVal("Yellow perch")
#> substock stock quality preferred memorable trophy #> 0 130 200 250 300 380
psdVal("Walleye",units="cm")
#> substock stock quality preferred memorable trophy #> 0 25 38 51 63 76
psdVal("Bluegill",units="in")
#> substock stock quality preferred memorable trophy #> 0 3 6 8 10 12
psdVal("Bluegill",units="in",incl.zero=FALSE)
#> stock quality preferred memorable trophy #> 3 6 8 10 12
psdVal("Bluegill")
#> substock stock quality preferred memorable trophy #> 0 80 150 200 250 300
# Demonstrate that it will work with mis-capitalization psdVal("bluegill")
#> substock stock quality preferred memorable trophy #> 0 80 150 200 250 300
psdVal("Yellow Perch")
#> substock stock quality preferred memorable trophy #> 0 130 200 250 300 380
# Demonstrate adding in user-defined categories psdVal("Bluegill",units="in",addLens=7)
#> substock stock quality 7 preferred memorable trophy #> 0 3 6 7 8 10 12
psdVal("Bluegill",units="in",addLens=7,addNames="MinLen")
#> substock stock quality MinLen preferred memorable trophy #> 0 3 6 7 8 10 12
psdVal("Bluegill",units="in",addLens=c(7,9),addNames=c("MinSlot","MaxSlot"))
#> substock stock quality MinSlot preferred MaxSlot memorable trophy #> 0 3 6 7 8 9 10 12
psdVal("Bluegill",units="in",addLens=c("MinLen"=7))
#> substock stock quality MinLen preferred memorable trophy #> 0 3 6 7 8 10 12
psdVal("Bluegill",units="in",addLens=c("MinSlot"=7,"MaxSlot"=9))
#> substock stock quality MinSlot preferred MaxSlot memorable trophy #> 0 3 6 7 8 9 10 12