[)](https://pypi.org/project/pingverter/)
A Python-based convertor for sonar logs collected with consumer-grade fishfinders.
`PINGVerter` is designed to pre-process sonar logs for [PINGMapper](https://cameronbodine.github.io/PINGMapper/) post-processing. *It is not intended to function as a stand-alone package.*
## Compatibility
- [Humminbird](https://humminbird.johnsonoutdoors.com/) ( *.DAT/ *.SON/ *.IDX)
- [Lowrance](https://www.lowrance.com/) ( *.sl2 / *.sl3)
## Installation
```bash
pip install pingverter
```
## Usage - Example Only
`PINGVerter` *can* be used as a stand-alone engine for decoding sonar logs and exporting ping attributes to CSV. While this functionality is described here, please use [PINGMapper](https://cameronbodine.github.io/PINGMapper/) for all sonar log processing.
### Humminbird
```python
# Import
from pingverter import hum2pingmapper
# Parameters
inFile = r'C:\Path\To\Recording\Rec00001.DAT'
projDir = r'C:\Path\To\Outputs\MyProject'
sonar_object = hum2pingmapper(inFile, projDir)
```
### Lowrance
```python
# Import
from pingverter import low2pingmapper
# Parameters
inFile = r'C:\Path\To\Recording\Rec00001.DAT'
projDir = r'C:\Path\To\Outputs\MyProject'
sonar_object = low2pingmapper(inFile, projDir)
```
Outputs from the above examples will be exported to `C:\Path\To\Outputs\MyProject\meta`.
## Acknowledgments
`PINGVerter` has been made possible through mentorship, partnerships, financial support, open-source software, manuscripts, and documentation linked below.
*NOTE: The contents of this repository are those of the author(s) and do not necessarily represent the views of the individuals and organizations specifically mentioned here.*
- [Dr. Arthur Trembanis](https://www.udel.edu/academics/colleges/ceoe/departments/smsp/faculty/arthur-trembanis/) (Post-Doc Advisor) & [Dr. Daniel Buscombe](https://github.com/dbuscombe-usgs) (PhD Advisor)
- [Coastal Sediments, Hydrodynamics and Engineering Lab (CSHEL)](https://sites.udel.edu/ceoe-art/), [College of Earth, Ocean, & Environment (CEOE)](https://www.udel.edu/ceoe/), [University of Delaware](https://www.udel.edu/)
- [PINGMapper](https://cameronbodine.github.io/PINGMapper/)
- 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
- 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
- [PyHum](https://github.com/BenthicSubstrateMapping/PyHum)
- Buscombe, D., Grams, P.E., and Smith, S. (2015) "Automated riverbed sediment classification using low-cost sidescan sonar", Journal of Hydraulic Engineering, https://doi.org/10.1061/(ASCE)HY.1943-7900.0001079, 06015019.
- Buscombe, D., 2017, Shallow water benthic imaging and substrate characterization using recreational-grade sidescan-sonar. ENVIRONMENTAL MODELLING & SOFTWARE 89, 1-18.
- [SL3Reader](https://github.com/halmaia/SL3Reader)
- Halmai, Akos; Gradwohl Valkay, Alexandra; Czigany, Szabolcs; Ficsor, Johanna; Liptay, ZoltAn Arpad; Kiss, Kinga; Loczy, Denes and Pirkhoffer, Ervin. 2020. "Applicability of a Recreational-Grade Interferometric Sonar for the Bathymetric Survey and Monitoring of the Drava River" ISPRS International Journal of Geo-Information 9, no. 3: 149. https://doi.org/10.3390/ijgi9030149
- [sonarlight](https://github.com/KennethTM/sonarlight) - Kenneth Thoro Martinsen
- [Navico (Lowrance, Simrad, B&G) Sonar Log File Format](https://www.memotech.franken.de/FileFormats/Navico_SLG_Format.pdf) - Herbert Oppmann
- [Vincent Capone](https://blacklaserlearning.com/) - Black Laser Learning
## Future Development, Collaborations, & Partnerships
If you are interested in partnering on future developments, please reach out to [Cameron Bodine](https://cameronbodine.github.io/).
Raw data
{
"_id": null,
"home_page": null,
"name": "pingverter",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "pingmapper, sonar, ecology, remotesensing, sidescan, sidescan-sonar, aquatic, humminbird, lowrance, gis, oceanography, limnology",
"author": "Cameron Bodine",
"author_email": "bodine.cs@gmail.email",
"download_url": "https://files.pythonhosted.org/packages/1e/5e/959d14ec59b30e8d5b22008016ef3d5e5ccc19ce3ea521add9064e46ada0/pingverter-1.0.2.tar.gz",
"platform": null,
"description": "[)](https://pypi.org/project/pingverter/)\r\n\r\n\r\nA Python-based convertor for sonar logs collected with consumer-grade fishfinders.\r\n\r\n`PINGVerter` is designed to pre-process sonar logs for [PINGMapper](https://cameronbodine.github.io/PINGMapper/) post-processing. *It is not intended to function as a stand-alone package.*\r\n\r\n## Compatibility\r\n\r\n- [Humminbird](https://humminbird.johnsonoutdoors.com/) ( *.DAT/ *.SON/ *.IDX)\r\n- [Lowrance](https://www.lowrance.com/) ( *.sl2 / *.sl3)\r\n\r\n## Installation\r\n\r\n\r\n```bash\r\npip install pingverter\r\n```\r\n\r\n## Usage - Example Only\r\n\r\n`PINGVerter` *can* be used as a stand-alone engine for decoding sonar logs and exporting ping attributes to CSV. While this functionality is described here, please use [PINGMapper](https://cameronbodine.github.io/PINGMapper/) for all sonar log processing.\r\n\r\n### Humminbird\r\n```python\r\n# Import\r\nfrom pingverter import hum2pingmapper\r\n\r\n# Parameters\r\ninFile = r'C:\\Path\\To\\Recording\\Rec00001.DAT'\r\nprojDir = r'C:\\Path\\To\\Outputs\\MyProject'\r\n\r\nsonar_object = hum2pingmapper(inFile, projDir)\r\n```\r\n\r\n### Lowrance\r\n```python\r\n# Import\r\nfrom pingverter import low2pingmapper\r\n\r\n# Parameters\r\ninFile = r'C:\\Path\\To\\Recording\\Rec00001.DAT'\r\nprojDir = r'C:\\Path\\To\\Outputs\\MyProject'\r\n\r\nsonar_object = low2pingmapper(inFile, projDir)\r\n```\r\n\r\nOutputs from the above examples will be exported to `C:\\Path\\To\\Outputs\\MyProject\\meta`.\r\n\r\n## Acknowledgments\r\n\r\n`PINGVerter` has been made possible through mentorship, partnerships, financial support, open-source software, manuscripts, and documentation linked below.\r\n\r\n*NOTE: The contents of this repository are those of the author(s) and do not necessarily represent the views of the individuals and organizations specifically mentioned here.*\r\n\r\n- [Dr. Arthur Trembanis](https://www.udel.edu/academics/colleges/ceoe/departments/smsp/faculty/arthur-trembanis/) (Post-Doc Advisor) & [Dr. Daniel Buscombe](https://github.com/dbuscombe-usgs) (PhD Advisor)\r\n- [Coastal Sediments, Hydrodynamics and Engineering Lab (CSHEL)](https://sites.udel.edu/ceoe-art/), [College of Earth, Ocean, & Environment (CEOE)](https://www.udel.edu/ceoe/), [University of Delaware](https://www.udel.edu/)\r\n- [PINGMapper](https://cameronbodine.github.io/PINGMapper/)\r\n - 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\r\n - 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\r\n\r\n\r\n- [PyHum](https://github.com/BenthicSubstrateMapping/PyHum)\r\n - Buscombe, D., Grams, P.E., and Smith, S. (2015) \"Automated riverbed sediment classification using low-cost sidescan sonar\", Journal of Hydraulic Engineering, https://doi.org/10.1061/(ASCE)HY.1943-7900.0001079, 06015019.\r\n - Buscombe, D., 2017, Shallow water benthic imaging and substrate characterization using recreational-grade sidescan-sonar. ENVIRONMENTAL MODELLING & SOFTWARE 89, 1-18.\r\n- [SL3Reader](https://github.com/halmaia/SL3Reader)\r\n - Halmai, Akos; Gradwohl Valkay, Alexandra; Czigany, Szabolcs; Ficsor, Johanna; Liptay, ZoltAn Arpad; Kiss, Kinga; Loczy, Denes and Pirkhoffer, Ervin. 2020. \"Applicability of a Recreational-Grade Interferometric Sonar for the Bathymetric Survey and Monitoring of the Drava River\" ISPRS International Journal of Geo-Information 9, no. 3: 149. https://doi.org/10.3390/ijgi9030149\r\n- [sonarlight](https://github.com/KennethTM/sonarlight) - Kenneth Thoro Martinsen\r\n- [Navico (Lowrance, Simrad, B&G) Sonar Log File Format](https://www.memotech.franken.de/FileFormats/Navico_SLG_Format.pdf) - Herbert Oppmann\r\n- [Vincent Capone](https://blacklaserlearning.com/) - Black Laser Learning\r\n\r\n\r\n## Future Development, Collaborations, & Partnerships\r\n\r\nIf you are interested in partnering on future developments, please reach out to [Cameron Bodine](https://cameronbodine.github.io/).\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A Python-based converter for sonar logs used by PINGMapper",
"version": "1.0.2",
"project_urls": null,
"split_keywords": [
"pingmapper",
" sonar",
" ecology",
" remotesensing",
" sidescan",
" sidescan-sonar",
" aquatic",
" humminbird",
" lowrance",
" gis",
" oceanography",
" limnology"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6cfce07be8a1e73c517efb4b22170428608219029f19a486b7aad0b90e132224",
"md5": "14da120384ebf3e41ff8c7acacc21c36",
"sha256": "007f4f93399748c28dd047782f8fb9f0df5fcf21eb1ddfc8672eb8aa33bf2f21"
},
"downloads": -1,
"filename": "pingverter-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "14da120384ebf3e41ff8c7acacc21c36",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 36211,
"upload_time": "2025-01-05T19:22:27",
"upload_time_iso_8601": "2025-01-05T19:22:27.301364Z",
"url": "https://files.pythonhosted.org/packages/6c/fc/e07be8a1e73c517efb4b22170428608219029f19a486b7aad0b90e132224/pingverter-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1e5e959d14ec59b30e8d5b22008016ef3d5e5ccc19ce3ea521add9064e46ada0",
"md5": "f88f57a526591b81306e5a138acee5ca",
"sha256": "d6c5fab08a25313aec97f2832cfe357fe049814911e2d02d0c6b719ac3b37b22"
},
"downloads": -1,
"filename": "pingverter-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "f88f57a526591b81306e5a138acee5ca",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 31014,
"upload_time": "2025-01-05T19:22:29",
"upload_time_iso_8601": "2025-01-05T19:22:29.721410Z",
"url": "https://files.pythonhosted.org/packages/1e/5e/959d14ec59b30e8d5b22008016ef3d5e5ccc19ce3ea521add9064e46ada0/pingverter-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-05 19:22:29",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pingverter"
}
JSON