--- a +++ b/docs/_build/html/index.html @@ -0,0 +1,314 @@ + + +<!DOCTYPE html> +<html class="writer-html5" lang="en" > +<head> + <meta charset="utf-8" /> + + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + + <title>Welcome to DeepProg’s documentation! — DeepProg documentation</title> + + + + <link rel="stylesheet" href="_static/css/theme.css" type="text/css" /> + <link rel="stylesheet" href="_static/pygments.css" type="text/css" /> + + + + + + + + + + + <!--[if lt IE 9]> + <script src="_static/js/html5shiv.min.js"></script> + <![endif]--> + + + <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script> + <script src="_static/jquery.js"></script> + <script src="_static/underscore.js"></script> + <script src="_static/doctools.js"></script> + <script src="_static/language_data.js"></script> + + <script type="text/javascript" src="_static/js/theme.js"></script> + + + <link rel="index" title="Index" href="genindex.html" /> + <link rel="search" title="Search" href="search.html" /> + <link rel="next" title="Installation" href="installation.html" /> +</head> + +<body class="wy-body-for-nav"> + + + <div class="wy-grid-for-nav"> + + <nav data-toggle="wy-nav-shift" class="wy-nav-side"> + <div class="wy-side-scroll"> + <div class="wy-side-nav-search" > + + + + <a href="#" class="icon icon-home"> DeepProg + + + + </a> + + + + + + + +<div role="search"> + <form id="rtd-search-form" class="wy-form" action="search.html" method="get"> + <input type="text" name="q" placeholder="Search docs" /> + <input type="hidden" name="check_keywords" value="yes" /> + <input type="hidden" name="area" value="default" /> + </form> +</div> + + + </div> + + + <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation"> + + + + + + + <ul> +<li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li> +<li class="toctree-l1"><a class="reference internal" href="usage.html">Tutorial: Simple DeepProg model</a></li> +<li class="toctree-l1"><a class="reference internal" href="usage_ensemble.html">Tutorial: Ensemble of DeepProg model</a></li> +<li class="toctree-l1"><a class="reference internal" href="usage_advanced.html">Tutorial: Advanced usage of DeepProg model</a></li> +<li class="toctree-l1"><a class="reference internal" href="case_study.html">Case study: Analyzing TCGA HCC dataset</a></li> +<li class="toctree-l1"><a class="reference internal" href="usage_tuning.html">Tutorial: Tuning DeepProg</a></li> +<li class="toctree-l1"><a class="reference internal" href="LICENSE.html">License</a></li> +<li class="toctree-l1"><a class="reference internal" href="api/simdeep.html">simdeep package</a></li> +</ul> + + + + </div> + + </div> + </nav> + + <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"> + + + <nav class="wy-nav-top" aria-label="top navigation"> + + <i data-toggle="wy-nav-top" class="fa fa-bars"></i> + <a href="#">DeepProg</a> + + </nav> + + + <div class="wy-nav-content"> + + <div class="rst-content"> + + + + + + + + + + + + + + + + + + + +<div role="navigation" aria-label="breadcrumbs navigation"> + + <ul class="wy-breadcrumbs"> + + <li><a href="#" class="icon icon-home"></a> »</li> + + <li>Welcome to DeepProg’s documentation!</li> + + + <li class="wy-breadcrumbs-aside"> + + + <a href="_sources/index.rst.txt" rel="nofollow"> View page source</a> + + + </li> + + </ul> + + + <hr/> +</div> + <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article"> + <div itemprop="articleBody"> + + <div class="section" id="welcome-to-deepprog-s-documentation"> +<h1>Welcome to DeepProg’s documentation!<a class="headerlink" href="#welcome-to-deepprog-s-documentation" title="Permalink to this headline">¶</a></h1> +<div class="toctree-wrapper compound"> +<ul> +<li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a><ul> +<li class="toctree-l2"><a class="reference internal" href="installation.html#requirements">Requirements</a></li> +<li class="toctree-l2"><a class="reference internal" href="installation.html#tested-python-package-versions">Tested python package versions</a></li> +<li class="toctree-l2"><a class="reference internal" href="installation.html#deep-learning-packages-installation">Deep-Learning packages installation</a></li> +<li class="toctree-l2"><a class="reference internal" href="installation.html#support-for-cntk-tensorflow">Support for CNTK / tensorflow</a></li> +<li class="toctree-l2"><a class="reference internal" href="installation.html#distributed-computation">Distributed computation</a></li> +<li class="toctree-l2"><a class="reference internal" href="installation.html#visualisation-module-experimental">Visualisation module (Experimental)</a></li> +<li class="toctree-l2"><a class="reference internal" href="installation.html#usage">Usage</a></li> +<li class="toctree-l2"><a class="reference internal" href="installation.html#example-scripts">Example scripts</a></li> +</ul> +</li> +<li class="toctree-l1"><a class="reference internal" href="usage.html">Tutorial: Simple DeepProg model</a><ul> +<li class="toctree-l2"><a class="reference internal" href="usage.html#input-parameters">Input parameters</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage.html#input-matrices">Input matrices</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage.html#creating-a-simple-deepprog-model-with-one-autoencoder-for-each-omic">Creating a simple DeepProg model with one autoencoder for each omic</a></li> +</ul> +</li> +<li class="toctree-l1"><a class="reference internal" href="usage_ensemble.html">Tutorial: Ensemble of DeepProg model</a><ul> +<li class="toctree-l2"><a class="reference internal" href="usage_ensemble.html#instanciation">Instanciation</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage_ensemble.html#fitting">Fitting</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage_ensemble.html#evaluate-the-models">Evaluate the models</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage_ensemble.html#predicting-on-test-dataset">Predicting on test dataset</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage_ensemble.html#distributed-computation">Distributed computation</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage_ensemble.html#more-examples">More examples</a></li> +</ul> +</li> +<li class="toctree-l1"><a class="reference internal" href="usage_advanced.html">Tutorial: Advanced usage of DeepProg model</a><ul> +<li class="toctree-l2"><a class="reference internal" href="usage_advanced.html#visualisation">Visualisation</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage_advanced.html#hyperparameters">Hyperparameters</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage_advanced.html#usage-of-metadata-associated-with-patients">Usage of metadata associated with patients</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage_advanced.html#computing-cluster-specific-feature-signatures">Computing cluster-specific feature signatures</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage_advanced.html#save-load-models">Save / load models</a></li> +</ul> +</li> +<li class="toctree-l1"><a class="reference internal" href="case_study.html">Case study: Analyzing TCGA HCC dataset</a><ul> +<li class="toctree-l2"><a class="reference internal" href="case_study.html#dataset-preparation">Dataset preparation</a></li> +<li class="toctree-l2"><a class="reference internal" href="case_study.html#model-fitting">Model fitting</a></li> +<li class="toctree-l2"><a class="reference internal" href="case_study.html#visualisation-and-analysis">Visualisation and analysis</a></li> +</ul> +</li> +<li class="toctree-l1"><a class="reference internal" href="usage_tuning.html">Tutorial: Tuning DeepProg</a><ul> +<li class="toctree-l2"><a class="reference internal" href="usage_tuning.html#a-first-example">A first example</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage_tuning.html#tuning-using-one-or-multiple-test-datasets">Tuning using one or multiple test datasets</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage_tuning.html#results">Results</a></li> +<li class="toctree-l2"><a class="reference internal" href="usage_tuning.html#recommendation">Recommendation</a></li> +</ul> +</li> +<li class="toctree-l1"><a class="reference internal" href="LICENSE.html">License</a></li> +<li class="toctree-l1"><a class="reference internal" href="api/simdeep.html">simdeep package</a><ul> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#submodules">Submodules</a></li> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#module-simdeep.config">simdeep.config module</a></li> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#module-simdeep.coxph_from_r">simdeep.coxph_from_r module</a></li> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#module-simdeep.deepmodel_base">simdeep.deepmodel_base module</a></li> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#module-simdeep.extract_data">simdeep.extract_data module</a></li> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#module-simdeep.plot_utils">simdeep.plot_utils module</a></li> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#module-simdeep.simdeep_analysis">simdeep.simdeep_analysis module</a></li> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#module-simdeep.simdeep_boosting">simdeep.simdeep_boosting module</a></li> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#module-simdeep.simdeep_distributed">simdeep.simdeep_distributed module</a></li> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#module-simdeep.simdeep_multiple_dataset">simdeep.simdeep_multiple_dataset module</a></li> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#module-simdeep.simdeep_utils">simdeep.simdeep_utils module</a></li> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#module-simdeep.survival_utils">simdeep.survival_utils module</a></li> +<li class="toctree-l2"><a class="reference internal" href="api/simdeep.html#module-simdeep">Module contents</a></li> +</ul> +</li> +</ul> +</div> +<div class="section" id="introduction"> +<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2> +<p>This package allows to combine multi-omics data for individual samples together with survival. Using autoencoders (default) or any alternative embedding methods, the pipeline creates new set of features and identifies those linked with survival. In a second time, the samples are clustered with different possible strategies to obtain robust subtypes linked to survival. The robustness of the obtained subtypes can then be tested externally on one or multiple validation datasets and/or the <em>out-of-bags</em> samples. The omic data used in the original study are RNA-Seq, MiR and Methylation. However, this approach can be extended to any combination of omic data. The current package contains the omic data used in the study and a copy of the model computed. However, it is easy to recreate a new model from scratch using any combination of omic data. +The omic data and the survival files should be in tsv (Tabular Separated Values) format and examples are provided. The deep-learning framework to produce the autoencoders uses Keras with either Theano / tensorflow/ CNTK as background.</p> +<img alt="_images/workflow.png" src="_images/workflow.png" /> +</div> +<div class="section" id="access"> +<h2>Access<a class="headerlink" href="#access" title="Permalink to this headline">¶</a></h2> +<p>The package is accessible at this link: <a class="reference external" href="https://github.com/lanagarmire/DeepProg">https://github.com/lanagarmire/DeepProg</a>.</p> +</div> +<div class="section" id="contribute"> +<h2>Contribute<a class="headerlink" href="#contribute" title="Permalink to this headline">¶</a></h2> +<ul class="simple"> +<li><p>Issue Tracker: github.com/lanagarmire/DeepProg/issues</p></li> +<li><p>Source Code: github.com/lanagarmire/DeepProg</p></li> +</ul> +</div> +<div class="section" id="support"> +<h2>Support<a class="headerlink" href="#support" title="Permalink to this headline">¶</a></h2> +<p>If you are having issues, please let us know. +You can reach us using the following email address:</p> +<p>Olivier Poirion, Ph.D. +<a class="reference external" href="mailto:o.poirion%40gmail.com">o<span>.</span>poirion<span>@</span>gmail<span>.</span>com</a></p> +</div> +<div class="section" id="citation"> +<h2>Citation<a class="headerlink" href="#citation" title="Permalink to this headline">¶</a></h2> +<p>This package refers to our preprint paper: [Multi-omics-based pan-cancer prognosis prediction using an ensemble of deep-learning and machine-learning models](<a class="reference external" href="https://www.medrxiv.org/content/10.1101/19010082v1">https://www.medrxiv.org/content/10.1101/19010082v1</a>)</p> +</div> +<div class="section" id="license"> +<h2>License<a class="headerlink" href="#license" title="Permalink to this headline">¶</a></h2> +<p>The project is licensed under the MIT license.</p> +</div> +</div> + + + </div> + + </div> + <footer> + <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation"> + <a href="installation.html" class="btn btn-neutral float-right" title="Installation" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a> + </div> + + <hr/> + + <div role="contentinfo"> + <p> + © Copyright 2019, Olivier Poirion. + + </p> + </div> + + + + Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a + + <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a> + + provided by <a href="https://readthedocs.org">Read the Docs</a>. + +</footer> + </div> + </div> + + </section> + + </div> + + + <script type="text/javascript"> + jQuery(function () { + SphinxRtdTheme.Navigation.enable(true); + }); + </script> + + + + + + +</body> +</html> \ No newline at end of file