FOVEX 3D/Report View

From FOVEX Help
Jump to: navigation, search

Properties of the Project Explorer

The Report View provides an access to view and edit the properties under the Project Explorer:

Property at Project Explorer Report View shows the following information after left mouse click on Property
Solution the table of projects
Project the table of cameras
Settings the setting of the project
Frame Array Camera the table of the cameras
# Sensor the table of images
Settings the camera parameters
Images the table of images
# image filename the table of image points
Exif Info Exif information
Object Space
Network Points the table of image points and their 3D coordinates
CAD Objects the table of CAD shapes
Scale Bars the table of scale-bars
Control Points
# Reference Set The table of control points
Point Cloud the table of point cloud data
# point cloud file name
Bundle Reports
Statistics a text report including statistical information about network and qualification check parameters
Ext. Orientation a text report of exterior orientation parameters of the processed images
Short report a text short report (combination of Statistics and 3D Coordinates)
3D Coordinates a text report of the 3D points in the network


The following explain the content of Report View for each Properties of the Project Explorer.

Solution

Shows the projects of the Solution. The Red Project name shows the project which is currently loaded and open:


Solution


Property Description
Project Name The name of the project
Valid Camera Number of Valid cameras. Valid camera is a camera if the sensor data values are non-zero.
Oriented Image Number of oriented images
Scale Bar Number of valid scale-bar (scale-bars which have been used in the computations) in the project.
3D Points Number of 3D points (not the number of points in point cloud)
Processed A flag showing if the project has been processed with bundle adjustment.


The following is the Context menu of this view:


Context menu


Context menu Description
Unload Project Closes the project.
Delete Selected Items Removes the selected projects from the Solution.
Copy to Clipboard Copy the selected rows to clipboard.
Select All Select all rows.

Project

Project


Property Description
Camera Name Name of camera which images have been taken with.
Camera Type Type of camera which is Frame Array.
Oriented Image Number of oriented images of this camera
Active A flag showing if the camera is active or not active. If the camera is Inactive, it will not be used in computation.


The following is the Context menu of this view:


Context menu


Context menu Description
Delete Selected Items Removes the selected rows (the sensors) from the Project.
Copy to Clipboard Copy the selected rows to clipboard.
Select All Select all rows.

Settings

Report View/Settings      Report View/Settings


Property Description
Specification Data and Time Date and time of the creation of the project file. This field cannot be changed
Date of Project The date and time of the project.
Place Place of the project
Processed by The name of operator
Bundle Adjustment & Forward Intersection Bundle adjustment model
  • Approximate model (fast)
  • Full model (slow)

In practice the results of approximate model is the same as full model.

Datum of bundle adjustment
  • Control points: in order to run bundle adjustment with control point you need to add “Reference Set” under Control Points in Project Explorer and then add or import your control points.
  • Free network: the datum is Inner constrained therefore does not need any external information.
Min. ray intersection angle (degree) The minimum acceptable intersection angle between rays. The points which have intersection angle smaller than this value its 3D coordinates will not be computed.
Min. number of rays >= The minimum acceptable number of ray per each 3D point. If a 3D point has less ray than this value its 3D coordinates will not be computed.
Max. error ellipsoid size (mm) The maximum acceptable size of error ellipsoid. The 3D coordinates of the points with error ellipsoid size more than this value will not be computed.
Max. condition number The ratio of maximum principal axis to the minimal principal axis of the error ellipsoid is the condition number. If it is smaller the value of this filed, its 3D coordinates will not be computed.
Blunder detection If chosen, image point blunder detection will be performed after bundle adjustment.
Feature Detection Feature detection
  • Fast (less features)
  • Slow (more features)
Automated Target Detection Min. target size (pixel) Minimum acceptable target size in pixel. Targets with smaller size than this value will not be detected.
Max. target size (pixel) Maximum acceptable target size in pixel. Targets with larger size than this value will not be detected.
Min. target contrast Minimum acceptable target contrast. Target contrast is the difference of intensity value of target and background. Targets with smaller contrast value than this value will not be detected.
Target contrast type
  • Positive (white targets): targets with positive value of the contrast (white target on black background) are detected.
  • Negative (black targets): targets with negative value of the contrast (black target on white background) are detected.
  • Both: both positive and negative targets will be detected.
Image processing channel
  • Mean value of RGB: A new image is created with an average value of the three channel.
  • Red: Red channel is chosen in image processing
  • Green: Green channel is chosen in image processing
  • Blue: Blue channel is chosen in image processing
Detect coded target If selected, coded targets will be recognized.
Point Cloud with Dense Matching Dense Matching with emphasize
  • Fill region but not clean edge: dense matching is performed to create point cloud for even regions with low texture. This has a draw back and the edges will not be a clean and sharp edge.
  • Clean edge but not necessarily fill region: dense matching is performed to create point cloud with clean and sharp edge. This has a draw back and dense matching may not generate points for the surfaces with low texture.
Image resolution reduction by factor
  • 1 (Full size): the image is processed in full size
  • 2 (each side factor 1.4): the image resolution will be down sampled by factor 2 and the new down sampled image (an image with reduced dimension with factor 1.4) is used for point cloud generation.
  • 3 (each side factor 1.7)
  • 4 (each side factor 2)
  • 8 (each side factor 2.87)
  • 16 (each side factor 4.0)
Max. acceptable reduction range (m) The maximum acceptable range in point cloud generation. The range is the distance of the point from the camera station.
Use of single stereo pair If chosen, single stereo pairs will be used in the point cloud generation. This has a drawback that the point cloud may contain a lot of outliers.


The following is the Context menu of this view:

Report View - Settings - Context menu

Context menu Description
Default Values Set the default value of the parameters

Frame Array Camera

See the page Project.

# Sensor

Report View - Frame Array Camera - # Sensor


Property Description
Image Name the name of the Image, which is identical to the image file name.
Omega the rotation angle around X-axis.
Phi the rotation angle around Y-axis.
Kappa the rotation angle around Z-axis.
X0 the X-coordinate of the projection center.
Y0 the Y-coordinate of the projection center.
Z0 the Z-coordinate of the projection center.
Num. Points indicates the number of image points existing in the Image.
Active indicates if the Image is active or not. Inactive Images do not participate in the processing.


The above fields with gray color background are editable. Edition can be done by single click on the cell.

The following is the Context menu of this view:

Report View - Frame Array Camera - # Sensor -Context menu

Context menu Description
Delete Selected Items Removes the selected rows (the images) from the Project.

Multiple selection of rows is possible pressing <Ctr-key> and left click on the row.

Copy to Clipboard Copy the selected rows to clipboard.
Select All Select all rows.

Settings

Report View - Frame Array Camera - Settings


The value of the yellow fields are the essential input values which should be provided correctly. PhotoCore uses an especial sensor size database to fill in these parameters automatically. However, if it is failed to fill in these parameters, they have given manually.

Theses parameters are given in the technical notes of the camera and are editable by single left button click:

Property Description
Width (pixel) The width of the sensor
Width (mm) The width of the image
Height (pixel) The height of the sensor
Width (mm) The height of the image


The following are the so called Additional Parameters (APs) for the camera self-calibration:

Property Description
c (unit: mm) camera constant
x0 (unit: mm) shift of principal point along x-axis of the CCD-chip
y0 (unit: mm) shift of principal point along y-axis of the CCD-chip
Sx affinity parameter and corrects the dimension of a pixel
a shear parameter and compensates the non-orthogonality of row and column axes at CCD-chip
k1 (unit: 1/〖mm〗^2 ) first parameter of symmetrical lens distortion
k2 (unit: 1/〖mm〗^4 ) second parameter of symmetrical lens distortion
k3 (unit: 1/〖mm〗^6 ) third parameter of symmetrical lens distortion
p1 (unit: 1/〖mm〗^2 ) first parameter of asymmetrical lens distortion
p2 (unit: 1/〖mm〗^2 ) second parameter of asymmetrical lens distortion


Each of the above parameters has an attribute as follow:

Property Description
Fix if selected, this parameter will be estimated through the self-calibration. If not selected (is fixed) then the Bundle Adjustment will be performed with no self-calibration and it will use the Given Values for computations.
Given Value The value of the Additional Parameters that is provided by the user.
Estimated Value the estimated value of the Additional Parameter after self-calibration.
Estimated Std. Dev. the estimated value for the standard deviation of Additional Parameters after self-calibration.
Total Correction the difference between the Estimated Value and the Given Value after self-calibration.
Sig. Ratio the significant ratio of the Estimated Value of the Additional Parameter. The larger value shows larger deviation of the Estimated Value from the Given Value. The Estimated Additional Parameters with the Sig. Ratio value below 4.0 is be considered as a stochastically identical value to the Given Value.


The above fields with gray color background are editable. Edition can be done by single click on the cell.

The following is the Context menu of this view:


Report View - Frame Array Camera - Settings - Context menu


Context menu Description
Copy Estimated to Given Copy the Estimated value of the Given value of the selected rows.
Copy Given to Estimated Copy the Given value of the Estimated value of the selected rows.
Copy to Clipboard Copy the selected rows to clipboard.
Select All Select all rows.

Images

See the page # Sensor.

# Image Filename

Image Filename


Property Description
Point ID the identifier (or label) of the image point.
Col the column-coordinate of the image point in the pixel coordinate system.
Row the row-coordinate of the image point in the pixel coordinate system.
Res. Col the residual vector of the column-coordinate of the image point.
Res. Row the residual vector of the row-coordinate of the image point.
Active the indication that the image point is active or not.
Auto Measure the indication of the type of the image point. Types of image point are: Auto or Manual.


The above fields with gray color background are editable. Edition can be done by single click on the cell.

The following is the Context menu of this view:


Context menu


Context menu Description
Delete Selected Items Removes the selected rows (the image points) from the Image.

Multiple selection of rows is possible pressing <Ctr-key> and left click on the row.

Copy to Clipboard Copy the selected rows to clipboard.
Select All Select all rows.

Exif Info

Part of the EXIF information (read from the meta-data of the image) is shown here:

Exif Info

Object Space

Network Points

Network Points


Property Description
Point ID the identifier of the 3D Network Point.
X the estimated X-coordinate of the 3D Network Point.
Y the estimated Y-coordinate of the 3D Network Point.
Z the estimated Z-coordinate of the 3D Network Point.
Std. Dev. X the estimated standard deviation of the X-coordinate of the 3D Network Point.
Std. Dev. Y the estimated standard deviation of the X-coordinate of the 3D Network Point.
Std. Dev. Z the estimated standard deviation of the X-coordinate of the 3D Network Point.
Num. Rays the number of rays (image point) for this 3D Network Point.
Condition Number the condition number. Condition number is the ratio of the largest to smallest principal- axis of the 3D Network Point error ellipsoid.
Control Point the indication if the Network Point is used in datum definition or not.
Comment A description text as a comment for this point.


The above fields with gray color background are editable. Edition can be done by single click on the cell.

The following is the Context menu of this view:


Context menu

Context menu Description
Inactivate Inactive the network point. Therefore, it will be disappeared from the Network View.
Delete Selected Items Removes the selected rows (the image points) from the Image.

Multiple selection of rows is possible pressing <Ctr-key> and left click on the row.

Copy to Clipboard Copy the selected rows to clipboard.
Select All Select all rows.

CAD Object

CAD Object


Property Description
CAD ID The ID of the CAS Object, which is given by software.
Type The type of the CAD Object: Line, Polyline, Circle or Rect
Points The ID of the vertices of the CAD Object


The following is the Context menu of this view:

Context menu

Context menu Description
Delete Selected Items Removes the selected rows (the CAD object) from the Project.

Multiple selection of rows is possible pressing <Ctr-key> and left click on the row.

Copy to Clipboard Copy the selected rows to clipboard.
Select All Select all rows.

Scale Bars

Scale Bars

Property Description
Active the indication that the scale bar is active or not. Active scale bars are processed in the computations.
End Point 1 the label of the first end point of the scale bar.
End Point 2 the label of the second end point of the scale bar.
Calib. Temp the calibrated temperature of the scale bar.
Calib. Length the calibrated length of the scale bar.
Std. Dev. Calib. Length the standard deviation of the calibrated length of the scale bar.
Estimated Length the estimated length of the scale bar. This value is estimated after bundle adjustment and scaling network.
Std. Dev. Estimated Length the standard deviation of the estimated length of the scale bar. This value is estimated after bundle adjustment and scaling network.
Difference the difference of the estimated and calibrated length of the scale bar.


The above fields with gray color background are editable. Edition can be done by single click on the cell.

The following is the Context menu of this view:

Context menu

Context menu Description
Add Scale Bar Add one row to the table of scale bars.
Add Coded Target Scale Bars Add Coded Target scale bars automatically to the project. A dialog box will appear and asks the size of the Coded Target.

It is only applicable when the Coded Target exists in the images.

Delete Selected Items Removes the selected rows (the CAD object) from the Project.

Multiple selection of rows is possible pressing <Ctr-key> and left click on the row.

Copy to Clipboard Copy the selected rows to clipboard.
Select All Select all rows.

# Reference Set

# Reference Set


Property Description
Point ID the identifier or the name of the object point.
X the X-coordinate of the object point.
Y the Y-coordinate of the object point.
Z the Z-coordinate of the object point.
Std. Dev. X the standard deviation of the X-coordinate of the object point.
Std. Dev. Y the standard deviation of the Y-coordinate of the object point.
Std. Dev. Z the standard deviation of the Z-coordinate of the object point.
Delta X the difference of computed X from the given X at this Table
Delta Y the difference of computed Y from the given Y at this Table
Delta Z the difference of computed Z from the given Z at this Table
Control Point If selected the point is considered as control point otherwise as check point.


The above fields with gray color background are editable. Edition can be done by single click on the cell.

The following is the Context menu of this view:

Context menu

Context menu Description
Add Point Add one row to the table.
Delete Selected Items Removes the selected rows (the points) from the Project.

Multiple selection of rows is possible pressing <Ctr-key> and left click on the row.

Copy to Clipboard Copy the selected rows to clipboard.
Select All' Select all rows.

Point Cloud

Point Cloud


Property Description
Filename the point cloud filename without extension.
Num Points the number of points of the point cloud.
Show Point-cloud if selected the point cloud will be shown in Network view.
Num Vertices of Mesh the number of vertices of triangular mesh.
Show Mesh if selected the triangular mesh will be shown in Network View.


The above fields with gray color background are editable. Edition can be done by single click on the cell.

The following is the Context menu of this view:

Context menu

Context menu Description
Delete Selected Items Removes the selected rows (the point cloud) from the Project.

Multiple selection of rows is possible pressing <Ctr-key> and left click on the row.

Copy to Clipboard Copy the selected rows to clipboard.
Select All Select all rows.

Bundle Report

The items under the Bundle Report have all the following Context menu:

Bundle Report Context menu


File Menu Description
Save as … Saves the current report in a file as an ASCII format.
Copy to Clipboard Copies the selected texts into clipboard.

The text can be selected by pressing the left mouse button and moving the mouse cursor or by “Select All”.

Select All Selects the entire report.


Statistics

This report will be only available after “Orient Images” and is displayed in text format and is not editable.


Statistics

Ext. Orientation

This report will be only available after “Orient Images”and is displayed in text format and is not editable.


Ext. Orientation

Short Report

This report will be only available after “Orient Images” and is displayed in text format and is not editable.


Short Report

3D Coordinates

This report will be only available after “Orient Images “and is displayed in text format and is not editable.


3D Coordinates