{"id":21959990,"url":"https://github.com/osoceanacoustics/echoregions","last_synced_at":"2025-04-23T18:20:36.401Z","repository":{"id":37942025,"uuid":"332865211","full_name":"OSOceanAcoustics/echoregions","owner":"OSOceanAcoustics","description":"Interfacing water column sonar data with annotations and labels","archived":false,"fork":false,"pushed_at":"2025-03-07T22:54:07.000Z","size":833825,"stargazers_count":6,"open_issues_count":15,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-30T02:11:30.718Z","etag":null,"topics":["ecs","evl","evr","parser","plotting","region"],"latest_commit_sha":null,"homepage":"https://echoregions.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OSOceanAcoustics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-25T19:50:50.000Z","updated_at":"2025-03-07T22:54:11.000Z","dependencies_parsed_at":"2023-09-28T21:49:30.053Z","dependency_job_id":"11e3744d-39b1-438f-b0cb-63be8ce2bfb8","html_url":"https://github.com/OSOceanAcoustics/echoregions","commit_stats":{"total_commits":268,"total_committers":9,"mean_commits":29.77777777777778,"dds":0.5932835820895522,"last_synced_commit":"dd81e2f21f79cd21fcf4fa3b16702df99ac4e0c9"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSOceanAcoustics%2Fechoregions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSOceanAcoustics%2Fechoregions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSOceanAcoustics%2Fechoregions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OSOceanAcoustics%2Fechoregions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OSOceanAcoustics","download_url":"https://codeload.github.com/OSOceanAcoustics/echoregions/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250487622,"owners_count":21438626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ecs","evl","evr","parser","plotting","region"],"created_at":"2024-11-29T09:36:44.413Z","updated_at":"2025-04-23T18:20:36.396Z","avatar_url":"https://github.com/OSOceanAcoustics.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Echoregions\n\n\u003cdiv\u003e\n    \u003ca href=\"https://raw.githubusercontent.com/OSOceanAcoustics/echoregions/master/LICENSE\"\u003e\n        \u003cimg alt=\"GitHub License\" src=\"https://img.shields.io/github/license/OSOceanAcoustics/echoregions\"\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv\u003e\n    \u003ca href=\"https://github.com/OSOceanAcoustics/echoregions/actions/workflows/pytest.yml\"\u003e\n        \u003cimg src=\"https://github.com/OSOceanAcoustics/echoregions/actions/workflows/pytest.yml/badge.svg\" alt=\"build\"/\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://echoregions.readthedocs.io/en/latest/?badge=latest\"\u003e\n        \u003cimg src=\"https://readthedocs.org/projects/echoregions/badge/?version=latest\"  alt=\"Readthedocs\"/\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv\u003e\n    \u003ca href=\"https://pypi.org/project/echoregions/\"\u003e\n        \u003cimg src=\"https://img.shields.io/pypi/v/echoregions.svg\" alt=\"PyPI version\"/\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://anaconda.org/conda-forge/echoregions\"\u003e\n        \u003cimg src=\"https://img.shields.io/conda/vn/conda-forge/echoregions.svg\" alt=\"Conda version\"/\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n\nEchoregions is a Python Package that interfaces with annotations of water column sonar data for training machine learning models or doing other downstream processing such as biomass estimation.\n\nThe annotations are typically regions indicating the presence of specific animal species or lines delineating ocean boundaries, such as the seafloor or sea surface, in the \"echogram\" (sonar images formed by echo returns). The interfacing functionalities operate in two directions:\n- Annotation to ML: Parsing and organizing annotations for preparing training and test datasets for ML developments\n- ML to annotation: Generating annotations from ML predictions that can be used for further downstream processing\n\nAt present, functionalities in the Annotation to ML direction have been built for interfacing the [Echoview](https://echoview.com/products-and-services/echoview/) software that is widely used in the fisheries acoustics community. We plan to add functionalities in the ML to Annotation direction in the near future.\n\n## Functionalities\n\nAs of now, Echoregions contains functions to:\n- Read, organize, and store Echoview manual annotations (regions and lines)\n- Create masks by combining the manual annotations and xarray water column sonar datasets generated by [Echopype](https://github.com/OSOceanAcoustics/echopype)\n\nNote that in Echoregions, the underlying annotation data is stored as a Pandas dataframe, which allows users to directly leverage the powerful indexing and computing functionalities provided by Pandas.\n\n## Documentation\n\nLearn more about Echoregions functions in the documentation at https://echoregions.readthedocs.io.\n\nSee the [API documentation](https://echoregions.readthedocs.io/en/latest/api.html) for all of the classes and functions available in echoregions.\n\n## Contributors\n\nEchoregions development is currently led by Caesar Tuguinay([@ctuguinay](https://github.com/ctuguinay)), with inputs from Wu-Jung Lee ([@leewujung](https://github.com/leewujung)) and Valentina Staneva ([@valentina-s](https://github.com/valentina-s)). Kavin Nguyen ([@ngkavin](https://github.com/ngkavin)) contributed significantly to the initial version.\n\n## Acknowledgement\n\nWe thank the NOAA Northwest Fisheries Science Center (NWFSC) Fisheries Engineering and Acoustics Team (FEAT) for supporting this project.\n\n\u003cimg src=\"docs/source/images/noaa_fisheries_logo.png\" alt=\"NOAA_fisheries_logo\" width=\"200\"\u003e\n\n## License\n\nEchoregions is licensed under the open source [Apache 2.0 license](https://opensource.org/licenses/Apache-2.0).\n\n---------------\n\nCopyright (c) 2021-2025, Echoregions Developers.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosoceanacoustics%2Fechoregions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fosoceanacoustics%2Fechoregions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosoceanacoustics%2Fechoregions/lists"}