Skip to content

Latest commit

 

History

History
87 lines (62 loc) · 2.77 KB

help.md

File metadata and controls

87 lines (62 loc) · 2.77 KB

=============== survivors

survivors is a Python module for survival analysis_.

It allows building survival models: Survival Tree, Bagging ensemble, Adaptive Boosting ensemble.

======================= About Survival Analysis

The objective in survival analysis_ (also referred to as time-to-event or reliability analysis) is to establish a connection between covariates and the time of an event.

Survival analysis is a set of statistical models and methods used for estimating time until the occurrence of an event (or the probability that an event has not occurred). These methods are widely used in demography, e.g. for estimating lifespan or age at the first childbirth, in healthcare, e.g. for estimating duration of staying in a hospital or survival time after the diagnosis of a disease, in engineering (for reliability analysis), in insurance, economics, and social sciences.

Statistical methods need data, but complete data may not be available, i.e. the exact time of the event may be unknown for certain reasons (the event did not occur before the end of the study or it is unknown whether it occurred). In this case, events are called censored. The data are censored from below (left censored) when below a given value the exact values of observations is unknown. Right censored data (censored from above) does not have exact observations above a given value. Further in this paper, right censoring is considered.

============ Requirements

  • Python 3.7 or later
  • joblib
  • pickle-mixin
  • numpy
  • numba
  • matplotlib
  • seaborn
  • graphviz
  • pandas >=0.25
  • scipy
  • python-dateutil
  • scikit-learn
  • lifelines
  • scikit-survival

============ Installation

The easiest way to install survivors is to use by running::

pip install survivors

======== Examples

The user guide <https://google.com>_ provides in-depth information on the key concepts of survivors, an overview of available survival models, and hands-on examples in the form of Jupyter notebooks <https://jupyter.org/>_.

========== References

Methods from survivors are based on following paper.

Vasilev I., Petrovskiy M., Mashechkin I. Survival Analysis Algorithms based on Decision Trees with Weighted Log-rank Criteria. – 2022.

.. code::

@article{vasilev2022survival, title={Survival Analysis Algorithms based on Decision Trees with Weighted Log-rank Criteria}, author={Vasilev, Iulii and Petrovskiy, Mikhail and Mashechkin, Igor}, year={2022} }

.. _survival analysis: https://en.wikipedia.org/wiki/Survival_analysis

========== Commands

Installing by setup

python setup.py install

Installing by tar.gz

python setup.py sdist pip install dist/survivors-*.tar.gz

Uninstalling

pip uninstall survivors