Metadata-Version: 2.4
Name: xdas
Version: 0.2.10
Author-email: Alister Trabattoni <alister.trabattoni@gmail.com>
Project-URL: Homepage, https://github.com/xdas-dev/xdas
Project-URL: Documentation, https://xdas.readthedocs.io
Project-URL: Changelog, https://github.com/xdas-dev/xdas/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/xdas-dev/xdas/issues
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: h5netcdf
Requires-Dist: h5py
Requires-Dist: hdf5plugin
Requires-Dist: loky
Requires-Dist: numba
Requires-Dist: numpy>=2.3
Requires-Dist: obspy
Requires-Dist: pandas
Requires-Dist: plotly
Requires-Dist: setuptools<82.0.0
Requires-Dist: scipy
Requires-Dist: tqdm
Requires-Dist: typing_extensions
Requires-Dist: watchdog
Requires-Dist: xarray
Requires-Dist: xinterp>=0.2.1
Requires-Dist: pyzmq
Dynamic: license-file

<div align="center">
<picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/xdas-dev/xdas/main/docs/_static/logo-dark.png">
    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/xdas-dev/xdas/main/docs/_static/logo-light.png">
    <img alt="Xdas Logo" height="250px" src="https://raw.githubusercontent.com/xdas-dev/xdas/main/docs/_static/logo-light.png">
</picture>
</div>

-----------------

[![Documentation Status](https://readthedocs.org/projects/xdas/badge/?version=latest)](https://xdas.readthedocs.io/en/latest/?badge=latest)
[![CI Status](https://github.com/xdas-dev/xdas/actions/workflows/ci.yaml/badge.svg)](https://github.com/xdas-dev/xdas/actions/workflows/ci.yaml)
[![codecov](https://codecov.io/gh/xdas-dev/xdas/graph/badge.svg?token=00MD52JRA3)](https://codecov.io/gh/xdas-dev/xdas)
[![PyPI](https://img.shields.io/pypi/v/xdas)](https://pypi.org/project/xdas/)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![DOI](https://zenodo.org/badge/560867006.svg)](https://zenodo.org/badge/latestdoi/560867006)

# Xdas: a Python Framework for Distributed Acoustic Sensing

*Xdas* is an python library for managing, processing and visualizing **Distributed Acoustic Sensing (DAS)** data. It reads any DAS format into self-described python abstractions that encapsulates both the data and the metadata (coordinates and attributes). Xdas reuses concepts of labeled N-dimensional arrays developped by the [Xarray](https://xarray.dev) library. It takes inspiration from [Dask](https://www.dask.org/) in term of lazy computing.

## Key Features

- Seamless manipulation of large multi-file datasets in their native DAS-specific format.
- Signal Processing: Multi-threaded implementations of common routines.
- Extensibility: build your pipeline with a mix of Xdas, NumPy/SciPy, and/or your own custom routines. 
- Larger-than-memory processing: apply your piplines with optimized I/O latencies.

Xdas can also be used in other context than DAS, for example in the context of other dense and heavy N-dimenional arrays such as large-N seismic arrays.

## Installation

Xdas can be fetched from [PyPI](https://pypi.org/project/xdas):

    pip install xdas

## Documentation

The documentation is available at: [https://xdas.readthedocs.io](https://xdas.readthedocs.io).

## Tutorials

A comprehensive series of tutorials can be found at: [https://github.com/xdas-dev/tutorials](https://github.com/xdas-dev/tutorials).

## Contributing

You can find information about contributing to Xdas in our [Contributing Guide](https://xdas.readthedocs.io/en/latest/contribute.html).

## Get in touch

- Ask usage questions and discuss any ideas on [GitHub Discussions](https://github.com/xdas-dev/xdas/discussions).
- Report bugs, suggest features or view the source code on [GitHub](https://github.com/xdas-dev/xdas).
- To follow the main announcements such as online trainning sessions please register to our [Newsletter](https://groups.google.com/g/xdas).

## Citing

If you use Xdas for your DAS data processing, please consider [citing the project](https://xdas.readthedocs.io/en/latest/cite.html).
