PyVrPunt

This class allows you to manage points. Points in Vr are normally used as an efficient method to store LiDAR data. Points are managed in buffers, and each point contains an x,y,z location along with many attribute fields. Each buffer is currently set to hold 1000 points.

Several methods use a point attribute dictionary to specify the point attributes. The attribute dictionary is a standard Python dictionary holding the attributes for a single point. A dictionary may be created using the standard Python syntax or with the InitPuntA convenience method of this class. An attribute dictionary is returned from the GetPunt, GetPuntA methods, and is set using ChgPunt, ChgPuntA, or InsPunt. The same thing can be accomplished using the direct methods for changing attributes such as SetInt, SetDsp, etc., but it may be more convenient to create and work with dictionary objects. Using attribute dictionaries is more efficient when changing multiple attributes.

The following sample code demonstrates loading a Punt buffer, and then setting some attributes on one point.

The following sample code demonstrates creating new Punt buffers. Notice how IsFull() is used to determine when the buffer should be recorded and reset.

WsNum	Workspace
returns	(ret)
	ret	New Point entity number

returns	(format)
	format	LAS Data format code (0 - 3).

returns

(ret)

ret

Mode.

1= Line.

2= Spline.

3= Symbol.

4= Text.

5= Point.

Aws	Currently active workspace.
returns	(ret)
	ret	Pen number (1-256).

returns	(ret)
	ret	Feature code (up to 48 characters).

Tests whether a point buffer is full. This should be used when creating new Punt entities to check if they are full and need to be recorded.

x	X coordinate of point to add.
y	Y coordinate of point to add.
z	Z coordinate of point to add.
PuntA	Point attributes dictionary.
returns	(ret)
	ret	Point number in buffer.

x	X coordinate of point to add.
y	Y coordinate of point to add.
z	Z coordinate of point to add.
PuntA	Point attributes dictionary.
r	Red channel.
g	Green channel.
b	Blue channel.
returns	(ret)
	ret	Point number in buffer.

x	X coordinate of point to add.
y	Y coordinate of point to add.
z	Z coordinate of point to add.
PuntA	Point attributes dictionary.
returns	(ret)
	ret	Point number in buffer (-1 = Point is duplicate).

Adds a unique point with RGB data to the point buffer. Does not allow point duplication.

x	X coordinate of point to add.
y	Y coordinate of point to add.
z	Z coordinate of point to add.
PuntA	Point attributes dictionary.
r	Red channel.
g	Green channel.
b	Blue channel.
returns	(ret)
	ret	Point number in buffer (-1 = Punt is duplicate).

Adds a unique point to the point buffer. Does not allow point duplication with the XY coordinates.

x	X coordinate of point to add.
y	Y coordinate of point to add.
z	Z coordinate of point to add.
returns	(ret)
	ret	Point number in buffer. -1 = Punt is duplicate.

PuntNum	Point number to change (LAST=Last).
x	X coordinate of point to add.
y	Y coordinate of point to add.
z	Z coordinate of point to add.
PuntA	Point attributes dictionary.

PuntNum	Point number to change (LAST=Last).
x	X coordinate of point to add.
y	Y coordinate of point to add.
z	Z coordinate of point to add.
PuntA	Point attributes dictionary.
r	Red channel.
g	Green channel.
b	Blue channel.

PuntNum	Point after which to insert new point.
x	X coordinate of new point.
y	Y coordinate of new point.
z	Z coordinate of new point.
PuntA	Point attributes dictionary.

PuntNum	Point to insert after
x	X coordinate of new point.
y	Y coordinate of new point.
z	Z coordinate of new point.
PuntA	Point attributes dictionary.
r	Red channel.
g	Green channel.
b	Blue channel.

PuntNum	Number of point to get (LAST=Last).
returns	(x, y, z, PuntA).
	x	X coordinate of new point.
	y	Y coordinate of new point.
	z	Z coordinate of new point.
	PuntA	Point attributes dictionary.

PuntNum	Number of point to get (LAST=Last).
returns	(x, y, z, PuntA, r, g, b)
	x	X coordinate of new point.
	y	Y coordinate of new point.
	z	Z coordinate of new point.
	PuntA	Point attributes dictionary.
	r	Red channel.
	g	Green channel.
	b	Blue channel.

PuntNum	Number of point to get (LAST=Last).
returns	(PuntA).
	PuntA	Coordinate attributes dictionary

Updates header information, minimum and maximum coordinates, minimum and maximum intensities, and classes that have been used.

returns	(MinX, MinY, MinZ, MaxX, MaxY, MaxZ)
	MinX	Minimum X coordinate.
	MinY	Minimum Y coordinate.
	MinZ	Minimum Z coordinate.
	MaxX	Maximum X coordinate.
	MaxY	Maximum Y coordinate.
	MaxZ	Maximum Z coordinate.

x	X coordinate of search point.
y	Y coordinate of search point.
z	Z coordinate of search point.
SeaRad	Search radius in ground units.
returns	(ret)
	ret	Closest point number (-1=No points in buffer)

Gets the intensity minimum and maximum for points in buffer. Deleted points are not considered.

returns	(Min, Max)
	Min	Minimum intensity.
	Max	Maximum intensity.

Class[32]
returns	(Class)
	Class	Classification flags as a Python list with 32 entries. NOTE: The Class array is not initialized, so multiple calls can be made with it. No item is ever set to 0.

Hacks from the specified point number to the end of the buffer. Leaves the point of PuntNum as last point in buffer.

PuntNum	Point number (0-Count-1 LAST=Last)
x	X coordinate to which to compute distance.
y	Y coordinate to which to compute distance.
returns	(ret)
	ret	Distance.

Axis	Sorting method. 0=X axis location.. 1=Y axis location. 2=Z axis location (elevation). 3=Intensity. 4=Return.

returns	(ret, PuntA)
	PuntA	Vr Point Attributes dictionary

PuntA1	Vr Point Attributes dictionary 1.
PuntA2	Vr Point Attributes dictionary 2.
returns	(ret)
	ret	0= Equal. 1= Not equal.