pycudal 1.0.0__tar.gz

pycudal-1.0.0/LICENSE

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

pycudal-1.0.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md LICENSE requirements.txt
+include cudal/logo.png
+recursive-include assets *
+recursive-include extras *.py
+recursive-include tests *.py
+prune build
+prune dist

pycudal-1.0.0/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: pycudal
+Version: 1.0.0
+Summary: Parametric acceptance limits for USP <905> Content Uniformity and USP <711> Dissolution (mirrors SAS CALCUSPx/CALDISPx, EVCUSPx/EVDISPx, SMPCUSPx/SMPDISPx).
+Author-email: Moaz El-Essawey <moazelessawey@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Moaz El-Essawey
+        
+        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.
+Project-URL: Homepage, https://github.com/moazelessawey/cudal
+Project-URL: Repository, https://github.com/moazelessawey/cudal
+Project-URL: Issues, https://github.com/moazelessawey/cudal/issues
+Keywords: USP,content uniformity,dissolution,acceptance limits,pharmacopeia
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy==2.5.2
+Requires-Dist: pandas==3.0.5
+Requires-Dist: scipy==1.18.1
+Provides-Extra: plot
+Requires-Dist: matplotlib==3.11.1; extra == "plot"
+Provides-Extra: xlsx
+Requires-Dist: openpyxl==3.1.5; extra == "xlsx"
+Provides-Extra: pdf
+Requires-Dist: reportlab==5.0.1; extra == "pdf"
+Provides-Extra: qt
+Requires-Dist: PySide6==6.11.2; extra == "qt"
+Requires-Dist: matplotlib==3.11.1; extra == "qt"
+Provides-Extra: all
+Requires-Dist: matplotlib==3.11.1; extra == "all"
+Requires-Dist: openpyxl==3.1.5; extra == "all"
+Requires-Dist: reportlab==5.0.1; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pyinstaller; extra == "dev"
+Dynamic: license-file
+
+# CuDAL
+
+<p align="center">
+  <img src="assets/logo.png" alt="CuDAL logo" width="120"/>
+</p>
+
+**Parametric acceptance limits for USP <905> Content Uniformity and USP <711> Dissolution** —
+a Python re-implementation of the SAS programs `CALCUSP1/2`, `CALDISP1/2`,
+`EVCUSP1/2`, `EVDISP1/2`, `SMPCUSP1/2`, `SMPDISP1/2`, with a CLI and two GUIs.
+
+[![CI](https://github.com/moazelessawey/cudal/actions/workflows/ci.yml/badge.svg)](https://github.com/moazelessawey/cudal/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/cudal.svg)](https://pypi.org/project/cudal/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Release](https://img.shields.io/github/v/release/moazelessawey/cudal)](https://github.com/moazelessawey/cudal/releases)
+
+---
+
+## Features
+
+- **Computations (`cudal` package)**
+  - Content Uniformity – Sampling Plans 1 & 2 (`cusp1`, `cusp2`)
+  - Dissolution – Sampling Plans 1 & 2 (`disp1`, `disp2`)
+  - Three analysis modes each: acceptance-limit table, probability of passing, sample probability
+- **CLI** – `python -m cudal.cli` (or installed command `cudal`)
+- **Tkinter GUI** (`cudal-gui`, stdlib-only → tiny install): 4 tabs × 3 modes,
+  background threads with progress, scrollable parameters, live validation,
+  sortable/colored results table, CSV export, modal matplotlib plots
+  (lines + cubic spline, heatmap with 80/90 % contours), SAS-style **PDF listings**
+  (Courier, column wrapping, repeated page headers), XLSX export, settings persistence
+- **Optional PySide6 GUI** (`extras/cudal_gui_pyside6.py`) – modern Qt theme,
+  kept *outside* the package so the pip install stays small
+
+## Repository layout
+
+```
+cudal/            library: computations + CLI + Tk GUI (+ logo package data)
+extras/           optional PySide6 GUI (not installed)
+tests/            pytest smoke tests
+scripts/          local exe build helper
+.github/          CI, PyPI publish, exe release workflows
+```
+
+## Installation
+
+Requires Python ≥ 3.9.
+
+```bash
+# from GitHub
+pip install git+https://github.com/moazelessawey/cudal.git
+
+# from a source checkout
+pip install .            # core (numpy/pandas/scipy) + CLI + Tk GUI
+pip install .[all]       # + matplotlib, openpyxl, reportlab (plots/exports)
+pip install .[qt]        # + PySide6 for the optional Qt GUI
+pip install .[dev]       # + pytest, pyinstaller
+```
+
+| Extra   | Adds                          |
+|---------|-------------------------------|
+| `plot`  | matplotlib (plots)            |
+| `xlsx`  | openpyxl (Excel export)       |
+| `pdf`   | reportlab (PDF listings)      |
+| `qt`    | PySide6 (+matplotlib) Qt GUI  |
+| `all`   | plot + xlsx + pdf             |
+| `dev`   | pytest + pyinstaller          |
+
+## Quick start
+
+### Python API
+
+```python
+from cudal import cusp1
+
+table = cusp1.acceptance_limit_table(10, 100.0, 95.0, 95.0, 85.1, 114.9, 0.5)
+print(table)
+```
+
+### CLI
+
+```bash
+cudal --help                 # installed console script
+python -m cudal.cli --help   # module form
+python -m cudal --help       # package __main__
+```
+
+The CLI covers the same four scenarios × three modes as the GUIs
+(see `--help` for the exact option names).
+
+### Tkinter GUI (included, stdlib-only)
+
+```bash
+cudal-gui                 # after pip install
+python cudal_gui.py       # from a source checkout
+```
+
+### Optional PySide6 GUI (extra file, not installed)
+
+```bash
+pip install .[qt]
+python extras/cudal_gui_pyside6.py
+```
+
+## Result exports
+
+- **CSV** – one click per table
+- **XLSX** – File → *Export all results* (one sheet per tab)
+- **PDF** – SAS-listing style: Courier, centered title block, Plan‑1 row-wrapped
+  blocks, Plan‑2 SE×SM LL/UL matrix, 2 dp right-aligned numbers, `*` for NaN,
+  **title + table headers repeated on every page**
+- **Plots** – lines + cubic spline, or heatmap with 80/90 % threshold contours; Save PNG
+
+## Building standalone executables
+
+Locally (Windows):
+
+```bat
+scripts\build_exe.bat
+```
+
+or manually:
+
+```bat
+pip install .[all,qt] pyinstaller
+pyinstaller --onefile --noconsole --name CuDAL    --add-data "cudal\logo.png;cudal" cudal_gui.py
+pyinstaller --onefile --noconsole --name CuDAL-Qt --add-data "cudal\logo.png;cudal" extras\cudal_gui_pyside6.py
+```
+
+On every **GitHub Release**, the `build-exe.yml` workflow builds
+`CuDAL.exe` and `CuDAL-Qt.exe` and attaches them to the release automatically.
+
+## Releasing & publishing
+
+1. Bump `cudal/__version__` and commit.
+2. Create a tag & GitHub release: `git tag v1.0.0 && git push origin v1.0.0`
+   (or use *Releases → Draft new release* in the UI).
+3. Actions then:
+   - build & attach the Windows executables to the release,
+   - build the wheel/sdist and publish to PyPI (`publish.yml`).
+
+## Development
+
+```bash
+pip install -e .[all,dev]
+pytest -q
+python -m cudal.gui --selftest
+```
+
+## License & disclaimer
+
+MIT — see [LICENSE](LICENSE).
+
+This software is provided for research/informational use. It does **not**
+constitute regulatory advice; validate any output against your own
+reference implementation before use in a GMP environment.

pycudal-1.0.0/README.md

@@ -0,0 +1,154 @@
+# CuDAL
+
+<p align="center">
+  <img src="assets/logo.png" alt="CuDAL logo" width="120"/>
+</p>
+
+**Parametric acceptance limits for USP <905> Content Uniformity and USP <711> Dissolution** —
+a Python re-implementation of the SAS programs `CALCUSP1/2`, `CALDISP1/2`,
+`EVCUSP1/2`, `EVDISP1/2`, `SMPCUSP1/2`, `SMPDISP1/2`, with a CLI and two GUIs.
+
+[![CI](https://github.com/moazelessawey/cudal/actions/workflows/ci.yml/badge.svg)](https://github.com/moazelessawey/cudal/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/cudal.svg)](https://pypi.org/project/cudal/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Release](https://img.shields.io/github/v/release/moazelessawey/cudal)](https://github.com/moazelessawey/cudal/releases)
+
+---
+
+## Features
+
+- **Computations (`cudal` package)**
+  - Content Uniformity – Sampling Plans 1 & 2 (`cusp1`, `cusp2`)
+  - Dissolution – Sampling Plans 1 & 2 (`disp1`, `disp2`)
+  - Three analysis modes each: acceptance-limit table, probability of passing, sample probability
+- **CLI** – `python -m cudal.cli` (or installed command `cudal`)
+- **Tkinter GUI** (`cudal-gui`, stdlib-only → tiny install): 4 tabs × 3 modes,
+  background threads with progress, scrollable parameters, live validation,
+  sortable/colored results table, CSV export, modal matplotlib plots
+  (lines + cubic spline, heatmap with 80/90 % contours), SAS-style **PDF listings**
+  (Courier, column wrapping, repeated page headers), XLSX export, settings persistence
+- **Optional PySide6 GUI** (`extras/cudal_gui_pyside6.py`) – modern Qt theme,
+  kept *outside* the package so the pip install stays small
+
+## Repository layout
+
+```
+cudal/            library: computations + CLI + Tk GUI (+ logo package data)
+extras/           optional PySide6 GUI (not installed)
+tests/            pytest smoke tests
+scripts/          local exe build helper
+.github/          CI, PyPI publish, exe release workflows
+```
+
+## Installation
+
+Requires Python ≥ 3.9.
+
+```bash
+# from GitHub
+pip install git+https://github.com/moazelessawey/cudal.git
+
+# from a source checkout
+pip install .            # core (numpy/pandas/scipy) + CLI + Tk GUI
+pip install .[all]       # + matplotlib, openpyxl, reportlab (plots/exports)
+pip install .[qt]        # + PySide6 for the optional Qt GUI
+pip install .[dev]       # + pytest, pyinstaller
+```
+
+| Extra   | Adds                          |
+|---------|-------------------------------|
+| `plot`  | matplotlib (plots)            |
+| `xlsx`  | openpyxl (Excel export)       |
+| `pdf`   | reportlab (PDF listings)      |
+| `qt`    | PySide6 (+matplotlib) Qt GUI  |
+| `all`   | plot + xlsx + pdf             |
+| `dev`   | pytest + pyinstaller          |
+
+## Quick start
+
+### Python API
+
+```python
+from cudal import cusp1
+
+table = cusp1.acceptance_limit_table(10, 100.0, 95.0, 95.0, 85.1, 114.9, 0.5)
+print(table)
+```
+
+### CLI
+
+```bash
+cudal --help                 # installed console script
+python -m cudal.cli --help   # module form
+python -m cudal --help       # package __main__
+```
+
+The CLI covers the same four scenarios × three modes as the GUIs
+(see `--help` for the exact option names).
+
+### Tkinter GUI (included, stdlib-only)
+
+```bash
+cudal-gui                 # after pip install
+python cudal_gui.py       # from a source checkout
+```
+
+### Optional PySide6 GUI (extra file, not installed)
+
+```bash
+pip install .[qt]
+python extras/cudal_gui_pyside6.py
+```
+
+## Result exports
+
+- **CSV** – one click per table
+- **XLSX** – File → *Export all results* (one sheet per tab)
+- **PDF** – SAS-listing style: Courier, centered title block, Plan‑1 row-wrapped
+  blocks, Plan‑2 SE×SM LL/UL matrix, 2 dp right-aligned numbers, `*` for NaN,
+  **title + table headers repeated on every page**
+- **Plots** – lines + cubic spline, or heatmap with 80/90 % threshold contours; Save PNG
+
+## Building standalone executables
+
+Locally (Windows):
+
+```bat
+scripts\build_exe.bat
+```
+
+or manually:
+
+```bat
+pip install .[all,qt] pyinstaller
+pyinstaller --onefile --noconsole --name CuDAL    --add-data "cudal\logo.png;cudal" cudal_gui.py
+pyinstaller --onefile --noconsole --name CuDAL-Qt --add-data "cudal\logo.png;cudal" extras\cudal_gui_pyside6.py
+```
+
+On every **GitHub Release**, the `build-exe.yml` workflow builds
+`CuDAL.exe` and `CuDAL-Qt.exe` and attaches them to the release automatically.
+
+## Releasing & publishing
+
+1. Bump `cudal/__version__` and commit.
+2. Create a tag & GitHub release: `git tag v1.0.0 && git push origin v1.0.0`
+   (or use *Releases → Draft new release* in the UI).
+3. Actions then:
+   - build & attach the Windows executables to the release,
+   - build the wheel/sdist and publish to PyPI (`publish.yml`).
+
+## Development
+
+```bash
+pip install -e .[all,dev]
+pytest -q
+python -m cudal.gui --selftest
+```
+
+## License & disclaimer
+
+MIT — see [LICENSE](LICENSE).
+
+This software is provided for research/informational use. It does **not**
+constitute regulatory advice; validate any output against your own
+reference implementation before use in a GMP environment.

pycudal-1.0.0/cudal/__init__.py

@@ -0,0 +1,21 @@
+"""
+CuDAL -- Content Uniformity and Dissolution Acceptance Limits
+
+Python translation of the legacy SAS/AF application (CuDAL.sas, cusp1.sas,
+Cusp2.sas, Disp1.sas, Disp2.sas) used to derive parametric (tolerance
+interval) acceptance limits for the USP <905> Content Uniformity and
+USP <711> Dissolution tests.
+
+Modules
+-------
+core   : shared probability primitives (content_uniformity_bound, dissolution_bound)
+cusp1  : Content Uniformity, Sampling Plan 1 (single location)
+cusp2  : Content Uniformity, Sampling Plan 2 (multiple locations)
+disp1  : Dissolution, Sampling Plan 1 (single location)
+disp2  : Dissolution, Sampling Plan 2 (multiple locations)
+"""
+
+from . import core, cusp1, cusp2, disp1, disp2
+
+__version__ = "1.0.0"
+__all__ = ["core", "cusp1", "cusp2", "disp1", "disp2"]

pycudal-1.0.0/cudal/__main__.py

@@ -0,0 +1,5 @@
+"""Enables `python -m cudal` (same as `python -m cudal.cli`)."""
+from cudal.cli import main
+
+if __name__ == "__main__":
+    main()