Introduction
equser is the open-source Python interface to EQ Wave power quality data and sensors. It provides tools for loading, analyzing, and visualizing high-resolution electrical measurements.
What equser does
equser can work with EQ Wave data in several ways:
- Load and analyze Parquet files stored by an EQ gateway, including continuous waveform (CPOW) and power monitoring (PMon) data
- Connect directly to an EQ Wave sensor to collect PMon data in real time
- Capture waveform snapshots on demand via an EQ gateway
- Query gateway APIs for historical data, events, and live streams
- Visualize power quality data with publication-ready matplotlib plots
Data formats
| Format | Description | Sample Rate | File Pattern |
|---|---|---|---|
| CPOW | Continuous Point-on-Wave waveforms (7 channels: VA, VB, VC, IA, IB, IC, IN) | 32 kHz | YYYYMMDD_HHMMSS.parquet |
| PMon | 10/12-cycle RMS power quality summaries (voltage, current, power, frequency) | ~5 Hz | YYYYMMDD_HHMM.parquet |
Quick install
pip install equser # Data loading and analysis
pip install equser[analysis] # Add plotting and API client
pip install equser[jupyter] # Full notebook environment
Get started
See the Installation guide, then follow the Quick Start tutorial.
The broader platform
equser is one component of the Energy Quotient platform for continuous waveform intelligence. For the full capabilities, including real-time CPOW visualization through EQ Sight and power system intelligence through EQ Syntropy, see the platform overview.