2.184. Softree ASCII Traverse Files

Softree ASCII Traverse Files

Overview

Options exist in the SURVEY/MAP module to read and write traverses in SOFTREE - ASCII format. This format allows traverse information to be read into other software packages such as spreadsheets or data bases.

The file extension of the SOFTREE ASCII file should be set to ".ASC".

The SOFTREE - ASCII file consists of a series of comma delimited fields. Each record corresponds to a station and ends with a Carriage Return (CR) Line Feed (LF).

When the file is read, the first record is used to determine the version number. The version number should occupy the first 5 bytes of the first record and should contain the version number e.g. "V3". Older versions in e.g. 2.8 are supported. These versions are not described here. Also, when the file is output the first record contains the column headings.

Some fields are optional and can be omitted but a comma delimiter must still be included. The following fields are included in each record.

C/L Fields

STATION The cumulative horizontal distance. This field is optional, it is only used to determine the start station. All stations after the first station are calculated from the horizontal distance field.

FORESHOT AZIMUTH

The foreshot azimuth in decimal degrees measured from north in the range (0-360)

BACKSHOT AZIMUTH (optional). The backshot azimuth in decimal degrees measured from north in the range (0-360). This angle should be adjusted to match the sign and angular orientation of the previous foreshot azimuth.

HORIZONTAL DISTANCE (HD) (not required if SD included)

Horizontal distance corresponding to the foreshot.

-Set TYPE to 0 if HD is used (see TYPE field).

SLOPE DISTANCE (SD) (not required if HD included)

Slope distance corresponding to the foreshot.

-Set TYPE to 16 if SD is used (see TYPE field).

SLOPE PERCENT

Slope percent.

LABEL 1 (optional)

'At station' label

LABEL 2 (optional)

'Between station' label. No longer used this field is included for backward compatibility.

X (optional)

X coordinate not used on import unless the point is absolute.

Y (optional)

Y coordinate not used on import unless the point is absolute.

Z (optional)

Z coordinate not used on import unless the point is absolute.

TYPE (optional)

Type flag

set to 0

add 3 if station is XY absolute.

add 4 if station is Z absolute.

add 8 if shot is an IFS.

add 16 if SD is used.

add 64 if shot is a deflection angle as opposed to an absolute bearing.

add 128 if elevation difference entered instead of a % slope.

add 512 if shot is a radial side shot.

CREEK (optional)

Creek information consists of 6 subfields separated by a

lower case 'x' character. Creek information is in the form

{sizeY}x{sizeX}x{Gradient}x{Az}x{Flag}x{SD}x

where

{sizeY} = diameter of pipe or height for box in 1/1000's of project units (e.g. mm)

{sizeX} = width of box in 1/1000's of project units (e.g. mm). Left empty if pipe. {Gradient}= downstream gradient in slope %.

{Az} = downstream azimuth in decimal degrees.

{Flag} = culvert orientation (gradient and direction) information

- 0 gradient and direction are explicitly set

- 1 if downstream is perpendicular right to the p-line.

- 3 if downstream is perpendicular left to the p-line

- 5 if downstream is automatically determined from side shots.

{SD} = slope distance used to measure gradient if the slope entry mode is elevation difference otherwise this field is ignored.

REFERENCE SHOT AZIMUTH (optional)

The foreshot azimuth of a single reference shot in decimal degrees measured from north in the range (0-360). This field is ignored for import (it is redundant with the RS field and retained only for backward compatibility with previous versions).

REFERENCE SHOT HORIZONTAL DISTANCE (optional)

The horizontal distance to a single shot reference. This field is ignored for import(it is redundant with the RS field and retained only for backward compatibility with previous versions)

GROUND TYPE LAYER 1 (optional)

2 Character ground type identifier for top layer.

CENTER LINE DEPTH LAYER 1 (optional)

Centerline depth for layer 1.

GROUND TYPE LAYER 2 (optional)

2 Character ground type identifier for 2nd layer.

CENTER LINE DEPTH LAYER2 (optional)

Centerline depth for layer 2

GROUND TYPE LAYER 3 (optional)

2 Character ground type identifier for 3rd layer

HEIGHT OF INSTRUMENT(optional)

Height of instrument in project units

HEIGHT OF TARGET(optional)

Height of target in project units.

Perpendicular SIDE SHOTS LEFT(optional)

These records contain perpendicular side shots. See perpendicular SIDE SHOTS FIELDS for a description of these fields. NOTE the number of side shots must be the same for all records in the file and must be the same for right and left.

Perpendicular SIDE SHOTS RIGHT(optional)

TP FLAGS LEFT(optional)

This field indicates if a perpendicular side shot is a TP

(turning point). This flag is 0 if all side shots are TP's.

Add 2^(J-1). If side shot J isn't a turning point.TP FLAGS RIGHT

(optional)This field indicates if a perpendicular side shot is a TP

(turning point). This flag is 0 if all side shots are TP's.

Add 2^(J-1) if side shot J isn't a turning point.

Perpendicular Side Shot Fields

SSL 1 SLOPE DISTANCE (optional)

SSL 1 SLOPE PERCENT1 (optional)

SSL 1 DEPTH LAYER 1 (optional)

SSL 1 DEPTH LAYER 2 (optional)

...................

..................

SSL n SLOPE DISTANCE (optional)

SSL n SLOPE PERCENT1 (optional)

SSL n DEPTH LAYER 1 (optional)

SSL n DEPTH LAYER 2 (optional)

For each side the following fields are included -Slope Distance -Slope Percent - Depth of Layer 1 - Depth of Layer 2

NOTES:

1) each side shot must have a non zero slope distance entry except the last which must be 0.

2) A maximum of 25 side shots

3) Each side shot can be an intermediate shot or a turning point determined by the TP Flag

4) Side shots are assumed to be perpendicular to the traverse centerline.NOTE: Previous File Versions (prior to Version 3) are supported for file import operations. The Survey/Map module will read SOFTREE ASCII files created in Version 2 and Version 2.1. For more information on these formats consult your Version 2 documentation.

SOFTREE ASCII File Examples

Example 1. Simple Boundary Traverse without Side Shots

V2.900 CB# T33

0.0, 358.3, ,137.6, ,8.9, label A1

137.6, 270.0, ,86.0, ,8.9

223.6, 335.0, ,33.1, ,10.2

256.7, 240.4, ,93.2, ,7.2

349.8, 184.6, ,174.6, ,5.2

524.5, 184.6, ,174.6, ,4.6

669.1, 184.6, ,174.6, ,7.2

873.7, 133.7, ,123.1, ,8.4

996.8, 80.7, ,61.8, ,5.7

1058.6, 30.5, ,106.2, ,10.7

Example 2. Road Survey With Side Shots

V2.900 Main# T23

0.000,259.000,,16.000,16.051,8.000,[G] Start,,670.169,183.391,240.500,7,,,,HP,,,,,0.000,0.000,

-1.000,-5.000,,,-1.000,5.000,,,0,0

16.000,224.000,,18.000,18.090,10.000,,,654.462,180.338,241.780,0,,20.000,100.000,HP,,,,,0.000,

0.000,-1.000,-5.000,,,-1.000,5.000,,,0,0

34.000,204.000,,50.000,50.202,9.000,,,641.959,167.390,243.580,0,,,,HP,,,,,0.000,0.000,-1.000,

-10.000,,,-1.000,10.000,,,0,0

84.000,238.000,,34.000,34.002,-1.000,,,621.622,121.713,248.080,0,,,,HP,,,,,0.000,0.000,

-1.000,-10.000,,,-1.000,20.000,,,0,0

118.000,,,,,,,,592.788,103.696,247.740,0,1000.000x x22.500x x7x10.000x,,,HP,,,,,0.000,0.000,

-1.000,-20.000,,,-1.000,25.000,,,0,0