Metadata-Version: 2.1
Name: ixmp
Version: 3.9.0rc1
Summary: The ix modeling platform
Author: IIASA Energy, Climate, and Environment (ECE) program
Maintainer-email: Paul Natsuo Kishimoto <mail@paul.kishimoto.name>, Fridolin Glatter <glatter@iiasa.ac.at>
Project-URL: homepage, https://github.com/iiasa/ixmp
Project-URL: repository, https://github.com/iiasa/ixmp
Project-URL: documentation, https://docs.messageix.org/ixmp
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: R
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE.rst
License-File: AUTHORS.md
Requires-Dist: click
Requires-Dist: genno >=1.20
Requires-Dist: JPype1 >=1.2.1
Requires-Dist: openpyxl
Requires-Dist: pandas >=1.2
Requires-Dist: pint
Requires-Dist: PyYAML
Requires-Dist: xarray
Requires-Dist: JPype1 <=1.4.0 ; python_version < "3.11"
Provides-Extra: docs
Requires-Dist: ixmp[tests] ; extra == 'docs'
Requires-Dist: genno >=1.26 ; extra == 'docs'
Requires-Dist: GitPython ; extra == 'docs'
Requires-Dist: numpydoc ; extra == 'docs'
Requires-Dist: sphinx >=3.0 ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme ; extra == 'docs'
Requires-Dist: sphinxcontrib-bibtex ; extra == 'docs'
Provides-Extra: report
Requires-Dist: genno[compat,graphviz] ; extra == 'report'
Provides-Extra: tests
Requires-Dist: ixmp[report,tutorial] ; extra == 'tests'
Requires-Dist: memory-profiler ; extra == 'tests'
Requires-Dist: nbclient >=0.5 ; extra == 'tests'
Requires-Dist: pretenders >=1.4.4 ; extra == 'tests'
Requires-Dist: pytest >=5 ; extra == 'tests'
Requires-Dist: pytest-benchmark ; extra == 'tests'
Requires-Dist: pytest-cov ; extra == 'tests'
Requires-Dist: pytest-rerunfailures ; extra == 'tests'
Requires-Dist: pytest-xdist ; extra == 'tests'
Provides-Extra: tutorial
Requires-Dist: jupyter ; extra == 'tutorial'

# `ixmp`: the ix modeling platform

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.4005665.svg)](https://doi.org/10.5281/zenodo.4005665)
[![PyPI version](https://img.shields.io/pypi/v/ixmp.svg)](https://pypi.python.org/pypi/ixmp/)
[![Anaconda version](https://img.shields.io/conda/vn/conda-forge/ixmp)](https://anaconda.org/conda-forge/ixmp)
[![Documentation build](https://readthedocs.com/projects/iiasa-energy-program-ixmp/badge/?version=latest)](https://docs.messageix.org/projects/ixmp/en/latest/)
[![Build status](https://github.com/iiasa/ixmp/actions/workflows/pytest.yaml/badge.svg)](https://github.com/iiasa/ixmp/actions/workflows/pytest.yaml)
[![Test coverage](https://codecov.io/gh/iiasa/ixmp/branch/master/graph/badge.svg)](https://codecov.io/gh/iiasa/ixmp)

The ix modeling platform (`ixmp`) is a data warehouse for high-powered scenario
analysis, with interfaces to Python and R for efficient scientific workflows and
effective data pre- and post-processing, and a structured database backend for
version-controlled data management.
In the name, “ix” stands for “integrated” and “cross (x) cutting”.

The [MESSAGEix modeling *framework*](https://docs.messageix.org) is built on top of the ix modeling *platform*.


This repository contains the core and application programming interfaces (API)
for the ix modeling platform (ixmp), as well as a number of tutorials and
examples for a generic model instance based on Dantzig's transport problem.

## Documentation

Complete documentation of the ixmp API is available for current and past versions at: https://docs.messageix.org/ixmp/.
This includes:

- **Installation.**
  Most users will have ixmp installed automatically as a dependency when
[installing MESSAGEix](https://docs.messageix.org/en/stable/#getting-started).
  To install ixmp from source code, or to use ixmp from R, see
[‘Installation’](https://docs.messageix.org/projects/ixmp/en/stable/install.html) or [`INSTALL.rst`](INSTALL.rst).
- **Tutorials.** Introductory tutorials are provided in both Python and R; see [‘Tutorials’](https://docs.messageix.org/projects/ixmp/en/stable/tutorials.html) or [`tutorial/README.rst`](tutorial/README.rst).
- How to **cite `ixmp` when using it in published scientific work.** See [‘User guidelines and notice’](https://docs.messageix.org/en/stable/notice.html) or [`NOTICE.rst`](NOTICE.rst).
- **Changelog and migration notes** for each new release: see [“What's New”](https://docs.messageix.org/projects/ixmp/en/stable/whatsnew.html).

Other forms of documentation:

- The online documentation is built automatically from the contents of the
[ixmp GitHub repository](https://github.com/iiasa/ixmp).
- For documentation of a specific release, e.g. `v3.2.0`, use the chooser in the bottom sidebar.
- For offline use, the documentation can be built from the source code.
See [`doc/README.rst`](doc/README.rst) for further details.
- The [MESSAGEix API documentation](https://docs.messageix.org/en/stable/api.html) links to the ixmp documentation in many places, for convenience.

## License

Copyright © 2017–2024 IIASA Energy, Climate, and Environment (ECE) program

`ixmp` is licensed under the Apache License, Version 2.0 (the "License"); you
may not use the files in this repository except in compliance with the License.
You may obtain a copy of the License in [`LICENSE`](LICENSE) or at
<https://www.apache.org/licenses/LICENSE-2.0>.
