Package com.agisoft.metashape

Class Calibration

java.lang.Object
com.agisoft.metashape.Calibration
public class Calibration
extends Object
Calibration object contains camera calibration information including image size,
focal length, principal point coordinates and distortion coefficients.

  • Nested Class Summary

    Nested Classes
    Modifier and Type Class Description
    static class  Calibration.Type  

  • Field Summary

    Fields
    Modifier and Type Field Description
    protected boolean swigCMemOwn  

  • Constructor Summary

    Constructors
    Constructor Description
    Calibration()  
    Calibration​(long cPtr, boolean cMemoryOwn)  
    Calibration​(Calibration calibration)  

  • Method Summary

    Modifier and Type Method Description
    void delete()  
    protected void finalize()  
    double getB1()
    Affinity.
    double getB2()
    Non-orthogonality.
    static long getCPtr​(Calibration obj)  
    double getCx()
    Principal point X coordinate.
    double getCy()
    Principal point Y coordinate.
    Vector2d getError​(Vector3d point, Vector2d proj)
    Return projection error.
    double getF()
    Focal length.
    long getHeight()
    Image height.
    double getK1()
    Radial distortion coefficient K1.
    double getK2()
    Radial distortion coefficient K2.
    double getK3()
    Radial distortion coefficient K3.
    double getK4()
    Radial distortion coefficient K4.
    double getP1()
    Decentering distortion coefficient P1.
    double getP2()
    Decentering distortion coefficiant P2.
    double getP3()
    Decentering distortion coefficient P3.
    double getP4()
    Decentering distortion coefficiant P4.
    RPCModel getRPCModel()
    RPC model.
    Calibration.Type getType()
    Camera model.
    long getWidth()
    Image width.
    void load​(String path, CalibrationFormat format)
    Load calibration from file.
    Vector2d project​(Vector3d point)
    Return projected pixel coordinates of the point.
    void save​(String path, CalibrationFormat format, String label, Vector2d pixel_size, double focal_length, double cx, double cy)
    Save calibration to file.
    void setB1​(double value)
    Affinity.
    void setB2​(double value)
    Non-orthogonality.
    void setCx​(double value)
    Principal point X coordinate.
    void setCy​(double value)
    Principal point Y coordinate.
    void setF​(double value)
    Focal length.
    void setHeight​(long height)
    Image height.
    void setK1​(double value)
    Radial distortion coefficient K1.
    void setK2​(double value)
    Radial distortion coefficient K2.
    void setK3​(double value)
    Radial distortion coefficient K3.
    void setK4​(double value)
    Radial distortion coefficient K4.
    void setP1​(double value)
    Decentering distortion coefficient P1.
    void setP2​(double value)
    Decentering distortion coefficiant P2.
    void setP3​(double value)
    Decentering distortion coefficient P3.
    void setP4​(double value)
    Decentering distortion coefficiant P4.
    void setRPCModel​(RPCModel rpc)
    RPC model.
    void setType​(Calibration.Type type)
    Camera model.
    void setWidth​(long width)
    Image width.
    Vector3d unproject​(Vector2d point)
    Return direction corresponding to the image point.

    Methods inherited from class java.lang.Object

    clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • swigCMemOwn

      protected transient boolean swigCMemOwn

  • Constructor Details

    • Calibration

      public Calibration​(long cPtr, boolean cMemoryOwn)

    • Calibration

      public Calibration()

    • Calibration

      public Calibration​(Calibration calibration)

  • Method Details

    • getCPtr

      public static long getCPtr​(Calibration obj)

    • finalize

      protected void finalize()
      Overrides:
      finalize in class Object

    • delete

      public void delete()

    • getType

      public Calibration.Type getType()
      Camera model.

    • getWidth

      public long getWidth()
      Image width.

    • getHeight

      public long getHeight()
      Image height.

    • setType

      public void setType​(Calibration.Type type)
      Camera model.

    • setWidth

      public void setWidth​(long width)
      Image width.

    • setHeight

      public void setHeight​(long height)
      Image height.

    • setF

      public void setF​(double value)
      Focal length.

    • getF

      public double getF()
      Focal length.

    • setCx

      public void setCx​(double value)
      Principal point X coordinate.

    • getCx

      public double getCx()
      Principal point X coordinate.

    • setCy

      public void setCy​(double value)
      Principal point Y coordinate.

    • getCy

      public double getCy()
      Principal point Y coordinate.

    • setB1

      public void setB1​(double value)
      Affinity.

    • getB1

      public double getB1()
      Affinity.

    • setB2

      public void setB2​(double value)
      Non-orthogonality.

    • getB2

      public double getB2()
      Non-orthogonality.

    • setK1

      public void setK1​(double value)
      Radial distortion coefficient K1.

    • getK1

      public double getK1()
      Radial distortion coefficient K1.

    • setK2

      public void setK2​(double value)
      Radial distortion coefficient K2.

    • getK2

      public double getK2()
      Radial distortion coefficient K2.

    • setK3

      public void setK3​(double value)
      Radial distortion coefficient K3.

    • getK3

      public double getK3()
      Radial distortion coefficient K3.

    • setK4

      public void setK4​(double value)
      Radial distortion coefficient K4.

    • getK4

      public double getK4()
      Radial distortion coefficient K4.

    • setP1

      public void setP1​(double value)
      Decentering distortion coefficient P1.

    • getP1

      public double getP1()
      Decentering distortion coefficient P1.

    • setP2

      public void setP2​(double value)
      Decentering distortion coefficiant P2.

    • getP2

      public double getP2()
      Decentering distortion coefficiant P2.

    • setP3

      public void setP3​(double value)
      Decentering distortion coefficient P3.

    • getP3

      public double getP3()
      Decentering distortion coefficient P3.

    • setP4

      public void setP4​(double value)
      Decentering distortion coefficiant P4.

    • getP4

      public double getP4()
      Decentering distortion coefficiant P4.

    • setRPCModel

      public void setRPCModel​(RPCModel rpc)
      RPC model.

    • getRPCModel

      public RPCModel getRPCModel()
      RPC model.

    • save

      public void save​(String path, CalibrationFormat format, String label, Vector2d pixel_size, double focal_length, double cx, double cy)
      Save calibration to file.
      Parameters:
      path - path to calibration file.
      format - Calibration format.
      label - Calibration label used in Australis, CalibCam and CalCam formats.
      pixel_size - Pixel size in mm used to convert normalized calibration coefficients to Australis and CalibCam coefficients.
      focal_length - Focal length (Grid calibration format only).
      cx - X principal point coordinate (Grid calibration format only).
      cy - Y principal point coordinate (Grid calibration format only).

    • load

      public void load​(String path, CalibrationFormat format)
      Load calibration from file.
      Parameters:
      path - Path to calibration file.
      format - Calibration format.

    • project

      public Vector2d project​(Vector3d point)
      Return projected pixel coordinates of the point.
      Parameters:
      point - Coordinates of the point to be projected.
      Returns:
      2D projected point coordinates.

    • unproject

      public Vector3d unproject​(Vector2d point)
      Return direction corresponding to the image point.
      Parameters:
      point - Pixel coordinates of the point.
      Returns:
      3D vector in the camera coordinate system.

    • getError

      public Vector2d getError​(Vector3d point, Vector2d proj)
      Return projection error.
      Parameters:
      point - Coordinates of the point to be projected.
      proj - Pixel coordinates of the point.
      Returns:
      2D projection error.