Returns a vector that contains all known or a subset of information about the standard weight equation for a given species, type of measurement units, and reference percentile.
Usage
wsVal(
species = "List",
units = c("metric", "English"),
ref = 75,
simplify = FALSE
)Arguments
- species
A string that contains the species name for which to find coefficients. See details.
- units
A string that indicates whether the coefficients for the standard weight equation to be returned are in (
"metric"(DEFAULT; mm and g) or"English"(in and lbs) units.- ref
A numeric that indicates which percentile the equation should be returned for. Note that the vast majority of equations only exist for the
75th percentile (DEFAULT).- simplify
A logical that indicates whether the ‘units’, ‘ref’, ‘measure’, ‘method’, ‘comments’, and ‘source’ fields should be included (
=FALSE) or not (=TRUE; DEFAULT). See details.
Value
A one row data frame from WSlit that contains all known information about the standard weight equation for a given species, type of measurement units, and reference percentile if simplify=FALSE. If simplify=TRUE then only the species; minimum and maximum length for which the standard equation should be applied; and intercept, slope, and quadratic coefficients for the standard weight equation. Note that the maximum length and the quadratic coefficient will not be returned if they do not exist in WSlit.
If no arguments are given to this function, a species name is mis-spelled, or if a standard weight equation does not exist (in WSlit) for a particular species, then a warning will be issued and a list of species names will be printed.
Details
This function extract all known information from WSlit about the following standard weight equation,
$$log_{10}(Ws) = log_{10}(a) + blog_{10}(L) + blog_{10}(L)^{2}$$
See WSlit for more information about the meaning of each value returned.
Note from above that the coefficients are returned for the TRANSFORMED model. Thus, to obtain the standard weight (Ws), the returned coefficients are used to compute the common log of Ws which must then bed raised to the power of 10 to compute the Ws.
References
Ogle, D.H. 2016. Introductory Fisheries Analyses with R. Chapman & Hall/CRC, Boca Raton, FL.
Author
Derek H. Ogle, DerekOgle51@gmail.com
Examples
wsVal()
#>
#> Species name must be one of following. Be careful of spelling and capitalization.
#> [1] "Aegean Chub" "African Sharptooth Catfish"
#> [3] "Alabama Bass" "Ankara Nase"
#> [5] "Arctic Grayling" "Bighead Carp"
#> [7] "Bigmouth Buffalo" "Bigmouth Sleepers (all)"
#> [9] "Bigmouth Sleepers (lotic)" "Black Bullhead"
#> [11] "Black Crappie" "Blacktail Redhorse"
#> [13] "Blue Catfish" "Blue Sucker"
#> [15] "Bluegill" "Bridgelip Sucker"
#> [17] "Brook Chub" "Brook Trout"
#> [19] "Brook Trout (appalachia)" "Brown Bullhead"
#> [21] "Brown Trout (lentic)" "Brown Trout (lotic)"
#> [23] "Bull Trout" "Burbot"
#> [25] "Cavedano Chub" "Chain Pickerel"
#> [27] "Channel Catfish" "Chinook Salmon"
#> [29] "Cisco" "Common Carp"
#> [31] "Cutthroat Trout (lentic)" "Cutthroat Trout (lotic)"
#> [33] "European Chub" "European Perch"
#> [35] "Flannelmouth Sucker" "Flathead Catfish"
#> [37] "Fourbarbel Scraper" "Freshwater Drum"
#> [39] "Gizzard Shad" "Golden Shiner"
#> [41] "Golden Trout" "Green Sunfish"
#> [43] "Horse Barbel" "Humpback Chub"
#> [45] "Kokanee" "Lake Herring"
#> [47] "Lake Trout" "Largemouth Bass"
#> [49] "Largescale Sucker" "Longnose Gar"
#> [51] "Marble Trout" "Mountain Mullet"
#> [53] "Mountain Whitefish" "Muskellunge (female)"
#> [55] "Muskellunge (male)" "Muskellunge (overall)"
#> [57] "Nile Tilapia" "Nipple-Lip Scraper"
#> [59] "Northern Pike" "Northern Pikeminnow"
#> [61] "Northern Squawfish" "Paddlefish (female)"
#> [63] "Paddlefish (male)" "Paddlefish (overall)"
#> [65] "Palmetto Bass" "Pejerrey"
#> [67] "Pumpkinseed" "Pursak Chub"
#> [69] "Rainbow Trout (lentic)" "Rainbow Trout (lotic)"
#> [71] "Razorback Sucker" "Redbreast Sunfish"
#> [73] "Redear Sunfish" "Riffle Dace"
#> [75] "River Carpsucker" "River Goby"
#> [77] "Rock Bass" "Roundtail Chub"
#> [79] "Ruffe" "Sardine"
#> [81] "Sauger" "Saugeye"
#> [83] "Shoal Bass" "Shorthead Redhorse"
#> [85] "Shovelnose Sturgeon" "Silver Carp"
#> [87] "Smallmouth Bass" "Smallmouth Buffalo"
#> [89] "South European Roach" "Spotted Bass"
#> [91] "Spotted Bass (alabama subspecies)" "Spotted Gar"
#> [93] "Spotted Sunfish" "Striped Bass"
#> [95] "Striped Bass (hybrid)" "Striped Bass X White Bass"
#> [97] "Suwannee Bass" "Tiger Muskellunge"
#> [99] "Utah Chub" "Walleye"
#> [101] "Walleye (30-149 mm)" "Warmouth"
#> [103] "White Bass" "White Catfish"
#> [105] "White Crappie" "White Perch"
#> [107] "White Sturgeon" "White Sucker"
#> [109] "Yellow Bass" "Yellow Bullhead"
#> [111] "Yellow Perch"
wsVal("Bluegill")
#> species units type ref measure method min.TL int slope source
#> 26 Bluegill metric linear 75 TL Other 80 -5.374 3.316 Hillman (1982)
wsVal("Bluegill",units="metric")
#> species units type ref measure method min.TL int slope source
#> 26 Bluegill metric linear 75 TL Other 80 -5.374 3.316 Hillman (1982)
wsVal("Bluegill",units="English")
#> species units type ref measure method min.TL int slope
#> 25 Bluegill English linear 75 TL Other 3 -3.371 3.316
#> source
#> 25 Hillman (1982)
wsVal("Bluegill",units="English",simplify=TRUE)
#> species min.TL int slope
#> 25 Bluegill 3 -3.371 3.316
wsVal("Ruffe",units="metric",simplify=TRUE)
#> species min.TL max.TL int slope quad
#> 144 Ruffe 55 205 -2.58 0.621 0.6073
wsVal("Ruffe",units="metric",ref=50,simplify=TRUE)
#> species min.TL max.TL int slope quad
#> 143 Ruffe 55 205 -3.3524 1.3969 0.4054