Vr Mapping

ON-LINE REFERENCE DOCUMENTATION

CARDINAL SYSTEMS, LLC

www.cardinalsystems.net

Survey Points Out (SurOut)

Type: Translator

 

Translates VrOne lines and symbols into Survey Points Format.

The Survey Points Format consists of lines and points in comma delimited ASCII file.

 

Load Parameters

Record Parameters

Parameters

Translate

Help

Quit

 

SurveyPointsOut01

The Survey Points Out button box.

Load Parameters

Loads previously recorded Survey Points Out (.spo) parameter file.

Record Parameters

Records current translation parameters to a Survey Points Out (.spo) parameter file.

Parameters

Allows editing of the translation parameters.

 

SurveyPointsOut02

The Edit Parameters dialog box

Workspaces to consider

Defines the workspaces to consider when exporting Survey Points files.  Options are "Current only" and "All open".

Layers to consider

Defines the layers in the VrOne file(s) to translate.  A Number Line may be used to define these layers.

Output mode

Determines handling of output files during translation.

Single File - All open workspaces are translated into a single Survey Points file.  The "Output file name" field determines the output file name.  The "Output directory" field may be used to place the output file in a different folder than the VrOne file.
One File Per Workspace - A Survey Points file is created for each open workspace. The output filename is the same as the workspace (VrOne) filename with an .spf extension.  The "Output directory" field may be used to place the output files in a different folder than the VrOne files.

Output file name

Defines the output file name when "Output mode" is set to "Single File".  This name is ignored if "Output mode" is set to "One file per workspace".

Output folder

Defines the folder name to place the output file(s). This field may be left blank to place the output files in same the directory as the VrOne files.

Decimal accuracy for xyz

Defines the number of decimal places for the x, y and z coordinates in the output file(s).

Code to indicate the start of a line (16char)

The start of a line in the output files is defined by this code.  The default code is '+'.

Code to indicate the end of a line (16char)

The end of a line in the output files is defined by this code.  The default code is '-'.

Start sequence number for output records

Each point or record in the output files much contain a unique number.  This parameter defines the start sequence number for the output records.  If multiple files are being translated, the number will be sequenced between output files.

Feature code source

The cross referencing between VrOne Layers and Survey Points Format Feature Code is accomplished by using the Vr Function Keys.  One of two methods may be used when searching for a point's Feature Code.

Line layer - When the translator needs a Feature Code, the Function Keys are searched for the VrOne layer.  When the layer number is found, the Function Key name is used as the Survey Points Feature Code.  The Function Key Description is also used as the Survey Points Description or Comment.
Line point's M flag - The layer number in the line point's M Flag is used to search Function Keys. The Function Key's Feature Code is used as the survey point feature code.  The setting of the layer number in a Vr Line point's M Flag is done by another application such as the batch application Drape.

Translate

Begins the file translation process.

Help

Starts the browser and displays the current help document.

Quit

Quits Survey Points Out and allows current parameters to be saved if they were altered.

Survey Points Format

The Survey Points Format consists of lines and points in comma delimited ASCII file.  Each record has a unique sequence number, a coordinate position, a feature code, a control code and an optional description.

 

Following is an example of the Survey Points Format:

 

5000,553318.7073,1857992.2046,623.8169,BL+/CL

5001,553327.2930,1857901.5110,624.9915,BL

5002,553336.4310,1857813.4315,625.2355,BL

5003,553342.8827,1857744.9807,624.0503,BL-

5004,553498.2773,1857906.8409,621.6160,FN

5005,553436.2169,1857979.3360,645.5678,XLP2

5006,553500.5725,1857929.4577,637.6788,XLP2

5007,553504.7982,1857886.2872,640.6937,XLP2

5008,553511.2007,1857834.5915,643.5109,XLP2

5009,553400.0948,1857886.2190,630.4220,BC

 

Field

Example

Description

1

5000

Sequence number

2

553318.7073

X coordinate

3

1857992.2046

Y coordinate

4

623.8169

Z coordinate

5

BL

Feature code

6

+

Control code (see below)

7

/CL

Description or comment

 

Feature Codes

The cross referencing between VrOne Layers and Survey Points Format Feature Code is accomplished by using the Vr Function Keys.  One of two methods may be used when searching for a point's Feature Code.

Feature Code Source - Line layer - When the translator needs a Feature Code, the Function Keys are searched for the VrOne layer.  When the layer number is found, the Function Key name is used as the Survey Points Feature Code.  The Function Key Description is also used as the Survey Points Description or Comment.
Feature Code Source - Line point's M flag - The layer number in the line point's M Flag is used to search Function Keys. The Function Key's Feature Code is used as the survey point feature code.  The setting of the layer number in a Vr Line point's M Flag is done by another application such as the batch application Drape.

 

Control Codes

Currently the only control codes that are used are the + (plus) character to indicate the beginning of a line and the - (minus) character to indicate the end of a line.