Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

Echopype

A package built to enable interoperability and scalability in ocean sonar data processing.
https://github.com/OSOceanAcoustics/echopype

Category: Biosphere
Sub Category: Marine Life and Fishery

Keywords

acoustics azfp echosounder ek60 ek80 netcdf ocean sonar xarray zarr

Keywords from Contributors

ecs evl evr region oceanography watersheds

Last synced: about 18 hours ago
JSON representation

Repository metadata

Enabling interoperability and scalability in ocean sonar data analysis

README.md

Echopype

ssec

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
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/OSOceanAcoustics/echopype-examples.

Contributing

You can find information about how to contribute to echopype at our Contributing Page.

Echopype doesn't run on your data?

Please report any bugs by creating issues on GitHub.

Pull requests are always welcome!

Contributors

Contributors

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

A complete list of direct contributors is on our GitHub Contributors Page.

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)
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)
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.

License

Echopype is licensed under the open source Apache 2.0 license.

Copyright (c) 2018-2026, Echopype Developers.

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Lee"
  given-names: "Wu-Jung"
  orcid: "https://orcid.org/0000-0002-4112-2034"
- family-names: "Setiawan"
  given-names: "Landung"
  orcid: "https://orcid.org/0000-0002-1624-2667"
- family-names: "Tuguinay"
  given-names: "Caesar"
  orcid: "https://orcid.org/0009-0000-6652-1093"
- family-names: "Mayorga"
  given-names: "Emilio"
  orcid: "https://orcid.org/0000-0003-2574-4623"
- family-names: "Staneva"
  given-names: "Valentina"
  orcid: "https://orcid.org/0000-0002-3412-0364"
title: "Echopype"
doi: 10.5281/zenodo.3906999
url: "https://github.com/OSOceanAcoustics/echopype"
preferred-citation:
  type: article
  authors:
  - family-names: "Lee"
    given-names: "Wu-Jung"
    orcid: "https://orcid.org/0000-0002-4112-2034"
  - family-names: "Setiawan"
    given-names: "Landung"
    orcid: "https://orcid.org/0000-0002-1624-2667"
  - family-names: "Tuguinay"
    given-names: "Caesar"
    orcid: "https://orcid.org/0009-0000-6652-1093"
  - family-names: "Mayorga"
    given-names: "Emilio"
    orcid: "https://orcid.org/0000-0003-2574-4623"
  - family-names: "Staneva"
    given-names: "Valentina"
    orcid: "https://orcid.org/0000-0002-3412-0364"
  doi: "10.1093/icesjms/fsae133"
  journal: "ICES Journal of Marine Science"
  month: 12
  start: 1941 # First page number
  end: 1951 # Last page number
  title: "Interoperable and scalable echosounder data processing with Echopype"
  issue: 10
  volume: 181
  year: 2024

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 1 day ago

Total Commits: 2,236
Total Committers: 41
Avg Commits per committer: 54.537
Development Distribution Score (DDS): 0.653

Commits in past year: 133
Committers in past year: 9
Avg Commits per committer in past year: 14.778
Development Distribution Score (DDS) in past year: 0.511

Name Email Commits
leewujung l****g@g****m 776
Kavin n****7@g****m 458
Landung Setiawan l****s@u****u 221
Emilio Mayorga e****a@g****m 112
dependabot[bot] 4****] 105
Caesar Tuguinay 8****y 86
pre-commit-ci[bot] 6****] 82
b-reyes 5****s 66
Lloyd Izard 7****d 65
Rick Towler r****r@g****m 41
imranmaj 4****j 37
rick.towler r****r@n****v 37
vagrant v****t@l****n 34
Praneeth Ratna 6****a 17
Valentina Staneva 1****s 11
Paul Robinson p****n@g****m 9
cyrf0006 F****r@d****a 9
FletcherFT f****x@g****m 8
Filipe Fernandes o****f@g****m 6
Chuck Anderson c****n@n****v 6
Dominic Bashford d****d@n****v 5
Shivam Agarwal 3****6 5
marianpena l****i@y****m 5
Andrei Rusu a****u@b****t 4
Aaron Marburg a****g@a****u 3
Anant Mittal a****l@c****u 3
Mark Langhirt m****t@g****m 3
Veronica Martinez v****z@n****v 3
Rob Blackwell r****8@b****k 2
Veronica Martinez v****z@c****l 2
and 11 more...

Committer domains:

Issue and Pull Request metadata

Last synced: about 23 hours ago

Total issues: 568
Total pull requests: 1,169
Average time to close issues: 5 months
Average time to close pull requests: 16 days
Total issue authors: 76
Total pull request authors: 40
Average comments per issue: 3.65
Average comments per pull request: 2.44
Merged pull request: 991
Bot issues: 0
Bot pull requests: 203

Past year issues: 32
Past year pull requests: 100
Past year average time to close issues: 4 months
Past year average time to close pull requests: 23 days
Past year issue authors: 12
Past year pull request authors: 14
Past year average comments per issue: 0.88
Past year average comments per pull request: 2.17
Past year merged pull request: 68
Past year bot issues: 0
Past year bot pull requests: 25

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/OSOceanAcoustics/echopype

Top Issue Authors

  • leewujung (238)
  • emiliom (84)
  • lsetiawan (56)
  • b-reyes (37)
  • ctuguinay (26)
  • LOCEANlloydizard (8)
  • ngkavin (8)
  • imranmaj (6)
  • oftfrfbf (6)
  • erinann (5)
  • rolandproud (4)
  • icaro-00 (3)
  • cywhale (3)
  • emma-ozanich (3)
  • Cristia7 (3)

Top Pull Request Authors

  • leewujung (298)
  • lsetiawan (154)
  • dependabot[bot] (129)
  • emiliom (111)
  • ctuguinay (83)
  • pre-commit-ci[bot] (74)
  • b-reyes (59)
  • ngkavin (57)
  • imranmaj (33)
  • LOCEANlloydizard (30)
  • praneethratna (27)
  • beatfactor (12)
  • anantmittal (10)
  • dbashford-NOAA (10)
  • shivam096 (9)

Top Issue Labels

  • enhancement (115)
  • bug (71)
  • data conversion (51)
  • conventions (49)
  • docs (32)
  • feature request (25)
  • infrastructure (24)
  • tests (22)
  • computation (19)
  • design (13)
  • dependencies (13)
  • processing functions (12)
  • my_files_don't_convert (8)
  • tracking issue (5)
  • product levels (4)
  • help wanted (4)
  • CodeUW (3)
  • good first issue (3)
  • data format (3)
  • GSoC24 (3)
  • AA SI (2)
  • investigation (2)
  • security (1)
  • potential future use (1)
  • duplicate (1)

Top Pull Request Labels

  • dependencies (139)
  • enhancement (96)
  • bug (89)
  • docs (62)
  • infrastructure (38)
  • data conversion (30)
  • conventions (28)
  • github_actions (22)
  • tests (19)
  • feature request (18)
  • Needs Complete Testing (17)
  • computation (10)
  • processing functions (9)
  • data format (7)
  • Need linting (6)
  • AA SI (5)
  • design (4)
  • potential future use (2)
  • help wanted (2)
  • product levels (2)
  • GSoC24 (1)
  • good first issue (1)
  • my_files_don't_convert (1)

Package metadata

proxy.golang.org: github.com/osoceanacoustics/echopype

proxy.golang.org: github.com/OSOceanAcoustics/echopype

pypi.org: echopype

Enhancing the interoperability and scalability in analyzing ocean sonar data

  • Homepage: https://github.com/OSOceanAcoustics/echopype
  • Documentation: https://echopype.readthedocs.io/
  • Licenses: Apache License, Version 2.0
  • Latest release: 0.11.0 (published 6 months ago)
  • Last Synced: 2026-04-06T23:01:59.345Z (11 days ago)
  • Versions: 35
  • Dependent Packages: 5
  • Dependent Repositories: 2
  • Downloads: 1,230 Last month
  • Rankings:
    • Forks count: 5.605%
    • Dependent packages count: 7.306%
    • Stargazers count: 7.874%
    • Average: 8.327%
    • Downloads: 9.055%
    • Dependent repos count: 11.793%
  • Maintainers (1)
conda-forge.org: echopype

  • Homepage: https://github.com/OSOceanAcoustics/echopype
  • Licenses: Apache-2.0
  • Latest release: 0.6.3 (published over 3 years ago)
  • Last Synced: 2026-04-02T15:47:57.786Z (15 days ago)
  • Versions: 15
  • Dependent Packages: 1
  • Dependent Repositories: 7
  • Rankings:
    • Dependent repos count: 12.838%
    • Forks count: 26.204%
    • Average: 26.23%
    • Dependent packages count: 28.954%
    • Stargazers count: 36.925%

Dependencies

.github/workflows/pr.yaml actions
  • actions/cache v5 composite
  • actions/checkout v6 composite
  • actions/download-artifact v8 composite
  • actions/setup-python v6.2.0 composite
  • actions/upload-artifact v7 composite
  • codecov/codecov-action v6 composite
  • tj-actions/changed-files v47 composite
  • cormorack/minioci latest docker
  • httpd 2.4 docker
.github/workflows/pypi.yaml actions
  • actions/checkout v6 composite
  • actions/download-artifact v8 composite
  • actions/setup-python v6.2.0 composite
  • actions/upload-artifact v7 composite
  • pypa/gh-action-pypi-publish v1.13.0 composite
.github/workflows/packit.yaml actions
  • actions/checkout v6 composite
  • actions/download-artifact v8 composite
  • actions/setup-python v6.2.0 composite
  • actions/upload-artifact v7 composite
.github/workflows/docker.yaml actions
  • ./.github/actions/gdrive-rclone * composite
  • actions/checkout v6 composite
  • docker/build-push-action v7 composite
  • docker/login-action v4 composite
  • docker/setup-buildx-action v4 composite
  • docker/setup-qemu-action v4 composite
  • jlumbroso/free-disk-space main composite
.github/workflows/ep-install.yaml actions
  • actions/checkout v6 composite
  • conda-incubator/setup-miniconda v3 composite
docs/requirements.txt pypi
  • jupyter-book <2.0
  • numpydoc *
  • sphinx-automodapi *
  • sphinx-panels *
  • sphinx_rtd_theme *
  • sphinxcontrib-mermaid *
setup.py pypi
requirements-dev.txt pypi
  • black * development
  • check-manifest * development
  • codespell * development
  • docker-compose * development
  • flake8 * development
  • flake8-builtins * development
  • flake8-comprehensions * development
  • flake8-mutable * development
  • flake8-print * development
  • isort * development
  • moto * development
  • mypy * development
  • numpydoc * development
  • pre-commit * development
  • pylint * development
  • pytest * development
  • pytest-cov * development
  • pytest-flake8 * development
  • pytest-mock * development
  • pytest-xdist * development
  • setuptools_scm * development
  • sphinx * development
  • sphinx-automodapi * development
  • sphinx_rtd_theme * development
  • sphinxcontrib-mermaid * development
  • twine * development
  • wheel * development
pyproject.toml pypi
.github/workflows/build.yaml actions
  • actions/cache v5 composite
  • actions/checkout v6 composite
  • actions/setup-python v6.2.0 composite
  • codecov/codecov-action v6 composite
  • cormorack/minioci latest docker
  • httpd 2.4 docker
requirements.txt pypi
  • aiohttp *
  • bottleneck *
  • dask *
  • dask-image *
  • flox >=0.7.2
  • fsspec *
  • geopy *
  • jinja2 *
  • netCDF4 >1.6
  • numpy *
  • pandas *
  • psutil >=5.9.1
  • pynmea2 *
  • pytz *
  • requests *
  • s3fs *
  • scipy *
  • typing-extensions *
  • xarray >=2024.11.0
  • zarr >=3

Score: 16.342523976596432