Metadata-Version: 2.4
Name: daspal
Version: 1.0.0a1
Summary: Package for reading and processing DAS data built around DASK
Author-email: Florian Le Pape <florian.le.pape@ifremer.fr>, Gwenaël CAËR <gwenael.caer@data-terra.org>
License-Expression: MIT
License-File: LICENSE.txt
Requires-Python: >=3.10
Requires-Dist: dask
Requires-Dist: datashader
Requires-Dist: distributed
Requires-Dist: h5py
Requires-Dist: holoviews
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: obspy
Requires-Dist: pandas
Requires-Dist: scipy
Requires-Dist: xarray
Requires-Dist: zarr
Provides-Extra: local
Requires-Dist: ipykernel; extra == 'local'
Provides-Extra: server
Requires-Dist: batchspawner; extra == 'server'
Requires-Dist: dask-labextension; extra == 'server'
Requires-Dist: ipykernel; extra == 'server'
Requires-Dist: jupyterhub<4; extra == 'server'
Requires-Dist: jupyterlab; extra == 'server'
Description-Content-Type: text/markdown

# daspal

**DAS Processing & Analysis Library**

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE.txt)
[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](#)

----

## Table of Contents

* [Description](#description)
* [Installation](#installation)
* [Examples](#examples)
* [License](#license)
* [Contributing](#contributing)
* [Developers](#developers)

---

## Description

This python project presents a set of tools for **Distibuted Acoustic Sensing (DAS) data processing and analysis**. It aims to leverage on existing widely used python libraries within the geoscience community, mainly [Xarray](https://docs.xarray.dev/en/stable/index.html) and [Dask](https://docs.dask.org/en/stable/), for efficient reading, processing and visualization of DAS data. `daspal` offers easily scalable DAS data analysis tools that be ran on simple laptop and HPC clusters, even cloud computing environments with Xarray and Dask integrated compatibility with could-native data formats such as [Zarr](https://zarr.readthedocs.io/en/stable/).

---

## Installation

Install `daspal` using **pip**:

```bash
pip install daspal
```

---

## Examples

In order to get familiar with some of the modules to read, process and visualize DAS data, three example notebooks can be found in the `Notebooks` folder (based on OptoDAS data):

* `Reading_and_processing_data.ipynb`
* `Lazy_data_pipeline.ipynb`
* `Channel_spectrograms.ipynb`
* `Working_with_Zarr_data_format.ipynb`

---

## License

`daspal` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

---

## Contributing

We welcome contributions of all kinds: bug fixes, new features, or improvements to documentation.

For more information, see our [Contributing page](https://geo-ocean-das.gitlab-pages.ifremer.fr/daspal/development).

**AI-assisted development**

This project was designed and implemented by the authors. However, LLMs were used along the way as an interactive assistant for code suggestions, boilerplate generation, and prototyping. The authors take full responsibility for the content of the codebase.

---

## Developers

This package is developed and maintained by:

* **Florian Le Pape** – [florian.le.pape@ifremer.fr](mailto:florian.le.pape@ifremer.fr)
* **Gwenaël Caër** – [gwenael.caer@data-terra.org](mailto:gwenael.caer@data-terra.org)
