Skip to contents

Usage

recist(
  data,
  patientId,
  assessmentTime,
  lesionId,
  lesionType,
  lesionDiameter,
  nonTargetStatus,
  organ,
  maxTargetLesions = 5,
  maxPerOrgan = 2,
  prThreshold = 30,
  pdThreshold = 20,
  pdAbsolute = 5,
  requireConfirmation = TRUE,
  confirmationWindow = 4,
  nadirReference = TRUE,
  sdMinDuration = 6,
  nonTargetCR = "absent, disappeared",
  nonTargetPD = "pd, progression, unequivocal",
  showLesionTable = TRUE,
  showTargetSumTable = TRUE,
  showResponseTable = TRUE,
  showBestResponse = TRUE,
  showLesionPlot = TRUE,
  showSumPlot = TRUE,
  showWaterfallPlot = TRUE,
  groupVar,
  stratifiedAnalysis = FALSE,
  exportLesionData = FALSE,
  showReference = TRUE,
  formula
)

Arguments

data

the data as a data frame

patientId

Patient identifier variable

assessmentTime

Time from baseline (weeks or months)

lesionId

Unique lesion identifier

lesionType

Lesion type (target, non-target, new)

lesionDiameter

Lesion diameter in millimeters (for target lesions)

nonTargetStatus

Non-target lesion status (present, absent, unequivocal PD)

organ

Organ location (for max 2 per organ rule)

maxTargetLesions

Maximum number of target lesions (default: 5 per RECIST 1.1)

maxPerOrgan

Maximum target lesions per organ (default: 2 per RECIST 1.1)

prThreshold

Percent decrease for partial response (default: 30\

pdThresholdPercent increase for progressive disease (default: 20\pdAbsoluteAbsolute increase required for PD (default: 5mm)requireConfirmationRequire 2 consecutive assessments for CR/PRconfirmationWindowMinimum weeks between confirmation assessmentsnadirReferenceUse nadir (lowest) sum as reference for PD calculationsdMinDurationMinimum duration from baseline required to qualify for Stable Disease (SD)nonTargetCRValues in non-target status variable indicating Complete Response (comma separated)nonTargetPDValues in non-target status variable indicating Progressive Disease (comma separated)showLesionTableShow individual lesion measurementsshowTargetSumTableShow aggregated target lesion sums by assessmentshowResponseTableShow RECIST response categories per assessmentshowBestResponseCalculate best overall response per patientshowLesionPlotPlot individual lesion sizes over timeshowSumPlotPlot target lesion sum over timeshowWaterfallPlotWaterfall plot of best percent changegroupVarGrouping variable for stratified analysisstratifiedAnalysisPerform stratified analysis by groupexportLesionDataExport processed lesion-level data to CSVshowReferenceDisplay RECIST 1.1 guidelines referenceformula(optional) the formula to use, see the examples A results object containing:

results$runSummarya html
results$instructionsa html
results$dataInfoa table
results$lesionTablea table
results$targetSumTablea table
results$responseTablea table
results$bestResponseTablea table
results$summaryStatsa table
results$efficacyMetricsa table
results$lesionPlotan image
results$sumPlotan image
results$waterfallPlotan image
results$stratifiedTablea table
results$clinicalInterpretationa html
results$referenceInfoa html
Tables can be converted to data frames with asDF or as.data.frame. For example:results$dataInfo$asDFas.data.frame(results$dataInfo) Multi-lesion RECIST 1.1 aggregation for automated calculation of target lesion sums and best overall response. Processes individual lesion measurements and applies RECIST 1.1 criteria (Eisenhauer et al., 2009) for response classification. data <- data.frame( patient = rep(c("P01", "P02"), each = 6), time = rep(c(0, 8, 16), 4), lesion = rep(c("L1", "L2"), each = 3, times = 2), lesion_type = "target", diameter = c(25, 15, 12, 20, 10, 8, 30, 35, 40, 22, 20, 18) )recist( data = data, patientId = "patient", assessmentTime = "time", lesionId = "lesion", lesionType = "lesion_type", lesionDiameter = "diameter" )