Read and write points (with or without additional properties) in LAS format.

Functions
template<typename PointMap >
std::tuple< PointMap, typename Kernel_traits< typename PointMap::value_type >::Kernel::Construct_point_3, LAS_property::X, LAS_property::Y, LAS_property::Z >	CGAL::make_las_point_reader (PointMap point_map)
	Generates a LAS property handler to read 3D points. More...

template<typename OutputIteratorValueType , typename OutputIterator , typename ... PropertyHandler>
bool	CGAL::read_las_points_with_properties (std::istream &stream, OutputIterator output, PropertyHandler &&... properties)
	Reads user-selected points properties from a .las or .laz stream. More...

template<typename OutputIteratorValueType , typename OutputIterator , typename NamedParameters >
bool	CGAL::read_las_points (std::istream &stream, OutputIterator output, const NamedParameters &np)
	Reads points (position only) from a .las or .laz stream. More...

template<typename PointMap >
std::tuple< PointMap, LAS_property::X, LAS_property::Y, LAS_property::Z >	CGAL::make_las_point_writer (PointMap point_map)
	Generates a LAS property handler to write 3D points. More...

template<typename PointRange , typename PointMap , typename ... PropertyHandler>
bool	CGAL::write_las_points_with_properties (std::ostream &stream, const PointRange &points, std::tuple< PointMap, LAS_property::X, LAS_property::Y, LAS_property::Z > point_property, PropertyHandler &&... properties)
	Saves the range of `points` with properties to a .las stream. More...

template<typename PointRange , typename NamedParameters >
bool	CGAL::write_las_points (std::ostream &stream, const PointRange &points, const NamedParameters &np)
	Saves the range of `points` (positions only) to a .las stream. More...

Function Documentation

◆ make_las_point_reader()

template<typename PointMap >

std::tuple<PointMap, typename Kernel_traits<typename PointMap::value_type>::Kernel::Construct_point_3, LAS_property::X, LAS_property::Y, LAS_property::Z > CGAL::make_las_point_reader ( PointMap point_map )

#include <CGAL/IO/read_las_points.h>

Generates a LAS property handler to read 3D points.

Points are constructed from the input the using 3 LAS properties LAS_property::X, LAS_property::Y and LAS_property::Z.

See also: read_las_points_with_properties()

Template Parameters

PointMap the property map used to store points.

Examples:: Point_set_processing_3/read_las_example.cpp.

◆ make_las_point_writer()

template<typename PointMap >

std::tuple<PointMap, LAS_property::X, LAS_property::Y, LAS_property::Z > CGAL::make_las_point_writer ( PointMap point_map )

#include <CGAL/IO/write_las_points.h>

Generates a LAS property handler to write 3D points.

See also: write_las_points_with_properties()

Template Parameters

PointMap the property map used to store points.

◆ read_las_points()

template<typename OutputIteratorValueType , typename OutputIterator , typename NamedParameters >

bool CGAL::read_las_points	(	std::istream &	stream,
		OutputIterator	output,
		const NamedParameters &	np
	)

#include <CGAL/IO/read_las_points.h>

Reads points (position only) from a .las or .laz stream.

Potential additional properties are ignored.

Template Parameters

OutputIteratorValueType	type of objects that can be put in `OutputIterator`. It is default to `value_type_traits<OutputIterator>::type` and can be omitted when the default is fine.
OutputIterator	iterator over output points.

Parameters

stream	input stream.
output	output iterator over points.
np	an optional sequence of Named Parameters among the ones listed below

Optional Named Parameters

a property map associating points to the elements of the point range
Type: a model of WritablePropertyMap with value type geom_traits::Point_3
Default: CGAL::Identity_property_map<geom_traits::Point_3>

an instance of a geometric traits class
Type: a model of Kernel
Default: a CGAL Kernel deduced from the point type, using CGAL::Kernel_traits

Returns: true on success.

Warning: This function requires a C++11 compiler.

◆ read_las_points_with_properties()

template<typename OutputIteratorValueType , typename OutputIterator , typename ... PropertyHandler>

bool CGAL::read_las_points_with_properties	(	std::istream &	stream,
		OutputIterator	output,
		PropertyHandler &&...	properties
	)

#include <CGAL/IO/read_las_points.h>

Reads user-selected points properties from a .las or .laz stream.

Potential additional properties are ignored.

Properties are handled through a variadic list of property handlers. A PropertyHandler can either be:

A std::pair<PropertyMap, LAS_property::Tag > if the user wants to read a LAS property as a scalar value LAS_property::Tag::type (for example, storing an int LAS property into an int variable).
A std::tuple<PropertyMap, Constructor, LAS_property::Tag...> if the user wants to use one or several LAS properties to construct a complex object (for example, storing 4 unsigned short LAS properties into a Color object that can for example be a std::array<unsigned short, 4>). In that case, the second element of the tuple should be a functor that constructs the value type of PropertyMap from N objects of of type LAS_property::Tag::type.

The LAS standard defines a fixed set of properties accessible through the following tag classes:

LAS_property::X with type double
LAS_property::Y with type double
LAS_property::Z with type double
LAS_property::Intensity with type unsigned short
LAS_property::Return_number with type unsigned char
LAS_property::Number_of_returns with type unsigned char
LAS_property::Scan_direction_flag with type unsigned char
LAS_property::Edge_of_flight_line with type unsigned char
LAS_property::Classification with type unsigned char
LAS_property::Synthetic_flag with type unsigned char
LAS_property::Keypoint_flag with type unsigned char
LAS_property::Withheld_flag with type unsigned char
LAS_property::Scan_angle with type double
LAS_property::User_data with type unsigned char
LAS_property::Point_source_ID with type unsigned short
LAS_property::Deleted_flag with type unsigned int
LAS_property::GPS_time with type double
LAS_property::R with type unsigned short
LAS_property::G with type unsigned short
LAS_property::B with type unsigned short
LAS_property::I with type unsigned short

Warning: This function requires a C++11 compiler.

See also: make_las_point_reader()

Template Parameters

OutputIteratorValueType	type of objects that can be put in `OutputIterator`. It is default to `value_type_traits<OutputIterator>::type` and can be omitted when the default is fine.
OutputIterator	iterator over output points.
PropertyHandler	handlers to recover properties.

Returns: true on success.

Examples:: Point_set_processing_3/read_las_example.cpp.

◆ write_las_points()

template<typename PointRange , typename NamedParameters >

bool CGAL::write_las_points	(	std::ostream &	stream,
		const PointRange &	points,
		const NamedParameters &	np
	)

#include <CGAL/IO/write_las_points.h>

Saves the range of points (positions only) to a .las stream.

Template Parameters

PointRange is a model of ConstRange. The value type of its iterator is the key type of the named parameter point_map.

Parameters

stream	output stream.
points	input point range.
np	an optional sequence of Named Parameters among the ones listed below

Optional Named Parameters

a property map associating points to the elements of the point range Type: a model of `ReadablePropertyMap` with value type `geom_traits::Point_3` Default: `CGAL::Identity_property_map<geom_traits::Point_3>`
an instance of a geometric traits class Type: a model of `Kernel` Default: a CGAL Kernel deduced from the point type, using `CGAL::Kernel_traits`

Returns: true on success.

Warning: This function requires a C++11 compiler.

◆ write_las_points_with_properties()

template<typename PointRange , typename PointMap , typename ... PropertyHandler>

bool CGAL::write_las_points_with_properties	(	std::ostream &	stream,
		const PointRange &	points,
		std::tuple< PointMap, LAS_property::X, LAS_property::Y, LAS_property::Z >	point_property,
		PropertyHandler &&...	properties
	)

#include <CGAL/IO/write_las_points.h>

Saves the range of points with properties to a .las stream.

Properties are handled through a variadic list of property handlers. A PropertyHandle is a std::pair<PropertyMap, LAS_property::Tag > used to write a scalar value LAS_property::Tag::type as a LAS property (for example, writing an int vairable as an int LAS property). An exception is used for points that are written using a std::tuple object.

See documentation of read_las_points_with_properties() for the list of available LAS_property::Tag classes.

See also: make_las_point_writer()

Warning: This function requires a C++11 compiler.

Template Parameters

PointRange	is a model of `ConstRange`. The value type of its iterator is the key type of the named parameter `point_map`.
PointMap	is a model of `ReadablePropertyMap` with a value_type = `CGAL::Point_3`.
PropertyHandler	handlers to recover properties.

Returns: true on success.

Parameters

stream	output stream.
points	input point range.
point_property	property handler for points
properties	parameter pack of property handlers

Functions

Function Documentation

◆ make_las_point_reader()

◆ make_las_point_writer()

◆ read_las_points()

◆ read_las_points_with_properties()

◆ write_las_points()

◆ write_las_points_with_properties()