cosmos 3.5.1 → 3.5.2

data/lib/cosmos/tools/tlm_grapher/tlm_grapher.rb

@@ -1,87 +1,87 @@
-# encoding: ascii-8bit
-
-# Copyright 2014 Ball Aerospace & Technologies Corp.
-# All Rights Reserved.
-#
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-
-require 'cosmos'
-Cosmos.catch_fatal_exception do
-  require 'cosmos/tools/tlm_grapher/tabbed_plots_tool/tabbed_plots_tool'
-  require 'cosmos/tools/tlm_grapher/data_objects/housekeeping_data_object'
-end
-
-module Cosmos
-
-  # TlmGrapher class
-  #
-  # This class implements the TlmGrapher Application.  This application displays multiple line graphs
-  # that perform various analysis on housekeeping telemetry.
-  #
-  class TlmGrapher < TabbedPlotsTool
-
-    # Runs the application
-    def self.run (opts = nil, options = nil)
-      Cosmos.catch_fatal_exception do
-        unless options
-          opts, options = create_default_options()
-          options.auto_size = false
-          options.width = 1000
-          options.height = 800
-          options.title = "Telemetry Grapher"
-          options.config_dir = 'tlm_grapher'
-          options.config_file = 'tlm_grapher.txt'
-          options.tool_short_name = 'tlmgrapher'
-          options.tabbed_plots_type = 'overview'
-          options.data_object_types = ['HOUSEKEEPING', 'XY','SINGLEXY']
-          options.plot_types = ['LINEGRAPH', 'XY','SINGLEXY']
-          options.plot_type_to_data_object_type_mapping = {'LINEGRAPH' => ['HOUSEKEEPING'], 'XY' => ['XY'], 'SINGLEXY' => ['SINGLEXY']}
-          options.adder_types = ['HOUSEKEEPING']
-          options.adder_orientation = Qt::Horizontal
-          options.items = []
-          options.start = false
-          options.about_string = "TlmGrapher provides realtime and log file graphing abilities to the COSMOS system."
-
-          opts.separator "Telemetry Grapher Specific Options:"
-          opts.on("-c", "--config FILE", "Use the specified configuration file") do |arg|
-            options.config_file = arg
-          end
-          opts.on("-s", "--start", "Start graphing immediately") do |arg|
-            options.start = true
-          end
-          opts.on("-i", "--item 'TARGET_NAME PACKET_NAME ITEM_NAME'", "Start graphing the specified item (ignores config file)") do |arg|
-            split = arg.split
-            if split.length != 3
-              puts "Items must be specified as 'TARGET_NAME PACKET_NAME ITEM_NAME' in quotes"
-              exit
-            end
-            options.items << split
-          end
-        end
-
-        super(opts, options)
-      end
-    end
-
-    def closeEvent(event)
-      super(event)
-    end
-
-    # Handles items being passed in as command line arguments
-    def handle_items
-      plot_index = 0
-      @items.each do |target_name, packet_name, item_name|
-        # Default configuration has one plot so don't add plot for first item
-        data_object = HousekeepingDataObject.new
-        data_object.set_item(target_name, packet_name, item_name)
-        @tabbed_plots_config.add_data_object(0, 0, data_object)
-        plot_index += 1
-      end
-    end
-
-  end # class TlmGrapher
-
-end # module Cosmos
+# encoding: ascii-8bit
+
+# Copyright 2014 Ball Aerospace & Technologies Corp.
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+
+require 'cosmos'
+Cosmos.catch_fatal_exception do
+  require 'cosmos/tools/tlm_grapher/tabbed_plots_tool/tabbed_plots_tool'
+  require 'cosmos/tools/tlm_grapher/data_objects/housekeeping_data_object'
+end
+
+module Cosmos
+
+  # TlmGrapher class
+  #
+  # This class implements the TlmGrapher Application.  This application displays multiple line graphs
+  # that perform various analysis on housekeeping telemetry.
+  #
+  class TlmGrapher < TabbedPlotsTool
+
+    # Runs the application
+    def self.run (opts = nil, options = nil)
+      Cosmos.catch_fatal_exception do
+        unless options
+          opts, options = create_default_options()
+          options.auto_size = false
+          options.width = 1000
+          options.height = 800
+          options.title = "Telemetry Grapher"
+          options.config_dir = 'tlm_grapher'
+          options.config_file = 'tlm_grapher.txt'
+          options.tool_short_name = 'tlmgrapher'
+          options.tabbed_plots_type = 'overview'
+          options.data_object_types = ['HOUSEKEEPING', 'XY','SINGLEXY']
+          options.plot_types = ['LINEGRAPH', 'XY','SINGLEXY']
+          options.plot_type_to_data_object_type_mapping = {'LINEGRAPH' => ['HOUSEKEEPING'], 'XY' => ['XY'], 'SINGLEXY' => ['SINGLEXY']}
+          options.adder_types = ['HOUSEKEEPING']
+          options.adder_orientation = Qt::Horizontal
+          options.items = []
+          options.start = false
+          options.about_string = "TlmGrapher provides realtime and log file graphing abilities to the COSMOS system."
+
+          opts.separator "Telemetry Grapher Specific Options:"
+          opts.on("-c", "--config FILE", "Use the specified configuration file") do |arg|
+            options.config_file = arg
+          end
+          opts.on("-s", "--start", "Start graphing immediately") do |arg|
+            options.start = true
+          end
+          opts.on("-i", "--item 'TARGET_NAME PACKET_NAME ITEM_NAME'", "Start graphing the specified item (ignores config file)") do |arg|
+            split = arg.split
+            if split.length != 3
+              puts "Items must be specified as 'TARGET_NAME PACKET_NAME ITEM_NAME' in quotes"
+              exit
+            end
+            options.items << split
+          end
+        end
+
+        super(opts, options)
+      end
+    end
+
+    def closeEvent(event)
+      super(event)
+    end
+
+    # Handles items being passed in as command line arguments
+    def handle_items
+      plot_index = 0
+      @items.each do |target_name, packet_name, item_name|
+        # Default configuration has one plot so don't add plot for first item
+        data_object = HousekeepingDataObject.new
+        data_object.set_item(target_name, packet_name, item_name)
+        @tabbed_plots_config.add_data_object(0, 0, data_object)
+        plot_index += 1
+      end
+    end
+
+  end # class TlmGrapher
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/screen.rb

@@ -1,486 +1,486 @@
-# encoding: ascii-8bit
-
-# Copyright 2014 Ball Aerospace & Technologies Corp.
-# All Rights Reserved.
-#
-# This program is free software; you can modify and/or redistribute it
-# under the terms of the GNU General Public License
-# as published by the Free Software Foundation; version 3 with
-# attribution addendums as found in the LICENSE.txt
-
-require 'cosmos'
-require 'cosmos/gui/qt'
-require 'cosmos/gui/qt_tool'
-require 'cosmos/script'
-require 'cosmos/tools/tlm_viewer/widgets'
-
-module Cosmos
-
-  class Screen < Qt::MainWindow
-    # The list of all open screens so they can be shutdown when
-    # close_all_screens is called
-    @@open_screens = []
-
-    attr_accessor :full_name, :width, :height, :window
-
-    class Widgets
-      # Flag to indicate all screens should close
-      @@closing_all = false
-
-      attr_accessor :named, :item, :non_item, :invalid, :items, :value_types, :polling_period, :mode
-
-      def self.closing_all= (value)
-        @@closing_all = value
-      end
-
-      def initialize(screen, mode)
-        @screen = screen
-        # The telemetry viewer mode. Must be :REALTIME or basically anything else?
-        @mode = mode
-        # Hash of only the named widgets identifed by the NAMED_WIDGET keyword
-        @named = {}
-        # Array of all widgets which take a value
-        @item = []
-        # Array of all widgets which do NOT take a value
-        @non_item = []
-        # Array of all the invalid items detected while parsing the config file
-        @invalid = []
-        # Array of all the items used by the item_widgets
-        @items = []
-        # Array of all the value types associated with the items
-        @value_types = []
-        # Latest limits set returned by the value update thread
-        @limits_set = :DEFAULT
-        # Current limits set which is compared against the one returned by the
-        # value update thread
-        @current_limits_set = :DEFAULT
-        # Whether the value update thread is alive and running
-        @alive = true
-        # Values returned from the value update thread which are used to
-        # update all the item_widgets
-        @values = nil
-        # Limits states returned from the value update thread which are used to
-        # update all the item_widgets
-        @limits_states = nil
-        # Mutex used to synchronize the value update thread and updating the GUI
-        @mutex = Mutex.new
-        # Polling period of the value update thread
-        @polling_period = nil
-        # The value update thread instance
-        @value_thread = nil
-        # Used to gracefully break out of the value thread
-        @value_sleeper = Sleeper.new
-      end
-
-      def widgets
-        @item + @non_item
-      end
-
-      def process_settings
-        widgets().each do |widget|
-          widget.process_settings
-        end
-      end
-
-      def add_widget(klass, parameters, widget, widget_name, substitute, original_target_name, force_substitute)
-        # Add to item or non_item widgets
-        if klass.takes_value?
-          if substitute and (original_target_name == parameters[0].upcase or force_substitute)
-            @items << [substitute, parameters[1], parameters[2]]
-          else
-            @items << [parameters[0], parameters[1], parameters[2]]
-          end
-          @value_types << widget.value_type
-          @item << widget
-        else
-          @non_item << widget
-        end
-
-        # Add to named widgets if necessary
-        @named[widget_name] = widget if widget_name
-      end
-
-      def update_limits_set
-        if @limits_set != @current_limits_set
-          @current_limits_set = @limits_set
-          @item.each do |widget|
-            widget.limits_set = @current_limits_set
-          end
-        end
-      end
-
-      def start_updates
-        @value_thread = Thread.new do
-          begin
-            while(true)
-              break if @@closing_all
-              time = Time.now
-
-              begin
-                # Gather item values for value widgets
-                if @mode == :REALTIME
-                  values, limits_states, limits_settings, limits_set = get_tlm_values(@items, @value_types)
-                  index = 0
-                  @items.each do |target_name, packet_name, item_name|
-                    begin
-                      System.limits.set(target_name, packet_name, item_name, limits_settings[index][0], limits_settings[index][1], limits_settings[index][2], limits_settings[index][3], limits_settings[index][4], limits_settings[index][5], limits_set) if limits_settings[index]
-                    rescue
-                      # This can fail if we missed setting the DEFAULT limits set earlier - Oh well
-                    end
-                    index += 1
-                  end
-                end
-                @mutex.synchronize do
-                  @values = values
-                  @limits_states = limits_states
-                  @limits_set = limits_set
-                end
-              rescue DRb::DRbConnError
-                break if @@closing_all
-                break if @value_sleeper.sleep(1)
-                next
-              end
-
-              Qt.execute_in_main_thread {update_gui()} if @alive and (@mode == :REALTIME)
-              delta = Time.now - time
-              break if @@closing_all
-              if @polling_period - delta > 0
-                break if @value_sleeper.sleep(@polling_period - delta)
-              else
-                break if @value_sleeper.sleep(0.1) # Minimum delay
-              end
-            end
-          rescue Exception => error
-            @alive = false
-            Qt.execute_in_main_thread(true) {|| ExceptionDialog.new(@screen, error, "Screen - Value Update Thread", false)}
-            Thread.exit
-          end
-        end
-      end
-
-      def update_gui
-        begin
-          if @alive
-            # Handle change in limits set
-            update_limits_set()
-
-            # Update widgets with values and limits_states
-            @mutex.synchronize do
-              (0..(@values.length - 1)).each do |index|
-                @item[index].limits_state = @limits_states[index]
-                @item[index].value = @values[index]
-              end
-            end
-
-            # Update non_item widgets
-            @non_item.each do |widget|
-              widget.update_widget
-            end
-          end
-        rescue Exception => error
-          @alive = false
-          Qt.execute_in_main_thread(true) {|| ExceptionDialog.new(@screen, error, "Screen - update_gui", false)}
-          Thread.exit
-        end
-      end
-
-      def shutdown
-        @alive = false
-        Cosmos.kill_thread(self, @value_thread)
-
-        # Shutdown All Widgets
-        widgets().each do |widget|
-          widget.shutdown()
-        end
-      end
-
-      def graceful_kill
-        @value_sleeper.cancel
-      end
-    end
-
-    def initialize(full_name, filename, notify_on_close = nil, mode = :REALTIME, x_pos = nil, y_pos = nil, original_target_name = nil, substitute = nil, force_substitute = false, single_screen = false)
-      super(nil)
-      # The full name of the widget which goes in the title
-      @full_name = full_name
-      # The method 'notify' will be called on this object if it is given
-      @notify_on_close = notify_on_close
-      # X position to display the screen
-      @x_pos = x_pos
-      # Y position to display the screen
-      @y_pos = y_pos
-      # Original target name where this screen is defined
-      @original_target_name = original_target_name.to_s.upcase
-      # Substitute target name to use when actually retrieving data
-      @substitute = substitute
-      # Whether to automatically substitute the target name when requesting
-      # telemetry
-      @force_substitute = force_substitute
-      # Whether this screen was launched as a command line option to be
-      # displayed as a stand alone screen and not launched as a part of the
-      # regular TlmViewer application
-      @single_screen = single_screen
-
-      @widgets = Widgets.new(self, mode)
-      @window = process(filename)
-      @@open_screens << self if @window
-    end
-
-    def widgets
-      @widgets.widgets
-    end
-
-    def named_widgets
-      @widgets.named
-    end
-
-    def mode
-      @widgets.mode
-    end
-
-    def process(filename)
-      layout_stack = []
-      layout_stack[0] = nil
-
-      top_widget = nil
-      current_widget = nil
-      global_settings = {}
-      global_subsettings = {}
-
-      begin
-        parser = ConfigParser.new
-        parser.parse_file(filename) do |keyword, parameters|
-
-          if keyword
-            case keyword
-            when 'SCREEN'
-              parser.verify_num_parameters(3, 3, "#{keyword} <Width or AUTO> <Height or AUTO> <Polling Period>")
-              @width = parameters[0].to_i
-              @height = parameters[1].to_i
-              @widgets.polling_period = parameters[2].to_f
-
-              setWindowTitle(@full_name)
-              top_widget = Qt::Widget.new()
-              setCentralWidget(top_widget)
-              frame = Qt::VBoxLayout.new()
-              top_widget.setLayout(frame)
-              layout_stack[0] = frame
-              Cosmos.load_cosmos_icon if @single_screen
-            when 'END'
-              parser.verify_num_parameters(0, 0, "#{keyword}")
-              current_widget = layout_stack.pop()
-              # Call the complete method to allow layout widgets to do things
-              # once all their children have been added
-              # Need the respond_to? to protect against the top level widget
-              # added by the SCREEN code above. It adds a Qt::VBoxLayout
-              # to the stack and that class doesn't have a complete method.
-              current_widget.complete() if current_widget.respond_to? :complete
-            when 'SETTING'
-              parser.verify_num_parameters(1, nil, "#{keyword} <Setting Name> <Setting Values... (optional)>")
-              if parameters.length > 1
-                current_widget.set_setting(parameters[0], parameters[1..-1])
-              else
-                current_widget.set_setting(parameters[0], [])
-              end
-            when 'SUBSETTING'
-              parser.verify_num_parameters(2, nil, "#{keyword} <Widget Index (0..?)> <Setting Name> <Setting Values... (optional)>")
-              if parameters.length > 2
-                current_widget.set_subsetting(parameters[0], parameters[1], parameters[2..-1])
-              else
-                current_widget.set_subsetting(parameters[0], parameters[1], [])
-              end
-            when 'GLOBAL_SETTING'
-              parser.verify_num_parameters(2, nil, "#{keyword} <Widget Type> <Setting Name> <Setting Values... (optional)>")
-              klass = Cosmos.require_class(parameters[0].to_s.downcase + '_widget')
-              global_settings[klass] ||= []
-              global_settings[klass] << parameters[1..-1]
-            when 'GLOBAL_SUBSETTING'
-              parser.verify_num_parameters(3, nil, "#{keyword} <Widget Type> <Widget Index (0..?)> <Setting Name> <Setting Values... (optional)>")
-              klass = Cosmos.require_class(parameters[0].to_s.downcase + '_widget')
-              global_subsettings[klass] ||= []
-              global_subsettings[klass] << [parameters[1]].concat(parameters[2..-1])
-            else
-              current_widget = process_widget(parser, keyword, parameters, layout_stack, global_settings, global_subsettings)
-            end # case keyword
-          end # if keyword
-
-        end # parser.parse_file
-      rescue Exception => err
-        begin
-          raise $!, "In file #{filename} at line #{parser.line_number}:\n\n#{$!}", $!.backtrace
-        rescue => err
-          ExceptionDialog.new(self, err, "Screen #{File.basename(filename)}", false)
-        end
-        shutdown()
-        return nil
-      end
-
-      unless @widgets.invalid.empty?
-        Qt::MessageBox.information(self, "Screen #{@full_name}", "The following telemetry items could not be created: \n" + @widgets.invalid.join("\n"))
-      end
-
-      # Process all settings before we show the screen
-      @widgets.process_settings
-
-      if @width > 0 and @height > 0
-        resize(@width, @height)
-      elsif @width <= 0 and height > 0
-        resize(self.width, @height)
-      elsif @width > 0 and height <= 0
-        resize(@width, self.height)
-      end
-
-      if @x_pos or @y_pos
-        x = @x_pos || 0
-        y = @y_pos || 0
-        move(x,y)
-      end
-      show()
-
-      # Start the update thread now that the screen is displayed
-      @widgets.start_updates()
-
-      return self
-    end
-
-    def process_widget(parser, keyword, parameters, layout_stack, global_settings, global_subsettings)
-      widget_name = nil
-      if keyword == 'NAMED_WIDGET'
-        parser.verify_num_parameters(2, nil, "#{keyword} <Widget Name> <Widget Type> <Widget Settings... (optional)>")
-        widget_name = parameters[0].upcase
-        keyword = parameters[1].upcase
-        parameters = parameters[2..-1]
-      else
-        parser.verify_num_parameters(0, nil, "#{keyword} <Widget Settings... (optional)>")
-      end
-
-      widget = nil
-      klass = Cosmos.require_class(keyword.downcase + '_widget')
-      if klass.takes_value?
-        parser.verify_num_parameters(3, nil, "#{keyword} <Target Name> <Packet Name> <Item Name> <Widget Settings... (optional)>")
-        begin
-          if @substitute and (@original_target_name == parameters[0].upcase or @force_substitute)
-            System.telemetry.packet_and_item(@substitute, parameters[1], parameters[2])
-            widget = klass.new(layout_stack[-1], @substitute, *parameters[1..(parameters.length - 1)])
-          else
-            System.telemetry.packet_and_item(*parameters[0..2])
-            widget = klass.new(layout_stack[-1], *parameters)
-          end
-        rescue
-          @widgets.invalid << parameters.join(" ")
-          return nil
-        end
-      else
-        if parameters[0] != nil
-          widget = klass.new(layout_stack[-1], *parameters)
-        else
-          widget = klass.new(layout_stack[-1])
-        end
-      end
-
-      # Assign screen
-      widget.screen = self
-
-      # Assign polling period
-      if @widgets.polling_period
-        widget.polling_period = @widgets.polling_period
-      else
-        raise "SCREEN keyword must appear before any widgets"
-      end
-
-      # Add to Layout Stack if Necessary
-      if klass.layout_manager?
-        layout_stack.push(widget)
-      end
-
-      # Apply Global Settings
-      global_settings.each do |global_klass, settings|
-        if widget.class == global_klass
-          settings.each do |setting|
-            if setting.length > 1
-              widget.set_setting(setting[0], setting[1..-1])
-            else
-              widget.set_setting(setting[0], [])
-            end
-          end
-        end
-      end
-
-      # Apply Global Subsettings
-      global_subsettings.each do |global_klass, settings|
-        if widget.class == global_klass
-          settings.each do |setting|
-            widget_index = setting[0]
-            if setting.length > 2
-              widget.set_subsetting(widget_index, setting[1], setting[2..-1])
-            else
-              widget.set_subsetting(widget_index, setting[1], [])
-            end
-          end
-        end
-      end
-
-      @widgets.add_widget(klass, parameters, widget, widget_name, @substitute, @original_target_name, @force_substitute)
-
-      return widget
-    end
-
-    def closeEvent(event)
-      super(event)
-      @@open_screens.delete(self)
-      shutdown()
-    end
-
-    def shutdown
-      # Shutdown Value Gathering Thread
-      @widgets.shutdown
-
-      # Notify Owner if Necessary
-      @notify_on_close.notify(self) if @notify_on_close
-
-      if @single_screen
-        QtTool.restore_io
-      end
-
-      self.dispose
-    end
-
-    def get_named_widget(widget_name)
-      @widgets.named[widget_name.upcase]
-    end
-
-    def get_target_name(target_name)
-      if @substitute and (@original_target_name == target_name.upcase or @force_substitute)
-        @substitute
-      else
-        target_name
-      end
-    end
-
-    def graceful_kill
-      @widgets.graceful_kill
-    end
-
-    def self.open_screens
-      @@open_screens
-    end
-
-    def self.close_all_screens(closer)
-      Widgets.closing_all = true
-      screens = @@open_screens.clone
-      screens.each do |screen|
-        screen.window.graceful_kill if screen.window
-      end
-      screens.each do |screen|
-        begin
-          screen.window.close
-        rescue
-          # Screen probably already closed - continue
-        end
-      end
-      Widgets.closing_all = false
-    end
-
-  end
-
-end # module Cosmos
+# encoding: ascii-8bit
+
+# Copyright 2014 Ball Aerospace & Technologies Corp.
+# All Rights Reserved.
+#
+# This program is free software; you can modify and/or redistribute it
+# under the terms of the GNU General Public License
+# as published by the Free Software Foundation; version 3 with
+# attribution addendums as found in the LICENSE.txt
+
+require 'cosmos'
+require 'cosmos/gui/qt'
+require 'cosmos/gui/qt_tool'
+require 'cosmos/script'
+require 'cosmos/tools/tlm_viewer/widgets'
+
+module Cosmos
+
+  class Screen < Qt::MainWindow
+    # The list of all open screens so they can be shutdown when
+    # close_all_screens is called
+    @@open_screens = []
+
+    attr_accessor :full_name, :width, :height, :window
+
+    class Widgets
+      # Flag to indicate all screens should close
+      @@closing_all = false
+
+      attr_accessor :named, :item, :non_item, :invalid, :items, :value_types, :polling_period, :mode
+
+      def self.closing_all= (value)
+        @@closing_all = value
+      end
+
+      def initialize(screen, mode)
+        @screen = screen
+        # The telemetry viewer mode. Must be :REALTIME or basically anything else?
+        @mode = mode
+        # Hash of only the named widgets identifed by the NAMED_WIDGET keyword
+        @named = {}
+        # Array of all widgets which take a value
+        @item = []
+        # Array of all widgets which do NOT take a value
+        @non_item = []
+        # Array of all the invalid items detected while parsing the config file
+        @invalid = []
+        # Array of all the items used by the item_widgets
+        @items = []
+        # Array of all the value types associated with the items
+        @value_types = []
+        # Latest limits set returned by the value update thread
+        @limits_set = :DEFAULT
+        # Current limits set which is compared against the one returned by the
+        # value update thread
+        @current_limits_set = :DEFAULT
+        # Whether the value update thread is alive and running
+        @alive = true
+        # Values returned from the value update thread which are used to
+        # update all the item_widgets
+        @values = nil
+        # Limits states returned from the value update thread which are used to
+        # update all the item_widgets
+        @limits_states = nil
+        # Mutex used to synchronize the value update thread and updating the GUI
+        @mutex = Mutex.new
+        # Polling period of the value update thread
+        @polling_period = nil
+        # The value update thread instance
+        @value_thread = nil
+        # Used to gracefully break out of the value thread
+        @value_sleeper = Sleeper.new
+      end
+
+      def widgets
+        @item + @non_item
+      end
+
+      def process_settings
+        widgets().each do |widget|
+          widget.process_settings
+        end
+      end
+
+      def add_widget(klass, parameters, widget, widget_name, substitute, original_target_name, force_substitute)
+        # Add to item or non_item widgets
+        if klass.takes_value?
+          if substitute and (original_target_name == parameters[0].upcase or force_substitute)
+            @items << [substitute, parameters[1], parameters[2]]
+          else
+            @items << [parameters[0], parameters[1], parameters[2]]
+          end
+          @value_types << widget.value_type
+          @item << widget
+        else
+          @non_item << widget
+        end
+
+        # Add to named widgets if necessary
+        @named[widget_name] = widget if widget_name
+      end
+
+      def update_limits_set
+        if @limits_set != @current_limits_set
+          @current_limits_set = @limits_set
+          @item.each do |widget|
+            widget.limits_set = @current_limits_set
+          end
+        end
+      end
+
+      def start_updates
+        @value_thread = Thread.new do
+          begin
+            while(true)
+              break if @@closing_all
+              time = Time.now
+
+              begin
+                # Gather item values for value widgets
+                if @mode == :REALTIME
+                  values, limits_states, limits_settings, limits_set = get_tlm_values(@items, @value_types)
+                  index = 0
+                  @items.each do |target_name, packet_name, item_name|
+                    begin
+                      System.limits.set(target_name, packet_name, item_name, limits_settings[index][0], limits_settings[index][1], limits_settings[index][2], limits_settings[index][3], limits_settings[index][4], limits_settings[index][5], limits_set) if limits_settings[index]
+                    rescue
+                      # This can fail if we missed setting the DEFAULT limits set earlier - Oh well
+                    end
+                    index += 1
+                  end
+                end
+                @mutex.synchronize do
+                  @values = values
+                  @limits_states = limits_states
+                  @limits_set = limits_set
+                end
+              rescue DRb::DRbConnError
+                break if @@closing_all
+                break if @value_sleeper.sleep(1)
+                next
+              end
+
+              Qt.execute_in_main_thread {update_gui()} if @alive and (@mode == :REALTIME)
+              delta = Time.now - time
+              break if @@closing_all
+              if @polling_period - delta > 0
+                break if @value_sleeper.sleep(@polling_period - delta)
+              else
+                break if @value_sleeper.sleep(0.1) # Minimum delay
+              end
+            end
+          rescue Exception => error
+            @alive = false
+            Qt.execute_in_main_thread(true) {|| ExceptionDialog.new(@screen, error, "Screen - Value Update Thread", false)}
+            Thread.exit
+          end
+        end
+      end
+
+      def update_gui
+        begin
+          if @alive
+            # Handle change in limits set
+            update_limits_set()
+
+            # Update widgets with values and limits_states
+            @mutex.synchronize do
+              (0..(@values.length - 1)).each do |index|
+                @item[index].limits_state = @limits_states[index]
+                @item[index].value = @values[index]
+              end
+            end
+
+            # Update non_item widgets
+            @non_item.each do |widget|
+              widget.update_widget
+            end
+          end
+        rescue Exception => error
+          @alive = false
+          Qt.execute_in_main_thread(true) {|| ExceptionDialog.new(@screen, error, "Screen - update_gui", false)}
+          Thread.exit
+        end
+      end
+
+      def shutdown
+        @alive = false
+        Cosmos.kill_thread(self, @value_thread)
+
+        # Shutdown All Widgets
+        widgets().each do |widget|
+          widget.shutdown()
+        end
+      end
+
+      def graceful_kill
+        @value_sleeper.cancel
+      end
+    end
+
+    def initialize(full_name, filename, notify_on_close = nil, mode = :REALTIME, x_pos = nil, y_pos = nil, original_target_name = nil, substitute = nil, force_substitute = false, single_screen = false)
+      super(nil)
+      # The full name of the widget which goes in the title
+      @full_name = full_name
+      # The method 'notify' will be called on this object if it is given
+      @notify_on_close = notify_on_close
+      # X position to display the screen
+      @x_pos = x_pos
+      # Y position to display the screen
+      @y_pos = y_pos
+      # Original target name where this screen is defined
+      @original_target_name = original_target_name.to_s.upcase
+      # Substitute target name to use when actually retrieving data
+      @substitute = substitute
+      # Whether to automatically substitute the target name when requesting
+      # telemetry
+      @force_substitute = force_substitute
+      # Whether this screen was launched as a command line option to be
+      # displayed as a stand alone screen and not launched as a part of the
+      # regular TlmViewer application
+      @single_screen = single_screen
+
+      @widgets = Widgets.new(self, mode)
+      @window = process(filename)
+      @@open_screens << self if @window
+    end
+
+    def widgets
+      @widgets.widgets
+    end
+
+    def named_widgets
+      @widgets.named
+    end
+
+    def mode
+      @widgets.mode
+    end
+
+    def process(filename)
+      layout_stack = []
+      layout_stack[0] = nil
+
+      top_widget = nil
+      current_widget = nil
+      global_settings = {}
+      global_subsettings = {}
+
+      begin
+        parser = ConfigParser.new
+        parser.parse_file(filename) do |keyword, parameters|
+
+          if keyword
+            case keyword
+            when 'SCREEN'
+              parser.verify_num_parameters(3, 3, "#{keyword} <Width or AUTO> <Height or AUTO> <Polling Period>")
+              @width = parameters[0].to_i
+              @height = parameters[1].to_i
+              @widgets.polling_period = parameters[2].to_f
+
+              setWindowTitle(@full_name)
+              top_widget = Qt::Widget.new()
+              setCentralWidget(top_widget)
+              frame = Qt::VBoxLayout.new()
+              top_widget.setLayout(frame)
+              layout_stack[0] = frame
+              Cosmos.load_cosmos_icon if @single_screen
+            when 'END'
+              parser.verify_num_parameters(0, 0, "#{keyword}")
+              current_widget = layout_stack.pop()
+              # Call the complete method to allow layout widgets to do things
+              # once all their children have been added
+              # Need the respond_to? to protect against the top level widget
+              # added by the SCREEN code above. It adds a Qt::VBoxLayout
+              # to the stack and that class doesn't have a complete method.
+              current_widget.complete() if current_widget.respond_to? :complete
+            when 'SETTING'
+              parser.verify_num_parameters(1, nil, "#{keyword} <Setting Name> <Setting Values... (optional)>")
+              if parameters.length > 1
+                current_widget.set_setting(parameters[0], parameters[1..-1])
+              else
+                current_widget.set_setting(parameters[0], [])
+              end
+            when 'SUBSETTING'
+              parser.verify_num_parameters(2, nil, "#{keyword} <Widget Index (0..?)> <Setting Name> <Setting Values... (optional)>")
+              if parameters.length > 2
+                current_widget.set_subsetting(parameters[0], parameters[1], parameters[2..-1])
+              else
+                current_widget.set_subsetting(parameters[0], parameters[1], [])
+              end
+            when 'GLOBAL_SETTING'
+              parser.verify_num_parameters(2, nil, "#{keyword} <Widget Type> <Setting Name> <Setting Values... (optional)>")
+              klass = Cosmos.require_class(parameters[0].to_s.downcase + '_widget')
+              global_settings[klass] ||= []
+              global_settings[klass] << parameters[1..-1]
+            when 'GLOBAL_SUBSETTING'
+              parser.verify_num_parameters(3, nil, "#{keyword} <Widget Type> <Widget Index (0..?)> <Setting Name> <Setting Values... (optional)>")
+              klass = Cosmos.require_class(parameters[0].to_s.downcase + '_widget')
+              global_subsettings[klass] ||= []
+              global_subsettings[klass] << [parameters[1]].concat(parameters[2..-1])
+            else
+              current_widget = process_widget(parser, keyword, parameters, layout_stack, global_settings, global_subsettings)
+            end # case keyword
+          end # if keyword
+
+        end # parser.parse_file
+      rescue Exception => err
+        begin
+          raise $!, "In file #{filename} at line #{parser.line_number}:\n\n#{$!}", $!.backtrace
+        rescue => err
+          ExceptionDialog.new(self, err, "Screen #{File.basename(filename)}", false)
+        end
+        shutdown()
+        return nil
+      end
+
+      unless @widgets.invalid.empty?
+        Qt::MessageBox.information(self, "Screen #{@full_name}", "The following telemetry items could not be created: \n" + @widgets.invalid.join("\n"))
+      end
+
+      # Process all settings before we show the screen
+      @widgets.process_settings
+
+      if @width > 0 and @height > 0
+        resize(@width, @height)
+      elsif @width <= 0 and height > 0
+        resize(self.width, @height)
+      elsif @width > 0 and height <= 0
+        resize(@width, self.height)
+      end
+
+      if @x_pos or @y_pos
+        x = @x_pos || 0
+        y = @y_pos || 0
+        move(x,y)
+      end
+      show()
+
+      # Start the update thread now that the screen is displayed
+      @widgets.start_updates()
+
+      return self
+    end
+
+    def process_widget(parser, keyword, parameters, layout_stack, global_settings, global_subsettings)
+      widget_name = nil
+      if keyword == 'NAMED_WIDGET'
+        parser.verify_num_parameters(2, nil, "#{keyword} <Widget Name> <Widget Type> <Widget Settings... (optional)>")
+        widget_name = parameters[0].upcase
+        keyword = parameters[1].upcase
+        parameters = parameters[2..-1]
+      else
+        parser.verify_num_parameters(0, nil, "#{keyword} <Widget Settings... (optional)>")
+      end
+
+      widget = nil
+      klass = Cosmos.require_class(keyword.downcase + '_widget')
+      if klass.takes_value?
+        parser.verify_num_parameters(3, nil, "#{keyword} <Target Name> <Packet Name> <Item Name> <Widget Settings... (optional)>")
+        begin
+          if @substitute and (@original_target_name == parameters[0].upcase or @force_substitute)
+            System.telemetry.packet_and_item(@substitute, parameters[1], parameters[2])
+            widget = klass.new(layout_stack[-1], @substitute, *parameters[1..(parameters.length - 1)])
+          else
+            System.telemetry.packet_and_item(*parameters[0..2])
+            widget = klass.new(layout_stack[-1], *parameters)
+          end
+        rescue
+          @widgets.invalid << parameters.join(" ")
+          return nil
+        end
+      else
+        if parameters[0] != nil
+          widget = klass.new(layout_stack[-1], *parameters)
+        else
+          widget = klass.new(layout_stack[-1])
+        end
+      end
+
+      # Assign screen
+      widget.screen = self
+
+      # Assign polling period
+      if @widgets.polling_period
+        widget.polling_period = @widgets.polling_period
+      else
+        raise "SCREEN keyword must appear before any widgets"
+      end
+
+      # Add to Layout Stack if Necessary
+      if klass.layout_manager?
+        layout_stack.push(widget)
+      end
+
+      # Apply Global Settings
+      global_settings.each do |global_klass, settings|
+        if widget.class == global_klass
+          settings.each do |setting|
+            if setting.length > 1
+              widget.set_setting(setting[0], setting[1..-1])
+            else
+              widget.set_setting(setting[0], [])
+            end
+          end
+        end
+      end
+
+      # Apply Global Subsettings
+      global_subsettings.each do |global_klass, settings|
+        if widget.class == global_klass
+          settings.each do |setting|
+            widget_index = setting[0]
+            if setting.length > 2
+              widget.set_subsetting(widget_index, setting[1], setting[2..-1])
+            else
+              widget.set_subsetting(widget_index, setting[1], [])
+            end
+          end
+        end
+      end
+
+      @widgets.add_widget(klass, parameters, widget, widget_name, @substitute, @original_target_name, @force_substitute)
+
+      return widget
+    end
+
+    def closeEvent(event)
+      super(event)
+      @@open_screens.delete(self)
+      shutdown()
+    end
+
+    def shutdown
+      # Shutdown Value Gathering Thread
+      @widgets.shutdown
+
+      # Notify Owner if Necessary
+      @notify_on_close.notify(self) if @notify_on_close
+
+      if @single_screen
+        QtTool.restore_io
+      end
+
+      self.dispose
+    end
+
+    def get_named_widget(widget_name)
+      @widgets.named[widget_name.upcase]
+    end
+
+    def get_target_name(target_name)
+      if @substitute and (@original_target_name == target_name.upcase or @force_substitute)
+        @substitute
+      else
+        target_name
+      end
+    end
+
+    def graceful_kill
+      @widgets.graceful_kill
+    end
+
+    def self.open_screens
+      @@open_screens
+    end
+
+    def self.close_all_screens(closer)
+      Widgets.closing_all = true
+      screens = @@open_screens.clone
+      screens.each do |screen|
+        screen.window.graceful_kill if screen.window
+      end
+      screens.each do |screen|
+        begin
+          screen.window.close
+        rescue
+          # Screen probably already closed - continue
+        end
+      end
+      Widgets.closing_all = false
+    end
+
+  end
+
+end # module Cosmos