SCPI-Instrument-Control 1.0.0__py3-none-any.whl

scpi_instrument_control-1.0.0.dist-info/METADATA

@@ -0,0 +1,918 @@
+Metadata-Version: 2.4
+Name: SCPI-Instrument-Control
+Version: 1.0.0
+Summary: Universal Python library for controlling SCPI-compatible test equipment via Ethernet/LAN. Supports oscilloscopes (Siglent SDS series, generic SCPI scopes), function generators/AWGs (Siglent SDG series, generic SCPI AWGs), and power supplies (Siglent SPD series, generic SCPI PSUs). Features include waveform capture, measurements, FFT analysis, PyQt6 GUI, automated report generation with AI analysis, and comprehensive SCPI command abstraction.
+Author: Robin Mumm
+Maintainer: little-did-I-know
+License: MIT
+Project-URL: Homepage, https://github.com/little-did-I-know/SCPI-Instrument-Control
+Project-URL: Documentation, https://little-did-I-know.github.io/SCPI-Instrument-Control/
+Project-URL: Repository, https://github.com/little-did-I-know/SCPI-Instrument-Control
+Project-URL: Issues, https://github.com/little-did-I-know/SCPI-Instrument-Control/issues
+Project-URL: Changelog, https://github.com/little-did-I-know/SCPI-Instrument-Control/blob/main/CHANGELOG.md
+Keywords: SCPI,instrument control,test equipment,oscilloscope,function generator,AWG,power supply,PSU,siglent,SDS,SDG,SPD,IEEE 488.2,waveform,signal generator,laboratory,automation,measurement,data acquisition,lab automation,PyQt6,GUI,FFT,protocol decoder,I2C,SPI,UART,visualization,voltage,current,frequency,waveform generator,waveform,test equipment,lab equipment
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Manufacturing
+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: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Interface Engine/Protocol Translator
+Classifier: Topic :: System :: Hardware :: Hardware Drivers
+Classifier: Topic :: System :: Networking :: Monitoring
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: matplotlib>=3.7.0
+Requires-Dist: scipy>=1.10.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: codecov>=2.1.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: flake8>=6.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: black[jupyter]>=23.0; extra == "dev"
+Provides-Extra: hdf5
+Requires-Dist: h5py>=3.8.0; extra == "hdf5"
+Provides-Extra: gui
+Requires-Dist: PyQt6>=6.6.0; extra == "gui"
+Requires-Dist: PyQt6-WebEngine>=6.6.0; extra == "gui"
+Requires-Dist: pyqtgraph>=0.13.0; extra == "gui"
+Provides-Extra: fun
+Requires-Dist: shapely>=2.0.0; extra == "fun"
+Requires-Dist: Pillow>=10.0.0; extra == "fun"
+Requires-Dist: svgpathtools>=1.6.0; extra == "fun"
+Provides-Extra: report-generator
+Requires-Dist: PyQt6>=6.6.0; extra == "report-generator"
+Requires-Dist: Pillow>=10.0.0; extra == "report-generator"
+Requires-Dist: requests>=2.31.0; extra == "report-generator"
+Requires-Dist: reportlab>=4.0.0; extra == "report-generator"
+Requires-Dist: ollama>=0.6.0; extra == "report-generator"
+Provides-Extra: power-supply-beta
+Provides-Extra: usb
+Requires-Dist: pyvisa>=1.14.0; extra == "usb"
+Requires-Dist: pyvisa-py>=0.7.0; extra == "usb"
+Provides-Extra: experimental
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5.0; extra == "docs"
+Requires-Dist: mkdocs-material>=9.5.0; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24.0; extra == "docs"
+Requires-Dist: mkdocs-gen-files>=0.5.0; extra == "docs"
+Requires-Dist: mkdocs-literate-nav>=0.6.0; extra == "docs"
+Requires-Dist: mkdocs-section-index>=0.3.0; extra == "docs"
+Provides-Extra: build-exe
+Requires-Dist: pyinstaller>=6.0.0; extra == "build-exe"
+Provides-Extra: all
+Requires-Dist: h5py>=3.8.0; extra == "all"
+Requires-Dist: PyQt6>=6.6.0; extra == "all"
+Requires-Dist: PyQt6-WebEngine>=6.6.0; extra == "all"
+Requires-Dist: pyqtgraph>=0.13.0; extra == "all"
+Requires-Dist: shapely>=2.0.0; extra == "all"
+Requires-Dist: Pillow>=10.0.0; extra == "all"
+Requires-Dist: svgpathtools>=1.6.0; extra == "all"
+Requires-Dist: requests>=2.31.0; extra == "all"
+Requires-Dist: reportlab>=4.0.0; extra == "all"
+Requires-Dist: ollama>=0.6.0; extra == "all"
+Dynamic: license-file
+
+# SCPI Instrument Control
+
+> **📦 Package Renamed!** This project was formerly known as `Siglent-Oscilloscope`. See the [Migration Guide](#migration-guide) below for updating your code.
+
+[![CI](https://github.com/little-did-I-know/SCPI-Instrument-Control/actions/workflows/ci.yml/badge.svg)](https://github.com/little-did-I-know/SCPI-Instrument-Control/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/little-did-I-know/SCPI-Instrument-Control/branch/main/graph/badge.svg)](https://codecov.io/gh/little-did-I-know/SCPI-Instrument-Control)
+[![PyPI version](https://img.shields.io/pypi/v/SCPI-Instrument-Control.svg)](https://pypi.org/project/SCPI-Instrument-Control/)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/SCPI-Instrument-Control.svg)](https://pypi.org/project/SCPI-Instrument-Control/)
+[![Python Version](https://img.shields.io/pypi/pyversions/SCPI-Instrument-Control)](https://pypi.org/project/SCPI-Instrument-Control/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![GitHub issues](https://img.shields.io/github/issues/little-did-I-know/SCPI-Instrument-Control)](https://github.com/little-did-I-know/SCPI-Instrument-Control/issues)
+[![GitHub stars](https://img.shields.io/github/stars/little-did-I-know/SCPI-Instrument-Control)](https://github.com/little-did-I-know/SCPI-Instrument-Control/stargazers)
+[![GitHub last commit](https://img.shields.io/github/last-commit/little-did-I-know/SCPI-Instrument-Control)](https://github.com/little-did-I-know/SCPI-Instrument-Control/commits/main)
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-Support-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/little.did.i.know)
+
+A universal Python library for controlling SCPI-compatible test equipment via Ethernet/LAN. Supports oscilloscopes, function generators (AWGs), and power supplies with a comprehensive programmatic API and high-performance PyQt6-based GUI application.
+
+## Features
+
+### Core Features
+
+- **Programmatic API**: Control your oscilloscope from Python scripts
+- **Automation & Data Collection**: High-level API for batch capture, continuous monitoring, and analysis
+- **GUI Application**: Modern PyQt6-based graphical interface
+- **Waveform Acquisition**: Capture and download waveform data in multiple formats (NPZ, CSV, MAT, HDF5)
+- **Channel Configuration**: Control voltage scale, coupling, offset, bandwidth
+- **Trigger Settings**: Configure trigger modes, levels, edge detection
+- **Advanced Analysis**: Built-in FFT, SNR, THD, and statistical analysis tools
+
+### GUI Features (New!)
+
+- **High-Performance Live View**: Real-time waveform display at 1000+ fps using PyQtGraph
+- **Interactive Visual Measurements**: Click-and-drag measurement markers directly on waveforms
+  - 15+ measurement types: Frequency, Vpp, Rise Time, Duty Cycle, etc.
+  - Visual gates and markers with real-time calculation
+  - Save/load measurement configurations
+  - Export results to CSV/JSON
+- **Non-Blocking Updates**: Threaded data acquisition keeps GUI responsive
+- **Reference Waveforms**: Save, overlay, and compare waveforms
+- **Protocol Decoding**: I2C, SPI, UART, CAN, LIN support
+- **Math Functions**: Custom math expressions on waveforms
+- **VNC Display**: Embedded oscilloscope screen viewer
+
+### Automated Test Report Generation 📊
+
+**Automatically generate comprehensive PDF and Markdown test reports** from your waveform captures with detailed analysis, visualizations, and AI-powered insights. Perfect for documentation, test validation, and automated quality control.
+
+```python
+# Install report generator dependencies
+# pip install "SCPI-Instrument-Control[report-generator]"
+
+from scpi_control.report_generator import ReportGenerator, PDFGenerator, MarkdownGenerator
+from pathlib import Path
+
+# Create a report generator
+report = ReportGenerator(
+    title="Probe Calibration Test Report",
+    test_id="CAL-2024-001",
+    operator="Lab Technician"
+)
+
+# Add waveform captures
+waveform = scope.get_waveform(channel=1)
+report.add_waveform(waveform, channel_number=1, name="Calibration Signal")
+
+# Automatic signal analysis
+waveform.analyze()  # Auto-detects signal type, calculates 25+ statistics
+
+# Optional: Add AI insights (requires Ollama)
+report.set_ai_model("llama3.2")  # Local LLM analysis
+
+# Generate reports in multiple formats
+pdf_gen = PDFGenerator(report_data=report.data)
+pdf_gen.generate(Path("calibration_report.pdf"))
+
+markdown_gen = MarkdownGenerator(report_data=report.data)
+markdown_gen.generate(Path("calibration_report.md"))
+```
+
+**Key Features:**
+
+- ✅ **Automatic Signal Detection** - FFT-based classification (sine, square, triangle, pulse, etc.)
+- ✅ **Comprehensive Statistics** - 25+ parameters including Vpp, RMS, frequency, SNR, THD, jitter, overshoot
+- ✅ **AI-Powered Analysis** - Optional LLM integration via Ollama for intelligent waveform insights
+- ✅ **Region Extraction** - Zoom into plateaus, edges, and transients with calibration guidance
+- ✅ **Multiple Formats** - Generate PDF and Markdown reports with embedded plots
+- ✅ **Professional Layout** - Publication-ready reports with metadata, statistics tables, and visualizations
+
+**Report Sections Include:**
+
+- Test metadata (title, ID, operator, timestamp, scope model)
+- Waveform plots with automatic scaling
+- Signal classification and characteristics
+- Detailed measurement tables
+- Region-of-interest analysis with zoomed views
+- AI-generated insights and recommendations (optional)
+- Pass/fail criteria and test conclusions
+
+See `examples/probe_calibration_analysis.py` for complete examples including region extraction and automated probe compensation guidance.
+
+### Vector Graphics / XY Mode (Fun! 🎨)
+
+Use your oscilloscope as a vector display by generating waveforms for XY mode:
+
+- **Draw Shapes**: Circles, rectangles, stars, polygons, Lissajous figures
+- **Text Rendering**: Display text messages on your oscilloscope screen
+- **Animations**: Create rotating and transforming graphics
+- **Composite Paths**: Combine multiple shapes into complex drawings
+
+**Requirements**: External AWG/DAC or scope's built-in AWG to feed generated waveforms into scope channels.
+
+```python
+# Install the fun extras
+# pip install "SCPI-Instrument-Control[fun]"
+
+from scpi_control import Oscilloscope
+from scpi_control.vector_graphics import Shape
+
+scope = Oscilloscope('192.168.1.100')
+scope.connect()
+
+# Enable XY mode (CH1=X, CH2=Y)
+scope.vector_display.enable_xy_mode()
+
+# Generate waveforms for a circle
+circle = Shape.circle(radius=0.8, points=1000)
+x_wave, y_wave = scope.vector_display.draw(circle)
+
+# Save for AWG upload
+scope.vector_display.save_waveforms(circle, "my_circle", format='csv')
+# Load my_circle_x.csv and my_circle_y.csv into your AWG!
+```
+
+See `examples/vector_graphics_xy_mode.py` for more demos including animations and text!
+
+## Installation
+
+### From PyPI (recommended)
+
+```bash
+pip install SCPI-Instrument-Control
+```
+
+To include optional features, use extras:
+
+```bash
+# GUI application with PyQt6
+pip install "SCPI-Instrument-Control[gui]"
+
+# Automated report generation (PDF/Markdown with AI analysis)
+pip install "SCPI-Instrument-Control[report-generator]"
+
+# Vector graphics and XY mode (draw shapes on scope!)
+pip install "SCPI-Instrument-Control[fun]"
+
+# Everything
+pip install "SCPI-Instrument-Control[all]"
+```
+
+**Note**: The `siglent-gui` command includes automatic dependency checking. If you try to run the GUI without the required packages, you'll receive a clear error message with installation instructions. Missing optional dependencies (like PyQtGraph for high-performance live view) will trigger warnings but allow the GUI to launch.
+
+### From source
+
+```bash
+git clone git@github.com:little-did-I-know/SCPI-Instrument-Control.git
+cd SCPI-Instrument-Control
+pip install -e .
+```
+
+Install with GUI support from source:
+
+```bash
+pip install -e ".[gui]"
+```
+
+### Development installation
+
+```bash
+pip install -e ".[dev]"
+```
+
+### Build & Publish (PyPI)
+
+To create release artifacts that render correctly on PyPI:
+
+```bash
+python -m build
+twine check dist/*
+```
+
+The `twine check` command validates the built distributions, including the long description rendered from `README.md`, before upload.
+
+## Migration Guide
+
+**v1.0.0** introduces a package rename from `Siglent-Oscilloscope` to `SCPI-Instrument-Control` to better reflect the expanded capabilities of this library.
+
+### For Existing Users
+
+If you're upgrading from the old `siglent` package:
+
+#### 1. Update Your Installation
+
+**Uninstall the old package** (if installed):
+
+```bash
+pip uninstall siglent
+```
+
+**Install the new package**:
+
+```bash
+pip install SCPI-Instrument-Control
+```
+
+Or with extras:
+
+```bash
+pip install "SCPI-Instrument-Control[gui]"
+pip install "SCPI-Instrument-Control[all]"
+```
+
+#### 2. Update Your Import Statements
+
+**Old imports** (deprecated but still work):
+
+```python
+from siglent import Oscilloscope, PowerSupply, FunctionGenerator
+from siglent.gui.app import main
+from siglent.waveform import Waveform
+```
+
+**New imports** (recommended):
+
+```python
+from scpi_control import Oscilloscope, PowerSupply, FunctionGenerator
+from scpi_control.gui.app import main
+from scpi_control.waveform import Waveform
+```
+
+#### 3. Backward Compatibility
+
+**Good news**: The old `import siglent` syntax still works! A compatibility shim automatically redirects to `scpi_control`.
+
+However, you'll see a `DeprecationWarning` encouraging you to update your code:
+
+```
+DeprecationWarning: The 'siglent' package name is deprecated and will be removed in v2.0.0.
+Please update your imports to use 'scpi_control' instead.
+```
+
+**The compatibility layer will be removed in v2.0.0**, so please migrate your code when convenient.
+
+#### 4. Command-Line Tools
+
+The CLI commands remain **unchanged** for convenience:
+
+```bash
+siglent-gui                    # Still works!
+siglent-report-generator       # Still works!
+```
+
+No changes needed to scripts or automation that invoke these commands.
+
+#### 5. What Changed
+
+| Old | New | Status |
+|-----|-----|--------|
+| PyPI package: `siglent` | PyPI package: `SCPI-Instrument-Control` | **Changed** |
+| `import siglent` | `import scpi_control` | **Recommended** |
+| `siglent-gui` command | `siglent-gui` command | **Unchanged** |
+| `siglent-report-generator` command | `siglent-report-generator` command | **Unchanged** |
+
+#### 6. Why the Rename?
+
+This library has grown significantly beyond its original focus on Siglent oscilloscopes:
+
+- **Multi-Instrument Support**: Oscilloscopes, power supplies, and function generators
+- **Multi-Vendor Support**: Works with any SCPI-compatible equipment (not just Siglent)
+- **Universal Protocol**: Based on industry-standard SCPI commands
+
+The new name better represents what the library does: **control any SCPI-compatible test equipment**.
+
+### Need Help?
+
+If you encounter any migration issues:
+
+- Check the [CHANGELOG.md](CHANGELOG.md) for detailed v1.0.0 release notes
+- [Open an issue](https://github.com/little-did-I-know/SCPI-Instrument-Control/issues) on GitHub
+- Review the updated [examples/](examples/) directory for new usage patterns
+
+## Quick Start
+
+### Programmatic Usage
+
+```python
+from scpi_control import Oscilloscope
+
+# Connect to oscilloscope
+scope = Oscilloscope('192.168.1.100')
+scope.connect()
+
+# Get device information
+print(scope.identify())
+
+# Configure channel 1
+scope.channel1.set_scale(1.0)  # 1V/div
+scope.channel1.set_coupling('DC')
+scope.channel1.enable()
+
+# Capture waveform
+waveform = scope.get_waveform(channel=1)
+print(f"Captured {len(waveform.time)} samples")
+
+scope.disconnect()
+```
+
+### GUI Application
+
+```bash
+siglent-gui
+```
+
+Or from Python:
+
+```python
+from scpi_control.gui.app import main
+main()
+```
+
+## Requirements
+
+### Core Library
+
+- Python 3.8+
+- NumPy >= 1.24.0
+- Matplotlib >= 3.7.0
+- SciPy >= 1.10.0
+
+### GUI Application (optional)
+
+Install with `[gui]` extra to add:
+
+- PyQt6 >= 6.6.0
+- PyQt6-WebEngine >= 6.6.0
+- PyQtGraph >= 0.13.0 (high-performance plotting)
+
+### Optional Extras
+
+- **Report Generator**: Install with `[report-generator]` to add PyQt6, Pillow, requests, ReportLab, Ollama (PDF/Markdown reports with AI)
+- **HDF5 support**: Install with `[hdf5]` to add h5py >= 3.8.0
+- **Vector Graphics**: Install with `[fun]` to add shapely, Pillow, svgpathtools (XY mode drawing)
+- **All features**: Install with `[all]` for complete functionality
+
+## Connection
+
+The oscilloscope must be connected to your network. The default SCPI port is 5024.
+
+To find your oscilloscope's IP address:
+
+1. Press **Utility** on the oscilloscope
+2. Navigate to **I/O** settings
+3. Check the **LAN** configuration
+
+## GUI Application Overview
+
+The SCPI Instrument Control GUI provides a comprehensive interface for controlling your oscilloscope, capturing waveforms, and performing measurements.
+
+> **Note**: Screenshots can be captured following the guide in [`docs/SCREENSHOT_GUIDE.md`](docs/SCREENSHOT_GUIDE.md). This provides visual documentation of all GUI features.
+
+### Main Window
+
+![Main Window](docs/images/main_window.png)
+
+The main interface consists of:
+
+- **Waveform Display**: High-performance real-time plotting area (center)
+- **Control Panels**: Tabbed interface with all oscilloscope controls (right)
+- **Menu Bar**: File operations, acquisition controls, and utilities (top)
+- **Status Bar**: Connection status and system information (bottom)
+
+### Getting Connected
+
+![Connection Dialog](docs/images/connection_dialog.png)
+
+To connect to your oscilloscope:
+
+1. Launch the GUI: `siglent-gui`
+2. Enter your oscilloscope's IP address
+3. Click **Connect**
+
+The oscilloscope must be connected to your network (default SCPI port: 5024).
+
+**Finding your oscilloscope's IP address**:
+
+- Press **Utility** on the oscilloscope
+- Navigate to **I/O** settings
+- Check the **LAN** configuration
+
+### Channel Controls
+
+![Channel Controls](docs/images/channel_controls.png)
+
+The **Channels** tab provides complete control over all input channels:
+
+- **Enable/Disable**: Toggle channels on/off with checkboxes
+- **Voltage Scale**: Adjust volts/division (0.001V to 10V)
+- **Coupling**: Set DC, AC, or GND coupling
+- **Probe Ratio**: Configure probe attenuation (1X, 10X, 100X, etc.)
+- **Bandwidth Limit**: Enable 20MHz bandwidth limiting
+- **Offset**: Adjust vertical position
+
+**Quick Tip**: Enable channels before starting Live View or capturing waveforms.
+
+## GUI Application Guide
+
+### Live View
+
+![Live View](docs/images/live_view.png)
+
+The GUI features **high-performance real-time waveform viewing** powered by PyQtGraph:
+
+```
+Acquisition → Live View (Ctrl+R)
+```
+
+**Performance:**
+
+- Real-time updates at 5-20 fps (configurable)
+- 100x faster than traditional matplotlib-based viewers
+- Non-blocking: GUI remains responsive during data acquisition
+- Supports all 4 channels simultaneously
+
+**Controls:**
+
+- Enable channels in the "Channels" tab first
+- Live view automatically acquires from enabled channels
+- Adjust update rate by modifying `update_interval` in `live_view_worker.py`
+
+### Visual Measurements
+
+![Visual Measurements](docs/images/visual_measurements.png)
+
+Interactive measurement markers that you can place and adjust directly on waveforms:
+
+**How to use:**
+
+1. Go to the **"Visual Measure"** tab
+2. Select measurement type (Frequency, Vpp, Rise Time, etc.)
+3. Select channel (CH1-CH4)
+4. Click **"Add Marker"**
+5. Marker auto-places on waveform
+6. Drag marker gates to adjust measurement region
+7. See real-time measurement updates
+
+**Measurement Types:**
+
+- **Frequency/Period**: Auto-detects signal period
+- **Voltage**: Vpp, Amplitude, Max, Min, RMS, Mean
+- **Timing**: Rise Time, Fall Time, Pulse Width, Duty Cycle
+
+**Features:**
+
+- **Save/Load Configs**: Save measurement setups for reuse
+- **Export Results**: Export to CSV or JSON
+- **Auto-Update**: Optional 1-second auto-refresh
+- **Batch Mode**: Run multiple measurements simultaneously
+
+**Example Workflow:**
+
+```python
+# In GUI:
+# 1. Capture or enable live view
+# 2. Visual Measure tab → Add Marker
+# 3. Type: "Frequency", Channel: "CH1" → Add
+# 4. Marker appears with measurement result
+# 5. Save Config → "my_measurements.json"
+# 6. Export Results → "results.csv"
+```
+
+### Automated Measurements
+
+![Measurements Panel](docs/images/measurements_panel.png)
+
+The **Measurements** tab provides quick access to standard oscilloscope measurements:
+
+- 15+ measurement types (frequency, Vpp, RMS, rise time, etc.)
+- Channel selection
+- Results table with units
+- Export measurement results
+
+### Cursors
+
+![Cursors](docs/images/cursors.png)
+
+Interactive cursors for precise measurements:
+
+- **Vertical cursors** for time measurements
+- **Horizontal cursors** for voltage measurements
+- **Delta calculations** (ΔT, ΔV, frequency)
+- Draggable cursor lines
+- Real-time delta updates
+
+### FFT Analysis
+
+![FFT Analysis](docs/images/fft_analysis.png)
+
+Frequency domain analysis:
+
+- Fast Fourier Transform visualization
+- Peak detection and markers
+- Window function selection (Hanning, Hamming, Blackman)
+- Frequency and amplitude axes
+- Export FFT data
+
+### Vector Graphics 🎨 (XY Mode)
+
+> **Requires**: `pip install "SCPI-Instrument-Control[fun]"`
+
+Turn your oscilloscope into a vector display by generating waveforms for XY mode!
+
+The **Vector Graphics** tab provides:
+
+**Shape Generator:**
+
+- **Basic Shapes**: Circle, Rectangle, Star, Triangle, Line
+- **Lissajous Figures**: Classic oscilloscope patterns (3:2, 5:4, 7:5, etc.)
+- **Parameter Controls**: Adjust size, points, frequency ratios, phase shifts
+- **Generate Button**: Create vector paths with customizable parameters
+
+**Waveform Export:**
+
+- **Sample Rate Control**: 1-1000 MSa/s for AWG compatibility
+- **Duration**: 1ms to 10s per waveform
+- **Format Options**: CSV (universal), NumPy (.npy), Binary (.bin)
+- **Save for AWG**: Exports separate X and Y waveform files
+
+**XY Mode Control:**
+
+- **Enable/Disable**: Configure oscilloscope for XY display mode
+- **Channel Setup**: Auto-configures CH1 (X-axis) and CH2 (Y-axis)
+- **Status Display**: Connection and configuration feedback
+
+**How to use:**
+
+1. Go to the **"Vector Graphics 🎨"** tab
+2. Select a shape (e.g., "Circle" or "Lissajous")
+3. Adjust parameters (radius, points, frequencies)
+4. Click **"Generate Shape"**
+5. Set sample rate and duration for your AWG
+6. Click **"Save Waveforms..."** to export
+7. Load the X/Y files into your AWG (Channel 1 = X, Channel 2 = Y)
+8. Connect AWG outputs to scope inputs
+9. Click **"Enable XY Mode"** or manually enable on scope
+10. Watch your shape appear on the oscilloscope! ✨
+
+**Works without scope connection** - you can generate and export waveforms offline!
+
+**Example Use Cases:**
+
+- Draw circles, stars, and geometric shapes
+- Create classic Lissajous patterns for calibration
+- Generate animations (rotating shapes, morphing patterns)
+- Educational demonstrations of XY mode
+- Signal generator pattern testing
+
+See `examples/vector_graphics_xy_mode.py` for programmatic usage and animation examples.
+
+### Other GUI Features
+
+**Reference Waveforms:**
+
+- Save waveforms as references
+- Overlay comparisons
+- Difference mode (live - reference)
+- Calculate correlation
+
+**Math Channels:**
+
+- Custom expressions: `C1 + C2`, `C1 * 2`, etc.
+- Real-time calculation
+
+**FFT Analysis:**
+
+- Frequency domain visualization
+- Window function selection
+- Peak detection
+
+**Protocol Decode:**
+
+- I2C, SPI, UART, CAN, LIN decoding
+- Packet analysis and export
+
+## API Documentation
+
+### Oscilloscope
+
+```python
+from scpi_control import Oscilloscope
+
+# Connect
+scope = Oscilloscope('192.168.1.100', port=5024, timeout=5.0)
+scope.connect()
+
+# Device information
+print(scope.identify())  # Get *IDN? string
+print(scope.device_info)  # Parsed device info dict
+
+# Basic controls
+scope.run()           # Start acquisition (AUTO mode)
+scope.stop()          # Stop acquisition
+scope.auto_setup()    # Auto setup
+scope.reset()         # Reset to defaults
+```
+
+### Channels
+
+```python
+# Channel configuration (channels 1-4)
+scope.channel1.enable()
+scope.channel1.coupling = "DC"  # DC, AC, or GND
+scope.channel1.voltage_scale = 1.0  # Volts/division
+scope.channel1.voltage_offset = 0.0  # Volts
+scope.channel1.probe_ratio = 10.0  # 10X probe
+scope.channel1.bandwidth_limit = "OFF"  # ON or OFF
+
+# Get configuration
+config = scope.channel1.get_configuration()
+```
+
+### Trigger
+
+```python
+# Trigger configuration
+scope.trigger.mode = "NORMAL"  # AUTO, NORM, SINGLE, STOP
+scope.trigger.source = "C1"  # C1, C2, C3, C4, EX, LINE
+scope.trigger.level = 0.0  # Trigger level in volts
+scope.trigger.slope = "POS"  # POS (rising) or NEG (falling)
+
+# Edge trigger setup
+scope.trigger.set_edge_trigger(source="C1", slope="POS")
+
+# Trigger actions
+scope.trigger.single()  # Single trigger
+scope.trigger.force()   # Force trigger
+```
+
+### Waveform Acquisition
+
+```python
+# Acquire waveform
+waveform = scope.get_waveform(channel=1)
+
+# Access data
+print(waveform.time)      # Time array (numpy)
+print(waveform.voltage)   # Voltage array (numpy)
+print(waveform.sample_rate)
+print(waveform.record_length)
+
+# Save waveform
+scope.waveform.save_waveform(waveform, "data.csv", format="CSV")
+```
+
+### Measurements
+
+```python
+# Individual measurements
+freq = scope.measurement.measure_frequency(1)
+vpp = scope.measurement.measure_vpp(1)
+vrms = scope.measurement.measure_rms(1)
+period = scope.measurement.measure_period(1)
+
+# All measurements at once
+measurements = scope.measurement.measure_all(1)
+```
+
+### Programmatic Data Collection & Automation
+
+For advanced data collection workflows, use the high-level automation API:
+
+```python
+from scpi_control.automation import DataCollector
+
+# Simple capture with automatic analysis
+with DataCollector('192.168.1.100') as collector:
+    # Capture waveforms
+    data = collector.capture_single([1, 2])
+
+    # Analyze waveform
+    stats = collector.analyze_waveform(data[1])
+    print(f"Vpp: {stats['vpp']:.3f}V, Freq: {stats['frequency']/1e3:.2f}kHz")
+
+    # Save to file (supports NPZ, CSV, MAT, HDF5)
+    collector.save_data(data, 'measurement.npz')
+```
+
+**Batch capture with configuration sweeps:**
+
+```python
+# Capture with different timebase and voltage settings
+results = collector.batch_capture(
+    channels=[1],
+    timebase_scales=['1us', '10us', '100us'],
+    voltage_scales={1: ['500mV', '1V', '2V']},
+    triggers_per_config=5
+)
+collector.save_batch(results, 'batch_output')
+```
+
+**Continuous time-series collection:**
+
+```python
+# Collect data over time with automated file saving
+collector.start_continuous_capture(
+    channels=[1, 2],
+    duration=300,          # 5 minutes
+    interval=1.0,          # 1 capture per second
+    output_dir='time_series_data',
+    file_format='npz'
+)
+```
+
+**Event-based trigger capture:**
+
+```python
+from scpi_control.automation import TriggerWaitCollector
+
+with TriggerWaitCollector('192.168.1.100') as tc:
+    # Configure trigger
+    tc.collector.scope.trigger.set_source(1)
+    tc.collector.scope.trigger.set_slope('POS')
+    tc.collector.scope.trigger.set_level(1, 1.0)
+
+    # Wait for trigger event
+    data = tc.wait_for_trigger(channels=[1, 2], max_wait=30.0)
+```
+
+**Advanced analysis:**
+
+```python
+# Built-in analysis includes: Vpp, RMS, frequency, SNR, THD, etc.
+analysis = collector.analyze_waveform(waveform)
+print(f"SNR: {analysis['snr_db']:.2f} dB")
+print(f"THD: {analysis['thd_percent']:.2f}%")
+```
+
+See `examples/` directory for complete automation examples including:
+
+- Simple capture (`simple_capture.py`)
+- Batch processing (`batch_capture.py`)
+- Continuous monitoring (`continuous_capture.py`)
+- Trigger-based capture (`trigger_based_capture.py`)
+- Advanced analysis with visualization (`advanced_analysis.py`)
+
+## Examples
+
+See the `examples/` directory for complete working examples:
+
+- **basic_usage.py** - Connection and basic operations
+- **waveform_capture.py** - Capture and save waveforms
+- **measurements.py** - Automated measurements
+- **live_plot.py** - Real-time plotting
+- **probe_calibration_analysis.py** - Automated report generation with region extraction and AI analysis
+
+## Supported Models
+
+### Fully Tested
+
+- **SDS800X HD Series**: SDS804X HD, SDS824X HD
+- **SDS1000X-E Series**: SDS1102X-E, SDS1104X-E, SDS1202X-E, SDS1204X-E
+- **SDS2000X Plus Series**: SDS2104X+, SDS2204X+, SDS2354X+
+- **SDS5000X Series**: SDS5034X, SDS5054X, SDS5104X
+
+### Compatibility
+
+Should work with other Siglent oscilloscopes that support SCPI commands over Ethernet. Model-specific features are auto-detected via the `ModelCapability` registry.
+
+**Note**: Some SCPI commands vary between models. The library includes model-specific command variants for HD, X, and Plus series.
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details on:
+
+- Development setup and workflow
+- Code style and testing requirements
+- Pull request process
+- How to report bugs and request features
+
+### Quick Start for Contributors
+
+```bash
+# Clone and setup
+git clone https://github.com/little-did-I-know/SCPI-Instrument-Control.git
+cd SCPI-Instrument-Control
+
+# Install development environment
+make dev-setup
+
+# Run tests
+make test
+
+# Format code
+make format
+
+# Run all checks
+make check
+```
+
+See our [Code of Conduct](CODE_OF_CONDUCT.md) and [Security Policy](SECURITY.md) for more information.
+
+## Community and Support
+
+- **Issues**: [Report bugs or request features](https://github.com/little-did-I-know/SCPI-Instrument-Control/issues)
+- **Discussions**: [Ask questions and share ideas](https://github.com/little-did-I-know/SCPI-Instrument-Control/discussions)
+- **Security**: See our [Security Policy](SECURITY.md) for reporting vulnerabilities
+
+## Resources
+
+- 📘 **[Interactive Tutorial](examples/interactive_tutorial.ipynb)** - Jupyter notebook with step-by-step examples
+- 📁 **[Examples Directory](examples/)** - Ready-to-run example scripts
+- 📖 **[API Documentation](#api-documentation)** - Complete API reference in this README
+- 🔧 **[Contributing Guide](CONTRIBUTING.md)** - How to contribute to the project
+- 🧪 **[Experimental Features Guide](docs/development/EXPERIMENTAL_FEATURES.md)** - Beta releases and experimental features
+- 🔒 **[Security Policy](SECURITY.md)** - Security best practices and reporting
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details

scpi_instrument_control-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+scpi_instrument_control-1.0.0.dist-info/licenses/LICENSE,sha256=i9ZSY6vVyVzmzmZ7rgpuiK3USZH5yJ2Q_FjbIFVa68w,1062
+siglent/__init__.py,sha256=X6NuAX2EGc3YX3R-dBMyDkecUtfbPuBjM9lc__b9Wlc,1498
+scpi_instrument_control-1.0.0.dist-info/METADATA,sha256=jrjLLwIJeFyr7Yr0mIqSmc3oSUZuLGHAIS4__3QNTok,31277
+scpi_instrument_control-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+scpi_instrument_control-1.0.0.dist-info/entry_points.txt,sha256=eqPCEzf5od0P0ggwn0EESAURiCXZbu6AryayMfqCQyM,114
+scpi_instrument_control-1.0.0.dist-info/top_level.txt,sha256=jqHtrzYuCmSomoCH6f2F5CqE-xRWeLlQ8FP-CDHchE4,8
+scpi_instrument_control-1.0.0.dist-info/RECORD,,

scpi_instrument_control-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

scpi_instrument_control-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+siglent-gui = siglent.gui.app:main
+siglent-report-generator = siglent.report_generator.app:main

scpi_instrument_control-1.0.0.dist-info/licenses/LICENSE

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

scpi_instrument_control-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+siglent

siglent/__init__.py

@@ -0,0 +1,35 @@
+"""Backward compatibility module for the 'siglent' package name.
+
+DEPRECATED: This module provides backward compatibility for code using 'import siglent'.
+
+The package has been renamed to 'scpi_control' to better reflect its capabilities:
+- SCPI Instrument Control (scpi_control) supports oscilloscopes, power supplies,
+  and function generators from Siglent and other SCPI-compatible manufacturers.
+
+Migration Guide:
+    Old import (deprecated):
+        from siglent import Oscilloscope, PowerSupply, FunctionGenerator
+
+    New import (recommended):
+        from scpi_control import Oscilloscope, PowerSupply, FunctionGenerator
+
+This compatibility module will be removed in v2.0.0.
+For more information, see: https://github.com/little-did-I-know/SCPI-Instrument-Control
+"""
+
+import warnings
+
+warnings.warn(
+    "The 'siglent' package name is deprecated and will be removed in v2.0.0.\n"
+    "Please update your imports to use 'scpi_control' instead:\n\n"
+    "  Old: from siglent import Oscilloscope, PowerSupply, FunctionGenerator\n"
+    "  New: from scpi_control import Oscilloscope, PowerSupply, FunctionGenerator\n\n"
+    "PyPI package name: pip install SCPI-Instrument-Control\n"
+    "See migration guide: https://github.com/little-did-I-know/SCPI-Instrument-Control",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+# Re-export everything from the new package for backward compatibility
+from scpi_control import *  # noqa: F401, F403
+from scpi_control import __version__, __all__  # noqa: F401