Skip to content

Commit

Permalink
Working…
Browse files Browse the repository at this point in the history
  • Loading branch information
Stefan Kebekus committed Sep 15, 2023
1 parent 51bc6a6 commit 6338e0c
Show file tree
Hide file tree
Showing 2 changed files with 81 additions and 37 deletions.
3 changes: 3 additions & 0 deletions manual/.vscode/ltex.dictionary.en-US.txt
Original file line number Diff line number Diff line change
Expand Up @@ -4,3 +4,6 @@ Volksbank
SafeSky
GeoTIFF
TripKits
Paus
TripKit
NextCloud
115 changes: 78 additions & 37 deletions manual/02-advanced/vac.rst
Original file line number Diff line number Diff line change
@@ -1,9 +1,15 @@
Import visual approach charts
=============================

**Enroute Flight Navigation** is able to import visual approach charts and
display them in the moving map. The figure :ref:`vac` shows how this will
typically look.

.. warning:: This section describes a new feature currently in the beta
test phase. At present, the functionality is only available to a small group
of testers.


**Enroute Flight Navigation** is can import visual approach charts and display
them on the moving map. The figure :ref:`vac` shows how this will typically
look.

.. _vac:
.. figure:: ./VAC.png
Expand All @@ -17,53 +23,88 @@ typically look.
following formats.

* Geo-referenced image files in GeoTIFF format.
* TripKits, as produced by the latest beta-version of the `AIP Browser DE
<https://mpmediasoft.de/products/AIPBrowserDE/help/AIPBrowserDE.html>`_

.. note:: GeoTIFF is a complex format that supports a wide range of use
cases. For simplicity, **Enroute Flight Navigation** only supports a
restricted subset of the GeoTIFF standard. If you encounter a GeoTIFF
file that is not recognized by **Enroute Flight Navigation**, please
* TripKits that contain collections of approach charts for a specific area or
flight route. The latest beta version of the `AIP Browser DE
<https://mpmediasoft.de/products/AIPBrowserDE/help/AIPBrowserDE.html>`_ can
produce TripKits for Germany.

.. note:: GeoTIFF is a complex format that supports many use cases, ranging
from astronomy to high-precision land survey. **Enroute Flight Navigation**
only supports a subset of the GeoTIFF standard. If you encounter a GeoTIFF
file that **Enroute Flight Navigation** does not recognize, please
`open an issue report
<https://github.com/Akaflieg-Freiburg/enroute/issues/new/choose>`_.
We will be glad to help!

.. note:: This section describes a new feature that is currently in a beta
test phase. At present, the feature is only available for a small group
of beta testers.


Obtain approach charts
^^^^^^^^^^^^^^^^^^^^^^
Obtain approach chart files
---------------------------

Michael Paus' free software `AIP Browser DE
<https://mpmediasoft.de/products/AIPBrowserDE/help/AIPBrowserDE.html>`_ is able
to generate GeoTIFF images and TripKits with approach charts for all German
airfields. The data comes from Germany's official `AIP
<https://aip.dfs.de/basicAIP>`_, as provided by `DFS Deutsche Flugsicherung GmbH
<https://www.dfs.de/homepage>`_.
<https://mpmediasoft.de/products/AIPBrowserDE/help/AIPBrowserDE.html>`_ can
generate GeoTIFF images and TripKits for all German airfields. The data comes
from Germany's official `AIP <https://aip.dfs.de/basicAIP>`_, as provided by
`DFS Deutsche Flugsicherung GmbH <https://www.dfs.de/homepage>`_.

Please get in touch with us if you are aware of other data sources. We will be
glad to list them here.


Import approach chart files
---------------------------

Import on Android devices
^^^^^^^^^^^^^^^^^^^^^^^^^

If you are using an Android device, you must transfer the approach chart file or
TripKit file to the device and open it there. There are many ways to transfer
files, but most users will likely do one of the following.

- Download the file on the Android device with a web browser. The browser will
then offer to open the file in **Enroute Flight Navigation**.

- Upload the file to a cloud storage service, such as "Google Drive", "Microsoft
OneDrive", "Apple iCloud" or a "NextCloud" instance. Connect your device to
the service and use a file management program on your device to open the file.

.. note:: TripKits are ZIP files with specialized content. Trying to open a
TripKit file, some file management utilities will automatically unpack the ZIP
file rather than offering to open it in **Enroute Flight Navigation**. Along
similar lines, GeoTIFF files are image files with specialized metadata and some
file management utilities will launch an image viewing application rather than
offering to open a GeoTIFF file in **Enroute Flight Navigation**.

If you encounter problems opening a TripKit or GeoTIFF file, look for an icon
or menu item labeled "Open with…". Some utilities open an appropriate context
menu after a tap-and-hold gesture.

Please contact us if you are aware of other data sources. We will be glad to
list them here.
Import on the Linux desktop
^^^^^^^^^^^^^^^^^^^^^^^^^^^

If you run **Enroute Flight Navigation** on a Linux Desktop machine, drag and
drop the file into the app's main window.

Import OpenAir files on Android devices
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If you are using an Android device, you must transfer the OpenAir file to the
device and open it there. There are many ways to transfer files, but most users
will likely do one of the following.
Manage your approach chart collection
-------------------------------------

- Download the OpenAir file on the Android device with a web browser. The
browser will then offer to open the file in **Enroute Flight Navigation**.
On the moving map screen, open the main menu and go to "Library/Maps and Data".
The page "Map and Data Library" will then open. The page has a "VAC" tab listing
the approach charts. Use the context menus to uninstall charts and retrieve
basic information.

- Download the OpenAir file to a desktop computer, connect the device to the
desktop computer via USB, and then copy the file to the device. Afterward,
open the file with a file management app on the Android device.

Use approach charts
-------------------

Import Maps on Linux Desktop
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Once approach charts are installed, open the main menu and go to "Approach
Charts". The page "Visual Approach Charts" will then open. The page lists all
approach charts installed in your device, sorted by distance to the current
position. Tap on a chart to open "Approach Chart" page, which shows a slightly
simplified moving map with the approach chart superimposed on top of the usual
map layer. As usual, tap on the left arrow symbol in the page title to close the
page and return to the standard moving map display.

If you are running **Enroute Flight Navigation** on a Linux Desktop machine, use
the file manager to drag and drop the file into the app's main window.
.. note:: The menu entry "Approach Charts" is only visible if approach
charts are installed on your device. If you cannot find the menu entry,
install some approach charts first.

0 comments on commit 6338e0c

Please sign in to comment.