Please enable JavaScript to view this site.

TerraScan User Guide

Navigation: Batch Processing Reference > Macros > Macro actions

Output points

Scroll Prev Top Next More

Output points

Not Lite

Output points action can be used to write points into a new file. A typical example is a macro that:

1. classifies model keypoints.

2. writes only model keypoints into one output file for all block binary files.

3. does not effect the original block binary files in any way.

The action can also be used to write points block-wise into new files that may have a different format than the original block binary files, for example for delivery purposes.

The output file format can be any of the Supported file formats implemented in TerraScan or a user-defined point file format.

macro_output_points

SETTING

EFFECT

Points

Points for output: All points which would include neighbour points or Active block.

Class

Point class(es) that are included in the output file(s).

_select_classes

Opens the Select classes dialog which contains the list of active classes in TerraScan. You can select multiple source classes from the list that are then used in the Class field.

Transform

Transformation applied to the points before an output file is written. The list contains all transformation defined in the Coordinate transformations / Transformations category of TerraScan Settings.

Inside fence only

If on, only points inside a fence or selected polygon(s) are included in the output file(s).

To file

Storage location and name of the output file. If it does not include a directory, the project directory is used. If there should be one output file for each block binary file, the file name must include a variable, such as the block name. Add the extension of the output file manually at the end of the file name according to the selected output Format.

Variable

Opens the Macro variable dialog which contains the list of variables. Select the variable that you want to use as part of the output file name.

Format

Format of the output file(s).

Delimiter

Character that separates different fields in an implemented text file format: Space, Tabulator, or Comma. This is only active if Format is set to a text file format that does not explicitly define the delimiter itself.

Xyz decimals

Number of decimals stored for coordinate values. This is only active if Format is set to any text file format.

Append if file exists

If on, input files are written into one output file if the file name is the same. If the output file name does not contain a variable, all input files are written into a single output file.

If off, input files are written into individual output file(s), if the file name contains a variable. If no variable is used that makes an output file name unique, the process might overwrite existing files of the same name.

Return value: Number of points that were written into the output file, -1 if the process failed due to a missing fence, -2 if the output file(s) could not be written into the given directory, -3 if the process failed due to invalid parameters, -4 if the process failed due to a missing transformation.

TerraScan User Guide   01.01.2024   © 2024 Terrasolid Ltd