libreyolo fcos3d

Run fcos3d 3D detection from the command line.

Synopsis

bash
libreyolo fcos3d source=IMAGE intrinsics=camera.npy [OPTIONS]

Arguments

ArgumentDefaultMeaning
sourcerequiredImage path or directory
modelupstream default checkpointLocal checkpoint or the mirrored default filename
intrinsicsrequiredOriginal-image 3x3 camera calibration .npy file
deviceautoauto, cpu, or a CUDA device
confNoneJoint confidence threshold
iouNoneRotated bird's-eye-view NMS threshold
max-det200Maximum number of detections per image
saveFalseSave projected cuboids
output-pathNoneSingle-image output filename
jsonfalseJSON output to stdout
quietFalseSuppress stderr
--help-jsonflagDump command schema as JSON

Examples

Inspect the installed command schema:

bash
libreyolo fcos3d --help-json

Predict on the shipped sample image. For commands requiring calibration, camera.npy must contain its measured original-image 3x3 intrinsic matrix.

bash
libreyolo fcos3d source=https://raw.githubusercontent.com/LibreYOLO/libreyolo/release/libreyolo/assets/parkour.jpg intrinsics=camera.npy

Request machine-readable results:

bash
libreyolo fcos3d source=https://raw.githubusercontent.com/LibreYOLO/libreyolo/release/libreyolo/assets/parkour.jpg intrinsics=camera.npy --json --quiet

Notes

Configuration, model-loading and I/O errors exit through the shared CLI error handler. --json writes structured results to stdout; diagnostics use stderr. --quiet suppresses stderr. See fcos3d for installation, calibration and model constraints.

Verified against LibreYOLO v1.6.0.