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)
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 |
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 |
A vector of minimum values for length categories for the chosen species.
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.
6-Size Structure.
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.]
# List all of the species psdVal()#> #>#> [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 380psdVal("Walleye",units="cm")#> substock stock quality preferred memorable trophy #> 0 25 38 51 63 76psdVal("Bluegill",units="in")#> substock stock quality preferred memorable trophy #> 0 3 6 8 10 12psdVal("Bluegill",units="in",incl.zero=FALSE)#> stock quality preferred memorable trophy #> 3 6 8 10 12psdVal("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 300psdVal("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 12psdVal("Bluegill",units="in",addLens=7,addNames="MinLen")#> substock stock quality MinLen preferred memorable trophy #> 0 3 6 7 8 10 12psdVal("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 12psdVal("Bluegill",units="in",addLens=c("MinLen"=7))#> substock stock quality MinLen preferred memorable trophy #> 0 3 6 7 8 10 12psdVal("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