Tool Import Point Cloud from Text File

Creates a point cloud from a text file.
The input file must have at least three columns holding the x, y, z coordinates of each point. You must specify the field index (i.e. the column) of these. Field index starts to count with 1. In case you like to import additional attributes, you have to provide the field indexes for those attributes with the -FIELDS option as integer numbers separated by semicolon (e.g. "-FIELDS=4;5;8").

You have also to select the field separator that is used by the file and if the first line of the file should be skipped (in case it contains column headings).
The columns in the input file can be in any order, and you can omit columns, but you have to provide the correct field index for those fields that you like to import.

The tool usage differs slightly between SAGA GUI and SAGA CMD. With SAGA GUI you can specify names and types for additional fields in the 'Specifications' sub dialog. To do this using SAGA CMD you have to use the -FIELDNAMES and -FIELDTYPES options. The first one is for the field names, the second for the data type specification (see the GUI which number equals which data type). Again entries have to be separated by semicolons, e.g. "-FIELDNAMES=intensity;class;range -FIELDTYPES=2;2;3".

Author: V. Wichmann, LASERDATA GmbH (c) 2009
Menu: File|Shapes|Import

Parameters

	Name	Type	Identifier	Description	Constraints
Output	Point Cloud (*)	Data Object (optional output)	`POINTS`	-	-
Options	Text File	File path	`FILE`	-	-
	Field Separator	Choice	`SEPARATOR`	Field Separator	Available Choices: [0] tabulator [1] space [2] comma Default: 0
	Skip first line	Boolean	`SKIP_HEADER`	Skip first line as it contains column names.	Default: 0
	X is Column ...	Integer	`XFIELD`	The column holding the X-coordinate.	Minimum: 1 Default: 1
	Y is Column ...	Integer	`YFIELD`	The column holding the Y-coordinate.	Minimum: 1 Default: 2
	Z is Column ...	Integer	`ZFIELD`	The column holding the Z-coordinate.	Minimum: 1 Default: 3
	Fields	Text	`FIELDS`	The index (starting with 1) of the fields to import, separated by semicolon, e.g. "5;6;8"	-
	Field Names	Text	`FIELDNAMES`	The name to use for each field, separated by semicolon, e.g. "intensity;class;range"	-
	Field Types	Text	`FIELDTYPES`	The datatype to use for each field, separated by semicolon, e.g. "2;2;3;". The number equals the choice selection, see GUI version.	-
	Specifications	Parameters	`FIELDSPECS`	-	0 Parameters:
(*) optional

Command-line

Usage: saga_cmd io_shapes 16 [-POINTS <str>] [-FILE <str>] [-SEPARATOR <str>] [-SKIP_HEADER <str>] [-XFIELD <num>] [-YFIELD <num>] [-ZFIELD <num>] [-FIELDS <str>] [-FIELDNAMES <str>] [-FIELDTYPES <str>]
  -POINTS:<str>     	Point Cloud
	Data Object (optional output)
  -FILE:<str>       	Text File
	File path
  -SEPARATOR:<str>  	Field Separator
	Choice
	Available Choices:
	[0] tabulator
	[1] space
	[2] comma
	Default: 0
  -SKIP_HEADER:<str>	Skip first line
	Boolean
	Default: 0
  -XFIELD:<num>     	X is Column ...
	Integer
	Minimum: 1
	Default: 1
  -YFIELD:<num>     	Y is Column ...
	Integer
	Minimum: 1
	Default: 2
  -ZFIELD:<num>     	Z is Column ...
	Integer
	Minimum: 1
	Default: 3
  -FIELDS:<str>     	Fields
	Text
  -FIELDNAMES:<str> 	Field Names
	Text
  -FIELDTYPES:<str> 	Field Types
	Text