For documentation on the current version, please check Knowledge Base.
This is an old revision of the document!
Image Pixels to Objects
This page describes how to use the extension “Image Pixels to Objects”
Main Toolbar > … > > Extensions > Image Pixels to Objects
The “Image Pixels to Objects” extension makes it possible to convert Image Pixel coordinates or bounds into 3D coordinates or 3D boxes.
Concepts
Image pixel coordinates and bounds can be defined for mapping run imagery. The image pixels are converted into 3D coordinates or 3D boxes in a vector file.
The 2D annotations and tags are overlayed on the opened image.
Source
Pixel Definitions
Choose how the pixels are defined: * Coordinates: every pixel is defined by 1 pixel coordinate * Bounds: every pixel is defined by 4 pixel coordinates from a rectangle
Reference Files
Choose how the reference files are structured: * One file for every image * One file for all images
Target
Select the target file location and CRS.
Choose to create 3D coordinates or 3D boxes.
Parameters
Cluster size
The radius around the vector between camera position and pixel point to search for cluster points.
Tooltip: The cluster size to identify coordinates in the direction from camera position to image position.
Advanced Parameters
Search Slice Thickness
The thickness of the slices created from camera position to pixel point.
For creating 3D Coordinates:
If a slice has an object, don't search in the following slices.
For creating 3D Boxes:
Do search in the following slices up until the Search Dist Max is reached.
Cluster Pts Min
The minimum number of points to have a cluster.
Search Radius (Box from Pix Coord)
The search radius around the direction camera to pixel position to search for the 3D object.
Search Dist Max
The maximum distance from the camera to the detected object.
3D Box Creation - Ground margin
The ground margin used to identify a 3D box reached the ground to be able to end the clustering.
3D Box Creation - Voxel Size
The voxel size used to cluster objects.
3D Box Creation - Voxel Pts Min
The minimum number of points to have a voxel.