# remus-rlf-reader

> remus-rlf-reader parses REMUS-100 autonomous underwater vehicle run logs and companion ADCP, GPS, and mission files using an empirically derived record layout. It provides a binary format specification, Python decoders for sensor and mission records, and a browser explorer that plots parsed RLF data.

- Type: Tool
- Targets: Firmware
- Category: Firmware tools
- Relationship: Foundation tool
- Sources reviewed: 2026-11-08
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/isaacgerg/remus-rlf-reader>
- Primary source: <https://github.com/isaacgerg/remus-rlf-reader/blob/036793993a5c5d522f9ff89dd4be803ada0bb103/README.md>
- Catalog page: <https://awesomerea.org/resources/remus-rlf-reader/>
- Record JSON: <https://awesomerea.org/resources/remus-rlf-reader/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/remus-rlf-reader/index.md)

## Requirements & limits

- **Prerequisites:** Requires Python 3.8+ and NumPy; Matplotlib is needed for --plot.
- **Limits:** Field offsets, scaling factors, and physical interpretations were derived empirically and may be incorrect.
- **License:** AGPL-3.0.

## Primary sources

1. <https://github.com/isaacgerg/remus-rlf-reader/blob/036793993a5c5d522f9ff89dd4be803ada0bb103/README.md>
2. <https://github.com/isaacgerg/remus-rlf-reader/blob/036793993a5c5d522f9ff89dd4be803ada0bb103/webapp/README.md>

## More in Firmware and hardware

- [unME11](https://awesomerea.org/resources/unme11/index.md) · Tool
- [pocketwalker](https://awesomerea.org/resources/pocketwalker-emulator/index.md) · Tool
- [Wii U Firmware Emulator](https://awesomerea.org/resources/wii-u-firmware-emulator/index.md) · Tool
- [Project IceStorm](https://awesomerea.org/resources/project-icestorm/index.md) · Tool
- [ThinkPad IMX471: recovering camera tuning for Linux](https://awesomerea.org/resources/thinkpad-imx471-camera-case/index.md) · Case study
- [MXQ PRO RK3229: an Android firmware investigation and Linux repurposing](https://awesomerea.org/resources/mxqpro-rk3229-rea-repurposing-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.