For the complete documentation index, see llms.txt. This page is also available as Markdown.

LimelightResults

Package: limelight.networktables

Java model of the full limelight.results JSON payload — every field the Limelight can publish for a single frame, across every pipeline type. Retrieved via limelight.getLatestResults() or limelight.getData().getResults(), both of which return Optional<LimelightResults> (empty if the LL GUI's "Send JSON over NT?" option is off).


Key Fields

Field
Type
Description

valid

boolean

true if any valid target is present (v).

error

String

Error message, if any.

tx, ty

double

Crosshair-relative horizontal/vertical offset in degrees.

txnc, tync

double

Principal-pixel-relative horizontal/vertical offset in degrees.

ta

double

Undistorted, normalized target area (0-100).

pipelineID, pipeline_type

double, String

Active pipeline index and type string.

latency_pipeline, latency_capture

double

Tracking loop latency and capture latency, in milliseconds.

timestamp_LIMELIGHT_publish, timestamp_RIOFPGA_capture, timestamp_NT, timestamp_System

double

Timestamps from various clocks — Limelight boot, RIO FPGA, NT server, and system wall clock.

botpose, botpose_wpired, botpose_wpiblue

double[6]

MegaTag1 pose in raw/red/blue coordinate frames: [x, y, z, roll, pitch, yaw].

botpose_mt2, botpose_mt2_blue

double[6]

MegaTag2 pose, raw and blue-origin.

botpose_tagcount, botpose_span, botpose_avgdist, botpose_avgarea

double

Aggregate stats over the tags used to compute botpose.

stdev_mt1, stdev_mt2

double[6]

Standard deviations for MegaTag1/MegaTag2 pose components.

camerapose_robotspace

double[6]

Camera pose relative to the robot.

targets_Retro

RetroreflectiveTape[]

Retroreflective pipeline results. See RetroreflectiveTape.

targets_Fiducials

AprilTagFiducial[]

AprilTag pipeline results. See AprilTagFiducial.

targets_Classifier

NeuralClassifier[]

Neural classifier results. See NeuralClassifier.

targets_Detector

NeuralDetector[]

Neural detector results. See NeuralDetector.

targets_Barcode

Barcode[]

Barcode pipeline results. See Barcode.

hardware

HardwareReport

System hardware telemetry (2026+). See HardwareReport.

imuResults

IMUResults

IMU orientation/acceleration data. See IMUResults.

rewindStats

RewindStats

Rewind buffer stats (LL4 only). See RewindStats.

targetDistance

double

3D distance from camera to target/POI, in meters (tdist).

PythonOut

double[8]

Output from a custom Python SnapScript pipeline.


Methods

Method
Returns
Description

getBotPose3d()

Pose3d

MegaTag1 botpose as a Pose3d.

getBotPose3d(DriverStation.Alliance alliance)

Pose3d

MegaTag1 pose in the given alliance's coordinate frame.

getBotPose2d()

Pose2d

MegaTag1 botpose as a Pose2d.

getBotPose2d(DriverStation.Alliance alliance)

Pose2d

MegaTag1 pose (2D) in the given alliance's coordinate frame.

getMT2Pose3d()

Pose3d

MegaTag2 botpose_orb as a Pose3d.

Prefer LimelightPoseEstimator / PoseEstimate for pose consumption in a periodic loop — they read the NT double-array entries directly (cheaper than JSON parsing) and include per-tag ambiguity data for filtering.

See Also

Last updated

Was this helpful?