Metadata-Version: 2.4
Name: echopype
Version: 0.12.0
Summary: Enhancing the interoperability and scalability in analyzing ocean sonar data
Author-email: Wu-Jung Lee <leewujung@gmail.com>
Maintainer-email: Wu-Jung Lee <leewujung@gmail.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/echostack-org/echopype
Project-URL: Repository, https://github.com/echostack-org/echopype
Project-URL: Documentation, https://echopype.readthedocs.io
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering
Requires-Python: <3.15,>=3.13
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.10.9
Requires-Dist: bottleneck>=1.4.1
Requires-Dist: dask[array,distributed]>=2024.10.0
Requires-Dist: dask-image>=2025.11.0
Requires-Dist: flox>=0.9.14
Requires-Dist: fsspec>=2024.10.0
Requires-Dist: geopy>=2.5.0
Requires-Dist: jinja2>=3.1.5
Requires-Dist: netCDF4>=1.7.2
Requires-Dist: numpy>=2.3.0
Requires-Dist: pandas>=2.3.0
Requires-Dist: psutil>=6.1.0
Requires-Dist: pynmea2
Requires-Dist: pytz>=2025.1
Requires-Dist: requests>=2.32.4
Requires-Dist: s3fs>=2024.10.0
Requires-Dist: scipy>=1.15.0
Requires-Dist: typing-extensions>=4.13.0
Requires-Dist: xarray>=2026.01.0
Requires-Dist: zarr>=3
Provides-Extra: plot
Requires-Dist: matplotlib>=3.11.0; extra == "plot"
Requires-Dist: cmocean; extra == "plot"
Dynamic: license-file

<div align="center">
  <img src="https://raw.githubusercontent.com/echostack-org/echopype/main/docs/source/_static/echopype_logo_banner.png" width="400">
</div>

# Echopype

<p align="center">
  <a href="https://doi.org/10.5281/zenodo.3906999"><img src="https://img.shields.io/badge/DOI-10.5281/zenodo.3906999-blue" alt="DOI"></a>
  <a href="https://raw.githubusercontent.com/echostack-org/echopype/main/LICENSE"><img src="https://img.shields.io/github/license/echostack-org/echopype" alt="License"></a>
  <a href="https://scientific-python.org/specs/spec-0000/"><img src="https://img.shields.io/badge/SPEC-0-green?labelColor=%23004811&color=%235CA038" alt="SPEC 0"></a>
  <a href="https://github.com/echostack-org/echopype/actions/workflows/build.yaml"><img src="https://github.com/echostack-org/echopype/actions/workflows/build.yaml/badge.svg"></a>
  <a href="https://results.pre-commit.ci/latest/github/echostack-org/echopype/main"><img src="https://results.pre-commit.ci/badge/github/echostack-org/echopype/main.svg"></a>
  <a href="https://echopype.readthedocs.io"><img src="https://readthedocs.org/projects/echopype/badge/?version=latest"></a>
  <a href="https://codecov.io/gh/echostack-org/echopype"><img src="https://codecov.io/gh/echostack-org/echopype/branch/main/graph/badge.svg?token=GT98F919XR"></a>
  <a href="https://pypi.org/project/echopype/"><img src="https://img.shields.io/pypi/v/echopype.svg"></a>
  <a href="https://anaconda.org/conda-forge/echopype"><img src="https://img.shields.io/conda/vn/conda-forge/echopype.svg"></a>
  <a href="https://escience.washington.edu/echopype/"><img src="https://img.shields.io/badge/SSEC-Project-purple?logo=data:image/png;base64,...&style=plastic"></a>
</p>

Echopype is a package built to enable interoperability and scalability in ocean sonar data processing. These data are widely used for obtaining information about the distribution and abundance of marine animals, such as fish and krill. Our ability to collect large volumes of sonar data from a variety of ocean platforms has grown significantly in the last decade. However, most of the new data remain under-utilized. echopype aims to address the root cause of this problem - the lack of interoperable data format and scalable analysis workflows that adapt well with increasing data volume - by providing open-source tools as entry points for scientists to make discovery using these new data.

Watch the [echopype talk](https://www.youtube.com/watch?v=qboH7MyHrpU)
at SciPy 2019 for background, discussions and a quick demo!


## Documentation

Learn more about echopype in the official documentation at https://echopype.readthedocs.io. Check out executable examples in the companion repository https://github.com/echostack-org/echopype-examples.

## Dependency support policy

Echopype follows [Scientific Python SPEC 0](https://scientific-python.org/specs/spec-0000/) for its minimum supported Python and core dependency versions.

## Contributing

You can find information about how to contribute to echopype at our [Contributing Page](https://echopype.readthedocs.io/en/latest/contrib_start.html#contributing-to-echopype).

## Echopype doesn't run on your data?

Please report any bugs by [creating issues on GitHub](https://medium.com/nyc-planning-digital/writing-a-proper-github-issue-97427d62a20f).

[Pull requests](https://jarednielsen.com/learn-git-fork-pull-request/) are always welcome!

## Contributors

[![Contributors](https://contrib.rocks/image?repo=echostack-org/echopype)](https://github.com/echostack-org/echopype/graphs/contributors)

Wu-Jung Lee ([@leewujung](https://github.com/leewujung))
founded the echopype project in 2018 and continue to be the primary contributor
together with Caesar Tuguinay([@ctuguinay](https://github.com/ctuguinay)).
Emilio Mayorga ([@emiliom](https://github.com/emiliom)),
Landung "Don" Setiawan ([@lsetiawan](https://github.com/lsetiawan)),
Praneeth Ratna([@praneethratna](https://github.com/praneethratna)),
Brandon Reyes ([@b-reyes](https://github.com/b-reyes)),
Kavin Nguyen ([@ngkavin](https://github.com/ngkavin))
and Imran Majeed ([@imranmaj](https://github.com/imranmaj))
have contributed significantly to the code.
Valentina Staneva ([@valentina-s](https://github.com/valentina-s)) is also part of the development team. Lloyd Izard ([@LOCEANlloydizard](https://github.com/LOCEANlloydizard)) joined the project in 2025
and is an active contributor.

A complete list of direct contributors is on our [GitHub Contributors Page](https://github.com/echostack-org/echopype/graphs/contributors).


## Acknowledgement

We thank all previous and current contributors to Echopype,
including those whose contributions do not include code.
We thank Dave Billenness of ASL Environmental Sciences for
providing the AZFP Matlab Toolbox as reference for developing
support for the AZFP echosounder,
Rick Towler ([@rhtowler](https://github.com/rhtowler))
of the NOAA Alaska Fisheries Science Center
for providing low-level file parsing routines for
Simrad EK60 and EK80 echosounders,
and Alejandro Ariza ([@alejandro-ariza](https://github.com/alejandro-ariza))
for developing NumPy implementation of
acoustic analysis functions via Echopy, which
we referenced for several Echopype functions.

We thank funding support from the National Science Foundation,
NOAA Ocean Exploration, NOAA Fisheries,
and the VOTO Foundation.
We also acknowledge software engineering support from
the University of Washington Scientific Software Engineering Center (SSEC),
as part of the Schmidt Sciences Virtual Institute for Scientific Software (VISS) in 2023.

<table align="center" border="0" cellpadding="12" cellspacing="0" style="border-collapse: collapse;">
  <tr>
    <td align="center" style="border: 0;">
      <a href="https://oceanexplorer.noaa.gov/news/oer-updates/2021/fy21-ffo-schedule.html" style="text-decoration:none;">
        <img src="docs/source/_static/logos/noaa.png" alt="NOAA" width="120">
      </a>
    </td>
    <td align="center" style="border: 0;">
      <a href="https://www.nsf.gov/awardsearch/showAward?AWD_ID=1849930&HistoricalAwards=false" style="text-decoration:none;">
        <img src="docs/source/_static/logos/nsf.png" alt="NSF" width="120">
      </a>
    </td>
    <td align="center" style="border: 0;">
      <a href="https://escience.washington.edu/software-engineering/ssec/" style="text-decoration:none;">
        <img src="docs/source/_static/logos/ssec.png" alt="SSEC" width="120">
      </a>
    </td>
    <td align="center" style="border: 0;">
      <a href="https://voiceoftheocean.org/" style="text-decoration:none;">
        <img src="docs/source/_static/logos/voto.png" alt="VOTO Foundation" width="120">
      </a>
    </td>
  </tr>
</table>


## License

Echopype is licensed under the open source [Apache 2.0 license](https://opensource.org/licenses/Apache-2.0).

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

Copyright (c) 2018-2026, Echopype Developers.
