Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

ID:

AIXM-402

target version:

AIXM 5.2

version:

1.0

last updated:

09 MAY 2019

status:

APPROVED


Table of Contents
printablefalse

Description

An attribute allowing to provide an ICAO country code is added to Designated Point and Navaid.

Rationale for change

See https://aixmccb.atlassian.net/browse/AIXM-194 

This code will help identify the region of the world where the Designated Point or Navaid is located.  This would improve the compatibility with ARINC 424, in two ways:

  • enable to store the incoming information from an ARINC 424 data source and/or 
  • provide out the country code to the data integrators. 

Note: Within a region identified by a single letter (such as K, C, etc.), the individual countries or territories may specify a second character (letter or number). 

The current model already has a data type CodeICAOCountry that is defined as “The one or two letter country code identifier as published in the ICAO DOC 7910 - Location Indicators.” This is used by the codeICAO attribute of the FASDataBlock. However, it allows an unlimited number of alphanumeric characters. This needs to be constrained with a maximum length of 2 characters.

Impact assessment

There is no impact on existing implementations as the current

Image Added

[FWD_1:1] No data mapping is necessary and no data loss occurs when data is exchanged from a system (A) that uses AIXM 5.1

(

.1

) data remains fully valid against

for output towards a system (B) that uses AIXM 5.2

.When receiving data from AIXM 5.2 implementations, current

for input.

[BWD_MAP_LOSS] Data mapping is possible, but some data would be lost (or converted into Notes) when data is exchanged from a system (B) that uses AIXM 5.2 for output towards a system (A) that uses AIXM 5.1

(.1) systems that are interested in this data will have to be able to map back the ICAO property, as described in the mapping rules further in this document.  The data can only me mapped as notes, because the corresponding concept does not exist in the current model. 

.1 for input.

Change Proposal details

In the UML model, add the following attribute to DesignatedPoint:

  • codeICAOCountry with data type of CodeICAOCountryType and definition of "A code derived from the International Civil Aviation Organization (ICAO) list of nationality letters in Document 7910, which represents a State or a sub-region of that State where the point is located.
    Note: for points located on the border between two countries, the ICAO Country Code of the State having formally registered the five-letter code in the ICAO ICARD system is expected to used."

In the UML model, add the following attribute to Navaid:

  • codeICAOCountry with data type of CodeICAOCountryType and definition of "A code derived from the International Civil Aviation Organization (ICAO) list of nationality letters in Document 7910, which represents a State or a sub-region of that State where the point is located".

In the UML model, add the following constraint to the definition of the CodeICAOCountryBaseType:

  • maxLength = 2

The two new attributes are highlighted in UML class diagram at the right.

Mapping AIXM 5.1.1 to AIXM 5.2 (forward)

NIL (Not applicable)

Mapping AIXM 5.2 to AIXM 5.1.1 (backward)

[MAPC-02] From the three backward mapping options applicable in this case, the first two (discard the value or use an extension) are straightforward and do not need any further details. The 3rd option (backward mapping into a Note) is detailed in order to provide a complete description of this case and its conversion option. The following mapping into Note algorithm is proposed:

For each DesignatedPoint that has a specified codeICAOCountry:

  • Remove the codeICAOCountry
  • Add an annotation.Note associated with the DesignatedPoint class having:
    • purpose=“OTHER:BACKWARD_MAPPING”
    • translatedNote.LinguisticNote.note=”codeICAOCountry: <codeICAOCountry>”;

For each Navaid that has a specified codeICAOCountry:

  • Remove the codeICAOCountry
  • Add an annotation.Note associated with the Navaid class having:
    • purpose=“OTHER:BACKWARD_MAPPING”
    • translatedNote.LinguisticNote.note=”codeICAOCountry: <codeICAOCountry”;

Mapping example

(Note: for mapping test data see: https://github.com/aixm/mapping_52_511/tree/master/AIXM-402

AIXM 5.2AIXM 5.1(.1)
HTML
<pre>
message:AIXMBasicMessage
  message:hasMember
    DesignatedPoint
      gml:identifier = 2fea81e6-023b-4069-b8cd-2ab96da198-
      timeSlice
        DesignatedPointTimeSlice
          gml:validTime
            gml:TimePeriod
              gml:beginPosition = 2017-07-01T00:00:00Z
              gml:endPosition = 
          interpretation = BASELINE
          sequenceNumber = 1
          featureLifetime
            gml:TimePeriod
              gml:beginPosition = 2017-07-01T00:00:00Z
              gml:endPosition = 
          designator = BARAB
          type = OTHER:NAMED_REPORTING_POINT
          name = BARABER
          <font color="blue">codeICAOCountry = LD</font>
          location
            Point
              gml:pos = 45.0000 015.0000
              horizontalAccuracy = 

  ...</pre>





HTML
<pre>
message:AIXMBasicMessage
  message:hasMember
    DesignatedPoint
      gml:identifier = 2fea81e6-023b-4069-b8cd-2ab96da198-
      timeSlice
        DesignatedPointTimeSlice
          gml:validTime
            gml:TimePeriod
              gml:beginPosition = 2017-07-01T00:00:00Z
              gml:endPosition = 
          interpretation = BASELINE
          sequenceNumber = 1
          featureLifetime
            gml:TimePeriod
              gml:beginPosition = 2017-07-01T00:00:00Z
              gml:endPosition = 
          designator = BARAB
          type = OTHER:NAMED_REPORTING_POINT
          name = BARABER
          location
            Point
              gml:pos = 45.0000 015.0000
              horizontalAccuracy = 
          <font color="blue">annotation
            Note
              propertyName = codeICAOCountry
              purpose = OTHER:BACKWARD_MAPPING
              translatedNote
                LinguisticNote
                  note = codeICAOCountry:LD</font>

...</pre>