Maps - Airspace
Cumulus supports two different source formats:
as database for airspaces.
OpenAir
Addesses where you can find OpenAir airspace files are:
openAIP
openAIP airspace files can be downloaded
from the openAIP website, where this project is hosted.
See here for further help.
Installation Directory
Just put your airspace files in the directory .../maps/airspaces
and make sure, that OpenAir files have the .txt extension while
openAIP files uses the .aip extension. The extension spelling is not
case sensitive.
Because you can have a lot of airspace files in the airspace
directory, maybe one for every country, it is useful to define, which
files should be loaded only to save run-time memory. That can be done
in the configuration setup for
Airspaces.
Press the Load button on that page and select the airspace files in the
displayed list to be loaded.
Mapping Services
Certain OpenAir/openAIP airspace elements are not unique mapable
to Cumulus airspace elements. Therefore Cumulus provides additional mapping
services.
- One global mapping file
- Special mapping files, related to one airspace file
The mapping files must be placed in the same directory as the airspace files
are installed. Their rules overwrite the default Cumulus mapping rules.
Global Mapping File
The global mapping file is applied first to all read airspace file. The name
of the file is airspace_mappings.conf.
Special Mapping Files
Special mapping files can be applied only once to a related airspace file.
Such a file consists of the basename of the airspace file without the extension
.txt or .aip, extended by the string _mappings.conf.
Example: SourceFile=openair.txt, MappingFile=openair_mappings.conf
Cumulus knows the following airspace types:
- AirA
- AirB
- AirC
- AirD
- AirE
- AirF
- AirUkn
- ControlC
- ControlD
- Danger
- Prohibited
- Restricted
- LowFlight
- Tmz
- GliderSector
- WaveWindow
The syntax used in the mapping file is very simple. Lines starting with #
or * are ignored and can be used for comments. Empty lines are
also ignored. The rest of the lines should contain entries in the form
key = value, one entry per line. The key is the airspace type
in the OpenAir/openAIP file you wish to map, and the value is the
corresponding Cumulus type you wish to assign.
Default mapping for OpenAir
- A = AirA
- B = AirB
- C = AirC
- D = AirD
- E = AirE
- F = AirF
- UKN = AirUkn
- GP = Restricted
- P = Prohibited
- Q = Danger
- R = Restricted
- TRA = Restricted
- CTR = ControlD
- TMZ = Tmz
- GSEC = GliderSector
- W = WaveWindow
Default mapping for openAIP
- A = AirA
- B = AirB
- C = AirC
- D = AirD
- E = AirE
- F = AirF
- DANGER = Danger
- PROHIBITED = Prohibited
- RESTRICTED = Restricted
- CTR = ControlD
- TMA = ControlD
- TMZ = Tmz
- GLIDING = GliderSector
- OTH = AirUkn
- WAVE = WaveWindow
Note! You only need to define the values you actually want to change
in the read airspace file. These instructions will overwrite the default
mappings.
Example: CTR=ControlC
This statement changes the default assignment ControlD to ControlC.
Remember that the mapping definitions are case-sensitive! Otherwise the
mapping rules will fail.