How tkyoseva/amphireach works
AmphiReach is a simulation and analysis repository for evaluating an amphibious rescue vessel, with a separate earlier interactive Gazebo demo. The main analysis workflow computes deterministic mission energy, checks twin-hull stability, runs seeded mission trials, and adds detection, failure classification, and JONSWAP analyses; scripts write the reported results. The README also documents the demo’s robot model, water worlds, and motor and mission controllers. Edges follow shown imports and calls or explicit README statements; demo wiring is not established by the sampled source.
Main entry points: run_trials.py Seeded trials · run_jonswap.py JONSWAP trials · run_calculations.py Mission results runner · failures.py Failure replay
Components 24
Mission analysis
- Resistance model
simulation/plan_v3/calculations.py - Mission results runner
simulation/plan_v3/run_calculations.py - Seeded trials
simulation/plan_v4/run_trials.py - Mission CSV results
simulation/plan_v3/results - Trial summaries
simulation/plan_v4/results
Analysis extensions
- First-pass detection
simulation/plan_v5/detection.py - Failure replay
simulation/plan_v5/failures.py - JONSWAP spectrum
simulation/plan_v5/jonswap.py - JONSWAP trials
simulation/plan_v5/run_jonswap.py - Result workbook
simulation/plan_v5/pack_results.py - Detection results
simulation/plan_v5/results/first_pass_detection.csv - Failure results
simulation/plan_v5/results/failure_reasons.csv - JONSWAP results
simulation/plan_v5/results/table7_jonswap_medians.csv - Manuscript workbook
simulation/plan_v5/results/for_use/AmphiReach_results.xlsx
Float validation
- Hydrostatics
simulation/plan_v4/hydrostatics.py - Gazebo float world
simulation/worlds/plan_v4_float.sdf - Float check outputs
simulation/plan_v4/results/float_check.txt
Interactive Gazebo demo
- Robot model
models/urdf/ar_robot.urdf - Water simulation worlds
simulation/worlds/ar_robot_water_world.sdf - Mission controller
control/mission_control/mission_controller.py - Standalone mission control
control/mission_control/mission_controller_standalone.py - ROS motor control
control/motor_control/motor_controller.py - Standalone motor control
control/motor_control/motor_controller_standalone.py
Other components
- Analyst
Connections 27
- Analyst → Mission results runner: runs
README.md - Mission results runner → Resistance model: calls
simulation/plan_v3/run_calculations.py - Mission results runner → Mission CSV results: writes
simulation/plan_v3/run_calculations.py - Analyst → Seeded trials: runs
README.md - Seeded trials → Resistance model: uses model
simulation/plan_v4/run_trials.py - Seeded trials → Trial summaries: writes
README.md - Analyst → Hydrostatics: runs
README.md - Hydrostatics → Resistance model: imports constants
simulation/plan_v4/hydrostatics.py - Analyst → Gazebo float world: runs test
README.md - Gazebo float world → Float check outputs: produces
README.md - Analyst → First-pass detection: runs
README.md - First-pass detection → Detection results: writes
README.md - Analyst → Failure replay: runs
README.md - Failure replay → Seeded trials: replays trials
simulation/plan_v5/failures.py - Failure replay → Failure results: writes
README.md - Analyst → JONSWAP trials: runs
README.md - JONSWAP trials → JONSWAP spectrum: calls
simulation/plan_v5/run_jonswap.py - JONSWAP trials → Seeded trials: reuses statistics
simulation/plan_v5/run_jonswap.py - JONSWAP trials → JONSWAP results: writes
README.md - Analyst → Result workbook: runs
README.md - Result workbook → Manuscript workbook: packs tables
README.md - Analyst → Water simulation worlds: runs demo
README.md - Water simulation worlds → Robot model: includes model
- Analyst → Mission controller: operates
- Analyst → Standalone mission control: operates
- Analyst → ROS motor control: commands
- Analyst → Standalone motor control: commands