Skip to content

Commit 1990109

Browse files
committed
docs: add roadmap for advanced survival models and extend TODO
1 parent 978a79a commit 1990109

File tree

2 files changed

+45
-1
lines changed

2 files changed

+45
-1
lines changed

TODO.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,4 +60,17 @@ This document outlines future enhancements, features, and ideas for improving th
6060

6161
- [ ] Add performance benchmarks for each model
6262
- [ ] Improve PyPI discoverability (add keywords)
63-
- [ ] Create a Streamlit or Gradio live demo
63+
- [ ] Create a Streamlit or Gradio live demo
64+
65+
---
66+
67+
## 🧠 8. New Survival Models to Implement
68+
69+
- [ ] Accelerated Failure Time (AFT) models:
70+
- [ ] Log-Normal AFT
71+
- [ ] Log-Logistic AFT
72+
- [ ] Weibull AFT formulation
73+
- [ ] Piecewise Exponential Model
74+
- [ ] Competing Risks simulation
75+
- [ ] Recurrent Events simulation
76+
- [ ] Mixture Cure Model

docs/source/theory.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,37 @@ $$
8181

8282
---
8383

84+
85+
## 5. Accelerated Failure Time (AFT) Models
86+
87+
AFT models assume that the effect of covariates accelerates or decelerates time to event directly, rather than the hazard.
88+
89+
### Log-Normal AFT
90+
91+
The model assumes:
92+
93+
$$
94+
\log(T_i) = X_i \beta + \varepsilon_i, \quad \varepsilon_i \sim \mathcal{N}(0, \sigma^2)
95+
$$
96+
97+
Thus:
98+
99+
$$
100+
T_i \sim \text{Log-Normal}(X_i \beta, \sigma^2)
101+
$$
102+
103+
The survival function is:
104+
105+
$$
106+
S(t \mid X) = 1 - \Phi\left(\frac{\log(t) - X \beta}{\sigma}\right)
107+
$$
108+
109+
Where:
110+
111+
- \( \Phi \) is the standard normal cumulative distribution function (CDF)
112+
113+
This model is especially useful when the proportional hazards assumption is not valid and provides interpretable effects in the time domain.
114+
84115
## Notes
85116

86117
All models support censoring:

0 commit comments

Comments
 (0)