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

ExtraDescriptionKey Packages
(base)Data loading, analysis, CLInumpy, pyarrow, pyyaml, argcomplete, colorlog
[daq]Live sensor acquisitionavro, fastavro
[analysis]Plotting + API clientmatplotlib, requests, websocket-client
[jupyter]Full notebook environment[analysis] + jupyterlab, duckdb, ipywidgets
[full]All of the above-