aemo 0.7.2 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea699afbf970dfa72f1188990acfc13264b29d98e214c6085bc9685079790f1e
-  data.tar.gz: 9ceef79d54bdb445c9583b1220efa370ef819c249636a5d8a4edb452291ac9c2
+  metadata.gz: 284b65f74f29337015ac3c4072c3599068565538962eec46d07e2c3a5d37f1f3
+  data.tar.gz: 8c4142b329c6bc78f7a2407572d5adbf041659a90362ee5eb8c3595f7f9f41ac
 SHA512:
-  metadata.gz: 7395b0db22261ee71ad2ddb3c29c995e148111a2078063a04eaa9fb061efc13d9c5f44721e2a1d4fafc8ca65ccf7617820bc8be2454c93c75ba41128c31c922c
-  data.tar.gz: af63516810c79d07494122ca103c004d89bfeeac50ca51a4d32c32b1af8d3fb29c26393606b7d7b4ae286f1a50617407a9bbe9accc9482d573a2d35a98a71833
+  metadata.gz: fbf2afed45b613df53d4f01d1785b9e4b504859d8002fdb1180dfd4977b638eedf4e3cb6b294bd83bc6d923e12cff6474e03a571e6d012410e4ef943f9db4a52
+  data.tar.gz: 4288d1a9c8eeccc67a1020d7d86b8377080f34a89f2c3ebeb28d8b873a6ec84ba502dad650cd798cf4d87ef6d2c9bae2ef28a129b6e18a27f8e9a0fe1b157fe8

data/lib/aemo/meter_data/flag/method.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module AEMO
+  module MeterData
+    class Flag
+      # Method flags for NEM12/NEM13 meter data
+      # @since 0.1.4
+      METHOD_FLAGS = {
+        11 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Check', description: '' },
+        12 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Calculated', description: '' },
+        13 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'SCADA', description: '' },
+        14 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Retrospective Like Day', description: 'Updated v7.8' },
+        15 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Retrospective Average Like Day', description: 'Updated v7.8' },
+        16 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Agreed', description: '[OBSOLETE] v7.8' },
+        17 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Linear', description: '' },
+        18 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Alternate', description: '' },
+        19 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Zero', description: '' },
+        20 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Prospective Like Day',
+                description: 'Updated v7.8' },
+        21 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Five-minute No Historical Data',
+                description: 'Added v7.8' },
+        22 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Prospective Ave Like Day',
+                description: 'Added v7.8' },
+        23 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Previous Year',
+                description: 'Added v7.8' },
+        24 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Data Scaling',
+                description: 'Added v7.8' },
+        25 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'ADL',
+                description: 'Added v7.8' },
+        51 => { type: %w[EST SUB], installation_type: 5, short_descriptor: 'Previous Year', description: '' },
+        52 => { type: %w[EST SUB], installation_type: 5, short_descriptor: 'Previous Read', description: '' },
+        53 => { type: %w[SUB], installation_type: 5, short_descriptor: 'Revision', description: '' },
+        54 => { type: %w[SUB], installation_type: 5, short_descriptor: 'Linear', description: '' },
+        55 => { type: %w[SUB], installation_type: 5, short_descriptor: 'Agreed', description: '' },
+        56 => { type: %w[EST SUB], installation_type: 5, short_descriptor: 'Prior to First Read - Agreed',
+                description: '' },
+        57 => { type: %w[EST SUB], installation_type: 5, short_descriptor: 'Customer Class', description: '' },
+        58 => { type: %w[EST SUB], installation_type: 5, short_descriptor: 'Zero', description: '' },
+        59 => { type: %w[EST SUB], installation_type: 5, short_descriptor: 'Five-minute No Historical Data',
+                description: '' },
+        61 => { type: %w[EST SUB], installation_type: 6, short_descriptor: 'Previous Year', description: '' },
+        62 => { type: %w[EST SUB], installation_type: 6, short_descriptor: 'Previous Read', description: '' },
+        63 => { type: %w[EST SUB], installation_type: 6, short_descriptor: 'Customer Class', description: '' },
+        64 => { type: %w[SUB], installation_type: 6, short_descriptor: 'Agreed', description: '' },
+        65 => { type: %w[EST], installation_type: 6, short_descriptor: 'ADL', description: '' },
+        66 => { type: %w[SUB], installation_type: 6, short_descriptor: 'Revision', description: '' },
+        67 => { type: %w[SUB], installation_type: 6, short_descriptor: 'Customer Read', description: '' },
+        68 => { type: %w[EST SUB], installation_type: 6, short_descriptor: 'Zero', description: '' },
+        69 => { type: %w[SUB], installation_type: 6, short_descriptor: 'Linear extrapolation', description: '' },
+        71 => { type: %w[SUB], installation_type: 7, short_descriptor: 'Recalculation', description: '' },
+        72 => { type: %w[SUB], installation_type: 7, short_descriptor: 'Revised Table', description: '' },
+        73 => { type: %w[SUB], installation_type: 7, short_descriptor: 'Revised Algorithm', description: '' },
+        74 => { type: %w[SUB], installation_type: 7, short_descriptor: 'Agreed', description: '' },
+        75 => { type: %w[EST], installation_type: 7, short_descriptor: 'Existing Table', description: '' }
+      }.freeze
+    end
+  end
+end

data/lib/aemo/meter_data/flag/quality.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module AEMO
+  module MeterData
+    class Flag
+      # Quality flags for NEM12/NEM13 meter data
+      # @since 0.1.4
+      QUALITY_FLAGS = {
+        'A' => 'Actual Data',
+        'E' => 'Forward Estimated Data',
+        'F' => 'Final Substituted Data',
+        'N' => 'Null Data',
+        'S' => 'Substituted Data',
+        'V' => 'Variable Data'
+      }.freeze
+    end
+  end
+end

data/lib/aemo/meter_data/flag/reason_code.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+module AEMO
+  module MeterData
+    class Flag
+      # Reason codes for NEM12/NEM13 meter data
+      # @since 0.1.4
+      REASON_CODES = {
+        0 => 'Free Text Description',
+        1 => 'Meter/Equipment Changed',
+        2 => 'Extreme Weather/Wet',
+        3 => 'Quarantine',
+        4 => 'Savage Dog',
+        5 => 'Meter/Equipment Changed',
+        6 => 'Extreme Weather/Wet',
+        7 => 'Unable To Locate Meter',
+        8 => 'Vacant Premise',
+        9 => 'Meter/Equipment Changed',
+        10 => 'Lock Damaged/Seized',
+        11 => 'In Wrong Walk',
+        12 => 'Locked Premises',
+        13 => 'Locked Gate',
+        14 => 'Locked Meter Box',
+        15 => 'Access - Overgrown',
+        16 => 'Noxious Weeds',
+        17 => 'Unsafe Equipment/Location',
+        18 => 'Read Below Previous',
+        19 => 'Consumer Wanted',
+        20 => 'Damaged Equipment/Panel',
+        21 => 'Switched Off',
+        22 => 'Meter/Equipment Seals Missing',
+        23 => 'Meter/Equipment Seals Missing',
+        24 => 'Meter/Equipment Seals Missing',
+        25 => 'Meter/Equipment Seals Missing',
+        26 => 'Meter/Equipment Seals Missing',
+        27 => 'Meter/Equipment Seals Missing',
+        28 => 'Damaged Equipment/Panel',
+        29 => 'Relay Faulty/Damaged',
+        30 => 'Meter Stop Switch On',
+        31 => 'Meter/Equipment Seals Missing',
+        32 => 'Damaged Equipment/Panel',
+        33 => 'Relay Faulty/Damaged',
+        34 => 'Meter Not In Handheld',
+        35 => 'Timeswitch Faulty/Reset Required',
+        36 => 'Meter High/Ladder Required',
+        37 => 'Meter High/Ladder Required',
+        38 => 'Unsafe Equipment/Location',
+        39 => 'Reverse Energy Observed',
+        40 => 'Timeswitch Faulty/Reset Required',
+        41 => 'Faulty Equipment Display/Dials',
+        42 => 'Faulty Equipment Display/Dials',
+        43 => 'Power Outage',
+        44 => 'Unsafe Equipment/Location',
+        45 => 'Readings Failed To Validate',
+        46 => 'Extreme Weather/Hot',
+        47 => 'Refused Access',
+        48 => 'Timeswitch Faulty/Reset Required',
+        49 => 'Wet Paint',
+        50 => 'Wrong Tariff',
+        51 => 'Installation Demolished',
+        52 => 'Access - Blocked',
+        53 => 'Bees/Wasp In Meter Box',
+        54 => 'Meter Box Damaged/Faulty',
+        55 => 'Faulty Equipment Display/Dials',
+        56 => 'Meter Box Damaged/Faulty',
+        57 => 'Timeswitch Faulty/Reset Required',
+        58 => 'Meter Ok - Supply Failure',
+        59 => 'Faulty Equipment Display/Dials',
+        60 => 'Illegal Connection/Equipment Tampered',
+        61 => 'Meter Box Damaged/Faulty',
+        62 => 'Damaged Equipment/Panel',
+        63 => 'Illegal Connection/Equipment Tampered',
+        64 => 'Key Required',
+        65 => 'Wrong Key Provided',
+        66 => 'Lock Damaged/Seized',
+        67 => 'Extreme Weather/Wet',
+        68 => 'Zero Consumption',
+        69 => 'Reading Exceeds Estimate',
+        70 => 'Probe Reports Tampering',
+        71 => 'Probe Read Error',
+        72 => 'Meter/Equipment Changed',
+        73 => 'Low Consumption',
+        74 => 'High Consumption',
+        75 => 'Customer Read',
+        76 => 'Communications Fault',
+        77 => 'Estimation Forecast',
+        78 => 'Null Data',
+        79 => 'Power Outage Alarm',
+        80 => 'Short Interval Alarm',
+        81 => 'Long Interval Alarm',
+        82 => 'CRC Error',
+        83 => 'RAM Checksum Error',
+        84 => 'ROM Checksum Error',
+        85 => 'Data Missing Alarm',
+        86 => 'Clock Error Alarm',
+        87 => 'Reset Occurred',
+        88 => 'Watchdog Timeout Alarm',
+        89 => 'Time Reset Occurred',
+        90 => 'Test Mode',
+        91 => 'Load Control',
+        92 => 'Added Interval (Data Correction)',
+        93 => 'Replaced Interval (Data Correction)',
+        94 => 'Estimated Interval (Data Correction)',
+        95 => 'Pulse Overflow Alarm',
+        96 => 'Data Out Of Limits',
+        97 => 'Excluded Data',
+        98 => 'Parity Error',
+        99 => 'Energy Type (Register Changed)'
+      }.freeze
+    end
+  end
+end

data/lib/aemo/meter_data/flag.rb

@@ -0,0 +1,280 @@
+# frozen_string_literal: true
+
+require_relative 'flag/quality'
+require_relative 'flag/method'
+require_relative 'flag/reason_code'
+
+module AEMO
+  module MeterData
+    # Represents a NEM12/NEM13 quality flag with validation and conversion capabilities
+    # @since 0.2.0
+    class Flag
+      attr_reader :quality_flag, :method_flag, :reason_code
+
+      # Initialize a new Flag instance
+      #
+      # @param quality_flag [String, nil] the quality flag ('A', 'E', 'F', 'N', 'S', 'V')
+      # @param method_flag [Integer, nil] the method flag (11-75)
+      # @param reason_code [Integer, nil] the reason code (0-99)
+      # @param validate [Boolean] whether to validate the flag (default: true)
+      def initialize(quality_flag: nil, method_flag: nil, reason_code: nil, validate: true)
+        @quality_flag = quality_flag
+        @method_flag = method_flag
+        @reason_code = reason_code
+
+        # Validate the flag if requested
+        self.class.validate!(self) if validate
+      end
+
+      class << self
+        # Create a Flag from a hash (backward compatibility)
+        #
+        # @param hash [Hash, Flag, nil] the hash or Flag instance
+        # @param validate [Boolean] whether to validate the flag (default: false for backward compatibility)
+        # @return [Flag, nil] a new Flag instance or nil if input is nil
+        def from_hash(hash, validate: false)
+          return nil if hash.nil?
+          return hash if hash.is_a?(Flag)
+
+          new(
+            quality_flag: hash[:quality_flag],
+            method_flag: hash[:method_flag],
+            reason_code: hash[:reason_code],
+            validate: validate
+          )
+        end
+
+        # Create a Flag from a quality method string and reason code
+        #
+        # @param quality_method [String] the quality method string (e.g., 'A', 'E52', 'F11')
+        # @param reason_code [String] the reason code ('0'-'99' or '')
+        # @param validate [Boolean] whether to validate the flag (default: false for backward compatibility)
+        # @return [Flag] a new Flag instance
+        def from_quality_method_reason_code(quality_method:, reason_code:, validate: false)
+          quality_flag = quality_method[0]
+          method_flag = quality_method[1, 2].to_i if quality_method.length == 3
+          new(
+            quality_flag:,
+            method_flag:,
+            reason_code: reason_code.blank? ? nil : reason_code.to_i,
+            validate:
+          )
+        end
+
+        # Normalize a flag (apply NEM12 specification rules)
+        #
+        # @param flag_or_hash [Flag, Hash, nil] the flag to normalize
+        # @return [Flag] normalized flag instance
+        #
+        # Normalization rules:
+        # - nil flags become 'A' (Actual Data)
+        # - 'A', 'N' flags: Remove method_flag if present
+        # - 'V' flags: Remove both method_flag and reason_code if present
+        # - Other flags: Preserve as-is
+        def normalize(flag_or_hash)
+          # Handle nil input
+          return new(quality_flag: 'A', validate: false) if flag_or_hash.nil?
+
+          # Convert to Flag if needed
+          flag = flag_or_hash.is_a?(Flag) ? flag_or_hash : from_hash(flag_or_hash)
+
+          normalized_quality = flag.quality_flag || 'A'
+          normalized_method = flag.method_flag
+          normalized_reason = flag.reason_code
+
+          # Apply normalization rules based on quality flag
+          case normalized_quality
+          when 'A', 'N'
+            # A and N: Remove method_flag (reason_code is optional)
+            normalized_method = nil
+          when 'V'
+            # V: Remove both method_flag and reason_code
+            normalized_method = nil
+            normalized_reason = nil
+          end
+
+          new(
+            quality_flag: normalized_quality,
+            method_flag: normalized_method,
+            reason_code: normalized_reason,
+            validate: false
+          )
+        end
+
+        # Validate a flag and raise an error if invalid
+        #
+        # @param flag_or_hash [Flag, Hash, nil] the flag to validate
+        # @return [void]
+        # @raise [ArgumentError] if flag combination is invalid
+        #
+        # NEM12 Specification Requirements:
+        # - 'A' (Actual Data): No method flag, optional reason code
+        # - 'N' (Null Data): No method flag, optional reason code *DEPRECATED*
+        # - 'V' (Variable Data): No method flag, no reason code
+        # - 'E' (Forward Estimated Data): Requires method flag, optional reason code
+        # - 'F' (Final Substituted Data): Requires method flag AND reason code
+        # - 'S' (Substituted Data): Requires method flag AND reason code
+        def validate!(flag_or_hash)
+          return if flag_or_hash.nil?
+
+          flag = from_hash(flag_or_hash)
+
+          quality_flag = flag.quality_flag
+          method_flag = flag.method_flag
+          reason_code = flag.reason_code
+
+          # Validate individual components
+          unless valid_quality_flag?(quality_flag)
+            raise ArgumentError,
+                  "Invalid quality flag: #{quality_flag.inspect}"
+          end
+
+          unless valid_method_flag?(method_flag)
+            raise ArgumentError,
+                  "Invalid method flag: #{method_flag.inspect}"
+          end
+
+          unless valid_reason_code?(reason_code)
+            raise ArgumentError,
+                  "Invalid reason code: #{reason_code.inspect}"
+          end
+
+          # Validate flag combinations according to NEM12 specification
+          case quality_flag
+          when 'A', 'N'
+            # A and N: Should not have method flags, may have reason codes
+            unless method_flag.nil?
+              raise ArgumentError,
+                    "Quality flag '#{quality_flag}' should not have a method flag"
+            end
+          when 'V'
+            # V: Should not have method flags or reason codes
+            unless method_flag.nil?
+              raise ArgumentError,
+                    "Quality flag 'V' should not have a method flag"
+            end
+            unless reason_code.nil?
+              raise ArgumentError,
+                    "Quality flag 'V' should not have a reason code"
+            end
+          when 'E'
+            # E: Requires method flag, may have reason code (optional)
+            if method_flag.nil?
+              raise ArgumentError,
+                    "Quality flag 'E' requires a method flag"
+            end
+          when 'F', 'S'
+            # F and S: Require both method flag and reason code
+            if method_flag.nil?
+              raise ArgumentError,
+                    "Quality flag '#{quality_flag}' requires a method flag"
+            end
+            if reason_code.nil?
+              raise ArgumentError,
+                    "Quality flag '#{quality_flag}' requires a reason code"
+            end
+          end
+        end
+
+        # Validate a quality flag value
+        #
+        # @param quality_flag [String, nil] the quality flag to validate
+        # @return [Boolean] true if valid
+        def valid_quality_flag?(quality_flag)
+          quality_flag.nil? || QUALITY_FLAGS.key?(quality_flag)
+        end
+
+        # Validate a method flag value
+        #
+        # @param method_flag [Integer, nil] the method flag to validate
+        # @return [Boolean] true if valid
+        def valid_method_flag?(method_flag)
+          method_flag.nil? || METHOD_FLAGS.key?(method_flag)
+        end
+
+        # Validate a reason code value
+        #
+        # @param reason_code [Integer, nil] the reason code to validate
+        # @return [Boolean] true if valid
+        def valid_reason_code?(reason_code)
+          reason_code.nil? || REASON_CODES.key?(reason_code)
+        end
+      end
+
+      # Convert flag to quality method string
+      #
+      # @return [String] the quality method string (e.g., 'A', 'E52', 'F11')
+      def to_quality_method
+        return 'A' if quality_flag.nil?
+
+        qf = quality_flag || 'A'
+        mf = method_flag
+
+        # Build quality method string (quality flag + optional method flag)
+        if mf.nil?
+          qf
+        else
+          "#{qf}#{format('%02d', mf)}"
+        end
+      end
+
+      # Convert flag to human-readable string
+      #
+      # @return [String, nil] a hyphenated string for the flag or nil
+      def to_s
+        parts = []
+        parts << QUALITY_FLAGS[quality_flag] unless QUALITY_FLAGS[quality_flag].nil?
+        parts << METHOD_FLAGS[method_flag][:short_descriptor] unless METHOD_FLAGS[method_flag].nil?
+        parts << REASON_CODES[reason_code] unless REASON_CODES[reason_code].nil?
+        parts.empty? ? nil : parts.join(' - ')
+      end
+
+      # Convert flag to hash (backward compatibility)
+      #
+      # @return [Hash] hash representation of the flag
+      def to_h
+        {
+          quality_flag: @quality_flag,
+          method_flag: @method_flag,
+          reason_code: @reason_code
+        }
+      end
+
+      # Equality comparison
+      #
+      # @param other [Flag, Hash] the other flag to compare
+      # @return [Boolean] true if flags are equal
+      def ==(other)
+        if other.is_a?(Flag)
+          quality_flag == other.quality_flag &&
+            method_flag == other.method_flag &&
+            reason_code == other.reason_code
+        elsif other.is_a?(Hash)
+          quality_flag == other[:quality_flag] &&
+            method_flag == other[:method_flag] &&
+            reason_code == other[:reason_code]
+        else
+          false
+        end
+      end
+
+      # Hash code for use in hashes and sets
+      #
+      # @return [Integer] hash code
+      def hash
+        [quality_flag, method_flag, reason_code].hash
+      end
+
+      # Validate the flag and raise an error if invalid
+      #
+      # @return [void]
+      # @raise [ArgumentError] if flag combination is invalid
+      def validate!
+        self.class.validate!(self)
+      end
+
+      # Equality for hash keys
+      alias eql? ==
+    end
+  end
+end

data/lib/aemo/nem12/quality_method.rb

@@ -1,65 +1,5 @@
 # frozen_string_literal: true
 
-module AEMO
-  # Namespace for classes and modules that handle AEMO Gem NEM12 interactions
-  # @since 0.1.4
-  class NEM12
-    QUALITY_FLAGS = {
-      'A' => 'Actual Data',
-      'E' => 'Forward Estimated Data',
-      'F' => 'Final Substituted Data',
-      'N' => 'Null Data',
-      'S' => 'Substituted Data',
-      'V' => 'Variable Data'
-    }.freeze
-
-    METHOD_FLAGS = {
-      11 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Check', description: '' },
-      12 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Calculated', description: '' },
-      13 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'SCADA', description: '' },
-      14 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Retrospective Like Day', description: 'Updated v7.8' },
-      15 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Retrospective Average Like Day', description: 'Updated v7.8' },
-      16 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Agreed', description: '[OBSOLETE] v7.8' },
-      17 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Linear', description: '' },
-      18 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Alternate', description: '' },
-      19 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Zero', description: '' },
-      20 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Prospective Like Day',
-              description: 'Updated v7.8' },
-      21 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Five-minute No Historical Data',
-              description: 'Added v7.8' },
-      22 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Prospective Ave Like Day',
-              description: 'Added v7.8' },
-      23 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Previous Year',
-              description: 'Added v7.8' },
-      24 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'Data Scaling',
-              description: 'Added v7.8' },
-      25 => { type: %w[SUB], installation_type: [1, 2, 3, 4], short_descriptor: 'ADL',
-              description: 'Added v7.8' },
-      51 => { type: %w[EST SUB], installation_type: 5, short_descriptor: 'Previous Year', description: '' },
-      52 => { type: %w[EST SUB], installation_type: 5, short_descriptor: 'Previous Read', description: '' },
-      53 => { type: %w[SUB], installation_type: 5, short_descriptor: 'Revision', description: '' },
-      54 => { type: %w[SUB], installation_type: 5, short_descriptor: 'Linear', description: '' },
-      55 => { type: %w[SUB], installation_type: 5, short_descriptor: 'Agreed', description: '' },
-      56 => { type: %w[EST SUB], installation_type: 5, short_descriptor: 'Prior to First Read - Agreed',
-              description: '' },
-      57 => { type: %w[EST SUB], installation_type: 5, short_descriptor: 'Customer Class', description: '' },
-      58 => { type: %w[EST SUB], installation_type: 5, short_descriptor: 'Zero', description: '' },
-      59 => { type: %w[EST SUB], installation_type: 5, short_descriptor: 'Five-minute No Historical Data',
-              description: '' },
-      61 => { type: %w[EST SUB], installation_type: 6, short_descriptor: 'Previous Year', description: '' },
-      62 => { type: %w[EST SUB], installation_type: 6, short_descriptor: 'Previous Read', description: '' },
-      63 => { type: %w[EST SUB], installation_type: 6, short_descriptor: 'Customer Class', description: '' },
-      64 => { type: %w[SUB], installation_type: 6, short_descriptor: 'Agreed', description: '' },
-      65 => { type: %w[EST], installation_type: 6, short_descriptor: 'ADL', description: '' },
-      66 => { type: %w[SUB], installation_type: 6, short_descriptor: 'Revision', description: '' },
-      67 => { type: %w[SUB], installation_type: 6, short_descriptor: 'Customer Read', description: '' },
-      68 => { type: %w[EST SUB], installation_type: 6, short_descriptor: 'Zero', description: '' },
-      69 => { type: %w[SUB], installation_type: 6, short_descriptor: 'Linear extrapolation', description: '' },
-      71 => { type: %w[SUB], installation_type: 7, short_descriptor: 'Recalculation', description: '' },
-      72 => { type: %w[SUB], installation_type: 7, short_descriptor: 'Revised Table', description: '' },
-      73 => { type: %w[SUB], installation_type: 7, short_descriptor: 'Revised Algorithm', description: '' },
-      74 => { type: %w[SUB], installation_type: 7, short_descriptor: 'Agreed', description: '' },
-      75 => { type: %w[EST], installation_type: 7, short_descriptor: 'Existing Table', description: '' }
-    }.freeze
-  end
-end
+# This file is kept for backward compatibility
+# Constants have been moved to lib/aemo/nem12/meter_data/flag/
+# and are now accessible via AEMO::NEM12::QUALITY_FLAGS and AEMO::NEM12::METHOD_FLAGS

data/lib/aemo/nem12/reason_codes.rb

@@ -1,110 +1,5 @@
 # frozen_string_literal: true
 
-module AEMO
-  # Namespace for classes and modules that handle AEMO Gem NEM12 interactions
-  # @since 0.1.4
-  class NEM12
-    REASON_CODES = {
-      0 => 'Free Text Description',
-      1 => 'Meter/Equipment Changed',
-      2 => 'Extreme Weather/Wet',
-      3 => 'Quarantine',
-      4 => 'Savage Dog',
-      5 => 'Meter/Equipment Changed',
-      6 => 'Extreme Weather/Wet',
-      7 => 'Unable To Locate Meter',
-      8 => 'Vacant Premise',
-      9 => 'Meter/Equipment Changed',
-      10 => 'Lock Damaged/Seized',
-      11 => 'In Wrong Walk',
-      12 => 'Locked Premises',
-      13 => 'Locked Gate',
-      14 => 'Locked Meter Box',
-      15 => 'Access - Overgrown',
-      16 => 'Noxious Weeds',
-      17 => 'Unsafe Equipment/Location',
-      18 => 'Read Below Previous',
-      19 => 'Consumer Wanted',
-      20 => 'Damaged Equipment/Panel',
-      21 => 'Switched Off',
-      22 => 'Meter/Equipment Seals Missing',
-      23 => 'Meter/Equipment Seals Missing',
-      24 => 'Meter/Equipment Seals Missing',
-      25 => 'Meter/Equipment Seals Missing',
-      26 => 'Meter/Equipment Seals Missing',
-      27 => 'Meter/Equipment Seals Missing',
-      28 => 'Damaged Equipment/Panel',
-      29 => 'Relay Faulty/Damaged',
-      30 => 'Meter Stop Switch On',
-      31 => 'Meter/Equipment Seals Missing',
-      32 => 'Damaged Equipment/Panel',
-      33 => 'Relay Faulty/Damaged',
-      34 => 'Meter Not In Handheld',
-      35 => 'Timeswitch Faulty/Reset Required',
-      36 => 'Meter High/Ladder Required',
-      37 => 'Meter High/Ladder Required',
-      38 => 'Unsafe Equipment/Location',
-      39 => 'Reverse Energy Observed',
-      40 => 'Timeswitch Faulty/Reset Required',
-      41 => 'Faulty Equipment Display/Dials',
-      42 => 'Faulty Equipment Display/Dials',
-      43 => 'Power Outage',
-      44 => 'Unsafe Equipment/Location',
-      45 => 'Readings Failed To Validate',
-      46 => 'Extreme Weather/Hot',
-      47 => 'Refused Access',
-      48 => 'Timeswitch Faulty/Reset Required',
-      49 => 'Wet Paint',
-      50 => 'Wrong Tariff',
-      51 => 'Installation Demolished',
-      52 => 'Access - Blocked',
-      53 => 'Bees/Wasp In Meter Box',
-      54 => 'Meter Box Damaged/Faulty',
-      55 => 'Faulty Equipment Display/Dials',
-      56 => 'Meter Box Damaged/Faulty',
-      57 => 'Timeswitch Faulty/Reset Required',
-      58 => 'Meter Ok - Supply Failure',
-      59 => 'Faulty Equipment Display/Dials',
-      60 => 'Illegal Connection/Equipment Tampered',
-      61 => 'Meter Box Damaged/Faulty',
-      62 => 'Damaged Equipment/Panel',
-      63 => 'Illegal Connection/Equipment Tampered',
-      64 => 'Key Required',
-      65 => 'Wrong Key Provided',
-      66 => 'Lock Damaged/Seized',
-      67 => 'Extreme Weather/Wet',
-      68 => 'Zero Consumption',
-      69 => 'Reading Exceeds Estimate',
-      70 => 'Probe Reports Tampering',
-      71 => 'Probe Read Error',
-      72 => 'Meter/Equipment Changed',
-      73 => 'Low Consumption',
-      74 => 'High Consumption',
-      75 => 'Customer Read',
-      76 => 'Communications Fault',
-      77 => 'Estimation Forecast',
-      78 => 'Null Data',
-      79 => 'Power Outage Alarm',
-      80 => 'Short Interval Alarm',
-      81 => 'Long Interval Alarm',
-      82 => 'CRC Error',
-      83 => 'RAM Checksum Error',
-      84 => 'ROM Checksum Error',
-      85 => 'Data Missing Alarm',
-      86 => 'Clock Error Alarm',
-      87 => 'Reset Occurred',
-      88 => 'Watchdog Timeout Alarm',
-      89 => 'Time Reset Occurred',
-      90 => 'Test Mode',
-      91 => 'Load Control',
-      92 => 'Added Interval (Data Correction)',
-      93 => 'Replaced Interval (Data Correction)',
-      94 => 'Estimated Interval (Data Correction)',
-      95 => 'Pulse Overflow Alarm',
-      96 => 'Data Out Of Limits',
-      97 => 'Excluded Data',
-      98 => 'Parity Error',
-      99 => 'Energy Type (Register Changed)'
-    }.freeze
-  end
-end
+# This file is kept for backward compatibility
+# Constants have been moved to lib/aemo/nem12/meter_data/flag/reason_code.rb
+# and are now accessible via AEMO::NEM12::REASON_CODES