Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
dev:desktop_ext:image_pixel_objects [2021/02/18 06:31] paulien [Image Pixels to Objects] |
dev:desktop_ext:image_pixel_objects [2021/04/26 11:58] paulien removed |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Image Pixels | + | ====== Image Annotations |
- | This page describes how to use the extension " | + | This page describes how to use the extension " |
- | {{orbit_desktop: | + | {{orbit_desktop: |
- | The " | + | The " |
===== Concepts ===== | ===== Concepts ===== | ||
- | Image pixel coordinates and bounds can be defined | + | Image annotations |
- | The 2D annotations and tags are overlayed on the opened image. | + | The image_pixel.ini file describes the tags in the annotation file used for the conversion. |
+ | Every annotation (and optionally the tag) can be overlayed on the opened image. | ||
+ | ===== Pixel Definitions ===== | ||
- | ===== Source ===== | + | Select how the annotations are defined. |
- | ==== Pixel Definitions | + | ==== Coordinates |
- | Coordinates | + | Every annotation is defined by 1 coordinate having two pixel coordinates: |
- | Bounds | + | |
- | ==== Reference Files ==== | + | ==== Bounds |
- | Define if there is one source | + | Every annotation |
+ | |||
+ | The center of the bounds can be used to convert to 3D. The same algorithm as for pixel coordinates will be used. | ||
+ | |||
+ | ==== Display Annotations ==== | ||
+ | |||
+ | The original image annotations and tags can be displayed on the imagery via the [[dev: | ||
+ | ===== Reference Files ===== | ||
+ | |||
+ | Choose how the reference files are structured: | ||
+ | ==== One file for every image ==== | ||
+ | There is one csv or xml file in the original or processed folder that is linked to an image via equal filenames. | ||
+ | |||
+ | Example of csv file. | ||
+ | |||
+ | < | ||
+ | Filename PixelMinX PixelMinY PixelMaxX PixelMaxY PhotoName Tags | ||
+ | DSC02497 6366 4079 6973 4621 DSC02497.jpg corrosion, | ||
+ | </ | ||
+ | |||
+ | Example of xml file. | ||
+ | |||
+ | < | ||
+ | <?xml version=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | |||
+ | </ | ||
+ | |||
+ | Example of the image_pixel.ini file to describe the xml tags. | ||
+ | |||
+ | < | ||
+ | Element=object | ||
+ | Filename=filename | ||
+ | PixelX= | ||
+ | PixelY= | ||
+ | PixelMinX=bound/ | ||
+ | PixelMaxX=bound/ | ||
+ | PixelMinY=bound/ | ||
+ | PixelMaxY=bound/ | ||
+ | Tags=tags | ||
+ | Attribute0=folder | ||
+ | Attribute1=comment | ||
+ | ... | ||
+ | </ | ||
+ | |||
+ | ==== One file for all images | ||
+ | |||
+ | There is one csv or xml file to be selected in which all annotations are described. The same structure as for one file for one image can be used. | ||
===== Target ===== | ===== Target ===== | ||
- | Select | + | After selecting |
- | Choose | + | |
- | ===== Parameters | + | ===== Algorithms |
- | ==== Cluster size ==== | + | For every situation, slices are created along the vector line between the camera position and the pixel point. |
- | The cluster size to identify coordinates in the direction | + | ==== 3D Coordinates |
- | ===== Advanced Parameters ===== | + | Within a radius around the vector, points are detected and clustered to create the 3D coordinate. |
- | ==== Search Slice Thickness | + | ==== 3D Coordinates fom Pixel Bounds |
- | The thickness of the slice used to find an object in the direction camera to pixel position. | + | Within |
- | If one slice has object, don't look in further slices. Only if there' | + | |
- | ==== Cluster Pts Min ==== | + | ==== 3D Boxes from Pixel Coordinates |
- | The minimum number of points to have a cluster. | + | With a radius around the vector, |
- | ==== Search Radius (Box from Pix Coord) ==== | + | If objects on ground, use ground margin. |
- | The search radius | + | ==== 3D Boxes from Pixel Bounds ==== |
+ | |||
+ | Withing the pixel coordinate bounds | ||
+ | |||
+ | If objects on ground, use ground margin. | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Advanced Parameters ===== | ||
+ | |||
+ | Depending on the chosen source and target options, the used parameters will be enabled. | ||
+ | |||
+ | ==== Search Slice Thickness ==== | ||
+ | |||
+ | The thickness of the slices created from camera | ||
+ | *For creating 3D Coordinates: | ||
+ | *For creating | ||
==== Search Dist Max ==== | ==== Search Dist Max ==== | ||
- | The maximum distance from the camera to the object. | + | The maximum distance from the camera to create slices and detect points. |
- | ==== 3D Box Creation - Ground margin | + | ==== Search Radius and Cluster Distance |
- | The ground margin used to identify | + | The radius around the vector between the camera position and pixel point to search for cluster points within |
+ | This value counts also as the cluster distance which is the minimum cluster gap size. | ||
- | ==== 3D Box Creation - Voxel Size ==== | + | ==== Cluster Pts Min ==== |
- | The voxel size used to cluster | + | The minimum number of points |
- | ==== 3D Box Creation - Voxel Pts Min ==== | + | ==== Search Radius |
+ | |||
+ | The search radius around the direction camera to pixel position to search for the 3D object. | ||
+ | |||
+ | ==== Ground margin ==== | ||
+ | |||
+ | The ground margin used to identify a 3D box reached the ground to be able to end the clustering. | ||
+ | To be used if the object to identify is located on the ground. If you don't remove the ground, the object will become bigger. | ||
- | The minimum number of points to have a voxel. | + | ==== Voxel Size ==== |
- | ===== Analyze ===== | + | The box in the slice is divided into voxels of this size. |
+ | ==== Voxel Pts Min ==== | ||
+ | Nearby voxels that have the minimum number of points will be clustered into an object. | ||
===== Results ===== | ===== Results ===== | ||
+ | The result is an ovf where every object corresponds to one annotation, having the attributes from the image_pixel.ini file or csv file. The following attributes are extra: | ||
+ | * FD_ImageAnnotationSequence: | ||
+ | * FD_PixelDistanceFromAnnotation: | ||
+ | * FD_InsideAnnotationBounds: | ||
+ | The pixels_not_converted.txt contains the list of objects that couldn' | ||