Module calibration 

Generate a synthetic multi-camera calibration from a Scenario and serialize it to the flydra XML format that Braid loads.

Functions

build_calibration

Build the perfect generation calibration: count ideal-pinhole cameras evenly spaced on a horizontal ring around the arena center, each looking at the center.

build_tracking_calibration

Build the calibration Braid tracks with: the perfect generation calibration of build_calibration with the scenario’s CalibrationPerturbation applied (pose / intrinsic error). With the default (identity) perturbation this is byte-identical to build_calibration; with a nonzero perturbation the tracker reconstructs with a slightly wrong calibration while the detections were generated with the perfect one, so reprojection error is realistic.

to_flydra_xml_string

Serialize a calibration to flydra XML (the format referenced by mainbrain.cal_fname).