Output Points Macro Step

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 affect the original block binary files in any way.

The action can also be used to write points blockwise 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 neighbor 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 Coordinate transformation to apply when computing output coordinates for a point.
Inside fence only If on, only points inside fence or selected polygon 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

Add a variable to the output file name:

#bnumber – block number.

#block – block name or block binary file name without extension.

#bpath – path of the block binary file. This includes the binary file name and its extension.

#bemin – minimum easting value of block boundary vertices.

#bnmin – minimum northing value of block boundary vertices.

#bemax – maximum easting value of block boundary vertices.

#bnmax – maximum northing value of block boundary vertices.

#pdir – path of the storage directory of the block binary file. This does not include the name of the binary file.

#name – active file name. Use this to replace the file name component when running a macro on selected files.

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 output 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 output 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:

Return Number Meaning
+ve number Number of points that were written into the output file
-1 The process failed due to a missing fence
-2 The output file(s) could not be written into the given directory
-3 The process failed due to invalid parameters
-4 The process failed due to a missing transformation

 

Share

GeoCue Group Support

GeoCue Group Support has written 717 articles

Leave a Reply