{"id":19197266,"url":"https://github.com/lolab-msm/biocomparator","last_synced_at":"2026-06-23T16:30:19.475Z","repository":{"id":138781005,"uuid":"201081578","full_name":"LoLab-MSM/BioComparator","owner":"LoLab-MSM","description":"software toolset to compare biological-models","archived":false,"fork":false,"pushed_at":"2020-01-01T17:55:34.000Z","size":64,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-01-04T10:14:21.273Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LoLab-MSM.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-08-07T15:52:52.000Z","updated_at":"2021-06-28T18:45:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"949322ef-71e2-42fd-bfd4-586074de8c0f","html_url":"https://github.com/LoLab-MSM/BioComparator","commit_stats":null,"previous_names":["lolab-vu/biocomparator"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoLab-MSM%2FBioComparator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoLab-MSM%2FBioComparator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoLab-MSM%2FBioComparator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LoLab-MSM%2FBioComparator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LoLab-MSM","download_url":"https://codeload.github.com/LoLab-MSM/BioComparator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240271530,"owners_count":19774859,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T12:16:11.449Z","updated_at":"2026-06-23T16:30:19.413Z","avatar_url":"https://github.com/LoLab-MSM.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BioComparator\nRapidly compare biological models written in PySB using particle swarm optimization-based model fitting and model selection metrics.\n\n![Python version badge](https://img.shields.io/badge/python-3.6-blue.svg)\n[![license](https://img.shields.io/github/license/LoLab-VU/BioComparator.svg)](LICENSE)\n![version](https://img.shields.io/badge/version-0.2.0-orange.svg)\n[![release](https://img.shields.io/github/release-pre/LoLab-VU/BioComparator.svg)](https://github.com/LoLab-VU/BioComparator/releases/tag/v0.2.0)\n\n\n**BioComparator** is a Python software tool designed to compare biological models encoded using the [PySB](http://pysb.org/) modeling framework. Candidate models may for example encode different mechanistic hypotheses or represent different granularities of a biological mechanism. Principally, the tool employs parameter estimation to the set of candidate models with respect to a common data-set (or set of data-sets) via a common cost function. **BioComparator** then provides users with a set of comparative metrics such as the minimum cost and Akaike Information Criterion, allowing users to easily evaluate candidate models' fit to the data and the trade offs between the fit to data and model size/complexity.\n\nCurrently, **BioComparator** uses particle swarm optimization-based parameter estimation, via the [simplePSO](https://github.com/LoLab-VU/ParticleSwarmOptimization) package, to minimize a cost function and fit models to a given data-set. In the future, interfaces may be added for other model calibration/parameter estimation tools, such as [Gleipnir](https://github.com/LoLab-VU/Gleipnir) (Bayesian parameter estimation and model evidence via Nested Sampling).\n\n------\n\n# Install\n\n**BioComparator** installs as the `biocomparator` package. It is compatible (i.e., tested) with Python 3.6.\n\nNote that `biocomparator` has the following core dependencies:\n   * [NumPy](http://www.numpy.org/)\n   * [pandas](https://pandas.pydata.org/)\n   * [PySB](http://pysb.org/)\n   * [simplePSO](https://github.com/LoLab-VU/ParticleSwarmOptimization)\n   * [swarm_it](https://github.com/LoLab-VU/swarm_it)\n\n### pip install\nYou can install the latest (possibly unreleased) version of the `biocomparator` package using `pip` sourced from the GitHub repo:\n```\npip install -e git+https://github.com/LoLab-VU/BioComparator/#egg=biocomparator\n```\nHowever, this will not automatically install the core dependencies. You will have to do that separately.\n\nYou can also install the latest release (currently v0.2.0) version of the `biocomparator` package using `pip` sourced from the GitHub repo with an additional release tag:\n```\npip install -e git+https://github.com/LoLab-VU/BioComparator/#egg=biocomparator@v0.2.0\n```\nYou may check the [BioComparator releases page](https://github.com/LoLab-VU/Gleipnir/releases/) to find all available releases.\n\n------\n\n# License\n\nThis project is licensed under the GPL-3.0 License - see the [LICENSE](LICENSE) file for details\n\n------\n\n# Documentation and Usage\n\n### Quick Overview\nPrincipally, **BioComparator** defines the **BioComparator** class,\n```python\nfrom biocomparator import BioComparator\n```\nwhich defines an object that can be used setup and run Particle Swarm Optimization (PSO)-based parameter estimation and subsequent Akaike Information Criterion (AIC)-based model selection of PySB models.\n\n\n### Examples\nAdditional example scripts that show how to setup and launch comparison runs using **BioComparator** can be found under [examples](./examples).\n\n------\n\n# Contact\n\nTo report problems or bugs please open a\n[GitHub Issue](https://github.com/LoLab-VU/BioComparator/issues). Additionally, any comments, suggestions, or feature requests for **BioComparator** can also be submitted as a [GitHub Issue](https://github.com/LoLab-VU/BioComparator/issues).\n\n------\n\n# Citing\n\nIf you use the **BioComparator** software in your research, please cite the GitHub repo.\n\nAlso, please cite the following references as appropriate for software used with/via **BioComparator**:\n\n#### Packages from the SciPy ecosystem\n\nThese include NumPy and pandas for which references can be obtained from:\nhttps://www.scipy.org/citing.html\n\n#### PySB\n  1. Lopez, C. F., Muhlich, J. L., Bachman, J. A. \u0026 Sorger, P. K. Programming biological models in Python using PySB. Mol Syst Biol 9, (2013). doi:[10.1038/msb.2013.1](dx.doi.org/10.1038/msb.2013.1)\n\n#### simplePSO\nYou can export simplePSO reference from its Zenodo DOI entry: [10.5281/zenodo.2612912](https://doi.org/10.5281/zenodo.2612912).\n\n#### swarm_it\nCite the GitHub repo: [https://github.com/LoLab-VU/swarm_it](https://github.com/LoLab-VU/swarm_it)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flolab-msm%2Fbiocomparator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flolab-msm%2Fbiocomparator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flolab-msm%2Fbiocomparator/lists"}