3DDB Viewer Version 0.4.3 Manual

はじめに

本書は、国立研究開発法人 産業技術総合研究所 情報・人間工学領域 人工知能研究センター 地理情報科学研究チームが運用・管理する三次元モデルデータベースへ登録されたモデルデータを表示するための Web ベースのユーザインタフェース (以後、3DDB Viewer と呼称します) の使用方法について記載するものです。

動作環境

以下の環境で 3DDB Viewer の動作を確認しています。

一番下に記載した環境は最低動作環境です。

ハードウェア/OS/Web ブラウザ

DELL Alienware (CPU: Intel(R) Core(TM) i9-12900HK MEM: 64GB GPU: GeForce RTX3080Ti)
Windows 11 Professional
Chrome version 107.0.5304.87, Firefox version 106.0.2 (64bit)
ASUS ROG (CPU: Intel(R) Core(TM) i9-11900H MEM: 32 GPU: GeForce RTX3080 Laptop GPU)
Windows 10 Professional
Chrome version 107.0.5304.87, Firefox version 106.0.2 (64bit)
MacBook Pro 13-inch, M1, 2020 (CPU: Apple M1 MEM: 16GB)
macOS Monterey version 12.6.1
Chrome version 107.0.5304.87, Firefox version 106.0.2 (64bit)
DELL Alienware (CPU: Intel(R) Core(TM) i9-8950HK MEM: 32GB GPU: GeForce GTX1080 with Max-Q)
Windows 10 Enterprise
Chrome version 107.0.5304.87, Firefox version 106.0.2 (64bit)
MacBook Pro 13inch 2016 (CPU: Intel(R) Core(TM) i5 MEM: 16GB)
macOS Monterey version 12.6.1
Chrome version 107.0.5304.87, Firefox version 106.0.2 (64bit)

注意

  • 概ね上記の環境と同程度の環境であれば動作すると考えますが、全ての環境で動作することを保証するものではありません。

    基本的に上記の環境以外の動作については一切保証しません。

  • 表示するモデルデータが複雑な場合や、複数のモデルデータを表示する場合において、クライアント側のマシンスペックが不足している場合、以下のようなエラー (レンダリングエラー) により 3DDB Viewer の動作が停止することがあります。

    _images/3dui_rendering_error.png

    この状態になった場合は、Web ブラウザでリロードを実行し、当該モデルデータの表示を避ける、表示するモデルデータの数を減らすなどの対応を実施してください。

    また、マシンスペックが不足していない場合においても、同様のエラーが発生する場合がありますが、この場合も前述の対応を実施してください。

    マシンスペックが不足していない場合に発生するレンダリングエラーについては、Web ブラウザ由来の不具合である場合があるため、Chrome 使用時に問題が生じた場合は Firefox を使用する、Firefox 使用時に問題が生じた場合は Chrome を使用する、といった対応で回避することができる可能性があります。

    また、Web ブラウザのバージョンアップによりエラーが解消される場合があります (逆の場合もあります)。

警告

以下の環境の動作確認は未実施です。

  • Internet Exploer, Microsoft Edge (Chromium ベースでないもの), Safari の Web ブラウザ

  • Android OS の環境

以下の環境での動作は不完全であることを確認しています。

  • iOS, iPadOS の環境

    実行はできますが、ダイアログのドラッグ操作ができません。

使用方法

3DDB Viewer の使用方法について、以下に記載します。

基本操作

3DDB Viewer の基本操作を、以下に記載します。

_images/3dui_initial.png

図 1. 3DDB Viewer (クリックで拡大表示)

図 1. は 3DDB Viewer を起動した直後の画面です。3DDB Viewer は、図 1. に記した番号 (1) 〜 (5) の領域から構成されています。それぞれの領域は、以下の機能を担っています。

(1) モデルデータ検索・表示制御パネル

モデルデータの検索および、モデルデータの表示・ダウンロードに関する機能を担っています。

具体的な使用方法は、後述の「モデルデータ検索・表示・ダウンロード」を参照してください。

(2) ベースレイヤー

モデルデータの表示を担っています。「(1) モデルデータ検索・表示制御パネル」で選択したモデルデータは、ここに表示されます。

ベースレイヤーでの操作は、以下の通りです。

操作

ベースレイヤーの挙動

マウス左ボタンのドラッグ + マウス移動

移動 (図 2. 赤矢印)

シフトキー + マウス左ボタンのドラッグ + マウス移動

平行移動 (図 2. 水色矢印)

マウスホイールの回転

ズームイン・ズームアウト

マウスホイールのドラッグ + マウス移動
もしくは
コントロールキー + マウス左ボタンのドラッグ + マウス移動

回転 (図 2. 緑矢印)

_images/3dui_map_move.png

図 2. ベースレイヤー操作 (クリックで拡大表示)

(3) ツールボックス

ベースレイヤーおよびモデルの表示方式 (シーンモード) の変更、操作方法の簡易ヘルプを担っています。具体的な使用方法は、後述の「ツールボックス」を参照してください。

(4) タイムバー

3DDB Viewer 内の時刻の変更を担っています。

環境光の影響を受ける構造物モデルでは、時刻の変更に応じて建物の陰影などが変化します。

バーの任意の場所をクリックする、もしくはバーにあるつまみをドラッグ操作する事で時刻の変更が可能です。

3DDB Viewer 起動時の時刻は、起動した環境のタイムゾーンでの正午となります。

注意

タイムバーは協定世界時 (UTC) での時刻表示としているため、起動した環境のタイムゾーンにより正午が正午でない時刻となる場合があります。

例えば、起動した環境のタイムゾーンが日本標準時 (JST) である場合、UTC と +9 時間の時差があることから、JST の正午 (12:00) は、タイムバーでは 3:00 となります。

タイムバーの中心を起動した環境の正午となるようにしているので、迷った際には「タイムバーの中心が正午」として認識してください。

(5) クレジット

3DDB Viewer についてのクレジット表記です。表記以外の機能は有していません。

(6) モデルデータカート

選択したモデルデータの保持・表示に関する機能を担っています。

具体的な使用方法は、後述の「モデルデータ検索・表示・ダウンロード」を参照してください。

モデルデータ検索・表示・ダウンロード

3DDB Viewer のモデルデータ検索・表示・ダウンロードについて、以下に記載します。

モデルデータ カートへの追加・削除

「モデルデータ検索」で検索を実行すると、検索結果を含む以下のダイアログが表示されます。

_images/3dui_result_list.png

図 7. 検索結果あり

注意

  • 検索結果が多い場合、下のスライドバーをスライドさせてください。

結果が存在しない場合、結果が存在しない旨のメッセージが表示されます。

_images/3dui_result_empty.png

図 8. 検索結果なし

カート機能を利用することで、モデルデータの表示などを行うことができます。

_images/3dui_cart_dialog.png

図 9. カートダイアログ

カートの追加、検索結果のページ切り替えについて、以下に説明を記載します。

_images/3dui_result_add_icon.png

図 10. カートアイコンの追加、検索結果のページ切替え (クリックで拡大表示)

    1. 検索結果のページ切り替え機能

    検索結果のページを切り替えます。

    ページ辺りのデータ件数は 20 件となっており、検索結果 / 20 のページ番号がここに表示されます。表示されたページ番号をクリックする事で、検索結果のページを切り替えます。

    1. データをカートへ追加機能

    アイコンをクリックすることでデータをカートへ追加します。

カートからデータの削除について、以下に説明を記載します。

_images/3dui_result_remove_icon.png

図 11. 削除アイコン (クリックで拡大表示)

    1. カートからデータの削除機能

    アイコンをクリックすることでデータをカートから削除します。

モデルデータ表示・ダウンロード

検索結果の表示について、以下に説明を記載します。

_images/3dui_result_icon.png

図 12. 検索結果アイコン (クリックで拡大表示)

    1. モデルデータ表示 ON/OFF

    モデルデータの表示 ON/OFF を切り替えます。

    検索後の状態 (図 12. の状態) は、表示 OFF の状態です。

    _images/3dui_show_model.png

    図 13. モデルデータの表示例 (クリックで拡大表示)

    1. モデルデータのある場所への移動

    クリックするとモデルデータがある場所へ移動します。

    1. モデルデータの詳細情報

    モデルデータの詳細情報を閲覧します。

    クリックすると以下のようなダイアログを開き詳細情報が表示されます。

    _images/3dui_detail_panel.png

    図 14. 詳細情報

    1. モデルデータのダウンロード

    注釈

    モデルデータの登録時にダウンロード不可として登録されたデータである場合、当該アイコンは非表示となります。

    クリックすると以下のようなダイアログを開き、モデルデータをダウンロードする事が可能です。

    _images/3dui_download_panel.png

    図 15. ダウンロード

    警告

    モデルデータをダウンロードする場合、そのモデルデータに紐付くライセンス条項に従う事に合意する必要があります。

    _images/3dui_download_confirm.png

表示状態の制御

モデルデータの表示については、個別のモデルデータではなく表示全般に影響する機能として、以下の機能があります。

_images/3dui_view_control.png

図 16. 表示制御 (全般)

    1. Foot print

    各モデルが存在する箇所にワイヤーフレームで領域を描画したもの (foot print) の、表示 ON/OFF を切り替えます。

    初期状態は OFF となっています。

    _images/3dui_footprint_off.png

    図 17. Foot print OFF

    ON にすると図 18. のようにモデルの存在する箇所に foot print を描画します。

    _images/3dui_footprint_on.png

    図 18. Foot print ON

    モデルの表示を実行した場合、そのモデルの foot print は自動的に OFF となります。

    1. Point Size

    点群データの点の大きさを変更します。点群データ以外への影響はありません。

    1. Underground

    地下視点へ移動できる機能の ON/OFF を切り替えます。DEM 表示時にも利用可能です。

    1. Translucency

    地表を透過する機能の ON/OFF を切り替えます。DEM 非表示時にも利用可能です。

表示状態の共有

3DDB Viewer は、モデルデータの表示状態を再現するための URL を生成する機能を提供しています。この URL を共有する事で、モデルデータの表示状態を共有することが可能です。

注意

  • 本機能は、シーンモードが 3D 表示の場合にのみ機能します。

  • version 0.2 以前で生成した URL を使用した場合、モデルデータの表示状態の復元はできません。

当該 URL は、モデル検索・表示制御パネルの Share ボタンをクリックする事で生成することが可能です。

_images/3dui_share_button.png

図 19. Share ボタン

Share ボタンをクリックすると、以下のダイアログが表示されます。

_images/3dui_share_panel.png

図 20. Share ダイアログ

Copy to clipboard ボタンをクリックする事で、表示している URL がクリップボード領域へコピーされます。テキストエディタ等のアプリケーションを利用してクリップボードの内容を保存してください。

ツールボックス

ツールボックスについて、以下に記載します。

_images/3dui_tbox.png

図 21. ツールボックス

左から、日本文化財レイヤー、シーンモード変更、ベースレイヤー切り替え、操作方法の簡易ヘルプとなります。

それぞれの機能について、以下に記載します。

日本文化財レイヤー

日本文化財レイヤーは、日本の文化財の所在地および、各文化財の情報を表示するものです。

日本文化財レイヤーは、独立行政法人国立文化財機構 奈良文化財研究所国立研究開発法人 産業技術総合研究所 の共同研究の一環として、独立行政法人国立文化財機構 奈良文化財研究所から提供されたデータを用いて実現しています。

アイコンをクリックすると、図 22. のダイアログを展開します。

_images/3dui_wms_dialog.png

図 22. レイヤー制御ダイアログ

各項目の説明を以下に記載します。

レイヤー制御ダイアログ

項目名

説明

Currently Layer State

現在のレイヤーの状態です。
ボタンをクリックするとレイヤーの有効・無効が切り替わります。

Display Object Type

文化財の所在の表示形式を選択します。

Polygon: 文化財の所在を領域 (ポリゴン) で表示します。
Point: 文化財の所在を点 (ポイント) で表示します。
All: ポリゴンとポイントを混在して表示します。

データ件数はポイントの方が多いため、網羅的に閲覧する場合はポイントの
使用を推奨します。

Layer Opacity

レイヤーの透過度を変更します。
0.0 から 1.0 (0.1 刻み) で指定可能です。
1.0 が不透過、0.0 が完全透過です。

レイヤーを有効にすると、以下のように文化財の所在地を表示します。

_images/3dui_wms_layer.png

図 23. レイヤーの表示例

ポリゴンやポイントをクリックすることで、文化財の情報を表示することができます。

_images/3dui_wms_info.png

図 24. 文化財の情報

各項目の説明を以下に記載します。

文化財の情報

項目名

説明

RecNo

RecNo は、奈良文化財研究所が運営する「文化財総合一覧WebGIS」システム上の
ID です。
ID が数字のみのものは「各種文化財・遺跡DB(奈良文化財研究所)」のデータ、
ID が「S」で始まるものは「遺跡抄録」のデータであることを意味します。
※ ID が「S」で始まるものは「総覧抄録 ID」ですが、便宜上ここに表示しています。

Name

文化財の名前です。
クリックすることで「文化財総覧 WebGIS」システムを開きます。

Location

所在地の情報です。

Lon

経度の情報です。

Lat

経度の情報です。

Mainage

文化財の年代の情報です。

Source Data

データの提供日です。

シーンモード変更

アイコンをクリックすると、図 25. のようにアイコンを展開するので、希望するモードを選択します。

_images/3dui_tbox_smode.png

図 25. シーンモード変更

各モードのアイコンは、上から 3D 表示、2D 表示、2.5D 表示 (Columnbus View) となります。

選択したモードによって表示順が変化するため、表示順序でなくアイコンとモードを紐づけて覚えるようにしてください。

ベースレイヤー切り替え

アイコンをクリックすると、図 26. のダイアログを展開します。当該ダイアログで希望するベースレイヤーのイメージおよび、数値標高モデル (DEM: Digital Elevation Model) を選択します。

_images/3dui_tbox_blpicker.png

図 26. ベースレイヤー切り替え

ベースレイヤーのイメージは Imagery、DEM は Terrain から、それぞれ 1 つ選択可能です。

3DDB Viewer 起動時は、Imagery に「Basemap of GSI of Japan」、Terrain に「WGS84 Ellipsoid」を指定しています。

注意

  • CPU に GPU を内蔵した古いハードウェアでは、DEM 「Cesium World Terrain」や「地形図の標高線」や「航空レーザー測量」を有効にすると高負荷となるため、これらの使用は推奨しません。

  • “航空レーザー測量”や"写真測量"の 5m メッシュは、カバーされていない範囲があるため、正しく表示されない場合があります。

    _images/3dui_dem5_not_cover.png

    カバーされていない範囲については、以下の国土地理院のページで確認してください。

操作方法の簡易ヘルプ

アイコンをクリックすると、図 27. のようにダイアログを展開し、ベースレイヤー上での操作の簡易的な説明図が表示されます。

_images/3dui_tbox_help.png

図 27. 簡易ヘルプ

表示後、別の場所をクリックすると、当該ダイアログは自動的に非表示となります。

その他

ダイアログ共通操作

ダイアログの共通操作について、以下に記載します。

_images/3dui_dialog_control.png

図 28. ダイアログ操作

  • (1). 移動バー

    ダイアログの位置を移動する事ができます。

    バーの部分をドラッグする事で、任意の場所に移動する事ができます。

  • (2). 折り畳みボタン

    クリックすると、ダイアログを折り畳みます。

    再度クリックすると折り畳みを解除します。

  • (3). ラベル

    ダイアログを識別するためのラベル表示です。

    操作することはできません。

  • (4). クローズボタン

    クリックすると、ダイアログを閉じます。

    クローズボタンが存在しないダイアログもあります。

ヘルプ表示

Help ボタンをクリックする事で、本マニュアルを参照することが可能です。

_images/3dui_help_button.png

図 29. Help ボタン