Leica XPro 6.2 Manual
Leica XPro 6.2 Manual
Leica XPro 6.2 Manual
User Manual
Leica Geosystems AG
9435 Heerbrugg, Switzerland
Document Code: 769340
This document shall not be reproduced in whole or in part without prior permission in writing from Leica Geosystems AG, 9435 Heerbrugg
(Switzerland), either by mechanical, photographic, electronic, or other means (including conversion into or transmission in machine-readable form);
stored in any retrieval system; used for any purpose other than that/ those for which it is intended; nor accessible or communicated in any form to
any third party not expressly authorized by Leica Geosystems AG to have access thereto
Trademarks
International Warranty
The International Warranty can be downloaded from the Leica Geosystems home page at http://www.leica-geosystems.com/international warranty
or received from your Leica Geosystems dealer.
This product contains software that is pre-installed on the product, or that is supplied to you on a data carrier medium, or that can be downloaded
by you online pursuant to prior authorization from Leica Geosystems. Such software is protected by copyright and other laws and its use is defined
and regulated by the Leica Geosystems Software License Agreement, which covers aspects such as, but not limited to, Scope of the License,
Warranty, Intellectual Property Rights, Limitation of Liability, Exclusion of other Assurances, Governing Law and Place of Jurisdiction. Please
make sure, that at any time you fully comply with the terms and conditions of the Leica Geosystems Software License Agreement.
Such agreement is provided together with all products and can also be found at the Leica Geosystems home page at http://www.leica-
geosystems.com/swlicense or your Leica Geosystems dealer.
You must not install or use the software unless you have read and accepted the terms and conditions of the Leica Geosystems Software License
Agreement. Installation or use of the software or any part thereof, is deemed to be an acceptance of all the terms and conditions of such license
agreement. If you do not agree to all or some of the terms of such license agreement, you may not download, install or use the software and you
must return the unused software together with its accompanying documentation and the purchase receipt to the dealer from whom you purchased
the product within ten (10) days of purchase to obtain a full refund of the purchase price.
Table of Contents
Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii
Chapter 1
Leica XPro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Chapter 2
Installation and Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Configure XPro Initialization file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Security Options in Windows 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Set virtual memory paging file size larger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
License setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
License tool installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Using Node Locked licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Using Floating licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Offline License Transfer Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Application setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
License update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Re-hosting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Necessary for MM80 connection - for ADS80 data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Necessary for MM30 connection - for ADS100 data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Starting Leica XPro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Chapter 3
Data Download for ADS80 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Preparation for download . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Data download . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Create / select Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Select data for download . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Start download . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Downloaded data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Disconnect MM80 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Chapter 4
Data Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Data Preparation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
ADS100 data on MM30 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Data Preparation Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
iii
Table of Contents
Chapter 5
QC Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
QC Viewer Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
QC Viewer Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
QC Viewer Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Selecting an image to view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Status Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Moving Around . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Image pyramids availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Toggle image bands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Toggle image zoom level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Viewing cross-eyed stereo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Histograms View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Drawing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Overlay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Image Adjustment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Orientation Plot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Chapter 6
Measurement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Measurement Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Measurement Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Core functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Input Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Output Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Automatic Point Matching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
APM Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Measurement Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Select Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Select Image Bands to measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Load Ground Control Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Measure Ground Control Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Generate tie points using APM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
iv Leica XPro
Chapter 7
Block Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Block Preparation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Block Preparation Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Create New Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Set Coordinate System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Add Takes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Add GPro triangulated Takes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Add DSM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Add Reference Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Add Ground Control Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Save Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Export to Shapefile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Supported Coordinate Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Data Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Example Block File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
ASCII geoid file format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Chapter 8
Aerial Triangulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Triangulation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Triangulation flow in brief . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Input Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Output Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Triangulation Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Open Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Run APM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Import Ground Control Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Measurement in Triangulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Create New Adjustment Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Edit Ground Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Set Parameters for Bundle Adjustment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Run Adjustment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Validate Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Further Improvement of Quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Write Out Adjusted Orientation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Self-calibration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Export Adjusted Ground Points . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Block Check tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Chapter 9
Product Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Product Generation Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Input data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Output data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Product Generation Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Select Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Open AOI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Processor Manual v
Table of Contents
Chapter 10
Appendix A - Automated Point Matching File Description . . . . . . . . . . . . . . . 165
APM File Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
APM Settings File Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Chapter 11
Appendix B - HTC Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
HTCondor installation instructions on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
IT infrastructure testing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Installation for Master- and Submitter Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Installation option B for Master Node installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Installation option B for Submitter Node installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
Installation on the Worker nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
Full Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Specify Local License Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Potential issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
vi Leica XPro
Chapter 1
Leica XPro
Introduction Leica XPro is a software package performing the ADS ground processing workflow from data
download to image generation and dense DSM extraction.
Headquarter
Internet http://www.leica-geosystems.com
Contact Leica Geosystems AG e-mail:
Business Unit Digital Imaging [email protected]
Heinrich-Wild-Strasse Phone: + 41 71 727 3131
9435 Heerbrugg Fax: + 41 71 727 4674
Switzerland
User Manual 1
Leica XPro
2 Leica XPro
Chapter 2
System Leica XPro is software that runs under the Microsoft Windows family of operating systems.
Requirements Requirements for an optimal processing workstation are the following:
12 GB or more RAM for using XPro DSM; (4 GB or more RAM for other applications).
3 TB or more free disk space for data processing. Disk space for data processing depends
largely on the characteristics of production work and back up cycles used. It is
recommended to have 20 TB or more available. One full day flight data with products may
require about 3 TB.
Graphics card - NVIDIA GeForce 9600/ 9800 or Nvidia GeForce 285/ 295 (basically any
current with at least 512 MB RAM; RAM speed is important - DDR 3 or better; OpenGL
version 2.0 or greater is required).
ADS80 - MM80 data download workstation has to have the following for mounting the
adapter card:
ADS100 - MM30 data download workstation has to have the following for mounting the
adapter card:
Installation It is recommended to uninstall the previous version of the software before installing the new
version.
To install Leica XPro, double-click the setup.exe file on the software CD. Follow the
instruction provided by the installation program.
User Manual 3
Installation and Configuration
The license server name used for XPro licenses is asked during the XPro installation. User can
change the name in the XPro Initialization file (xpro.ini) at later stage, if required.
Configure XPro XPro requires certain data locations to be defined in XPro initialization file after the software
Initialization file installation. Initialization file, xpro.ini, is provided with XPro installation, usually at location
C:\Program Files\Leica Geosystems\XPro\
The required settings in the initialization file are:
- location of sensor calibration files
- location of APM settings file
- location of global elevation file - GTopo or SRTM
- location of XPro license server
Examples of the location definitions are given below:
Sensor calibration
====
; default location for calibrations
[Calibrations]
location=C:/ADS/calibrations
Avoid spaces in the path of the location for calibration. In case the spaces are in the
calibration path then the .sup files for Products will not get the proper calibration
location.
[SRTM]
; location of the data directory for SRTM3
; there is no default location, please specify (or leave it empty)
;datapath = etc/dem/SRTM/SRTM3
4 Leica XPro
Installation
XPro uses global elevation files for footprint computation, for point measurement in
Triangulation and as option for ortho calculation in Product Generation. XPro
installation comes with GTopo global elevation file - GTopo is used by default. User has
option to comment out GTopo use in xpro.ini and to define the location of the SRTM files.
The DVD with SRTM3 files can be ordered from Leica Geosystems (the same SRTM3 files
can be used for flight planning in Leica MissionPro).
Security Options in In case experiencing issues with getting the processing logs populated into the Leica XPro
Windows 7 installation folder with Windows 7 OS, it might be required to change the Security Options.
It should help going to
Administrative Tools > Local Security Policy > Local Policies > Security Options
and setting
User Account Control: Virtualize file and registry write failure to Disabled.
Set virtual memory For systems lacking RAM for Leica XPro DSM Extraction step it is recommended to set the
paging file size larger paging file size value higher than the Windows OS default value is.
Paging can make data processing significantly slower though - thus adding RAM to the system
is the more preferred solution.
User Manual 5
Installation and Configuration
License setup
Introduction This part of user documentation describes office software licensing as implemented for all
airborne data post processing software from Leica Geosystems and Z/I Imaging.
For all products Leica Geosystems (LGS) FlexNet licensing is used.
Two license types are available:
Floating licenses
Licensing software
LGS FlexNet uses the following tools:
On the application machine:
The Client License Manager (CLM) Local Software (clm-admin.exe).
For installation see "License tool installation" on page 9.
The CLM Local Software is used:
To activate, update and re-host node locked licenses from the Leica Geosystems License
server. See "Using Node Locked licenses" on page 12, "License update" on page 25.
To display a list of all floating licenses which are activated on the local license server to check
what is available for checkout by an application or for borrowing.
To borrow floating licenses from the local license server and to return borrowed floating
licenses to the local license server
In the application:
A license configuration dialog.
This dialogue is used
To specify the license type (either node locked or floating)
6 Leica XPro
License setup
To enter the local license server name or address (In case of floating licenses)
In the case a product is only available with floating licenses the license configuration
dialogue in the application might be not available. In this case an executable is used to
specify on the application machine the name of the local license server.
Entitlement-ID
When ordering a software product, customer gets an entitlement certificate with an Entitlement-
ID.
The Entitlement-ID is the key to the license(s) of each product. The Entitlement ID must be
entered during the license activation at customer site.
License activation
For the license activation, users computer must be connected to the internet.
All issued licenses must be activated on the users computer. That means the users computer
must be connected online to the Leica Geosystems License Server [FlexNet Operations (FNO)
license server] through the internet when getting the license. The license information is stored
in a trusted storage on the computer. For node locked licenses this is the users computer. For a
floating license this is the users local license server.
For running a software product, there is no further connection to the Leica Geosystems License
Server required.
For customers who cannot establish an internet connection on the PC where the application
software shall be used (i.e. on the target PC) there is option to use Offline License Transfer
functionality.
The option to activate/return or update a license offline is offered via a second PC or via any
other device that must at least have e-mail connection to the internet (e.g. a smartphone).
Floating licenses
Floating licenses are used for sharing a license between different users within an organization.
The number of concurrent users is defined by the number of available licenses.
A float license is bound to a single machine running the local license server. Several float
licenses can be activated on the local license server. Float licenses can be re-hosted once per
year to move a license to another local license server machine.
The address of the local license server machine has to be entered in the software product
configuration on each machine where the software is installed. It is possible to install and
execute the software on the same machine where the local license server is running.
User Manual 7
Installation and Configuration
Maintenance concept
Software maintenance entitles a customer for a free of charge update of the software within a
given period. The Software maintenance can be ordered with duration of 1, 2, or more years.
Without Software maintenance a product includes free of charge update for a period of 30 days
after first entitlement activation.
An expired maintenance does not stop the usage of the product (it's not an expiring
license). An expired maintenance prevents only the use of newer software versions. The
software version is linked to a date.
Upgrades
The Entitlement number remains if a Software is upgraded to a newer version or if additional
modules to a Software are purchased. Leica Geosystems generates a new or subsequent item to
the existing Entitlement and place it on the Leica Geosystems License Server. The new or
subsequent item to the existing Entitlement needs to be activated by the user on his local
machine. Activation of this item is similar as activation of a new license.
Re-hosting
Depending on the license model, a license can be returned to the Leica Geosystems License
Server (FNO) and re-hosted to another machine.
Re-hosting, as extended licensing functionality, is available only for registered customers.
8 Leica XPro
License setup
Return to Leica Geosystems License Server (FNO) function should be used also for expired
evaluation licenses.
Details see "Re-hosting" on page 27.
Summary
License tool
installation
CLM software installation performs automatically temporary stop of license services and
removal of the old software versions. Using Windows Add or Remove Programs to
remove the previous versions of the licensing tools is not recommended.
Activated node locked license(s) can remain. It has not to be returned to the Leica
Geosystems license server before upgrading the licensing tools.
Installation DVD
To install the CLM Local software, follow these steps:
Insert the Product DVD.
The installation menu dialogue opens:
User Manual 9
Installation and Configuration
From the Z/I Software Packages Installer select License ... to open the License Installer sub-
menu
Installation procedure
1. Click CLM Local software and follow the instructions in the installation dialogue.
10 Leica XPro
License setup
Click I agree to if you agree to the terms and conditions set forth in the Leica Geosystems
Software License Agreement.
Click Cancel to exit the installation program if you do not agree to the terms and
conditions.
User Manual 11
Installation and Configuration
For how to activate the license see "Using Node Locked licenses" on page 12.
The Entitlement ID of the Z/I Imaging & Leica Geosystems Products license
Your computer has to be connected to the internet. In case internet connection cannot be
established for the computer then please use Offline License Transfer - see "Offline License
Transfer Process" on page 22.
1. Start the CLM Local software from Start Programs Leica Geosystems Client License
Manager License Administrator. Select Tab Node-locked Licenses. The following dialogue
opens:
12 Leica XPro
License setup
2. In case your Internet connection is via Proxy Server configure the Proxy Server settings.
User Manual 13
Installation and Configuration
Software connects to the Leica Geosystems License Server and lists the licenses which can be
activated.
14 Leica XPro
License setup
User Manual 15
Installation and Configuration
Using Floating
licenses
A floating entitlement can be valid for 1 to n licenses of a software product. If you own
more than one floating licenses for a product the licenses shall be combined in one single
Entitlement ID, because on a local license server only one Entitlement ID per software
product should be activated. If this is not the case, borrowing of licenses and check out of
licenses may fail.
Troubleshooting
If you have your floating licenses for a product not combined in a single Entitlement ID
then either:
or
If you have activated more than one floating license Entitlement per software product on
a local licenses server machine, you may have to restart the license server application on
your local license server machine, if borrowing or check out failed.
Environment
Local License Server is usually a server machine in the environment which serves the licenses
to the application machines connected in the company network.
It is also possible to use the floating license model if only one workstation is available. In that
case this single workstation has to fulfil both functions - being license server and application
machine.
The software product can check out licenses from the local license server if
the licensing code in the application (software product) and the Leica CLM Administrator
Server Software are of the same version.
if the licensing code in the application (software product) is of a newer version than the
Leica CLM Administrator Server Software.
If you are already running Software from Leica Geosystems check if the Leica CLM
Administrator Server Software is already installed on your local server machine. If this is the
case start the CLM, select About and check the version. e.g. 1.0.1068. Compare the number
of the already installed Leica CLM Administrator Server Software version with the number of
version provided on the software product Installation DVD.
16 Leica XPro
License setup
Update the CLM Local software on all client machines. If the already installed Leica CLM
Local software version is older than the version provided on the software product Installation
DVD, then install the version which is provided on the software product Installation DVD.
If newer versions of other Leica Geosystems software are available it is highly recommended
to upgrade those, to have always the latest Software version in use.
Click Leica CLM Administrator Server to install (or update) clm_server_package.exe to the
local license server. Follow the instruction provided by the installation program.
In case internet connection cannot be established for the computer then please use Offline
License Transfer - see "Offline License Transfer Process" on page 22.
User Manual 17
Installation and Configuration
Use Return licenses function on View Installed Licenses page in case the re-hosting of the
licenses to another local license server is intended.
CLM Local software is used on application machine in order to borrow the floating licenses
from Local License Server i.e. from the PC which serves the licenses in the company network.
CLM Local software is not required for the single workstation installation cases in which the
Local License Server with the floating license is running on the same application workstation.
Installation and using of CLM Server software on the application machine is sufficient in that
case.
The definition of the local license server in the CLM Local software is required:
- To display in the CLM Local software a list of all floating licenses which are activated
on the Local License Server to validate what is available for checkout by an application
or for borrowing.
- To use the CLM Local software to borrow floating licenses from the local license server
and to return borrowed floating licenses to the Local License Server
18 Leica XPro
License setup
In addition to the above the Local License Server needs to be specified in the application
itself as well. See "Application setup" on page 24.
1. Install the CLM Local software to the application machine. Follow the instruction provided by
the installation program. See "License tool installation" on page 9.
2. Open the CLM Local software and go to Options window for defining from which license
server the licenses are used. Type in the server name. Specify the number of days for borrowing.
License will be returned automatically once the number of the borrowing days has passed. User
can return the licenses earlier than specified. Click Apply.
3. The Local License Server name you have specified appears in the list under Borrowing from:
on CLM Local software main window. Click on the server name for displaying the list of
licenses on the server. Select the licenses to be borrowed.
User Manual 19
Installation and Configuration
To run the software product on a client machine all desired modules including the
Software Maintenance module have to be borrowed from the local license server. For an
early return all borrowed modules have to be also returned to the local license server.
4. Click Borrow.
1. Go to the View Installed Licenses page of CLM Local software. Select the licenses to be
returned. For an early return all the modules of the borrowed license have to be selected for
return.
20 Leica XPro
License setup
User Manual 21
Installation and Configuration
Offline License The Offline License Transfer functionality is helpful for the users who cannot establish an
Transfer Process internet connection on the PC where the application software shall be used (i.e. on the target
PC).
The option to activate/return or update a license offline is offered via a second PC or via any
other device that must at least have e-mail connection to the internet (e.g. a smartphone).
When a customer has got the Entitlement ID, the following steps have to be taken to activate
the Entitlement offline:
Enter the Entitlement ID to be activated offline as body text into the e-mail and send the
e-mail to [email protected]
The offline activation Start file will be sent back to your e-mail address
Save the Start file to a portable storage device, e.g. a USB stick, and transfer it to the target
PC.
Dependent on the license type (node locked or floating) install CLM Local or CLM Server
software and follow the steps of offline license transfer.
22 Leica XPro
License setup
Create a Request file and save it to a portable storage device, e.g. a USB stick.
User Manual 23
Installation and Configuration
Save the activation Request file as an attachment to the e-mail and send the e-mail to
[email protected]
The offline activation Response file will be sent back to your e-mail address.
Save the Response file to a portable storage device, e.g. a USB stick.
Application setup If no license is activated or the server is not defined for floating license a message window
appears after starting the software product: No valid basic license found.
Depending on the application either
or
an executable is used to specify on the application machine the name of the Local License
Server name or address (in case of floating licenses)
or
as in Leica XPro - the SW installation wizard asks user to specify the Local License Server,
the setting is saved and can be redefined in the xpro.ini file.
24 Leica XPro
License setup
Figure 2-20: Example: Z/I Imaging & Leica Geosystems Products Application
Preferences, Tab License settings
Select the radio button of the option which corresponds to your license type.
In case of Floating License enter the license server name
If the software product is running on the same machine as the Local License Server, enter
@localhost
In all other case enter either
or
License update Without valid software maintenance the upgrade is not free of charge. An order for the upgrade
is required. The deliverable for this order is a subsequent item to the existing Entitlement.
User Manual 25
Installation and Configuration
Activation of this item is equal as activation of a new license. See "Using Node Locked
licenses" on page 12 or "Using Floating licenses" on page 16.
Floating Licenses
For floating licenses use the CLM Server software to check the expiration date of Software
Maintenance.
26 Leica XPro
License setup
Re-hosting Depending on the license model, a license can be returned to the Leica Geosystems License
Server (FNO) and re-hosted to another machine.
Re-hosting, as extended licensing functionality, is available only for registered customers.
Floating Licenses
Re-host is used to transfer a floating license from the local license server machine A to the local
license server machine B
To re-host proceed as follows
6. Confirm Continue
User Manual 27
Installation and Configuration
Including:
- 777426 - SAS Host Bus Card, PCIe Bus
- 767993 - Slot Cover
- 767994 - Internal SAS cable
1. Mount the HBA Adapter with slot cover and internal SAS cable in a PC to a free PCIe slot.
Instructions how to use the Download Station are given in the Users Guide delivered with the
MM30 Download Station.
28 Leica XPro
Starting Leica XPro
eSATA controller card is required to connect the MM30 Download Station to a computer:
- Article #790732, eSATA Controller card for Desktop PC, 4 x eSATA cables included
or
- Article #785918, eSATA Controller card for Notebook, with cable
Instructions how to install the cards are given in the corresponding Users Guide delivered with
the cards.
Due to the high risk of accidentally deleting the flight data it is not recommended to use
the HighPoint RAID Management Software to handle the MM30 Download Station. It is
more preferred using Windows OS means for disk connections.
In case still using the HighPoint RAID Management Software, then please do not press
Yes for the initialization message which pops up while connecting MM30 - unless the
data on MM30 will be deleted.
Starting Leica Start Leica XPro with selecting from Programs > Leica Geosystems > XPro > Leica XPro or
XPro click to the Leica XPro Shortcut on Desktop.
XPro toolbar is launched with listing the XPro applications from left to right according to the
sequence in workflow.
User Manual 29
Installation and Configuration
30 Leica XPro
Chapter 3
Introduction Downloader software module is performing the first step of ADS80 ground processing
workflow. After this the data processing can continue with using whether Leica GPro or Leica
XPro software.
ADS80 Downloader gives a captured Mass Memory data overview and executes data extraction
or data replication to a user defined repository.
XPro v5.1 and later have new option to skip the Data Download step and to use the raw MM80
data in the workflow from Data Preparation to Product Generation. Further description of this
workflow is provided in Data Preparation Workflow .
ADS100 data is captured to MM30 and the Data Download step is always skipped. ADS100
workflow starts with Data Preparation step.
Preparation for Data storage on MM80 is performed whether in Single Operation, Joint Operation or Backup
download Operation modes. Dependent on the MM80 storage mode selected for data capture one or both
MM80-s have to be attached to the download workstation.
Additional information about the data storage modes is provided in Leica ADS80 User Manual.
Wait some seconds until the disks are recognized by the system
There should be 6 Dynamic Disks (for 2 MM80-s) which can be Reactivated or,
alternatively, Foreign Disks which can be Imported .
DO NOT CLICK "Convert to Basic Disk" - all data would be lost on the MM80
Check that an usable drive letter gets assigned after the reactivation / import
User Manual 31
Data Download for ADS80
Access rights to MM
Download process requires that user has write access to the Mass Memory - writing permission
is necessary for Index file.
When attaching an MM to workstation with Windows 7 OS then the user has to be owner of the
disk and has to gain write access to the Index file.
In case the Mass Memory is formatted with FCMS 3.22 or greater, then the access rights for the
volume are already set to allow access for everyone.
There is no need to format the MM80 before each flight.
32 Leica XPro
Data download
Data download Start the Downloader program with selecting from Programs > Leica Geosystems > XPro >
Downloader or click to the Downloader button on XPro toolbar.
Create / select Repository has to be pointed out into which the data download will be performed.
Repository Click Create New Repository button on the Destination line. Browse the location and type in
the repository name for creating a new repository.
Alternatively, click Attach existing Repository button on the Destination line in case the
existing repository is intended to be used for the download.
Select data for Data for download and download options have to be picked after creating and selecting the
download repository.
Select download operation mode from Operation selection box:
- Store and Extract - for performing copy of session on MM80 to the repository; copy
is followed by data extraction to the repository
- Store only - for performing copy of session on MM80 to the repository
User Manual 33
Data Download for ADS80
Select the Mass Memory location from which the data will be downloaded by clicking the icon
behind the MM field.
Browse to the Mass Memory location and Open the MMVolume.xml.
The selection process is the same for the real MM80 connected to the workstation and as well
for the previously copied Mass Memory data location.
Once the session is selected the view gets filled with listing the takes captured during the
particular session.
34 Leica XPro
Data download
All the takes from the session appear as activated for download. Click the check boxes for
deselecting/reselecting the takes.
Selection button for CCDs in the lower left corner of the ADS80 Downloader main window
opens the dialog for selecting image bands for download.
All the image bands appear as activated for download. Click the check boxes for
deselecting/reselecting the image bands.
Click OK for confirming the image band selection and closing the dialog.
Image compression selection box in the bottom of the Downloader main window offers the
following choices:
- Decompress data
- Do not change compression
Note: For downloading the data for Leica GPro workflow the option has to be set to
Decompress data. GPro is not able to handle the compressed images from ADS80.
Check box for Extract GNSS/IMU Data in the bottom of the Downloader main window offers
the option to perform the image and GNSS/IMU data extraction separately.
Commonly, GNSS/IMU data is always selected for the extraction as it is required for
georeferencing the images in the later stage of ADS data processing.
Start download Click Start Download button in the lower right corner of the Downloader main window in
order to perform the download.
User Manual 35
Data Download for ADS80
Progress of the download process can be observed in the download Progress window.
Downloaded data Data is downloaded to the repository into the workspace folder.
Workspace contains Session folder, where for each downloaded session the following data is
extracted:
- gps-imu - folder containing the raw GNSS-IMU data and additional folders ready to
use for GNSS-IMU processing,
- images - folder containing ADS80 images and camera time (CT) files,
- mm - folder containing the copy of Mass Memory data in case the Store option has
been selected; folder is containing as well FPES fight planning and evaluation data,
- raw - folder containing info and support files related to the downloaded images.
36 Leica XPro
Data download
Disconnect MM80 Before detaching MM80 from workstation press the Disconnect MM button.
Note: Disconnect MM button has to be used before detaching MM80 in order to avoid
inconsistencies in file system.
The Disconnect MM dialog window opens with asking to specify the device to disconnect.
User Manual 37
Data Download for ADS80
After selecting the device and clicking OK please wait for the next dialog message before
disconnecting the MM cable.
38 Leica XPro
Chapter 4
Data Preparation
Data Preparation Data Preparation is a tool for data validation and for image georeferencing.
Overview Data Preparation is the first step of data ingestion into the Leica XPro system. It ties together
the various bits of information that were created as separate files on the airborne system. Data
Preparation uses for input the data whether from GPro download step (ADS40 data) or from
ADS80 download step. XPro v5.1 and later have new option to skip the ADS80 Data Download
step and to use the raw MM80 data in the workflow from Data Preparation to Product
Generation.
Data from ADS100 at MM30 is always accessed without Data Download step. Data Preparation
is the first ground processing step for ADS100 data.
Data Preparation combines a number of different steps into one user interface. These steps and
tools are:
ct transformation - transforms the ct (camera time) file for each band into a ctg file
(camera time in GPS time system). It is done by interpolating within the TM (time mark)
file. In addition, integrity of ct files is checked.
eop generation - creates initial exterior orientation file (eop files) for each Take. The
values are obtained by applying a number of coordinate transforms and interpolation
within the orientation data delivered by the GNSS/IMU system. In addition, integrity of
TM files is checked.
GNSS-IMU real-time trajectory extraction - extracts and uses optionally the GNSS-
IMU real-time trajectory, in case the post processed trajectory is not available
footprint generation - creates footprints (fpt files) for each image band by using a sensor
model and running image-to-ground with a rough global elevation model (gTopo).
statistics generation - creates image statistics files for use with other XPro software
components (radiometric corrections).
User Manual 39
Data Preparation
ADS100 data on MM30 The MM (Mass Memory) for ADS100 will no longer consist of a software raid. Instead Leica
FlightPro will spread the data across an array of disks. This has the advantage that the MM can
be handled as simple disks, not requiring any specific drivers or operating system support - the
disks of the MM30 appear as normal drives in the Windows Operating System and each disk
will have its own drive letter.
One MM30 consists of n disks and there can be m MM-s. At the moment the CU is physically
capable of working with 4 disks.
The MM-s support 2 different modes of operation:
- Joint
- Back up
And there is in addition the hot-swap mode of operation, which can be used with any of the 2
modes of operation mentioned above. Leica FlightPro will automatically rename the session
folders on the swapped MM30-s. And the flightdata.xml file contains information about the
continued file on the next pair of MM30-s.
Joint Operation
In joint mode the recorded data is spread across all available disks. Some data is duplicated and
other is unique:
- There is exactly one file containing the per image data (like TIF file, ct files, ...)
- GNSS-IMU data exists exactly on one of the n disks
- All other meta data (including Flightdata.xml) exist on exactly one disk
- The whole directory structure exists n times
Back up Operation
In back up mode the data is spread across the disks of one MM (like in joint mode) but the whole
MM is duplicated. Thus making it possible to recover data in the case of a disk error.
There will be an entry in mmvolume.xml of flightdata.xml to mark the system as running in
back up mode.
40 Leica XPro
Data Preparation Workflow
Data Preparation Start the Data Preparation from Programs > Leica Geosystems > XPro > Data Preparation
Workflow or click to the Data Preparation button on XPro toolbar.
Using raw MM data in XPro v5.1 and later have new option to skip the ADS80 Download step and to use the raw
workflow MM80 data in the workflow.
Users who have selected to use ADS80 Downloader and have already the Sessions with the raw
downloaded images on the processing environment, should skip the instructions in Select
Flight on MM and should work further from step Select Session .
The raw MM data can be processed from MM directly or from the copy of MM Flight located
in the network / drive.
MM data is used as read only.
Information for connecting the MM to the processing workstation can be found at Preparation
for download .
For disconnecting the MM80 follow the instructions in Disconnect MM80 .
The main difference in using the MM80 data in the workflow is about creating the Session by
Data Preparation and not by ADS80 Downloader.
The step of creating the Session in Data Preparation is described in Select Flight on MM .
For further steps, starting from Select Session , the workflow with the raw MM80 data and
the workflow with the downloaded raw images are similar.
The process of creating Session from MM80 raw data in Data Preparation includes:
creating a new Session folder, according to the pre-defined Session name in the Data
Preparation Settings
creating mm sub-folder with writing the location of the raw MM80 into it
(yyyymmddhhmmss_FlightData.raw.xml file).
User Manual 41
Data Preparation
extracting the GNSS-IMU raw file and also the GNSS-IMU real-time solution into the
gps-imu sub-folder
creating the references of raw image files (.rds) into the images sub-folder, according to
the pre-defined Image name in the Data Preparation Settings
Leica XPro v5.2 and later can take the benefit from using the additional data prepared on MM80
by the newer versions of FCMS during the flight mission.
FCMS v3.38 and later prepare during the Index file generation the following data, in order to
minimize XPro data preparation time:
- GNSS-IMU realtime solution file
- GNSS-IMU raw file
- TM (Time Mark) file
- CT (Camera Time) files
Select Flight on MM Data Preparation opens with the dialog window offering to browse the location of the Flight
folder on MM.
Select the Flight folder on MM or select the copy of MM Flight located in the network / drive.
42 Leica XPro
Data Preparation Workflow
Select the location on processing workstation or in network to where the new Session will be
created.
File naming of the images will be performed according the Data Preparation Settings.
User Manual 43
Data Preparation
After the Session has been created the further steps of the workflow with raw MM data are
similar to the workflow with downloaded images - Data Preparation performs the validation and
georeferencing as described on the next pages.
Select Session Select a Session folder. This a folder holding the raw downloaded data from a single Session (or
ADS40 Flight). This folder must contain at least the three sub folders "images" , "raw" and "gps-
imu". An error message will be displayed if no valid Session data is found in the selected folder.
Data Preparation picks the proper sensor calibration file according to the sensor head number.
The location of the sensor calibration files is user defined in the xpro.ini initialization file.
Users can change the preset calibration location in the xpro.ini file in [Calibrations] section.
xpro.ini file is provided with XPro installation, usually at location C:\Program Files\Leica
Geosystems\XPro\.
The processed GNSS-IMU trajectory with the extracted TM file have to be present in the
Sessions gps-imu proc and extract subfolders respectively.
In case there are multiple processed GNSS-IMU trajectory files, then user is asked to pick one
in the Data Preparation interface.
44 Leica XPro
Data Preparation Workflow
Note that the accuracy of GNSS-IMU real-time solution is generally lower than of post-
processed. Real-time solutions are flagged with the red exclamation mark and the images
georeferenced with real-time solution are not supposed to be used for the further steps of Block
Preparation and Aerial Triangulation.
Run Session After selecting GNSS-IMU trajectory press Open button in order to start the Session
Validation validation.
User Manual 45
Data Preparation
Session validation runs and reports Messages, Warnings and Errors, in case found.
Warning is displayed in case for some of the image bands the data is not found.
Select Takes and Select the Takes to be processed. By default, all Takes will be prepared, as indicated by the
georeferencing checkbox in front of the corresponding Take.
options
46 Leica XPro
Data Preparation Workflow
User Manual 47
Data Preparation
Image pyramids (minified images) are required for these L0 image bands which are
expected to be QC-d before the Product Generation in the QC Viewer with full swath of
the image.
Image Statistics has to be collected in order to be able to use the QC Viewer with the
certain correction options (Modified Chavez, Atmospheric Correction, BRDF)
For instance, in order to view for QC the full swath of Virtual L1 RGB with Atmospheric
Corrections it is required to create image pyramids and collect image statistics for Red,
Green and Blue L0 image bands.
For getting the advantage from the BRDF correction it is required that RED and also NIR
image band are worked through by the image statistics collection in Data Preparation, as
the water mask is calculated for BRDF correction.
The steps of APM, Triangulation and Rectification do not require preparing minifications
nor image statistics. In case the L1 or L2 product is expected with Atmospheric
Corrections then the Rectification itself is taking care of collecting the image statistics.
Still, in case the BRDF correction is intended to use for the L1 and L2 products then the
image statistics have to be collected in the DataPrep Minify tool (NIR image band is
required) before the Image Generation step.
APM step has option to avoid water bodies detected by Image Statistics calculation. Select
Statistics to be calculated in Data Preparation step in case it is intended that APM will use
this information in later stage.
DSM Extraction step requires image pyramids for the input image bands.
48 Leica XPro
Data Preparation Workflow
User Manual 49
Data Preparation
Data Preparation Data Preparation Settings window can be opened from File > Settings menu.
Settings
General settings
Settings are provided for whether to run the process locally or on cluster.
Users can define in settings the default folder location into which new Sessions are created.
50 Leica XPro
Data Preparation Workflow
Statistics Parameters
Statistics Parameters define the image statistics collection settings.
Water NDVI value is taken into account for collecting the water mask information required for
BRDF corrections. The default value is -0.1. With raising the value from -0.1 towards 0 there
will be less water-like pixels included while calculating the statistics. In cases the data set
includes many bright pixels (e.g. from reflections), then it is suggested to raise the value to 0.
Lowering the value to -0.2 would make sense when the images in the data set include large
percentage of water bodies i.e. have many dark pixels.
Statistics settings window offers option for creating histograms from the collected statistics
information in .PNG or in .CSV format.
Histogram files are created to the Session folder or to the folder defined by the user.
Histogram information will be created only for these image bands, which are selected for
'Statistics' in the DataPrep main window ( Image Pyramids and Statistics ).
Pyramids settings
Settings window offers option to define the location for the L0 image pyramids.
User Manual 51
Data Preparation
Session- and Image file naming settings are applied for the cases when processing the raw
MM80 data directly.
The naming settings do not impact the data while performing the Data Preparation to the
already downloaded Session.
52 Leica XPro
Data Preparation Workflow
User Manual 53
Data Preparation
Run image Click Process button in order to start the image georeferencing process.
georeferencing Data Preparation asks the confirmation - in case the georeferecing exists from the previous runs,
then it will be overwritten.
54 Leica XPro
Data Preparation Workflow
User Manual 55
Data Preparation
Data Preparation saves the log file into the Session folder.
EOP Export Tool EOP Export Tool is offered for converting the L0 image orientation into the format usable
outside the Leica XPro workflow, for the SW packages with ADS sensor model. EOP Export
Tool converts .eop orientation to .odf and updates the L0 .sup files according to the output folder
which the user selects.
The tool is not required for Leica XPro workflow as all the XPro applications take the image
orientation from .eop files.
EOP Export Tool is not suitable for converting the adjusted orientation (.eop.adj) after the XPro
Triangulation step.
56 Leica XPro
Data Preparation Workflow
Start the EOP Export Tool by double-clicking the eop2odf.exe in the Leica XPro installation
folder (usually at location C:\Program Files (x86)\Leica Geosystems\XPro\).
EOP Export Tool requires Leica XPro installation, but does not require any XPro SW license.
EOP Export dialog window asks user to select the Session for export and to browse the Output
Directory for .odf and .sup files.
User Manual 57
Data Preparation
58 Leica XPro
Chapter 5
QC Viewer
QC Viewer QC (Quality Control) Viewer is used to display any image in the supported formats of TIFF,
Overview ADS image with TIFF blocks, RDS and LRI.
One of the main uses of QC Viewer is to quickly validate the quality of downloaded images for
cloud coverage, reflections, etc.
The viewer can as well load a block file and display the images in that block using the sensor
model. This allows viewing and moving the images using ground coordinates instead of image
pixel locations. In this case the images are rotated to North up, East right.
QC Viewer Smooth roaming of any image in the supported formats of TIFF, ADS image with TIFF
Features blocks, RDS and LRI.
Support for 1, 2, 3, or 4 band images. Up to 3 bands can be viewed at a time and can be
rearranged in different orders.
Support for L1 on-the-fly (OTF) rectified images. Users can load a Session with
georeferenced L0 images - while selecting L1 mode in QC Viewer the images are displayed
with OTF L1 rectification. This feature allows viewing the RGB and FCIR for QC without
the need for rectifying the products on the disk.
Support for using minification levels when viewing an image. Minification levels must be
generated before using the QC Viewer. The existing/missing pyramid levels are indicated
by the pyramid symbol in the QC Viewer.
Dynamically stretches the brightness of the currently viewed area of the image. Update is
performed as the view is moved. Additionally, user can adjust the minimum and maximum
percentage and offset to use for the stretch.
Allows for loading of a block or strip file which allows for viewing and moving the imagery
in ground space using the sensor model.
Allows viewing footprints of the images when the session or the block of image takes is
loaded.
Provides a continuous movement mode which causes the view to move down at a certain
rate.
User Manual 59
QC Viewer
Offers creating Radiometric Profiles in Image Adjustment window for the later use in
Product Generation.
Allows copying the text on the QC Viewer status bar to the clipboard for pasting.
QC Viewer requires a 3D video card that supports OpenGL version 2.0 or greater.
QC Viewer requires a 3D video card that supports 16 bit texture formats. Image Viewer
has the function for disabling the use of 16 bit textures, which would solve the issues for
the video cards not providing this support, but this degrades viewer output quality.
QC Viewer Start the QC Viewer from Programs > Leica Geosystems > XPro > QC Viewer or click to the
Workflow QC Viewer button on the XPro toolbar.
Selecting an image to On initial start up the image viewer will be blank. The user will need to click on the Open
view command item located on the command bar. Alternatively you can use the File menu and select
Open.
The Open File Dialog will then be presented in which the user can select a LRI, ADS, RDS or
TIF file from the list. Alternatively, user can change the "Files of type" filter to Blocks or Strips.
Loading a block or take will load the first image in that block or take. The remaining bands in
the block or take will be added to the image list.
Loading the session of image takes works from File > Open Session with pointing to the Session
folder containing the takes.
Users can switch the band that is displayed by clicking on a band in the image list and then
clicking "Load" in the image list's command bar.
60 Leica XPro
QC Viewer Workflow
Synchronized views of multiple bands or images in the block or take can be created. First the
user has to load a take or a block or multiple images with getting the image list populated. Then
with the Right mouse click onto the items in the images list user gets the option to load the
image into the left or right view.
The synchronized view will be removed with hitting the "-" button on the command bar.
Status Information When an image is loaded the name of the file that was loaded will be displayed on the top
window bar. Also the X and Y coordinates for the center of the pixel under the center mark is
displayed in the bottom left status bar along with the Minfication/Magnification level.
Selecting DRA Settings form the Settings menu will open the window showing the Min
and Max threshold percentages which are used for the dynamic brightness stretch.
Brightness offset can be adjusted to increase or decrease the overall brightness of the image.
Checking in the Lock Brightness Changes box freezes the brightness settings for not changing
according to the image contents in the view.
While working with the split view, the pressing of buttons Left, Both or Right on the QC
Viewer toolbar defines to which view the change of the settings gets applied.
Clicking Both will apply the current settings of the Left view also to the Right view.
User Manual 61
QC Viewer
If a block or strip file are loaded then the x, y and z ground coordinates will be displayed along
with the line and sample coordinates of the image. The coordinate system will be displayed in
the bottom right. The coordinate system can be changed and the movement and display will
change to the new coordinate system.
Controls By selecting the "Control Settings" menu item from the "Settings" menu, you will bring up the
current control settings for both the mouse and keyboard. Currently only the mouse buttons can
be modified to perform different functions. Each button has a pull down list which allows any
mouse button to be mapped to a any of the allowed functions. The default keyboard shortcuts
are also shown. The current allowed functions are:
1) Restart Scroll - Sets the view window to the start of the image.
2) Start/Stop Scroll - Toggles the auto-scrolling of the image.
3) Stop Scroll - Stops the auto-scrolling of the image.
4) Increase Scroll Speed - Increases the speed of the auto-scroll.
5) Decrease Scroll Speed - Decreases the speed of the auto-scroll.
6) Toggle Cursor - Toggles the display of the center mark on the display.
7) Fit to window - Minimizes the image until the full width of the image fits into the view.
8) Go to coordinate - Pops up a dialog that allows you to select the x, y, z coordinate to go to.
9) Toggle smooth roam - Toggles moving the view using the movement of the mouse.
10) Increase Zoom - Increases the zoom by 2x magnification
11) Decrease Zoom - Decreases the zoom by 2x minification
12) Increase Z axis - Increase the z coordinate value.
13) Decrease Z axis - Decrease the z coordinate value.
14) Increase Brightness Max Cutoff - Increase the percentage used for the max cutoff.
15) Decrease Brightness Max Cutoff - Decrease the percentage used for the max cutoff.
16) Increase Brightness Min Cutoff - Increase the percentage used for the min cutoff.
17) Decrease Brightness Min Cutoff - Decrease the percentage used for the min cutoff.
18) Scroll View Down - Move the view down
19) Scroll View Up - Move the view up
20) Scroll View Left - Move the view left
21) Scroll View Right - Move the view right
22) Copy StatusBar Text - Copies the text on the QC Viewer status bar to the clipboard for
pasting
62 Leica XPro
QC Viewer Workflow
Moving Around There are a number of ways to move around an image once it is loaded. The main way is to use
the mouse and to toggle the smooth roaming. By default the left mouse button will toggle
smooth roam. When smooth roam is enabled the system mouse cursor will be hidden and all
mouse movement will cause the view to move in the same direction. To disable the smooth roam
just click the left mouse button again and smooth roam will be disabled.
The next way to move is to use the auto-scroll feature. The auto-scroll is controlled by the play,
stop and rewind buttons on the main control bar. There is also a slider that controls the speed of
the scroll. Hitting the play button will start the scroll and hitting the stop will stop it. The slider
can be changed while the scroll is active. Also using the "Page Up" and "Page Down" keys on
the keyboard will increase or decrease the speed respectively.
The last way to move around is to use the arrow keys on the keyboard. Up will move the view
up, down moves down, left to the left, and right to the right.
If minifications are available the viewer can be zoomed out to show a minified view of the
image. By default the mouse wheel controls the zoom of the viewer. To magnify the image roll
the wheel forward. To minify the image roll the wheel backwards.
When a block or strip file are loaded the sensor model will be used. All movement will be based
on the ground coordinates of the take being viewed. Images will be displayed with North to the
top of the screen and East to the right. Movements left or right will change the x ground
coordinate and movements up or down will change the y coordinate.
Image pyramids The availability of image pyramids for the loaded image is indicated by the pyramid icon in the
availability lower right corner of the QC Viewer.
Available pyramids allow zooming out of the loaded image in the viewer.
Users can switch on the Analyze Sessions and images for existing minifications check box
from Settings > Performance Settings. The check box enables the option of flagging the
missing image pyramids for the images in the product list with the icon.
User Manual 63
QC Viewer
Toggle image bands While viewing 4-band images the image bands can be toggled easily with the toggle button on
the QC Viewer bar.
The settings of which of the image bands are toggled can be defined under Settings > Band
Toggle Settings.
64 Leica XPro
QC Viewer Workflow
Toggle image zoom User has option to toggle the zoom level of image or images in case working with split view.
level
Figure 5-7: Toggle image zoom level
Zoom levels can be redefined in the Image Display Settings window from Settings menu.
Zoom level toggle honours the Left, Both, Right button selection while working with split
view.
Viewing cross-eyed Users can load the L1 on-the-fly rectified images to the split screen and view cross-eyed stereo
stereo for QC.
Open Image Display Settings window from Settings menu.
Change the L1 Alignment from North Up to Stereo or to Stereo Right. Stereo Right
setting aligns the images always by turning from North up to the clockwise direction - to the
right. Alignment settings are explained on the drawing below.
User Manual 65
QC Viewer
Histograms View The viewer can display the histogram of the luminance of the image being viewed. For starting
the histograms view open the Image Adjustment window (View->Image Adjustment) and click
the Histograms View button on the upper right corner.
66 Leica XPro
QC Viewer Workflow
Users can change between viewing in the composite or individual bands mode by clicking to
the coloured buttons below the histogram view respectively.
Auto button scales the histogram view automatically according to the input image histogram.
Alternative to automatic scale is to select a certain bit depth range by typing in the number: 12,
14 or other.
Users can zoom in the histogram view with drawing the zoom-in rectangle by mouse. Zoom
out is performed by double mouse click.
Drawing QC Viewer has the ability to draw and export closed polygons.
The polygons are representing a type of object that covers an area - for example: clouds,
reflections, disaster regions, etc.
Each polygon can be grouped and named.
Draw polygons
User Manual 67
QC Viewer
Export polygons
Drawing View opens with showing the drawing tooltip and the two tabs for drawing parameters
and for export/delete tools respectively.
68 Leica XPro
QC Viewer Workflow
Drawing Mode
Hit the 'D' key for starting the Drawing Mode.
Cursor shape change and drawing tooltip indicate that you are in the Draw Mode.
The other QC Viewer actions remain available - zoom in/out and roam in the image are enabled.
In Drawing Mode each of the Left mouse click is converted into the insertion of a new vertex
of polygon.
The Drawing Mode provides automatic incrementing of the polygon Names - this enables
drawing multiple polygons without leaving the Drawing Mode. The type of Object stays in
Drawing Mode unchanged.
Hit the 'D' key for leaving the Drawing Mode.
Drawing polygons
Left mouse click in the Drawing Mode inserts a vertex of a polygon.
Close the polygon by clicking the Right mouse button. The polygon gets saved to the Session
with the name and the object type chosen.
The Drawing is automatically handling the names of the polygons. By default the name of a
polygon is Poly_ followed by a counter. The incrementing is automatic when finishing a
polygon. The name and type displayed in the Drawing View will be taken for the polygon you
are going to draw or which you have already started to draw.
The automatic naming strategy uses the pattern name given by the user and increments it by a
counter.
You still have the possibility to change the polygon parameters before closing the polygon by
leaving the Drawing Mode and the Roaming Mode. Enter the correct parameter value(s) and
continue the drawing by getting back to the Drawing Mode afterwards.
User Manual 69
QC Viewer
In order to delete a polygon go in Drawing Mode with the cursor into the polygon area and press
ALT+E.
Alternatively, users have an option to define a mouse key for deleting polygons. Go to the QC
Viewer menu Setting>Control Settings and define Remove Polygon to the mouse middle
button, for instance.
In case of pointing to the overlap area of multiple polygons, ALL polygons will be removed.
Drawing View provides ability to delete multiple polygons from the Session in one go.
Tools tab of the Drawing View lists the filter by the object types. Hitting Delete will remove
all the polygons from the Session according to the object types checked in the filter.
70 Leica XPro
QC Viewer Workflow
Exporting polygons
Tools tab of the Drawing View lists the filter by the object types. Hitting Export will export
all the polygons from the Session into ESRI shape file format according to the object types
checked in the filter.
Select a location to where the shape files would be exported.
Type a name related to the project or session. The Export tool exports all the selected object
types in file, named as following:
<Name typed while exporting>.shp
User Manual 71
QC Viewer
Overlay QC Viewer offers an option to import and view existing shape files as Overlay.
Open the Import Overlay dialog from File > Import Overlay.
Coordinate system of Shape files is defined in the .prj file, which usually accompanies the .shp
file.
In addition to WGS84 Geographic also UTM and Grid State Plane (both in 2D) Coordinate
Systems are supported.
In case the .prj file is missing then QC Viewer assumes WGS84 Geographic while loading the
Overlay.
Overlay can be switched On/Off from View > Overlays.
72 Leica XPro
QC Viewer Workflow
Overlay is not persisted for the viewing session - user needs to reload the Overlay every
time after restarting the QC Viewer.
Image Adjustment QC Viewer offers tools for creating Radiometric Profiles in Image Adjustment window for the
later use in Product Generation. Radiometric Profile captures the settings user selects in the QC
Viewer with virtual products and ensures the same radiometric properties for the 16-bit and 8-
bit products which are rectified to a disk.
Open a Session and load an Image - usually a virtual (on-the-fly) L1 RGB or NRGB
For 4-band image product - switch the image display settings to the other set of 3 bands and
verify/adjust the Radiometric Profile
User Manual 73
QC Viewer
Image Adjustment window opens with loading the histograms per image band and performing
the Auto Scale adjustment for the Input Levels.
While working with Image Adjustment the Dynamic Range Adjustment (DRA) in the image
view is automatically switched Off.
Auto button scales the histogram view automatically according to the input image histogram.
Alternative to automatic scale is to select a certain bit depth range by typing in the number: 12,
14 or other.
Users can zoom in the histogram view with drawing the zoom-in rectangle by mouse. Zoom
out is performed by double mouse click.
Reset button in the upper right corner of the Image Adjustment view sets back to linear the
changes done for the composite tone curve and/or for the curves of individual image bands.
Image curve adjustment works whether for composite image or for individual image bands.
Users can change between working in the composite or individual bands mode by clicking to
the coloured buttons below the histogram view respectively.
74 Leica XPro
QC Viewer Workflow
Infrared Scaling factor value is available for adjustment with FCIR and NRGB images. NIR
Factor changes the intensity of NIR compared to the other image bands.
Save button opens the dialog window for saving the Radiometric Profile file. The file name is
proposed according to the Take and Image - the naming is helpful for further use of profiles in
Product Generation.
Load button, in the lower left corner of the Image Adjustment window, loads and applies the
already saved Radiometric Profile file for the currently loaded image. Loading the profile which
is saved from another Take works, only condition is that the existing Radiometric Profile has to
include the information for all the image bands of the loaded image. Loading of a 4-band
(NRGB) Radiometric Profile for a 3-band (RGB) image is supported, but not the other way
around. While loading the Radiometric Profile also the type of correction (Calibrated,
Atmospheric etc.) is read from the file and applied to the image in view.
Users can load also GPro .bpf TTC curves into the Image Adjustment view. The GPro .bpf
curves can be saved into the XPro Radiometric Profiles.
User Manual 75
QC Viewer
The controls for panning and zooming in Image View remain active while working with Image
Adjustment view.
76 Leica XPro
QC Viewer Workflow
Figure 5-24: Verify / adjust the profile with the other set of 3 image bands
While adjusting or validating the Radiometric Profile in the Left view, users have option to load
a neighbouring flight line image into the Right view with an already saved existing Radiometric
Profile as for comparison. Right mouse click to a Take in the list offers this option for image
loading.
User Manual 77
QC Viewer
The file name is proposed according to the Take and Image - the naming is helpful for further
use of profiles in Product Generation.
In order to synchronize the Orientation Plot with the image in the loaded Session check in the
Sync with View box at the lower-right corner of the Orientation Plot.
In addition to the orientation information EOP View provides plots also for Scanline Data.
The values for Integration Time, Cycle Time and TDI Stage are displayed on the Scanline
Data plot.
78 Leica XPro
Chapter 6
Measurement
Measurement Measurement module is used to measure the tie points for tying the images from 3 different
Overview viewing angles of a take and as for tying the overlapping takes to each other. The measurement
of tie points can be executed as Automatic Point Matching or performed manually.
Measurement can be used as well for measuring Ground Control Points.
With Leica XPro v4.2 and higher the measurement functionality is alternatively offered from
the XPro Triangulation interface. With Leica XPro v4.4 and higher also the initial APM run can
be started from XPro Triangulation interface.
Thus starting from version 4.4 the Leica XPro workflow can be executed with skipping the
Measurement module.
Measurement
Features
Core functionality Core functionality of Measurement is listed as follows:
- list of points
- point statistics: number of measured/unmeasured control/tie points
- point location on top of block overview
- point ID
- type: control point or tie point
- measured / unmeasured state
- measurement information: number of measured image points / total number of
image points
- image views displaying
- all image points related to the current object point (control or tie)
- flight direction of each band
User Manual 79
Measurement
- control/tie points imported from: the legacy Measurement format, the control/tie
coordinate file (ASCII or XML format), IPF file
- tie points generated by APM module
- adding control/tie points in the block overview
- deleting control/tie points by
- single deletion
- regional deletion by defying a rectangle in the block overview window
Measuring points
Adjusting points
- adjusting control points from a control coordinate file (ASCII or XML format)
- moving tie points in the block overview window
Manipulation of view
- zoom in, zoom out, pan in block overview window and image views
- roaming in image views (single view or all views)
- image smoothing on/off in image views
- brightness control in image views
Input Data Measurement needs the block definition file (*.blf) created by Block Preparation.
This contains:
*.stp file (one per take)
*.eop file (one per take)
*.fpt file (one per band): used to determine the bounding box for rectification
*.ctg file (CT file in GPS time, one per band)
80 Leica XPro
Automatic Point Matching
Output Data *.msf file contains a reference to its block file, the measured bands, and all point measurement
information.
Other files exported by user, such as:
- footprints as ESRI shape file
- block overview as image file
- control / object points coordinates file
- image points file in XML format / IPF format / IPT format
Automatic Point
Matching
APM Overview The ADSAPM module has been designed to optimize the automatic point matching task on
ADS imagery by taking advantage of the sensor's characteristics. Specifically, the APM
module uses and requires:
- A valid camera calibration
- Valid direct georeferencing information with known error characteristics
- Multi-view geometry
By using this information, the search algorithm can quickly zero in on the appropriate area in
the image. In the diagram below, a master point is selected; the georeferencing and camera
calibration allows us to choose a small area along the epi-polar line in an adjacent view of the
ground. By sampling the search area, a cross-correlation function results with having a
maximum value at the correct match point.
User Manual 81
Measurement
1. A series of 'seed' points are pre-computed on the master image using the pattern information.
2. The seed point areas are searched to find an interest point (a point with high contrast).
3. The interest point location, along with the minimum and maximum search elevations defines an
epipolar line (a geometrically constrained search area) in the target images. The area
perpendicular to the line can be searched by increasing the expected parallax value.
5. The computation results are analyzed to pick the most likely match that meets your cutoff
specifications.
This contains the image information and image order (important to determine the 'master'
image)
This document assumes the user has access to an APM Settings file; and it will make references
to specific criteria in the following sections.
82 Leica XPro
Automatic Point Matching
APM Operation
The search criteria on which the APM operates is defined in the APM settings file.
The more detailed description of the APM setting file is given in Chapter 10 Appendix A -
Automated Point Matching File Description
The APM module has 3 modes which are all related (settings file key APM_MODE):
INLINE_ONLY
This creates new points and matches only within single ADS lines. A line should contain
multiple images. This mode will not transfer points between overlapping lines.
TRANSFER_ONLY
This will transfer points between lines only. No new points will be created.
FULL
This will run the INLINE_ONLY mode first, then followed by the TRANSFER_ONLY mode.
This is considered the default case.
The INLINE_ONLY and TRANSFER_ONLY modes vary only is the source of the tie points.
In INLINE_ONLY, new points are created based on Settings File criterion; in
TRANSFER_ONLY, points are read from IPF and GPF files. The remaining matching logic is
the same.
User Manual 83
Measurement
84 Leica XPro
Measurement Workflow
- For each search result, values are checked against the user supplied
INLINE_RMS_CUTOFF_PER_PIXEL and INLINE_CORRELATION_CUTOFF
values. If the search results pass, they are stored in a list.
- The next target image is search
6. When all target images have been searched, the list of all results is compared
- All lists are searched for the point with the highest cross-correlation and lowest RMS.
Its ground position is recorded.
- The remaining image lists are searched for the point with the minimum spatial offset
in object space to the highest correlated point.
9. When all images are processed, the results are written to the IPT/IPF/GPF files.
10. Done.
By default, the TRANSFER_ONLY mode will not transfer points within the same ADS line;
only across different lines. This behavior can be altered by specifying TRANSFER_INLINE =
1. This function can be useful is the user wants to add a new image view to an ADS line that
has already run APM.
Measurement Start the Measurement from Programs > Leica Geosystems > XPro > Measurement or click
Workflow to the Measurement button on XPro toolbar.
Select Block Click to a New icon for opening the Block Selection dialog window.
User Manual 85
Measurement
Select an existing block created in the Bock Preperation step. Measurement works on one block
at a time.
Options are:
- pick a block from the recently visited block list, or
- browse for a block file.
Select Image Bands to Measurement, APM and Triangulation work on 3 image bands from a take. Points are measured
measure on these 3 image bands from different viewing angles - Forward, Nadir (or close to Nadir) and
Backward. 3 panchromatic image bands are preferred for this purpose. After the Bundle
Adjustment with these 3 image bands the improved orientation is written out to all of the images
in the take, including those image bands which did not directly participate in Measurement and
Triangulation.
Select the image bands to measure:
- check 3 bands to be measured - 3 panchromatic image bands are preferred
- select the master band - usually most nadir-looking band.
86 Leica XPro
Measurement Workflow
Load Ground Control In case the Ground Control Points (GCP) file has been added during the Block Preparation step
Points then the GCP-s are loaded automatically into the Measurement.
Only the GCP-s in the block area will be loaded.
User can alternatively load and measure the GCP-s in the Triangulation interface. Thus, there is
option to skip this step and run only the APM from Measurement interface.
In Measurement interface the GCP-s would be measured on non-rectified L0 images. While in
Triangulation interface the measurement of GCP-s is performed on the automatically rectified
L1 images (on-the-fly rectification). Latter is covered in Chapter 8 Aerial Triangulation .
Measure Ground GCP-s appear on Footprint window. The images of the green rectangle marked first GCP
Control Points location are loaded.
User Manual 87
Measurement
Optionally, the Digital Elevation Model (DEM) which has been added to the block in Block
Preparation step can be switched to view on Footprint window.
Left mouse click on first image in the GCP location in order to measure the GCP. Software
takes the first image on which the user measures the GCP as Master Image. Software correlates
the GCP measurements for the rest of the images in other views. In case the operator wishes to
correct the measurement in any of the images, then new Left mouse click to the proper location
is required.
Right mouse click is giving the option for changing the Master Image view.
Zooming in and out can be performed by changing the value in the Zoom Scale pull-down
selection box in the measurement main window.
Zooming out from 1:1 is supported only when image pyramid has been minified for the images.
After the GCP has been measured in the view the mark X appears in the lower right corner of
the image view.
Master image view is marked with M in the upper right corner of the image view.
88 Leica XPro
Measurement Workflow
After going through all GCP-s start Automatic Point Matching (APM) for measuring the tie
points.
Generate tie points Select menu Point > Generate Tie Points using APM from Measurement main window in
using APM order to start APM.
User Manual 89
Measurement
A notification message pops up, as all the GCP measurements have to be saved into the image
point files (IPT) before the APM start.
Figure 6-10: Save GCP-s measurements into image point files (IPT)
APM starts with measuring tie points and continues with point transfer.
The tie points are saved automatically into the IPT files for the Triangulation step.
After the APM run exit Measurement with closing the Measurement main window.
Say No for the offer of saving the measurement file.
Import of IPT files into Measurement is a process used only in cases when the points are
intended to be verified / re-measured in Measurement. The verification and re-measuring is
however usually performed in the XPro Triangulation interface.
90 Leica XPro
Chapter 7
Block Preparation
Block Preparation Block Preparation is used to assemble individual flight takes into one triangulation block (group
Overview of takes that together undergo the bundle block adjustment process.) The central data structure
is a block file, which references all Takes (Strips) in this Block. Because a Take (Strip) can be
used in multiple blocks, BlockPrep makes local copies of all relevant files for a Take (Strip)
(*.stp file, *.ctg files, *.eop file) and assembles them into subfolders of the block location.
The different parts that make up a block are:
Flight takes
Reference Image
Block Preparation Start the Block Preparation from Programs > Leica Geosystems > XPro > Block Preparation
Workflow or click to the Block Preparation button on XPro toolbar.
Create New Block Create a new block file or open an existing file for modification. When creating a new file, the
user has to specify location and name. The name is used as a default for the folder containing
the block data. Still, it can be changed in the dialog if required.
User Manual 91
Block Preparation
Set Coordinate Set the Coordinate System to be used for aerial triangulation and product generation.
System
Figure 7-3: Set Coordinate System dialog
Add Takes Add the takes to be used in the block via menu Block > Add Take and selecting the required
.stp files from Session\yyyymmdd..\raw folder.
92 Leica XPro
Block Preparation Workflow
Add GPro triangulated User has option to add into XPro block the takes triangulated with the previous workflow
Takes software GPro. In this way the already existing improved image orientation can be used in XPro
Product Generation and DSM Extraction without the need of readjustment in XPro
Triangulation.
Select the L0 image .sup files from GPro workflow location and proceed with Block
Preparation.
User Manual 93
Block Preparation
Add DSM In case DSM is intended to be used add the DSM corresponding to the block area and to the
selected coordinate system via menu Block > Add DSM.
DSM-s in IMG and TIFF format are supported. The IMG and TIFF DSM-s would have to be 32
bit floating point single band images.
According to the choice, a newly added DSM is copied to the "dsm" folder of the new block
location, or alternatively, referencing is made to the original location of the DSM without the
copy.
Several DSM-s can be added to a Block.
In the later Product Generation step users have the ability to select one of the DSM-s from the
list for orhtorectification. Thus it is not required to remove the previously added DSM-s.
Add Reference Image In case reference image is intended to be used then add it via menu Block > Add Reference
Ortho.
Add Ground Control In case ground control points are intended to be used in aerial triangulation then add the points
Points in ASCII file via menu Block > Edit Ground Control.
Alternatively, users can add and measure the GCP-s in the later step of the workflow i.e. in the
Triangulation step after the APM has been already performed.
Click to Import Control Points icon in upper left corner of the Edit Ground Control window
and browse to the location of the ASCII GCP-s file.
ASCII GCP file can contain header of rows commented out by the semicolon character (;).
94 Leica XPro
Block Preparation Workflow
In case the selected GCP-s file is in different coordinate system than the block, then pick the
GCP-s file coordinate system. GCP-s file will be transformed and copied to the block location.
Edit Ground Control window allows changing values for multiple rows / columns of the GCP
file in one edit operation. Activate the required rows and Right mouse click for changing the
values.
User Manual 95
Block Preparation
The sequence of the GCP list can be sorted by any of the column with clicking to the header of
that particular column.
Save the edited ground control data.
Save Block Upon Save, BlockPrep creates a new copy of all newly added Strips (Takes) within the "strips"
subfolder of the block and adds a reference to this Strip (Take) to the contents of the block file.
A Strip (Take) only then belongs to a block when it is referenced in the block file, regardless of
physical location.
BlockPrep will display a dialog with the progress of the copy while busy.
Export to Shapefile Block Preparation has option to generate ESRI shape file from the footprints of the Takes in an
already saved Block. Shape file will be created together with .prj file in Geographic WGS84
coordinate system.
Go to Block > Export to Shapefile and browse to the intended location for saving the shape.
Projected Systems
Oblique Mercator
Lambert Conformal
Swiss Projection
96 Leica XPro
Block Preparation Workflow
Others by request
Vertical Reference:
The coordinate library supports conversion between ellipsoidal and geoid vertical references.
Current Geoid support:
AUSGeoid98 Australia
JGD2000 Japan
LV98 Latvia
Others by request
The supported ASCII geoid file format is described at: ASCII geoid file format
Units:
Linear:
Angular:
Others by request
Ellipsoid:
User definable. Many predefined in file: ellips.dat
Ellipsoid Transformation:
User definable; up to 16 parameters transformations supported. Defined in files: 3_param.dat,
7_param.dat
User Manual 97
Block Preparation
Data Layout Although the block model file references all resources by name and relative/absolute path and
therefore a fixed structure is not necessary, there is a default layout:
|- project folder
|- strips
|- 1715
|- 1715.eop
|- 1715.stp
|- 1715PANN00A.fpt
|- 1715PANN00A.ctg
|- 1718
|- 1718.eop
|- 1718.stp
|- 1718PANN00A.fpt
|- 1718PANN00A.ctg
|- cam
|- ADS40_300017
|- v001
|- *.cam
|- misalignment.dat
|- dsm
98 Leica XPro
Block Preparation Workflow
The eye after the header line and the 2nd line geoid high in the lattice point is housed in the
following order.
The latitude line of the south edge (20 degrees in north latitude) from facing toward north the
latitude line of the north edge (50 degrees in north latitude) in order, in each latitude line
Being, Nisibata (120 degrees in east longitude) from Higasibata (150 degrees in east longitude)
geoid high numerical value being m unit in order, case
Paying/inserting it is done. The prescribed form of the data is as follows.
User Manual 99
Block Preparation
glamn = 20.0: Latitude value of south edge (20 degrees in north latitude)
glomn = 120.0: Nisibata's longitude value (120 degrees in east longitude)
dgla = .016667: Latitude interval (degree unit: However, it is made round)
dglo = .025000: Longitude interval (degree unit)
nla = 1801: Quantity in latitude line
nlo = 1201: Quantity in longitude line
ikind = 1 : The format identifier (here there is no especially meaning)
vern = ver4.0: Version of data
With the model, among the lands, the conformity processing for the data of geoid measurement
is not done
Concerning the remote island ' 999.0 ' m calls numerical value is buried, it is the invalid territory
of the data
Thing is meant.
Furthermore, in order to make direct access possible, as for each data being attached to one line
252 letter + (CR+LF) it is arranged. According to need, header line and so in the latitude line
most
In end of end line, blank is added.
example:
Aerial Triangulation
Triangulation The main goal of Triangulation is the reconstruction or adjustment of exterior orientation
Overview parameters (EOP), which consist of sensor positions and attitudes. For line scanner imagery,
each individual scan line features its own exterior orientation, which is observed with
GNSS/IMU - IPAS solution. Although this so-called a-priori solution can be used for Direct
Georeferencing of the imagery, the EOP can be improved by involving ground control and tie
points that connect adjacent takes and overlapping images into the Triangulation bundle
adjustment.
Triangulation also enables for solving for and regarding IMU misalignments and datum shifts.
Such a Triangulation is essential for high-resolution applications that assume high ground point
accuracy.
The Leica XPro Triangulation is based on the well-known ORIMA approach, which has been
significantly improved regarding both speed and flexibility. Leica XPro provides newly
designed analysis tools and automatically interacts with APM and targets image point
measurements where necessary to improve the triangulation accuracy.
With Leica XPro v4.2 and higher the measurement functionality is alternatively offered from
the XPro Triangulation interface. With Leica XPro v4.4 and higher also the initial APM run can
be started from XPro Triangulation interface.
In case the Triangulation adjustment has not been able to generate satisfactory results from the
input data and parameter settings, such analysis tools should support targeted parameter
adaptations as basis for a new run. Several runs may be carried out within one scenario but only
the actual parameter settings can be saved to disk.
Entirely different modeling approaches should be stored in different Scenarios in order to be
able to reproduce the results.
User has option to remeasure the tiepoints or ground control points in Triangulation.
Input Data - Block file (*.blf). This file will contain further information, such as, take files, which
then refer to EOP data, image point measurements, etc.
- Point Measurements:
- Initial image points, one file per image. These *.ipt files are created by APM or
can be interactively generated using manual measurement. They are referred to in
each take file and automatically loaded into the Triangulation application.
- Ground control points and check points (*.gpt, *.xyz). File name and location are
contained in the Block file. Ground points will be loaded after opening the block.
- Triangulation control parameters (*.trg)
Output Data - Adjusted EOPs; related take files are automatically updated with file names and
locations.
- Adjusted ground points (<original_name>.adj). This file contains the updated input
ground points as well as ground coordinates of all tie points.
- Adjusted image points, one file per image (<original_name>.adj).
Triangulation Start the XPro Triangulation window from Programs > Leica Geosystems > XPro >
Workflow Triangulation or click to the Triangulation button on XPro toolbar.
Open Block Open Block from File > Open Block menu.
Run APM General information about APM and APM settings can be found from Automatic Point
Matching and from Chapter 10 Appendix A - Automated Point Matching File Description .
APM can be started from the Measurement window of Triangulation interface after the Block
is loaded. The initial APM run cannot be started when Scenario is loaded - close the current
Scenario first.
In case not open already, start Measurement window from menu Window > Measurement.
Click on Run APM icon for starting the APM dialog window.
The preferred image bands for running APM are detected automatically. User can change the
band selection if required.
User has option to browse for selecting different APM Settings File.
Void Shape can be selected as option to not get tie points in the void area - browse to an ESRI
shape file.
Check in the Eliminate points based on Image Statistics option in case you have the Statistics
calculated from Data Preparation ( Image Pyramids and Statistics ) and you wish to not get
tie points in the water mask areas.
Click OK for starting Automatic Point Measurement.
In case the automatically detected image band selection for APM would have to be changed,
then click Band Selection icon on Measurement window for starting the selection widget.
Select Green bands for APM while processing ADS100 data.
Import Ground Control The measurement of GCP-s is suggested to be performed in the Block mode of Triangulation,
Points without going into a Adjustment Scenario mode - in that way as the GCP measurements will be
saved into the Block for all the future Scenarios.
Select Edit Ground Control for opening the dialog window.
Further details of how to import GCP-s with the Edit Ground Control dialog are provided in
Add Ground Control Points
The unmeasured GCP-s appear marked with yellow in the Triangulation footprint window.
Measurement in Triangulation interface provides the functionality to measure GCP-s and to re-measure tie
Triangulation points, in case required.
The point measurement is integrated into a dockable window within the Triangulation.
The dockable window pops up automatically when selecting a point to measure with Right
mouse click from the footprint window, but it can be reached as well from menu Window >
Measurement.
Each image patch of the selected bands is rectified on-the-fly to L1.
The patched are displayed in matrix:
each column corresponds to one image band used for the manual measurement
Labels are displaying the take name and image name correspondingly.
The location of the displayed images is given in the footprint view as a red box.
- Radiometric correction
- Switch correction to global for all images
- Minimum cutoff slider
- Maximum cutoff slider
- Zoom level
- Zoom In
- Zoom Out
- Point ID
There is ability to Select / Deselect all bands and also to Reset the selection back to default.
The default selection for ADS100 is:
GRNF26A
GRNN00A
GRNB19A
The three modes of Measure, Measure with Cross-correlation and Panning are exclusive.
Changing the modes and synchronizing can be performed also by keyboard shortcuts:
M - Change into Measure mode
A - Change into Measure with Cross-correlation mode
V - Change into Panning mode (Sliding)
U - Synchronize position in all views
Default
Setting Comments
value
auto_correlation_mode 1 Sets the Cross-correlation mode on/off; 1/0
auto_correlation_dsm_buffer 20.0 m Limitation of the cross-correlation search in epipolar
direction, accuracy (buffer) of the reference DEM;
>10.0 m dependent on the global- or user DEM used
auto_correlation_eripolar_buffer 15 pixels Limitation of the cross-correlation search left and
right of the epipolar line; > 5 (depending on the
orientation accuracy)
auto_correlation_window 7 pixels 7 to 9 pixels suggested
auto_correlation_threshold 0.7 > 0.0 ... < 1.0
auto_correlation_distinctness 0.1 Threshold for the minimum 'curvature' when
comparing the max correlation to its neighbors; 0.0 to
0.2 suggested
auto_correlation_sound 0 Sets the sound of the cross-correlation success on/off;
1/0
Image correction
The contrast of each image is dynamically stretched according to the content of the patch.
Navigation in images
Navigation in images is performed by
- sliding the image after entering into the Panning mode
- zooming in and out with the scroll wheel of mouse or by changing the zoom level from
the pull-down zoom window on the tool bar.
Image view
Yellow frame is displayed around the active image patch.
Measured locations are marked in two different ways:
- The thin red cross displays the new measurement.
- The doubled cross is centered on an existing measurement, as in case the
measurement window is opened for re-measuring.
Depending on whether the certain footprint view location is empty or having points the
possibilities are:
Right Click in an empty location - Measurement window will be triggered at that empty
location for measuring a new point. The ID of this new point follows the naming mask of:
Mpm_<date>@<time>.
Right Click on an existing point - the mouse cursor changes from arrow to cross when
reaching close to a point. Measurement window will be opened for verification or for re-
measuring the existing point.
- With selecting Remove Point the point will be completely removed without
opening the Measurement window.
Click in a location with dense point coverage. In case more than 10 points are present in the
location, then a message will pop up with asking to zoom in, in order to specify better which
item to select.
Click in a location with less than 10 points - the context menu is extended with showing the
list of available points. Certain point has to be picked to be re-measured or to be removed.
For loading the next point in the list into the measurement window click Go To Next Point.
In addition to the buttons on the Point List window toolbar, also the keyboard shortcuts can be
used for changing the point in the measurement window:
G - Go to Current Point
F - Go to First point
P - Go to Previous point
N - Go to Next point
L - Go to Last point
- Place the mouse cursor into the approximate location of the measurement and press
space bar on keyboard. Image gets zoomed in and the double cross disappears to
facilitate the measurement.
- With keeping the space bar pressed move the mouse cursor to the exact measurement
location and measure with Left Mouse Click. Release the space bar.
Create New Click the Create New Scenario button for creating a new adjustment scenario.
Adjustment Scenario
There is option for typing in a specific descriptive name for the Scenario. However, all the
Scenarios will be saved together with the creation date and time, thus the option of accepting
the default name by clicking OK is nicely valid.
Edit Ground Control In case the triangulation is performed with ground control there might be need for editing
ground control file for setting some of the GCP-s to Check Points or for changing the SD a priori
of the points, for instance.
Click to Edit Ground Control button on XPro main window for opening the ground control
editing window.
Edit Ground Control window allows changing values for multiple rows / columns of the GCP
file in one edit operation. Activate the required rows and Right mouse click for changing the
values.
Click Save and Close button for accepting and committing the changes.
Control Points and Check Points are shown in Triangulation interface as triangles and circles
respectively. In case the Control Points and Check Points are not of Full type, but of Planar and
Height type, then letters H and Z are added to the symbol respectively. Tie points are shown as
small circled dots on the image footprints.
Figure 8-27: GCP-s, Check Points and Tie Points on image footprints
Set Parameters for Bundle adjustment parameters are grouped to Basic and Advanced:
Bundle Adjustment - Basic adjustment settings: sigma0, GPS- and IMU parameterization
- Advanced adjustment settings: blunder elimination, variance components, etc.
Typically user operates with Basic Parameters.
GPS Parametrization
In case Ground Control is used in triangulation for compensating the datum deficiencies, then
one of the Datum types should be selected for GPS parameterization.
With Datum per Block adjustment is estimating one datum shift per triangulation block.
In case the triangulation block consists of image takes which are captured with multiple flight
Sessions, and sufficient Ground Control is used per area of each Session, then multiple datum
shifts can be estimated by selecting Datum per Session.
In case the triangulation block consists of image takes which are captured with multiple Sensors,
and sufficient the Ground Control is used per area of each Sensor, then multiple datum shifts
can be estimated by selecting Datum per Sensor.
While selecting Datum user has option to lock one or several of the parameters to not include
these in the adjustment. Locking Datum or Rotation retains the related transformation
parameters at 0. Locking Scale keeps the scale factor 1. User can get hint for whether to lock
certain parameters when observing the standard deviation of the parameters in the adjustment
protocol at Printout View. Locking certain parameters has also an impact on the number of
ground control points required for defining the datum. For instance, while locking Rotation and
Scale one would need only 1 full ground control point to solve for the datum parameters.
In the rare cases of having significant systematic errors in the position residuals of the
orientation fixes between the neighboring takes user should try adjustment with Drift for GPS
parametrization.
IMU Parametrization
In case the block has the configuration of allowing IMU parameterization, which is containing
at least two overlapping takes flown from opposite directions, then the IMU parameterization
per Sensor should be used.
In case the triangulation block consists of image takes which are captured with multiple flight
Sessions, each containing at least two overlapping takes flown from opposite directions, then
IMU Parametrization can be estimated per Session by selecting Session.
In the rare cases of having significant systematic errors in the attitude residuals of the orientation
fixes between the neighboring takes user should try adjustment with Take for IMU
parametrization.
Sigma0 a priori value should be adjusted during the bundle adjustment runs so that it would
match the value of Sigma a posteriori.
Triangulation is able to place the Orientation Fixes automatically according to the amount of
measured tie points in take. The default minimum number of Tie Points between Orientation
Fixes to be placed is 20. This number is commonly not changed.
Once the parameters are accepted, the bundle adjustment can be started.
Run Adjustment Click Run Adjustment button for starting the adjustment.
Once the adjustment run is finished, the results are imported with showing the Ground Cell-
based Analysis of the block.
Within a Scenario the adjustment can be run multiple times if necessary and/or desired.
Validate Results Leica XPro Triangulation offers helpful tools - whether for a quick validation or for a thorough
analysis:
- Triangulation results in main window controlled by the settings in the Layer Display
- Triangulation statistics shown in Statistics Display
- Protocol window with Printout View.
The following views can be switched On/Off for displaying form the
Layer Display
Layer Display controls the block overview given in the XPro Triangulation main window.
Information layers overlap in the main window according to the sequence of listing in Layer
Display view. The sequence of the layers in the list can be changed by users - most up in the
Layer Display list will be shown as the top layer in main window.
Right mouse click to the Quality rows in the Layer Display list is offering the Analysis
window with the slider for changing the quality criteria represented in the main window.
In similar way, with Right mouse click on the Residuals row in the Layer Display list, the scale
of the residual vector representation in main window can be changed.
Moving mouse over Ground Points, Orientation Fixes and Ground Cells in the Triangulation
main view opens additional information window. The information window can be
alternatively opened by Left mouse click on the point.
Statistics Display
Statistics Display presents the following adjustment results:
- Sigma0
- Variance Components
- Ground Points
- Orientation Fixes
- Additional Parameters
Point List
Point List holds the list of Ground Control Points, Check Points and Tie Points of the block with
their point ID, type, residuals and standard deviations.
Point List can be opened from menu Window > Point List or by clicking the Point List icon
on the toolbar.
Selected points in the Point List appear highlighted on the footprint view.
Point list lines are colored: yellow - not measured; blue - measured; red - blundered.
Point list has filters to facilitate block analysis and block adjustments with subsets of points.
Points can be filtered by type, residuals and by several other parameters. For adding the filters
click the Add Filter icon on the Point List window and select the required filter from the small
filter list window which pops up.
Each added filter appears with its parameters as a line in the upper part of the Point List window.
It is possible to add a filter twice for filtering out the range with less-than and greater-than
signs. Signs can be toggled by Left mouse click.
Note that by clicking the symbol at the end of each filter line the line disappears, but leaves the
filter active.
A highlighted selection of points in the Point List can be excluded from bundle adjustments runs
temporarily by clicking the Disable icon.
User has option to hide the Disabled tie points on footprint view by switching on the Hide
deactivated tie points check box on the Analysis Tool window - available by Right mouse click
on Triangulation Layer Display items.
Printout View
Click Show Protocol Window button for Printout View display.
Printout View is presenting the adjustment results in the format known from ORIMA.
Further Improvement In several cases the Quality achieved with bundle adjustment after the initial APM run already
of Quality meets the requirements.
Still, in cases the image orientation quality is required to be improved further then the following
techniques can be used:
- iterative Triangulation-Analysis-APM loop
- manual measurement of additional tie points.
In both techniques the areas to be worked on are the ones marked with the lowest Quality by the
GroundCBA.
Triangulation-Analysis-APM loop
Triangulation-Analysis-APM loop function is triggered as soon as the check box of Densify
Points if needed in Basic Parameters View is switched on. User specifies the number of
attempts given for software for achieving the targeted Quality in the Attempts field.
Densification with APM is performed in these Ground Cells for which the Quality has been
lower than the level user has specified with the Densify Points Threshold in the Advanced
Parameters view.
Triangulation-Analysis-APM loop starts with the click to the Run Adjustment button.
The tie points from the APM looping get imported to the block only in case they have led to
improvement of the Quality level.
User can analyze the results of looping runs in the Statistics Display.
Adjustment run (see Run Adjustment ) has to be performed after the re-measurement in order
to validate the improvement.
Alternatively, user has the option of measuring the additional tie points manually in
Measurement tool, see Chapter 6 Measurement .
The triangulation block has to be opened in Measurement and the IPT files containing the
existing APM and GCP measurements have to be imported.
Write Out Adjusted After the required accuracy for the triangulation block is achieved the adjusted orientation
Orientation should be written out for all the image bands.
Click Write to Block button for writing the adjusted orientation.
Self-calibration
Self-calibration is provided in XPro v6.1 as beta functionality. ADS workflow is not yet
triggered to handle the changed calibration files automatically in Product Generation
after the adjustment with self-calibration switched on.
XPro Triangulation provides the possibility to estimate camera parameters during the bundle
block adjustment. The main window offers a new scenario tab called Calibration.
User can switch on the self-calibration, by checking Use Self-Calibration check box.
1. The first group is used to handle global effects like principal distance (scale), principal point
(shift) and lens distortions (1 to 5 on Figure 8-43: Self-calibration parameters below). These
effects apply to all sensor lines.
2. The second group of parameters is used to handle shift and rotation of individual sensor lines.
This group becomes active as soon as a parameter from the first group has to be estimated. There
is no GUI to control it directly.
3. The third group - Use Node Correction (6 on Figure 8-43: Self-calibration parameters below)
is used to handle local systematic effects on each sensor line
State of all the sliders in the parameter group can be changed by clicking on icons:
Mathematical model
The new self-calibration capability allows switching on the estimation of the internal
parameters of the camera according to this model:
The shift and rotation parameters will be estimated as soon as any of the other parameters
is switched on. There is no direct control for the user over shift and rotation parameters.
The estimation is done for all looking angles together. There is no possibility to control a
looking angle independently.
The Nodes Correction computes for all looking angles one unique set of parameters.
Self-calibration Output
Always verify the correlation between parameters in the printout file. A high correlation
coefficient indicates a dependency between parameters and is a sign of over
determination. Over determination should be avoided as it slows down or prevents the
convergence.
The printout file provides detailed values for the estimated parameters their standard
deviation, reliability and correlation. Check those values before writing the results out.
In order to get the adjustment results written out the output folder for the new calibration files
has to be specified in the xpro.ini file:
Self-calibration is provided in XPro v6.2 as beta functionality. ADS workflow is not yet
triggered to handle the changed calibration files automatically in Product Generation
after the adjustment with self-calibration switched on.
For using the new adjusted calibration for Product Generation it is required to copy the
Adjusted calibration files from the output folder to the Sensor Calibration location (see
Sensor calibration ) for replacing the Original calibration.
In next XPro versions this manual operation will be not required and the new calibration
files will be not written into the location specified in xpro.ini any more, but maintained
with the block instead.
Export Adjusted Triangulation offers an option for exporting adjusted ground points from Adjustment Scenario
Ground Points into ASCII text files.
Select Export Ground Points from Scenario menu.
Browse the location for the text files. Two files will be exported, containing the point numbers
and their adjusted ground locations in the coordinate system of the Block:
adjustedGroundControlPoints.txt and adjustedGroundTiePoints.txt.
Block Check tool Block Check tool helps XPro users to evaluate whether the image orientation accuracy of block
fulfills the requirements to the upcoming DSM extraction step.
Two DSM-s extracted from the two neighboring overlapping flight lines match in the limits of
the image orientation accuracy. Block Check performs the extraction of two DSM-s in the user
defined location points in the overlap area and compares the height difference. This evaluation
with Block Check would give the confidence of image orientation being sufficiently accurate
and thus helps to ensure the expected DSM product accuracy.
Alternatively, users can collect the points for the regions of interest (ROI) also by QC Viewer.
Loading the L1 OTF images of the flight line, moving the cursor to the region of interest to the
correct surface height and collecting the coordinates with the help of Right mouse click from
the viewer status bar will buffer the location for pasting into the Point File.
The height of the ROI location in the Point File would have to be close to the correct
surface height. It is recommended to select ROI-s in flat areas and in areas without trees
and water bodies.
While loading the Point File to the Block Check tool, user interface offers the option to
transform the Point File coordinates into the coordinate system of the Block.
Generate DSM-s
Footprints and ROI-s appear in the Block Check view after the Block and Point File are loaded.
Only these points are shown and marked as ROI-s which are located in the overlap areas of the
Takes.
Block Check user interface organizes ROI-s and Overlaps into two tables below the footprint
view.
Click to the Generate DSMs button for starting the DSM extraction in the ROI-s.
DSM generation supports HPC processing with Condor setup.
DSM tiles are extracted as about 500 by 500 GSD-s large areas around the ROI centre points.
Analyze DSMs
After the DSM run the block is ready to be analyzed - the Quality Marker information is
automatically populated into the footprint view.
Analyze button would have to pressed for the cases after a different BlockCheck folder is
selected which already contains the DSM tiles from the previous extraction run.
Quality Marker size and quality threshold value can be adjusted by moving the two sliders
in the Block Check window.
The difference between the DSMs in certain ROI is populated into the list below the footprint
view after clicking on the Quality Marker of the ROI.
A click to the camera icon in the lower right corner of the footprint view is saving the
screenshot of the footprint into the BlockCheck folder.
Product Generation
Product Product Generation delivers stereo viewable images (L1) and ortho images (L2) with using
Generation image rectification.
Overview Starting from Leica XPro v6.0 also the DSM Extraction is started from Product Generator user
interface.
XPro DSM Extraction is providing dense point clouds from ADS imagery. The extraction
approach used is Semi-Global Matching (SGM), which is suited for high-performance and
high-resolution DSM computation.
Running of XPro DSM Extraction sets higher requirements for the system memory than any
other of the XPro applications - 8 GByte or more RAM is required.
Product Generation is a time consuming process, the use of distributed HPC environment is
highly recommended.
Output data rectified images (*.tif with *.ads); their georeference files - support files (*.sup),
orientation files (*.odf, *.odf.adj, if applicable) for L1 products and *.tfw files for L2
products
Product Start the Product Creation from Programs > Leica Geosystems > XPro > Product Generator
Generation or click to the Product Generator button on XPro toolbar.
Workflow
Figure 9-1: Start Product Generator
Product Generator user interface brings up the Footprint view with the additional views for
listing Takes, Digital Elevation Models, Areas of Interest and Jobs.
Select Block Select Block from File > Open Block ...
Multiple Blocks can be loaded into Product Generator.
The Takes of the Block get listed in the Take view and appear at the Footprint view.
User can activate/deactivate Takes for defining the Product Generation Jobs by clicking the
check box in the Take list view.
Open AOI In case there is intention to generate products from parts of the Take areas, then add an Area of
Interest (AOI). Select from File > Open AOI and browse to a ESRI shape file.
The shape files could be created with Drawing in XPro QC Viewer or could come from other
sources.
Coordinate system of Shape files is defined in the .prj file, which usually accompanies the .shp
file.
In addition to WGS84 Geographic also UTM and Grid State Plane Coordinate
Systems (both in 2D) are supported.
In case the .prj file is missing then WGS84 Geographic is assumed.
User can activate/deactivate a loaded AOI for defining the Product Generation Jobs by clicking
the check box in the Areas of Interest list view.
Open DEM User can add Digital Elevation Models in addition to the worldwide gTopo and SRTM by
browsing from File > Open DEM.
The boundary of the worldwide DEM-s is shown in Product Generator as bounding box around
the loaded Block(s) only.
Activate/deactivate a loaded DEM for defining the Product Generation Jobs by clicking the
check box in the Digital Elevation Models list view.
Edit Product User creates product generation jobs with the help of wizard by selecting a combination from
Templates the existing Product Templates and specifying additionally the Project Settings.
Product Templates are for Product Settings, Radiometric Settings and Output Settings. Output
Settings are kept separately for image products and for DSM products.
Leica XPro installation comes with a set of predefined Product Templates, however, in most
cases users wish to define and save according to their needs new product templates.
Product Templates are saved in the .xml files in folder ...\etc\producttemplates\ at XPro
installation - typically at:
C:\Program Files\Leica Geosystems\XPro\etc\producttemplates\
Window pops up with the list of already saved product setting templates.
Click to the green Add new template icon below the list for adding a new Product Settings
template. Give a meaningful name to the new template.
Define the product setting properties of: Type, Bands, Looks, Channel, Sampling, HiRes.
Click Apply to get the newly defined template added to the list.
User can edit the already defined Product Setting templates in the list or also remove any of the
templates.
In specific cases, as snow covered surfaces, using NIR image bands as input can be preferred.
Thinning Rate
In addition to the main product defined in Extraction Mode DSM extraction outputs also the
thinned point cloud. Point cloud Thinning Rate options are:
- Mild about 95% of points are thinned out
- Medium about 97% of points are thinned out
- Aggressive about 99% of points are thinned out
Extraction Mode
Select one of the Extraction Modes:
- Quick 8:1 uses image minification levels and does not go to matching on 1:1 image
- Intermediate 4:1 uses image minification levels and does not go to matching on 1:1
image
- Intermediate 2:1 uses image minification levels and does not go to matching on 1:1
image
- Full Resolution for applications as orthorectification, where DTM is targeted after
the point cloud treatment
- Full Resolution (Urban) for applications as city modeling, where DSM is targeted
Quick mode can be useful for overview DSM-s - the processing time is several times shorter
and density of the output point cloud is lower. Quick mode uses 8:1 image pyramid for matching
and minifies the point output to 16:1.
Full Resolution uses 1:1 image for matching and optionally minifies the point output to 2:1
when specified so in DSM Output Settings Template (see Edit DSM Output Settings
Template ).
Full Resolution (Urban) takes special care for not skipping the high features with relatively
small footprint (poles, towers) for matching.
User can add a new template or edit the already defined Radiometry templates in the list or also
remove any of the templates.
Define the radiometric properties of: Radiometric Profile, Base Correction, Extended
Correction, Sharpening, TTC (Tonal Transfer Curve - from GPro workflow), Gamma, NIR
Scaling.
Radiometric Profile
When user selects Radiometric Profile, then the radiometric properties are used from the profile
and not from the other fields of the template.
For the field Radiometric Profile user is able to insert a profile or, alternatively, a folder where
the radiometric profiles have been saved. The folder would have to contain the profiles with the
matching Take names - as saved from QC Viewer Image Adjustment step (see Adjust the
image ).
The .bpf file from GPro has to be changed in order to use it in XPro. Instead of the band
definition 0, 1, .. the real CCD names have to be used e.g. instead of
BREAK_POINTS band=0 XPro accepts BREAK_POINTS band=GRNN00A.
It is recommended to verify and convert the GPro TTC files to XPro Radiometric Profiles in
Image Adjustment step.
Click Apply to get the newly defined template added to the list.
User can add a new template or edit the already defined Image Output templates in the list or
also remove any of the templates.
Define the image output properties of: Output Format, Bit Depth, Tile Size [pixels], Max TIFF
Size [MB], Max TIFF Dimensions [pixels], Overlap Tiles [number of tiles], Clipping on Both
Sides [%], Generate Footprints.
Click Apply to get the newly defined template added to the list.
User can add a new template or edit the already defined DSM Output templates in the list or also
remove any of the templates.
Define the DSM output properties of: RGB- and FCIR Encoding to Info Cloud File, Minify Info
Cloud, Generate Raster Product (5-band tiff image), Output to LAS or to LAZ Format, Generate
TerraScan Trajectory, Sidelap Clipping, Keep Vertical Surfaces, Classify Vegetation, Generate
Footprints.
RGB- and FCIR encoding require Image Statistics for NIR, RED, GRN and BLU image
bands from Data Preparation step, as colorizing uses Atmospheric and BRDF correction.
Classify Vegetation
Users have option to Classify Vegetation based on NDVI (Normalized Difference Vegetation
Index) in the output LAS files. Classes 3 - Low vegetation and 5 - High vegetation
The default values of the setting are: 3 - Low vegetation > 0.3 and 5 - High vegetation > 0.5.
Click Apply to get the newly defined template added to the list.
Create a Product Product generation Job has to be built as a combination of the existing Product Templates. User
Generation Job can build several Jobs which will be listed in the Job list window before executing them.
Click to Generate button starts the Job building wizard.
Wizard walks through the Product Template pages - user has to select a template from the list
and then go the next page. New Job gets built when user finishes with the last wizard page which
defines Project Settings.
User has options to go back to the previous wizard page by clicking the back arrow in the upper
left corner of the window or to cancel the Job creation.
On the last wizard page user is asked to define the Project Settings: Reference System, Area of
Interest (AOI) and Exclusion as ESRI shape file, Ground Sample Distance (GSD), Elevation
Source, Minifications format, Output folder, product name Prefix.
Elevation Source
Specify the elevation source for product. The options are:
- Select a DEM - Browse to a DEM. DEM-s in IMG and TIFF format are supported.
The IMG and TIFF DEM-s would have to be 32 bit floating point single band images.
TIFF DEM-s would need to be accompanied with TFW world files.
- Global DEM - SRTM or GTopo global elevation file gets used - according to the
settings in xpro.ini (see Configure XPro Initialization file)
- DEM per Take - All the DEM files (.img or tif) for the list of takes have to be located
in one folder which user selects. The DEM files have to be named exactly according
to the corresponding takes (e.g. <take_name>.stp> corresponds to <take_name>.img)
- DEM from Block - Select one of the DEM files defined in the block. DEM-s in IMG
and TIFF format are supported. The IMG and TIFF DEM-s would have to be 32 bit
floating point single band images. TIFF DEM-s would need to be accompanied with
TFW world files.
- Constant Height - User is asked to type in the height
- Average Take Height - The mean terrain height of each Take will be used. The mean
terrain height value is written into the .stp file in the georeferecing process in Data
Preparation - calculated based on the Take footprint and global DEM.
Check in the Create Stereo Block option in case creating Stereo Block file for ArcMap Stereo
Analyst for ArcGIS extension (SAFA) is intended.
Users can Delete and Edit the Jobs by clicking the icons above the Jobs list.
The defined Workspace with the selected Block(s) and created Job(s) can be saved for future
use by selecting File > Save Workspace As ...
Execute Jobs Click the Execute Job icon for submitting the listed Job(s) to product generation.
Dialog window opens asking whether the Job has to be processed Locally or submitted to
HTCondor.
Process starts and delivers the products to the output folder location.
The logs of the process are gathered into the logs folder of XPro installation - typically at:
C:\Program Files\Leica Geosystems\XPro\logs\
Rectifier Monitor Rectifier Monitor enables to monitor the jobs submitted to HPC cluster.
Launch the Rectifier Monitor from Programs > Leica Geosystems > XPro > Rectifier
Monitor or click to the Rectifier Monitor button on XPro toolbar.
Minifier Minifier is a tool for submitting the L1 and L2 image pyramid generation jobs to HPC cluster.
Start the Minifier from Programs > Leica Geosystems > XPro > Minifier or click to the
Minifier button on XPro toolbar.
Click Add button and browse for the L1 or L2 images for which the image pyramids are
required.
Options button will open the window for defining the configuration file, job submission
directory and the runner .bat file.
The guidance for setting up the HPC environment is found at Chapter 11 Appendix B - HTC
Setup .
L0 Minifier
L0 Minifier tool allows to create L0 statistics and image pyramids outside of Data Preparation.
The minification jobs are submitted to the HPC cluster.
Start the L0 Minifier from Programs > Leica Geosystems > XPro > MinifierL0.
Product Export Tool Product Export Tool provides assistance for exporting the L1 products to a new location on
network- or on external drive with maintaining the correct data paths in the .sup file, which is
essential for using the image orientation in the new location.
Similarly, the tool can be used for data import and edit - modifying the data paths in the .sup
files with pointing to the intended data locations.
Product Export Tool has option to slice imagery - cutting L1 images in ground- and image
space.
Start the Product Export Tool from Programs > Leica Geosystems > XPro > Product Export
Tool.
Click Add button for selecting the image products for Export, Slice or Edit.
The selected images will be added into the product list.
Image names can be modified during the Export, Slice or Edit according to the settings in the
the Image Name dialog window. Click Pattern button for opening the Image Name window.
Select the Image Location folder for Export, Slice or Edit on the main window of Product
Export tool.
Option for selecting separate locations for Orientation and Sensor Calibration is offered after
checking off the Use Image Location for all files check-box.
Sensor Calibration location is the upper folder containing one or several subfolders per
different ADS sensor heads.
Highlighting certain product(s) in the list works for Remove from List.
All products in the list, independent on the highlighting, will be further worked on after clicking
the Next button.
Edit
In case the products in the list had no valid reference to the image-, orientation- and calibration
files in the .sup file, then only the Edit mode becomes available after user has clicked the Next
button in the Product Export window.
Clicking Process button will edit the .sup files according to the selected data locations.
Export & Slice offers options for cutting L1 images in ground- or in image space.
While slicing in Image Space the units for the input Upper Left Corner, Size and Overlap are
in pixels.
Check in the Repeat Pattern box in case the input image(s) are required to be cut into multiple
slices.
While slicing in Ground Space the units for the input Anchor Point, Size and Overlap are the
same as for the Coordinate System which user selects.
Check in the Repeat Pattern box in case the input image(s) are required to be cut into multiple
slices.
Slicing in Ground Space provides stereo-viewable image tiles with 100% overlap.
For the Takes not flown in parallel to the coordinate system axis the sliced images are cut with
bounding area i.e. the area of the slice is larger than specified in the Size box.
Slicing supports distributed processing in HPC environment.
At the end of the process the sliced images together with shape files and orientation files are
populated into the predefined folder(s).
APM File
Description
This Section contains a description of different files that are used during
Automated Point Matching (APM). At times, it may be necessary for you
to edit the Tie Point Pattern files to achieve the best ties between your
ADS images.
The Level 0 (L0) APM Settings File (apm_settings.txt) is used for fine
tuning APM on L0 ADS images. Changes to the file are made by hand
editing the contents to suit the needs of the project. Care must be taken
not to introduce errors into the file that might cause problems in reading
the file.
Value Ran
Keyword Unit Default Description
Type ge
PATTERN_SAMP_START Double Percent 0-100 10 Across line start position of the first point to
find.
PATTERN_SAMP_REPEAT Double Percent 0-100 20 Across line repeat positions for each row of
lines to find.
PATTERN_SAMP_USER Multi- Percent 0-100 Across line positions for each row of lines to
Double find, specified by the user (in percent), e.g.
PATTERN_SAMP_USER 10.0 20.0 50.0 80.0
90.0
When this field is present, the
PATTERN_SAMP_START and
PATTERN_SAMP_REPEAT will be ignored.
PATTERN_LINE_START Integer Pixels >0 200 Along line start position of the first pixel to
find.
Value Ran
Keyword Unit Default Description
Type ge
PATTERN_LINE_REPEAT Integer Pixels >0 500 Along line repeat distance to search for
points until the end of the line. ADS APM will
automatically adjust this value internally if
the value given is too large and thus not
provide the required amount of points to
form a strong photogrammetric solution.
The strongest geometry for ADS points is to
have three columns of points between
projection centers, if the value given here
does not meet this criteria, the software will
adjust this automatically.
PATTERN_LINE_USER Multi- Percent 0 - 100 Along line positions for each set of sample
double patterns to find, specified by the user (in
per-cent of total line length), e.g.
PATTERN_LINE_USER 10.0 30.0 50.0 70.0
90.0
INLINE_INIT_MASTER_SE Integer Pixels >0 100 This is the width and height of the initial
ARCH_SIZE search area around the seed point on the
master image to locate an interest point.
INLINE_TARG_TEMPLATE_ Integer Pixels >0 24 This is the size of the image template given
SIZE in pixels.
INLINE_RMS_CUTOFF_PE Double Unitless >0 2.0 Represents gray value differences between
R_PIXEL the master and target templates.
INLINE_PARALLAX_CUTOF Double Pixels 0 3.0 Parallax threshold used for discarding points
F while finding points in the same strip.
Value Ran
Keyword Unit Default Description
Type ge
INLINE_EXPECTED_PARAL Integer Pixels >0 3 The a priori parallax error. This affects the
LAX search width and minification logic for the
target area. Increasing this value will
increase the number of pixels searched (at
the price of speed). Increase this value (and
the cutoff value) when large initial
parallaxes are observed.
TRANSFER_TEMPLATE_SIZ Integer Pixels >0 10 Size of the image template used for transfer
E operation.
TRANSFER_CORRELATION Double Unitless 0-1.0 0.6 Threshold correlation value to accept points
_CUTOFF during transfer.
TRANSFER_PARALLAX_CU Double Pixels >0 3.0 Parallax threshold used for discarding points
TOFF during a transfer operation.
ALLOC_MAXSIZE Integer Bytes >0 4000000 The largest allowable buffer memory
allocation size to be created for reading
image buffers.
INTEREST_WINDOW_SIZE Integer Pixels >0 7 Interest operator window size (value should
be an odd number).
INTEREST_CIRCLE_CUTOF Double Unitless 0-1.0 0.75 Interest operator "roundness" cutoff for
F determine best interest point.
Value Ran
Keyword Unit Default Description
Type ge
APM_MODE String FULL, FULL This tells the APM operation to find and
INLINE transfer points. Allows for transfer of points
_ONLY, only, find new points within ADS Lines only,
TRANS or perform both operations.
FER_O
NLY
ELEV_MODE String DEM, DEM This elevation mode is used to select the
MANUA method which APM will use to set the terrain
L height seed point for finding points. Valid
entries are DEM or MANUAL. The DEM
setting will force ADS APM to use the DEM
specified by the user in the XPro
initialization file or alternatively with the
DEM_NAME. Leica XPro installation supplies
a global JPTF DEM with grid spacing of 30
arc seconds (derived from USGS GTOPO30
dems). Accuracy varies by location but is
typically better than 100m.( MANUAL will
force the ADS APM to use elevations defined
within this settings file.
DEM_ACCURACY Double Proj >0 50 This is a scalable value that allows you to set
Dist the perceived accuracy of the DEM. Since
Unit the JPTF DEM is roughly 1 km spacing, not
all regions on the surface of the earth can be
represented very well. For instance,
mountainous regions with many valleys and
fast changing terrain will not be described
very well with a coarse JPTF DEM. This value
allows the APM to expand the search along
the epi-polar line for points. A larger
DEM_ACCURACY value will open a longer
search space along the epi-polar line to
search for points. A larger value will also
generate more samples for the APM to test,
thus slowing down the overall APM process.
For flat terrain this value can be set lower,
but for mountainous regions, this might be
set higher to aid in finding more points.
INLINE_MATCHMODE Integer Integer 1,4 1 This is the algorithm used to match points.
1 = Conventional epi-polar constrained
cross-correlation; 4 = Hierarchical search
cross-correlation
Value Ran
Keyword Unit Default Description
Type ge
TP_FILE_FORMAT String IPT, IPT IPF is the old SOCET SET image point format
IPF, (which can be imported directly into Orima).
BOTH IPT is the new format in XPro.
APM_MODE FULL
This is will always be set to FULL for running APM from within XPro. This
tells the APM operation to find and transfer points.
ELEV_MODE DEM
This elevation mode is used to select the method which APM will use to set
the terrain height seed point for finding points. Valid entries are DEM, or
MANUAL.
The DEM setting will force ADS APM to use a USGS GTOPO30 DEM. The
USGS GTOPO30 DEM is coarse, 30 arc second, grid of points with global
coverage. These are freely downloadable and usable from:
http://edc.usgs.gov/products/elevation/gtopo30/gtopo30.html
MANUAL will force the ADS APM to use elevations defined within this
settings file.
DEM_NAME
Leica XPro installation supplies a global JPTF DEM. gtopoDem_ell.jptf unifies all
GTOPO30 dems into 1 file giving the global coverage. APM will use the default
DEM specified in the XPro initialization file. Still, this value can be used to override
and identify the full path of the JPTF dem file.
DEM_ACCURACY 100
This is a scalable value that allows you to set the perceived accuracy of the
DEM. Since the GTOPO30 DEM is roughly 1 km spacing, not all regions on
the surface of the earth can be represented very well. For instance,
mountainous regions with many valleys and fast changing terrain will not be
described very well with a coarse GTOPO30 DEM. This value allows the APM
to expand the search along the epi-polar line for points. A larger
DEM_ACCURACY value will open a longer search space along the epi-polar
line to search for points. A larger value will also generate more samples for
the APM to test, thus slowing down the overall APM process. For flat terrain
this value can be set lower, but for mountainous regions, this might be set
higher to aid in finding more points.
PATTERN_SAMP_START 5
Across line start position of the first point to find, this value is given in
percentage.
PATTERN_SAMP_REPEAT 20
Across line repeat positions for each row of lines to find, this value is given
in percentage.
PATTERN_LINE_START 500
Along line start position of the first pixel to find, this value is given in pixels.
PATTERN_LINE_REPEAT 500
Along line repeat distance to search for points until the end of the line. ADS
APM will automatically adjust this value internally if the value given is too
large and thus not provide the required amount of points to form a strong
photogrammetric solution. The strongest geometry for ADS points is to
have three columns of points between projection centers, if the value given
here does not meet this criteria, the software will adjust this automatically.
INLINE_INIT_MASTER_SEARCH_SIZE 100
This is the size of search area at the seed point around the epi-polar line,
given in pixels.
INLINE_TARG_TEMPLATE_SIZE 15
This is the seed size of the target template given in pixels.
INLINE_L1_ELEV 1000
If the ELEV_MODE from above is set to MANUAL then this is the L1
rectification elevation used within the ADS APM to rectify the master and
target patches. This value is given in meters.
INLINE_MIN_ELEV 300
If the ELEV_MODE from above is set to MANUAL then this is minimum
elevation used for the epi-polar search. This value is given in meters.
INLINE_MAX_ELEV 1200
If the ELEV_MODE from above is set to MANUAL then this is maximum
elevation used for the epi-polar search. This value is given in meters.
INLINE_RMS_CUTOFF_PER_PIXEL 1.5
Represents gray value differences between template and slave on a pixel
ratio. This value is unitless.
INLINE_CORRELATION_CUTOFF 0.7
Cross-correlation threshold for inline matches. Values are unitless (0-1).
INLINE_EXPECTED_PARALLAX 3
The a priori parallax error. This affects the search width and minification
logic for the target area. Values are given in pixels.
INLINE_PARALLAX_CUTOFF 5
Parallax threshold used for discarding points while finding points in the same
strip. Values are in pixels.
TRANSFER_CORRELATION_CUTOFF 0.7
Threshold correlation value to accept points during transfer. Values are
unitless (0-1).
TRANSFER_PARALLAX_CUTOFF 5
Parallax threshold used for discarding points during a transfer operation.
Values are given in pixels.
TRANSFER_TEMPLATE_SIZE 15
Size of the template used for transfer operation. Values are given in pixels.
TRANSFER_INLINE 0
This option is used when adding bands to a strip and transferring points to
these new bands without having to re-run the point finding operation on the
entire strip. Setting value to 1 will allow the existing points to be transferred
to newly added band in the same strip. Value of 0 is default and for the
normal workflow.
RECTIFY_SUBBLOCK_SIZE 8
The L1 subpatch to be rectified, unit is pixels.
ALLOC_MAXSIZE 4000000
The largest allowable buffer memory allocation size to be created for
reading image buffers, values is in bytes.
INTEREST_WINDOW_SIZE 7
Interest operator window size, the value is in pixels.
INTEREST_CIRCLE_CUTOFF 0.75
Interest operator "roundness" cutoff
APM_SETTINGS
;; apm settings file Nov 26
APM_MODE FULL
ELEV_MODE DEM
DEM_ACCURACY 50
PATTERN_SAMP_START 10
PATTERN_SAMP_REPEAT 40
;; PATTERN_SAMP_USER will override PATTERN_SAMP_START and
PATTERN_SAMP_REPEAT
PATTERN_SAMP_USER 5.0 15.0 50.0 85.0 95.0
PATTERN_LINE_START 500
PATTERN_LINE_REPEAT 500
;; PATTERN_LINE_USER will override PATTER_LINE_START and
PATTERN_LINE_REPEAT
PATTERN_LINE_USER 10.0 30.0 50.0 70.0 90.0
POINT_CLUSTER 0
INLINE_INIT_MASTER_SEARCH_SIZE 100
INLINE_TARG_TEMPLATE_SIZE 15
INLINE_L1_ELEV 1000
INLINE_MIN_ELEV 400
INLINE_MAX_ELEV 1000
INLINE_RMS_CUTOFF_PER_PIXEL 1.5
INLINE_CORRELATION_CUTOFF 0.7
INLINE_EXPECTED_PARALLAX 4
INLINE_PARALLAX_CUTOFF 6
TRANSFER_CORRELATION_CUTOFF 0.7
TRANSFER_PARALLAX_CUTOFF 7
TRANSFER_TEMPLATE_SIZE 15
TRANSFER_INLINE 0
SUBPIXEL_SEARCH 1
RECTIFY_SUBBLOCK_SIZE 4
ALLOC_MAXSIZE 4000000
INTEREST_WINDOW_SIZE 11
INTEREST_CIRCLE_CUTOFF 0.75
Introduction A HPC Cluster consists of at least 6 computers. One will be the server, one submitter and four
nodes. It is recommended to have a high performance graphics card in the submitter for QC
applications.
Server configuration:
- NAS System - 4 GB RAM (8 GB suggested)
- hard drive for OS and SW
- RAID for data
- 10Gb LAN or better
- Server 2008 R2
- .Net Framework 2.0 SP1
- HTCondor 8.0.6 (or newer stable release)
- Leica XPro 6.x
- CLM Administrator Server (License Manager Server)
- Share drive for SW (Leica XPro)
- Share drive(s) for Data
Node configuration:
- 4 GB RAM or more (12 GB RAM for XPro DSM or more)
- hard drive for OS, dual core processor
- 10Gb LAN or better
- Windows 7 x64 or Server 2008 R2
- Microsoft .Net Framework 2.0 SP1
- Microsoft Visual C++ 2008 Redistributable Package (x64)
(vcredist_x64.exe can be downloaded from Microsofts webpage)
- Microsoft .NET Framework 4 (dotNetFx40_Full_x86_x64.exe)
- HTCondor 8.0.6 (or newer stable release)
- CLM Activation Service (clm-activation-service-x64.msi)
- CLM Administrator Local (License Manager Local)
Submitter configuration:
- 4 GB RAM or more
HTCondor Manual
Current manual of your HTCondor installation can be found in different formats at:
http://research.cs.wisc.edu/htcondor/manual/
Activating Windows
Windows needs to be activated on all nodes.
If you need to activate the system after an new installation go to:
Control Panel-> System->Change Product Key
and type in the key for the current system (the one used during installation).
HTCondor
installation
instructions on
Windows
Prerequisites
P1
Use Windows Server 2008 (R2, x64 recommended) to use as the cluster master. This machine
is also used as the shared installation location for Leica XPro that all the submitters and cluster
nodes use. Windows XP is not recommended as it has a limit of 10 concurrent network
connections. This machine must have reliable network connectivity and we recommend
trunked connections for redundancy. This is also an ideal machine for the license server. For our
examples we will call this machine cluster-master.leica.com
P2
Windows 7 x64 or Server 2008 R2 for submission nodes. Please have a list of the machine
names and IP addresses. For our example, we shall call these machines cluster-
submitter.leica.com
P3
Windows 7 x64 or Server 2008 R2 for worker nodes. Please have a list of these machine names
and IP addresses. For our example, we shall call these machines cluster-worker1.leica.com
P4
All machines must be part of an active directory. This is important to eliminate authentication
issues.
P5
Proper DNS service functioning on the network.
P6
A list of all data shares (both drive letters and UNC names) that the production environment
uses and needs to be accessible to the cluster. A single user account and password that has
read/write permissions to all the above shared folders is required. We strongly suggest using
DFS (Distributed File System), to simplify this to a single DFS root share to be mapped by all
production users.
P7
For the ease of setup and maintenance all machines in the cluster should have RDP (Remote
Desktop Protocol) turned on.
P8
On the cluster-master machine setup a share called XPro. Set the permissions so that the
account in P6 can read/write from this share. If you are using DFS you can mount this share as
a DFS leaf with a name such as cluster_software
P9
Download the latest stable HTCondor version (8.0.2) from the HTCondor website
(http://research.cs.wisc.edu/htcondor/downloads) and store it in the share created in P8.
P10
An account with administrator rights on all cluster machines to use for installation of
HTCondor.
IT infrastructure
testing
DNS testing
T1
From the machine identified as the cluster master open a command line window and confirm
that it can ping the submitters and worker nodes by DNS name:
Repeat for all worker nodes and all submitters and ensure the name resolves to the correct
IP!
T2
Login to worker nodes and confirm they have correct DNS resolution for the cluster master:
T3
Login to submitters nodes and confirm they have correct DNS resolution for the cluster
master:
We are now confident that the DNS resolution is correct. If you had any errors above or
timeouts getting a response, there is no point in continuing as HTCondor WILL NOT work
reliably.
T4
Edit the attached "drive_map.bat" batch file using the information from P6 and put it in the
shared folder you created in step P8.
T5
From each worker and submitter node execute the batch file and ensure the shares from P6 are
accessible for read and write.
We are now confident that the nodes and submitter can map the drives required.
Installation for Master- In case users would be ready to set up the environment in the way that full XPro is
and Submitter Nodes installed on Submitter Nodes, then the requirement of using the UNC paths is not there.
An other way to add local shares is to add the machine to the Local Internet at the Security tab.
Help can be found at:
http://support.tabs3.com/main/R11124.htm
On Server2008 turn off UAC. Go to Start > Settings > Control Panel > User Accounts
1. Install XPro into the local default installation folder (e.g. C:\Program Files\Leica
Geosystems\XPro).
2. Edit the xpro.ini to set condor_temp_dir = C:\XPRO_Temp and point to the share letter used for
the Calibrations folder location = s:\calibrations.
3. Rename and edit the xpro_condor_runner_OS_ARCH.bat files that were created by the
installer. You need to modify these by pasting the contents of the drive_map.bat file into
these files so that they can correctly map the data.
Newer Condor versions use OpSys Windows to identify the operating system and ARCH
X86_64 for both AMD and Intel 64-bit processors or INTEL for Intelx86 (Pentium, Xenon,
etc.).
The previously delivered bat files were removed from the installer:
xpro_condor_runner_WINNT61/WINNT60/WINNT52/WINNT50_INTEL/X86_64.bat
4. Start Leica XPro to ensure it works on the master (to ensure no missing DLL errors or similar).
5. Install HTCondor.
Add the bin directory of your HTCondor installation to the System PATH variable
- Restart the HTCondor service (net start condor or condor restart, condor_startd)
The HTCondor service might take several minutes until it starts.
- use command condor_status to check the number of virtual machines. After editing the
condor_config file there should be only one machine listed per node. If up till now only the
server is configured AND the server is not used as a node, then no machines will be listed.
8. Use the condor_store_cred add command to add the user name and password using the
account created in P6.
If the desired processes / daemons have not started and are not visible in the task-manager check
the variable DAEMON_LIST in the condor_config file.
A typical master node should control the following daemons.
DAEMON_LIST = MASTER SCHEDD COLLECTOR NEGOTIATOR
Checking of different HTCondor variables is essential for running and security issues:
HOSTALLOW_WRITE = *
An other way to add local shares is to add the machine to the Local Internet at the Security tab.
Help can be found at:
http://support.tabs3.com/main/R11124.htm
On Server2008 turn off UAC from Start > Settings > Control Panel > User Accounts.
2. Edit the xpro.ini to point to the share letter used for the Leica XPro installation for the
location of all required files. For example if the share is the S drive edit xpro.ini to point
to s:\XPro\etc for the required data.
3. Rename and edit the xpro_condor_runner_OS_ARCH.bat template file that was created by
the installer (depending on the Windows and Condor versions you are using). You need to
modify these by pasting the contents of the drive_map.bat file into these files so that they can
correctly map the data.
Newer Condor versions use OpSys Windows to identify the operating system and ARCH
X86_64 for both AMD and Intel 64-bit processors or INTEL for Intelx86 (Pentium, Xenon,
etc.).
The previously delivered bat files were removed from the installer:
xpro_condor_runner_WINNT61/WINNT60/WINNT52/WINNT50_INTEL/X86_64.bat
4. Start Leica XPro to ensure it works on the master (to ensure no missing DLL errors or similar).
5. Install HTCondor.
- Add the bin directory of your HTCondor installation to the System PATH variable.
- Restart the HTCondor service (net start condor or condor restart, condor_startd)
The HTCondor service might take several minutes until it starts.
- use command condor_status to check the number of virtual machines. After editing
the condor_config file there should be only one machine listed per node. If until now
only the server is configured AND the server is not used as a node, then no machines
will be listed.
If the desired processes / daemons are not started and are not visible in the task-manager check
the variable DAEMON_LIST in the condor_config file.
A typical master node should control the following daemons.
DAEMON_LIST = MASTER SCHEDD COLLECTOR NEGOTIATOR
Checking of different HTCondor variables is essential for running and security issues:
HOSTALLOW_WRITE = *
1. Using the "drive-map.bat" to map the shares go into the share where XPro is installed. Create
shortcuts on the desktop for productgenerator.exe, rectifymonitor.exe and dataprep.exe
(\\Tango3100nas\xpro\XPro\productgenerator.exe, using the UNC path).
2. From the shared XPro directory in the prereq\ folder install the vcredist_x64.exe.
3. Start Leica XPro to confirm it works. We strongly suggest you start a small rectification job on
the LOCAL machine to confirm everything is working and the data can be mapped correctly.
Also save this recitification job file, so we can use it for testing the remote worker nodes later.
You can start this local test and move onto the next steps while it runs
5. Use the condor_store_cred add command to add the user name and password using the
account created in P6.
- Restart the HTCondor service (net start condor or condor restart, condor_startd). The
HTCondor service might take several minutes until it starts.
- Use command condor_status to check the number of virtual machines. After editing
the condor_config file there should be only one machine listed per node. If up until
now only the server is configured AND the server is not used as a node, then no
machines will be listed yet.
8. Manually create a XPRO_Temp folder on the submitter machine. This is where the job queue
will go.
Installation on the The procedure for the installation on the Worker nodes applies in both installation cases
Worker nodes - it is not dependent on whether Installation option B for Master- and Submitter nodes
is used or not.
1. From the XPro share prereq\ folder install the vcredist_x64.exe, dotNetFx40_Full_x86_x64.exe
and clm-activation-service-x64.msi.
2. Install HTCondor.
- Restart the HTCondor service (net start condor or condor restart, condor_startd). The
condor service might take several minutes until it starts.
- Use command condor_status to check the number of virtual machines. After editing
the condor_config file there should be only one machine listed per node. If up until
now only the server is configured AND the server is not used as a node, then no
machines will be listed.
5. Type condor_status command and you should see a list of the worker nodes already installed
in the cluster. Ensure the node name you are working on is visible.
Full Test
3. Confirm the local job on the submitter machine ran fine. If it didn't examine the log files to find
out why. It's most likely a drive mapping or xpro.ini problem.
4. Now load the job you ran locally and instead of submitting it to run locally, submit it to run on
the cluster (e.g. Rectifier > Rectify > Generate > Submit to HTCondor).
5. Start rectifiermonitor and you should see the job listed in the queue as queued or idle
6. Within a few minutes that job should change to running and we should see the % complete
count up.
7. Submit more jobs and the other nodes should pick these up and run.
8. If jobs run and stop very quickly it indicates a drive mapping, file permission, or file not found
issue. Please zip up the .log, .err, and .out files from the XPRO_Temp folder on the submission
machine for sending to support.
9. The 2003 Server Standard edition does not have the ICS installed by default.
Additionally we want to make sure that the firewall is switched off for now.
Therefore go to your network connection, TCP/IP Firewall (it will tell you that you have to
install -> yes) and switch the firewall off.
10. Verify that c:\condor\bin is included to the PATH (right click on My Computer > Properties >
Advanced > Environment Variables > System Variables
If using Asian Regional Settings add the full PATH to the entries in the xpro.ini file
(instead the default XPRO_ROOT).
Specify Local License Specify the Local License Sever location in the xpro.ini file.
Server See Application setup for detailed installation instructions.
Potential issues Condor provides different diagnosis tools to get more information about the status of available
machines and status of jobs.
condor_status
<machine> -long
condor_q
condor_q -analyze
condor_q -l <jobnumber>
If the OS of a submitter machine and the possible executing node differs, the jobs may not be
executed.
In order to execute a job the normal expectation is, to have the same environment on the
execution machine as the submitter machine. Therefore in the submit process some default
Requirements are added with the local values.
This can happen with the OpSys variable.
The local value can be checked with condor_status <machine> -long
For versions later than 7.7.2 (OpSys == "WINDOWS") is the general expression for all
Windows versions.
For previous versions use the older expressions as listed below::
Adding the variable which leads to the rejection to the .sub file resolves this issue.
Requirements = (VirtualMachineID == 1) && (OpSys == "WINNT61")
I
Installation 3
M
MM80 connection parts 28
S
System Requirements 3
190