The European Organisation for the Safety of Air Navigation AIXM 5.1 - UML to XSD AIXM XML Developers' Seminar

The European Organisation for the Safety of Air Navigation

AIXM 5.1 - UML to XSD

AIXM XML Developers' Seminar

UML to XSD – AIXM 5.1 mapping scripts 2

Content

• Overview of AIXM files

• Mapping rules for Datatypes

• Mapping rules for Features

• Presentation AIXM scripts

• Creation of an extension


Overview of AIXM files

• The file AIXM_AbstractGML_ObjectTypes.xsd • References ISO19139 Metadata Schema• Defines the base AIXM Feature Constructs

• AbstractAIXMFeatureType / AbstractAIXMFeature

• AbstractAIXMTimesliceType / AbstractAIXMTimeslice

• The file AIXM_DataTypes.xsd contains the mapping of the AIXM datatypes

• The file AIXM_Features.xsd contains the mapping of the AIXM features

includes

GML 3.2

ISO19139

metadataschema

W3C xlink

AIXM 5.1PropertiesWithSchedule(from Schedules)

<<object>>

ContactInformation

name : TextNameTypetitle : TextNameType

(from Address)

<<object>>

FlightRestrictionRoute

priorPermission : CodeYesNoType

<<object>>

0..*

+contact

0..*

hasContactInstructions

FlightRestriction

designator : CodeFlightRestrictionDesignatorType...type : CodeFlightRestrictionTypeinstruction : TextInstructionType

<<feature>>

0..*

+regulatedRoute

0..*

regulatesUseOf

FlightRoutingElement

orderNumber : NoSequenceTypespeed : ValSpeedTypespeedReference : CodeSpeedReferenceTypespeedCriteria : CodeComparisonType

<<object>>

1..*+routeElement 1..*

isSequenceOf

FlightConditionCombination

logicalOperator : CodeFlowConditionOperationType

<<object>>

1+flight

1

appliesToFlight

FlightConditionCircumstance<<object>>

FlightRestrictionLevel<<object>>

0..* +flightLevel0..*

isRestrictedTo

FlightConditionElement

index : NoSequenceType

<<object>>

0..*+element 0..*

hasOperand

0..1

+operationalCondition

0..1

hasCondition

0..*

+flightLevel

0..*

isApplicableAt

FlightConditionElementChoice<<choice>>

1 +flightCondition1

is


Overview of AIXM files

• AIXM 5.1 Mapping rules explains how to translate the AIXM 5.1 UML model into an XML grammar based on a subset of the Geography Markup Language (GML 3.2)

• Mapping rules are defined for: • AIXM Datatypes• AIXM Features

AIXM 5.1UML

PropertiesWithSchedule(from Schedules)

<<object>>

ContactInformation

name : TextNameTypetitle : TextNameType

(from Address)

<<object>>

FlightRestrictionRoute

priorPermission : CodeYesNoType

<<object>>

0..*

+contact

0..*

hasContactInstructions

FlightRestriction

designator : CodeFlightRestrictionDesignatorType...type : CodeFlightRestrictionTypeinstruction : TextInstructionType

<<feature>>

0..*

+regulatedRoute

0..*

regulatesUseOf

FlightRoutingElement

orderNumber : NoSequenceTypespeed : ValSpeedTypespeedReference : CodeSpeedReferenceTypespeedCriteria : CodeComparisonType

<<object>>

1..*+routeElement 1..*

isSequenceOf

FlightConditionCombination

logicalOperator : CodeFlowConditionOperationType

<<object>>

1+flight

1

appliesToFlight

FlightConditionCircumstance<<object>>

FlightRestrictionLevel<<object>>

0..* +flightLevel0..*

isRestrictedTo

FlightConditionElement

index : NoSequenceType

<<object>>

0..*+element 0..*

hasOperand

0..1

+operationalCondition

0..1

hasCondition

0..*

+flightLevel

0..*

isApplicableAt

FlightConditionElementChoice<<choice>>

1 +flightCondition1

is

AIXM 5.1XSD

AIXM 5.1 Mapping

Rules


AIXM 5.1 - UML to XSDMapping Rules - Datatypes


AIXM 5.1 Mapping Rules - Datatypes

• Mapping <<enumeration>>

CodeAirportHeliportType

AD : stringAH : stringHP : stringLS : stringOTHER : string

(from AIXM Data Types)

<<enumeration>>

string(from XMLSchemaDatatypes)

<<XSDsimpleType>>

<simpleType name="CodeAirportHeliportType"> <union> <simpleType> <restriction base="xsd:string"> <enumeration value="AD"> <annotation> <documentation/> </annotation> </enumeration> <enumeration value="AH“/> <enumeration value="HP“/> <enumeration value="LS“/> </restriction> </simpleType> <simpleType> <restriction base="string"> <pattern value="OTHER:\w{2,58}"/> </restriction> </simpleType> </union></simpleType>



• Mapping <<codelist>>

CodeAerialRefuelingPrefixType

AR : string


<<codelist>>

string(from XMLSchemaDatatypes)

<<XSDsimpleType>>

<simpleType name="CodeAerialRefuelingPrefixType_base"> <annotation> <documentation/> </annotation> <restriction base="xsd:string"> <enumeration value="AR"> <annotation> <documentation/> </annotation> </enumeration> </restriction></simpleType><simpleType name="CodeAerialRefuelingPrefixType"> <union memberTypes="aixm:CodeAerialRefuelingPrefixType_base xsd:string"/></simpleType>



• Mapping <<datatype>>

ValDistanceType

<<XSDfacet>> minInclusive : string = 0uom : UomDistanceType


<<datatype>>

decimal(from XMLSchemaDatatypes)

<<XSDsimpleType>>

UomDistanceType

NM : stringKM : stringM : stringFT : stringMI : stringOTHER : stringCM : string


<<enumeration>>

<simpleType name="ValDistanceTypeBase"> <annotation> <documentation/> </annotation> <restriction base="xsd:decimal"> <minInclusive value="0"/> </restriction></simpleType><complexType name="ValDistanceType"> <simpleContent> <annotation> <documentation/> </annotation> <extension base="aixm:ValDistanceTypeBase"> <attribute name="uom" type="aixm:UomDistanceType" use="required"/> </extension> </simpleContent></complexType>


AIXM 5.1 - UML to XSD Mapping Rules - Features


AIXM 5.1 Mapping Rules - Features

• AIXM is based on GML• AIXM Features are GML features…• AIXM follows the GML object-property concept.

<AirportHeliport>  <ElevatedPoint> 

<AirportHeliport>  <hasReferencePoint>  <ElevatedPoint> 



• For each AIXM Feature in the UML, the following XML schema entities are created:

• FeaturePropertyType• Feature• FeatureType• FeatureTimeSlicePropertyType• FeatureTimeSlice• FeatureTimeSliceType• FeaturePropertyGroup

• AIXM objects are encoded as GML objects. The mapping rule for Objects are the same as the rules for Features except that

• Object do not exist outside of a feature• TimeSlice types and elements are not created



Runway

designator : TextDesignatorTypetype : CodeRunwayTypenominalLength : ValDistanceTypelengthAccuracy : ValDistanceTypenominalWidth : ValDistanceTypewidthAccuracy : ValDistanceTypewidthShoulder : ValDistanceTypelengthStrip : ValDistanceTypewidthStrip : ValDistanceTypelengthOffset : ValDistanceSignedTypewidthOffset : ValDistanceSignedTypeabandoned : CodeYesNoType

<<feature>>

RunwayPropertyTypeRunwayRunwayTypeRunwayTimeSlicePropertyTypeRunwayTimeSliceRunwayTimeSliceTypeRunwayPropertyGroup

<group name="RunwayPropertyGroup"> <sequence> <element name="designator" nillable="true" minOccurs="0"> [………………] <complexType> <simpleContent> <extension base="aixm:TextDesignatorType"> <attribute name="nilReason" type="gml:NilReasonEnumeration"/> </extension> </simpleContent> </complexType> </element> <element name="type" nillable="true" minOccurs="0"> [………………] </sequence></group>

UML properties are mapped into FeaturePropertyGroup



Runway


<<feature>>

0..1hasSurfaceDescribedBy

+surfaceProperties

0..1

SurfaceCharacteristics

composition : CodeSurfaceCompositionTypepreparation : CodeSurfacePreparationTypesurfaceCondition : CodeSurfaceConditionTypeclassPCN : ValPCNTypepavementTypePCN : CodePCNPavementTypepavementSubgradePCN : CodePCNSubgradeTypemaxTyrePressurePCN : CodePCNTyrePressureTypeevaluationMethodPCN : CodePCNMethodTypeclassLCN : ValLCNTypeweightSIWL : ValWeightTypetyrePressureSIWL : ValPressureTypeweightAUW : ValWeightType

(from Airport/Hel iport)

<<object>>Runway


<<feature>>


<group name="RunwayPropertyGroup"> <sequence> <element name="designator" nillable="true" minOccurs="0"> [………………] <element name="surfaceProperties" nillable="true" minOccurs="0"> <complexType> <complexContent>

<extension base="aixm:SurfaceCharacteristicsPropertyType"> <attribute name="nilReason" type="gml:NilReasonEnumeration"/></extension>

</complexContent> </complexType> </element> [………………]



1

AirportHeliport(from Airport/Hel iport)

<<feature>>+associatedAirportHeliport

0..*1

isSituatedAt0..*

Runway


<<feature>>Runway


<<feature>>


UML properties are mapped into FeaturePropertyGroup

<group name="RunwayPropertyGroup"> <sequence> <element name="designator" nillable="true" minOccurs="0"> [………………] <element name="type" nillable="true" minOccurs="0"> [………………] <element name="associatedAirportHeliport" type="aixm:AirportHeliportPropertyType" nillable="true" minOccurs="0"> [………………] </sequence></group>



<complexType name="RunwayTimeSliceType"> <complexContent> <extension base="aixm:AbstractAIXMTimeSliceType"> <sequence> <group ref="aixm:RunwayPropertyGroup"/> <element name="extension" minOccurs="0" maxOccurs="unbounded"> <complexType> <sequence> <element ref="aixm:AbstractRunwayExtension"/> </sequence> <attributeGroup ref="gml:OwnershipAttributeGroup"/> </complexType> </element> </sequence> </extension> </complexContent></complexType>

Runway


<<feature>>


AIXMTimeSlice

validTime : TimePrimitiveinterpretation : TimeSliceInterpretationTypesequenceNumber : NoNumberTypecorrectionNumber : NoNumberType

(from AIXM Abstract Feature) The RunwayTimeSliceType encapsulates all the Runway properties that change over time


Runway


<<feature>>


AIXMTimeSlice


(from AIXM Abstract Feature)


<element name="RunwayTimeSlice" type="aixm:RunwayTimeSliceType" substitutionGroup="gml:AbstractTimeSlice"/>

RunwayTimeSlice element is of type RunwayTimeSliceType.


Runway


<<feature>>


AIXMTimeSlice




<complexType name="RunwayTimeSlicePropertyType"> <sequence> <element ref="aixm:RunwayTimeSlice"/> </sequence> <attributeGroup ref="gml:OwnershipAttributeGroup"/></complexType>

A GML property type containing a FeatureTimeSlice objects is created.


AIXMTimeSlice



1..*1..*

+timeSliceAIXMFeature

identifier : CodeUUIDType


<complexType name="RunwayType"> <complexContent> <extension base="aixm:AbstractAIXMFeatureType"> <sequence> <element name="timeSlice" type="aixm:RunwayTimeSlicePropertyType" maxOccurs="unbounded"/> </sequence> </extension> </complexContent></complexType>

Runway


<<feature>>


AIXMFeature




The Runway feature type is created extending the AbstractAIXMFeatureType with the RunwayTimeSlice object created before.


Runway


<<feature>>


AIXMFeature




<element name="Runway" type="aixm:RunwayType" substitutionGroup="aixm:AbstractAIXMFeature"> <annotation> <documentation>A defined rectangular area on a land aerodrome/heliport prepared for the landing and take-off of aircraft.Note: this includes the concept of Final Approach and Take-Off Area (FATO) for helicopters. </documentation> </annotation></element>

The Runway feature is then defined by the RunwayType.



Runway


<<feature>>


<complexType name="RunwayPropertyType"> <attributeGroup ref="gml:OwnershipAttributeGroup"/> <attributeGroup ref="gml:AssociationAttributeGroup"/></complexType>

Used for relationship to feature Runway

Provides the xlink:href attribute


AIXM 5.1 - UML to XSDAIXM Scripts


AIXM 5.1 - UML to XSDWalkthrough AIXM 5.1 XSD Schemas


AIXM 5.1 - UML to XSDCreation of an extension


UML Extension

• A feature or object may be extended by creating a class with the same name as the core AIXM feature and giving it a stereotype <<extension>>.

Airspace

flexibleUse : CodeYesNoTypelevel1 : CodeYesNoTypelevel2 : CodeYesNoTypelevel3 : CodeYesNoType

<<extension>>

Airspace(from Airspace)

<<feature>>

• New classes (features and objects), that do not extend existing AIXM Core classes, can be also created.

Mission

identification : TextDesignatorTypename : TextNameTypeformationCode : CodeMissionFormationType...

<<feature>>

1

0..*

+reason 1

0..*

isExecutedFor

FlightFormation

flightIdentification : TextDesignatorType...numberOfAircraft : NoNumberTypetransitDuration : ValDurationType

<<feature>>

0..*0..* 0..*uses0..*Airspace(from Airspace)

<<feature>>


UML Extension

• Extensions shall NOT be included in the core AIXM packages


AIXM 5.1 Mapping Rules - Extensions

• AIXM_Features.xsd is defined in such a way that multiple extensions can be included in the core FeatureTimesliceType

• Features with the stereotype of <<extension>> generates three related elements for that class.• FeatureExtensionPropertyGroup• FeatureExtensionType• FeatureExtension

<complexType name="AirspaceTimeSliceType"> <complexContent> <extension base="aixm:AbstractAIXMTimeSliceType"> <sequence> <group ref="aixm:AirspacePropertyGroup"/> <element name="extension" minOccurs="0" maxOccurs="unbounded"> <complexType> <sequence> <element ref="aixm:AbstractAirspaceExtension"/> […………….]




<<feature>>

Airspace


<<extension>>

AirspaceExtensionAirspaceExtensionTypeAirspaceExtensionPropertyGroup

<group name="AirspaceExtensionPropertyGroup"> <sequence> <element name="flexibleUse" nillable="true" minOccurs="0"> […………….] <element name="level1" nillable="true" minOccurs="0"> […………….] </sequence></group>




<<feature>>

Airspace


<<extension>>


<complexType name="AirspaceExtensionType"> <complexContent> <extension base="aixm:AbstractExtensionType"> <sequence> <group ref="easm:AirspaceExtensionPropertyGroup"/> </sequence> </extension> </complexContent></complexType>

A relationship is created with an abstract XML element that acts as the root for all extensions.



<element name="AirspaceExtension" type="easm:AirspaceExtensionType“ substitutionGroup="aixm:AbstractAirspaceExtension"/>


<<feature>>

Airspace


<<extension>>



Focus on AIXM Basic Message

AIXMBasicMessage<<message>>

AIXMFeature



BasicMessageMemberAIXM<<collectionMemberChoice>>

1..*1..*

hasMember

11

isFeature

Basic Message • is an AIXM 5.1 extension• contains just a collection of

AIXM features

Documents

The European Organisation for the Safety of Air Navigation AIXM 5.1 - UML to XSD AIXM XML Developers' Seminar