slicot 1.0.0__tar.gz

slicot-1.0.0/.github/workflows/build.yml

@@ -0,0 +1,95 @@
+name: Build Wheels
+
+on:
+  workflow_dispatch:
+  workflow_call:
+
+jobs:
+  build-wheels:
+    name: Build ${{ matrix.os }} ${{ matrix.arch }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            arch: x86_64
+            cibw_archs: x86_64
+          - os: macos-14
+            arch: arm64
+            cibw_archs: arm64
+          - os: windows-latest
+            arch: x86_64
+            cibw_archs: AMD64
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.22
+        env:
+          CIBW_ARCHS: ${{ matrix.cibw_archs }}
+          CIBW_BUILD: "cp311-* cp312-* cp313-*"
+          CIBW_SKIP: "pp* *-win32 *-manylinux_i686 *-musllinux_* *_universal2"
+          CIBW_MANYLINUX_X86_64_IMAGE: manylinux2014
+          CIBW_BEFORE_ALL_LINUX: yum install -y openblas-devel || apk add openblas-dev
+          CIBW_BEFORE_ALL_WINDOWS: choco install -y pkgconfiglite
+          CIBW_ENVIRONMENT_LINUX: PKG_CONFIG_PATH=/tmp/openblas
+          CIBW_ENVIRONMENT_MACOS: MACOSX_DEPLOYMENT_TARGET=11.0 PKG_CONFIG_PATH=/tmp/openblas
+          CIBW_BEFORE_BUILD_LINUX: pip install scipy-openblas32 && mkdir -p /tmp/openblas && python -c "import scipy_openblas32 as sc; open('/tmp/openblas/openblas.pc','w').write(sc.get_pkg_config())" || true
+          CIBW_BEFORE_BUILD_MACOS: pip install scipy-openblas32 && mkdir -p /tmp/openblas && python -c "import scipy_openblas32 as sc; open('/tmp/openblas/openblas.pc','w').write(sc.get_pkg_config())"
+          CIBW_BEFORE_BUILD_WINDOWS: pip install scipy-openblas32 delvewheel && (if not exist C:\openblas mkdir C:\openblas) && python -c "import scipy_openblas32 as sc; open('C:/openblas/openblas.pc','w').write(sc.get_pkg_config()); open('C:/openblas/libdir.txt','w').write(sc.get_lib_dir())"
+          CIBW_ENVIRONMENT_WINDOWS: PKG_CONFIG_PATH=C:/openblas
+          CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: >-
+            powershell -Command "$libdir = Get-Content 'C:/openblas/libdir.txt'; delvewheel repair -w {dest_dir} {wheel} --add-path $libdir"
+          CIBW_TEST_REQUIRES: pytest pytest-timeout scipy
+          CIBW_TEST_COMMAND: pytest {project}/tests/python/test_ab01md.py -v --timeout=60
+          CIBW_TEST_SKIP: "*-manylinux*"
+          CIBW_TEST_COMMAND_WINDOWS: pytest {project}/tests/python/test_ab01md.py -v --timeout=60 || true
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}-${{ matrix.arch }}
+          path: ./wheelhouse/*.whl
+
+  build-sdist:
+    name: Build sdist
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install deps
+        run: |
+          pip install scipy-openblas32
+          mkdir -p /tmp/openblas
+          python -c "import scipy_openblas32 as sc; open('/tmp/openblas/openblas.pc','w').write(sc.get_pkg_config())"
+
+      - run: PKG_CONFIG_PATH=/tmp/openblas pip install build && PKG_CONFIG_PATH=/tmp/openblas python -m build --sdist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  merge-artifacts:
+    name: Merge Artifacts
+    needs: [build-wheels, build-sdist]
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          pattern: wheels-*
+          merge-multiple: true
+
+      - uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels
+          path: dist/*

slicot-1.0.0/.github/workflows/codeql.yml

@@ -0,0 +1,48 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: "0 6 * * 1"
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+      packages: read
+      actions: read
+      contents: read
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [c-cpp, python]
+        include:
+          - language: c-cpp
+            build-mode: manual
+          - language: python
+            build-mode: none
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: github/codeql-action/init@v3
+        with:
+          languages: ${{ matrix.language }}
+          build-mode: ${{ matrix.build-mode }}
+
+      - name: Build (C/C++)
+        if: matrix.language == 'c-cpp'
+        run: |
+          sudo apt-get update && sudo apt-get install -y libblas-dev liblapack-dev ninja-build
+          cmake -B build -G Ninja -DBUILD_TESTING=OFF
+          cmake --build build
+
+      - uses: github/codeql-action/analyze@v3
+        with:
+          category: "/language:${{ matrix.language }}"

slicot-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,40 @@
+name: Publish
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+    inputs:
+      skip_tests:
+        description: "Skip tests"
+        type: boolean
+        default: false
+
+jobs:
+  test:
+    if: ${{ !inputs.skip_tests }}
+    uses: ./.github/workflows/test.yml
+
+  build:
+    needs: [test]
+    if: always() && (needs.test.result == 'success' || inputs.skip_tests)
+    uses: ./.github/workflows/build.yml
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: [build]
+    if: always() && needs.build.result == 'success'
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/slicot/
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheels
+          path: dist
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

slicot-1.0.0/.github/workflows/test.yml

@@ -0,0 +1,79 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+  workflow_call:
+
+jobs:
+  quick-test:
+    name: Quick Test (Ubuntu)
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install system deps
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libopenblas-dev meson ninja-build
+
+      - name: Install Python package
+        run: pip install .[test]
+
+      - name: Run quick test
+        run: pytest tests/python/test_ab01md.py -v
+
+  full-test:
+    name: Full Test Suite
+    needs: quick-test
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install system deps
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libopenblas-dev meson ninja-build
+
+      - name: Install Python package
+        run: pip install .[test]
+
+      - name: Run full tests
+        run: pytest tests/python/ -v -n auto --reruns 2 --only-rerun "worker .* crashed"
+
+  test-macos:
+    name: Test (macOS)
+    runs-on: macos-14
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install deps and package
+        run: |
+          pip install scipy-openblas32 meson ninja
+          mkdir -p /tmp/openblas
+          python -c "import scipy_openblas32 as sc; open('/tmp/openblas/openblas.pc','w').write(sc.get_pkg_config())"
+          PKG_CONFIG_PATH=/tmp/openblas pip install .[test]
+
+      - name: Run quick test
+        run: pytest tests/python/test_ab01md.py -v

slicot-1.0.0/.gitignore

@@ -0,0 +1,10 @@
+build/
+dist/
+*.egg-info/
+__pycache__/
+*.pyc
+*.so
+*.dylib
+*.dll
+.venv*/
+wheelhouse/

slicot-1.0.0/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## [1.0.0] - 2025-01-23
+
+### Added
+
+- Initial release
+- 550+ SLICOT routines (AB, SB, MB, IB, TG, SG families)
+- Pre-built wheels: Linux (x86_64, aarch64), macOS (arm64), Windows (AMD64, ARM64)
+- Python 3.11-3.13, NumPy 2.x
+- Type stubs (PEP 561)

slicot-1.0.0/CLAUDE.md

@@ -0,0 +1,47 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build Commands
+
+```bash
+# Install dev dependencies
+pip install -e ".[test]"
+
+# Build wheel (uses meson-python)
+pip install build && python -m build
+
+# Run all tests
+pytest tests/python/
+
+# Run single test
+pytest tests/python/test_ab01md.py -v
+
+# Run specific test function
+pytest tests/python/test_ab01md.py::test_basic -v
+```
+
+## Architecture
+
+This is a C11 translation of SLICOT (Subroutine Library In COntrol Theory) with Python bindings.
+
+### Core Structure
+- `src/` - C implementations organized by 2-letter prefix (AB/, SB/, MB/, etc.)
+- `include/slicot/` - Headers per prefix (ab.h, sb.h, etc.), aggregated in `slicot.h`
+- `include/slicot_types.h` - Type aliases: `i32`, `i64`, `f64`, `c128`
+- `python/wrappers/py_*.c` - NumPy C-API wrappers per prefix
+- `python/slicot_module.c` - Main Python extension module
+- `python/data/*.json` - Docstring metadata (generated by `tools/generate_docstrings.py`)
+
+### Build System
+- meson-python wraps Meson for Python packaging
+- Meson auto-detects BLAS/LAPACK (OpenBLAS, scipy-openblas, Accelerate)
+- Static linking for wheels
+
+### Key Conventions
+- All arrays use Fortran column-major order (`order='F'` in NumPy)
+- Python wrappers use `NPY_ARRAY_FARRAY` flag
+- Tests in `tests/python/test_<routine>.py` mirror routine names
+
+### macOS Note
+Full test suite may crash on macOS due to Accelerate framework issues. Use `tools/run_tests_batched.py` as workaround.

slicot-1.0.0/LICENSE

@@ -0,0 +1,30 @@
+BSD 3-Clause License
+
+Copyright (c) 1996-2025, The SLICOT Team (original Fortran77 code)
+Copyright (c) 2025, slicot contributors (C11 translation)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

slicot-1.0.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: slicot
+Version: 1.0.0
+Summary: Python bindings for SLICOT - Subroutine Library in Control Theory
+Keywords: control,systems,linear,lapack,blas,riccati,lyapunov
+Author: SLICOT Contributors
+License-Expression: BSD-3-Clause
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: C
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Project-URL: Homepage, https://github.com/jamestjsp/slicot
+Project-URL: Documentation, https://slicot.github.io/
+Project-URL: Repository, https://github.com/jamestjsp/slicot
+Project-URL: Issues, https://github.com/jamestjsp/slicot/issues
+Requires-Python: >=3.11
+Requires-Dist: numpy>=2.0
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-xdist; extra == "test"
+Requires-Dist: pytest-rerunfailures; extra == "test"
+Requires-Dist: scipy; extra == "test"
+Description-Content-Type: text/markdown
+
+# SLICOT
+
+[![PyPI version](https://badge.fury.io/py/slicot.svg)](https://badge.fury.io/py/slicot)
+[![Build Status](https://github.com/jamestjsp/slicot/actions/workflows/test.yml/badge.svg)](https://github.com/jamestjsp/slicot/actions)
+[![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](LICENSE)
+
+Python bindings for **SLICOT** (Subroutine Library In COntrol Theory) - numerical routines for control systems analysis and design.
+
+## Installation
+
+```bash
+pip install slicot
+```
+
+## Features
+
+- **600+ routines** for control systems
+- **State-space methods**: Riccati, Lyapunov, pole placement
+- **Model reduction**: Balance & Truncate, Hankel-norm
+- **System identification**: MOESP, N4SID
+- **NumPy integration**: Column-major arrays
+
+## Quick Start
+
+```python
+import numpy as np
+import slicot
+
+# Controllability analysis
+A = np.array([[1, 2], [3, 4]], order='F')
+B = np.array([[1], [0]], order='F')
+
+a_out, b_out, ncont, z, tau, info = slicot.ab01md('I', A, B.flatten(), 0.0)
+print(f"Controllable dimension: {ncont}")
+```
+
+## Column-Major Arrays
+
+SLICOT uses Fortran conventions:
+
+```python
+A = np.array([[1, 2], [3, 4]], order='F')  # Required!
+```
+
+## License
+
+BSD-3-Clause. See [LICENSE](LICENSE).

slicot-1.0.0/README.md

@@ -0,0 +1,47 @@
+# SLICOT
+
+[![PyPI version](https://badge.fury.io/py/slicot.svg)](https://badge.fury.io/py/slicot)
+[![Build Status](https://github.com/jamestjsp/slicot/actions/workflows/test.yml/badge.svg)](https://github.com/jamestjsp/slicot/actions)
+[![License: BSD-3-Clause](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](LICENSE)
+
+Python bindings for **SLICOT** (Subroutine Library In COntrol Theory) - numerical routines for control systems analysis and design.
+
+## Installation
+
+```bash
+pip install slicot
+```
+
+## Features
+
+- **600+ routines** for control systems
+- **State-space methods**: Riccati, Lyapunov, pole placement
+- **Model reduction**: Balance & Truncate, Hankel-norm
+- **System identification**: MOESP, N4SID
+- **NumPy integration**: Column-major arrays
+
+## Quick Start
+
+```python
+import numpy as np
+import slicot
+
+# Controllability analysis
+A = np.array([[1, 2], [3, 4]], order='F')
+B = np.array([[1], [0]], order='F')
+
+a_out, b_out, ncont, z, tau, info = slicot.ab01md('I', A, B.flatten(), 0.0)
+print(f"Controllable dimension: {ncont}")
+```
+
+## Column-Major Arrays
+
+SLICOT uses Fortran conventions:
+
+```python
+A = np.array([[1, 2], [3, 4]], order='F')  # Required!
+```
+
+## License
+
+BSD-3-Clause. See [LICENSE](LICENSE).