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.1

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.1
File Size Uploaded Provenance Actions
gana-1.3.1.tar.gz 168.5 kB With provenance Details for gana-1.3.1.tar.gz

Built distributions (wheels)

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

Total release size: 2.2 MB

Release files / gana-1.3.1.tar.gz

Download URL gana-1.3.1.tar.gz
Size 168.5 kB
Tags Source
SHA-256 checksum
How to use checksums
66990cf128bc7c236c5ff3770c582766ded1f75d92455b318d3bc00a9b60fa9e
BLAKE2b-256 checksum
How to use checksums
29f065800b0ac8af365ae6f36da6e25a5165b63cae676c23f42352b65b0a07fb
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.1-cp312-abi3-win_amd64.whl

Download URL gana-1.3.1-cp312-abi3-win_amd64.whl
Size 424.5 kB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
32fec6694b844bc398f590b38b422d1357ef2e5c51bfbf5b5f93126127c2f060
BLAKE2b-256 checksum
How to use checksums
ff0cb02a578576d864fa1630070201cf91d97637996b5ed1e688facda693c31b
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.1-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL gana-1.3.1-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
8ed728c8cd2f0da464168cd0b8b26ba1360fa3b131fe3d483b9edaf19745ae84
BLAKE2b-256 checksum
How to use checksums
2bcc36647812480659378d4401ecf10ce2e6d3b3f61d79039d930ffb0d398626
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.1-cp312-abi3-macosx_11_0_arm64.whl

Download URL gana-1.3.1-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
4b5c11f27a53d7dd42149ea08c08d9a556f92bee2a2ac7170fcc37b2be432e3f
BLAKE2b-256 checksum
How to use checksums
54ff531335b2e9aea5c331f7fea426751efac8b79c0b955b18d797db6f301905
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.1-cp312-abi3-macosx_10_12_x86_64.whl

Download URL gana-1.3.1-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
43bc8c0a9a061fb8ce549e2ecd09be08b726b02591c5202ee63e5e5eb0dd15a2
BLAKE2b-256 checksum
How to use checksums
912bcc778e559e598054f05c5975867e5850c9b0757a231c8624fed91f62ece7
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.1

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.1.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