Metadata-Version: 2.0
Name: cameo
Version: 0.11.3
Summary: cameo - computer aided metabolic engineering & optimization
Home-page: http://cameo.bio
Author: Nikolaus Sonnenschein, Joao Cardoso, Emre Özdemir, Kristian Jensen
Author-email: niko.sonnenschein@gmail.com
License: Apache License Version 2.0
Description-Content-Type: UNKNOWN
Keywords: biology metabolism bioinformatics
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Utilities
Classifier: Programming Language :: Python :: 2.5
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: License :: OSI Approved :: Apache Software License
Requires-Dist: numpy (>=1.9.1)
Requires-Dist: scipy (>=0.14.0)
Requires-Dist: blessings (>=1.5.1)
Requires-Dist: pandas (>=0.20.2)
Requires-Dist: ordered-set (>=1.2)
Requires-Dist: cobra (>=0.8.0)
Requires-Dist: future (>=0.15.2)
Requires-Dist: optlang (>=1.2.1)
Requires-Dist: numexpr (>=2.4)
Requires-Dist: requests (>=2.10.0)
Requires-Dist: networkx (==1.9.1)
Requires-Dist: six (>=1.9.0)
Requires-Dist: escher (>=1.1.2)
Requires-Dist: IProgress (>=0.4)
Requires-Dist: inspyred (>=1.0)
Requires-Dist: lazy-object-proxy (>=1.2.0)
Requires-Dist: palettable (>=2.1.1)
Requires-Dist: gnomic (==1.0.1)
Requires-Dist: openpyxl (>=2.4.5)
Requires-Dist: click (>=6.7)
Provides-Extra: all
Requires-Dist: redis (>=2.10.5); extra == 'all'
Requires-Dist: Sphinx (>=1.3.5); extra == 'all'
Requires-Dist: python-libsbml (>=5.13.0); extra == 'all'
Requires-Dist: jupyter (>=1.0.0); extra == 'all'
Requires-Dist: bokeh (<=0.12.1); extra == 'all'
Requires-Dist: numpydoc (>=0.5); extra == 'all'
Requires-Dist: ipywidgets (>=4.1.1); extra == 'all'
Requires-Dist: plotly (>=1.9.6); extra == 'all'
Requires-Dist: pytest; extra == 'all'
Requires-Dist: pytest-benchmark; extra == 'all'
Requires-Dist: lxml (>=3.6.0); extra == 'all'
Requires-Dist: ipyparallel (>=5.0.1); extra == 'all'
Requires-Dist: pytest-cov; extra == 'all'
Provides-Extra: bokeh
Requires-Dist: bokeh (<=0.12.1); extra == 'bokeh'
Provides-Extra: docs
Requires-Dist: Sphinx (>=1.3.5); extra == 'docs'
Requires-Dist: numpydoc (>=0.5); extra == 'docs'
Provides-Extra: jupyter
Requires-Dist: jupyter (>=1.0.0); extra == 'jupyter'
Requires-Dist: ipywidgets (>=4.1.1); extra == 'jupyter'
Provides-Extra: parallel
Requires-Dist: redis (>=2.10.5); extra == 'parallel'
Requires-Dist: ipyparallel (>=5.0.1); extra == 'parallel'
Provides-Extra: plotly
Requires-Dist: plotly (>=1.9.6); extra == 'plotly'
Provides-Extra: sbml
Requires-Dist: python-libsbml (>=5.13.0); extra == 'sbml'
Requires-Dist: lxml (>=3.6.0); extra == 'sbml'
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Requires-Dist: pytest-benchmark; extra == 'test'

Cameo—Computer Aided Metabolic Engineering and Optimization
-----------------------------------------------------------

.. summary-start

|Join the chat at https://gitter.im/biosustain/cameo| |PyPI| |License|
|Build Status| |Coverage Status| |DOI|

What is cameo?
~~~~~~~~~~~~~~

**Cameo** is a high-level python library developed to aid the strain
design process in metabolic engineering projects. The library provides a
modular framework of simulation and strain design methods that targets
developers that want to develop new design algorithms and custom analysis workflows.
Furthermore, it exposes a high-level API to users that just want to
compute promising strain designs.

Curious? Head over to `try.cameo.bio <http://try.cameo.bio>`__
and give it a try.

.. summary-end

Installation
~~~~~~~~~~~~

.. installation-start

Use pip to install cameo from `PyPI <https://pypi.python.org/pypi/cameo>`__.

::

    $ pip install cameo


In case you downloaded or cloned the source code from `GitHub <https://github.com/biosustain/cameo>`__
or your own fork, you can run the following to install cameo for development.

::

    $ pip install -e <path-to-cameo-repo>  # recommended


You might need to run these commands with administrative
privileges if you're not using a virtual environment (using ``sudo`` for example).
Please check the `documentation <http://cameo.bio/installation.html>`__
for further details.

.. installation-end

Documentation and Examples
~~~~~~~~~~~~~~~~~~~~~~~~~~

Documentation is available on `cameo.bio <http://cameo.bio>`__. Numerous `Jupyter notebooks <http://nbviewer.ipython.org/github/biosustain/cameo-notebooks/tree/master/>`__
provide examples and tutorials and also form part of the documentation. They are also availabe in executable form on (`try.cameo.bio <http://try.cameo.bio>`__).
Furthermore, course materials for a two day cell factory engineering course are available `here <https://biosustain.github.io/cell-factory-design-course/>`__.

.. showcase-start

High-level API (for users)
^^^^^^^^^^^^^^^^^^^^^^^^^^

Compute strain engineering strategies for a desired product in a number
of host organisms using the high-level interface (runtime is on the order of hours).

::

    from cameo.api import design
    design(product='L-Serine')

`Output <http://nbviewer.ipython.org/github/biosustain/cameo-notebooks/blob/master/08-high-level-API.ipynb>`__


The high-level API can also be called from the command line.

::

    $ cameo design --product vanillin

For more information run

::

    $ cameo --help

Low-level API (for developers)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Find gene knockout targets using evolutionary computation.

::

    from cameo import models
    from cameo.strain_design.heuristic import GeneKnockoutOptimization
    from cameo.strain_design.heuristic.objective_functions import biomass_product_coupled_yield

    model = models.bigg.e_coli_core
    obj = biomass_product_coupled_yield(
        model.reactions.Biomass_Ecoli_core_w_GAM,
        model.reactions.EX_succ_e,
        model.reactions.EX_glc_e)
    ko = GeneKnockoutOptimization(model=model, objective_function=obj)
    ko.run(max_evaluations=50000, n=1, mutation_rate=0.15, indel_rate=0.185)

`Output <http://nbviewer.ipython.org/github/biosustain/cameo-notebooks/blob/master/05-predict-gene-knockout-strategies.ipynb>`__

Predict heterologous pathways for a desired chemical.

::

    from cameo.strain_design import pathway_prediction
    predictor = pathway_prediction.PathwayPredictor(model)
    pathways = predictor.run(product="vanillin")

`Output <http://nbviewer.ipython.org/github/biosustain/cameo-notebooks/blob/master/07-predict-heterologous-pathways.ipynb>`__

.. showcase-end


Contributions
~~~~~~~~~~~~~

..are very welcome! Please read the `guideline <CONTRIBUTING.rst>`__ for instructions how to contribute.


.. url-marker

.. |Join the chat at https://gitter.im/biosustain/cameo| image:: https://badges.gitter.im/biosustain/cameo.svg
   :target: https://gitter.im/biosustain/cameo?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
.. |PyPI| image:: https://img.shields.io/pypi/v/cameo.svg
   :target: https://pypi.python.org/pypi/cameo
.. |License| image:: http://img.shields.io/badge/license-APACHE2-blue.svg
   :target: http://img.shields.io/badge/license-APACHE2-blue.svg
.. |Build Status| image:: https://travis-ci.org/biosustain/cameo.svg?branch=master
   :target: https://travis-ci.org/biosustain/cameo
.. |Coverage Status| image:: https://coveralls.io/repos/biosustain/cameo/badge.svg?branch=devel
   :target: https://coveralls.io/r/biosustain/cameo?branch=devel
.. |DOI| image:: https://zenodo.org/badge/5031/biosustain/cameo.svg
   :target: https://zenodo.org/badge/latestdoi/5031/biosustain/cameo

