Imports an ASCII file containing points, clouds, vectors, frames, or planes into the current job based on a predefined format.
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. |
None
SUCCESS |
The file was successfully imported. |
FAILURE |
The source file could not be found. |
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.