Metadata-Version: 2.1
Name: biosimulators-copasi
Version: 0.2.16
Summary: BioSimulators-compliant command-line interface to the COPASI simulation program <http://copasi.org>.
Home-page: https://basico.readthedocs.io/en/latest/
License: MIT
Keywords: systems,biology,modeling,simulation
Author: Center for Reproducible Biomedical Modeling
Author-email: info@biosimulators.org
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Dist: biosimulators_utils[logging,sbml] (>=0.2.0,<0.3.0)
Requires-Dist: cement (>=3.0.8,<4.0.0)
Requires-Dist: copasi_basico (>=0.74,<0.75)
Requires-Dist: docker (>=7.1.0,<8.0.0)
Requires-Dist: evalidate (>=2.0.1,<3.0.0)
Requires-Dist: kisao (>=2.34,<3.0)
Requires-Dist: lxml (>=4.9.2,<5.0.0)
Requires-Dist: numpy (>=1.24.4,<2.0.0)
Requires-Dist: pandas (>=2.0.2,<3.0.0)
Requires-Dist: python-copasi
Requires-Dist: python_dateutil (>=2.8.2,<3.0.0)
Requires-Dist: python_libsbml (>=5.20.1,<6.0.0)
Requires-Dist: setuptools (>=75.1.0,<76.0.0)
Requires-Dist: termcolor (>=2.3.0,<3.0.0)
Project-URL: Repository, https://github.com/biosimulators/Biosimulators_COPASI
Description-Content-Type: text/markdown

[![Latest release](https://img.shields.io/github/v/tag/biosimulators/Biosimulators_COPASI)](https://github.com/biosimulations/Biosimulators_COPASI/releases)
[![PyPI](https://img.shields.io/pypi/v/biosimulators_copasi)](https://pypi.org/project/biosimulators_copasi/)
[![CI status](https://github.com/biosimulators/Biosimulators_COPASI/workflows/Continuous%20integration/badge.svg)](https://github.com/biosimulators/Biosimulators_COPASI/actions?query=workflow%3A%22Continuous+integration%22)
[![Test coverage](https://codecov.io/gh/biosimulators/Biosimulators_COPASI/branch/dev/graph/badge.svg)](https://codecov.io/gh/biosimulators/Biosimulators_COPASI)
[![All Contributors](https://img.shields.io/github/all-contributors/biosimulators/Biosimulators_COPASI/HEAD)](#contributors-)


# BioSimulators-COPASI
BioSimulators-compliant command-line interface and Docker image for the [COPASI](http://copasi.org/) simulation program.

This command-line interface and Docker image enable users to use COPASI to execute [COMBINE/OMEX archives](https://combinearchive.org/) that describe one or more simulation experiments (in [SED-ML format](https://sed-ml.org)) of one or more models (in [SBML format](http://sbml.org])).

A list of the algorithms and algorithm parameters supported by COPASI is available at [BioSimulators](https://biosimulators.org/simulators/copasi).

A simple web application and web service for using COPASI to execute COMBINE/OMEX archives is also available at [runBioSimulations](https://run.biosimulations.org).

## Installation

### Install Python package
```
pip install biosimulators-copasi
```

### Install Docker image
```
docker pull ghcr.io/biosimulators/copasi
```

## Usage

### Local usage
```
usage: biosimulators-copasi [-h] [-d] [-q] -i ARCHIVE [-o OUT_DIR] [-v]

BioSimulators-compliant command-line interface to the COPASI simulation program <http://copasi.org>.

optional arguments:
  -h, --help            show this help message and exit
  -d, --debug           full application debug mode
  -q, --quiet           suppress all console output
  -i ARCHIVE, --archive ARCHIVE
                        Path to OMEX file which contains one or more SED-ML-
                        encoded simulation experiments
  -o OUT_DIR, --out-dir OUT_DIR
                        Directory to save outputs
  -v, --version         show program's version number and exit
```

### Usage through Docker container
The entrypoint to the Docker image supports the same command-line interface described above.

For example, the following command could be used to use the Docker image to execute the COMBINE/OMEX archive `./modeling-study.omex` and save its outputs to `./`.

```
docker run \
  --tty \
  --rm \
  --mount type=bind,source="$(pwd)",target=/root/in,readonly \
  --mount type=bind,source="$(pwd)",target=/root/out \
  ghcr.io/biosimulators/copasi:latest \
    -i /root/in/modeling-study.omex \
    -o /root/out
```

## Documentation
Documentation is available at https://docs.biosimulators.org/Biosimulators_COPASI/.

## License
This package is released under the [MIT license](LICENSE). COPASI is released under the [Artistic 2.0 License](http://copasi.org/Download/License/).

## Development team
This package was developed by the [Center for Reproducible Biomedical Modeling](http://reproduciblebiomodels.org). COPASI was developed by a [team](http://copasi.org/About/Team/) at the University of Connecticut, the University of Heidelberg, and the University of Virginia with assistance from the contributors listed [here](CONTRIBUTORS.md).

## Questions and comments
Please contact the [BioSimulators Team](mailto:info@biosimulators.org) with any questions or comments.


