Class: DWML

Inherits:
Object
  • Object
show all
Defined in:
lib/dwml.rb,
lib/dwml/error.rb,
lib/dwml/version.rb,
lib/dwml/location.rb,
lib/dwml/time_layout.rb,
lib/dwml/data_extractor.rb,
lib/dwml/head_extractor.rb,
lib/dwml/parameter_extractor.rb

Overview

The DWML class is the main entrypoint for processing DWML Nokogiri XML documents.

See http://graphical.weather.gov/xml/mdl/XML/Design/MDL_XML_Design.pdf for authoritative type definitions

Usage

output = DWML.new(nokogiri_xml_doc).process

Defined Under Namespace

Classes: DataExtractor, Error, HeadExtractor, Location, NokogiriDocumentError, ParameterExtractor, TimeLayout

Constant Summary collapse

VERSION = 
"1.2.0"

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(xmldoc) ⇒ DWML

Creates a new instance of the DWML class.

Parameters:

  • Nokogiri::XML::Document 


26
27
28
29
 
# File 'lib/dwml.rb', line 26

def initialize(xmldoc)
  @xmldoc = xmldoc
  @output = {}
end

Instance Attribute Details

#output ⇒ Object (readonly)

Returns the value of attribute output.



19
20
21
 
# File 'lib/dwml.rb', line 19

def output
  @output
end

#xmldoc ⇒ Object (readonly)

Returns the value of attribute xmldoc.



19
20
21
 
# File 'lib/dwml.rb', line 19

def xmldoc
  @xmldoc
end

Instance Method Details

#process ⇒ Hash

Processes the associated XML document with DWML object and returns a detailed hash of the weather metrics and also stores it in the @output instance variable.

Hash Structure

The returned hash will have a consistent structure under :product and :source keys. The :parameters value will vary depending on the original XML/DWML document that is passed to DWML.new.

Example Output

{:title=>"NOAA's National Weather Service Forecast Data", :field=>"meteorological", :category=>"forecast", :creation_date=>Thu, 05 Mar 2020 18:49:42 UTC +00:00, :source=> "Meteorological Development Laboratory - Product Generation Branch", :more_information=>"https://graphical.weather.gov/xml/", :disclaimer=>"http://www.nws.noaa.gov/disclaimer.html", :credit=>"https://www.weather.gov/", :credit_logo=>"https://www.weather.gov/logorequest", :feedback=>"https://www.weather.gov/contact", :parameters=> {:latitude=>38.99, :longitude=>-77.01, :temperature=> {:maximum=> {:name=>"Daily Maximum Temperature", :values=> [{:value=>48.0, :start_time=>Sat, 07 Mar 2020 12:00:00 UTC +00:00, :unit=>"Fahrenheit", :end_time=>Sun, 08 Mar 2020 00:00:00 UTC +00:00, :start_time=>Sun, 08 Mar 2020 12:00:00 UTC +00:00, :unit=>"Fahrenheit", :end_time=>Mon, 09 Mar 2020 00:00:00 UTC +00:00, :start_time=>Mon, 09 Mar 2020 12:00:00 UTC +00:00, :unit=>"Fahrenheit", :end_time=>Tue, 10 Mar 2020 00:00:00 UTC +00:00, :start_time=>Tue, 10 Mar 2020 12:00:00 UTC +00:00, :unit=>"Fahrenheit", :end_time=>Wed, 11 Mar 2020 00:00:00 UTC +00:00, :start_time=>Wed, 11 Mar 2020 12:00:00 UTC +00:00, :unit=>"Fahrenheit", :end_time=>Thu, 12 Mar 2020 00:00:00 UTC +00:00]}, :minimum=> Minimum Temperature", :values=> [{:value=>35.0, :start_time=>Sat, 07 Mar 2020 00:00:00 UTC +00:00, :unit=>"Fahrenheit", :end_time=>Sat, 07 Mar 2020 13:00:00 UTC +00:00, :start_time=>Sun, 08 Mar 2020 01:00:00 UTC +00:00, :unit=>"Fahrenheit", :end_time=>Sun, 08 Mar 2020 13:00:00 UTC +00:00, :start_time=>Mon, 09 Mar 2020 00:00:00 UTC +00:00, :unit=>"Fahrenheit", :end_time=>Mon, 09 Mar 2020 13:00:00 UTC +00:00, :start_time=>Tue, 10 Mar 2020 00:00:00 UTC +00:00, :unit=>"Fahrenheit", :end_time=>Tue, 10 Mar 2020 13:00:00 UTC +00:00, :start_time=>Wed, 11 Mar 2020 00:00:00 UTC +00:00, :unit=>"Fahrenheit", :end_time=>Wed, 11 Mar 2020 13:00:00 UTC +00:00]}}}}}

Returns:

  • (Hash) 


111
112
113
114
115
116
117
118
119
 
# File 'lib/dwml.rb', line 111

def process
  if @xmldoc.is_a?(Nokogiri::XML::Document)
    build_head
    build_data
    output
  else
    raise DWML::NokogiriDocumentError, "The input is not an Nokogiri::XML::Document"
  end
end