Skip to content

Commit

Permalink
Updates sections on raster maps.
Browse files Browse the repository at this point in the history
  • Loading branch information
kebekus committed Nov 19, 2024
1 parent a19a795 commit 5c28b6d
Show file tree
Hide file tree
Showing 8 changed files with 162 additions and 93 deletions.
9 changes: 9 additions & 0 deletions .vscode/ltex.dictionary.en-US.txt
Original file line number Diff line number Diff line change
Expand Up @@ -45,3 +45,12 @@ Geoid
pilotage
Airspaces
navaid
PowerFLARM
autogenerated
autopan
EDFE
NOTAMs
MBTILES
GeoTIFF
QGIS
EPSG
19 changes: 19 additions & 0 deletions .vscode/ltex.hiddenFalsePositives.en-US.txt
Original file line number Diff line number Diff line change
@@ -1,3 +1,22 @@
{"rule":"MORFOLOGIK_RULE_EN_US","sentence":"^\\QHERE WeGo (Android App)\\E$"}
{"rule":"MORFOLOGIK_RULE_EN_US","sentence":"^\\QOsmAnd (Android App)\\E$"}
{"rule":"MORFOLOGIK_RULE_EN_US","sentence":"^\\Q./autogenerated/02-01-01-traffic.png\n:scale: 30 %\n:align: center\n:alt: Approaching EDTF with Traffic\\E$"}
{"rule":"DOUBLE_PUNCTUATION","sentence":"^\\Q../01-gettingStarted/ic_menu.png Open the main menu.\\E$"}
{"rule":"DOUBLE_PUNCTUATION","sentence":"^\\Q../01-gettingStarted/NorthArrow.png Switch between modes north up and track up.\\E$"}
{"rule":"DOUBLE_PUNCTUATION","sentence":"^\\Q../01-gettingStarted/ic_layers.png Open the raster map menu.\\E$"}
{"rule":"DOUBLE_PUNCTUATION","sentence":"^\\Q../01-gettingStarted/ic_my_location.png Set autopan mode to \"on\".\\E$"}
{"rule":"DOUBLE_PUNCTUATION","sentence":"^\\Q../01-gettingStarted/ic_add.png Zoom in.\\E$"}
{"rule":"DOUBLE_PUNCTUATION","sentence":"^\\Q../01-gettingStarted/ic_remove.png Zoom out.\\E$"}
{"rule":"DOUBLE_PUNCTUATION","sentence":"^\\Q../01-gettingStarted/ic_airplanemode_active.png Open the traffic receiver status page.\\E$"}
{"rule":"MORFOLOGIK_RULE_EN_US","sentence":"^\\Q../01-gettingStarted/ic_airplanemode_active.png Open the traffic receiver status page.\\E$"}
{"rule":"MORFOLOGIK_RULE_EN_US","sentence":"^\\Q../01-gettingStarted/ic_remove.png Zoom out.\\E$"}
{"rule":"MORFOLOGIK_RULE_EN_US","sentence":"^\\Q../01-gettingStarted/ic_add.png Zoom in.\\E$"}
{"rule":"MORFOLOGIK_RULE_EN_US","sentence":"^\\Q../01-gettingStarted/ic_my_location.png Set autopan mode to \"on\".\\E$"}
{"rule":"MORFOLOGIK_RULE_EN_US","sentence":"^\\Q../01-gettingStarted/ic_layers.png Open the raster map menu.\\E$"}
{"rule":"MORFOLOGIK_RULE_EN_US","sentence":"^\\Q../01-gettingStarted/ic_menu.png Open the main menu.\\E$"}
{"rule":"WHITESPACE_RULE","sentence":"^\\Q../01-gettingStarted/ic_menu.png Open the main menu.\\E$"}
{"rule":"WHITESPACE_RULE","sentence":"^\\Q../01-gettingStarted/NorthArrow.png Switch between modes north up and track up.\\E$"}
{"rule":"WHITESPACE_RULE","sentence":"^\\Q../01-gettingStarted/ic_layers.png Open the raster map menu.\\E$"}
{"rule":"WHITESPACE_RULE","sentence":"^\\Q../01-gettingStarted/ic_my_location.png Set autopan mode to \"on\".\\E$"}
{"rule":"WHITESPACE_RULE","sentence":"^\\Q../01-gettingStarted/ic_add.png Zoom in.\\E$"}
{"rule":"WHITESPACE_RULE","sentence":"^\\Q../01-gettingStarted/ic_remove.png Zoom out.\\E$"}
25 changes: 14 additions & 11 deletions 01-gettingStarted/03-firstFlight.rst
Original file line number Diff line number Diff line change
Expand Up @@ -88,17 +88,17 @@ Interactive Controls
In addition to the pan and pinch gestures, you can use the following buttons to
control the app.

===================================== ========
Symbol Function
===================================== ========
.. image:: ic_menu.png Open main menu
.. image:: NorthArrow.png Switch between display modes **north up** and **track up**.
.. image:: ic_my_location.png Center map about own position.
.. image:: ic_add.png Zoom in
.. image:: ic_remove.png Zoom out
.. image:: ic_airplanemode_active.png Warning when the app is not connected to a traffic data receiver.
===================================== ========

========================================================== ========
Symbol Function
========================================================== ========
.. image:: ../01-gettingStarted/ic_menu.png Open the main menu.
.. image:: ../01-gettingStarted/NorthArrow.png Switch between modes **north up** and **track up**.
.. image:: ../01-gettingStarted/ic_layers.png Open the raster map menu. Only visible when raster maps are installed.
.. image:: ../01-gettingStarted/ic_my_location.png Set autopan mode to "on".
.. image:: ../01-gettingStarted/ic_add.png Zoom in.
.. image:: ../01-gettingStarted/ic_remove.png Zoom out.
.. image:: ../01-gettingStarted/ic_airplanemode_active.png Open the traffic receiver status page. Only visible when the app is not connected to a traffic data receiver.
========================================================== ========


.. _firstFlightWaypointInfo:
Expand Down Expand Up @@ -129,6 +129,9 @@ QUJ True track to the waypoint
E Minimal gliding ratio required to reach waypoint in 300 m AGL (disregarding terrain)
============= ================================

Click on the link 'full report' for a list of NOTAMs relevant for the EDFE
airfield.


Go Flying!
----------
Expand Down
110 changes: 28 additions & 82 deletions 03-tutorialAdvanced/02-customMapsRaster.rst
Original file line number Diff line number Diff line change
Expand Up @@ -12,26 +12,13 @@ situations where a user would like to use their own base maps.
countries.
- Some users might prefer raster maps that follow a different style.

**Enroute Flight Navigation** is able to import MBTILES file containing raster
**Enroute Flight Navigation** is able to import MBTILES files containing raster
data.

.. note:: In order to avoid confusion, we decided against mixing raster- and
vector maps. As soon as a single raster map is installed, the moving map of
**Enroute Flight Navigation** will **only** display that raster map. In
particular, the moving map will no longer display the aviation data layer. Even
though they become invisible, we still recommend installing our regular maps,
because **Enroute Flight Navigation** needs the data to provide airspace and
waypoint information.


Import Maps
-----------

Transfer the MBTILES file to your device and open the file on your device. The
Section :ref:`importData` explains the process in detail.

To view and manage your maps, open the main menu and go to "Library/Maps and
Data".
.. note::
Even if you decide to use raster maps, we still recommend installing our
regular maps, because **Enroute Flight Navigation** needs the data to provide
airspace and waypoint information.


MBTILES Map Data Sources
Expand All @@ -40,79 +27,38 @@ MBTILES Map Data Sources
The website `open flightmaps
<https://www.openflightmaps.org/https://www.openflightmaps.org>`_ provides
excellent aviation maps in raster format for a variety of European countries, as
well as South Africa and Namibia.


Raster Maps in GeoTIFF Format
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
well as South Africa and Namibia. We are aware of aviation authorities that
offer ICAO raster maps in GeoTIFF format. The Section :ref:`mapconversiontools`
explains how these can be converted to the MBTILES format suitable for **Enroute
Flight Navigation**.

We are aware of websites that offer raster maps in GeoTIFF format. At present,
**Enroute Flight Navigation** cannot handle GeoTIFF files, but there are tools
that convert GeoTIFF to MBTILES.

- Official ICAO maps for Denmark are available from the danish `AIM Naviair
<https://aim.naviair.dk/en/charts/>`_
Import Raster Maps
------------------

- Official ICAO maps for Spain are available from the Spanish `Insignia Servicio
de Información Aeronáutica
<https://aip.enaire.es/AIP/CartasInsigniaImpresas-es.html>`_

- Official ICAO maps for Switzerland are available from the Swiss `Federal
Office of Topography swisstopo
<https://www.swisstopo.admin.ch/en/geodata/aero/icao.html>`_

- Official VFR raster charts are available from the `United States Federal
Aviation Administration
<https://www.faa.gov/air_traffic/flight_info/aeronav/digital_products/vfr/>`_

Users have successfully used the free tool `QGIS <https://qgis.org/en/site>`_ to
convert GeoTIFF files to MBTILES, which can then be used with **Enroute Flight
Navigation**.

.. _QGIS-img:
.. figure:: QGIS-MainWindow.png
:scale: 40 %
:align: center

QGIS Main Window
Transfer the MBTILES file to your device and open the file on your device. The
Section :ref:`importData` explains the process in detail.

Since QGIS is a powerful tool that is not always easy to use, one user has
kindly provided the following short tutorial.

- Install QGIS on your desktop computer. On Fedora Linux, we found that the
packages provided by the default software repository were outdated and lacked
the necessary functionality. We followed the installations instructions on
the `QGIS website <https://qgis.org/en/site/forusers/download.html>`_ to
install a current and full-featured version of the program.
Manage Imported Raster Maps
---------------------------

- Open QGIS. Create a new project and open the GeoTIFF file in QGIS by
dragging-and-dropping the GeoTIFF file into the QGIS window. The content of
the GeoTIFF file should become visible.
To manage the raster maps installed in **Enroute Flight Navigation**, open the
main menu and go to "Library/Maps and Data".

- Choose the menu item "Project/Properties…" to open the dialog window "Project
Properties". There, set the coordinate reference system to EPSG:3857. To
locate the reference system, use the text field "Filter" and search for
EPSG:3857.

- Use the menu items under "View/Panels/…" to ensure that the panels "Layer" and
"Layer Styling" are visible. Select the layer of your GeoTIFF file and in the
"Layer" panel. Then, go to the "Layer Styling" panel and set "Resampling" to
"Bilinear" for better image render quality.
Use Imported Raster Maps
------------------------

- Use the menu items under "View/Panels/…" to ensure that the panel "Processing
Toolbox" is visible. Inside the "Processing Toolbox", double-click on "Raster
Tools→Generate XYZ Tiles (MBTILES)". The dialog "Generate XYZ Tiles
(MBTILES)" will open. Fill the necessary parameters, as seen in the image
below. We found the function "Draw on Map Canvas" useful to specify the map
extent. Pay attention to the maximum zoom level, as the time and file size
increase significantly after zoom level 12. Depending on the size of your
GeoTIFF and on the number of zoom levels you use, it may take a while to
generate the MBTILES file.
.. |ico1| image:: ../01-gettingStarted/ic_layers.png

As soon as raster maps are installed, a button with the label |ico1| will become
visible on the moving map page. A tap on the button will open the Raster Map
Menu, which shows all raster maps installed. Tap on an entry to show the
relevant map inside the moving map display. Tap on the same entry again to hide
it.

.. _QGIS-Gen-img:
.. figure:: QGIS-GenerateMBTILES.png
:scale: 40 %
:align: center
.. note::
In order to avoid confusion, at most one raster map will be shown at any given
time.

QGIS Generate Tiles Dialog
1 change: 1 addition & 0 deletions 04-additionalSoftware.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,3 +10,4 @@ other software what we should list here.

04-additionalSoftware/01-flightPlanning
04-additionalSoftware/02-mapping
04-additionalSoftware/03-mapConversion
91 changes: 91 additions & 0 deletions 04-additionalSoftware/03-mapConversion.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
.. _mapConversionTools:

Map Generation and Conversion Tools
===================================

As explained in Section :ref:`importraster`, **Enroute Flight Navigation** is
able to import and use third-party raster maps in MBTILES format. However, most
government offices publish aviation maps in GeoTIFF format rather than MBTILES.
GeoTIFF is suitable for use in geodata information service systems, but
unsuitable for map display on low-powered devices.

This section lists several official sources for aviation maps and explains how
to convert GeoTIFF to MBTILES format.


Data Sources
------------

We are aware of websites that offer raster maps in GeoTIFF format. At present,
**Enroute Flight Navigation** cannot handle GeoTIFF files, but there are tools
that convert GeoTIFF to MBTILES.

- Official ICAO maps for Denmark are available from the danish `AIM Naviair
<https://aim.naviair.dk/en/charts/>`_

- Official ICAO maps for Spain are available from the Spanish `Insignia Servicio
de Información Aeronáutica
<https://aip.enaire.es/AIP/CartasInsigniaImpresas-es.html>`_

- Official ICAO maps for Switzerland are available from the Swiss `Federal
Office of Topography swisstopo
<https://www.swisstopo.admin.ch/en/geodata/aero/icao.html>`_

- Official VFR raster charts are available from the `United States Federal
Aviation Administration
<https://www.faa.gov/air_traffic/flight_info/aeronav/digital_products/vfr/>`_


Conversion Tool: QGIS
---------------------

Users have successfully used the free tool `QGIS <https://qgis.org/en/site>`_ to
convert GeoTIFF files to MBTILES, which can then be used with **Enroute Flight
Navigation**.

.. _QGIS-img:
.. figure:: QGIS-MainWindow.png
:scale: 40 %
:align: center

QGIS Main Window

Since QGIS is a powerful tool that is not always easy to use, one user has
kindly provided the following short tutorial.

- Install QGIS on your desktop computer. On Fedora Linux, we found that the
packages provided by the default software repository were outdated and lacked
the necessary functionality. We followed the installations instructions on
the `QGIS website <https://qgis.org/en/site/forusers/download.html>`_ to
install a current and full-featured version of the program.

- Open QGIS. Create a new project and open the GeoTIFF file in QGIS by
dragging-and-dropping the GeoTIFF file into the QGIS window. The content of
the GeoTIFF file should become visible.

- Choose the menu item "Project/Properties…" to open the dialog window "Project
Properties". There, set the coordinate reference system to EPSG:3857. To
locate the reference system, use the text field "Filter" and search for
EPSG:3857.

- Use the menu items under "View/Panels/…" to ensure that the panels "Layer" and
"Layer Styling" are visible. Select the layer of your GeoTIFF file and in the
"Layer" panel. Then, go to the "Layer Styling" panel and set "Resampling" to
"Bilinear" for better image render quality.

- Use the menu items under "View/Panels/…" to ensure that the panel "Processing
Toolbox" is visible. Inside the "Processing Toolbox", double-click on "Raster
Tools→Generate XYZ Tiles (MBTILES)". The dialog "Generate XYZ Tiles
(MBTILES)" will open. Fill the necessary parameters, as seen in the image
below. We found the function "Draw on Map Canvas" useful to specify the map
extent. Pay attention to the maximum zoom level, as the time and file size
increase significantly after zoom level 12. Depending on the size of your
GeoTIFF and on the number of zoom levels you use, it may take a while to
generate the MBTILES file.

.. _QGIS-Gen-img:
.. figure:: QGIS-GenerateMBTILES.png
:scale: 40 %
:align: center

QGIS Generate Tiles Dialog
File renamed without changes

0 comments on commit 5c28b6d

Please sign in to comment.