Learn R Programming
⚠️There's a newer version (1.4.9) of this package.Take me there.

GenEst

GenEst: Generalized Fatality Estimator

GenEst is a tool for estimating mortalities from efficiency, persistence, and carcass data.

DISCLAIMER

This software is preliminary or provisional and is subject to revision. It is being provided to meet the need for timely best science. The software has not received final approval by the U.S. Geological Survey (USGS). No warranty, expressed or implied, is made by the USGS or the U.S. Government as to the functionality of the software and related material nor shall the fact of release constitute any such warranty. The software is provided on the condition that neither the USGS nor the U.S. Government shall be held liable for any damages resulting from the authorized or unauthorized use of the software.

Installation

Setup and installation require several steps. Do not skip any steps.

Updated version of R (>= 3.5.0, released on 23 April 2018):

R is free and open source software for statistical computing. If R is not installed on your computer or if your version of R is <3.5.0, download and install the latest version from https://cran.r-project.org/, following the instructions provided at the site. In particular, "Download" and then "install R for the first time" (if working in Windows), or "Download" and then follow the further instructions on the subsequent web page (if working on Mac OS or Linux-like OS). If you already have an older copy of R installed on your computer, the new version will be installed alongside the old. Unless you know a reason why you want to keep both versions, it is usually a good idea to uninstall the old version to avoid confusion and clutter.

NOTE TO EXPERIENCED R USERS: When you install a new version of R, packages that you previously installed under an older version may not be immediately available to the new R. If not, the easiest way to make them available is to copy the package folders in your old "library" folder into the "library" folder in your new R installation. Then, enter update.packages() in R. If asked about a CRAN mirror, choose the nearest location. If you are working in Windows OS and are asked whether you want to install packages "from source", choose "No".

Third-party packages:

Several third-party pacakges are required; all are free and open source and available from CRAN. The easiest way to install them is to run the following commands in R (with guidance concerning potential dialog boxes given below the commands):


package_new <- c("cbinom", "corpus", "DT", "gsl", "gtools", "htmltools", "lubridate", 
   "matrixStats", "mvtnorm", "Rcpp", "shiny", "shinyjs", "sticky", "survival")
package_new <- package_new[!(package_new %in% installed.packages()[,"Package"])] 
if(length(package_new) > 0) install.packages(package_new)

-- If asked about a "CRAN mirror", choose the nearest location.

-- If asked whether you want to use a "personal library", choose "Yes"

-- If you are on Windows and are asked whether you want to install packages and their dependencies "from source", choose "No" (unless you are ready to go to lunch, in which case, you can select "Yes" and the installation may well be done by the time you get back).

GenEst:

Click on "Releases" and then click the link for the specific release you want.

-- For Windows, download the compressed folder GenEst_1.0.0.zip (do not unzip) and note where it is stored. You will install from the local .zip folder.

-- For Mac OS or Unix-like OS, download the compressed file GenEst_1.0.0.tar.gz and note where it is stored. You will install from the local .tar.gz file.

If you are working directly in R (not R Studio), run the following command:

install.packages(file.choose()) # and navigate to the package archive file you just downloaded: GenEst_1.0.0.xxx

If you are working in R Studio:

Click "Install" in the Packages pane.

Select "Package Archive File (.zip; .tar.gz)" as "Install from:" in the dialog box.

Browse to where you saved the zip file, and open it so it appears in the "Package archive" space.

Click the Install button on the dialog box.

Getting Started

Graphical user interface (GUI): easy-to-use buttons and menus

To start the GUI, open R and enter the command:

library(GenEst)
runGenEst()

Download the User Guide from a link near the bottom of the "Help" page in the app or from https://pubs.usgs.gov/tm/7c19/tm7c19.pdf

R command line: more functionality and flexibility

library(GenEst)
browseVignettes("GenEst")
?GenEst

Also, help files for GenEst functions are accessible in the standard R way, for example:

?pkm

Further Reading

GenEst User Guide: https://pubs.usgs.gov/tm/7c19/tm7c19.pdf

GenEst Statistical Models: https://pubs.usgs.gov/tm/7a2/tm7a2.pdf

Copy Link

Version

Install

install.packages('GenEst')

Monthly Downloads

424

Version

1.1.0

License

CC0

Maintainer

Dan Dalthorp

Last Published

November 20th, 2018

Functions in GenEst (1.1.0)

DWPCols

Select the DWP-ok columns from a data table
GenEstInlineCSS

Generate the Inline CSS Definition
calcRate

Estimate the number of fatalities in each search interval throughout the monitoring period.
Ecbinom

Expected value of a continuous binomial with size = 1/g
calcSplits

Estimate the number of fatalities by up to two splitting covariates
GenEst

Generalized estimation of mortality
aicc

Generic S3 function for summarizing AICc
checkSpecificModelCP

Error check a specific model selection for a CP plot
aicc.cpm

Extract AIC and AICc for a carcass persistence model
aicc.pkm

extract AICc value from pkm object
GenEstServer

The GenEst server definition function
checkSpecificModelSE

Error check a specific model selection for an SE plot
countCarcs

Count the minimum number of carcasses in the cells
aicc.pkmSet

Create the AICc tables for a set of searcher efficiency models
cpmSetSpecCPCellPlot

Plot cell-specific decay curve for carcass persistence
downloadCPFig

Download the CP figure
cpmSetSizeFailRemove

Remove failed cpm models from a cpmSetSize object
dlModTabSE

Create the download version of the Searcher Efficiency model table
SEsi0

Calculate decayed searcher efficiency for a single pk
cpLogLik

Calculate the negative log-likelihood of a carcass persistence model
cpm

Fit cp carcass persistence models
SEsi_left

Calculate conditional probability of observation at a search
estgGeneric

Estimate generic g
cpmCPCellPlot

Plot cell-specific decay curve for carcass persistence
dataInputWidget

Create a Data Input Widget for the GenEst User Interface HTML
dataTabPanel

Create a Data Tab Panel for the GenEst User Interface HTML
estText

Prepare the text for the estimation table
CPdistOptions

Produce the options for the distributions in the CP model
CPcols

Produce a named vector of standard CP plot colors
estg

Estimate all carcass-level detection rates and arrival intervals
estgGenericSize

Estimate generic detection probability for multiple size classes
SEcols

Produce a named vectory with standard SE plot colors
calcTsplit

Estimate the number of fatalities by time interval
calcg

Calculate cell-level generic detection probability
classText

Prepare class text header
clearNotifications

Clear all notifications
SEsi

Calculate decayed searcher efficiency
GenEstShinyJS

Shiny Java Script (via shinyjs) Enabler
cpmFail

Check if a CP model is well-fit
cpmSetFail

Check if cpm models fail
modNamePaste

Paste the parts of a model's name back together
averageSS

Tabulate an average search schedule from a multi-unit SS data table
cButtonStyle

Define Clear Button Style
modNameSplit

Split model names into their components and remove only a desired one
modelSetPredictors

Determine the predictors for a whole model set
initialOutput

Update the output list upon initiation of the app
GenEstUI

Create the GenEst User Interface HTML
SEsi_right

Calculate conditional probability of observation after a series of searches
initialReactiveValues

Create the main reactive value list for GenEst
aboutContent

Create the Content for the About Pabel
aicc.pkmSetSize

Create the AICc tables for a list of sets of searcher efficiency models
msgFracNote

Create the message for when an incorrect FFS is input
checkComponents

Check for model components
checkDate

Checks whether a vector of data can be interpreted as dates
aicc.pkmSize

Create the AICc tables for a list of sets of searcher efficiency models
msgModFail

Create the error message for when no models are fit successfully
modelSetModelCells

Determine the cells from each model in a model set
cpmSetFailRemove

Remove failed cpm models from a cpmSet object
dateCols

Select the date columns from a data table
dateToDay

Calculate day of study from calendar date
downloadSEFig

Download the SE figure
combinePreds

Combine predictors
downloadTable

Download a table
matchCells

Match cells between models.
combinePredsAcrossModels

Combine predictors across models
mock

A mock example data set
modelSelectionWidget

Make a Model Selection Widget
cpmSetSizeFail

Check if all of the cpm models fail
msgModPartialFail

Create the warning message text for when only some models are fit successfully
modelSetModelPredictors

Determine the predictors from each model in a model set
disclaimersContent

Create the Content for the Disclaimers Pabel
pkLogLik

Calculate the negative log-likelihood of a searcher efficiency model
dlModTabCP

Create the download version of the Carcass Persistence model table
msgModRun

Create a model running message
pkm

Fit pk searcher efficiency models.
msgModSENobs

Create the SE data size notification
modelSetCells

Determine the cell table for a full model set
estM

Estimate mortality
downloadgFig

Download the g figure
msgSplitFail

Create the fail message for when splits aren't done correctly
navbar

Create the HTML for the navigation bar UI element
isNeverDecreasing

Is a vector never decreasing?
pkmSECellPlot

Plot cell-specific decay curve for searcher efficiency
msgSSinputFail

Create the warning message for when the SS based on inputs doesn't work
pkmSetSpecParamPlot

p or k box plots for an SE model set
msgSampleSize

Create the warning message text for small sample sizes
pkmSetSpecSECellPlot

Plot cell-specific decay curve for searcher efficiency for a specific model with comparison to the cellwise model
kFixedWidget

Make a kFixed Widget
modelInputWidget

Create a Model Input Widget for the GenEst User Interface HTML
modelOutputPanel

Create a Model Output Tab Panel for the GenEst User Interface HTML
msgList

Produce the message list
plot.estM

Plot total mortality estimation
plot.gGeneric

Plot results of a single generic ghat estimation
createvtext

Create the version text for GenEst
msgModDone

Create a model done message
dataDownloadWidget

Create a Data Download Widget for the GenEst User Interface HTML
downloadData

Download a zipped data set
obsCols_SE

Select the columns from a data table that could be SE observations
pkmFail

Check if a pk model is well-fit
pkmSetAllFail

Check if all of the pkm models fail within a given set
plotSEBoxTemplate

template box plot
downloadMFig

Download the M figure
plot.gGenericSize

Plot results of a set of size-based generic ghat estimations
obsCols_fta

Select the columns from a data table that could be CP First Time Absent observations
plot.pkm

Plot results of a single pk model
pkmParamPlot

Plot parameter box plots for each cell for either p or k
plot.cpm

Plot results of a single CP model
expandModelSetCP

Expand a CP model set for plotting
gettingStartedContent

Create the Content for the Getting Started Pabel
plotNA

Produce a blank plot for unsucessful fits
plot.cpmSet

Plot results of a set of CP models
plotSEBoxPlots

p and k box plots for an SE model set
prettyModTabSE

Create the pretty version of the Searcher Efficiency model table
plotSECells

Plot the cellwise results of a single model in a set of SE models
reNULL

Reset values of a list to NULL
prettySplitTab

Create the pretty version of the split summary table
plot.pkmSet

Plot results of a set of SE models
pkmSetFail

Check if pkm models fail
plot.splitFull

Plot summary statistics for splits of mortality estimates
pkmSetFailRemove

Remove failed pkm models from a pkmSet object
plotCPFigure

Plot results of a single CP model in a set
plotCPHeader

The CP plot header
logit

Compute the logit or anti-logit
readCSV

Read in csv files in either format
ltranspose

Transpose a list of arrays
refMod

Return the model with the greatest log-likelihood
prepPredictors

Prepare predictors based on inputs
modelOutputWidget

Create a Model Output Widget for the GenEst User Interface HTML
prepSS

Create search schedule data into an prepSS object for convenient splits analyses
modelRunWidget

Create a Model Run Widget for the GenEst User Interface HTML
plotSEFigure

Plot results of a single SE model in a set
msgModWarning

Create the warning message for a model run (if needed)
reVal

Reset values of a reactive values list
rpk

Simulate parameters from a fitted pk model
print.pkm

Print a pkm model object
plotSEHeader

The SE plot header
print.corpus_frame

Generic S3 function for printing corpus_frame
msgSSavgFail

Create the warning message for when the SS average doesn't work
rcp

Simulate parameters from a fitted cp model
solar_PV

Photovoltaic Example Dataset
print.cpm

Print a cpm model object
removeCols

Remove selected columns from column names
renderDTns

Render a data table without server-side processing
solar_powerTower

Power Tower Example Dataset
tidyModelSetCP

Tidy a CP model set
obsCols_ltp

Select the columns from a data table that could be CP Last Time Present observations
setkFix

Update the fixed k value
setFigW

Set Figure width and height based on the number of cells
setNotSuspending

(Re)set outputOptions to not suspending for given elements
pickSizeclass

Locate the sizeclass selected by the inputs
runGenEst

Launch the GenEst Application
simpleMplot

Plot a total mortality estimation for a simple situation
setkNeed

Create the kNeed text
pkmSetSizeFail

Check if all of the pkm models fail
summary.estM

Summarize total mortality estimation
tidyModelSetSE

Tidy an SE model set
updateSizeclasses

Update the size classes
update_input

Update the inputs when an event occurs
sizeCols

Select the potential size class columns from a data table
pkmSetSizeFailRemove

Remove failed pkm models from a pkmSetSize object
wind_RP

Wind Road and Pad (120m) Example
wind_RPbat

Wind Bat-Only Road and Pad (120m) Example
trueLength

Get the length of real (non-NA) things
summary.gGeneric

Summarize the gGeneric list to a simple table
plot.splitSummary

Plot summary statistics for splits of mortality estimates
updateColNames_size

Update the string of column names that are in all the needed tables
plotCPCells

Plot the cellwise results of a single model in a set of CP models
wind_cleared

Wind cleared plot (60m) Search Example
summary.gGenericSize

Summarize the gGenericSize list to a list of simple tables
ppersist

Calculate the probability of persistence to detection
summary.splitFull

Summarize results of mortality estimate splits
predsCols

Select the predictor-ok columns from a data table
prepSizeclassText

Prepare text for size classes
prettyModTabCP

Create the pretty version of the Carcass Persistence model table
update_output

Update the outputs when an event occurs
update_rv

Update the reactive value list when an event occurs
selectData

Select particular columns from a data set
selectedDataPanel

Create a Selected Data Tab Panel for the GenEst User Interface HTML
solar_trough

Trough-based solar thermal power simulated example
style

HTML tag functions
transposeSplits

Transpose a splitFull array (preserving attributes)
trimSetSize

Trim a Model-Set-Size Complex to a Single Model Per Size
updatesizeCol

Update the name of the size class column based on available names
widgetMaker

Input Widget Maker
DWPbyCarcass

Assign DWP value to each carcass
aicc.cpmSet

Create the AICc tables for a set of carcass persistence models
aicc.cpmSetSize

Create the AICc tables for a list of sets of searcher efficiency models