# frc4123/2026 architecture

> Architecture diagram of the GitHub repository frc4123/2026, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/frc4123/2026
- Repository: https://github.com/frc4123/2026

## Overview

This is an FRC robot-control application. Its user-to-result workflow starts with driver/operator controls configured in RobotContainer, which schedule commands that operate drivetrain and mechanism subsystems; vision and shot-calculation components support localization and shooting. The graph also preserves field geometry, simulation, and shift-timing utilities as distinct capabilities. Evidence is limited to the supplied excerpts and SOURCE INDEX: unsampled command bindings and autonomous routine wiring are not asserted where their relationships are not shown.

Main entry points: [`src/main/java/frc/robot/RobotContainer.java`](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/RobotContainer.java) (Controls And Scheduling), [`src/main/java/frc/robot/utils/ShotCache.java`](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/ShotCache.java) (Shot Cache), [`src/main/java/frc/robot/subsystems/Vision.java`](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Vision.java) (Vision Localization), [`src/main/java/frc/robot/subsystems/Hood.java`](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Hood.java) (Hood)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Robot Runtime"]
  node_container["Controls And Scheduling"]
  node_telemetry["Telemetry<br/>[Telemetry.java]"]
end

subgraph group_drive["Drive And Vision"]
  node_swerve["Swerve Drive"]
  node_vision["Vision Localization<br/>[Vision.java]"]
  node_oculus["Oculus Interface<br/>[Oculus.java]"]
end

subgraph group_mechanisms["Robot Mechanisms"]
  node_intakearm["Intake Arm<br/>[IntakeArm.java]"]
  node_intakeroller["Intake Roller<br/>[IntakeRoller.java]"]
  node_uptake["Uptake<br/>[Uptake.java]"]
  node_seveneleven["SevenEleven<br/>[SevenEleven.java]"]
  node_climb["Climb<br/>[Climb.java]"]
end

subgraph group_shooting["Aiming And Shooting"]
  node_hood["Hood<br/>[Hood.java]"]
  node_shooter["Shooter<br/>[Shooter.java]"]
  node_turret["Turret<br/>[Turret.java]"]
  node_trajectory["Shot Trajectory"]
  node_shotcache["Shot Cache<br/>[ShotCache.java]"]
  node_shothelper["Shot Helper<br/>[ShotHelper.java]"]
  node_target["Target Selection<br/>[Target.java]"]
end

subgraph group_support["Field And Simulation"]
  node_field["Field Geometry<br/>[Field.java]"]
  node_fuelsim["Fuel Simulation<br/>[FuelSim.java]"]
  node_shift["Shift Helpers<br/>[ShiftHelpers.java]"]
  node_selfrepair["Self Repair<br/>[SelfRepair.java]"]
end

node_operator(("Driver/operator"))

node_operator -->|"sets controls"| node_container
node_container -->|"configures drive"| node_swerve
node_container -->|"binds commands"| node_intakearm
node_container -->|"binds commands"| node_intakeroller
node_container -->|"registers command"| node_uptake
node_container -->|"initializes subsystem"| node_vision
node_container -->|"initializes subsystem"| node_hood
node_container -->|"initializes subsystem"| node_shooter
node_container -->|"initializes subsystem"| node_turret
node_container -->|"registers telemetry"| node_telemetry
node_vision -->|"adds pose measurement"| node_swerve
node_vision -->|"uses field geometry"| node_field
node_hood -->|"reads shot data"| node_shotcache
node_hood -->|"uses calculations"| node_trajectory
node_shooter -->|"reads shot data"| node_shotcache
node_shooter -->|"uses shot data"| node_trajectory
node_uptake -.->|"uses cached shot"| node_shotcache
node_turret -->|"reads target data"| node_shotcache
node_turret -->|"uses target selection"| node_target
node_container -->|"resets simulation"| node_fuelsim
node_container -->|"uses shift warning"| node_shift

click node_container "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/RobotContainer.java"
click node_swerve "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/CommandSwerveDrivetrain.java"
click node_vision "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Vision.java"
click node_oculus "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Oculus.java"
click node_intakearm "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/IntakeArm.java"
click node_intakeroller "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/IntakeRoller.java"
click node_uptake "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Uptake.java"
click node_seveneleven "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/SevenEleven.java"
click node_climb "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Climb.java"
click node_hood "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Hood.java"
click node_shooter "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Shooter.java"
click node_turret "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/turret/Turret.java"
click node_trajectory "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/turret/TrajectoryCalculator.java"
click node_shotcache "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/ShotCache.java"
click node_shothelper "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/ShotHelper.java"
click node_target "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/Target.java"
click node_field "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/Field.java"
click node_fuelsim "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/FuelSim.java"
click node_shift "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/ShiftHelpers.java"
click node_selfrepair "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/SelfRepair.java"
click node_telemetry "https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/Telemetry.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_container,node_telemetry toneBlue
class node_swerve,node_vision,node_oculus toneAmber
class node_intakearm,node_intakeroller,node_uptake,node_seveneleven,node_climb toneMint
class node_hood,node_shooter,node_turret,node_trajectory,node_shotcache,node_shothelper,node_target toneRose
class node_field,node_fuelsim,node_shift,node_selfrepair,node_operator toneIndigo
```

## Components

### Robot Runtime

- [Controls And Scheduling](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/RobotContainer.java): `src/main/java/frc/robot/RobotContainer.java`
- [Telemetry](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/Telemetry.java): `src/main/java/frc/robot/Telemetry.java`

### Drive And Vision

- [Swerve Drive](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/CommandSwerveDrivetrain.java): `src/main/java/frc/robot/subsystems/CommandSwerveDrivetrain.java`
- [Vision Localization](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Vision.java): `src/main/java/frc/robot/subsystems/Vision.java`
- [Oculus Interface](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Oculus.java): `src/main/java/frc/robot/subsystems/Oculus.java`

### Robot Mechanisms

- [Intake Arm](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/IntakeArm.java): `src/main/java/frc/robot/subsystems/IntakeArm.java`
- [Intake Roller](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/IntakeRoller.java): `src/main/java/frc/robot/subsystems/IntakeRoller.java`
- [Uptake](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Uptake.java): `src/main/java/frc/robot/subsystems/Uptake.java`
- [SevenEleven](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/SevenEleven.java): `src/main/java/frc/robot/subsystems/SevenEleven.java`
- [Climb](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Climb.java): `src/main/java/frc/robot/subsystems/Climb.java`

### Aiming And Shooting

- [Hood](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Hood.java): `src/main/java/frc/robot/subsystems/Hood.java`
- [Shooter](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/Shooter.java): `src/main/java/frc/robot/subsystems/Shooter.java`
- [Turret](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/turret/Turret.java): `src/main/java/frc/robot/subsystems/turret/Turret.java`
- [Shot Trajectory](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/turret/TrajectoryCalculator.java): `src/main/java/frc/robot/subsystems/turret/TrajectoryCalculator.java`
- [Shot Cache](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/ShotCache.java): `src/main/java/frc/robot/utils/ShotCache.java`
- [Shot Helper](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/ShotHelper.java): `src/main/java/frc/robot/utils/ShotHelper.java`
- [Target Selection](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/Target.java): `src/main/java/frc/robot/utils/Target.java`

### Field And Simulation

- [Field Geometry](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/Field.java): `src/main/java/frc/robot/utils/Field.java`
- [Fuel Simulation](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/FuelSim.java): `src/main/java/frc/robot/utils/FuelSim.java`
- [Shift Helpers](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/utils/ShiftHelpers.java): `src/main/java/frc/robot/utils/ShiftHelpers.java`
- [Self Repair](https://github.com/frc4123/2026/blob/main/src/main/java/frc/robot/subsystems/SelfRepair.java): `src/main/java/frc/robot/subsystems/SelfRepair.java`

### Other components

- **Driver/operator**

## Connections

- Driver/operator → Controls And Scheduling: sets controls (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Scheduling → Swerve Drive: configures drive (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Scheduling → Intake Arm: binds commands (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Scheduling → Intake Roller: binds commands (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Scheduling → Uptake: registers command (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Scheduling → Vision Localization: initializes subsystem (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Scheduling → Hood: initializes subsystem (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Scheduling → Shooter: initializes subsystem (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Scheduling → Turret: initializes subsystem (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Scheduling → Telemetry: registers telemetry (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Vision Localization → Swerve Drive: adds pose measurement (evidence: `src/main/java/frc/robot/subsystems/Vision.java`)
- Vision Localization → Field Geometry: uses field geometry (evidence: `src/main/java/frc/robot/subsystems/Vision.java`)
- Hood → Shot Cache: reads shot data (evidence: `src/main/java/frc/robot/subsystems/Hood.java`)
- Hood → Shot Trajectory: uses calculations (evidence: `src/main/java/frc/robot/subsystems/Hood.java`)
- Shooter → Shot Cache: reads shot data (evidence: `src/main/java/frc/robot/subsystems/Shooter.java`)
- Shooter → Shot Trajectory: uses shot data (evidence: `src/main/java/frc/robot/subsystems/Shooter.java`)
- Uptake → Shot Cache: uses cached shot (evidence: `src/main/java/frc/robot/subsystems/Uptake.java`)
- Turret → Shot Cache: reads target data (evidence: `src/main/java/frc/robot/subsystems/turret/Turret.java`)
- Turret → Target Selection: uses target selection (evidence: `src/main/java/frc/robot/subsystems/turret/Turret.java`)
- Controls And Scheduling → Fuel Simulation: resets simulation (evidence: `src/main/java/frc/robot/RobotContainer.java`)
- Controls And Scheduling → Shift Helpers: uses shift warning (evidence: `src/main/java/frc/robot/RobotContainer.java`)
