How to use the Editing Camera Model Options

 
Video: Watch the instructional video related to How to create a New Camera Model: here.
 
Access: On the Main Menu, click Project > Image Properties Editor... and on the section Selected Camera Model, click Edit....
 
Access via the New Project wizard: When creating a new project, the Image Properties window appears after loading the images.
 
Important: The Current EXIF field displays the EXIF ID for which the camera model will be edited.
 
Warning: When changing the camera parameters in Edit Camera Model, the focal length and sensor size ratio should be correct. Use the real focal length and sensor size of the camera. To find the real sensor size, ask the camera manufacturer or search here.

A camera model can be edited by:

 
Note: If a different camera model than the one that was first assigned to the camera is chosen, a pop-up appears asking if you want to assign by default the currently selected camera model to the cameras with the same EXIF ID.

 

Selecting another camera model

In order to change the camera model to another existing camera model:

1. On the section Camera Model, click the Camera Model Name drop-down list.
2. Use the right scroll bar to navigate among the different camera models available and click the desired camera model.

 
Note: Only the camera models with the same resolution as the one detected for the camera are available.
 
Note:

database.png Refers to camera models existing in the software internal camera model database.

user.png Refers to a camera model existing in the user camera model database.

pencil.png Refers to a camera model existing in the software internal camera model database that has been edited by the user.

camera.png Refers to a camera model whose parameters have been retrieved from the EXIF data.

document.png Refers to a camera model taken from a project file.

3. On the section Camera Model Parameters, check the camera internal parameters set up for the selected camera. If the internal camera parameters do not match the camera used, edit the camera model following the instructions below.

 

Editing an existing camera model

 
Warning: If the camera model exists in the software database or was manually created, it is recommended to edit the camera model ONLY:
  • Once a project has been processed and if the quality report displays under the Quality Check section, on Camera Optimization, a relative difference between initial and final focal length that is higher than 5%, change the camera initial values to the optimized values: 202560059.
  • When no project has been processed using this camera model but the values of the camera model differ considerably from the known values.

In order to modify an existing camera model:

1. Select the Camera Model to be edited following the instructions above.
2. On the section Camera Model, click Edit.
3. Select the lens type between Perspective Lens or Fisheye Lens.

3. Edit the parameters by changing their values. The parameters can be reset by clicking Clear. If the images have enough information about the camera model in the EXIF data, the parameters can be estimated from the EXIF data by clicking Estimate from EXIF.
4. Save the edited information, there are 2 options:

    • In order to save the camera model in the camera database, Click Save to DB (the icon user.png will be displayed with the camera model name) and click OK.
    • In order to save the camera model for the project, Click OK (the icon document.png will be displayed with the camera model name).
 
Note: If the radial and tangential distortion parameters for a perspective lens are not known, it is recommended to set them to 0.
 
Camera Model Name Field used to type the camera model name. It is recommended to type the name as follow: 

camera_name_focal_length_sensor_widthxsensor_height

Image Width [pixel] Image width in pixels.
Image Height [pixel] Image height in pixels.
Focal Length [pixel] Focal length in pixels (if defined in pixels, the mm value is automatically computed and added to the corresponding field).
Principal Point x [pixel] Principal point x coordinate in pixels (if defined in pixels, the mm value is automatically computed and added to the corresponding field).
Principal Point y [pixel] Principal point y coordinate in pixels (if defined in pixels, the mm value is automatically computed and added to the corresponding field).
Sensor Width [mm] Sensor width in mm.
Sensor Height [mm] Sensor height in mm.
Pixel Size [μm] Pixel size in μm.
Focal Length [mm] Focal length in mm (if defined in mm, the pixel value is automatically computed and added to the corresponding field).
Principal Point x [mm] Principal point x coordinate in mm (if defined in mm, the pixel value is automatically computed and added to the corresponding field).
Principal Point y [mm] Principal point y coordinate in mm (if defined in mm, the pixel value is automatically computed and added to the corresponding field).
Radial Distortion R1 Radial distortion R1 parameter of the lens (optional, it is recommended to leave the distortion parameters to 0).
Radial Distortion R2 Radial distortion R2 parameter of the lens (optional, it is recommended to leave the distortion parameters to 0).
Radial Distortion R3 Radial distortion R3 parameter of the lens (optional, it is recommended to leave the distortion parameters to 0).
Tangential Distortion T1 Tangential distortion T1 parameter of the lens (optional, it is recommended to leave the distortion parameters to 0).
Tangential Distortion T2 Tangential distortion T2 parameter of the lens (optional, it is recommended to leave the distortion parameters to 0).
 
Note: For detailed information about the internal Camera Model Parameters: 202559089.

 

Creating a new camera model

If the camera model has not been detected or the actual camera model does not meet the specifications of the camera, it is possible to create a new camera model following:

1. On the section Camera Model, click New.
2. Select the lens type between Persepective Lens or Fisheye Lens.
3. Edit the parameters by changing their values. The parameters can be reset by clicking Clear. If the images have enough information about the camera model in the EXIF data, the parameters can be estimated from the EXIF data clicking Estimate from EXIF.
4. Save the new camera, there are 2 options:

    • In order to save the camera model in the camera database, Click Save to DB (the icon user.png will be displayed with the camera model name) and click OK.
    • In order to save the camera model for the project, Click OK (the icon document.png will be displayed with the camera model name).
 
Note: If the radial and tangential distortion parameters for a perspective lens are not known, it is recommended to set them to 0.

 

Camera Model Name Field used to type the camera model name. It is recommended to type the name as following: 

camera_name_focal_length_sensor_widthxsensor_height

Image Width [pixel] Image width in pixels.
Image Height [pixel] Image height in pixels.
Focal Length [pixel] Focal length in pixels (if defined in pixels , the mm value is automatically computed and added to the corresponding field).
Principal Point x [pixel] Principal point x coordinate in pixels (if defined in pixels , the mm value is automatically computed and added to the corresponding field).
Principal Point y [pixel] Principal point y coordinate in pixels (if defined in pixels , the mm value is automatically computed and added to the corresponding field).
Sensor Width [mm] Sensor width in mm.
Sensor Height [mm] Sensor height in mm.
Pixel Size [μm] Pixel size in μm.
Focal Length [mm] Focal length in mm (if defined in mm, the pixel value is automatically computed and added to the corresponding field).
Principal Point x [mm] Principal point x coordinate in mm (if defined in mm, the pixel value is automatically computed and added to the corresponding field).
Principal Point y [mm] Principal point y coordinate in mm (if defined in mm, the pixel value is automatically computed and added to the corresponding field).
Radial Distortion R1 Radial distortion R1 parameter of the lens (optional, it is recommended to leave the distortion parameters to 0).
Radial Distortion R2 Radial distortion R2 parameter of the lens (optional, it is recommended to leave the distortion parameters to 0).
Radial Distortion R3 Radial distortion R3 parameter of the lens (optional, it is recommended to leave the distortion parameters to 0).
Tangential Distortion T1 Tangential distortion T1 parameter of the lens (optional, it is recommended to leave the distortion parameters to 0).
Tangential Distortion T2 Tangential distortion T2 parameter of the lens (optional, it is recommended to leave the distortion parameters to 0).
 
Note: For detailed information about the internal Camera Model Parameters: 202559089.

 

Resetting pencil.png an edited Camera model to database.pnga database Camera mode

If a camera model taken from the internal camera model database was modified , the change can be reverted following:

1. On the section Camera Model, click the Camera Model Name drop-down list.
2. Select the camera model that needs to be reset.
3. Click Restore.
4. Click OK.

 

 

Was this article helpful?
3 out of 3 found this helpful