add python

Author: wq2012

.github/workflows/python.yml

@@ -0,0 +1,24 @@
+name: Python CI
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python 3.10
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.10"
+    
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+        # Install local package
+        pip install -e .
+        
+    - name: Run tests
+      run: |
+        pytest python/tests

.gitignore

@@ -1 +1,5 @@
 *.mex
+*egg-info*
+*.pyc
+dist/*
+python/dist/*

MANIFEST.in

@@ -0,0 +1,4 @@
+include requirements.txt
+include README.md
+include license.txt
+global-include *.txt

README.md

@@ -2,6 +2,7 @@
 
 [![View COSBOS: COlor-Sensor-Based Occupancy Sensing on File Exchange](https://www.mathworks.com/matlabcentral/images/matlab-file-exchange.svg)](https://www.mathworks.com/matlabcentral/fileexchange/48428-cosbos-color-sensor-based-occupancy-sensing)
 [![Octave application](https://github.com/wq2012/COSBOS/actions/workflows/octave.yml/badge.svg)](https://github.com/wq2012/COSBOS/actions/workflows/octave.yml)
+[![Python CI](https://github.com/wq2012/COSBOS/actions/workflows/python.yml/badge.svg)](https://github.com/wq2012/COSBOS/actions/workflows/python.yml)
 
 ![logo](resources/logo.png)
 
@@ -89,6 +90,51 @@ run_tests;
 ```
 This verifies LTM recovery accuracy, MEX script correctness, and model performance.
 
+## Python Package
+
+COSBOS is also available as a Python package `cosbos`. It provides pure Python implementations of the core algorithms (Reflection Model, Blockage Model, LTM Recovery).
+
+### Installation
+
+```bash
+pip install cosbos
+```
+
+### Usage
+
+```python
+from cosbos import reflection, blockage, ltm
+import numpy as np
+
+# Reflection Model
+# Calculate reflection kernel for a light-sensor pair
+# light: [x, y, z], sensor: [x, y, z], dim: [dx, dy, dz]
+K = reflection.getReflectionKernel(light=[75, 22.5, 86.4], 
+                                   sensor=[66, 22, 86.4], 
+                                   dim=[87, 136, 88], 
+                                   para=1)
+
+# Blockage Model
+# Hash Gaussians for occupancy volume
+# sensors: [N, 3], lights: [M, 3]
+H = blockage.hashGaussians(sensors, lights, dim, sigma=2.0)
+# Reconstruct volume
+V = blockage.volumeFromHashing(sensors, lights, dim, H, E)
+
+# LTM Recovery
+# Recover matrix A from measurements Y and training data X
+# X: [m, N], Y: [l, N] (m: features, l: sensors, N: samples)
+A = ltm.solve_A_1norm(X, Y)
+```
+
+### Development
+To run tests locally:
+```bash
+cd python
+pip install -e .
+pytest tests/
+```
+
 ## Citation
 If you use this work in your research, please cite:
 

publish_pypi.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+set -e
+
+# Clean previous builds
+rm -rf dist/ build/ *.egg-info/ src/*.egg-info/ python/*.egg-info/
+
+# Install build dependencies
+pip install build twine
+
+# Build package
+python -m build
+
+# Check distribution
+twine check dist/*
+
+# Upload to PyPI
+# Expects TWINE_USERNAME and TWINE_PASSWORD env vars, or interactive prompt
+twine upload dist/*

pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"

python/cosbos/__init__.py

@@ -0,0 +1,5 @@
+from . import ltm
+from . import blockage
+from . import reflection
+
+__all__ = ["ltm", "blockage", "reflection"]