open-ocean-sounding / echopy

Fisheries acoustic data processing in Python
MIT License
10 stars 7 forks source link


PyPI - Python Version Lifecycle PyPI - Downloads GitHub

Echopy is a multipurpose library containing common algorithms for fisheries acoustic data processing, such as background noise correction, removal of seabed and corrupted pings, target detection, multifrequency analysis, and binning. The library provides building blocks that can be assembled for a variety of fisheries acoustics applications and is committed to transparency, cooperation, and universal access in fisheries acoustics software.

See the tests directory for code usage examples.

Installation

Echopy requires Python 3.6

To install echopy and all its requirements type the following in your preferred command-line terminal:

pip install echopy

or install the latest version available in the develop branch by cloning the repository:

git clone https://github.com/open-ocean-sounding/echopy.git
pip install ./echopy

An experimental conda package for Python 3.6 and higher is available on conda-forge. However, use with care, as it has not been tested extensively. To install in a conda environment using the terminal:

conda install -c conda-forge echopy

Contributing

Echopy has essentially grown from code that was initially implemented to support specific research projects, and later made publicly available for the benefit of all. If you work in fisheries acoustics, there are several ways you can contribute to improve Echopy. You might create an issue, propose an improvement or report a bug, or even create your own repository branch, work on it, and send pull requests to the main branch. By doing so, you can give visibility to your algorithms in fisheries acoustics, while making life easier for your colleagues. Echopy has an acknowledgments policy to make sure that your work is credited. Check out the contribution section if you want to be part of Echopy.

Maintainers

Contributors

Acknowledgments

Echopy does not currently have any direct funding, but benefits from the hard work, time and support of researchers and their institutions. We acknowledge all contributors and institutions involved with special mention of the British Antarctic Survey project RapidKrill, and The Antarctic Wildlife Research Fund (AWR) for releasing the first version and giving life to Echopy.

License

This software is licensed under the MIT License.

Contact

echopy@protonmail.com