View source: R/ca-scoreFACT_B.R
scoreFACT_B | R Documentation |
Generates all of the scores of the Functional Assessment of Cancer Therapy - Breast Cancer (FACT-B, v4) from item responses.
scoreFACT_B( df, id = NULL, AConly = FALSE, updateItems = FALSE, keepNvalid = FALSE )
df |
A data frame with the questionnaire items, appropriately-named. |
id |
(optional) The quoted name of a variable in |
AConly |
(optional) Logical, if omitted or set to |
updateItems |
(optional) Logical, if |
keepNvalid |
(optional) Logical, if |
Given a data frame that includes all of the FACT-B (Version 4) items as variables, appropriately named, this function generates all of the FACT-B scale scores. It is crucial that the item variables in the supplied data frame are named according to FACT conventions. For example, the first physical well-being 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.
This questionnaire consists of two components: (1) FACT-G items and (2)
"Additional Concerns" items. The FACT-G items (G for General) measure
general aspects of QoL common to all cancer patients. The "Additional
Concerns" items measure issues relevant for a specific cancer type,
treatment, or symptom. These two questionnaire components are typically
administered together. In some studies, however, ONLY the "Additional
Concerns" items are administered. The AConly
argument is provided to
accommodate such cases, and should be set to AConly = TRUE
if ONLY
the "Additional Concerns" items were administered.
For more details on the updateItems
and keepNvalid
arguments,
see the documentation entry for scoreFACTG
and
FACTscorer
.
A data frame with the following scale scores is returned:
PWB - Physical Well-Being subscale
SWB - Social/Family Well-Being subscale
EWB - Emotional Well-Being subscale
FWB - Physical Well-Being subscale
FACTG - FACT-G Total Score (PWB+SWB+EWB+FWB)
BCS - Breast Cancer subscale
FACT_B_TOTAL - FACT-B Total Score (PWB+SWB+EWB+FWB+BCS)
FACT_B_TOI - FACT-B Trial Outcome Index (PWB+FWB+BCS)
If AConly = TRUE
, the only scale score returned is BCS.
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-B Scoring Guidelines, available at http://www.facit.org
Brady, M.J., Cella D.F., Mo, F., Bonomi, A.E., Tulsky, D.S., Lloyd, S.R., Deasy, S., Cobleigh M., & Shiomoto, G. (1997). Reliability and validity of the Functional Assessment of Cancer Therapy-Breast (FACT-B) quality of life instrument. emphJournal of Clinical Oncology, 15, 974-986.
This function is very similar to the scoreFACTG
function. See the documentation for scoreFACTG
for more
details on the arguments and for examples. Also see the documentation
entry for the FACTscorer
package.
## FIRST creating a df with fake item data to score itemNames <- c('B1', 'B2', 'B3', 'B4', 'B5', 'B6', 'B7', 'B8', 'B9', 'P2') exampleDat <- make_FACTdata(namesAC = itemNames) ## NOW scoring the items in exampleDat ## Returns data frame with ONLY scale scores (scoredDat <- scoreFACT_B(exampleDat)) ## Using the id argument (makes merging with original data more fool-proof): (scoredDat <- scoreFACT_B(exampleDat, id = "ID")) ## Merge back with original data, exampleDat: mergeDat <- merge(exampleDat, scoredDat, by = "ID") names(mergeDat) ## If ONLY the "Additional Concerns" items are in df, use AConly = TRUE (scoredDat <- scoreFACT_B(exampleDat, AConly = TRUE)) ## AConly = TRUE with an id variable (scoredDat <- scoreFACT_B(exampleDat, id = "ID", AConly = TRUE)) ## Returns scale scores, plus recoded items (updateItems = TRUE) ## Also illustrates effect of setting keepNvalid = TRUE. scoredDat <- scoreFACT_B(exampleDat, updateItems = TRUE, keepNvalid = TRUE) names(scoredDat) ## Descriptives of scored scales summary(scoredDat[c('PWB', 'SWB', 'EWB', 'FWB', 'FACTG', 'BCS', 'FACT_B_TOTAL', 'FACT_B_TOI')])
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.