cicwave 0.5.0__tar.gz

cicwave-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020-2026 Carsten Wulff Software, Norway
+
+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.

cicwave-0.5.0/PKG-INFO

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: cicwave
+Version: 0.5.0
+Summary: Advanced waveform viewer with PyQtGraph backend
+Author-email: Carsten Wulff <carsten@wulff.no>
+License: MIT
+Project-URL: Homepage, https://github.com/wulffern/cicwave
+Project-URL: Bug Tracker, https://github.com/wulffern/cicwave/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Utilities
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: matplotlib
+Requires-Dist: click
+Requires-Dist: pyyaml
+Requires-Dist: PySide6
+Requires-Dist: pyqtgraph
+Requires-Dist: PyOpenGL
+Provides-Extra: parquet
+Requires-Dist: pyarrow; extra == "parquet"
+Provides-Extra: hdf5
+Requires-Dist: tables; extra == "hdf5"
+Dynamic: license-file
+
+# cicwave
+
+Waveform viewer with PyQtGraph backend for high-performance visualization of simulation data.
+
+cicwave is a standalone package extracted from
+[cicsim](https://github.com/wulffern/cicsim), focused on providing the 
+best possible waveform viewing experience with PyQtGraph and Qt6.
+
+## Background
+
+I made my first waveform viewer (<https://github.com/wulffern/NextGenLab.Chart>)
+back in 2001 during a summer internship. NextGenLab.Chart evolved into
+<https://github.com/wulffern/SystemDotNet.Report> during my Ph.D. In I always
+had in my plan to port SdnReport to Mac and Linux, but I never really did (no
+coding time). 
+
+In December 2023 I needed a waveform viewer for cicsim (read ngspice raw files),
+so I wrote one by hand. It was pretty basic. 
+
+Enter March 2026, and the advent of agentic coding. It was finally possible to
+revive SdnReport in the form of a Qt port to cicwave. Initially it lived inside
+cicsim, however, in May 2026 it became clear that cicwave deserved it's own
+repo. As such, you're here. 
+
+## Features
+
+- **High-performance rendering** with PyQtGraph and GPU acceleration
+- **Multiple file format support**: 
+  - ngspice `.raw` files
+  - CSV, TSV, Excel spreadsheets
+  - Parquet, HDF5, Feather for big data
+  - VCD digital waveforms 
+  - LitePoint `.iqvsa` IQ capture files
+- **Multi-dimensional data pivoting** with YAML specifications
+- **Digital waveform support** with separate analog/digital panes  
+- **Session save/restore** with `.cicwave.yaml` files
+- **Export capabilities** to PDF, PNG, SVG formats
+- **Engineering unit formatting** and auto-detection
+- **GPU-accelerated plotting** for smooth interaction with large datasets
+
+## Installation
+
+```bash
+pip install cicwave
+```
+
+For development installation:
+
+```bash
+git clone https://github.com/wulffern/cicwave.git
+cd cicwave
+pip install -e .
+```
+
+## Usage
+
+### Basic Usage
+
+Open waveform files directly:
+
+```bash
+# Single file
+cicwave data.raw
+
+# Multiple files  
+cicwave sim1.csv sim2.csv results.xlsx
+
+# Glob patterns (useful on PowerShell)
+cicwave --glob "results/*.csv" --glob "**/*.raw"
+```
+
+### Advanced Features
+
+**Multi-dimensional data reshaping:**
+```bash
+cicwave --pivot analysis.yaml dataset.csv
+```
+
+**Session management:**
+```bash
+# Save your current plot configuration in the GUI (File → Save Session)
+cicwave --session my_analysis.cicwave.yaml
+
+# Export plots without opening GUI
+cicwave --session config.yaml --export results.pdf
+```
+
+**Data exploration:**
+```bash
+# Preview pivot dimensions before plotting
+cicwave --pivot spec.yaml --pivot-info data.csv
+```
+
+## File Format Support
+
+| Format | Extension | Description |
+|--------|-----------|-------------|
+| ngspice | `.raw` | Binary simulation results |
+| CSV/TSV | `.csv`, `.tsv` | Comma/tab separated values |
+| Excel | `.xlsx` | Spreadsheet format |
+| Parquet | `.parquet` | Columnar storage (requires `pip install pyarrow`) |
+| HDF5 | `.h5` | Hierarchical data (requires `pip install tables`) |
+| VCD | `.vcd` | Digital simulation waveforms |
+| LitePoint | `.iqvsa` | IQ capture data |
+
+## Environment Variables
+
+- `CICWAVE_X` - Default X-axis column name
+
+## GUI Features
+
+### Waveform Interaction
+- **Mouse wheel**: Zoom in/out
+- **Middle click + drag**: Pan
+- **Right click**: Context menu with analysis tools
+- **Ctrl+A**: Auto-fit all waveforms
+- **Ctrl+Mouse wheel**: Zoom X-axis only
+
+### Analysis Tools
+- **Cursors**: Measure time/voltage differences
+- **Math expressions**: Create derived signals  
+- **Digital analysis**: View bus values and timing
+- **Export data**: Save currently visible waveforms
+
+### Session Management
+- **File → Save Session**: Save current plot configuration
+- **File → Load Session**: Restore previous analysis
+- Sessions store: visible signals, zoom levels, cursor positions, analysis setup
+
+## Pivot Specifications
+
+For multi-dimensional datasets, use YAML pivot specs to reshape data before visualization:
+
+```yaml
+# analysis.yaml
+index: time          # X-axis (rows)
+columns: [corner, temperature]  # Create separate traces for each combination  
+values: ["v(out)", "v(in)"]     # Y-axis signals to plot
+conditions:          # Filter data
+  frequency: 1e9
+  process: tt
+```
+
+```bash
+cicwave --pivot analysis.yaml monte_carlo_results.csv
+```
+
+## Migrating from cicsim
+
+If you previously used `cicsim wave` or the standalone `cicwave` from cicsim:
+
+1. **Install standalone cicwave**: `pip install cicwave`
+2. **Update workflows**: Replace `cicsim wave --backend pg` with just `cicwave`
+3. **Session files**: Existing `.cicwave.yaml` files are fully compatible
+4. **Tkinter users**: `cicsim wave --backend tk` still works in cicsim for lightweight usage
+
+## Development
+
+### Running Tests
+
+```bash
+# Run all unit tests
+python -m unittest discover -s tests/unittests/ -p 'test_*.py' -v
+
+# Test specific functionality
+python -m unittest tests.unittests.test_wavefiles_lazy -v
+```
+
+### Project Structure
+
+```
+cicwave/
+├── src/cicwave/
+│   ├── cli.py          # Command-line interface
+│   ├── wave_pg.py      # Main PyQtGraph viewer
+│   ├── wavefiles.py    # File I/O and data loading
+│   ├── ngraw.py        # ngspice binary parser  
+│   ├── pivot.py        # Data reshaping
+│   ├── theme.py        # Color themes
+│   └── command.py      # Logging utilities
+├── tests/unittests/    # Unit test suite
+└── scripts/            # Windows shortcut generator
+```
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Contributing
+
+Contributions welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new functionality  
+4. Ensure all tests pass
+5. Submit a pull request
+
+## Related Projects
+
+- **[cicsim](https://github.com/wulffern/cicsim)** - Simulation orchestration and lightweight tkinter viewer
+- **[cicpy](https://github.com/wulffern/cicpy)** - Analog IC design transpiler 
+- **[PyQtGraph](https://pyqtgraph.readthedocs.io/)** - High-performance plotting library

cicwave-0.5.0/README.md

@@ -0,0 +1,203 @@
+# cicwave
+
+Waveform viewer with PyQtGraph backend for high-performance visualization of simulation data.
+
+cicwave is a standalone package extracted from
+[cicsim](https://github.com/wulffern/cicsim), focused on providing the 
+best possible waveform viewing experience with PyQtGraph and Qt6.
+
+## Background
+
+I made my first waveform viewer (<https://github.com/wulffern/NextGenLab.Chart>)
+back in 2001 during a summer internship. NextGenLab.Chart evolved into
+<https://github.com/wulffern/SystemDotNet.Report> during my Ph.D. In I always
+had in my plan to port SdnReport to Mac and Linux, but I never really did (no
+coding time). 
+
+In December 2023 I needed a waveform viewer for cicsim (read ngspice raw files),
+so I wrote one by hand. It was pretty basic. 
+
+Enter March 2026, and the advent of agentic coding. It was finally possible to
+revive SdnReport in the form of a Qt port to cicwave. Initially it lived inside
+cicsim, however, in May 2026 it became clear that cicwave deserved it's own
+repo. As such, you're here. 
+
+## Features
+
+- **High-performance rendering** with PyQtGraph and GPU acceleration
+- **Multiple file format support**: 
+  - ngspice `.raw` files
+  - CSV, TSV, Excel spreadsheets
+  - Parquet, HDF5, Feather for big data
+  - VCD digital waveforms 
+  - LitePoint `.iqvsa` IQ capture files
+- **Multi-dimensional data pivoting** with YAML specifications
+- **Digital waveform support** with separate analog/digital panes  
+- **Session save/restore** with `.cicwave.yaml` files
+- **Export capabilities** to PDF, PNG, SVG formats
+- **Engineering unit formatting** and auto-detection
+- **GPU-accelerated plotting** for smooth interaction with large datasets
+
+## Installation
+
+```bash
+pip install cicwave
+```
+
+For development installation:
+
+```bash
+git clone https://github.com/wulffern/cicwave.git
+cd cicwave
+pip install -e .
+```
+
+## Usage
+
+### Basic Usage
+
+Open waveform files directly:
+
+```bash
+# Single file
+cicwave data.raw
+
+# Multiple files  
+cicwave sim1.csv sim2.csv results.xlsx
+
+# Glob patterns (useful on PowerShell)
+cicwave --glob "results/*.csv" --glob "**/*.raw"
+```
+
+### Advanced Features
+
+**Multi-dimensional data reshaping:**
+```bash
+cicwave --pivot analysis.yaml dataset.csv
+```
+
+**Session management:**
+```bash
+# Save your current plot configuration in the GUI (File → Save Session)
+cicwave --session my_analysis.cicwave.yaml
+
+# Export plots without opening GUI
+cicwave --session config.yaml --export results.pdf
+```
+
+**Data exploration:**
+```bash
+# Preview pivot dimensions before plotting
+cicwave --pivot spec.yaml --pivot-info data.csv
+```
+
+## File Format Support
+
+| Format | Extension | Description |
+|--------|-----------|-------------|
+| ngspice | `.raw` | Binary simulation results |
+| CSV/TSV | `.csv`, `.tsv` | Comma/tab separated values |
+| Excel | `.xlsx` | Spreadsheet format |
+| Parquet | `.parquet` | Columnar storage (requires `pip install pyarrow`) |
+| HDF5 | `.h5` | Hierarchical data (requires `pip install tables`) |
+| VCD | `.vcd` | Digital simulation waveforms |
+| LitePoint | `.iqvsa` | IQ capture data |
+
+## Environment Variables
+
+- `CICWAVE_X` - Default X-axis column name
+
+## GUI Features
+
+### Waveform Interaction
+- **Mouse wheel**: Zoom in/out
+- **Middle click + drag**: Pan
+- **Right click**: Context menu with analysis tools
+- **Ctrl+A**: Auto-fit all waveforms
+- **Ctrl+Mouse wheel**: Zoom X-axis only
+
+### Analysis Tools
+- **Cursors**: Measure time/voltage differences
+- **Math expressions**: Create derived signals  
+- **Digital analysis**: View bus values and timing
+- **Export data**: Save currently visible waveforms
+
+### Session Management
+- **File → Save Session**: Save current plot configuration
+- **File → Load Session**: Restore previous analysis
+- Sessions store: visible signals, zoom levels, cursor positions, analysis setup
+
+## Pivot Specifications
+
+For multi-dimensional datasets, use YAML pivot specs to reshape data before visualization:
+
+```yaml
+# analysis.yaml
+index: time          # X-axis (rows)
+columns: [corner, temperature]  # Create separate traces for each combination  
+values: ["v(out)", "v(in)"]     # Y-axis signals to plot
+conditions:          # Filter data
+  frequency: 1e9
+  process: tt
+```
+
+```bash
+cicwave --pivot analysis.yaml monte_carlo_results.csv
+```
+
+## Migrating from cicsim
+
+If you previously used `cicsim wave` or the standalone `cicwave` from cicsim:
+
+1. **Install standalone cicwave**: `pip install cicwave`
+2. **Update workflows**: Replace `cicsim wave --backend pg` with just `cicwave`
+3. **Session files**: Existing `.cicwave.yaml` files are fully compatible
+4. **Tkinter users**: `cicsim wave --backend tk` still works in cicsim for lightweight usage
+
+## Development
+
+### Running Tests
+
+```bash
+# Run all unit tests
+python -m unittest discover -s tests/unittests/ -p 'test_*.py' -v
+
+# Test specific functionality
+python -m unittest tests.unittests.test_wavefiles_lazy -v
+```
+
+### Project Structure
+
+```
+cicwave/
+├── src/cicwave/
+│   ├── cli.py          # Command-line interface
+│   ├── wave_pg.py      # Main PyQtGraph viewer
+│   ├── wavefiles.py    # File I/O and data loading
+│   ├── ngraw.py        # ngspice binary parser  
+│   ├── pivot.py        # Data reshaping
+│   ├── theme.py        # Color themes
+│   └── command.py      # Logging utilities
+├── tests/unittests/    # Unit test suite
+└── scripts/            # Windows shortcut generator
+```
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Contributing
+
+Contributions welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new functionality  
+4. Ensure all tests pass
+5. Submit a pull request
+
+## Related Projects
+
+- **[cicsim](https://github.com/wulffern/cicsim)** - Simulation orchestration and lightweight tkinter viewer
+- **[cicpy](https://github.com/wulffern/cicpy)** - Analog IC design transpiler 
+- **[PyQtGraph](https://pyqtgraph.readthedocs.io/)** - High-performance plotting library

cicwave-0.5.0/pyproject.toml

@@ -0,0 +1,60 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "cicwave"
+version = "0.5.0"
+authors = [
+  { name="Carsten Wulff", email="carsten@wulff.no" },
+]
+dependencies = [
+    "numpy",           # Core data arrays
+    "pandas",          # DataFrames  
+    "matplotlib",      # Engineering formatters (minimal dependency)
+    "click",           # CLI parsing
+    "pyyaml",          # Session files, pivot specs
+    "PySide6",         # Qt6 GUI framework  
+    "pyqtgraph",       # High-performance plotting
+    "PyOpenGL",        # GPU acceleration
+]
+description = "Advanced waveform viewer with PyQtGraph backend"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Natural Language :: English",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Utilities",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)",
+    "Topic :: Scientific/Engineering :: Visualization",
+]
+
+[project.optional-dependencies]  
+parquet = ["pyarrow"]     # Parquet file support
+hdf5 = ["tables"]         # HDF5 file support
+
+[project.scripts]
+cicwave = "cicwave.cli:main"
+
+[project.gui-scripts]  
+cicwavew = "cicwave.cli:main"  # Windows no-console wrapper
+
+[project.urls]
+"Homepage" = "https://github.com/wulffern/cicwave"
+"Bug Tracker" = "https://github.com/wulffern/cicwave/issues"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

cicwave-0.5.0/setup.cfg

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

cicwave-0.5.0/src/cicwave/__init__.py

@@ -0,0 +1,25 @@
+"""
+cicwave - Advanced waveform viewer with PyQtGraph backend
+
+A standalone waveform viewer extracted from cicsim, focused on providing
+high-performance visualization of simulation data with PyQtGraph and Qt6.
+
+Supports multiple file formats:
+- ngspice .raw files
+- CSV, TSV, Excel 
+- Parquet, HDF5, Feather
+- VCD digital waveforms
+- LitePoint .iqvsa IQ capture files
+
+Features:
+- GPU-accelerated rendering with PyQtGraph
+- Multi-dimensional data pivoting
+- Session save/restore
+- Export to PDF/PNG/SVG
+- Digital waveform support
+- Engineering unit formatting
+"""
+
+__version__ = "1.0.0"
+__author__ = "Carsten Wulff"
+__email__ = "carsten@wulff.no"