3DDB Viewer Version 0.2 Manual¶
This document describes how to use a Web-based user interface (hereinafter referred to as “3DDB Viewer”) for displaying model data registered in the 3DDB database operated and managed by the Geographical Information Science Research Team, Artificial Intelligence Research Center, Information and Human Engineering Field, National Institute of Advanced Industrial Science and Technology (AIST).
We have confirmed that 3DDB Viewer works in the following environments.
DOS/V (CPU: Intel(R) Core(TM) i7-7700K MEM: 32GB GPU: GeForce GTX1080)
Windows 10 Pro version 1809
Chrome version 87.0.4280.88, Firefox version 84.0 (64bit),
Microsfot Edge version 83.0.478.64 (official build)(64bit)
Alienware (CPU: Intel(R) Core(TM) i9-8950HK MEM: 32GB GPU: GeForce GTX1080 with Max-Q)
Windows 10 Enterprise version 2004
Chrome version 87.0.4280.88, Firefox version 83.0 (64bit)
MacBook Pro 15inch Mid 2015 (CPU: Intel(R) Core(TM) i7 MEM: 16GB)
macOS Catalina version 10.15.7
Chrome version 87.0.4280.88, Firefox version 84.0 (64bit)
MacBook Pro 13inch 2016 (CPU: Intel(R) Core(TM) i5 MEM: 16GB)
macOS Mojave version 10.14.6
Chrome version 87.0.4280.88, Firefox version 84.0 (64bit)
It should work in the same level of environment as above, but it is not guaranteed to work in all environments.
Basically, the operation by the environment other than the operation check is not guaranteed at all.
During the development process, we have confirmed that there was a bug that caused the application to crash due to a WebGL-related error when using Chrome for Mac.
The cause of the problem is unknown at this time, as Chrome has been updated to work properly without reproducing the problem.
Since this problem only occurs on Chrome for Mac and works fine on Chrome for Windows, and since Firefox works fine on both Windows and Mac, it is possible that this is a problem with Chrome for Mac.
If you encounter similar problems, please consider using Firefox.
We have confirmed that it does not work in the following environments.
Web browsers: Internet Explorer, Microsoft Edge (not the Chromium baseed), and Safari
Environments: Android OS, iOS, and iPadOS
How to Use¶
The following sections describe how to use the 3DDB Viewer.
The basic operations of 3DDB Viewer are described in the following sections.
Figure 1. shows the screen after starting the 3DDB Viewer. The 3DDB Viewer consists of the numbered areas (1) to (5) as shown in Figure 1. Each area has the following functions
(1) Model Data Search and Display Control Panel¶
It has functions for searching model data and displaying and downloading model data. For specific instructions on how to use this function, please refer to “Searching, Viewing and Downloading Model Data” below.
(2) Base Layer¶
This panel is responsible for displaying model data. The model data selected in “(1) Model data search and display control panel” is displayed here.
The operations on the base layer are as follows.
Base Layer Behavior
Drag left mouse button + move mouse
Move (Figure. 2. red arrow)
Shift + drag left mouse button + move mouse
translation (Figure. 2. light blue arrow)
Rotate mouse wheel
Drag the mouse wheel + move the mouse
Ctrl + drag left mouse button + move mouse
Rotate (Figure. 2. green arrow)
It serves as a simple help for changing the base layer and model display mode (scene mode). For specific instructions on how to use it, see “Toolbox” below.
(4) Time bar¶
It is responsible for changing the time in the 3DDB Viewer.
In a structural model that is affected by ambient light, the shading of the building and other features change as the time of day changes.
You can change the time by clicking anywhere on the bar, or by dragging the knob on the bar.
The time when the 3DDB Viewer is started is noon in the time zone of the started environment.
The time bar displays the time in Coordinated Universal Time (UTC), so noon may not be noon depending on the time zone of the environment in which you run the 3DDB Viewer.
For example, if the time zone of the environment you are running in is Japan Standard Time (JST), noon (12:00) in JST will be 3:00 in the time bar, since from UTC a time difference of +9 hours.
The center of the time bar is set to be the noon of the environment in which it is launched, so if you are confused, please recognize that the center of the time bar is noon.
This is a credit for 3DDB Viewer. It does not have any other functions.
Model data search, display and download¶
The following section describes how to search, display and download model data in 3DDB Viewer.
Model data search¶
It is necessary to select registered model data to display model data.
This section describes how to search for registered model data.
Among the items in the Model Data Search and Display Control Panel, the items related to the search and their descriptions are listed below.
Searches for model data.
If you execute a search without specifying any of the items described in the following section, the top 500 registered model data in the order of registration will be returned.
Model data registration information search field
The title and the description of model data (description) are added as search criteria.
The input is treated as a partial match.
Model data type selection
Add the type of model data as a search condition.
Descriptions for each type are listed below.
For point cloud data
For polygon data
For structures (such as stations and facilities)
Registration date search field
You can add the registration date of the model data as a search condition.
The left input field is the start date and the right input field is the end date.
If you enter only the start date, the start date will be entered after the specified date, if you enter only the end date, the end date will be entered by the specified date, and if you enter both, the specified range will be the search condition.
In addition, you can select a range of data to enter by clicking on the input field.
Search range specification
Add an arbitrary position/area on the base layer as a search condition.
When the checkbox is checked, the following items are expanded and a cube (bounding box) representing the search range is displayed on the base layer.
The bounding box will be displayed at the center of the base layer after starting 3DDB Viewer, or at the user-specified position after the second time.
When the checkbox is unchecked, the item will return to its original state and the bounding box will disappear.
You can change the position and size of the bounding box from the items you have expanded as described above.
Each item is described below.
Change the longitude [deg]
Change the latitude [deg]
Change the altitude [m]
Rotate the bounding box around a vertical line [deg]
Move the bounding box to the center of the base layer.
You can also change the latitude and longitude by dragging the bounding box on the base layer.
Change the magnitude of the longitude [m]
Change the size of the latitude [m]
Change the size of the height direction [m]
Model data display and download¶
When you execute a search with “Model Data Search”, the following dialog box with search results is displayed.
If the result does not exist, a message is displayed stating that the result does not exist.
The following is an explanation of how the search results are displayed.
Page switching in search results
Switch between pages of search results.
The number of data per page is 20, and the search results / 20 page numbers are displayed here. You can switch between the search results by clicking on the displayed page number.
Model data display ON/OFF
Switches the display of model data ON and OFF.
The state after the search (Figure 9) is the state of the display OFF.
Moving to the location of the model data
Clicking on it will take you to the location of the model data.
Download Model Data
If the data is registered as non-downloadable when the model data is registered, the icon in question will be hidden.
When you click this icon, the following dialog box will open and you can download the model data.
Control of display state¶
In order to display the model data, the following features are available that affect the overall display, not the individual model data.
Toggles the display of the wireframe area (foot print) drawn at the location where the model exists.
Initially, it is OFF.
When this is turned on, foot print is drawn at the point where the model exists, as shown in Figure 15.
When the model is displayed, the foot print of the model is automatically turned off.
Changes the size of points in point cloud data. There is no effect on anything other than point cloud data.
The toolbox is described below.
From left to right: Scene mode change, base layer switching, and simple help on how to operate.
Each of these features is described below.
Scene mode change¶
After clicking on the icon, the icon will expand as shown in Figure 19, and you can select the desired mode.
The icons for each mode are, from the top, 3D view, 2D view and 2.5D view (Columnbus View).
The order of display changes depending on the selected mode, so try to remember the icon and mode, not the order of display.
Base layer switching¶
Click the icon to expand the dialog shown in Figure 20. Select the desired base layer image and Digital Elevation Model (DEM).
You can select one image from Imagery for base layer and one from Terrain for DEM.
When launching the 3DDB Viewer, “Basemap of GSI of Japan” for Imagery and “WGS84 Elipsoid” for Terrain are specified.
Simple help on how to use¶
When you click the icon, the dialog shown in Figure 21 will be expanded to display a simple explanatory diagram of the operation on the base layer.
When you click on a different location after viewing, the dialog is automatically hidden.
Dialog common operations¶
The common operations of the dialog are described below.
(1). Moving bar
You can move the position of the dialog.
By dragging the bar, you can move it to the desired location.
(2). Collapse button
Click to collapse the dialog.
Click again to un-collapse the dialog.
Labeling to identify the dialog.
It cannot be manipulated.
(4). Close button
Click to close the dialog.
Some dialogs do not have a close button.
You can refer to this manual by clicking on the Help button.