cosmos 3.0.0

data/lib/cosmos/tools/tlm_viewer/widgets/progressbar_widget.rb

@@ -0,0 +1,34 @@
+# 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/tools/tlm_viewer/widgets/widget'
+
+module Cosmos
+
+  class ProgressbarWidget < Qt::ProgressBar
+    include Widget
+
+    def initialize(parent_layout, target_name, packet_name, item_name, scale_factor = 1.0, width = 80, value_type = :CONVERTED)
+      super(target_name, packet_name, item_name, value_type)
+      @scale_factor = scale_factor.to_f
+      self.setFixedWidth(width.to_i)
+      parent_layout.addWidget(self) if parent_layout
+    end
+
+    def value=(value)
+      setValue((value.to_f * @scale_factor).to_i)
+    end
+
+    def ProgressbarWidget.takes_value?
+      return true
+    end
+  end
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/widgets/radiobutton_widget.rb

@@ -0,0 +1,30 @@
+# 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/tools/tlm_viewer/widgets/widget'
+
+module Cosmos
+
+  class RadiobuttonWidget < Qt::RadioButton
+    include Widget
+
+    def initialize (parent_layout, radiobutton_text)
+      super()
+      setText(radiobutton_text.to_s)
+      parent_layout.addWidget(self) if parent_layout
+    end
+
+    def checked?
+      self.isChecked()
+    end
+  end
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/widgets/rangebar_widget.rb

@@ -0,0 +1,57 @@
+# 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/tools/tlm_viewer/widgets/limitsbar_widget'
+
+module Cosmos
+
+  class RangebarWidget < LimitsbarWidget
+
+    def initialize (parent_layout, target_name, packet_name, item_name, low_value, high_value, value_type = :CONVERTED, width = 160, height = 25)
+      super(parent_layout, target_name, packet_name, item_name, value_type, width, height)
+      @low_value = low_value.to_s.convert_to_value
+      @high_value = high_value.to_s.convert_to_value
+    end
+
+    def paint_implementation(dc)
+      # Fill the rectangle with white
+      dc.addRectColorFill(@x_pad, @y_pad, @width - @x_pad - @x_pad, @height - @y_pad - @y_pad, "white")
+
+      # Draw line at current value
+      @bar_scale = @high_value - @low_value
+
+      @line_pos = (@x_pad + (@value - @low_value) / @bar_scale * @bar_width).to_i
+      if @line_pos < @x_pad
+        @line_pos = @x_pad
+      end
+      if @line_pos > @x_pad + @bar_width
+        @line_pos = @bar_width + @x_pad
+      end
+
+      dc.addLineColor(@line_pos, @y_pad - 3, @line_pos, @y_pad + @bar_height + 3)
+
+      # Draw triangle above current value line
+      top_triangle = Qt::Polygon.new(3)
+      top_triangle.setPoint(0, @line_pos, @y_pad - 1)
+      top_triangle.setPoint(1, @line_pos-5, @y_pad - 6)
+      top_triangle.setPoint(2, @line_pos+5, @y_pad - 6)
+      dc.setBrush(Cosmos.getBrush(Cosmos::BLACK))
+      dc.drawPolygon(top_triangle)
+
+      # Draw overall border
+      dc.addRectColor(@x_pad, @y_pad, @width - @x_pad - @x_pad, @height - @y_pad - @y_pad)
+
+      #Additional drawing for subclasses
+      additional_drawing(dc)
+    end
+
+  end
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/widgets/screenshotbutton_widget.rb

@@ -0,0 +1,34 @@
+# 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/tools/tlm_viewer/widgets/widget'
+require 'cosmos/gui/utilities/screenshot'
+
+module Cosmos
+
+  class ScreenshotbuttonWidget < Qt::PushButton
+    include Widget
+
+    def initialize (parent_layout, button_text = 'Screenshot', screenshot_directory = nil)
+      super(nil, nil, nil, nil, button_text.to_s)
+      if screenshot_directory
+        @screenshot_directory = screenshot_directory
+      else
+        @screenshot_directory = System.paths['LOGS']
+      end
+      parent_layout.addWidget(self) if parent_layout
+      connect(SIGNAL('clicked()')) do
+        filename = File.join(@screenshot_directory, File.build_timestamped_filename([@screen.full_name], '.png'))
+        Screenshot.screenshot_window(@screen.window, filename)
+      end
+    end
+  end
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/widgets/scrollwindow_widget.rb

@@ -0,0 +1,35 @@
+# 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/tools/tlm_viewer/widgets/widget'
+require 'cosmos/tools/tlm_viewer/widgets/layout_widget'
+
+module Cosmos
+
+  class ScrollwindowWidget < Qt::VBoxLayout
+    include Widget
+    include LayoutWidget
+
+    def initialize(parent_layout)
+      super()
+      @widget = Qt::Widget.new
+      @widget.setLayout(self)
+      parent_layout.addWidget(@widget) if parent_layout
+      @parent_layout = parent_layout
+    end
+
+    def complete
+      scroll = Qt::ScrollArea.new
+      scroll.setWidget(@widget)
+      @parent_layout.addWidget(scroll)
+    end
+  end
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/widgets/sectionheader_widget.rb

@@ -0,0 +1,33 @@
+# 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/tools/tlm_viewer/widgets/multi_widget'
+require 'cosmos/tools/tlm_viewer/widgets/label_widget'
+require 'cosmos/tools/tlm_viewer/widgets/horizontalline_widget'
+
+module Cosmos
+
+  class SectionheaderWidget < Qt::Widget
+    include Widget
+    include MultiWidget
+
+    def initialize(parent_layout, text)
+      super()
+      setLayout(Qt::VBoxLayout.new)
+      layout.setSpacing(0)
+      layout.setContentsMargins(0,0,0,0)
+      @widgets << LabelWidget.new(layout, text.to_s)
+      @widgets << HorizontallineWidget.new(layout)
+      parent_layout.addWidget(self) if parent_layout
+    end
+  end
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/widgets/tabbook_widget.rb

@@ -0,0 +1,26 @@
+# 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/tools/tlm_viewer/widgets/widget'
+require 'cosmos/tools/tlm_viewer/widgets/layout_widget'
+
+module Cosmos
+
+  class TabbookWidget < Qt::TabWidget
+    include Widget
+    include LayoutWidget
+
+    def initialize(parent_layout = nil)
+      super()
+      parent_layout.addWidget(self) if parent_layout
+    end
+  end
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/widgets/tabitem_widget.rb

@@ -0,0 +1,28 @@
+# 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/tools/tlm_viewer/widgets/widget'
+require 'cosmos/tools/tlm_viewer/widgets/layout_widget'
+
+module Cosmos
+
+  class TabitemWidget < Qt::VBoxLayout
+    include Widget
+    include LayoutWidget
+
+    def initialize(parent_layout, text)
+      super()
+      w = Qt::Widget.new
+      w.setLayout(self)
+      parent_layout.addTab(w, text.to_s) if parent_layout
+    end
+  end
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/widgets/textbox_widget.rb

@@ -0,0 +1,47 @@
+# 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/tools/tlm_viewer/widgets/widget'
+require 'cosmos/tools/tlm_viewer/widgets/aging_widget'
+
+module Cosmos
+
+  class TextboxWidget < Qt::TextEdit
+    include Widget
+    include AgingWidget
+
+    def initialize(parent_layout, target_name, packet_name, item_name, width = 200, height = 100, value_type = :CONVERTED)
+      super(target_name, packet_name, item_name, value_type)
+      setup_aging
+      setFixedSize(width.to_i, height.to_i)
+      setReadOnly(true)
+      parent_layout.addWidget(self) if parent_layout
+    end
+
+    def format_value(data)
+      data.to_s
+    end
+
+    def value=(data)
+      scroll_pos = self.verticalScrollBar.value
+      self.text = super(data, format_value(data))
+      self.setColors(@foreground, @background)
+      self.verticalScrollBar.value = scroll_pos
+    end
+
+    def process_settings
+      super
+      process_aging_settings
+    end
+
+  end
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/widgets/textfield_widget.rb

@@ -0,0 +1,26 @@
+# 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/tools/tlm_viewer/widgets/widget'
+
+module Cosmos
+
+  class TextfieldWidget < Qt::LineEdit
+    include Widget
+
+    def initialize (parent_layout, num_characters = 12, default_text = '')
+      super()
+      setText(default_text.to_s)
+      setMaxLength(num_characters.to_i)
+      parent_layout.addWidget(self) if parent_layout
+    end
+  end
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/widgets/timegraph_widget.rb

@@ -0,0 +1,88 @@
+# 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 'time'
+require 'cosmos/tools/tlm_viewer/widgets/linegraph_widget'
+require 'cosmos/script'
+
+module Cosmos
+
+  # TimegraphWidget class
+  #
+  # This class creates a graph of the supplied data value versus time.
+  class TimegraphWidget < LinegraphWidget
+
+    def initialize(parent_layout, target_name, packet_name, item_name, num_samples = 100, width = 300, height = 200, point_size = 5, time_item_name = 'RECEIVED_TIMESECONDS', value_type = :CONVERTED)
+      super(parent_layout, target_name, packet_name, item_name, num_samples, width, height, value_type)
+      @time_item_name = time_item_name.to_s
+      @time = []
+      @first_value = true
+      @initial_time = 0
+      @vs_time = true
+      @items = []
+      @items << [@target_name, @packet_name, @item_name]
+      @items << [@target_name, @packet_name, @time_item_name]
+      self.show_y_grid_lines = true
+      self.unix_epoch_x_values = true
+      self.point_size = Integer(point_size)
+    end
+
+    # Obtains the telemetry item data and it's corresponding time stamp from
+    # the telemetry item name set during widget creation and then adds this
+    # data to the LineGraph object.
+    def value=(data)
+      data  = nil
+      t_sec = nil
+
+      if @screen.mode == :REALTIME
+        begin
+          # Even though it has been provided, need to get data and timestamp here.
+          # Otherwise, the time stamp may be from a different packet if packets
+          # are received too fast
+          tlm_items, _, _, _ = get_tlm_values(@items)
+          data = tlm_items[0]
+          t_sec = tlm_items[1]
+          return if t_sec == 0.0 # Don't graph if we have no timestamp
+        rescue DRb::DRbConnError
+          # If the cts is not available, it must have just recently been lost
+          # simply return without updating.
+          return
+        end
+      else # in log mode
+        # Note: in logmode value= usually isn't called with every data point so this is never
+        # going to work very well.  Will work ok for logfile playback so we will
+        # still support it.
+        data = System.telemetry.value(@target_name, @packet_name, @item_name)
+        t_sec = System.telemetry.value(@target_name, @packet_name, @time_item_name)
+      end
+
+      # Don't regraph old data
+      return if @time[-1] == t_sec
+
+      # create time array
+      @time << t_sec
+
+      # create data array and graph
+      @data << data.to_f
+
+      # truncate data if necessary
+      if @data.length > @num_samples
+        @data = @data[1..-1]
+        @time = @time[1..-1]
+      end
+
+      self.clear_lines
+      self.add_line('line', @data, @time)
+      self.graph
+    end
+
+  end
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/widgets/title_widget.rb

@@ -0,0 +1,27 @@
+# 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/tools/tlm_viewer/widgets/widget'
+
+module Cosmos
+
+  class TitleWidget < Qt::Label
+    include Widget
+
+    def initialize(parent_layout, text)
+      super()
+      self.text = text.to_s.remove_quotes
+      setFont(Cosmos.getFont("helvetica", 14, Qt::Font::Bold))
+      setAlignment(Qt::AlignCenter)
+      parent_layout.addWidget(self) if parent_layout
+    end
+  end
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_viewer/widgets/trendbar_widget.rb

@@ -0,0 +1,130 @@
+# 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
+
+# This file contains the implementation and TrendbarWidget class.   This class
+# implements a limitsbar widget with and additional horizontal trendline
+# indicating previous values and general trending.
+
+require 'cosmos/tools/tlm_viewer/widgets/limitsbar_widget'
+
+module Cosmos
+
+  class TrendbarWidget < LimitsbarWidget
+
+    MAX_TREND_SECONDS = 3600.0
+
+    def initialize (parent_layout, target_name, packet_name, item_name, value_type = :CONVERTED, trend_seconds = 60.0, width = 160, height = 25, trend_value_handle = nil)
+      #  @trend_seconds needs to be set before super because super will call get_tooltip_text
+      @trend_seconds = trend_seconds.to_f
+      @trend_seconds = MAX_TREND_SECONDS if @trend_seconds > MAX_TREND_SECONDS
+      super(parent_layout, target_name, packet_name, item_name, value_type, width, height)
+      @trend_value_handle = ConfigParser.handle_nil(trend_value_handle)
+
+      # Track the total number of samples received.  This will help us to know how many
+      # trendlines to plot before we reach the maximum.
+      @samples_received = 0
+
+      # The actual difference (delta) between the current value and the desired trend value.
+      @trend_delta = nil
+      @trend_points = 1
+      @trend_data = [0]
+    end
+
+    def polling_period=(polling_period)
+      super(polling_period)
+      adjust_trend_points_and_data()
+    end
+
+    def value= (data)
+      @value = data.to_f
+
+      @samples_received += 1
+
+      # Remove the oldest value off the end (right) and insert on the
+      # front (left) of the array.
+      @trend_data.pop
+      @trend_data.insert(0, @value)
+
+      update()
+    end
+
+    def adjust_trend_points_and_data
+      @trend_points = ((1.0 / @polling_period.to_f) * @trend_seconds).to_i + 1
+      # Time history of TLM item values with oldest -> newest reading left[0]
+      # -> right[max_trend_points - 1]
+      @trend_data = [0] * @trend_points
+
+      # Subtract one since we'll use this as an array index and will precompute so we don't have
+      # to take a computation hit at every data update.
+      @trend_points -= 1
+      @trend_points = 0 if @trend_points < 0
+    end
+
+    def get_tooltip_text
+      tooltip_text  = super()
+      tooltip_text += "\nTrending Value = (Current Value) - (Value #{@trend_seconds} Seconds Ago)"
+      return tooltip_text
+    end
+
+    def additional_drawing (dc)
+      trendline_pos = (@x_pad + ((@trend_data[@trend_points]) - @low_value) / @bar_scale * @bar_width).to_i
+      trendline_pos = @x_pad if trendline_pos < @x_pad
+      trendline_pos = @bar_width + @x_pad if trendline_pos > @x_pad + @bar_width
+
+      # Create the horizontal trendline and circle indicating the trend value.
+      # The desired diameter of the circle is 0.35 * bar_height.
+      bar_y_mid = @height / 2
+      radius = 0.175 * @bar_height
+
+      if @samples_received > @trend_points
+
+        # Set the value for the widget that displays the trend_delta
+        if @trend_value_handle
+          trend_val = @value - @trend_data[@trend_points]
+
+          # Round to 2 digits
+          @trend_value_handle.setText(sprintf("%0.2f", trend_val))
+        end
+
+        dc.addLineColor(trendline_pos, bar_y_mid, @line_pos, bar_y_mid)
+
+        # Put a circle in the middle of the bar at the trendline point.
+        #
+        # Note: The documentation claims the (x, y) given is the center of the
+        # circle but it doesn't seem right => we shift the circle (x,y) to what
+        # looks correct experimentally since this is just a rough visual indicator.
+        #~ dc.fillCircle(trendline_pos + radius/2, bar_y_mid + radius/2, radius)
+        dc.addEllipseColorFill(trendline_pos - 2, bar_y_mid - radius/2, radius*2, radius*2)
+      end
+    end
+
+    def process_settings
+      super()
+
+      # Handle the global TREND_SECONDS setting which will do a global change of
+      # all widgets of this type in a given screen definition file.
+      # Usage (in screen def file):
+      #                  GLOBAL_SETTING TRENDLIMITSBAR TREND_SECONDS <num_seconds>
+      if @settings.include?('TREND_SECONDS')
+        @trend_seconds = @settings['TREND_SECONDS'][0].to_f
+
+        # Make sure maximum is still enforced
+        if @trend_seconds > MAX_TREND_SECONDS
+          @trend_seconds = MAX_TREND_SECONDS
+        end
+
+        adjust_trend_points_and_data()
+      end
+    end
+
+  end
+
+end # module Cosmos
+

data/lib/cosmos/tools/tlm_viewer/widgets/trendlimitsbar_widget.rb

@@ -0,0 +1,46 @@
+# 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
+
+# This file contains the implementation of the Trendlimitsbar widget which
+# is essentially a standard limits bar compound widget with the addition of
+# a horizontal line indicating the previous trend position as well as another
+# value box with the actual trend value.
+# Trend = current value - value N samples ago.
+
+require 'cosmos/tools/tlm_viewer/widgets/widget'
+require 'cosmos/tools/tlm_viewer/widgets/multi_widget'
+require 'cosmos/tools/tlm_viewer/widgets/value_widget'
+require 'cosmos/tools/tlm_viewer/widgets/textfield_widget'
+require 'cosmos/tools/tlm_viewer/widgets/trendbar_widget'
+
+module Cosmos
+
+  class TrendlimitsbarWidget < Qt::Widget
+    include Widget
+    include MultiWidget
+
+    def initialize (parent_layout, target_name, packet_name, item_name, value_type = :WITH_UNITS, trend_seconds = 60, characters = 12, width = 160, height = 25)
+      super(target_name, packet_name, item_name, value_type)
+      setLayout(Qt::HBoxLayout.new())
+      layout.setSpacing(1)
+      layout.setContentsMargins(0,0,0,0)
+      @widgets << ValueWidget.new(layout, target_name, packet_name, item_name, value_type, characters)
+      @widgets << TextfieldWidget.new(layout, 8)
+      @widgets[-1].setReadOnly(true)
+      @widgets << TrendbarWidget.new(layout, target_name, packet_name, item_name, value_type, trend_seconds, width, height, @widgets[-1])
+      parent_layout.addWidget(self) if parent_layout
+    end
+
+    def self.takes_value?
+      return true
+    end
+  end
+
+end # module Cosmos