Skip to content

Simulation code accompanying the Retiring the Ruler: Toward a Volumetric, Multi-Lesion, Longitudinal Lens on Tumor Response paper.

Notifications You must be signed in to change notification settings

bhklab/retiring-the-ruler

Repository files navigation

Retiring the Ruler

Authors: Katy Scott, Caryn Geady, Kaitlyn Kobayashi

Contact: [email protected]

Description: Simulation code accompanying the Retiring the Ruler: Toward a Volumetric, Multi-Lesion, Longitudinal Lens on Tumor Response paper.


pixi-badge Ruff Built with Material for MkDocs

GitHub last commit GitHub issues GitHub pull requests GitHub contributors GitHub release (latest by date)

Set Up

Prerequisites

Pixi is required to run this project. If you haven't installed it yet, follow these instructions

Installation

  1. Clone this repository to your local machine
  2. Navigate to the project directory
  3. Set up the environment using Pixi:
pixi install

Algorithm

SYNTHETIC LESION GENERATION

  1. Artificially generate a dataset of N patients (input arg: N).
  2. For each patient, generate a random number of lesions (range: 1-30, poisson distribution with µ = 5).
  3. For each lesion, generate a random diameter (select from a list of possible diameters, with replacement (using original_shape_Maximum2DDiameterSlice)).
  4. For each lesion, generate a diameter change (select from a Gaussian distribution, with fractional changes from -1 to 1).
  5. For each lesion, assign a location tag (e.g. liver, lung, bone, brain, again from a list of possible locations, with replacement).

LESION SELECTION BIAS ASSESSMENT

  1. For each patient, select a random number of lesions to be target lesions (up to 5 per patient, with a maximum of 2 per assigned location).
  2. From the selected target lesions, assess the RECIST response (SLD = 100% decrease = CR, SLD > 30% decrease = PR, SLD > 20% increase = PD, otherwise SD).
  3. For each patient, assess the RECIST response across all lesions (as above).
  4. Compare the RECIST response across all lesions to the RECIST response across target lesions only.

DIAMETER VERSUS VOLUME ASSESSMENT

  1. For each diameter, calculate the corresponding volume (assuming spherical shape; this will represent the lower end of volumetric measurement).
  2. Inject inter-observer variability by adding a random error to the volume calculation (select from a Gaussian distribution, with fractional diameter changes from -0.113 to 0.113; REF: https://pmc.ncbi.nlm.nih.gov/articles/PMC3423763/).
  3. For each lesion, calculate the volume using another diameter measurement (i.e., original_shape_Maximum3DDiameter).

Documentation

Click here to view the full documentation.

About

Simulation code accompanying the Retiring the Ruler: Toward a Volumetric, Multi-Lesion, Longitudinal Lens on Tumor Response paper.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages