🐟 RTT‑Autonomous‑Fish

Aquatic Extensions for Autonomous Forms (RTT‑Inside)#

These schemas support:

• biomimetic robotic fish
• underwater swarms and schooling behavior
• ecological monitoring
• Great Lakes restoration robotics
• clarity‑aware corridor navigation
• RTT‑Inside environmental overlays

All schemas follow:

• snake_case naming
• JSON Schema Draft 2020‑12
• RTT‑Inside semantics
• SI units
• UUIDv4 identifiers
• ISO‑8601 timestamps
• extensions. for future growth

📁 Schema Overview#

1. fish_extension.schema.json#

Adds fish‑specific identity and configuration fields to the core autonomous_form_descriptor.

Includes:

• biomimetic species profile
• buoyancy mode (neutral, positive, negative)
• fin configuration
• swim gait (carangiform, anguilliform, etc.)

Use this schema to specialize an autonomous form as a robotic fish.

2. fish_hydrodynamics.schema.json#

Defines the hydrodynamic performance envelope of the fish.

Includes:

• drag coefficient
• max swim speed
• turn rate
• fin efficiency

This schema is essential for underwater simulation, control, and mission feasibility.

3. fish_habitat_interaction.schema.json#

Describes how the robotic fish interacts with its aquatic environment.

Includes:

• preferred depth range
• temperature tolerance
• pollutant sensitivity
• behavioral modes (schooling, patrolling, sampling)

This schema supports ecological robotics and habitat‑aware autonomy.

4. fish_mission_profile_extension.schema.json#

Extends the core autonomous_mission_profile with aquatic‑specific mission parameters.

Includes:

• sampling targets
• schooling behavior mode
• avoidance rules (nets, shallow zones)
• corridor preferences

Use this schema to tailor missions for underwater operations.

🔗 Relationship to the Autonomous Core#

This module extends the core schemas found in:

docs/schemas/rtt-autonomous/

Specifically:

• autonomous_form_descriptor → extended by fish_extension
• autonomous_mission_profile → extended by fish_mission_profile_extension
• autonomous_morphology → compatible with fin‑based actuation
• autonomous_energy_profile → used for underwater endurance modeling
• autonomous_corridor_definition → supports clarity‑aware underwater corridors
• autonomous_swarm_state → supports schooling and distributed underwater autonomy

The fish schemas never duplicate core fields; they only extend them.

🧩 Usage Pattern#

A typical robotic fish definition references:

1. Core descriptor
2. Fish extension
3. Hydrodynamics
4. Habitat interaction
5. Energy profile
6. Mission profile + fish mission extension

This layered approach keeps the system modular, expressive, and future‑proof.

🌱 Future Extensions#

This module is designed to grow with additional aquatic robotics capabilities, such as:

• multi‑species swarm coordination
• clarity‑adaptive routing
• pollutant plume tracking
• underwater mesh networking
• habitat restoration workflows