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 even create sharper outputs.

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:

  • Optimizing the required storage of a project.
  • Increase the processing speed of a project.
  • Reducing the required hardware needed for processing a project.
  • Creating 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: If you want to include the whole project extent to generate results, consider drawing a region that is larger than the project area.

How to import a Region of interest

To import a Region of interest:

  • Click on File > Import > Region of Interest

PIX4Dmatic only supports 3D .kml files for the import of a Region of Interest at the moment.

How to access the Region of interest

To access the Region of interest:

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

    PIX4Dmatic_ROI.png

  • On the Tools bar, select the Region of interest tool by clicking 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 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 and left-click, then 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 at any stage of the processing. It is recommended to add it before the Calibrate or the Densify step to have an immediate effect. Adding a Region of interest after the Densify step requires reprocessing to have an impact on the results.

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.

How to delete a Region of interest

To remove the Region of interest:

  1. Access the 2D or 3D View from the menu bar, the toolbar, or the keyboard shortcut. Select the Region of interest by clicking anywhere inside its area, so that the vertices become visible.
  2. To remove the Region of interest, press Delete.
  3. (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.