Python package for documenting all the functions used in the derivation of the iai clinical decision rule.

Stable clinical rule learning.

Demonstrating the use of PDR/PCS in emergency medicine on the PECARN dataset.

Code for reproducing analysis evaluating the PECARN Clinical Decision rule for prediction Intra-abdominal injury requiring intervention (IAI-I).

Documentation for useful functions is here and for a thorough look into the notebooks is here.

PCS documentation

1. Domain problem formulation

Our goal is to be able to identify the risk of clinically important traumatic brain injury (ciTBI) among children. This information can be used to triage CT imaging.

The outcome is definite to be Intra-abdominal injury requiring intervention (IAI-I).

2. Data collection and storage

Protocol for screening subjects is given in the PECARN paper01743-X/fulltext) (i.e. children presenting within 24 h of non-trivial head trauma) and the PSRC paper. Data is now open-source and available as a series of csv and accompanying pdf files providing details on how it was collected.

3. Data cleaning and preprocessing

After matching features between the PECARN and PSRC data, we get histograms as shown below:

The definition of the outcome is the most difficult part. Categorical features are one-hot encoded.

4. Exploratory data analysis

Split up preverbal (<2 years of age) and verbal (>=2 years of age) patients.

5. Modeling and Post-hoc analysis

Many different models are fit and achieve different sensitivity/specificity tradeoffs.

6. Interpretation of results

We are able to rederive reasonable rule-based models for IAI prediction.

Reference

  • IAI data is gratefully downloaded from the open-source PECARN website (also available here in the data folder)
    • unfortunately, PSRC data is not available open-source at this time
  • makes heavy use of the imodels package
Expand source code
"""
Python package for documenting all the functions used in the
derivation of the iai clinical decision rule.
.. include:: ../readme.md
"""

Sub-modules

src.config
src.data
src.data_pecarn
src.data_psrc
src.train
src.validate
src.viz