Skip to main content

Gana logo

PyPI Python Versions Downloads Documentation

Quality Codacy Badge Coverage License Last Commit

Gana is an Algebraic Modeling Language (AML) for Multiscale Modeling and Optimization. Generated programs (Prg) can be subclasses of Multiparametric Mixed Integer Linear Programming (mpMILP).

Installation

The current development checkout requires the Rust extension, gana._native. The Python modeling API is unchanged. Use Python 3.12 or 3.13 for the candidate validation matrix; other versions and wheel platforms are not yet verified.

Install an available release and its dependencies in a fresh environment:

python3.13 -m venv .venv
.venv/bin/python -m pip install gana

On Windows, use .venv\Scripts\python instead. Published releases may predate the backend retirement described here. A compatible wheel includes the native extension and needs no Rust compiler at runtime. A source installation, including this checkout, needs Rust/Cargo 1.88 or newer and a platform linker; validation uses Rust 1.88.0:

.venv/bin/python -m pip install .

Leave GANA_BACKEND unset. The old rust-parameters value is accepted as an alias; python and unknown values are rejected. A missing extension produces installation guidance instead of selecting a Python backend. See the installation guide and native implementation notes.

Features

Gana supports:

  • mutable elements, allowing constraints/functions to be updated dynamically
  • multiparametric as well as mixed integer programming
  • formulation in both matrix form and set-based mathematical program

Moreover, Gana uses a simple format to write constraints/functions.

Elements

Programs in Gana are written using element sets, namely:

  1. I - index
  2. V - variable
  3. P - parameter
  4. T - parametric variable

Solvers

The list of natively supported solvers are:

  1. PPOPT for multiparametric programming (mp)
  2. HiGHS for linear and mixed-integer programming, included with Gana and selected by default with program.opt().
  3. Gurobi for linear and mixed-integer programming with program.opt(using="gurobi").

Programs can be exported as a .mps or .lp file and passed to most solvers.

Illustration

Gana is best run in Jupyter as notebook (.ipynb) files, where programs can be visualized as canonical mathematical programs using set-notation.

Additionally, matrices can be exported.

Purpose

Gana was developed to enable certain functionalities in energia (py). Both were developed as PhD projects and have ample room for improvement. So please reach out to me on cacodcar@gmail.com with suggestions and such.

Metadata

Release files for gana 1.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gana 1.5.0
File Size Uploaded Provenance Actions
gana-1.5.0.tar.gz 168.7 kB With provenance Details for gana-1.5.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for gana 1.5.0
File Actions
gana-1.5.0-cp312-abi3-win_amd64.whl CPython 3.12 abi3 Windows x86-64 Details for gana-1.5.0-cp312-abi3-win_amd64.whl
gana-1.5.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.12 abi3 Linux glibc 2.17+ x86-64 Details for gana-1.5.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
gana-1.5.0-cp312-abi3-macosx_11_0_arm64.whl CPython 3.12 abi3 macOS 11.0+ ARM64 Details for gana-1.5.0-cp312-abi3-macosx_11_0_arm64.whl
gana-1.5.0-cp312-abi3-macosx_10_12_x86_64.whl CPython 3.12 abi3 macOS 10.12+ x86-64 Details for gana-1.5.0-cp312-abi3-macosx_10_12_x86_64.whl

Total release size: 2.2 MB

Release files / gana-1.5.0.tar.gz

Download URL gana-1.5.0.tar.gz
Size 168.7 kB
Tags Source
SHA-256 checksum
How to use checksums
625d9f51f379474edef58858ada06ba2be9f6c962cd5356975f67c50828d7790
BLAKE2b-256 checksum
How to use checksums
2004b7202d17d966a63f6f8ae3abe451b1b54c221613826ff8e8a52ef3ec1a80
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / gana-1.5.0-cp312-abi3-win_amd64.whl

Download URL gana-1.5.0-cp312-abi3-win_amd64.whl
Size 426.1 kB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
1ad06049cac8a38d92d126c0aaf2124bc1f786d5f473ceeb3245379779ddd98f
BLAKE2b-256 checksum
How to use checksums
d0402189ef079d6ab906d905e45a6cd4e25831b13194c504d91681f8443f3d4e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / gana-1.5.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL gana-1.5.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 562.6 kB
Tags CPython 3.12 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
f74d6b607bd2f3c29407a149d6d2878aa8c1c065ae8e4ae1bc5be3b9e091c37d
BLAKE2b-256 checksum
How to use checksums
94bc154528818b48aef76e213627c099f4c5bb8a22d3c2430a2c8531e45b9f89
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / gana-1.5.0-cp312-abi3-macosx_11_0_arm64.whl

Download URL gana-1.5.0-cp312-abi3-macosx_11_0_arm64.whl
Size 512.6 kB
Tags CPython 3.12 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
0c6ace52a869d848adf4e5812e545617cd586fb74c082222b91deca0dbf92719
BLAKE2b-256 checksum
How to use checksums
de517d890b46084ad1586b9b93cf7858db51a7b3976f9bffa4ace38c20369b10
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / gana-1.5.0-cp312-abi3-macosx_10_12_x86_64.whl

Download URL gana-1.5.0-cp312-abi3-macosx_10_12_x86_64.whl
Size 539.0 kB
Tags CPython 3.12 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
75c8cd3e2b85f58e4072f430b960e558dbbcbfdbc0bbcc368cf61fec3dac9c24
BLAKE2b-256 checksum
How to use checksums
86eecbc34f53c321a511a5d690b6c82d5ac48ae40d4508b483cb904e3648d458
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Security for gana 1.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 5 files in this release have been uploaded with provenance metadata.

Select from 5 files

Attestation for gana-1.5.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page