Aerial cloud

Aerial cloud, in MDTopX on Point classification, classifies LiDAR flight points into ground, vegetation and buildings using MDTopX's Magic Surface. The command applies the /MAGIC sequence to each tile and returns the resulting classes to Lot Of Points through process_tiles.

Cloud requirements

The button requires a cloud with an edit log and original-file indices. The command chooses open clouds meeting both conditions and retaining Global Positioning System (GPS) time and the flight line identifier (point_source_id). Hidden clouds meeting the requirements are included; each skipped cloud's name is written to Output.

The calculation groups points by flight line identifier and receives each flight line's points ordered by GPS time. Coordinates are represented in centimeters using 32-bit integers. If any tile coordinate fails the range check, the calculation fails and writes the reason to Output.

Parameters

Open Settings and select MDTopX. Settings are grouped under Aerial cloud: General, Aerial cloud: Heights, Aerial cloud: Buildings, Aerial cloud: Points and Aerial cloud: LiDAR codes.

Maximum distance between points is the largest gap between ground points and is the basis for other calculation distances. With Unclassify first enabled, calculation starts from class 1; otherwise it starts from existing classes. This option is added in Lot Of Points. Table units are those declared by the DLL for parameters.

Group Parameter Unit Default Declared range, both endpoints included Type
General Maximum distance between points m 3 0.5 – 50 Real
General Unclassify first No Yes / No Boolean
Heights Minimum height for aerial points m 50 0 – 1000 Real
Heights Minimum building height m 4 0 – 100 Real
Heights Maximum vegetation height m 15 0 – 1000 Real
Heights Minimum high vegetation height m 3 0 – 100 Real
Heights Minimum medium vegetation height m 2 0 – 100 Real
Heights Minimum low vegetation height m 1 0.01 – 100 Real
Buildings Minimum building area m² 30 0 – 1,000,000 Real
Buildings Maximum building slope ° 30 0 – 90 Real
Points Point elevation accuracy m 0.2 0.01 – 10 Real
Points Point search level % 1 1 – 10 Integer
LiDAR codes Low points 7 0 – 255 Integer
LiDAR codes Walls 12 0 – 255 Integer
LiDAR codes Aerial points 13 0 – 255 Integer
LiDAR codes Others 90 0 – 255 Integer
LiDAR codes Bridges 17 0 – 255 Integer

LiDAR codes configure the classes for those point types. SoloSuelo uses the bridge code and assigns class 2 to ground.

Processing characteristics

Feature Value
Core side 1000 cloud units.
Overlap width 100 cloud units.
Concurrent tiles Yes.
Estimated maximum memory per point 600 bytes.
Required additional attributes GPS time and flight line identifier.
Point order By flight line identifier, then GPS time within each flight line.

The command identifier is mdtopx.magic_surface. Calculation runs SoloSuelo and SuperficieMagica. SoloSuelo can perform a second pass with a 25 m search distance. If SuperficieMagica returns Ok, SinPuntos or ErrorDatos, calculation runs BuscaPicosIterado unless cancellation was requested.

If SuperficieMagica returns Incompleto, calculation retains the classes from preceding steps and skips BuscaPicosIterado. This result corresponds to SuperficiesPlanas, an MDTopX function not included in this DLL.

Messages

The command writes these cloud selection and summary messages to Output when the language is es. The DLL uses equivalent English text for other languages.

Message Meaning
Nube aérea: se omite la nube a la que le falta al menos uno de estos datos: registro de ediciones, índices de punto, tiempo GPS o fuente de punto: nombre The cloud lacks at least one command requirement.
Nube aérea: no hay ninguna nube que se pueda clasificar. No open cloud meets all requirements; the command ends without calling process_tiles.
Nube aérea: n puntos cambian de clase en k nubes. process_tiles returned LOP_OK; the summary gives reclassified points and modified clouds.

Tile calculation messages are written in English for every language. In these messages, N is the tile number, starting at 1.

Message Meaning
magic_surface: tile N: SuperficieMagica stopped at SuperficiesPlanas, which the port does not have (Incompleto); the tile keeps the classes of the steps before it, without E4 The tile retains classes from preceding steps and does not run BuscaPicosIterado.
magic_surface: tile N: a coordinate does not fit in centimetres as a 32-bit integer A coordinate fails the range check. Calculation returns LOP_FAILED.
magic_surface: tile N: K points have no matching classification result and keep their original class No classification result is found for K points, which retain their original class.
magic_surface: tile N: SuperficieMagica answered R SuperficieMagica returns numeric code R, other than Incompleto, Ok, SinPuntos and ErrorDatos.
magic_surface: texto del error Calculation catches a standard exception, writes its text and returns LOP_FAILED.
magic_surface: unknown error Calculation catches another exception and returns LOP_FAILED.