How to... (step-by-step instructions)
  1. Pix4D Documentation
  2. PIX4Dmatic
  3. How to... (step-by-step instructions)

How to use the Region of interest (ROI) in PIX4Dmatic

A Region of interest is a delimiting area to reduce the extent of outputs generated for a project, speed up the processing, or produce more focused and precise results.

Important:
  • Only one Region of interest per project can be drawn.
  • It is recommended to exclude areas of low overlap that could affect the results.

Effects of a Region of interest

The Region of interest can be used to restrain the processing and can be valuable for different key aspects such as:

  • Reduce the required storage of a project.
  • Increase the processing speed of a project.
  • Reduce the required hardware needed for processing a project.
  • Create better outputs with sharper edges.
  • Generate results for a restricted area of the project by excluding the surroundings of the area of interest, i.e. due to oblique imagery.
Tip: To include the entire project area in your results, consider drawing a region that extends beyond the project's boundaries.

How to import a Region of interest

To import a Region of interest:

  • Click on File > Import > Region of Interest

The file should contain only a single geometry, either a polygon or a circle, as only one region of interest can be active at a time within the project. If the file includes multiple geometries, it will not be possible to designate a specific one as the region of interest.

Note: PIX4Dmatic only supports 3D .kml files for importing a region of interest at this time. 

How to access the Region of interest

To access the Region of interest:

  • On the menu bar, click View > Region of Interest,

    Activating the Region of interest in PIX4Dmatic

  • On the Tools bar, select the Region of interest tool by clicking the Region of interest icon boundary.png, or use shortcut O to access the Region of interest.

How to draw a Region of interest

To draw a Region of interest:

  1. After selecting the Region of interest tool, left-click to place the first vertex and then release the mouse button.
  2. To place the following vertices, move the mouse to the desired location, left-click, and release the mouse button.
  3. (Optional) Click Esc to cancel the creation of the area.
  4. Right-click for the last vertex to close the polygon.
  5. Click File > Save to save the Region of interest in the project.
Note: It is possible to draw a Region of interest (ROI) at any stage of the processing. However, it is recommended to add the ROI before the Calibration or Densify steps to ensure immediate impact. If the ROI is defined after the Densify step, the point cloud must be reprocessed for the changes to take effect.

How to edit a Region of interest

To edit the Region of interest or correct the position of each vertex:

  1. Access the 2D or 3D view from the menu bar, the toolbar, or the keyboard shortcuts.
  2. Select the Region of interest by clicking anywhere inside its area, so that the vertices become visible.
  3. Click on a vertex to select it.
  4. Drag the vertex to move it to the correct position.
  5. (Optional) Click Esc to exit the Region of interest mode.
  6. (Optional) To remove an individual vertex, left-click on the specific vertex to select it and press the Delete button on the keyboard.
  7. (Optional) To add a new vertex, right-click on the position of the drawn polygon where the vertex needs to be added.
  8. Click outside the Region of interest to accept the modifications.
Note: When there are less than or equal to 3 vertices in the Region of interest, the deletion of a vertex will result in the deletion of the entire geometry.
To edit the Region of Interest or correct the height, use the yellow arrows at the top or bottom, depending on the adjustment needed.

How to delete a Region of interest

To remove the Region of interest:

  1. Open the 2D or 3D View via the menu bar, toolbar, or using the appropriate keyboard shortcut.
  2. Click anywhere inside the ROI to select it. The ROI’s vertices will become visible when selected.
  3. To remove the Region of interest, press Delete.
  4. (Optional) Draw it again from scratch if needed.
Note: It is possible to remove or delete a Region of interest only if it has already been drawn.