Create XYZ Template

Use the Import <XYZ File> template editing tool to specify the parameters of the channels to be imported from the XYZ data file into an Oasis database and to create an import template file (*.i0).

Import <XYZ File> dialog options

Template name

The import template file. The file is created in the local project directory using the extension "i0" and the template name specified in the parent dialog.

Display window

Field #

The index of the fields in the input file. The indices increase sequentially from left to right.

Example

The Example column displays an example of the data found in the imported file.

Output channel

The name of the output channel. If a label line is located in the input file, the labels are extracted and displayed. Otherwise, the channels are set by default to X,Y, Z1, Z2 etc.

These entries can be edited in the Output group box.

Source Data

Field #

The index of the highlighted channel. The parameters of this channel are displayed in the Output group box and can be edited.

Array size

The number of elements in the highlighted channel. Entering 1 will create the highlighted channel as a value-based channel. Entering a value >1 will create the highlighted channel as an array.

Storage direction

If you have chosen an array size >1 above, then you must indicate if the array is to be read along Rows, or down Columns.

Select the storage direction Row, to read in the next Array size elements along the row as consecutive elements of the current array channel. You will specify the name of the array channel under Output.

Select the Storage direction Column, to read in the next Array size elements down the column as consecutive elements of the array channel. You will specify the name of the array channel under Output.

In the case of columnar arrays, the import will search down the first (leftmost column) value-based channel until the value changes to determine the number of elements in the array.

  • It is very important that the first value-based field in the input file repeats Array size times and changes value at multiples of the Array size.

    • If the Array size specified is smaller than the increment at which the first fields value changes, the remaining data of the array will be ignored .

    If the Array size specified is larger than this dimension, the remaining data of the array will be set to dummies.

    Example

    Shown as an example, the first value in the Field # column.

    Format

    The input format for the highlighted channel. To change the default option ("Normal"), select from one of the available formats in the list.

    For a detailed description of formats, refer to the Importing Data, Grids, Images and Graphics Files section.

    Dummy

    Define the value indicating the dummy in the source file.

    Output

    Name

    The name of the channel in which the data will be placed – assigned to the currently highlighted field on output. You can select a different name from the drop-down list or type a new name in the box.

    See Application Notes below for more details on channels.

    Type

    Select the data type of the highlighted output channel.

    Size

    		 For data of type string, specify the number of characters in the string.

    Dec.

    The number of decimals this channel is displayed with in the Oasis database.

    Width

    The width of the channel in the Oasis database.

    Unit

    		 Select the appropriate unit from the Unit drop-down list. This is optional.

    Application Notes

    The default channel names may be determined from the last comment header found in the file (i.e. with the same number of labels as columns), or can simply be "X", "Y", "Z1", "Z2", etc.

    Channel names must start with a letter or an underscore character ‘_’, and may not contain any spaces. If the channel name is enclosed in square brackets, this indicates that the channel does not already exist in the database and will be created automatically during import.

    The special channel name "Fiducial" can be used to indicate that an import column contains fiducial numbers. If a fiducial channel is used, the increment is set to the smallest common interval found in the specified column for each survey line (i.e. independently for each line).

    If a fiducial column is not identified, the default fiducial start of each line is 0, and the default fiducial increment is 1.0. The "Merge" import mode will use the defined fiducial column to merge imported data with existing data in the database.

    See Also: