Structure Scan (Plan Pattern) - Daily Builds
A Structure Scan allows you to create a grid flight pattern that captures images over vertical surfaces (e.g. walls) around a structure with an arbitrary polygonal (or circular) ground footprint. Structure Scans are typically used for the visual inspection or creating 3d models of structures.
Structure Scans may be inserted into a mission using the Plan view Pattern > Structure Scan tool.
The new version of Structure Scan can't read older Structure Scan plans. They will need to be recreated.
This feature is not yet supported by ArduPilot firmware. It is supported in PX4.
The image below shows a screenshot of structure scan. The green polygon is used to mark out the ground footprint of the structure, while the white line around it indicates the vehicle flight path. The green numbered circle on the flight path is the scan entry/exit point (where the scan starts).
The scan divides the structure evenly into layers; the vehicle flies all the way around the structure at a particular altitude and scan distance from the structure, then repeats the process at each layer until the whole surface has been scanned.
Users can set the scan bottom altitude to avoid obstacles at the bottom of the structure, and the extrance/exit altitude to avoid obstacles as the vehicle travels to/from the scan.
Creating a Scan
To create a scan:
In the Plan View select Pattern tool > Structure Scan.
This will create a simple square structure scan on the map.
The region shown in green must be modified so that it surrounds the structure.
- Drag the opaque vertices on the map to the edge of the structure (example circled in mauve above).
- If the structure footprint is more than a simple square you can click the semi-transparent circles between the vertices to create a new vertix.
You can also change to a circular footprint by clicking on the central "vertix" (marked in red) and selecting Circle in the popup menu.
- From the popup menu you can switch back to a polygon footprint and change the radius and/or position of the scan.
- Drag the central vertix to position the centre of the circle.
The rest of the configuration is handled using the Structure Scan editor on the right hand side of the view. First select whether you want to perform a manual scan, a scan using a particular camera, or a scan using a custom camera definition.
The main difference between the modes is that predefined cameras are already set up to correctly calculate an effective layer height and trigger distance.
Options for the different modes are shown below.
The user can always configure the following settings:
- Start scan from top/bottom: The direction in which layers are scanned.
- Structure height: The height of the object being scanned.
- Scan distance: Distance from the structure of the flight path.
- Entrance/Exit Alt: Use this setting to avoid obstacles between the last/next waypoint and the structure to be scanned.
- The vehicle will fly to the Entrance/Exit point at this altitude and then descend to the initial layer to start the scan.
- The vehicle will ascend to this altitude after completing the scan and then move to the next waypoint.
- Scan Bottom Alt: Use this setting to avoid obstacles around the base of the structure. This adjust the bottom of the structure to be above the ground, and hence the altitude of the first scan (the height of the lowest layer flight path is shown in the scan statistics as Bottom Layer Alt.
- Rotate Entry Point: Move the start/finish point to the next vertix/position on the flight path.
The remaining settings depend on the camera mode:
- Manual Mode allows you to specify:
- Layer height: The height of each layer.
- Trigger Distance: The distance between each camera trigger. The camera is only triggered while flying the layer path. It does not trigger images while transitioning from one layer to the next.
- Gimbal Pitch - Gimbal pitch you want to use for the scan.
- Selecting a pre-defined camera automatically selects an appropriate layer height and camera triggering distance. It also ensures that the camera is always pointed directly at the right angles to the surface which it is capturing images.
- Selecting a custom camera allows you to enter your own camera characteristics, and otherwise behaves the same as a predefined camera.