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/04/26 11:40] paulien [Reference Files] |
dev:desktop_ext:image_pixel_objects [2021/04/26 11:58] paulien removed |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Image Annotation | + | ====== Image Annotations |
- | This page describes how to use the extension " | + | This page describes how to use the extension " |
- | {{orbit_desktop: | + | {{orbit_desktop: |
- | The " | + | The " |
Line 13: | Line 13: | ||
The image_pixel.ini file describes the tags in the annotation file used for the conversion. | The image_pixel.ini file describes the tags in the annotation file used for the conversion. | ||
- | Every annotation | + | Every annotation |
Line 39: | Line 39: | ||
There is one csv or xml file in the original or processed folder that is linked to an image via equal filenames. | There is one csv or xml file in the original or processed folder that is linked to an image via equal filenames. | ||
- | Example | + | Example of csv file. |
< | < | ||
Line 46: | Line 46: | ||
</ | </ | ||
- | The image_pixel.ini file describes | + | Example of xml file. |
+ | |||
+ | < | ||
+ | <?xml version=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | |||
+ | </ | ||
+ | |||
+ | Example of the image_pixel.ini file to describe | ||
| | ||
< | < | ||
Line 59: | Line 81: | ||
Tags=tags | Tags=tags | ||
Attribute0=folder | Attribute0=folder | ||
- | Attribute1=component | + | Attribute1=comment |
... | ... | ||
</ | </ | ||
Line 65: | Line 87: | ||
==== One file for all images ==== | ==== One file for all images ==== | ||
- | There is one csv or xml file to be selected in which all annotation | + | There is one csv or xml file to be selected in which all annotations |
===== Target ===== | ===== Target ===== | ||
Line 71: | Line 93: | ||
After selecting the target file location and CRS, choose to create 3D point objects or boxes. | After selecting the target file location and CRS, choose to create 3D point objects or boxes. | ||
- | The result is an ovf with the | + | ===== Algorithms ===== |
- | The pixels_not_converted.txt contains | + | For every situation, slices are created along the vector line between the camera position and the pixel point. |
+ | ==== 3D Coordinates from Pixel Coordinates ==== | ||
+ | Within a radius around the vector, points are detected and clustered to create the 3D coordinate. | ||
+ | ==== 3D Coordinates fom Pixel Bounds ==== | ||
+ | Within the pixel coordinate bounds around the vector, voxels are created and clustered to create the 3D coordinate. | ||
- | ===== Advanced Parameters ===== | + | ==== 3D Boxes from Pixel Coordinates |
- | Depending on the chosen source and target options, the used parameters will be enabled. | + | With a radius around |
- | ==== 3D Coordinates from Pixel Coordinates ==== | + | If objects on ground, use ground margin. |
- | Slices are created along the vector line between the camera position and the pixel point. Within a radius around the vector, points are detected and clustered to create the 3D coordinate. | + | ==== 3D Boxes from Pixel Bounds ==== |
- | ==== 3D Coordinates fom Pixel Bounds ==== | + | Withing the pixel coordinate bounds around the vector, voxels are created and clustered to create the 3D box. |
- | Slices are created along the vector line between the camera position and the pixel point. Within the pixel coordinate bounds around the vector, voxels are created and clustered to create the 3D coordinate. | + | If objects on ground, use ground margin. |
- | ==== 3D Boxes from Pixel Coordinates ==== | ||
- | If objects on ground, use ground margin. | ||
- | ==== 3D Boxes from Pixel Bounds ==== | ||
+ | ===== Advanced Parameters ===== | ||
- | + | Depending | |
- | If objects | + | |
==== Search Slice Thickness ==== | ==== Search Slice Thickness ==== | ||
The thickness of the slices created from camera position to pixel point to search for points. | The thickness of the slices created from camera position to pixel point to search for points. | ||
- | *For creating 3D Coordinates: | + | *For creating 3D Coordinates: |
- | *For creating 3D Boxes: | + | *For creating 3D Boxes: |
==== Search Dist Max ==== | ==== Search Dist Max ==== | ||
Line 116: | Line 139: | ||
The radius around the vector between the camera position and pixel point to search for cluster points within a slice. | The radius around the vector between the camera position and pixel point to search for cluster points within a slice. | ||
- | Minimum cluster gap size. | ||
- | |||
This value counts also as the cluster distance which is the minimum cluster gap size. | This value counts also as the cluster distance which is the minimum cluster gap size. | ||
- | |||
- | |||
==== Cluster Pts Min ==== | ==== Cluster Pts Min ==== | ||
Line 134: | Line 153: | ||
The ground margin used to identify a 3D box reached the ground to be able to end the clustering. | 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. | 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. | ||
- | For bins, hyrdants | ||
- | Use to create boxes for objects on the ground. | ||
==== Voxel Size ==== | ==== Voxel Size ==== | ||
- | The box is divided into voxels of this size. | + | The box in the slice is divided into voxels of this size. |
==== Voxel Pts Min ==== | ==== Voxel Pts Min ==== | ||
Line 148: | Line 165: | ||
===== Results ===== | ===== Results ===== | ||
- | The result is an ovf with the attributes from the image_pixel.ini file. The following attributes are extra: | + | The result is an ovf where every object corresponds to one annotation, having |
- | * FD_ImageAnnotationSequence: | + | * FD_ImageAnnotationSequence: |
* FD_PixelDistanceFromAnnotation: | * FD_PixelDistanceFromAnnotation: | ||
* FD_InsideAnnotationBounds: | * FD_InsideAnnotationBounds: |