How amslabtech/rwrc26 works
PlaceNav builds an ordered image topological map from a robot trajectory, then localizes incoming camera frames against that map, selects a subgoal, and predicts waypoints for robot motion. The graph also preserves the documented WHILL safety, diagnostics, and visualization branches. Source excerpts show navigation-to-recognition/model wiring; README documents several ROS and robot integrations whose implementation details were not sampled, so those links are cited to the README.
Main entry points: navigate.py ROS navigator · extract_database.py Descriptor export · feature_extractor.py Feature extractor · bayesian_querier.py Bayesian localizer
Components 21
Map creation
- Topomap builder
src/placenav/create_topomap.py - Topological maps
src/topomaps
Place recognition
- Descriptor export
src/placenav/place_recognition/extract_database.py - Descriptor database
src/placenav/place_recognition/gallery_db.py - Feature extractor
src/placenav/place_recognition/feature_extractor.py - CosPlace model
src/placenav/models/pr_models/cosplace_model/cosplace_network.py - Recognition model API
src/placenav/models/pr_models/base_model.py - Bayesian localizer
src/placenav/place_recognition/bayesian_querier.py - Sliding-window matcher
src/placenav/place_recognition/sliding_window_querier.py
Navigation inference
- ROS navigator
src/placenav/navigate.py - Navigation options
src/placenav/parser.py - GNM waypoint model
src/placenav/models/wp_models/gnm/gnm.py - MobileNet encoder
src/placenav/models/wp_models/gnm/modified_mobilenetv2.py - ROS image utilities
src/placenav/utils.py
Robot integration
- Joystick teleoperation
src/placenav/joy_teleop.py - PD controller
src/placenav/pd_controller.py - Velocity safety filter
src/placenav/safety_filter.py
Visualization diagnostics
- Visualization node
src/placenav/visualization_node.py - Visualization messages
src/placenav_viz_msgs/src/placenav_viz_msgs/msg
Other components
- Operator
- Mobile robot
Connections 27
- Operator → Topomap builder: records trajectory
README.md - Topomap builder → Topological maps: writes map
README.md - Topological maps → Descriptor export: provides map images
README.md - Descriptor export → Feature extractor: loads model
src/placenav/place_recognition/extract_database.py - Descriptor export → Descriptor database: writes descriptors
README.md - Feature extractor → Recognition model API: loads model API
src/placenav/place_recognition/feature_extractor.py - CosPlace model → Recognition model API: implements API
- ROS navigator → Navigation options: uses options
src/placenav/navigate.py - ROS navigator → Descriptor export: builds map database
src/placenav/navigate.py - ROS navigator → Feature extractor: initializes extractor
src/placenav/navigate.py - ROS navigator → Bayesian localizer: localizes frames
src/placenav/navigate.py - ROS navigator → Sliding-window matcher: selects matcher
src/placenav/navigate.py - Bayesian localizer → Feature extractor: encodes query
src/placenav/place_recognition/bayesian_querier.py - Bayesian localizer → Descriptor database: reads descriptors
src/placenav/place_recognition/bayesian_querier.py - Sliding-window matcher → Descriptor database: reads gallery
src/placenav/place_recognition/sliding_window_querier.py - ROS navigator → GNM waypoint model: predicts waypoints
README.md - GNM waypoint model → MobileNet encoder: uses encoder
src/placenav/models/wp_models/gnm/gnm.py - ROS navigator → ROS image utilities: uses image transforms
src/placenav/navigate.py - Mobile robot → ROS navigator: sends camera frames
README.md - ROS navigator → Mobile robot: publishes motion commands
README.md - Operator → Joystick teleoperation: sends joystick input
README.md - Joystick teleoperation → Mobile robot: teleoperates
README.md - PD controller → Velocity safety filter: filters velocity
README.md - Velocity safety filter → Mobile robot: limits commands
README.md - ROS navigator → Visualization node: publishes visualization data
README.md - ROS navigator → Visualization messages: publishes diagnostics
README.md - Visualization node → Visualization messages: consumes messages
README.md