Import ASCII: Predefined Formats

Imports an ASCII file containing points, clouds, vectors, frames, or planes into the current job based on a predefined format.

 

Input Arguments

 

0

File Path or Embedded File

ASCII File Path

The path to the ASCII file to import.

1

File Format

File Format

The format of the source ASCII file.

2

Units

Units

The units of the source ASCII file.

3

Angular Units

Angular Units

The angular units of the source ASCII file.

4

Collection Object Name

Group Name

The collection and group in which to place im- ported points.

5

Boolean

Import As Cloud

TRUE to import points as a point cloud. FALSE to

import as points.

Return Arguments

None

 

Returned Status

 

SUCCESS

The file was successfully imported.

FAILURE

The source file could not be found.

Remarks

The Collection Object Name specified (Arg.4) is used differently depending on the file format being imported (Arg. 1). A format that specifies collection and group will ignore this name entirely, while a format that includes a group name but not collection name will use the specified group name from the file and place it in the collection specified in Arg 4. This is true unless a format including uncertainty is imported which would also add an instrument, in which case, both the instrument and data are imported into the working collection.

This command supports both absolute paths (ex. C:\test.xit) and relative paths (ex. .\test.xit). If a relative path is provided and the MP is embedded, the path will be relative to the current SA file location.

Note that this command will not fail if the specified file did not match the prescribed format. In that case, data will not be imported. Upon import, values will be converted from the source units of the file (Argument 2) to the units of the current SA file. When a format contains a group name, it will override the group name provided in the arguments.