Skip to main content

Gana logo

PyPI Python Versions Downloads Documentation

Quality 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. Gurobi for Mixed Integer Programming (MIP) Programs can, however, 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.3.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.3.0
File Size Uploaded Provenance Actions
gana-1.3.0.tar.gz 168.5 kB With provenance Details for gana-1.3.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for gana 1.3.0
File Actions
gana-1.3.0-cp312-abi3-win_amd64.whl CPython 3.12 abi3 Windows x86-64 Details for gana-1.3.0-cp312-abi3-win_amd64.whl
gana-1.3.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.3.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
gana-1.3.0-cp312-abi3-macosx_11_0_arm64.whl CPython 3.12 abi3 macOS 11.0+ ARM64 Details for gana-1.3.0-cp312-abi3-macosx_11_0_arm64.whl
gana-1.3.0-cp312-abi3-macosx_10_12_x86_64.whl CPython 3.12 abi3 macOS 10.12+ x86-64 Details for gana-1.3.0-cp312-abi3-macosx_10_12_x86_64.whl

Total release size: 2.2 MB

Release files / gana-1.3.0.tar.gz

Download URL gana-1.3.0.tar.gz
Size 168.5 kB
Tags Source
SHA-256 checksum
How to use checksums
f2929b2e62b1e2f3b695aed53c450b05afc152eeaf5c10e362347fe58c0edabd
BLAKE2b-256 checksum
How to use checksums
1aae0715cb48cd64e7628ed861b70f63eb52d3a4116cd8b21dbc92184f95ad3e
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.3.0-cp312-abi3-win_amd64.whl

Download URL gana-1.3.0-cp312-abi3-win_amd64.whl
Size 424.4 kB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
8994a018e92a5299a8ecafc45ed0deac5677002e48c9efe95db78951f974457a
BLAKE2b-256 checksum
How to use checksums
cfd7a4cc675c85a424750351744dd985c59f701ba670dccebb1b7747cf093592
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.3.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL gana-1.3.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 561.0 kB
Tags CPython 3.12 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
2d0762b9fb1d2eb55c76cffa11457bf23587d5299ccc61a05dd3c313dafec11d
BLAKE2b-256 checksum
How to use checksums
bedd30c09308486c37bea25f67f46c3b39de46942faf4413772095360675b641
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.3.0-cp312-abi3-macosx_11_0_arm64.whl

Download URL gana-1.3.0-cp312-abi3-macosx_11_0_arm64.whl
Size 510.9 kB
Tags CPython 3.12 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
bc66f0af1e1bcb2fbaff1a8dddd8738ac2c71b9423ea64d7653e9da828603960
BLAKE2b-256 checksum
How to use checksums
e81d6ceb7cac1576f666bc1a446321f8ae0f5cec806352c2ca13747ea689a6bc
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.3.0-cp312-abi3-macosx_10_12_x86_64.whl

Download URL gana-1.3.0-cp312-abi3-macosx_10_12_x86_64.whl
Size 537.4 kB
Tags CPython 3.12 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
a7bd41abde57e34253df4e8db052e8a2bc4c0fa90407c2e8ef1be39f870b4492
BLAKE2b-256 checksum
How to use checksums
80c38500000c06150277dbf75fbcf11211c455312b962fe35610fa46f671e240
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.3.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.3.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