gen_surv 0.7.2

A Python package for simulating survival data, inspired by the R package genSurv

gen_surv

gen_surv is a Python package for simulating survival data under a variety of models, inspired by the R package genSurv. It supports data generation for:

• Cox Proportional Hazards Models (CPHM)
• Continuous-Time Markov Models (CMM)
• Time-Dependent Covariate Models (TDCM)
• Time-Homogeneous Hidden Markov Models (THMM)

---

📦 Installation

poetry install

✨ Features

• Consistent interface across models
• Censoring support (uniform or exponential)
• Easy integration with pandas and NumPy
• Suitable for benchmarking survival algorithms and teaching

🧪 Example

from gen_surv import generate

# CPHM
generate(model="cphm", n=100, model_cens="uniform", cens_par=1.0, beta=0.5, covar=2.0)

# AFT Log-Normal
generate(model="aft_ln", n=100, beta=[0.5, -0.3], sigma=1.0, model_cens="exponential", cens_par=3.0)

# CMM
generate(model="cmm", n=100, model_cens="exponential", cens_par=2.0,
         qmat=[[0, 0.1], [0.05, 0]], p0=[1.0, 0.0])

# TDCM
generate(model="tdcm", n=100, dist="weibull", corr=0.5,
         dist_par=[1, 2, 1, 2], model_cens="uniform", cens_par=1.0,
         beta=[0.1, 0.2, 0.3], lam=1.0)

# THMM
generate(model="thmm", n=100, qmat=[[0, 0.2, 0], [0.1, 0, 0.1], [0, 0.3, 0]],
         emission_pars={"mu": [0.0, 1.0, 2.0], "sigma": [0.5, 0.5, 0.5]},
         p0=[1.0, 0.0, 0.0], model_cens="exponential", cens_par=3.0)

🔧 Available Generators

Function	Description
gen_cphm()	Cox Proportional Hazards Model
gen_cmm()	Continuous-Time Multi-State Markov Model
gen_tdcm()	Time-Dependent Covariate Model
gen_thmm()	Time-Homogeneous Markov Model

genSurvPy/
├── gen_surv/             # Pacote principal
│   ├── __main__.py       # Interface CLI via python -m
│   ├── cphm.py
│   ├── cmm.py
│   ├── tdcm.py
│   ├── thmm.py
│   ├── censoring.py
│   ├── bivariate.py
│   ├── validate.py
│
├── tests/                # Testes automatizados
│   ├── test_cphm.py
│   ├── test_cmm.py
│   ├── test_tdcm.py
│   ├── test_thmm.py
│
├── examples/             # Exemplos de uso
│   ├── run_cphm.py
│   ├── ...
│
├── pyproject.toml        # Configurado com Poetry
├── README.md
├── LICENSE
├── .gitignore

🧠 License

MIT License. See LICENSE for details.