dasexplorer 1.0.0__tar.gz

dasexplorer-1.0.0/CITATION.cff

@@ -0,0 +1,40 @@
+cff-version: 1.2.0
+message: "If you use DASexplorer in your research, please cite it as below."
+type: software
+title: "DASexplorer"
+abstract: >
+  DASexplorer is an open-source desktop application for visualisation,
+  analysis and annotation of Distributed Acoustic Sensing (DAS) data.
+  It supports multiple interrogator formats, profile-based configuration, 
+  multispectral RGB representation, F-K filtering, and annotations conversion
+  to YOLO, COCO and Raven Pro formats.
+authors:
+  - family-names: Morell-Monzó
+    given-names: Sergio
+    orcid: "https://orcid.org/0000-0001-8883-2618"
+    affiliation: "Institut d'Investigació per a la Gestío Integrada de Zones Costaneres (IGIC-UPV), Universitat Politècnica de València"
+    email: sermomon@upv.es
+version: "1.0.0"
+date-released: "2026-06-25"
+license: MIT
+repository-code: "https://github.com/sermomon/DASexplorer"
+doi: "10.5281/zenodo.21032550"
+keywords:
+  - distributed acoustic sensing
+  - DAS
+  - fiber optic sensing
+  - underwater acoustics
+  - marine bioacoustics
+  - annotation
+  - visualization
+  - seismology
+preferred-citation:
+  type: software
+  title: "DASexplorer: Visualisation, analysis and annotation tool for Distributed Acoustic Sensing data"
+  authors:
+    - family-names: Morell-Monzó
+      given-names: Sergio
+  version: "1.0.0"
+  year: 2026
+  doi: "10.5281/zenodo.21032550"
+  url: "https://github.com/sermomon/DASexplorer"

dasexplorer-1.0.0/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2024-2026 Sergio Morell-Monzó, Dídac Diego-Tortosa,
+Isabel Pérez-Arjona, Víctor Espinosa Roselló
+Underwater Acoustics Group (IGIC), Universitat Politècnica de València
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dasexplorer-1.0.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+include CITATION.cff
+recursive-include dasexplorer/cfg *
+recursive-include dasexplorer/icons *
+include dasexplorer/about.txt

dasexplorer-1.0.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: dasexplorer
+Version: 1.0.0
+Summary: Visualisation, analysis and annotation tool for Distributed Acoustic Sensing (DAS) data
+Author-email: Sergio Morell-Monzó <sermomon@upv.es>
+License: MIT License
+        
+        Copyright (c) 2024-2026 Sergio Morell-Monzó, Dídac Diego-Tortosa,
+        Isabel Pérez-Arjona, Víctor Espinosa Roselló
+        Underwater Acoustics Group (IGIC), Universitat Politècnica de València
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/sermomon/DASexplorer
+Project-URL: Repository, https://github.com/sermomon/DASexplorer
+Project-URL: Bug Tracker, https://github.com/sermomon/DASexplorer/issues
+Keywords: DAS,distributed acoustic sensing,fiber optic sensing,underwater acoustics,annotation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyQt5>=5.15
+Requires-Dist: pyqtgraph>=0.13
+Requires-Dist: numpy>=1.22
+Requires-Dist: scipy>=1.9
+Requires-Dist: matplotlib>=3.5
+Requires-Dist: h5py>=3.7
+Requires-Dist: das4whales>=0.1
+Requires-Dist: Pillow>=9.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+  <img src="dasexplorer/icons/icon_2.ico" alt="DASexplorer Logo" width="200"/>
+
+  <h1></h1>
+
+  <p>
+    <strong>A desktop application for visualization, analysis and annotation of Distributed Acoustic Sensing data</strong>
+  </p>
+
+  <p>
+<a href="https://github.com/sermomon/DASexplorer/releases"><img src="https://img.shields.io/badge/release-v1.0.0-red" alt="Latest Release"/></a>
+    <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python 3.10+"/></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"/></a>
+    <a href="https://doi.org/10.xxxx/joss.xxxxx"><img src="https://img.shields.io/badge/JOSS-paper-orange" alt="JOSS Paper"/></a>
+    <img src="https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey" alt="Platform"/>
+  </p>
+
+  <p>
+    <a href="#installation">Installation</a> ·
+    <a href="#quickstart">Quickstart</a> ·
+    <a href="#features">Features</a> ·
+    <a href="#supported-interrogators">Interrogators</a> ·
+    <a href="#annotation-export">Annotation Export</a> ·
+    <a href="#contributing">Contributing</a> ·
+    <a href="#citation">Citation</a>
+  </p>
+  <br/>
+
+  <img src="dasexplorer/icons/screenshot.png" alt="DAS Explorer main window" width="900"/>
+
+</div>
+
+---
+
+## Overview
+
+**DASexplorer** is an open-source desktop application built for researchers working with Distributed Acoustic Sensing (DAS) data. It provides an integrated environment for loading, visualising, filtering, and annotating DAS recordings from multiple interrogator systems, without requiring any prior programming knowledge.
+
+DASexplorer was designed for efficient interactive navigation of large DAS datasets. Built on PyQt5 and pyqtgraph, it uses spatial decimation, parameter-based caching and smart rendering strategies to handle long acquisitions with minimal memory overhead. The application is interrogator-agnostic: a profile-based configuration system maps each acquisition system to its reader, file extensions and default visualisation parameters, making it straightforward to add support for new instruments.
+
+Key design principles:
+
+- **No-code** — the full analysis workflow is accessible through an intuitive GUI.
+- **Multi-interrogator** — natively supports HDAS 2.5 (Aragón Photonics), OptaSense (Luna Innovations) and OptoDAS (ASN/ Alcatel Subsea Networks) file formats; extensible to new systems.
+- **Research-ready** — exports data and annotations in formats directly usable by machine learning and bioacoustic analysis pipelines (NPZ, MAT, YOLO, COCO JSON, Raven Pro).
+
+
+## Citation
+
+If you use DASexplorer in your research, please cite:
+
+```bibtex
+@software{morellmonzo2026dasexplorer,
+  author       = {Morell-Monzó, Sergio},
+  title        = {DASexplorer},
+  version      = {1.0},
+  year         = {2026},
+  publisher    = {Zenodo},
+  doi          = {10.5281/zenodo.21032550},
+  url          = {https://doi.org/10.5281/zenodo.21032550}
+}
+```
+
+[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.21032550-blue)](https://doi.org/10.5281/zenodo.21032550)

dasexplorer-1.0.0/README.md

@@ -0,0 +1,64 @@
+<div align="center">
+  <img src="dasexplorer/icons/icon_2.ico" alt="DASexplorer Logo" width="200"/>
+
+  <h1></h1>
+
+  <p>
+    <strong>A desktop application for visualization, analysis and annotation of Distributed Acoustic Sensing data</strong>
+  </p>
+
+  <p>
+<a href="https://github.com/sermomon/DASexplorer/releases"><img src="https://img.shields.io/badge/release-v1.0.0-red" alt="Latest Release"/></a>
+    <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python 3.10+"/></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"/></a>
+    <a href="https://doi.org/10.xxxx/joss.xxxxx"><img src="https://img.shields.io/badge/JOSS-paper-orange" alt="JOSS Paper"/></a>
+    <img src="https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey" alt="Platform"/>
+  </p>
+
+  <p>
+    <a href="#installation">Installation</a> ·
+    <a href="#quickstart">Quickstart</a> ·
+    <a href="#features">Features</a> ·
+    <a href="#supported-interrogators">Interrogators</a> ·
+    <a href="#annotation-export">Annotation Export</a> ·
+    <a href="#contributing">Contributing</a> ·
+    <a href="#citation">Citation</a>
+  </p>
+  <br/>
+
+  <img src="dasexplorer/icons/screenshot.png" alt="DAS Explorer main window" width="900"/>
+
+</div>
+
+---
+
+## Overview
+
+**DASexplorer** is an open-source desktop application built for researchers working with Distributed Acoustic Sensing (DAS) data. It provides an integrated environment for loading, visualising, filtering, and annotating DAS recordings from multiple interrogator systems, without requiring any prior programming knowledge.
+
+DASexplorer was designed for efficient interactive navigation of large DAS datasets. Built on PyQt5 and pyqtgraph, it uses spatial decimation, parameter-based caching and smart rendering strategies to handle long acquisitions with minimal memory overhead. The application is interrogator-agnostic: a profile-based configuration system maps each acquisition system to its reader, file extensions and default visualisation parameters, making it straightforward to add support for new instruments.
+
+Key design principles:
+
+- **No-code** — the full analysis workflow is accessible through an intuitive GUI.
+- **Multi-interrogator** — natively supports HDAS 2.5 (Aragón Photonics), OptaSense (Luna Innovations) and OptoDAS (ASN/ Alcatel Subsea Networks) file formats; extensible to new systems.
+- **Research-ready** — exports data and annotations in formats directly usable by machine learning and bioacoustic analysis pipelines (NPZ, MAT, YOLO, COCO JSON, Raven Pro).
+
+
+## Citation
+
+If you use DASexplorer in your research, please cite:
+
+```bibtex
+@software{morellmonzo2026dasexplorer,
+  author       = {Morell-Monzó, Sergio},
+  title        = {DASexplorer},
+  version      = {1.0},
+  year         = {2026},
+  publisher    = {Zenodo},
+  doi          = {10.5281/zenodo.21032550},
+  url          = {https://doi.org/10.5281/zenodo.21032550}
+}
+```
+
+[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.21032550-blue)](https://doi.org/10.5281/zenodo.21032550)

dasexplorer-1.0.0/dasexplorer/__init__.py

@@ -0,0 +1,2 @@
+from dasexplorer.version import __version__
+__all__ = ["__version__"]

dasexplorer-1.0.0/dasexplorer/__main__.py

@@ -0,0 +1,60 @@
+"""
+DAS Explorer - entry point.
+
+Run with:
+    python -m dasexplorer
+or after pip install:
+    dasexplorer
+"""
+
+import os
+
+os.environ.setdefault("PYQTGRAPH_QT_LIB", "PyQt5")
+
+import sys
+
+import pyqtgraph as pg
+from PyQt5 import QtWidgets, QtGui
+
+from dasexplorer.gui.main_window import MainWindow
+from dasexplorer.gui import theme as theme_mod
+from dasexplorer.core.config import get_ui_defaults
+from dasexplorer.version import __version__
+
+pg.setConfigOptions(imageAxisOrder="row-major", antialias=False)
+
+DARK_STYLESHEET = theme_mod.build_stylesheet(theme_mod.DARK)
+
+
+def main():
+    if sys.platform == "win32":
+        import ctypes
+        try:
+            ctypes.windll.shell32.SetCurrentProcessExplicitAppUserModelID(
+                "IGIC-UPV.DASExplorer." + __version__
+            )
+        except Exception:
+            pass
+
+    app = QtWidgets.QApplication(sys.argv)
+
+    ui_cfg = get_ui_defaults()
+    saved_theme = str(ui_cfg.get("theme", "dark")).lower()
+    theme = theme_mod.set_current(saved_theme if saved_theme in theme_mod.THEMES else "dark")
+    pg.setConfigOption("background", theme["pg_background"])
+    pg.setConfigOption("foreground", theme["pg_foreground"])
+    app.setStyleSheet(theme_mod.build_stylesheet(theme))
+
+    # Icon path relative to the installed package location
+    icon_dir = os.path.dirname(os.path.abspath(__file__))
+    taskbar_icon_path = os.path.join(icon_dir, "icons", "icon_2.ico")
+    if os.path.isfile(taskbar_icon_path):
+        app.setWindowIcon(QtGui.QIcon(taskbar_icon_path))
+
+    win = MainWindow()
+    win.showMaximized()
+    sys.exit(app.exec_())
+
+
+if __name__ == "__main__":
+    main()

dasexplorer-1.0.0/dasexplorer/about.txt

@@ -0,0 +1,8 @@
+DASexplorer v1.0.0
+
+Visualization, analysis and annotation tool for DAS data.
+
+Sergio Morell-Monzó (sermomon@upv.es)
+UAG-UPV Underwater Acoustics Group - Universitat Politècnica de València
+
+GitHub: https://github.com/sermomon/DASexplorer

dasexplorer-1.0.0/dasexplorer/cfg/config.json

@@ -0,0 +1,82 @@
+{
+    "_comment": "DAS Explorer configuration. Each profile defines an interrogator + visualisation defaults.",
+    "_comment2": "null means 'use full range from file'. Add new profiles by duplicating an existing block.",
+    "default_profile": "hdas25_default",
+    "profiles": {
+        "hdas25_default": {
+            "label": "HDAS 2.5 (.bin) Default",
+            "interrogator": "hdas2.5",
+            "file_extensions": [
+                ".bin"
+            ],
+            "num_files": 1,
+            "tmin_s": null,
+            "tmax_s": null,
+            "dmin_m": null,
+            "dmax_m": null,
+            "vmin": 0.0,
+            "vmax": 12.0,
+            "colormap": "Rainbow",
+            "fmin_hz": 1.0,
+            "fmax_hz": null,
+            "fmax_offset_hz": 0.01,
+            "stride": 1,
+            "envelope": false,
+            "fk_cmin_ms": 100.0,
+            "fk_cmax_ms": 100000.0,
+            "fk_fmin_hz": 1.0,
+            "fk_fmax_hz": null,
+            "fk_fmax_offset_hz": 0.01,
+            "fk_envelope": false,
+            "default_view": "raw",
+            "rgb_rmin_hz": 1.0,
+            "rgb_rmax_hz": 5.0,
+            "rgb_gmin_hz": 5.0,
+            "rgb_gmax_hz": 15.0,
+            "rgb_bmin_hz": 15.0,
+            "rgb_bmax_hz": 40.0,
+            "rgb_percentile": 90.0
+        },
+        "optasense_default": {
+            "label": "OptaSense (.h5) Default",
+            "interrogator": "optasense",
+            "file_extensions": [
+                ".h5",
+                ".hdf5"
+            ],
+            "tmin_s": null,
+            "tmax_s": null,
+            "dmin_m": null,
+            "dmax_m": null,
+            "vmin": 0.0,
+            "vmax": 0.4,
+            "colormap": "Rainbow",
+            "fmin_hz": 10.0,
+            "fmax_hz": null,
+            "fmax_offset_hz": 0.01,
+            "stride": 1,
+            "envelope": true,
+            "fk_cmin_ms": 1400.0,
+            "fk_cmax_ms": 3500.0,
+            "fk_fmin_hz": 10.0,
+            "fk_fmax_hz": null,
+            "fk_fmax_offset_hz": 0.01,
+            "fk_envelope": true,
+            "default_view": "raw",
+            "rgb_rmin_hz": 1.0,
+            "rgb_rmax_hz": 5.0,
+            "rgb_gmin_hz": 5.0,
+            "rgb_gmax_hz": 15.0,
+            "rgb_bmin_hz": 15.0,
+            "rgb_bmax_hz": 40.0,
+            "rgb_percentile": 90.0,
+            "num_files": 1
+        }
+    },
+    "ui": {
+        "_comment": "App-wide UI settings (independent of profile).",
+        "colormap": "Rainbow",
+        "panel_width_fraction": 0.2,
+        "theme": "dark"
+    }
+}

dasexplorer-1.0.0/dasexplorer/core/analysis.py

@@ -0,0 +1,89 @@
+"""
+Analysis functions for DAS Explorer annotation windows.
+
+All functions operate on numpy arrays and return plain numpy results,
+with no Qt or pyqtgraph dependency.
+"""
+
+import numpy as np
+import scipy.signal as sp
+
+
+def compute_spectrogram(signal: np.ndarray, fs: float,
+                        nperseg: int = 256, noverlap: int = None,
+                        nfft: int = None):
+    """
+    Compute the spectrogram of a 1-D signal (PSD, dB scale).
+
+    Returns
+    -------
+    f : np.ndarray  frequency axis [Hz]
+    t : np.ndarray  time axis [s]
+    Sxx_db : np.ndarray  (n_freq, n_time) power in dB
+    """
+    n_samples = len(signal)
+
+    # Clamp nperseg to the number of available samples.
+    nperseg = min(nperseg, n_samples)
+
+    if noverlap is None:
+        noverlap = nperseg // 2
+    else:
+        # Clamp noverlap: must be strictly less than (possibly clamped) nperseg.
+        noverlap = min(noverlap, nperseg - 1)
+
+    if nfft is None:
+        nfft = nperseg
+    else:
+        nfft = max(nfft, nperseg)  # nfft must be >= nperseg
+
+    f, t, Sxx = sp.spectrogram(
+        signal, fs=fs,
+        nperseg=nperseg, noverlap=noverlap, nfft=nfft,
+        window='hann', scaling='density',
+    )
+    Sxx_db = 10.0 * np.log10(np.maximum(Sxx, 1e-20))
+    return f, t, Sxx_db
+
+
+def compute_spectrum(signal: np.ndarray, fs: float,
+                     nfft: int = 2048,
+                     window: str = 'hann') -> tuple:
+    """
+    Compute the magnitude spectrum of a 1-D signal.
+
+    Returns
+    -------
+    freqs : np.ndarray  frequency axis [Hz]
+    mag   : np.ndarray  magnitude spectrum
+    """
+    n = len(signal)
+    if window == 'hann':
+        w = np.hanning(n)
+    elif window == 'hamming':
+        w = np.hamming(n)
+    elif window == 'blackman':
+        w = np.blackman(n)
+    elif window == 'bartlett':
+        w = np.bartlett(n)
+    else:
+        w = np.ones(n)
+
+    F = np.fft.rfft(signal * w, n=nfft)
+    mag   = np.abs(F)
+    freqs = np.fft.rfftfreq(nfft, d=1.0 / fs)
+    return freqs, mag
+
+
+def select_channels_for_spectral(di0: int, di1: int,
+                                  max_n: int = 30) -> list:
+    """
+    Return up to max_n channel indices uniformly sampled in [di0, di1).
+    """
+    n = di1 - di0
+    if n <= 0:
+        return [di0]
+    if n <= max_n:
+        return list(range(di0, di1))
+    idx = np.round(np.linspace(di0, di1 - 1, max_n)).astype(int)
+    return sorted(set(idx.tolist()))