Installation
Requirements
- Python 3.10 or later
- Linux (for hardware integration features)
Install from source
equser uses a tiered dependency model. Install only what you need.
Base (data loading and analysis)
pip install equser
Includes: numpy, pyarrow, pyyaml, argcomplete, colorlog. Enough to load CPOW/PMon files, run waveform analysis, and use the CLI with tab completion and colored output.
Plotting and API client
pip install equser[analysis]
Adds: matplotlib, requests, websocket-client. Enables equser.plotting,
equser.api, and WebSocket streaming.
Jupyter notebook environment
pip install equser[jupyter]
Superset of [analysis]. Adds: jupyterlab, duckdb, ipywidgets, ipykernel,
nbconvert. Full interactive notebook environment for data exploration.
Live sensor acquisition
pip install equser[daq]
Adds: avro, fastavro. Required for equser pmon acquire to connect to EQ Wave
sensor hardware.
Full installation
pip install equser[full]
All optional extras.
Dependency tiers
| Extra | Description | Key Packages |
|---|---|---|
| (base) | Data loading, analysis, CLI | numpy, pyarrow, pyyaml, argcomplete, colorlog |
[daq] | Live sensor acquisition | avro, fastavro |
[analysis] | Plotting + API client | matplotlib, requests, websocket-client |
[jupyter] | Full notebook environment | [analysis] + jupyterlab, duckdb, ipywidgets |
[full] | All of the above | - |