{
    "info": {
        "author": "Anna Zhukova",
        "author_email": "zhutchok@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 4 - Beta",
            "Environment :: Console",
            "Intended Audience :: Developers",
            "Topic :: Scientific/Engineering :: Bio-Informatics",
            "Topic :: Software Development :: Libraries :: Python Modules"
        ],
        "description": "# mod_gen: Knowledge-based generalization for metabolic models\n\n**Model Generalization** is a Python library that compresses a metabolic network model\nusing the knowledge-based model generalization method.\n\n**Model generalization** takes a model in [SBML format](http://sbml.org/) as input, and produces 2 SBML files as an output:\n* SBML containing the generalized model\n* SBML file with [groups extension](http://sbml.org/Documents/Specifications/SBML_Level_3/Packages/groups)\ncontaining the initial model plus the groups representing similar metabolites and similar reactions.\n\n## Article\n\nZhukova A, Sherman DJ. **Knowledge-based generalization of metabolic models.**\n*J Comput Biol.* 2014 Jul; **21**(7):534-47 [doi:10.1089/cmb.2013.0143](http://identifiers.org/doi/10.1089/cmb.2013.0143)\n\n\n## Model Generalization Method\n\nThe **model generalization method** groups similar metabolites and reactions in the network\nbased on its structure and the knowledge, extracted from [the ChEBI ontology](http://www.ebi.ac.uk/chebi/).\nThe reactions between the same generalized species are factored together into generalized reactions.\nA generalization is made specifically for a given model and is maximal with respect to the relations in the model;\nit respects semantic constraints such as reaction stoichiometry, connectivity, and transport between compartments;\nand it is performed through a heuristic method that is efficient in practice for genome-scale models.\n\nEach metabolite can be generalized up to one of its ancestors in ChEBI. If a ChEBI annotation for a metabolite\nis not present in the model, the method attempts to automatically deduce it by comparing metabolite\u2019s name\nto ChEBI terms\u2019 names and synonyms. Reactions that share the same generalized reactants and\nthe same generalized products, are considered equivalent and are factored together into a generalized reaction.\n\nThe appropriate level of abstraction for metabolites and reactions is defined by the network itself as\nthe most general one that satisfies two restrictions:\n\n1. *Stoichiometry preserving restriction:* metabolites that participate in the same reaction cannot be grouped together;\n\n2. *Metabolite diversity restriction:* metabolites that do not participate in any pair of similar reactions are not\n  grouped together (as there is no evidence of their similarity in the network).\n\nOverall, the generalization method is composed of three modules:\n\n1. Aggressive reaction grouping based on the most general metabolite grouping (defined by ChEBI),\nin order to generate reaction grouping candidates;\n\n2. Ungrouping of some metabolites and reactions to correct for violation of the stoichiometry preserving restriction;\n\n3. Ungrouping of some metabolites (while keeping the reaction grouping intact) to correct for violation of\nthe metabolite diversity restriction.\n\nFor instance, *(S)-3-hydroxydecanoyl-CoA*, *(S)-3-hydroxylauroyl-CoA* and *(S)-3-hydroxytetradecanoyl-CoA*\nhave a common ancestor *hydroxy fatty acyl-CoA* in ChEBI. They can be grouped and generalized into *hydroxy fatty acyl-CoA*,\nif in the network there is no reaction whose stoichiometry would be changed by such a generalization\n(stoichiometry preserving restriction), and exist similar reactions that consume or produce them\n(metabolite diversity restriction).\n\n\n## Installation\n\nFrom the directory where you have extracted this archive, execute:\n```bash\npython setup.py\n```\n\n## Running Model Generalization\n\nExecute:\n\n```bash\npython3 ./sbml_generalization/runner/main.py --model path_to_your_model.xml --verbose\n```\n\nThe script will produce two SBML files, containing the generalized model:\n\n* path_to_your_model_generalized.xml -- SBML containing the generalized model\n* path_to_your_model_with_groups.xml -- SBML file with groups extension containing the initial model\n  plus the groups representing similar metabolites and similar reactions.",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "https://github.com/annazhukova/mod_gen/archive/0.1.1.zip",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/annazhukova/mod_gen",
        "keywords": null,
        "license": "UNKNOWN",
        "maintainer": null,
        "maintainer_email": null,
        "name": "sbml_generalization",
        "package_url": "https://pypi.org/project/sbml_generalization/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/sbml_generalization/",
        "project_urls": {
            "Download": "https://github.com/annazhukova/mod_gen/archive/0.1.1.zip",
            "Homepage": "https://github.com/annazhukova/mod_gen"
        },
        "release_url": "https://pypi.org/project/sbml_generalization/0.1.1/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "Knowledge-based generalization for metabolic models in SBML format.",
        "version": "0.1.1"
    },
    "last_serial": 2743154,
    "releases": {
        "0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "0c9f1aa5eea9d374d559ffd4ade5159f",
                    "sha256": "831c763f9e00ad3923e86cea384e71bc2427de12f317a030905ce6f177d27888"
                },
                "downloads": -1,
                "filename": "sbml_generalization-0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "0c9f1aa5eea9d374d559ffd4ade5159f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 16786,
                "upload_time": "2017-03-30T16:07:24",
                "url": "https://files.pythonhosted.org/packages/3d/7a/8eb77ee8a1fba17cf42392801deb3278fab2043cd76b5f0ea9913a6c2b12/sbml_generalization-0.1.tar.gz"
            }
        ],
        "0.1.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "f3e51672c0a708ee406421f05353fb0a",
                    "sha256": "6803b27ed41449e885adb76d6d87d36f519f01fc27a17a145e45d9e1fe3d2804"
                },
                "downloads": -1,
                "filename": "sbml_generalization-0.1.1.tar.gz",
                "has_sig": false,
                "md5_digest": "f3e51672c0a708ee406421f05353fb0a",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 17033,
                "upload_time": "2017-03-31T08:57:54",
                "url": "https://files.pythonhosted.org/packages/b8/56/469ff98c198c1dc714d487667a40093d5fb988892fd21717054c354fa8f9/sbml_generalization-0.1.1.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "f3e51672c0a708ee406421f05353fb0a",
                "sha256": "6803b27ed41449e885adb76d6d87d36f519f01fc27a17a145e45d9e1fe3d2804"
            },
            "downloads": -1,
            "filename": "sbml_generalization-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "f3e51672c0a708ee406421f05353fb0a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 17033,
            "upload_time": "2017-03-31T08:57:54",
            "url": "https://files.pythonhosted.org/packages/b8/56/469ff98c198c1dc714d487667a40093d5fb988892fd21717054c354fa8f9/sbml_generalization-0.1.1.tar.gz"
        }
    ]
}