Vr Mapping




VrTwo Orientation - Batch Import of ISAT Measurements

VrTwo Orientation Tutorial Batch Import Measurement Method (vr2ori.exe)



Section 1 Project Setup

Section 2 Importing Orientations

Section 3 Verifying Orientations

Section 4 Opening Models in VrTwo


VrTwo Orientation is used to create stereo image pairs (or models) for viewing in VrTwo and VrLite. Stereo models may be generated manually or by importing the results from various aerial triangulation programs. Orientations may be performed on a single model or multiple models may be oriented in a batch mode. The importing of models from aerial triangulation may be performed from the exterior orientations or from the measurements used to tie images and strips together. This tutorial will address Importing Orientations for multiple models using the ISAT measurement photo file.

Section 1 Project Setup

Creating or Editing the Camera File

New Camera (NewCam)

Allows the user to create and edit a new camera calibration file. Prompts user for the new camera's file name. Camera files in Vr Mapping have the .cam file name extension. See Edit Camera below for information on editing a camera file. If a preexisting camera file exists, this feature may not be needed.

Creating the Camera File

From the "Camera" dropdown menu, click on either "New Camera" or "Edit Camera".


The Edit Camera dialog box

Creating or Editing a Control File

If one does not already exist, create a new coordinate file. From the "Coordinates" dropdown menu, click on "New Coordinate File". Please see VrTwo Orientation New Coordinate File for more information.



The Edit Control dialog box


If a control file exists and contains the PointName X Y Z fields, it can be used directly by Vr Mapping programs. Simply rename the file by replacing the file postfix with .cor. For example, if there were a coordinate file named TheCoords.txt which contained the PointName XYZ fields, it could be renamed TheCoords.cor and be used by VrTwo Orientation.


The following is an example of a contents of a coordinate file compatible with Vr Mapping:


201   837831.194130   951352.037020   303.8200

202   836399.079330   951266.642540   337.6800

203   837994.618340   950634.951710   299.6000

204   836711.670600   950565.198920   326.3200

205   836018.411470   950724.804370   309.2900


The first field is the point name followed by the X, Y and Z coordinates.

Creating or Editing the Project

The following steps create the project:


1.Create a New Project File -  From the "Project" dropdown window, click on either "New Project" or "Edit Project".
2.Add Coordinate File - Click the button to the right of the “Coordinates” box to add the coordinate file name.

The Edit Project dialog box prior with no parameters defined


3. Define Images - Click the "Define Images" button in the "Edit Project" dialog box. The "Edit Project - Define Images" dialog box allows the definition of multiple image files. Each image file has a Photo Name Format, which are parameters that define the strip and photo number from an image file name. Strip direction, pixel size and the "Open in Layout" flag may also be defined for each image. The top portion of the dialog box is a template of these parameters. This template may be copied to an image or a group of images by selecting the desired file(s) then pressing the "Apply" button.



The Edit Project - Define Images dialog box


The following are descriptions of the parameters in the "Edit Project - Define Images" dialog box:

Project Camera

Project cameras (.cam) are assigned to individual images. Up to 10 camera files may be defined.

Film Strip Location

Defines the direction flight. For more information please see VrTwo Orientation - Film Strip Direction.

Photo Pixel Size

The photo pixel size is in the same fiducial units (millimeters, inches, or pixels) defined by the Camera file. If this value is unknown, it can be computed after reading three points in Inner Orientation at the bottom left of the Interior Orientation window.

Add Photos

Adds images to the project.

Photo Name Format

Sets the parameters that define the strip and photo number from an image file name. For more Information please see VrTwo Orientation - Photo Name Format.


4. Create Model Names

Click "Add Model" to create a new model. Pressing this button allows a single model to be added to the list of models. After the model is added, the left and right images must be selected and the epipolar re-sampling image parameters must be set.

The Add Model dialog box


The Edit Project dialog box showing Model 1002-1001


Please see VrTwo Orientation - Project for more information.

Section 2 Importing Orientations


Importing Measurement Orientations Batch

1.Select "Measurement Orientation Batch" from the "Import" dropdown menu.
2.Select the ISAT Photo File. Set the "Measurement orientation file format" to "ISAT (photo)"
3.Set  "Create Epipolar Images and pyramids?" to "No".




4.Select Strip Number Location - Specifies whether the strip number is embedded with the photo name. Review the ISAT photo file to see if the strip number is embedded with the photo number. In the example below, the strip number is part of the photo name. For more information, please see the ISAT photo File format.


begin photo_measurements 01-02        strip_id 01        version 2.0

 21370307        -12.313744        -61.250663        -12.312909        -61.246508        1 85

 21370297        -3.3020941        -68.078501        -3.3018724        -68.073928        1 85

 21370317        -5.2376813        -75.449179        -5.2373545        -75.44447        1 85

 21370322        -14.481854        -68.898072        -14.480887        -68.89347        1 85

 21370344        -0.68857854        -82.631939        -0.68853523        -82.626727        1 85




5.Set Strip Photo Separator - Defines the file format of the image names and determines how the strip and photo number are parsed by VrTwo Orientation.

For more information, please see Photo Name Format.



The Photo Name Format definition dialog box


6.Select models to orient then press "OK" to start the import process.




7.Review Import Results and Total RMS Values for Absolute and Relative Orientations. The Total RMS values should be reviewed to verify that the import was successful. When finished, click "OK" to continue.




8.Select "Create epipolar images batch" from the "Import" dropdown menu.




9. Click the OK button, then take a break while the epipolar images are being built.


10. Click the OK button again when the epipolar batch process is finished.




Section 3 Verifying Orientations (Optional)

1.Since measurements were imported, Relative and Absolute orientations may be viewed. This can be used to verify the locations of the control, pass, and tie points in the Stereo Model and visually inspect known ground control points for offset. To begin, select "Absolute orientation" from the "Orientation" dropdown menu.
2.Click the first point in the results main window. To toggle roaming, press the Keyboard Insert button.
3.To advance to the next point in orientation, press "Next point" (button 5). All visually identifiable ground control points can be verified using this method.



The VrTwo Orientation Absolute Orientation environment

Section 4 Opening Model in VrTwo

1. Start VrTwo from the Vr Mapping folder on the desktop by double clicking on the VrTwo icon.

2. Click on File -> Open Model or use the Open Model (OpeMod) command. Navigate to the location of the project folder by double clicking in the far left hand box.

3. Double click on the VrTwo Model (.vmo) file and press OK.



The Open Model dialog box


4. VrTwo will now generate pyramids for the epipolar images if they do not already exist.

5. Open a VrOne File by clicking on File -> Open Vr File or by using the Open VrOne File (OpeVr) command. Navigate to the project folder by double clicking in the far left hand box.

6. Double click on the VrOne (.vr) file.

The stereo model should open and the stereo model and vectors should be seen on the screen. If the stereo window does not show a stereo image and vectors try using the Drive Control (Cd) command. Typing "Cd 1" will drive to the first control point in the model. For more information please see the Getting started with VrOne/VrTwo tutorial which covers basics of data collection and editing.



The VrTwo graphics window showing the stereo model (Anaglyph)