README.md

EHRDiff [TMLR]

This is the official code base for paper: "EHRDiff: Exploring Realistic EHR Synthesis with Diffusion Models".

Requirements

• Install the dependencies by:

conda create -n ehrdiff python=3.9
pip install -r requirements.txt

Usage

First, you need to preprocess the EHR data into a binary matrix, which serves as the input of the diffusion model.

For the MIMIC data, we put our processed data to this link for open access and reproducing our results. Please note that the data is generated from the original MIMIC data, and if you use our processed data, do follow MIMIC's license and cite the original MIMIC source. We truncate the original ICD9 code in MIMIC following this Python code snippet:

def convert_to_3digit_icd9(dxStr):
    if dxStr.startswith('E'):
        if len(dxStr) > 4: return dxStr[:4]
        else: return dxStr
    else:
        if len(dxStr) > 3: return dxStr[:3]
        else: return dxStr

Adjust the data path and parameter setting in the corresponding config file and then start training by:

python main.py --mode train --workdir <new_directory> --config <config_file>

Adjust the checkpoint path and parameter setting and then you can do sampling by running:

python main.py --mode eval --workdir <new_directory> --config <config_file>

Note that we modify the code from the DPDM repo, with which we attempt to equip the model with the ability of differential privacy. In our preliminary experiments, we found it to be effective for the CinC dataset, while it is hard to adjust for MIMIC data which may be due to the high-dimension problem commonly concerned with differential privacy.

Citation

@article{
yuan2024ehrdiff,
title={{EHRD}iff : Exploring Realistic {EHR} Synthesis with Diffusion Models},
author={Hongyi Yuan and Songchi Zhou and Sheng Yu},
journal={Transactions on Machine Learning Research},
issn={2835-8856},
year={2024},
url={https://openreview.net/forum?id=DIGkJhGeqi},
note={}
}

Acknowledgements

Parts of our codes are modified from DPDM and edm.