Welcome to Marine Robotics!
Whether you're a curious student, experienced roboticist, or somewhere in between - this site has resources for you:
- 🎓 New to marine robotics? Start with our Getting Started Guide - no prior experience needed!
- 🔍 Looking for specific packages or tools? Browse by category using the navigation menu
- 📚 Want to learn? Check out Education & Tutorials with hands-on guides
- ❓ Have questions? See the FAQ and Glossary for quick answers
Quick Start for Beginners
Never built a robot before? No problem! You can start learning with free simulators - no hardware or ocean required. See Getting Started to drive your first virtual robot in simulation.
Fast Track for Experts
Experienced maritime roboticist? Jump directly to:
- Expert Reference - Package comparisons, integration notes, vendor selection criteria
- Operations Guide - Pre-deployment checklists, power budgets, failure modes, field-tested procedures
- Integration Examples - Reference architectures, launch files, tf trees, proven sensor suites
- Hardware Comparisons - DVL, INS/IMU, Thrusters, Budget Planning
- Known Issues - Debugging guidance for thrust allocation, localization, acoustic communication
Contributions Welcome
This landscape is under active development and we welcome contributions! You can submit a pull request with your changes or open an issue on GitHub. Join our monthly meetings to discuss maritime robotics development with the community.
Community
This landscape is a community project maintained by the ROS Maritime Robotics Working Group. The best way to contribute is to join our monthly meetings and help expand and improve this resource.
Main repository: Maritime Robotics Working Group
Meetings
The Maritime Robotics Working Group meets regularly; meetings are announced on the ROS Discourse Maritime Robotics category, and recordings and meeting notes are posted after each meeting.
- Meeting agendas and minutes: Google Doc
- Meeting calendar invites: Google Group
Team / Community Coordination
- Instant Messaging: Zulip chat (Marine Robotics channel)
- Forums: ROS Discourse Maritime Robotics Category
- Project Tracking: GitHub Project Board
Contributing
Contributions to the landscape are highly encouraged, from simple fixes to spelling and grammar all the way to adding new sections to the landscape.
Quick Changes in GitHub
Simple changes to existing pages can be made directly through GitHub using the "Edit on GitHub" link at the top of every page.
To edit an existing page:
- Open the page you want to edit.
- Click the "Edit on GitHub" link at the top of the page.
- Make your changes in the online editor.
- Create a separate branch when prompted and submit a pull request.
The team will review your contribution and either provide feedback or merge your changes to update the website.
Changes Using Git (New Pages and Images)
More substantial changes, including adding new pages or modifying images, are best done locally. For these changes, use the standard git workflow:
- Clone the repository:
git clone <repo-url> - Modify the documentation as needed (add, change, or delete content).
- Test locally with mkdocs:
mkdocs serveto preview changes atlocalhost:8000 - Create a branch for your changes and submit a pull request.