Transform Vr Files

Vr Mapping

ON-LINE REFERENCE DOCUMENTATION

CARDINAL SYSTEMS, LLC

www.cardinalsystems.net

Transform Vr Files (TraVr)

Type: Batch application

Transforms Vr files (workspaces) from one coordinate system to another

Detailed Description

The coordinate transformation from one coordinate system to another is based on two coordinate files. A coordinate file typically contains control points that are used to control functions such as model orientations. The two coordinate files contain common points that represent the current, or "from" coordinate system and the new, or "to" coordinate system. The coordinate transformation may be 2D or 3D. Following is an example from a "from" coordinate file and a "to" coordinate file.

"From" coordinates

1 634884.088000 1759508.376000 38.374000

2 637131.300000 1760536.069000 28.405000

3 636749.827000 1762981.944000 57.051000

4 634350.036000 1761869.624000 29.464000

"To" coordinates

1 634984.088000 1759608.376000 38.374000

2 637231.300000 1760636.069000 28.405000

3 636849.827000 1763081.944000 57.051000

4 634450.036000 1761969.624000 29.464000

Once the computations are complete between the two coordinate systems, the results are applied to one or more open Workspaces (VrOne files) in VrOne. The results of the computations are displayed when complete. An option to run a test computation without applying the results to the open Vr file(s) is available.

Available Key-ins

Key-in	Description	Range
WSTC	Workspaces to consider	0=Current 1=All open
FROM	From coordinate file name
TO	To coordinate file name
TRATYP	Translation type	2=2D 3=3D
REPORT	Results report file name
RUN	Compute and apply transformation
RUNTEST	Compute transformation only
PARFIL	Loads a parameter file
HELP	Displays this help page

Parameters for Transform Vr Files

On starting Transform Vr Files, a dialog is displayed in which the parameters are defined.

transformVr01

The Transform Vr Files dialog

Workspaces to consider

Defines the workspaces to consider.

From control file

Defines the "from" control (coordinate) file name. This file contains points that are in the current coordinate system.

To control file

Defines the "to" control (coordinate) file name. This file contains common points that are in the new coordinate system.

Translation type

The transformation of the coordinate may be performed in 2D or 3D. If 3D is used then the Z coordinates need to be in the "from" and "to" files

Report file name

The results of the transformation will be displayed in a dialog box and also written to a file specified here.

Load parameters

Loads an existing parameter (.tvf) file. When the Vr Transform Files application starts, the last parameter file is re-loaded.

Record parameters

Records the current parameters to user defined (.tvf) file.

Reset parameters

Resets the current parameters to initial values.

Test run

Performs the transformation between the "from" and "to" files, displays the results, and writes the Report file. However the Vr files are not modified. This button is used for testing and quality control before modifying the Vr files.

Run and transform

Performs the transformation between the "from" and "to" files, displays the results, and writes the Report file. The Vr files are then modified based on the transformation after a verification dialog is accepted.

Help

Displays this help page.

Prompts for the recording of the current parameters to a .tvf file and exits Transform Vr Files.

Results Dialog

The "Test Run" and "Run and transform" buttons perform the transformation math between the "from" and "to" files, if possible. The results are displayed in an information dialog. Following is an example of the results dialog.

transformVr02

The Results dialog

Document updated: April 2022