wias 0.1.0__tar.gz

wias-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nicolas Boulle
+
+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.

wias-0.1.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: wias
+Version: 0.1.0
+Summary: Weak Identification of Analytic Systems
+Author: Nicolas Boulle, Diana Halikias, Samuel E. Otto, Alex Townsend
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: scipy
+Provides-Extra: plot
+Requires-Dist: matplotlib; extra == "plot"
+Dynamic: license-file
+
+# wias — Weak Identification of Analytic Systems
+
+`wias` is a Python library for data-driven identification of analytic systems in weak form based on the paper: [A zero-one law for one-shot system identification
+](https://arxiv.org/abs/2607.15832) by Nicolas Boullé, Diana Halikias, Samuel E. Otto, and Alex Townsend.
+
+## Features
+
+- Weak-form assembly for **first- and second-order ODE** systems
+- Sinusoidal test-function basis construction
+- Column-pivoted QR solver (`CPQR_solver`) for coefficient recovery
+- **PDE support** via optional [Firedrake](https://www.firedrakeproject.org/) integration for finite-element weak-form assembly
+- Recovery of linearly-parametrized matrix families
+
+## Examples
+
+### Lorenz attractor
+
+The identified model accurately reconstructs the chaotic Lorenz trajectory from noisy data.
+
+![Lorenz attractor: true vs recovered](Figure/lorenz.png)
+
+### Duffing oscillator
+
+The phase portrait and time series of the identified Duffing oscillator match the ground truth closely over long integration times.
+
+![Duffing oscillator: true vs recovered](Figure/duffing.png)
+
+More examples are available in the [`examples/`](examples/) folder, including Allen–Cahn, Navier–Stokes, and Hankel/circulant matrix problems.
+
+### Level-set for algebraic equations
+
+Compute zero level set of a parameter-to-recovery map to identify inputs that lie in the degenerate set and do not allow recovery of the underlying system. 
+
+<img src="Figure/levelset_3d.png" alt="Level-set 3D visualization" width="400"/>
+
+
+## Installation
+
+```bash
+git clone https://github.com/NBoulle/wias
+cd wias
+pip install .
+```
+
+### Optional: Firedrake (PDE support)
+
+PDE identification via `wias.weak_assembly` requires [Firedrake](https://www.firedrakeproject.org/). Follow the official installation instructions at [https://www.firedrakeproject.org/install.html](https://www.firedrakeproject.org/install.html). Once installed, `assemble_weak_library_rows` becomes available automatically.
+
+
+## Citing WIAS
+If you use `wias` in your research, please cite the following paper:
+
+```bibtex
+@article{boulle2026zero,
+  title={A zero-one law for one-shot system identification},
+  author={Boull\'e, Nicolas and Halikias, Diana and Otto, Samuel E. and Townsend, Alex},
+  journal={arXiv preprint arXiv:2607.15832},
+  year={2026}
+}
+```

wias-0.1.0/README.md

@@ -0,0 +1,60 @@
+# wias — Weak Identification of Analytic Systems
+
+`wias` is a Python library for data-driven identification of analytic systems in weak form based on the paper: [A zero-one law for one-shot system identification
+](https://arxiv.org/abs/2607.15832) by Nicolas Boullé, Diana Halikias, Samuel E. Otto, and Alex Townsend.
+
+## Features
+
+- Weak-form assembly for **first- and second-order ODE** systems
+- Sinusoidal test-function basis construction
+- Column-pivoted QR solver (`CPQR_solver`) for coefficient recovery
+- **PDE support** via optional [Firedrake](https://www.firedrakeproject.org/) integration for finite-element weak-form assembly
+- Recovery of linearly-parametrized matrix families
+
+## Examples
+
+### Lorenz attractor
+
+The identified model accurately reconstructs the chaotic Lorenz trajectory from noisy data.
+
+![Lorenz attractor: true vs recovered](Figure/lorenz.png)
+
+### Duffing oscillator
+
+The phase portrait and time series of the identified Duffing oscillator match the ground truth closely over long integration times.
+
+![Duffing oscillator: true vs recovered](Figure/duffing.png)
+
+More examples are available in the [`examples/`](examples/) folder, including Allen–Cahn, Navier–Stokes, and Hankel/circulant matrix problems.
+
+### Level-set for algebraic equations
+
+Compute zero level set of a parameter-to-recovery map to identify inputs that lie in the degenerate set and do not allow recovery of the underlying system. 
+
+<img src="Figure/levelset_3d.png" alt="Level-set 3D visualization" width="400"/>
+
+
+## Installation
+
+```bash
+git clone https://github.com/NBoulle/wias
+cd wias
+pip install .
+```
+
+### Optional: Firedrake (PDE support)
+
+PDE identification via `wias.weak_assembly` requires [Firedrake](https://www.firedrakeproject.org/). Follow the official installation instructions at [https://www.firedrakeproject.org/install.html](https://www.firedrakeproject.org/install.html). Once installed, `assemble_weak_library_rows` becomes available automatically.
+
+
+## Citing WIAS
+If you use `wias` in your research, please cite the following paper:
+
+```bibtex
+@article{boulle2026zero,
+  title={A zero-one law for one-shot system identification},
+  author={Boull\'e, Nicolas and Halikias, Diana and Otto, Samuel E. and Townsend, Alex},
+  journal={arXiv preprint arXiv:2607.15832},
+  year={2026}
+}
+```

wias-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wias"
+version = "0.1.0"
+description = "Weak Identification of Analytic Systems"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "Nicolas Boulle, Diana Halikias, Samuel E. Otto, Alex Townsend" },
+]
+dependencies = ["numpy", "scipy"]
+
+[project.optional-dependencies]
+plot = ["matplotlib"]
+
+[tool.setuptools.packages.find]
+include = ["wias"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests", "."]
+python_files = ["test_*.py", "*_test.py"]

wias-0.1.0/setup.cfg

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