Skip to content

Open-source interface for processing recreation-grade side scan sonar datasets and reproducibly mapping benthic habitat

License

Notifications You must be signed in to change notification settings

CameronBodine/PINGMapper

Repository files navigation

PING-Mapper v3.0.0-alpha

PING-Mapper

GitHub last commit GitHub commit activity GitHub

Python Anaconda Numpy Pandas Tensorflow

Transform recordings from recreation-grade side scan sonar systems...

Video made with HumViewer

...into scientific datasets!

Overview

PING-Mapper is an open-source Python interface for reading and processing side scan sonar datasets and reproducibly mapping benthic habitat features. PING-Mapper transforms recreation-grade sonar systems into scientific data collectors, allowing researchers and citizens alike to reproducibly map their aquatic system with minimal expertise in data processing.

New Functionality & Bug Fixes (December 11, 2024)

  • PINGVerter - A Python-based convertor for sonar logs collected with consumer-grade fishfinders.
    • Support for Lowrance® *.sl2 and *.sl3 files!
    • Improved mechanism for reading sonar logs, inspired by sonarlight, resulting in ~1.3x speedup when running the Small Dataset Test.
  • Sonar log filtering based on heading deviation, speed, and Area of Interest (AOI) shapefile.
  • Export coverage and trackline shapefiles.
  • Fix bankline export.

See the v3.0.0-alpha release notes for more information

Key Functionality

  • PINGVerter - A Python-based convertor for sonar logs collected with consumer-grade fishfinders.

  • Export all metadata from .DAT, .SON, .sl2, and .sl3 files to .CSV.

  • Automatically detect depth (i.e. Zheng et al. 2021) and shadows in side scan channels .

  • Correct sonar backscatter with Empiracle Gain Normalization.

  • Export un-rectified sonar tiles with water column present (WCP) AND/OR export un-rectified sonograms with water column removed (WCR) using Humminbird depth estimates OR automated depth detections.

  • Export speed corrected un-rectified sonograms.

  • Smooth and interpolate GPS track points.

  • Export georectified WCP (spatially inaccurate due to presence of water column) AND/OR WCR sonar imagery for use in GIS w/wo shadows removed.

  • Mosaic georectified sonar imagery.

  • Automatically segment and classify substrate patches.

More information on PING-Mapper exports can be found here.

Compatible Sonar Systems

PING-Mapper is currently compatible with Humminbird® and Lowrance® side imaging sonar systems. The software has been tested with:

Humminbird® Models:

  • 998
  • 1198
  • 1199
  • Helix
  • Solix
  • Onix
  • Apex

Lowrance® File Formats:

  • sl2
  • sl3

If PING-Mapper doesn't work for your Humminbird® or Lowrance® sonar system, submit an Issue.

Software Documentation

There are several ways you can find out more about PING-Mapper. Check out the website, manuscripts, and Zenodo archives below. If you use PING-Mapper for your work, please cite the journal articles below.

Website

Check out PING-Mapper's website for more information.

PING-Mapper v2.0.0

The second version of PING-Mapper is available now. Check the release notes for more information.

Journal Article

Bodine, C. S., Buscombe, D., & Hocking, T. D. (2024). Automated river substrate mapping from sonar imagery with machine learning. Journal of Geophysical Research: Machine Learning and Computation, 1, e2024JH000135. https://doi.org/10.1029/2024JH000135

Preprint

Earth ArXiv Preprint DOI

Code

DOI

Segmentation models

DOI

Segmentation model training datasets

DOI

PING-Mapper v1.0.0

An overview of PING-Mapper v1.0.0 functionality and justification are published in AGU's Earth and Space Science scientific journal. If you use PING-Mapper for your work, please cite the article!

Journal Article

Bodine, C. S., Buscombe, D., Best, R. J., Redner, J. A., & Kaeser, A. J. (2022). PING-Mapper: Open-source software for automated benthic imaging and mapping using recreation-grade sonar. Earth and Space Science, 9, e2022EA002469. https://doi.org/10.1029/2022EA002469

Preprint

Earth ArXiv Preprint DOI

Code

DOI

Ready to get started?

Follow the installation and testing instructions to Get Started!

Acknowledgements

This study was made possible by a partnership between the U.S. Fish and Wildlife Service and Northern Arizona University. Funding for this work was provided by the Open Ocean Trustee Implementation Group to restore natural resources injured by the 2010 Deepwater Horizon oil spill in the Gulf of Mexico. The contents of this website are those of the authors and do not necessarily represent the views of the U.S. Fish and Wildlife Service or Northern Arizona University.

Primary Developer: Cameron S. Bodine

Co-Developer: Daniel Buscombe

Thanks to project collaborators Adam Kaeser (USFWS), Channing St. Aubin (USFWS), Mike Andres (USM), Kasea Price (USM), Alyssa Pagel (USM), Eric Haffey (USM), and Katherine Wright (USM).

A special thanks to advocates and early-adoptors including, but not limited to, Jennylyn Redner, Adrian Pinchbeck, Art Trembanis, Dan Carlson, Alan Ryon, Mirko Denecke, Dan Haught, Dan Hamill, Mark Lundine, Elizabeth Greenheck, Hendra Kurnia Febriawan, Bryan Bozeman, Paul Grams, Matt Kaplinski, Jess Kozarek, Chris Milliren, Brett Connell, James Parham and Vincent Capone.

Cameron wishes to thank his PhD dissertation committee chair Toby Hocking, co-chair and advisor Dan Buscombe, Rebecca Best, and Adam Kaeser.

Future Development, Collaborations, & Partnerships

If you are interested in partnering on future developments, please reach out to Cameron Bodine.

PING-Mapper is part of the Doodleverse!

153729377-e16d0679-ca0d-4d0d-a9f9-90306ba2f871

The Doodleverse is an opinionated collection of Python packages designed for geoscientific image segmentation. Find out more on GitHub.