coralME


NamecoralME JSON
Version 1.1.10 PyPI version JSON
download
home_pagehttps://github.com/jdtibochab/coralme
SummaryComprehensive Reconstruction Algorithm for ME-models (coralME)
upload_time2024-12-05 00:25:25
maintainerNone
docs_urlNone
authorJuan D. Tibocha-Bonilla and Rodrigo Santibanez-Palominos
requires_python~=3.0
licenseMIT License Copyright (c) 2022 Juan D. Tibocha-Bonilla Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords metabolism biology constraint-based linear programming mixed-integer optimization flux-balance analysis reconstruction
VCS
bugtrack_url
requirements cobra python-libsbml Biopython anyconfig pyranges xlsxwriter openpyxl numpy scipy sympy pandas jsonschema tqdm
Travis-CI No Travis.
coveralls test coverage No coveralls.
            .. image:: https://github.com/jdtibochab/coralme/blob/main/docs/logo.png

.. image:: https://img.shields.io/pypi/v/coralme.svg
   :target: https://pypi.org/project/coralme/
   :alt: Current PyPI Version

.. image:: https://img.shields.io/pypi/pyversions/coralme.svg
   :target: https://pypi.org/project/coralme/
   :alt: Supported Python Versions

The **COmprehensive Reconstruction ALgorithm for ME-models (coralME)** is an automatic pipeline for the reconstruction of ME-models. coralME integrates existing ME-modeling packages `COBRAme`_, `ECOLIme`_, and `solveME`_, generalizes their functions for implementation on any prokaryote, and processes readily available organism-specific inputs for the automatic generation of a working ME-model.

coralME has four main objectives:

1. **Synchronize** input files to remove contradictory entries.
2. **Complement** input files from homology with a template organism to complete the E-matrix.
3. **Reconstruct** a ME-model.
4. **Troubleshoot** the ME-model to make it functional.

Installation
------------

Install using pip
=================
1. ``pip install coralme``

Install locally
===============
1. Clone repository and navigate to coralme/.
2. ``pip install -r requirements.txt``
3. ``python3 setup.py clean build install``

Install using docker (tested on Ubuntu 22.04)
=============================================
1. Clone repository and navigate to coralme/
2. ``docker build --file "./Dockerfile-Python3.10" . -t "python3.10-coralme"``
3. ``docker run --detach -p 10000:8888 -v USER/PATH/TO/coralme/:/opt/notebooks/ python3.10-coralme``
4. In your browser, go to ``localhost:10000``

Requirements
------------

coralME was tested with the following package versions:

- Python3, versions 3.7, 3.8, 3.9, and 3.10
- COBRApy version 0.26.3
- GUROBIpy version 9.5.2 (license is required)
- Ubuntu 22.04 is recommended (libgfortran.so.5 is required to execute MINOS and quad MINOS)
- Windows and MacOS users need to install `Gurobi`_ or `IBM CPLEX Optimizer <cplex_>`_. Alternatively, Windows users can install `WSL <wsl_>`_ and Ubuntu. Windows and MacOS users can use as well Docker Desktop to install it. We recommend the installation of Jupyter in the guest and its access through a browser from the host.

Compiled MINOS and quad MINOS are provided here as ``*.so`` files under ``coralme/solver``, and have been compiled using:

- Python3, versions 3.7.17, 3.8.17, 3.9.17, and 3.10.12
- wheel 0.38.4
- numpy 1.21.6
- scipy 1.7.3
- cython 0.29.32
- cpython 0.0.6

Compiled MINOS and quad MINOS are provided here as ``*.so`` files under ``coralme/solver``, and have been compiled using:

- Python3, versions 3.11.9 and 3.12.4
- wheel 0.43.0
- numpy 2.0.0
- cython 3.0.10

Documentation
-------------

You can find the documentation as a combined PDF called coralME_Documentation.pdf

Development
-----------

The coralME package has been tested using the most recent package versions available for each python3 version, except for numpy

========== ============ ============ ============ ============= ============= =============
Package     Python 3.7   Python 3.8   Python 3.9   Python 3.10   Python 3.11   Python 3.12 
========== ============ ============ ============ ============= ============= =============
cobra       0.28.0       0.29.0       0.29.0       0.29.0        0.29.0        0.29.0      
numpy       1.21.6       1.24.4       1.26.4       1.26.4        2.0.1         2.0.1       
scipy       1.7.3        1.10.1       1.13.1       1.14.0        1.14.0        1.14.0      
pandas      1.3.5        2.0.3        2.2.2        2.2.2         2.2.2         2.2.2       
sympy       1.10.1       1.13.1       1.13.1       1.13.1        1.13.1        1.13.1
anyconfig   0.13.0       0.14.0       0.14.0       0.14.0        0.14.0        0.14.0
========== ============ ============ ============ ============= ============= =============

.. refs
.. _COBRAme: https://github.com/SBRG/cobrame
.. _ECOLIme: https://github.com/SBRG/ecolime
.. _solveME: https://github.com/SBRG/solvemepy
.. _readthedocs: https://coralme.readthedocs.io/
.. _Gurobi: https://www.gurobi.com/
.. _cplex: https://www.ibm.com/products/ilog-cplex-optimization-studio/cplex-optimizer
.. _wsl: https://learn.microsoft.com/en-us/windows/wsl/install

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/jdtibochab/coralme",
    "name": "coralME",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "~=3.0",
    "maintainer_email": null,
    "keywords": "metabolism, biology, constraint-based, linear programming, mixed-integer, optimization, flux-balance analysis, reconstruction",
    "author": "Juan D. Tibocha-Bonilla and Rodrigo Santibanez-Palominos",
    "author_email": "\"Juan D. Tibocha-Bonilla\" <jdtibochab@users.noreply.github.com>, Rodrigo Santib\u00e1\u00f1ez-Palominos <glucksfall@users.noreply.github.com>",
    "download_url": "https://files.pythonhosted.org/packages/e3/59/3cfee49ca874953c018f0ff5b20c341763056a2af0e61b94852721b77a1b/coralme-1.1.10.tar.gz",
    "platform": null,
    "description": ".. image:: https://github.com/jdtibochab/coralme/blob/main/docs/logo.png\n\n.. image:: https://img.shields.io/pypi/v/coralme.svg\n   :target: https://pypi.org/project/coralme/\n   :alt: Current PyPI Version\n\n.. image:: https://img.shields.io/pypi/pyversions/coralme.svg\n   :target: https://pypi.org/project/coralme/\n   :alt: Supported Python Versions\n\nThe **COmprehensive Reconstruction ALgorithm for ME-models (coralME)** is an automatic pipeline for the reconstruction of ME-models. coralME integrates existing ME-modeling packages `COBRAme`_, `ECOLIme`_, and `solveME`_, generalizes their functions for implementation on any prokaryote, and processes readily available organism-specific inputs for the automatic generation of a working ME-model.\n\ncoralME has four main objectives:\n\n1. **Synchronize** input files to remove contradictory entries.\n2. **Complement** input files from homology with a template organism to complete the E-matrix.\n3. **Reconstruct** a ME-model.\n4. **Troubleshoot** the ME-model to make it functional.\n\nInstallation\n------------\n\nInstall using pip\n=================\n1. ``pip install coralme``\n\nInstall locally\n===============\n1. Clone repository and navigate to coralme/.\n2. ``pip install -r requirements.txt``\n3. ``python3 setup.py clean build install``\n\nInstall using docker (tested on Ubuntu 22.04)\n=============================================\n1. Clone repository and navigate to coralme/\n2. ``docker build --file \"./Dockerfile-Python3.10\" . -t \"python3.10-coralme\"``\n3. ``docker run --detach -p 10000:8888 -v USER/PATH/TO/coralme/:/opt/notebooks/ python3.10-coralme``\n4. In your browser, go to ``localhost:10000``\n\nRequirements\n------------\n\ncoralME was tested with the following package versions:\n\n- Python3, versions 3.7, 3.8, 3.9, and 3.10\n- COBRApy version 0.26.3\n- GUROBIpy version 9.5.2 (license is required)\n- Ubuntu 22.04 is recommended (libgfortran.so.5 is required to execute MINOS and quad MINOS)\n- Windows and MacOS users need to install `Gurobi`_ or `IBM CPLEX Optimizer <cplex_>`_. Alternatively, Windows users can install `WSL <wsl_>`_ and Ubuntu. Windows and MacOS users can use as well Docker Desktop to install it. We recommend the installation of Jupyter in the guest and its access through a browser from the host.\n\nCompiled MINOS and quad MINOS are provided here as ``*.so`` files under ``coralme/solver``, and have been compiled using:\n\n- Python3, versions 3.7.17, 3.8.17, 3.9.17, and 3.10.12\n- wheel 0.38.4\n- numpy 1.21.6\n- scipy 1.7.3\n- cython 0.29.32\n- cpython 0.0.6\n\nCompiled MINOS and quad MINOS are provided here as ``*.so`` files under ``coralme/solver``, and have been compiled using:\n\n- Python3, versions 3.11.9 and 3.12.4\n- wheel 0.43.0\n- numpy 2.0.0\n- cython 3.0.10\n\nDocumentation\n-------------\n\nYou can find the documentation as a combined PDF called coralME_Documentation.pdf\n\nDevelopment\n-----------\n\nThe coralME package has been tested using the most recent package versions available for each python3 version, except for numpy\n\n========== ============ ============ ============ ============= ============= =============\nPackage     Python 3.7   Python 3.8   Python 3.9   Python 3.10   Python 3.11   Python 3.12 \n========== ============ ============ ============ ============= ============= =============\ncobra       0.28.0       0.29.0       0.29.0       0.29.0        0.29.0        0.29.0      \nnumpy       1.21.6       1.24.4       1.26.4       1.26.4        2.0.1         2.0.1       \nscipy       1.7.3        1.10.1       1.13.1       1.14.0        1.14.0        1.14.0      \npandas      1.3.5        2.0.3        2.2.2        2.2.2         2.2.2         2.2.2       \nsympy       1.10.1       1.13.1       1.13.1       1.13.1        1.13.1        1.13.1\nanyconfig   0.13.0       0.14.0       0.14.0       0.14.0        0.14.0        0.14.0\n========== ============ ============ ============ ============= ============= =============\n\n.. refs\n.. _COBRAme: https://github.com/SBRG/cobrame\n.. _ECOLIme: https://github.com/SBRG/ecolime\n.. _solveME: https://github.com/SBRG/solvemepy\n.. _readthedocs: https://coralme.readthedocs.io/\n.. _Gurobi: https://www.gurobi.com/\n.. _cplex: https://www.ibm.com/products/ilog-cplex-optimization-studio/cplex-optimizer\n.. _wsl: https://learn.microsoft.com/en-us/windows/wsl/install\n",
    "bugtrack_url": null,
    "license": "MIT License  Copyright (c) 2022 Juan D. Tibocha-Bonilla  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
    "summary": "Comprehensive Reconstruction Algorithm for ME-models (coralME)",
    "version": "1.1.10",
    "project_urls": {
        "Bug Reports": "https://github.com/jdtibochab/coralme/issues",
        "Homepage": "https://github.com/jdtibochab/coralme",
        "Manual": "https://coralme.readthedocs.io",
        "Source": "https://github.com/jdtibochab/coralme"
    },
    "split_keywords": [
        "metabolism",
        " biology",
        " constraint-based",
        " linear programming",
        " mixed-integer",
        " optimization",
        " flux-balance analysis",
        " reconstruction"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "39e0de4a154927536c3cee3b8582f2a06df5624d7376e58753fa54f9783aa861",
                "md5": "367686922568be4f50a0d5ba3738f699",
                "sha256": "145a7fd98828b5ea578b5f5b7ce56411271197e0efd9d1cd248a94ac1a50bf84"
            },
            "downloads": -1,
            "filename": "coralME-1.1.10-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "367686922568be4f50a0d5ba3738f699",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "~=3.0",
            "size": 9540142,
            "upload_time": "2024-12-05T00:25:22",
            "upload_time_iso_8601": "2024-12-05T00:25:22.974442Z",
            "url": "https://files.pythonhosted.org/packages/39/e0/de4a154927536c3cee3b8582f2a06df5624d7376e58753fa54f9783aa861/coralME-1.1.10-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e3593cfee49ca874953c018f0ff5b20c341763056a2af0e61b94852721b77a1b",
                "md5": "0ff866f7aa1be3ffb7ea9103ec54899b",
                "sha256": "d2917e5fcd0604698b1dd1a47834726fd8a4206a4a52b7cd0ff072f74cad435b"
            },
            "downloads": -1,
            "filename": "coralme-1.1.10.tar.gz",
            "has_sig": false,
            "md5_digest": "0ff866f7aa1be3ffb7ea9103ec54899b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "~=3.0",
            "size": 9350412,
            "upload_time": "2024-12-05T00:25:25",
            "upload_time_iso_8601": "2024-12-05T00:25:25.752977Z",
            "url": "https://files.pythonhosted.org/packages/e3/59/3cfee49ca874953c018f0ff5b20c341763056a2af0e61b94852721b77a1b/coralme-1.1.10.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-12-05 00:25:25",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "jdtibochab",
    "github_project": "coralme",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "cobra",
            "specs": [
                [
                    "==",
                    "0.26.3"
                ]
            ]
        },
        {
            "name": "python-libsbml",
            "specs": []
        },
        {
            "name": "Biopython",
            "specs": [
                [
                    "==",
                    "1.80"
                ]
            ]
        },
        {
            "name": "anyconfig",
            "specs": []
        },
        {
            "name": "pyranges",
            "specs": []
        },
        {
            "name": "xlsxwriter",
            "specs": []
        },
        {
            "name": "openpyxl",
            "specs": []
        },
        {
            "name": "numpy",
            "specs": [
                [
                    "==",
                    "1.23.5"
                ]
            ]
        },
        {
            "name": "scipy",
            "specs": [
                [
                    "==",
                    "1.11.0"
                ]
            ]
        },
        {
            "name": "sympy",
            "specs": []
        },
        {
            "name": "pandas",
            "specs": [
                [
                    "==",
                    "1.5.1"
                ]
            ]
        },
        {
            "name": "jsonschema",
            "specs": []
        },
        {
            "name": "tqdm",
            "specs": []
        }
    ],
    "lcname": "coralme"
}
        
Elapsed time: 5.87775s