Please enable JavaScript to view this site.

TerraScan User Guide

Navigation: Batch Processing Reference > Macros > Macro actions

Output by line

Scroll Prev Top Next More

Output by line

Not Lite

Output by line action can be used to write points into output files per line number. You would typically use this to produce final output files for delivering each line in a separate file.

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

macro_output_by_line

SETTING

EFFECT

Lines

Points of the given line(s) are included in the output file(s). Use a comma or minus to separate several line numbers, for example 2-5,10. 1-65535 refers to all lines and creates one output file for each line.

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.

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 individual output files for several lines, the file name must include the #line variable. 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, -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