View source: R/tx-scoreFACT_EGFRI.R
scoreFACT_EGFRI | R Documentation |
Scores the Functional Assessment of Cancer Therapy - for patients treated with EGFR Inhibitors (FACT-EGFRI) from item responses.
scoreFACT_EGFRI(df, id = NULL, updateItems = FALSE, keepNvalid = FALSE)
df |
A data frame with the questionnaire items, appropriately-named. |
id |
(optional) The quoted name of a variable in |
updateItems |
(optional) Logical, if |
keepNvalid |
(optional) Logical, if |
Given a data frame that includes all of the FACIT-EGFRI items as variables, appropriately named, this function generates the FACIT-EGFRI scale score. It is crucial that the item variables in the supplied data frame are named according to FACT conventions. For example, the first item should be named GP1, the second GP2, and so on. Please refer to the materials provided by http://www.facit.org for the particular questionnaire you are using. In particular, refer to the left margin of the official questionnaire (i.e., from facit.org) for the appropriate item variable names.
For more details on the updateItems
and keepNvalid
arguments,
see the documentation entry for scoreFACTG
and
FACTscorer
.
A data frame containing the following scale score is returned:
FACIT_EGFRI - FACT EGFR Inhibitors
If a variable was given to the id
argument, then that variable will
also be in the returned data frame. Additional, relatively unimportant,
variables will be returned if updateItems = TRUE
or keepNvalid
= TRUE
.
Keep in mind that this function (and R in general) is case-sensitive.
All items in df
should be numeric
(i.e., of type
integer
or double
).
This function expects missing item responses to be coded as NA
,
8
, or 9
, and valid item responses to be coded as 0
,
1
, 2
, 3
, or 4
. Any other value for any of the
items will result in an error message and no scores.
FACT-EGFRI Scoring Guidelines, available at http://www.facit.org
For additional details on the function arguments, see
scoreFACTG
and FACTscorer
. For brevity,
examples are omitted below. However, this function is very similar to the
scoreFACTG7
function. See the documentation for
scoreFACTG7
for examples. Alternatively, examples for
scoreFACT_EGFRI
can be accessed by running
example(scoreFACT_EGFRI)
.
## FIRST creating a df with fake item data to score itemNames <- c('ST4', 'ST5', 'ST6', 'ST7', 'ST9', 'ST32', 'ST22', 'ST17', 'ST24', 'ST37', 'ST26', 'ST34', 'ST38', 'ST16', 'ST15', 'ST29', 'B5', 'ST11') exampleDat <- make_FACTdata(namesAC = itemNames, AConly = TRUE) ## NOW scoring the items in exampleDat ## Returns data frame with ONLY scale score (scoredDat <- scoreFACT_EGFRI(exampleDat)) ## Using the id argument (makes merging with original data more fool-proof): (scoredDat <- scoreFACT_EGFRI(exampleDat, id = "ID")) ## Merge back with original data, exampleDat: mergeDat <- merge(exampleDat, scoredDat, by = "ID") names(mergeDat) ## Returns scale score, plus recoded items (updateItems = TRUE) ## Also illustrates effect of setting keepNvalid = TRUE. scoredDat <- scoreFACT_EGFRI(exampleDat, updateItems = TRUE, keepNvalid = TRUE) names(scoredDat) ## Descriptives of scored scales summary(scoredDat['FACIT_EGFRI'])
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.