How do I upload pointcloud data in xyz ASCII format?

Make sure the first line of the file defines the format of the xyz data.

Pointclouds can be loaded into the Rock Cloud from an ASCII text file.  There are specific requirements for this to work properly.

 

1. The file must have '.xyz' as its extension.

2. Each point is represented in the file as a single line. Each line is expected to be divided into a number of fields by a separator. Each field represents a value for a point's dimension.

3. The first line in the file needs to indicate the format of the points (each subsequent line). Each line in the file must contain the same number of fields as indicated by dimension names in the header. Spaces are generally ignored in the input unless used as a separator. When a space character is used as a separator, any number of consecutive spaces are treated as single space and leading/trailing spaces are ignored.

 

Example input file comma delimited:

X,Y,Z
289814.15,4320978.61,170.76
289814.64,4320978.84,170.76
289815.12,4320979.06,170.75
289815.60,4320979.28,170.74
289816.08,4320979.50,170.68
289816.56,4320979.71,170.66
289817.03,4320979.92,170.63
289817.53,4320980.16,170.62
289818.01,4320980.38,170.61
289818.50,4320980.59,170.58

 

Example input file space delimited:

X Y Z
289814.15 4320978.61 170.76
289814.64 4320978.84 170.76
289815.12 4320979.06 170.75
289815.60 4320979.28 170.74
289816.08 4320979.50 170.68
289816.56 4320979.71 170.66
289817.03 4320979.92 170.63
289817.53 4320980.16 170.62
289818.01 4320980.38 170.61
289818.50 4320980.59 170.58

 

Valid dimension names:

Name

Type

Description

Alpha

uint16

Alpha

Amplitude

float

This is the ratio of the received power to the power received at the detection limit expressed in dB

Anisotropy

double

Anisotropy of a point; larger values indicate strong variance in multiple dimensions.

Azimuth

double

Scanner azimuth

BackgroundRadiation

float

A measure of background radiation.

Blue

uint16

Blue image channel value

ClassFlags

uint8

Class Flags

Classification

uint8

ASPRS classification. 0 for no classification. See LAS specification for details.

ClusterID

int64_t

ID assigned to a point by a point-clustering algorithm.

Coplanar

uint8

Indicator of whether or not a point is part of a coplanar neighborhood.

Curvature

double

Curvature of surface at this point

DemantkeVerticality

double

Verticality of a point; larger values indicate vertical structure (Demantke’s variation).

Density

double

Estimate of point density

Deviation

float

Difference between the shape of the reference pulse and the return pulse. A larger value for deviation indicates larger distortion.

EchoRange

double

Echo Range

EdgeOfFlightLine

uint8

Indicates the end of scanline before a direction change with a value of 1 - 0 otherwise

Eigenentropy

double

Eigenentropy of a point; small values indicate more ordered regions, while large values indicate disorder.

Eigenvalue0

double

Smallest eigenvalue obtained form covariance of XYZ coordinates in k-neighborhood.

Eigenvalue1

double

Middle eigenvalue obtained form covariance of XYZ coordinates in k-neighborhood.

Eigenvalue2

double

Largest eigenvalue obtained form covariance of XYZ coordinates in k-neighborhood.

EigenvalueSum

double

Sum of computed eigenvalues.

ElevationCentroid

double

Elevation Centroid

ElevationHigh

double

Elevation High

ElevationLow

double

Elevation Low

Flag

uint8

Flag

GpsTime

double

GPS time that the point was acquired

Green

uint16

Green image channel value

HeightAboveGround

double

Height Above Ground

Infrared

uint16

Infrared

Intensity

uint16

Representation of the pulse return magnitude

InternalTime

double

Scanner’s internal time when the point was acquired, in seconds

IsPpsLocked

uint8

The external PPS signal was found to be synchronized at the time of the current laser shot.

LatitudeCentroid

double

Latitude Centroid

LatitudeHigh

double

Latitude High

LatitudeLow

double

Latitude Low

Linearity

double

Linearity of a point; larger values indicate more linear regions.

LocalOutlierFactor

double

Outlier factor based on the LocalReachabilityDistance of a point’s nearest neighbors.

LocalReachabilityDistance

double

Reachability metric based on the NNDistance of a point’s nearest neighbors.

LongitudeCentroid

double

Longitude Centroid

LongitudeHigh

double

Longitude High

LongitudeLow

double

Longitude Low

LvisLfid

uint64

LVIS_LFID

Mark

uint8

Mark

Miniball

double

Metric capturing distance from a point to the center of the smallest enclosing ball encapsulating k-nearest neighbors, scaled by radius of the ball.

NNDistance

double

Distance metric related to a point’s nearest neighbors.

NormalX

double

X component of a vector normal to surface at this point

NormalY

double

Y component of a vector normal to surface at this point

NormalZ

double

Z component of a vector normal to surface at this point

NumberOfReturns

uint8

Total number of returns for a given pulse.

OffsetTime

uint32

Milliseconds from first acquired point

Omit

uint8_t

Used to shallowly mark a point as being omitted without removing it

Omnivariance

double

Omnivariance of a point; cube root of the product of all eigenvalues.

OptimalKNN

uint64

Optimal number of k nearest neighbors, such that eigenentropy is minimized.

OptimalRadius

double

Radius corresponding to optimal k nearest neighbors, such that eigenentropy is minimized.

OriginId

uint32

A file source ID from which the point originated. This ID is global to a derivative dataset which may be aggregated from multiple files.

PassiveSignal

int32

Relative passive signal

PassiveX

double

Passive X footprint

PassiveY

double

Passive Y footprint

PassiveZ

double

Passive Z footprint

Pdop

float

GPS PDOP (dilution of precision)

Pitch

float

Pitch in degrees

Planarity

double

Planarity of a point; larger values indicate more planar regions.

PlaneFit

double

Metric capturing current point’s point to plane distance compared to those in the same k-neighborhood used to estimate the plane.

PointId

uint32

An explicit representation of point ordering within a file, which allows this usually-implicit information to be preserved when reordering points.

PointSourceId

uint16

File source ID from which the point originated. Zero indicates that the point originated in the current file

PulseWidth

float

Laser received pulse width (digitizer samples)

RadialDensity

double

Estimate of radial point density

Rank

uint8

Estimated rank of neighborhood of points.

Reciprocity

double

Metric capturing percentage of k-nearest neighbors that also contain the current point in their k-neighborhood.

Red

uint16

Red image channel value

Reflectance

float

Ratio of the received power to the power that would be received from a white diffuse target at the same distance expressed in dB. The reflectance represents a range independent property of the target. The surface normal of this target is assumed to be in parallel to the laser beam direction.

ReflectedPulse

int32

Relative reflected pulse signal strength

ReturnNumber

uint8

Pulse return number for a given output pulse. A given output laser pulse can have many returns, and they must be marked in order, starting with 1

Roll

float

Roll in degrees

ScanAngleRank

float

Angle degree at which the laser point was output from the system, including the roll of the aircraft. The scan angle is based on being nadir, and -90 the left side of the aircraft in the direction of flight

ScanChannel

uint8

Scan Channel

ScanDirectionFlag

uint8

Direction at which the scanner mirror was traveling at the time of the output pulse. A value of 1 is a positive scan direction, and a bit value of 0 is a negative scan direction, where positive scan direction is a scan moving from the left side of the in-track direction to the right side and negative the opposite

Scattering

double

Scattering of a point; larger values incidate complex (scattered) 3D regions.

ShotNumber

uint64

Shot Number

StartPulse

int32

Relative pulse signal strength

SurfaceVariation

double

Surface variation of a point; larger values indicate higher surface variation.

TextureU

double

U component of a texture location at this point

TextureV

double

V component of a texture location at this point

TextureW

double

W component of a texture location at this point

UserData

uint8

Unspecified user data

Verticality

double

Verticality of a point; larger values indicate vertical structure.

W

double

W coordinate

WanderAngle

double

Wander Angle

X

double

X coordinate

XBodyAccel

double

X Body Acceleration

XBodyAngRate

double

X Body Angle Rate

XVelocity

double

X Velocity

Y

double

Y coordinate

YBodyAccel

double

Y Body Acceleration

YBodyAngRate

double

Y Body Angle Rate

YVelocity

double

Y Velocity

Z

double

Z coordinate

ZBodyAccel

double

Z Body Acceleration

ZBodyAngRate

double

Z Body Angle Rate

ZVelocity

double

Z Velocity