Echopype

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

Category: Biosphere
Sub Category: Marine Life and Fishery

Keywords

acoustics azfp echosounder ek60 ek80 netcdf ocean sonar xarray zarr

Keywords from Contributors

oceanography watersheds ecs evl evr region hydrology

Last synced: about 4 hours ago
JSON representation

Repository metadata

Enabling interoperability and scalability in ocean sonar data analysis

Host: GitHub
URL: https://github.com/echostack-org/echopype
Owner: echostack-org
License: apache-2.0
Created: 2018-08-26T00:59:09.000Z (almost 8 years ago)
Default Branch: main
Last Pushed: 2026-06-29T22:12:29.000Z (7 days ago)
Last Synced: 2026-06-29T23:17:24.700Z (7 days ago)
Topics: acoustics, azfp, echosounder, ek60, ek80, netcdf, ocean, sonar, xarray, zarr
Language: Python
Homepage: https://echopype.readthedocs.io/
Size: 99.1 MB
Stars: 138
Watchers: 16
Forks: 91
Open Issues: 117
Releases: 36
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff

Echopype

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/echostack-org/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

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.

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

Name: echostack
Login: echostack-org
Email:
Kind: organization
Description: Home for open source tools and resources in ocean acoustics
Website:
Location:
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/42682187?v=4
Repositories: 6
Last ynced at: 2026-05-21T09:53:13.805Z
Profile URL: https://github.com/echostack-org

GitHub Events

Total

Delete event: 1
Pull request event: 1
Push event: 13
Pull request review comment event: 1
Create event: 1

Last Year

Delete event: 1
Pull request event: 1
Push event: 13
Pull request review comment event: 1
Create event: 1

Committers metadata

Last synced: 4 days ago

Total Commits: 2,281
Total Committers: 42
Avg Commits per committer: 54.31
Development Distribution Score (DDS): 0.659

Commits in past year: 172
Committers in past year: 9
Avg Commits per committer in past year: 19.111
Development Distribution Score (DDS) in past year: 0.471

Name	Email	Commits
leewujung	l**g@g**m	778
Kavin	n**7@g**m	458
Landung Setiawan	l**s@u**u	221
Emilio Mayorga	e**a@g**m	112
dependabot[bot]	4****]	110
Lloyd Izard	7****d	91
pre-commit-ci[bot]	6****]	91
Caesar Tuguinay	8****y	86
b-reyes	5****s	66
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
Chuck Anderson	c**n@n**v	6
Filipe Fernandes	o**f@g**m	6
Andrei Rusu	a**u@b**t	5
Dominic Bashford	d**d@n**v	5
Shivam Agarwal	3****6	5
marianpena	l**i@y**m	5
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 12 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 10 days ago

Total issues: 8
Total pull requests: 10
Average time to close issues: 32 minutes
Average time to close pull requests: about 1 hour
Total issue authors: 2
Total pull request authors: 3
Average comments per issue: 0.25
Average comments per pull request: 0.0
Merged pull request: 9
Bot issues: 0
Bot pull requests: 3

Past year issues: 8
Past year pull requests: 10
Past year average time to close issues: 32 minutes
Past year average time to close pull requests: about 1 hour
Past year issue authors: 2
Past year pull request authors: 3
Past year average comments per issue: 0.25
Past year average comments per pull request: 0.0
Past year merged pull request: 9
Past year bot issues: 0
Past year bot pull requests: 3

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

Top Issue Authors

LOCEANlloydizard (7)
leewujung (1)

Top Pull Request Authors

LOCEANlloydizard (7)
pre-commit-ci[bot] (2)
dependabot[bot] (1)

Top Issue Labels

tests (3)
bug (3)
good first issue (1)
docs (1)

Top Pull Request Labels

github_actions (1)
dependencies (1)

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: 9.278933163441794

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

Echopype

Keywords

Keywords from Contributors

Repository metadata

README.md

Echopype

Documentation

Contributing

Echopype doesn't run on your data?

Contributors

Acknowledgement

License

Citation (CITATION.cff)

Owner metadata

GitHub Events

Total

Last Year

Committers metadata

Committer domains:

Issue and Pull Request metadata

Top Issue Authors

Top Pull Request Authors

Top Issue Labels

Top Pull Request Labels

Dependencies