Provides Python-based functionality for pulling telemetry from the microSWIFT wave buoy developed at the University of Washington Applied Physics Laboratory (UW-APL).
This package contains python functions for programmatically accessing and compiling microSWIFT data from the UW-APL SWIFT server at http://swiftserver.apl.washington.edu/ (base URL). The primary functions are contained in the pull_telemetry.py
module and include:
pull_telemetry_as_var()
— return request as a variable in memorypull_telemetry_as_zip()
— return request as a .zip filepull_telemetry_as_json()
— return request as JSON-formatted textpull_telemetry_as_kml()
— return a .kml file of GPS positions
See examples/ for usage.
NOTE:
Please note this package is only developed to work with microSWIFTs and not the larger SWIFT buoys.
For a MALTAB-based implementation that works for the entire suite of SWIFTs, see SWIFT-codes
and the pullSWIFTtelemetry.m
function at https://github.com/SASlabgroup/SWIFT-codes/blob/master/GeneralTools/pullSWIFTtelemetry.m.
The server can also be queryed and explored using the web page and web-based map:
- http://faculty.washington.edu/jmt3rd/SWIFTdata/DynamicDataLinks.html (web page)
- https://swiftserver.apl.washington.edu/map/ (map)
The latest release of microSWIFTtelemetry
can be installed from PyPI using pip:
pip install microSWIFTtelemetry
microSWIFTtelemetry/
├── LICENSE
├── README.md
├── docs
├── examples/
│ ├── create_telemetry_report_example.ipynb
│ └── pull_telemetry_example.ipynb
├── microSWIFTtelemetry/
│ ├── __init__.py
│ ├── pull_telemetry.py
│ ├── sbd/
│ │ ├── __init__.py
│ │ ├── compile_sbd.py
│ │ ├── definitions.py
│ │ └── read_sbd.py
│ └── version.py
├── pyproject.toml
├── requirements.txt
├── setup.py
└── tests/
└── test_microSWIFTtelemetry.py
Learn more about the microSWIFT wave buoy:
-
https://apl.uw.edu/project/projects/swift/pdfs/microSWIFTspecsheet.pdf (spec sheet)
-
https://github.com/SASlabgroup/microSWIFT (microSWIFTv1 operational code)
Schematic depicting buoys telemetering wave data from the ocean to a scientist on land via satellite: