# `BB.IK.TestRobots.ThreeLinkArm`
[🔗](https://github.com/beam-bots/bb_ik_fabrik/blob/main/test/support/test_robots.ex#L228)

3-DOF arm with vertical reach for testing 3D IK.

Structure:
- base_link
  - joint1 (revolute, Z-axis) - base rotation
    - link1
      - joint2 (revolute, Y-axis) - shoulder lift
        - link2 (0.2m)
          - joint3 (revolute, Y-axis) - elbow
            - link3
              - tip_joint (fixed, 0.15m)
                - tip

# `child_spec`

```elixir
@spec child_spec(Keyword.t()) :: Supervisor.child_spec()
```

Returns a child specification for starting this robot under a supervisor.

# `robot`

```elixir
@spec robot() :: BB.Robot.t()
```

Returns the optimised robot representation.

This struct is built at compile-time from the DSL definition and contains:
- All physical values converted to SI base units (floats)
- Flat maps for O(1) lookup of links, joints, sensors, and actuators
- Pre-computed topology metadata for efficient traversal

## Examples

    robot = Elixir.BB.IK.TestRobots.ThreeLinkArm.robot()
    {:ok, link} = BB.Robot.get_link(robot, :base_link)
    {:ok, joint} = BB.Robot.get_joint(robot, :shoulder)

# `start_link`

```elixir
@spec start_link(Keyword.t()) :: Supervisor.on_start()
```

Starts the robot's supervision tree.

## Options

All options are passed through to sensor and actuator child processes.

---

*Consult [api-reference.md](api-reference.md) for complete listing*