pydgens 0.6.1__tar.gz

pydgens-0.6.1/LICENSE.txt

@@ -0,0 +1,8 @@
+MIT License
+Copyright (c) 2026 Massachusetts Institute of Technology
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

pydgens-0.6.1/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: pydgens
+Version: 0.6.1
+Summary: Python/JAX-based numerical solvers for dynamic/differential game equilibria
+Author: R. Allen, W. Li
+License-Expression: MIT
+Project-URL: Changelog, https://github.com/mit-ll/pydgens/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://mit-ll.github.io/pydgens/
+Project-URL: Issues, https://github.com/mit-ll/pydgens/issues
+Project-URL: Source, https://github.com/mit-ll/pydgens
+Keywords: differential games,dynamic games,feedback Nash equilibrium,jax,optimal control
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: flax
+Requires-Dist: jax
+Requires-Dist: numpy
+Provides-Extra: dev
+Requires-Dist: line_profiler; extra == "dev"
+Requires-Dist: pyinstrument; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-rich; extra == "dev"
+Requires-Dist: pytest-benchmark; extra == "dev"
+Requires-Dist: scalene; extra == "dev"
+Requires-Dist: tensorboard; extra == "dev"
+Requires-Dist: zensical; extra == "dev"
+Provides-Extra: full
+Requires-Dist: pydgens[dev]; extra == "full"
+Dynamic: license-file
+
+# PYDGENS: Python/JAX Differential Game Equilibria Numerical Solvers
+
+<p align="center">
+  <img src="docs/assets/pydgens-logo.png" alt="PYDGENS logo" width="300">
+</p>
+
+PYDGENS provides numerical solvers for approximating equilibrium solutions in multi-player, general-sum dynamic and differential games. The package currently focuses on linear-quadratic feedback Nash games, iterative linear-quadratic methods for nonlinear games, and augmented-Lagrangian workflows for constrained games.
+
+PYDGENS is a pre-`1.0` release. The package is ready for early adopters, but the public API may continue to evolve as the modeling frontend, examples, and solver interfaces mature.
+
+## Installation
+
+```bash
+pip install pydgens
+```
+
+PYDGENS requires Python `3.12` or newer.
+
+## Solvers
+
+PYDGENS currently supports three main solver paths:
+
+- LQ: linear-quadratic, unconstrained games solved for feedback Nash strategies
+- iLQ: nonlinear, unconstrained games solved for local feedback Nash strategies
+- AL: constrained nonlinear games solved with an augmented-Lagrangian workflow for local open-loop trajectories
+
+## Examples
+
+Run a minimal linear-quadratic tug-of-war game solved with the LQ solver:
+
+```bash
+python src/pydgens/examples/tug_o_war.py
+```
+
+Run a nonlinear two-player unicycle game solved with the iterative LQ solver:
+
+```bash
+python src/pydgens/examples/unicycle.py
+```
+
+Run a constrained two-player integrator game solved with the augmented-Lagrangian solver:
+
+```bash
+python src/pydgens/examples/constrained_integrators.py
+```
+
+More examples live in [`src/pydgens/examples/`](src/pydgens/examples/).
+
+## Documentation
+
+Documentation is available at <https://mit-ll.github.io/pydgens/>.
+
+## Development
+
+For development from a local clone:
+
+```bash
+pip install -e .[full]
+```
+
+Contributors can also use `uv` for a reproducible environment:
+
+```bash
+uv sync --extra dev
+source .venv/bin/activate
+```
+
+## Testing
+
+Quick tests:
+
+```bash
+pytest tests/ -v -s -m "not slow"
+```
+
+Slow and benchmark-oriented tests:
+
+```bash
+pytest tests/ -v -m "slow" --benchmark-columns='mean, min, max, stddev, rounds'
+```
+
+## Disclaimer
+
+DISTRIBUTION STATEMENT A. Approved for public release. Distribution is unlimited.
+
+This material is based upon work supported by the Under Secretary of War for Research and
+Engineering under Air Force Contract No. FA8702-15-D-0001 or FA8702-25-D-B002. Any
+opinions, findings, conclusions or recommendations expressed in this material are those of
+the author(s) and do not necessarily reflect the views of the Under Secretary of War for
+Research and Engineering.
+
+© 2026 Massachusetts Institute of Technology.
+
+Subject to FAR52.227-11 Patent Rights - Ownership by the contractor (May 2014)
+
+SPDX-License-Identifier: MIT
+
+The software/firmware is provided to you on an As-Is basis.
+
+Delivered to the U.S. Government with Unlimited Rights, as defined in DFARS Part
+252.227-7013 or 7014 (Feb 2014). Notwithstanding any copyright notice, U.S. Government
+rights in this work are defined by DFARS 252.227-7013 or DFARS 252.227-7014 as detailed
+above. Use of this work other than as specifically authorized by the U.S. Government may
+violate any copyrights that exist in this work.

pydgens-0.6.1/README.md

@@ -0,0 +1,104 @@
+# PYDGENS: Python/JAX Differential Game Equilibria Numerical Solvers
+
+<p align="center">
+  <img src="docs/assets/pydgens-logo.png" alt="PYDGENS logo" width="300">
+</p>
+
+PYDGENS provides numerical solvers for approximating equilibrium solutions in multi-player, general-sum dynamic and differential games. The package currently focuses on linear-quadratic feedback Nash games, iterative linear-quadratic methods for nonlinear games, and augmented-Lagrangian workflows for constrained games.
+
+PYDGENS is a pre-`1.0` release. The package is ready for early adopters, but the public API may continue to evolve as the modeling frontend, examples, and solver interfaces mature.
+
+## Installation
+
+```bash
+pip install pydgens
+```
+
+PYDGENS requires Python `3.12` or newer.
+
+## Solvers
+
+PYDGENS currently supports three main solver paths:
+
+- LQ: linear-quadratic, unconstrained games solved for feedback Nash strategies
+- iLQ: nonlinear, unconstrained games solved for local feedback Nash strategies
+- AL: constrained nonlinear games solved with an augmented-Lagrangian workflow for local open-loop trajectories
+
+## Examples
+
+Run a minimal linear-quadratic tug-of-war game solved with the LQ solver:
+
+```bash
+python src/pydgens/examples/tug_o_war.py
+```
+
+Run a nonlinear two-player unicycle game solved with the iterative LQ solver:
+
+```bash
+python src/pydgens/examples/unicycle.py
+```
+
+Run a constrained two-player integrator game solved with the augmented-Lagrangian solver:
+
+```bash
+python src/pydgens/examples/constrained_integrators.py
+```
+
+More examples live in [`src/pydgens/examples/`](src/pydgens/examples/).
+
+## Documentation
+
+Documentation is available at <https://mit-ll.github.io/pydgens/>.
+
+## Development
+
+For development from a local clone:
+
+```bash
+pip install -e .[full]
+```
+
+Contributors can also use `uv` for a reproducible environment:
+
+```bash
+uv sync --extra dev
+source .venv/bin/activate
+```
+
+## Testing
+
+Quick tests:
+
+```bash
+pytest tests/ -v -s -m "not slow"
+```
+
+Slow and benchmark-oriented tests:
+
+```bash
+pytest tests/ -v -m "slow" --benchmark-columns='mean, min, max, stddev, rounds'
+```
+
+## Disclaimer
+
+DISTRIBUTION STATEMENT A. Approved for public release. Distribution is unlimited.
+
+This material is based upon work supported by the Under Secretary of War for Research and
+Engineering under Air Force Contract No. FA8702-15-D-0001 or FA8702-25-D-B002. Any
+opinions, findings, conclusions or recommendations expressed in this material are those of
+the author(s) and do not necessarily reflect the views of the Under Secretary of War for
+Research and Engineering.
+
+© 2026 Massachusetts Institute of Technology.
+
+Subject to FAR52.227-11 Patent Rights - Ownership by the contractor (May 2014)
+
+SPDX-License-Identifier: MIT
+
+The software/firmware is provided to you on an As-Is basis.
+
+Delivered to the U.S. Government with Unlimited Rights, as defined in DFARS Part
+252.227-7013 or 7014 (Feb 2014). Notwithstanding any copyright notice, U.S. Government
+rights in this work are defined by DFARS 252.227-7013 or DFARS 252.227-7014 as detailed
+above. Use of this work other than as specifically authorized by the U.S. Government may
+violate any copyrights that exist in this work.

pydgens-0.6.1/pyproject.toml

@@ -0,0 +1,74 @@
+[build-system]
+requires = [
+  "setuptools >= 61.0",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pydgens"
+description = "Python/JAX-based numerical solvers for dynamic/differential game equilibria"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE.txt"]
+authors = [
+  { name = "R. Allen" },
+  { name = "W. Li" },
+]
+keywords = [
+  "differential games",
+  "dynamic games",
+  "feedback Nash equilibrium",
+  "jax",
+  "optimal control",
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Science/Research",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Scientific/Engineering",
+]
+
+dependencies = [
+  "flax",
+  "jax",
+  "numpy",
+]
+dynamic = ["version"]
+
+[project.urls]
+Changelog = "https://github.com/mit-ll/pydgens/blob/main/CHANGELOG.md"
+Documentation = "https://mit-ll.github.io/pydgens/"
+Issues = "https://github.com/mit-ll/pydgens/issues"
+Source = "https://github.com/mit-ll/pydgens"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"pydgens.examples" = ["*.json"]
+
+[tool.setuptools.dynamic]
+version = { attr = "pydgens.__version__" }
+
+[project.optional-dependencies]
+dev = [
+  "line_profiler",
+  "pyinstrument",
+  "pytest",
+  "pytest-rich",
+  "pytest-benchmark",
+  "scalene",
+  "tensorboard",
+  "zensical",
+]
+full = ["pydgens[dev]"]
+
+[tool.pytest.ini_options]
+markers = [
+  "regression: approved-output and/or performance regression tests",
+  "slow: may include JIT compile or long-running steps",
+]

pydgens-0.6.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pydgens-0.6.1/src/pydgens/__init__.py

@@ -0,0 +1,46 @@
+# Copyright 2026 MIT Lincoln Laboratory
+# SPDX-License-Identifier: MIT
+
+# Single-sourcing package version
+# https://packaging.python.org/guides/single-sourcing-package-version/
+
+__version__ = "0.6.1"
+
+# User-facing semantic modeling APIs
+from pydgens.frontend import dynamics
+from pydgens.frontend import costs
+from pydgens.frontend import players
+from pydgens.frontend import games
+from pydgens.frontend import constraints
+
+# Convenience constructors for common workflows
+from pydgens.ir.timetypes import time_grid
+from pydgens.frontend.dynamics import linear_dynamics
+from pydgens.frontend.dynamics import nonlinear_dynamics
+from pydgens.frontend.costs import player_cost
+from pydgens.frontend.costs import quadratic_cost
+from pydgens.frontend.constraints import control_bounds
+from pydgens.frontend.constraints import state_bounds
+from pydgens.frontend.constraints import constraint_set
+from pydgens.frontend.players import player
+from pydgens.frontend.games import game
+from pydgens.frontend.solvers import solve
+
+__all__ = [
+    "dynamics",
+    "costs",
+    "players",
+    "games",
+    "constraints",
+    "time_grid",
+    "linear_dynamics",
+    "nonlinear_dynamics",
+    "player_cost",
+    "quadratic_cost",
+    "control_bounds",
+    "state_bounds",
+    "constraint_set",
+    "player",
+    "game",
+    "solve",
+]

pydgens-0.6.1/src/pydgens/examples/__init__.py

@@ -0,0 +1,3 @@
+# Copyright 2026 MIT Lincoln Laboratory
+# SPDX-License-Identifier: MIT
+