validate_choice

This function checks if an input is within a specified set of valid choices.
Depending on the specified type, it will either throw an error, issue a
warning, or send a message.

Hospitals, hospital systems, and even trauma systems that
provide care to injured patients may not be aware of robust metrics
that can help gauge the efficacy of their programs in saving the lives
of injured patients. 'traumar' provides robust functions driven by
the academic literature to automate the calculation of relevant
metrics to individuals desiring to measure the performance of their
trauma center or even a trauma system. 'traumar' also provides some
helper functions for the data analysis journey. Users can refer to the
following publications for descriptions of the methods used in
'traumar'. TRISS methodology, including probability of survival, and
the W, M, and Z Scores - Flora (1978)
<doi:10.1097/00005373-197810000-00003>, Boyd et al. (1987,
PMID:3106646), Llullaku et al. (2009) <doi:10.1186/1749-7922-4-2>,
Singh et al. (2011) <doi:10.4103/0974-2700.86626>, Baker et al. (1974,
PMID:4814394), and Champion et al. (1989)
<doi:10.1097/00005373-198905000-00017>. For the Relative Mortality
Metric, see Napoli et al. (2017) <doi:10.1080/24725579.2017.1325948>,
Schroeder et al. (2019) <doi:10.1080/10903127.2018.1489021>, and
Kassar et al. (2016) <doi:10.1177/00031348221093563>. For more
information about methods to calculate over- and under-triage in
trauma hospital populations and samples, please see the following
publications - Peng & Xiang (2016) <doi:10.1016/j.ajem.2016.08.061>,
Beam et al. (2022) <doi:10.23937/2474-3674/1510136>, Roden-Foreman et
al. (2017) <doi:10.1097/JTN.0000000000000283>.

Nicolas Foss

traumar

Calculate Metrics for Trauma System Performance

Iowa Department of Health and Human Services 

validate_choice function

<dl><dt>input</dt>
<dd>The data to be validated.</dd>
<dt>choices</dt>
<dd>a character vector of candidate values, often missing, see
documentation for <code><a href="/link/base%3A%3Amatch.arg()?package=traumar&version=1.2.4" data-mini-rdoc="traumar::base::match.arg()">base::match.arg()</a></code> for more information.</dd>
<dt>several.ok</dt>
<dd>logical specifying if <code>arg</code> should be allowed
 to have more than one element.</dd>
<dt>type</dt>
<dd>A character string specifying the type of message to be displayed
if the input is not numeric or if the values are out of range. Must be one
of "error", "warning", or "message".</dd>
<dt>na_ok</dt>
<dd>Logical. If TRUE, NA values are allowed. Default is TRUE.</dd>
<dt>null_ok</dt>
<dd>Logical. If TRUE, NULL values are allowed. Default is TRUE.</dd>
<dt>var_name</dt>
<dd>Optional. A character string giving the desired variable (or
object) name that will appear in console output in place of the how the
object will typically be named in messages via deparse(substitute(input)).</dd>
<dt>calls</dt>
<dd>Optional. The number of callers to go back in the call stack for
error messaging. If NULL, will default to 2.</dd></dl>

Arguments

Author

Validate Choice — validate_choice

<dl>

<dt>input</dt>
<dd>The data to be validated.</dd>


<dt>choices</dt>
<dd>a character vector of candidate values, often missing, see
documentation for <code><a href='https://rdrr.io/r/base/match.arg.html'>base::match.arg()</a></code> for more information.</dd>


<dt>several.ok</dt>
<dd>logical specifying if <code>arg</code> should be allowed
 to have more than one element.</dd>


<dt>type</dt>
<dd>A character string specifying the type of message to be displayed
if the input is not numeric or if the values are out of range. Must be one
of "error", "warning", or "message".</dd>


<dt>na_ok</dt>
<dd>Logical. If TRUE, NA values are allowed. Default is TRUE.</dd>


<dt>null_ok</dt>
<dd>Logical. If TRUE, NULL values are allowed. Default is TRUE.</dd>


<dt>var_name</dt>
<dd>Optional. A character string giving the desired variable (or
object) name that will appear in console output in place of the how the
object will typically be named in messages via deparse(substitute(input)).</dd>


<dt>calls</dt>
<dd>Optional. The number of callers to go back in the call stack for
error messaging. If NULL, will default to 2.</dd>

</dl>

validate_choice: Validate Choice

Description

Usage

Value

Arguments

Author

Details