Vr Mapping |
ON-LINE REFERENCE DOCUMENTATION CARDINAL SYSTEMS, LLC |
VrTwo Orientation - Batch Import of ISAT Measurements
VrTwo Orientation Tutorial Batch Import Measurement Method (vr2ori.exe)
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.
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)