Represents a indexed point clouds data in octree. More...

#include <qgspointcloudindex.h>

Inheritance diagram for QgsPointCloudIndex:

Public Types
enum	AccessType { Local , Remote }
	The access type of the data, local is for local files and remote for remote files (over HTTP) More...

Public Member Functions
	QgsPointCloudIndex ()
	Constructs index. More...

	~QgsPointCloudIndex ()

virtual AccessType	accessType () const =0
	Returns the access type of the data If the access type is Remote, data will be fetched from an HTTP server either synchronously or asynchronously If the access type is local, the data is stored locally as a file and will only be fetch synchronously ( blocking request with nodeData only ) More...

virtual QgsPointCloudBlockRequest *	asyncNodeData (const IndexedPointCloudNode &n, const QgsPointCloudRequest &request)=0
	Returns a handle responsible for loading a node data block. More...

QgsPointCloudAttributeCollection	attributes () const
	Returns all attributes that are stored in the file. More...

virtual QgsCoordinateReferenceSystem	crs () const =0
	Returns the coordinate reference system of the point cloud index. More...

QgsRectangle	extent () const
	Returns extent of the data. More...

virtual bool	hasNode (const IndexedPointCloudNode &n) const
	Returns whether the octree contain given node. More...

virtual bool	isValid () const =0
	Returns whether index is loaded and valid. More...

virtual void	load (const QString &fileName)=0
	Loads the index from the file. More...

virtual QVariantList	metadataClasses (const QString &attribute) const =0
	Returns the classes of attribute. More...

virtual QVariant	metadataClassStatistic (const QString &attribute, const QVariant &value, QgsStatisticalSummary::Statistic statistic) const =0
	Returns the statistic statistic of the class value of the attribute attribute. More...

virtual QVariant	metadataStatistic (const QString &attribute, QgsStatisticalSummary::Statistic statistic) const =0
	Returns the statistic statistic of attribute. More...

QgsPointCloudDataBounds	nodeBounds (const IndexedPointCloudNode &node) const
	Returns bounds of particular node. More...

virtual QList< IndexedPointCloudNode >	nodeChildren (const IndexedPointCloudNode &n) const
	Returns all children of node. More...

virtual QgsPointCloudBlock *	nodeData (const IndexedPointCloudNode &n, const QgsPointCloudRequest &request)=0
	Returns node data block. More...

float	nodeError (const IndexedPointCloudNode &n) const
	Returns node's error in map units (used to determine in whether the node has enough detail for the current view) More...

QgsRectangle	nodeMapExtent (const IndexedPointCloudNode &node) const
	Returns the extent of a node in map coordinates. More...

int	nodePointCount (const IndexedPointCloudNode &n)
	Returns the number of poiny of indexed point cloud node n. More...

QgsDoubleRange	nodeZRange (const IndexedPointCloudNode &node) const
	Returns the z range of a node. More...

QgsVector3D	offset () const
	Returns offset. More...

virtual QVariantMap	originalMetadata () const =0
	Returns the original metadata map. More...

virtual qint64	pointCount () const =0
	Returns the number of points in the point cloud. More...

IndexedPointCloudNode	root ()
	Returns root node of the index. More...

QgsVector3D	scale () const
	Returns scale. More...

int	span () const
	Returns the number of points in one direction in a single node. More...

double	zMax () const
	Returns z max. More...

double	zMin () const
	Returns z min. More...

Protected Member Functions
void	setAttributes (const QgsPointCloudAttributeCollection &attributes)
	Sets native attributes of the data. More...

Protected Attributes
QgsPointCloudAttributeCollection	mAttributes

QgsRectangle	mExtent
	2D extent of data More...

QHash< IndexedPointCloudNode, int >	mHierarchy
	Data hierarchy. More...

QMutex	mHierarchyMutex

QgsVector3D	mOffset
	Offset of our int32 coordinates compared to CRS coords. More...

QgsPointCloudDataBounds	mRootBounds
	Bounds of the root node's cube (in int32 coordinates) More...

QgsVector3D	mScale
	Scale of our int32 coordinates compared to CRS coords. More...

int	mSpan
	All native attributes stored in the file. More...

double	mZMax = 0
	Vertical extent of data. More...

double	mZMin = 0

Detailed Description

Represents a indexed point clouds data in octree.

Note: The API is considered EXPERIMENTAL and can be changed without a notice

Since: QGIS 3.18

Definition at line 160 of file qgspointcloudindex.h.

Member Enumeration Documentation

◆ AccessType

enum QgsPointCloudIndex::AccessType

The access type of the data, local is for local files and remote for remote files (over HTTP)

Enumerator
Local	Local means the source is a local file on the machine.
Remote	Remote means it's loaded through a protocol like HTTP.

Definition at line 165 of file qgspointcloudindex.h.

Constructor & Destructor Documentation

◆ QgsPointCloudIndex()

QgsPointCloudIndex::QgsPointCloudIndex ( )

explicitdefault

Constructs index.

◆ ~QgsPointCloudIndex()

QgsPointCloudIndex::~QgsPointCloudIndex ( )

default

Member Function Documentation

◆ accessType()

virtual AccessType QgsPointCloudIndex::accessType ( ) const

pure virtual

Returns the access type of the data If the access type is Remote, data will be fetched from an HTTP server either synchronously or asynchronously If the access type is local, the data is stored locally as a file and will only be fetch synchronously ( blocking request with nodeData only )

Note: Always make sure to check before trying to use asyncNodeData since it is not supported in the case of local access type

◆ asyncNodeData()

virtual QgsPointCloudBlockRequest* QgsPointCloudIndex::asyncNodeData	(	const IndexedPointCloudNode &	n,
		const QgsPointCloudRequest &	request
	)

pure virtual

Returns a handle responsible for loading a node data block.

e.g. positions (needs to be scaled and offset applied to get coordinates) or classification, intensity or custom attributes

It is caller responsibility to free the handle and the block issued by the handle if the loading succeeds.

May return nullptr in case the node is not present or any other problem with loading

◆ attributes()

QgsPointCloudAttributeCollection QgsPointCloudIndex::attributes ( ) const

Returns all attributes that are stored in the file.

Definition at line 188 of file qgspointcloudindex.cpp.

◆ crs()

virtual QgsCoordinateReferenceSystem QgsPointCloudIndex::crs ( ) const

pure virtual

Returns the coordinate reference system of the point cloud index.

◆ extent()

QgsRectangle QgsPointCloudIndex::extent ( ) const

inline

Returns extent of the data.

Definition at line 239 of file qgspointcloudindex.h.

◆ hasNode()

bool QgsPointCloudIndex::hasNode ( const IndexedPointCloudNode & n ) const

virtual

Returns whether the octree contain given node.

Definition at line 159 of file qgspointcloudindex.cpp.

◆ isValid()

virtual bool QgsPointCloudIndex::isValid ( ) const

pure virtual

Returns whether index is loaded and valid.

◆ load()

virtual void QgsPointCloudIndex::load ( const QString & fileName )

pure virtual

Loads the index from the file.

◆ metadataClasses()

virtual QVariantList QgsPointCloudIndex::metadataClasses ( const QString & attribute ) const

pure virtual

Returns the classes of attribute.

◆ metadataClassStatistic()

virtual QVariant QgsPointCloudIndex::metadataClassStatistic	(	const QString &	attribute,
		const QVariant &	value,
		QgsStatisticalSummary::Statistic	statistic
	)		const

pure virtual

Returns the statistic statistic of the class value of the attribute attribute.

◆ metadataStatistic()

virtual QVariant QgsPointCloudIndex::metadataStatistic	(	const QString &	attribute,
		QgsStatisticalSummary::Statistic	statistic
	)		const

pure virtual

Returns the statistic statistic of attribute.

◆ nodeBounds()

QgsPointCloudDataBounds QgsPointCloudIndex::nodeBounds ( const IndexedPointCloudNode & node ) const

Returns bounds of particular node.

Definition at line 193 of file qgspointcloudindex.cpp.

◆ nodeChildren()

QList< IndexedPointCloudNode > QgsPointCloudIndex::nodeChildren ( const IndexedPointCloudNode & n ) const

virtual

Returns all children of node.

Definition at line 167 of file qgspointcloudindex.cpp.

◆ nodeData()

virtual QgsPointCloudBlock* QgsPointCloudIndex::nodeData	(	const IndexedPointCloudNode &	n,
		const QgsPointCloudRequest &	request
	)

pure virtual

Returns node data block.

e.g. positions (needs to be scaled and offset applied to get coordinates) or classification, intensity or custom attributes

It is caller responsibility to free the block.

May return nullptr in case the node is not present or any other problem with loading

◆ nodeError()

float QgsPointCloudIndex::nodeError ( const IndexedPointCloudNode & n ) const

Returns node's error in map units (used to determine in whether the node has enough detail for the current view)

Definition at line 222 of file qgspointcloudindex.cpp.

◆ nodeMapExtent()

QgsRectangle QgsPointCloudIndex::nodeMapExtent ( const IndexedPointCloudNode & node ) const

Returns the extent of a node in map coordinates.

See also: nodeZRange()

Definition at line 212 of file qgspointcloudindex.cpp.

◆ nodePointCount()

int QgsPointCloudIndex::nodePointCount ( const IndexedPointCloudNode & n )

Returns the number of poiny of indexed point cloud node n.

Definition at line 248 of file qgspointcloudindex.cpp.

◆ nodeZRange()

QgsDoubleRange QgsPointCloudIndex::nodeZRange ( const IndexedPointCloudNode & node ) const

Returns the z range of a node.

See also: nodeMapExtent()

Definition at line 217 of file qgspointcloudindex.cpp.

◆ offset()

QgsVector3D QgsPointCloudIndex::offset ( ) const

Returns offset.

Definition at line 233 of file qgspointcloudindex.cpp.

◆ originalMetadata()

virtual QVariantMap QgsPointCloudIndex::originalMetadata ( ) const

pure virtual

Returns the original metadata map.

◆ pointCount()

virtual qint64 QgsPointCloudIndex::pointCount ( ) const

pure virtual

Returns the number of points in the point cloud.

◆ root()

IndexedPointCloudNode QgsPointCloudIndex::root ( )

inline

Returns root node of the index.

Definition at line 203 of file qgspointcloudindex.h.

◆ scale()

QgsVector3D QgsPointCloudIndex::scale ( ) const

Returns scale.

Definition at line 228 of file qgspointcloudindex.cpp.

◆ setAttributes()

void QgsPointCloudIndex::setAttributes ( const QgsPointCloudAttributeCollection & attributes )

protected

Sets native attributes of the data.

Definition at line 238 of file qgspointcloudindex.cpp.

◆ span()

int QgsPointCloudIndex::span ( ) const

Returns the number of points in one direction in a single node.

Definition at line 243 of file qgspointcloudindex.cpp.

◆ zMax()

double QgsPointCloudIndex::zMax ( ) const

inline

Returns z max.

Definition at line 244 of file qgspointcloudindex.h.

◆ zMin()

double QgsPointCloudIndex::zMin ( ) const

inline

Returns z min.

Definition at line 242 of file qgspointcloudindex.h.

Member Data Documentation

◆ mAttributes

QgsPointCloudAttributeCollection QgsPointCloudIndex::mAttributes

protected

Definition at line 294 of file qgspointcloudindex.h.

◆ mExtent

QgsRectangle QgsPointCloudIndex::mExtent

protected

2D extent of data

Definition at line 286 of file qgspointcloudindex.h.

◆ mHierarchy

QHash<IndexedPointCloudNode, int> QgsPointCloudIndex::mHierarchy

mutableprotected

Data hierarchy.

Definition at line 290 of file qgspointcloudindex.h.

◆ mHierarchyMutex

QMutex QgsPointCloudIndex::mHierarchyMutex

mutableprotected

Definition at line 289 of file qgspointcloudindex.h.

◆ mOffset

QgsVector3D QgsPointCloudIndex::mOffset

protected

Offset of our int32 coordinates compared to CRS coords.

Definition at line 292 of file qgspointcloudindex.h.

◆ mRootBounds

QgsPointCloudDataBounds QgsPointCloudIndex::mRootBounds

protected

Bounds of the root node's cube (in int32 coordinates)

Definition at line 293 of file qgspointcloudindex.h.

◆ mScale

QgsVector3D QgsPointCloudIndex::mScale

protected

Scale of our int32 coordinates compared to CRS coords.

Definition at line 291 of file qgspointcloudindex.h.

◆ mSpan

int QgsPointCloudIndex::mSpan

protected

All native attributes stored in the file.

Number of points in one direction in a single node

Definition at line 295 of file qgspointcloudindex.h.

◆ mZMax

double QgsPointCloudIndex::mZMax = 0

protected

Vertical extent of data.

Definition at line 287 of file qgspointcloudindex.h.

◆ mZMin

double QgsPointCloudIndex::mZMin = 0

protected

Definition at line 287 of file qgspointcloudindex.h.

The documentation for this class was generated from the following files:

/build/qgis-3.24.2+99sid/src/core/pointcloud/qgspointcloudindex.h
/build/qgis-3.24.2+99sid/src/core/pointcloud/qgspointcloudindex.cpp

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ AccessType

Constructor & Destructor Documentation

◆ QgsPointCloudIndex()

◆ ~QgsPointCloudIndex()

Member Function Documentation

◆ accessType()

◆ asyncNodeData()

◆ attributes()

◆ crs()

◆ extent()

◆ hasNode()

◆ isValid()

◆ load()

◆ metadataClasses()

◆ metadataClassStatistic()

◆ metadataStatistic()

◆ nodeBounds()

◆ nodeChildren()

◆ nodeData()

◆ nodeError()

◆ nodeMapExtent()

◆ nodePointCount()

◆ nodeZRange()

◆ offset()

◆ originalMetadata()

◆ pointCount()

◆ root()

◆ scale()

◆ setAttributes()

◆ span()

◆ zMax()

◆ zMin()

Member Data Documentation

◆ mAttributes

◆ mExtent

◆ mHierarchy

◆ mHierarchyMutex

◆ mOffset

◆ mRootBounds

◆ mScale

◆ mSpan

◆ mZMax

◆ mZMin