BVKviewer en BVKviewerRenderPlugin UserGuide

Beeldverwerkingsketen (BVK) GDI-Vlaanderen
BVKviewer: handleiding
BVKRenderPlugin: installatiehandleiding
Document Versie 2.0
2 Oktober 2014
Agentschap voor Geografische Informatie Vlaanderen
Koningin Maria Hendrikaplein 70 bus 110
BE-9000 Gent
T +32 9 276 15 00
F +32 9 276 15 05
[email protected]
www.agiv.be
Agentschap voor Geografische Informatie Vlaanderen
Document history
Release
Date
Description of Change
Editors
Reviewers
V1.0
22/03/2013
First release version
WH (VITO), JB (VITO),
JVV, NVC (AGIV)
V2.0
02/10/2014
Second release version
JB (VITO)
JVV, NVC (AGIV)
Content
Content
2
1
Introduction
3
2
Using https://remotesensing.agiv.be/bvkviewer/
3
2.1 Data prerequisites
3
2.2 Exploring the interfaces towards the AGIV-VITO BVK data hosting services.
3
2.3 Executing a set of 3D point measurements
4
BVKviewerRenderPlugin
6
3.1 System prerequisites
6
3.2 Installation guide
7
3
3.3 Uninstallation guide
2 / 11
10
BVK render plug-in, installation guide
Agentschap voor Geografische Informatie Vlaanderen
1
Introduction
In the context of the AGIV (www.agiv.be) and VITO (www.vito.be) cooperation with respect to the
mobile mapping, LiDAR and airborne imaging hosting services a general purpose viewer
(https://remotesensing.agiv.be/bvkviewer/) is made available:



To present an overview of all data hosted under the AGIV-BVK initiative.
To enable 3D point measurements using equirectangular mobile mapping photo’s (in
support of data quality checks).
To present the user an example of how to use the WMS, WFS and HTTP-GET interfaces
to the AGIV-VITO data hosting system.
As part of this viewer, the BVK team developed an OpenGL based plug-in for the 3D rendering of
panoramic photos and LiDAR data. Chapter 2 of this document describes the installation procedure
of this plug-in.
Send your questions or remarks with respect to this product to: [email protected]
2
2.1
Using https://remotesensing.agiv.be/bvkviewer/
Data prerequisites
All use of the AGIV services and applications, including BVK data hosting services, requires a valid
AGIV account. An AGIV account can be requested via the AGIV website https://www.agiv.be/, or
more directly: https://auth.agiv.be/
After successful login using your AGIV account, you can see your profile on
https://auth.agiv.be/profiles and have an overview of which applications (e.g. Remote Sensing) and
related data you can have access. Not all data, due to property rights, is public available. So, not
all data will be accessible or visualized in the BVK viewer. A message will appear if you do not
have the necessary data-access rights.
2.2
Exploring the interfaces towards the AGIV-VITO BVK data hosting services.
One of the objectives of the BVKviewer website is to present the application developer an example
of how to use the WMS, WFS and HTTP-GET interfaces to the AGIV-VITO BVK data hosting
services. These interfaces can be easily monitored and explored using the “Developer console” of
the Internet browser (Figure 1).
Basically, there are 3 interface types:
1. WFS HTTP-GET: queries to database for requesting metadata, such as: requesting all photo
points in a bounding box and their metadata, requesting all LiDAR-LAZ-tile info in a bounding
box. E.g.:
https://remotesensing.agiv.be/geoserver/wfs?SERVICE=WFS&VERSION=1.1.0&REQUEST=GetFeature
&TYPENAME=Agiv:LIDAR_BevaarbarewaterwegenVl_I&SRSNAME=EPSG:31370&BBOX=164200,2214
50,164900,221900
https://remotesensing.agiv.be/geoserver/wfs?SERVICE=WFS&VERSION=1.1.0&REQUEST=GetFeature
&TYPENAME=MM_BevaarbareWaterwegenVl_I&SRSNAME=EPSG:31370&BBOX=164200,221450,164
900,221900
2.
WMS HTTP-GET: drawing of geo-features in a georeferenced bitmap. E.g:
https://remotesensing.agiv.be/geoserver/wms?LAYERS=Agiv%3ALIDAR_BevaarbarewaterwegenVl_I,Agi
BVK render plug-in, installation guide
3 / 11
Agentschap voor Geografische Informatie Vlaanderen
v%3AMM_BevaarbareWaterwegenVl_I&TRANSPARENT=TRUE&FORMAT=image%2Fpng&TILED=true
&SERVICE=WMS&VERSION=1.1.1&REQUEST=GetMap&STYLES=&SRS=EPSG%3A31370&BBOX=1
64200,221450,164900,221900&WIDTH=1000&HEIGHT=500
3. HTTP-GET: downloading original photos or LiDAR LAZ data. E.g.:
https://remotesensing.agiv.be/data/MM_BevaarbareWaterwegenVl_I/D4_Dessel-Schoten/Teccon_201310-03-A_001181.jpg
https://remotesensing.agiv.be/data/LiDAR_WaterwegenVL_1/P1/D000004/LiDAR_WaterwegenVL_1_P1_
D000004_000039/Tiles/LiDAR_WaterwegenVL_1_P1_D000004_000039_164600_221800.laz
A technical description of (a) the interfaces and (b) the data security scenarios can be found on:
1. https://www.agiv.be/producten/beeldverwerkingsketen/meer-over-bvk/aan-de-slag-met-de-bvkdiensten/bvk-hosting-services/bvk-ruwe-data-hosting-services
2. https://www.agiv.be/producten/beeldverwerkingsketen/meer-overbvk/ondersteuning/documentatie
3. https://www.agiv.be/~/media/agiv/producten/bvk/documenten/bvk-mmsensormodel_v02.pdf
4. https://www.agiv.be/~/media/agiv/producten/bvk/documenten/bvk-mmservice_icd_v01.pdf
Figure 1. Explore the WMS, WFS and http-GET interfaces towards the BVK hosting services
using the “Developer Console” of your favorite browser.
2.3
Executing a set of 3D point measurements
In the “3D measurements” tab-sheet (Figure 2), you can select 2 photo’s: a “top” and “bottom”
image. In these two photos one has to click on the object that must be measured. Click on “save
measurement” to store the 3D-measurment in a point-list.
In the “Export” tab-sheet (Figure 3), you get an overview of all your measurements on a map, and
get the possibility to activate/deactivate a measurement. By clicking the “Export selected” button, a
4 / 11
BVK render plug-in, installation guide
Agentschap voor Geografische Informatie Vlaanderen
comma delimited file is saved to your local storage folder (the default download folder used by your
browser).
Figure 2. “3D Measurements” Tab-sheet.
Figure 3. Export 3D-measurement Tab-sheet.
BVK render plug-in, installation guide
5 / 11
Agentschap voor Geografische Informatie Vlaanderen
3
3.1
BVKviewerRenderPlugin
System prerequisites
The RenderPlugin of the internet-viewer https://remotesensing.agiv.be/bvkviewer/ will only work
correctly if:
1. Your user-account has administrative rights,
2. and the BVK-team advises the usage of Firefox (http://www.mozilla.org/) as browser.
If you don’t have administrative rights, you can still view the mobile mapping photographs in raw
sensor geometry. Therefore, in the left-side-menu, under “Mobile mapping photo rendering
settings” select “Raw geometry, not projected” (see Figure 4). When this option is activated, the
RenderPlugin is not invoked (this is also the default behavior).
Figure 4. Select “Raw geometry, not projected” if you do not want to use the RenderPlugin.
When clicking on a LiDAR LAZ tile, the default behavior is that you get the option to download the
clicked LAZ file. If the RenderPlugin is correctly installed, you can also activate a 3D-rendering of
the LiDAR points. To activate this, select the “Render LAZ tiles” option in the “LAZ tiles rendering
settings” (Figure 5).
6 / 11
BVK render plug-in, installation guide
Agentschap voor Geografische Informatie Vlaanderen
Figure 5. Do not select “Render LAZ tiles” if you do not want to use the RenderPlugin.
3.2
Installation guide
When using the BVK demo-viewer (https://remotesensing.agiv.be/bvkviewer) and accessing a
panoramic photo or LiDAR tile for the first time, a window will be shown that invites you to install a
browser plugin (Figure 6).
Figure 6. Download the plug-in and this installation guide.
BVK render plug-in, installation guide
7 / 11
Agentschap voor Geografische Informatie Vlaanderen
This BVK-plugin makes use of the OpenGL standard to visualize the panoramic photo or LiDAR
data in 3D at interactive rates. If you are not using the viewer for the first time but want to install a
new version, please remove the old version first (see section 3.3).
Before starting the installation please make sure that all browser windows are closed and that your
user-account has administrative rights on the system, if you are unsure about this, contact your
IT-department before proceeding.
By selecting the “Download Plugin” link, the installation program will be downloaded. Double click
this file to start the installation process. Click “Next” on the welcome screen and on the next screen,
click “I Agree” to accept the License. Then choose the option “Add Project to the system PATH for
all users” (Figure 7).
Figure 7. Setup “Welcome” screen and “Installation Options” screen.
On 64-bit Windows-7 systems the setup program will default to install in the path (Figure 8):
“C:\Program Files (x86)\BVKRenderPlugin”
It is advised to change this to:
“C:\Program Files\BVKRenderPlugin”.
Figure 8.Change “Destination Folder”.
8 / 11
BVK render plug-in, installation guide
Agentschap voor Geografische Informatie Vlaanderen
Then click “Next” to accept “BVKRenderPlugin” as the name for the Start Menu item. Afterwards,
on the “Choose Components” screen, click “Install” to complete the installation process. And finally,
click “Finish” to close the installer.
After the installation, selecting a panoramic photo from the demo viewer will present the picture in a
3D view (Figure 9).
Figure 9. Rendered panoramic photo.
BVK render plug-in, installation guide
9 / 11
Agentschap voor Geografische Informatie Vlaanderen
3.3
Uninstallation guide
Close all browser windows and select “Control Panel” from the Windows start menu and open the
“Programs and Features” dialog box (Figure 10).
Figure 10. In “Control Panel”, select “Programs and Features”
Windows will now show list of programs installed on the system, select BVKRenderPlugin from this
list using the right mouse button. A menu is now presented with the option “Uninstall/Change”:
select this option with the left mouse button (Figure 11).
Figure 11. Search for “BVKRenderPlugin” in the list of installed programs.
The procedure to remove the BVKRenderplugin is now started, click the “Uninstall” button to accept
the change (Figure 12). When the procedure ends, click the “Close” button to end the uninstallation
The BVKRenderPlugin, associated files and settings are now removed from the system.
10 / 11
BVK render plug-in, installation guide
Agentschap voor Geografische Informatie Vlaanderen
Figure 12. Uninstall process.
.
BVK render plug-in, installation guide
11 / 11

Download Report