python123-ops/moonground/camera does not have a README file

    CameraModel

    pub struct CameraModel {
    // private fields
    } derive(
    Debug
    )

    Immutable zero-skew pinhole intrinsics and Brown-Conrady distortion. The radius bounds ideal (undistorted) normalized coordinates, not pixels.

    CameraModel::jacobian

    Analytic raw-to-rectified pixel Jacobian, row-major two by two.

    CameraModel::max_normalized_radius

    fn CameraModel::max_normalized_radius(self : CameraModel) -> Double

    CameraModel::new

    fn CameraModel::new(fx~ : Double, fy~ : Double, cx~ : Double, cy~ : Double, k1? : Double, k2? : Double, p1? : Double, p2? : Double, k3? : Double, max_normalized_radius? : Double) -> CameraModel raise
    GroundError

    Construct a camera whose forward normalized distortion has a unique inverse branch on the specified closed disk. The analytic bound 3|k1|R² + 5|k2|R⁴ + 7|k3|R⁶ + 6R sqrt(p1²+p2²) < 1 bounds ||J_distortion-I||₂ there. Since the Brown Jacobian is symmetric, its eigenvalues are positive and the forward map is strongly monotone. Unsafe parameters are rejected rather than selecting an arbitrary root.

    CameraModel::parameters

    fn CameraModel::parameters(self : CameraModel) -> Array[Double]

    Defensive parameter copy: fx, fy, cx, cy, k1, k2, p1, p2, k3.

    CameraModel::project

    Compose lens correction with a calibration whose ROI is in rectified pixel coordinates. Only GroundCalibration adds the ground noise floor, once.

    CameraModel::project_jacobian

    Full raw-pixel-to-ground Jacobian, J_homography * J_rectification.

    CameraModel::rectify

    Correct one raw pixel using the certified branch. A maximum of 512 projected contraction steps is allowed; residual/R/(1-L) must be at most 1e-12. Domain comparisons use the same relative radius scale. Unresolved points raise an error.

    CameraModel::rectify_covariance

    Propagate raw-pixel covariance into rectified pixels. No noise floor or calibration-parameter uncertainty is added by this camera operation.

    CameraModel::reframed

    Express raw and rectified image coordinates in destination pixels p'=D p+t. Brown distortion and its certified normalized-coordinate disk are unchanged.