Metadata-Version: 1.1
Name: scikit-survival
Version: 0.2
Summary: Survival analysis built on top of scikit-learn
Home-page: https://github.com/sebp/scikit-survival
Author: Sebastian Pölsterl
Author-email: sebp@k-d-w.org
License: GPLv3+
Description: ***************
        scikit-survival
        ***************
        
        .. image:: https://img.shields.io/badge/license-GPLv3-blue.svg
          :target: COPYING
          :alt: License
        
        .. image:: https://travis-ci.org/sebp/scikit-survival.svg
          :target: https://travis-ci.org/sebp/scikit-survival
          :alt: Build Status
        
        .. image:: https://codecov.io/gh/sebp/scikit-survival/branch/master/graph/badge.svg
          :target: https://codecov.io/gh/sebp/scikit-survival
          :alt: codecov
        
        .. image:: https://api.codacy.com/project/badge/Grade/17242004cdf6422c9a1052bf1ec63104
           :target: https://www.codacy.com/app/sebp/scikit-survival?utm_source=github.com&utm_medium=referral&utm_content=sebp/scikit-survival&utm_campaign=badger
           :alt: Codacy Badge
        
        .. image:: https://readthedocs.org/projects/scikit-survival/badge/?version=latest
          :target: https://scikit-survival.readthedocs.io/en/latest/
          :alt: readthedocs.org
        
        scikit-survival is a Python module for `survival analysis`_
        built on top of `scikit-learn <http://scikit-learn.org/>`_. It allows doing survival analysis
        while utilizing the power of scikit-learn, e.g., for pre-processing or doing cross-validation.
        
        =======================
        About Survival Analysis
        =======================
        
        The objective in `survival analysis`_ (also referred to as reliability analysis in engineering)
        is to establish a connection between covariates and the time of an event.
        What makes survival analysis differ from traditional machine learning is the fact that
        parts of the training data can only be partially observed – they are *censored*.
        
        For instance, in a clinical study, patients are often monitored for a particular time period,
        and events occurring in this particular period are recorded.
        If a patient experiences an event, the exact time of the event can
        be recorded – the patient’s record is uncensored. In contrast, right censored records
        refer to patients that remained event-free during the study period and
        it is unknown whether an event has or has not occurred after the study ended.
        Consequently, survival analysis demands for models that take
        this unique characteristic of such a dataset into account.
        
        ============
        Requirements
        ============
        
        - Python 3.4 or later
        - cvxpy
        - cvxopt
        - numexpr
        - numpy 1.10 or later
        - pandas 0.18 or later
        - scikit-learn 0.18
        - scipy 0.17 or later
        - C/C++ compiler
        
        ============
        Installation
        ============
        
        The easiest way to get started is to install `Anaconda <https://store.continuum.io/cshop/anaconda/>`_
        and setup an environment::
        
          conda install -c sebp scikit-survival
        
        ----------------------
        Installing from source
        ----------------------
        
        First, create a new environment, named ``sksurv``::
        
          conda create -n sksurv python=3 --file requirements.txt
        
        
        To work in this environment, ``activate`` it as follows::
        
          source activate sksurv
        
        If you are on Windows, run the above command without the ``source`` in the beginning.
        
        Once you setup your build environment, you have to compile the C/C++
        extensions and install the package by running::
        
          python setup.py install
        
        Alternatively, if you want to use the package without installing it,
        you can compile the extensions in place by running::
        
          python setup.py build_ext --inplace
        
        To check everything is setup correctly run the test suite by executing::
        
          nosetests
        
        ========
        Examples
        ========
        
        A `simple example <https://nbviewer.jupyter.org/github/sebp/scikit-survival/blob/master/examples/survival-svm.ipynb>`_
        on how to use Survival Support Vector Machines is described in an `Jupyter notebook <https://jupyter.org/>`_.
        
        =============
        Documentation
        =============
        
        The source code is thoroughly documented and a HTML version of the API documentation
        is available at https://scikit-survival.readthedocs.io/en/latest/.
        
        You can generate the documentation yourself using `Sphinx <http://sphinx-doc.org/>`_ 1.4 or later::
        
          cd doc
          make html
          xdg-open _build/html/index.html
        
        ==========
        References
        ==========
        
        Please cite the following papers if you are using **scikit-survival**.
        
        1. Pölsterl, S., Navab, N., and Katouzian, A.,
        `Fast Training of Support Vector Machines for Survival Analysis <http://link.springer.com/chapter/10.1007/978-3-319-23525-7_15>`_.
        Machine Learning and Knowledge Discovery in Databases: European Conference,
        ECML PKDD 2015, Porto, Portugal,
        Lecture Notes in Computer Science, vol. 9285, pp. 243-259 (2015)
        
        2. Pölsterl, S., Navab, N., and Katouzian, A.,
        `An Efficient Training Algorithm for Kernel Survival Support Vector Machines <https://arxiv.org/abs/1611.07054>`_.
        4th Workshop on Machine Learning in Life Sciences,
        23 September 2016, Riva del Garda, Italy
        
        3. Pölsterl, S., Gupta, P., Wang, L., Conjeti, S., Katouzian, A., and Navab, N.,
        `Heterogeneous ensembles for predicting survival of metastatic, castrate-resistant prostate cancer patients <http://doi.org/10.12688/f1000research.8231.1>`_.
        F1000Research, vol. 5, no. 2676 (2016).
        
        .. _survival analysis: https://en.wikipedia.org/wiki/Survival_analysis
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: C
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development
Classifier: Topic :: Scientific/Engineering
