aixm 0.3.8 → 0.3.10

data/lib/aixm/component/lighting.rb

@@ -1,7 +1,7 @@
 using AIXM::Refinements
 
 module AIXM
-  class Component
+  module Component
 
     # Lighting of a runway, helipad etc
     #
@@ -14,10 +14,13 @@ module AIXM
     #   lighting.color = COLORS or nil
     #   lighting.remarks = String or nil
     #
-    # @see https://github.com/openflightmaps/ofmx/wiki/Airport#rls-runway-direction-lighting
-    # @see https://github.com/openflightmaps/ofmx/wiki/Airport#fls-fato-direction-lighting
-    # @see https://github.com/openflightmaps/ofmx/wiki/Airport#tls-helipad-tlof-lighting
+    # @see https://gitlab.com/openflightmaps/ofmx/wikis/Airport#rls-runway-direction-lighting
+    # @see https://gitlab.com/openflightmaps/ofmx/wikis/Airport#fls-fato-direction-lighting
+    # @see https://gitlab.com/openflightmaps/ofmx/wikis/Airport#tls-helipad-tlof-lighting
     class Lighting
+      include AIXM::Association
+      include AIXM::Memoize
+
       POSITIONS = {
         TDZ: :touch_down_zone,
         AIM: :aiming_point,
@@ -54,8 +57,9 @@ module AIXM
         OTHER: :other   # specify in remarks
       }
 
-      # @return [AIXM::Component::Runway::Direction, AIXM::Component::FATO::Direction, AIXM::Component::Helipad] lighted entity
-      attr_reader :lightable
+      # @!method lightable
+      #   @return [AIXM::Component::Runway::Direction, AIXM::Component::FATO::Direction, AIXM::Component::Helipad] lighted entity
+      belongs_to :lightable
 
       # @return [Symbol, nil] position of the lighting system (see {POSITIONS})
       attr_reader :position
@@ -81,12 +85,6 @@ module AIXM
         %Q(#<#{self.class} position=#{position.inspect}>)
       end
 
-      def lightable=(value)
-        fail(ArgumentError, "invalid lightable") unless value.respond_to? :lightings
-        @lightable = value
-      end
-      private :lightable=
-
       def position=(value)
         @position = POSITIONS.lookup(value.to_s.to_sym, nil) || fail(ArgumentError, "invalid position")
       end
@@ -113,8 +111,9 @@ module AIXM
         builder.tag!(as) do |tag|
           tag << lightable.to_uid.indent(2)
           tag.codePsn(POSITIONS.key(position).to_s)
-        end.insert_payload_hash(region: AIXM.config.mid_region)
+        end
       end
+      memoize :to_uid
 
       # @return [String] AIXM or OFMX markup
       def to_xml(as:)

data/lib/aixm/component/runway.rb

@@ -1,7 +1,7 @@
 using AIXM::Refinements
 
 module AIXM
-  class Component
+  module Component
 
     # Runways are landing and takeoff strips for forward propelled aircraft.
     #
@@ -44,8 +44,11 @@ module AIXM
     #   runway.forth.geographic_orientation = 165
     #   runway.back = nil
     #
-    # @see https://github.com/openflightmaps/ofmx/wiki/Airport#rwy-runway
+    # @see https://gitlab.com/openflightmaps/ofmx/wikis/Airport#rwy-runway
     class Runway
+      include AIXM::Association
+      include AIXM::Memoize
+
       STATUSES = {
         CLSD: :closed,
         WIP: :work_in_progress,          # e.g. construction work
@@ -55,8 +58,21 @@ module AIXM
         OTHER: :other                    # specify in remarks
       }
 
-      # @return [AIXM::Feature::Airport] airport the runway belongs to
-      attr_reader :airport
+      # @!method forth
+      #   @return [AIXM::Component::Runway::Direction] main direction
+      # @!method forth=(forth)
+      #   @param forth [AIXM::Component::Runway::Direction]
+      has_one :forth, accept: 'AIXM::Component::Runway::Direction'
+
+      # @!method back
+      #   @return [AIXM::Component::Runway::Direction, nil] reverse direction
+      # @!method back=(back)
+      #   @param back [AIXM::Component::Runway::Direction, nil]
+      has_one :back, accept: 'AIXM::Component::Runway::Direction', allow_nil: true
+
+      # @!method airport
+      #   @return [AIXM::Feature::Airport] airport the runway belongs to
+      belongs_to :airport
 
       # @return [String] full name of runway (e.g. "12/30" or "16L/34R")
       attr_reader :name
@@ -76,18 +92,12 @@ module AIXM
       # @return [String, nil] free text remarks
       attr_reader :remarks
 
-      # @return [AIXM::Component::Runway::Direction] main direction
-      attr_accessor :forth
-
-      # @return [AIXM::Component::Runway::Direction] reverse direction
-      attr_accessor :back
-
       def initialize(name:)
         self.name = name
-        @name.split("/").tap do |forth, back|
-          @forth = Direction.new(runway: self, name: AIXM.a(forth))
-          @back = Direction.new(runway: self, name: AIXM.a(back)) if back
-          fail(ArgumentError, "invalid name") unless !@back || @back.name.inverse_of?(@forth.name)
+        @name.split("/").tap do |forth_name, back_name|
+          self.forth = Direction.new(name: AIXM.a(forth_name))
+          self.back = Direction.new(name: AIXM.a(back_name)) if back_name
+          fail(ArgumentError, "invalid name") unless !back || back.name.inverse_of?(@forth.name)
         end
         @surface = AIXM.surface
       end
@@ -97,12 +107,6 @@ module AIXM
         %Q(#<#{self.class} airport=#{airport&.id.inspect} name=#{name.inspect}>)
       end
 
-      def airport=(value)
-        fail(ArgumentError, "invalid airport") unless value.is_a? AIXM::Feature::Airport
-        @airport = value
-      end
-      private :airport=
-
       def name=(value)
         fail(ArgumentError, "invalid name") unless value.is_a? String
         @name = value.uptrans
@@ -138,8 +142,9 @@ module AIXM
         builder.RwyUid do |rwy_uid|
           rwy_uid << airport.to_uid.indent(2)
           rwy_uid.txtDesig(name)
-        end.insert_payload_hash(region: AIXM.config.mid_region)
+        end
       end
+      memoize :to_uid
 
       # @return [String] AIXM or OFMX markup
       def to_xml
@@ -167,16 +172,27 @@ module AIXM
       # Runway directions further describe each direction {#forth} and {#back}
       # of a runway.
       #
-      # @see https://github.com/openflightmaps/ofmx/wiki/Airport#rdn-runway-direction
+      # @see https://gitlab.com/openflightmaps/ofmx/wikis/Airport#rdn-runway-direction
       class Direction
+        include AIXM::Association
+        include AIXM::Memoize
+
         VFR_PATTERNS = {
           L: :left,
           R: :right,
           E: :left_or_right
         }
 
-        # @return [AIXM::Component::Runway] runway the runway direction is further describing
-        attr_reader :runway
+        # @!method lightings
+        #   @return [Array<AIXM::Component::Lighting>] installed lighting systems
+        # @!method add_lighting(lighting)
+        #   @param lighting [AIXM::Component::Lighting]
+        #   @return [self]
+        has_many :lightings, as: :lightable
+
+        # @!method runway
+        #   @return [AIXM::Component::Runway] runway the runway direction is further describing
+        belongs_to :runway, readonly: true
 
         # @return [AIXM::A] partial name of runway (e.g. "12" or "16L")
         attr_reader :name
@@ -201,12 +217,8 @@ module AIXM
         # @return [String, nil] free text remarks
         attr_reader :remarks
 
-        # @return [Array<AIXM::Component::Lighting>] installed lighting systems
-        attr_reader :lightings
-
-        def initialize(runway:, name:)
-          self.runway, self.name = runway, name
-          @lightings = []
+        def initialize(name:)
+          self.name = name
         end
 
         # @return [String]
@@ -214,12 +226,6 @@ module AIXM
           %Q(#<#{self.class} airport=#{runway&.airport&.id.inspect} name=#{name.inspect}>)
         end
 
-        def runway=(value)
-          fail(ArgumentError, "invalid runway") unless value.is_a? AIXM::Component::Runway
-          @runway = value
-        end
-        private :runway
-
         def name=(value)
           fail(ArgumentError, "invalid name") unless value.is_a? AIXM::A
           @name = value
@@ -263,17 +269,6 @@ module AIXM
           @remarks = value&.to_s
         end
 
-        # Add a lighting system to the runway direction.
-        #
-        # @param lighting [AIXM::Component::Lighting] lighting instance
-        # @return [self]
-        def add_lighting(lighting)
-          fail(ArgumentError, "invalid lighting") unless lighting.is_a? AIXM::Component::Lighting
-          lighting.send(:lightable=, self)
-          @lightings << lighting
-          self
-        end
-
         # @return [AIXM::A] magnetic orientation (magnetic bearing) in degrees
         def magnetic_orientation
           if geographic_orientation && runway.airport.declination
@@ -287,8 +282,9 @@ module AIXM
           builder.RdnUid do |rdn_uid|
             rdn_uid << runway.to_uid.indent(2)
             rdn_uid.txtDesig(name)
-          end.insert_payload_hash(region: AIXM.config.mid_region)
+          end
         end
+        memoize :to_uid
 
         # @return [String] AIXM or OFMX markup
         def to_xml

data/lib/aixm/{feature → component}/service.rb

@@ -1,22 +1,22 @@
 using AIXM::Refinements
 
 module AIXM
-  class Feature
+  module Component
 
     # Service provided by a unit.
     #
     # ===Cheat Sheet in Pseudo Code:
     #   service = AIXM.service(
-    #     source: String or nil
     #     type: TYPES
     #   )
     #   service.timetable = AIXM.timetable or nil
     #   service.remarks = String or nil
     #   service.add_frequency(AIXM.frequency)
     #
-    # @see https://github.com/openflightmaps/ofmx/wiki/Organisation#ser-service
-    class Service < Feature
-      public_class_method :new
+    # @see https://gitlab.com/openflightmaps/ofmx/wikis/Organisation#ser-service
+    class Service
+      include AIXM::Association
+      include AIXM::Memoize
 
       TYPES = {
         ACS: :area_control_service,
@@ -125,10 +125,21 @@ module AIXM
         :vhf_direction_finding_service => :vdf_direction_finding_station,
         :volmet_service => :meteorological_office,
         :other => :other
-}
+      }.freeze
+
+      # @!method frequencies
+      #   @return [Array<AIXM::Component::Frequency>] frequencies used by this service
+      # @!method add_frequency(frequency)
+      #   @param frequency [AIXM::Component::Frequency]
+      has_many :frequencies
 
-      # @return [AIXM::Feature::Unit] unit providing this service
-      attr_reader :unit
+      # @!method unit
+      #   @return [AIXM::Feature::Unit] unit providing this service
+      belongs_to :unit
+
+      # @!method layer
+      #   @return [AIXM::Component::Layer] airspace layer this service is provided within
+      belongs_to :layer
 
       # @return [Symbol] type of service (see {TYPES})
       attr_reader :type
@@ -139,13 +150,9 @@ module AIXM
       # @return [String, nil] free text remarks
       attr_reader :remarks
 
-      # @return [Array<AIXM::Component::Frequency>] frequencies used by this service
-      attr_reader :frequencies
-
-      def initialize(source: nil, type:)
-        super(source: source)
+      def initialize(type:)
         self.type = type
-        @frequencies = []
+        @sequence = 1
       end
 
       # @return [String]
@@ -153,12 +160,6 @@ module AIXM
         %Q(#<#{self.class} type=#{type.inspect}>)
       end
 
-      def unit=(value)
-        fail(ArgumentError, "invalid unit") unless value.is_a? AIXM::Feature::Unit
-        @unit = value
-      end
-      private :unit=
-
       def type=(value)
         @type = TYPES.lookup(value&.to_s&.to_sym, nil) || fail(ArgumentError, "invalid type")
       end
@@ -172,17 +173,6 @@ module AIXM
         @remarks = value&.to_s
       end
 
-      # Add a frequency used by this service
-      #
-      # @param frequency [AIXM::Component::Frequency] frequency instance
-      # @return [self]
-      def add_frequency(frequency)
-        fail(ArgumentError, "invalid frequency") unless frequency.is_a? AIXM::Component::Frequency
-        frequency.send(:service=, self)
-        @frequencies << frequency
-        self
-      end
-
       # Guess the unit type for this service
       #
       # @return [Symbol, nil] guessed unit type or +nil+ if unmappable
@@ -192,20 +182,21 @@ module AIXM
 
       # @return [String] UID markup
       def to_uid
+        resequence!
         builder = Builder::XmlMarkup.new(indent: 2)
         builder.SerUid do |ser_uid|
           ser_uid << unit.to_uid.indent(2)
           ser_uid.codeType(TYPES.key(type).to_s)
           ser_uid.noSeq(@sequence)
-        end.insert_payload_hash(region: AIXM.config.mid_region)
+        end
       end
+      memoize :to_uid
 
       # @return [String] AIXM or OFMX markup
-      def to_xml(sequence:)
-        @sequence = sequence
+      def to_xml
         builder = Builder::XmlMarkup.new(indent: 2)
-        builder.comment! ["Service: #{TYPES.key(type)}", unit&.name].compact.join(' by ')
-        builder.Ser({ source: (source if AIXM.ofmx?) }.compact) do |ser|
+        builder.comment! ["Service: #{TYPES.key(type)}", unit&.send(:name_with_type)].compact.join(' by ')
+        builder.Ser do |ser|
           ser << to_uid.indent(2)
           ser << timetable.to_xml(as: :Stt).indent(2) if timetable
           ser.txtRmk(remarks) if remarks
@@ -215,6 +206,16 @@ module AIXM
         end
         builder.target!
       end
+
+      private
+
+      def resequence!
+        unit.services.sort { |a, b| a.type <=> b.type }.each.with_object({}) do |service, sequences|
+          sequences[service.type] = (sequences[service.type] || 0) + 1
+          service.instance_variable_set(:@sequence, sequences[service.type])
+        end
+      end
+
     end
 
   end

data/lib/aixm/component/surface.rb

@@ -1,7 +1,7 @@
 using AIXM::Refinements
 
 module AIXM
-  class Component
+  module Component
 
     # Surface of a runway, helipad etc
     #
@@ -21,7 +21,7 @@ module AIXM
     # * +AIXM::PCN_RE+ - regular expression to match PCN notations
     #
     #
-    # @see https://github.com/openflightmaps/ofmx/wiki/Airport#rwy-runway
+    # @see https://gitlab.com/openflightmaps/ofmx/wikis/Airport#rwy-runway
     class Surface
       COMPOSITIONS = {
         ASPH: :asphalt,
@@ -109,7 +109,7 @@ module AIXM
       def pcn=(value)
         return @pcn = {} if value.nil?
         fail(ArgumentError, "invalid PCN") unless match = value.to_s.upcase.match(PCN_RE)
-        @pcn = match.named_captures.reject{ |k| k == 'pcn' }
+        @pcn = match.named_captures.reject{ _1 == 'pcn' }
       end
 
       def siwl_weight=(value)

data/lib/aixm/component/timetable.rb

@@ -1,7 +1,7 @@
 using AIXM::Refinements
 
 module AIXM
-  class Component
+  module Component
 
     # Timetables define activity time windows.
     #
@@ -17,7 +17,7 @@ module AIXM
     # * +AIXM::H24+ - continuous, all day and all night
     # * +AIXM::H_RE+ - pattern matching working hour codes
     #
-    # @see https://github.com/openflightmaps/ofmx/wiki/Timetable#predefined-timetable
+    # @see https://gitlab.com/openflightmaps/ofmx/wikis/Timetable#predefined-timetable
     class Timetable
       CODES = {
         H24: :continuous,           # all day and all night

data/lib/aixm/component/{vertical_limits.rb → vertical_limit.rb}

@@ -1,9 +1,9 @@
 using AIXM::Refinements
 
 module AIXM
-  class Component
+  module Component
 
-    # Vertical limits define a 3D airspace vertically. They are often noted in
+    # Vertical limit defines a 3D airspace vertically. It is often noted in
     # AIP as follows:
     #
     #   upper_z
@@ -13,7 +13,7 @@ module AIXM
     #   (min_z)   whichever is lower
     #
     # ===Cheat Sheet in Pseudo Code:
-    #   vertical_limits = AIXM.vertical_limits(
+    #   vertical_limit = AIXM.vertical_limit(
     #     upper_z: AIXM.z
     #     max_z: AIXM.z or nil
     #     lower_z: AIXM.z
@@ -24,14 +24,20 @@ module AIXM
     # * +AIXM::GROUND+ - surface expressed as "0 ft QFE"
     # * +AIXM::UNLIMITED+ - no upper limit expressed as "FL 999"
     #
-    # @see https://github.com/openflightmaps/ofmx/wiki/Airspace#ase-airspace
-    class VerticalLimits
+    # @see https://gitlab.com/openflightmaps/ofmx/wikis/Airspace#ase-airspace
+    class VerticalLimit
+      include AIXM::Association
+
       # @api private
       TAGS = { upper_z: :Upper, lower_z: :Lower, max_z: :Max, min_z: :Mnm }.freeze
 
       # @api private
       CODES = { qfe: :HEI, qnh: :ALT, qne: :STD }.freeze
 
+      # @!method layer
+      #   @return [AIXM::Component::Layer] layer to which this vertical limit applies
+      belongs_to :layer
+
       # @return [AIXM::Z] upper limit
       attr_reader :upper_z
 
@@ -50,7 +56,7 @@ module AIXM
 
       # @return [String]
       def inspect
-        payload = %i(upper_z max_z lower_z min_z).map { |l| %Q(#{l}="#{send(l)}") if send(l) }.compact
+        payload = %i(upper_z max_z lower_z min_z).map { %Q(#{_1}="#{send(_1)}") if send(_1) }.compact
         %Q(#<#{self.class} #{payload.join(' ')}>)
       end