dasio 0.1.1

Lightweight standalone IO + basic processing for DAS (Distributed Acoustic Sensing) data

dasio

Lightweight, standalone IO + basic processing for DAS (Distributed Acoustic Sensing) data: vendor HDF5 readers (ASN/OptoDAS, OptaSense/QuantX, AP Sensing), a Proc processed format, an Event format, a numpy DASdata container, a file catalog (DASdb), and signal processing including a C++/OpenMP bandpass.

Install (development)

This package contains a compiled C++ extension. Always install editable so the extension builds in place:

pip install -e .

Build requirements: a C++14 compiler, CMake ≥3.15, and OpenMP (e.g. apt-get install build-essential libomp-dev). pybind11 and scikit-build-core are pulled automatically by the build.

Optional extras

Ambient-noise cross-correlation and phase picking have heavier, optional dependencies, exposed as install extras (still editable):

pip install -e '.[noise]'       # ambient-noise cross-correlation (dasio.noise) -> PyTorch
pip install -e '.[pick]'        # PhaseNet-DAS P/S picking (dasio.pick_phases) -> phasenet (+ PyTorch)
pip install -e '.[noise,pick]'  # both

Both are imported lazily, so the rest of dasio works without them installed.

Quickstart

from dasio import DASFile

d = DASFile('file.h5').read()                        # auto-detects the vendor format -> DASdata
d.bandpass(1.0, 10.0).subtract_common_mode().plot()  # filter -> denoise -> waterfall