Surface of Revolution Analysis (plugin)

From CloudCompareWiki
Jump to navigation Jump to search

Introduction

The qSRA plugin computes distances between a cloud and a theoretical Surface of Revolution. The surface of revolution is simply defined by a 2D profile.

Once the distances are computed, the plugin lets the user create a 2D map of deviations, either with a cylindrical or a conical projection.

QSRACylindricalMap.jpg


Since version 2.6.2 a 'cylinder' or a 'cone' primitives can be used in place of a 2D profile.


Loading a 2D profile QSRALoadProfileIcon.png

2D profiles can be loaded with the "Plugins > qSRA > Load profile" menu entry or the equivalent icon in the plugin's toolbar.

The corresponding dialog will mainly ask the user to specify a '2D profile' TXT file (the expected format is recalled directly above the Profile file field):

   Xc        Yc         Zc      (profile origin)
   4667.000  10057.000  171.000	
   R                    H       (radius and height of profile vertices)
   59.3235190427553	28.685
   58.8177164625621	30.142
   58.32550519856	31.594
   57.8404034801208	33.044
   ...

Don't change the header lines ('Xc...' and 'R...'), don't add blank lines, etc.

Notes:

  • The profile origin is a point on the revolution axis corresponding to zero height (H = 0) by default (see below).
  • The profile is described as a series of (radius,height) couples. The height values must be either constantly increasing or constantly decreasing.

Eventually the user can specify the revolution axis in 3D (X, Y or Z) and whether the height values are expressed relatively to the profile origin (i.e. z3D = Zc + H) or if they are absolute (i.e. z3D = H).

Computing radial distances QSRADistToProfileIcon.png

To compute the (radial) distances between a cloud and a 2D profile (i.e. the Surface of Revolution), the user must highlight both the cloud and the profile (or a cylinder/cone primitive since version 2.6.2) at the same time. Keep the CTRL key pressed while selecting both entities in the DB tree.

No dialog is displayed (apart from a progress bar).

QSRAProfile.png
QSRARadialDistances.png

On completion, the tool will automatically suggest to launch the Map Generation tool (see below).

Map Generation QSRACreateMapIcon.png

To launch the map generation tool, the user must select both the cloud and the profile at the same time (keep the CTRL key pressed while selecting both entities in the DB tree). The cloud must already have a scalar field with radial distances (see above).

Most of the parameters are straightforward. You'll have to click on the Apply button to make the map appear (or to refresh it if you change some parameters).

QSRAConical.jpg

You can export the map to various formats:

  • CSV matrix file
  • image
  • point cloud (with the cylindrical projection only)
  • textured mesh of the Surface of Revolution (with the cylindrical projection only)

You can also generate horizontal and/or vertical profiles in Autocad DXF format.