cosmos 4.0.3-java

data/lib/cosmos/tools/tlm_grapher/plot_editors/plot_editor.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'
+require 'cosmos/gui/qt'
+
+module Cosmos
+
+  # Widget which contains the plot for editing
+  class PlotEditor < Qt::Widget
+
+    # Overall frame for this plot type
+    attr_accessor :plot
+
+    def initialize(parent, plot)
+      super(parent)
+      @plot = plot
+    end
+  end # class PlotEditor
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_grapher/plot_editors/singlexy_plot_editor.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
+
+# This file contains the implementation of the XyPlotEditor class.   This class
+# provides dialog box content to create/edit xy plots.
+
+require 'cosmos'
+require 'cosmos/tools/tlm_grapher/plot_editors/xy_plot_editor'
+require 'cosmos/tools/tlm_grapher/plots/singlexy_plot'
+
+module Cosmos
+
+  # Widget which contains the X-Y plot for editing
+  class SinglexyPlotEditor < XyPlotEditor
+
+    def initialize(parent, plot = nil)
+      plot = SinglexyPlot.new unless plot
+      super(parent, plot)
+    end
+
+  end # class SinglexyPlotEditor
+
+end # module Cosmos

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

@@ -0,0 +1,59 @@
+# 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 XyPlotEditor class.   This class
+# provides dialog box content to create/edit xy plots.
+
+require 'cosmos'
+require 'cosmos/tools/tlm_grapher/plot_editors/linegraph_plot_editor'
+require 'cosmos/tools/tlm_grapher/plots/xy_plot'
+
+module Cosmos
+
+  # Widget which contains the X-Y plot for editing
+  class XyPlotEditor < LinegraphPlotEditor
+
+    def initialize(parent, plot = nil)
+      plot = XyPlot.new unless plot
+      super(parent, plot)
+
+      # Float Choosers for Manual Scaling
+      manual_x_scale_min = nil
+      manual_x_scale_min = plot.manual_x_scale[0] if plot.manual_x_scale
+      @manual_x_scale_min  = FloatChooser.new(self, 'Manual X Axis Minimum:', manual_x_scale_min.to_s)
+      @layout.addWidget(@manual_x_scale_min)
+      manual_x_scale_max = nil
+      manual_x_scale_max = plot.manual_x_scale[1] if plot.manual_x_scale
+      @manual_x_scale_max  = FloatChooser.new(self, 'Manual X Axis Maximum:', manual_x_scale_max.to_s)
+      @layout.addWidget(@manual_x_scale_max)
+    end
+
+    # Returns the edited plot
+    def plot
+      plot = super()
+      manual_x_scale_max = @manual_x_scale_max.string.strip
+      manual_x_scale_min = @manual_x_scale_min.string.strip
+      if not manual_x_scale_max.empty? or not manual_x_scale_min.empty?
+        if manual_x_scale_max.to_f > manual_x_scale_min.to_f
+          plot.manual_x_scale = [manual_x_scale_min.to_f, manual_x_scale_max.to_f]
+        elsif manual_x_scale_min.to_f > manual_x_scale_max.to_f
+          plot.manual_x_scale = [manual_x_scale_max.to_f, manual_x_scale_min.to_f]
+        else
+          plot.manual_x_scale = nil
+        end
+      else
+        plot.manual_x_scale = nil
+      end
+      plot
+    end
+
+  end # class XyPlotEditor
+
+end # module Cosmos

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

@@ -0,0 +1,173 @@
+# 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/line_graph/line_graph'
+require 'cosmos/tools/tlm_grapher/data_objects/linegraph_data_object'
+
+module Cosmos
+
+  # Represents the entire line graph plot in the graphing system. This class
+  # extends LineGraph by implementing callbacks and the update methods which
+  # are called by higher level classes.
+  class LinegraphPlotGuiObject < LineGraph
+
+    # Color of a linegraph frame when selected
+    SELECTED_FRAME_COLOR = 'lightgreen'
+
+    def initialize(parent, tab, plot, tabbed_plots)
+      # Add new line graph
+      super(parent)
+      @plot = plot
+      @paused = nil
+
+      update()
+
+      # Setup callbacks for multi-graph mouse-overs
+      self.draw_cursor_line_callback = lambda do |calling_line_graph, x, left_button_pressed|
+        tab.plots.each do |current_plot|
+          current_plot.gui_object.remote_draw_cursor_line_at_x(x, left_button_pressed) if current_plot.gui_object != calling_line_graph and current_plot.gui_object.respond_to? :remote_draw_cursor_line_at_x
+        end
+      end
+      self.mouse_leave_callback = lambda do |calling_line_graph|
+        tab.plots.each do |current_plot|
+          current_plot.gui_object.remote_draw_cursor_line_at_x(nil, false) if current_plot.gui_object != calling_line_graph and current_plot.gui_object.respond_to? :remote_draw_cursor_line_at_x
+        end
+      end
+
+      # Setup callbacks for viewing errors
+      self.pre_error_callback = lambda do |calling_line_graph|
+        @paused = tabbed_plots.paused?
+        tabbed_plots.pause
+      end
+      self.post_error_callback = lambda do |calling_line_graph|
+        tabbed_plots.resume unless @paused
+      end
+      show()
+    end # def initialize
+
+    # Update the GraphView object properties
+    def update(redraw_needed = false)
+      self.title = @plot.title
+      self.x_axis_title = @plot.x_axis_title
+      self.left_y_axis_title = @plot.left_y_axis_title
+      self.right_y_axis_title = @plot.right_y_axis_title
+      self.show_x_grid_lines = @plot.show_x_grid_lines
+      self.show_y_grid_lines = @plot.show_y_grid_lines
+      self.point_size = @plot.point_size
+      self.show_lines = @plot.show_lines
+      self.show_legend = @plot.show_legend
+      if @plot.manual_left_y_scale
+        self.manual_scale_y(*(@plot.manual_left_y_scale))
+      else
+        self.auto_scale_y(:LEFT)
+      end
+      if @plot.manual_right_y_scale
+        self.manual_scale_y(*(@plot.manual_right_y_scale))
+      else
+        self.auto_scale_y(:RIGHT)
+      end
+      self.manual_x_grid_line_scale = @plot.manual_x_grid_line_scale
+      self.manual_y_grid_line_scale = @plot.manual_y_grid_line_scale
+      self.unix_epoch_x_values = @plot.unix_epoch_x_values
+      self.utc_time = @plot.utc_time
+
+      # Update horizontal lines
+      self.clear_horizontal_lines
+      @plot.data_objects.each do |data_object|
+        if data_object.kind_of? LinegraphDataObject
+          axis = data_object.y_axis
+          data_object.horizontal_lines.each do |y_value, color|
+            self.add_horizontal_line(y_value, color, axis)
+          end
+          if data_object.kind_of?(HousekeepingDataObject) && data_object.show_limits_lines
+            axis = data_object.y_axis
+            data_object.limits_lines.each do |y_value, color|
+              self.add_horizontal_line(y_value, color, axis)
+            end
+          end
+        end
+      end
+
+      redraw() if redraw_needed
+    end
+
+    # Update the overview graph associated with the line graph
+    def update_overview(points_plotted, overview_graph)
+      @plot.data_objects.each do |data_object|
+        begin
+          overview_graph.add_line(data_object.name, data_object.y_values, data_object.x_values, nil, nil, nil, nil, data_object.color, :LEFT, points_plotted) unless data_object.y_values.empty?
+        rescue Exception => error
+          # Ignore errors in overview graph
+          raise error if error.class == NoMemoryError
+        end
+      end
+    end
+
+    # Update the GraphView lines
+    def update_plot(points_plotted, min_x_value, max_x_value)
+      self.clear_lines
+      self.manual_scale_x(min_x_value, max_x_value, false)
+      @plot.data_objects.each do |data_object|
+        unless data_object.x_values.empty?
+          begin
+            raise "GraphView x data must be Numeric" unless data_object.x_values[0].kind_of?(Numeric)
+            range = data_object.x_values.range_within(min_x_value, max_x_value)
+            x_values = data_object.x_values[range]
+            if x_values[0] and x_values[0] >= min_x_value and x_values[0] <= max_x_value
+              y_values = data_object.y_values[range]
+              formatted_x_values = nil
+              formatted_x_values = data_object.formatted_x_values[range] unless data_object.formatted_x_values.empty?
+              self.add_line(data_object.name, y_values, x_values, nil, formatted_x_values, data_object.y_states, data_object.x_states, data_object.color, data_object.y_axis, points_plotted) unless y_values.empty?
+            end
+          rescue Exception => error
+            raise error if error.class == NoMemoryError
+            self.error = error unless self.error
+          end
+        end
+        if data_object.error
+          self.error = data_object.error
+          data_object.error = nil
+        end
+      end
+      @plot.redraw_needed = false
+    end
+
+    # Indicates if the plot is selected
+    def selected?
+      self.frame_color == SELECTED_FRAME_COLOR
+    end
+
+    # Selects the plot
+    def select
+      if self.frame_color != SELECTED_FRAME_COLOR
+        self.frame_color = SELECTED_FRAME_COLOR
+        self.frame_size = 3
+        redraw()
+      end
+    end
+
+    # Unselects plot
+    def unselect
+      if self.frame_color == SELECTED_FRAME_COLOR
+        self.frame_color = 'black'
+        self.frame_size = 0
+        redraw()
+      end
+    end
+
+    # Redraws the line graph
+    def redraw
+      self.graph
+    end
+
+  end # class LinegraphPlotGuiObject
+
+end # module Cosmos

data/lib/cosmos/tools/tlm_grapher/plot_gui_objects/singlexy_plot_gui_object.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'
+require 'cosmos/tools/tlm_grapher/plot_gui_objects/xy_plot_gui_object'
+
+module Cosmos
+
+  # Represents a single X-Y graph plot in the graphing system. This class
+  # extends XyPlotGuiObject by re-implementing update_plot.
+  class SinglexyPlotGuiObject < XyPlotGuiObject
+
+    # Updates the lines on the plot
+    def update_plot(points_plotted, min_x_value, max_x_value)
+      super(points_plotted, min_x_value, max_x_value, true)
+    end
+
+  end # class SinglexyPlotGuiObject
+
+end # module Cosmos

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

@@ -0,0 +1,74 @@
+# 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_grapher/plot_gui_objects/linegraph_plot_gui_object'
+
+module Cosmos
+
+  # Represents a X-Y graph plot in the graphing system. This class
+  # extends LinegraphPlotGuiObject by re-implementing the update methods.
+  class XyPlotGuiObject < LinegraphPlotGuiObject
+
+    # Updates the linegraph to new settings
+    def update(redraw_needed = false)
+      if @plot.manual_x_scale
+        self.manual_scale_x(*(@plot.manual_x_scale))
+      else
+        self.auto_scale_x
+      end
+      self.ordered_x_values = false
+      self.show_popup_x_y = true
+      super(redraw_needed)
+    end
+
+    # Update the overview graph with this plots data
+    def update_overview(points_plotted, overview_graph)
+      @plot.data_objects.each do |data_object|
+        begin
+          overview_graph.add_line(data_object.name, data_object.y_values, data_object.time_values, nil, nil, nil, nil, data_object.color, :LEFT, points_plotted) unless data_object.y_values.empty?
+        rescue Exception => error
+          # Ignore errors in overview graph
+          raise error if error.class == NoMemoryError
+        end
+      end
+    end
+
+    # Updates the lines on the plot
+    def update_plot(points_plotted, min_x_value, max_x_value, single = false)
+      self.clear_lines
+      @plot.data_objects.each do |data_object|
+        unless data_object.time_values.empty?
+          begin
+            raise "LineGraph time data must be Numeric" unless data_object.time_values[0].kind_of?(Numeric)
+            range = data_object.time_values.range_within(min_x_value, max_x_value)
+            range = (range.last)..(range.last) if single
+            time_values = data_object.time_values[range]
+            if time_values[0] and time_values[0] >= min_x_value and time_values[0] <= max_x_value
+              x_values = data_object.x_values[range]
+              y_values = data_object.y_values[range]
+              self.add_line(data_object.name, y_values, x_values, nil, nil, data_object.y_states, data_object.x_states, data_object.color, :LEFT, points_plotted) unless y_values.empty?
+            end
+          rescue Exception => error
+            raise error if error.class == NoMemoryError
+            self.error = error unless self.error
+          end
+        end
+        if data_object.error
+          self.error = data_object.error
+          data_object.error = nil
+        end
+      end
+      @plot.redraw_needed = false
+    end
+
+  end # class XyPlotGuiObject
+
+end # module Cosmos

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

@@ -0,0 +1,209 @@
+# 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_grapher/plots/plot'
+
+module Cosmos
+
+  # Represents a line graph plot in a plots definition
+  class LinegraphPlot < Plot
+
+    # Title of the line graph
+    attr_accessor :title
+
+    # X Axis Title
+    attr_accessor :x_axis_title
+
+    # Left Y Axis Title
+    attr_accessor :left_y_axis_title
+
+    # Right Y Axis Title
+    attr_accessor :right_y_axis_title
+
+    # Show absolute X grid labels
+    attr_accessor :show_abs_x_grid_labels
+
+    # Show x gridlines
+    attr_accessor :show_x_grid_lines
+
+    # Show y gridlines
+    attr_accessor :show_y_grid_lines
+
+    # Size of points on graph
+    attr_accessor :point_size
+
+    # Show lines on graph
+    attr_accessor :show_lines
+
+    # Show legend of data objects
+    attr_accessor :show_legend
+
+    # Manual left y scale array of y_min and y_max
+    attr_accessor :manual_left_y_scale
+
+    # Manual right  y scale array of y_min and y_max
+    attr_accessor :manual_right_y_scale
+
+    # Manual x grid line scale
+    attr_accessor :manual_x_grid_line_scale
+
+    # Manual y grid line scale
+    attr_accessor :manual_y_grid_line_scale
+
+    # Interpret x values as unix epoch timestamps
+    attr_accessor :unix_epoch_x_values
+
+    # Display x values as UTC time
+    attr_accessor :utc_time
+
+    def initialize
+      super()
+      @title = nil
+      @x_axis_title = 'Time (Seconds)'
+      @left_y_axis_title = nil
+      @right_y_axis_title = nil
+      @show_abs_x_grid_labels = true
+      @show_x_grid_lines = false
+      @show_y_grid_lines = true
+      @point_size = 5
+      @show_lines = true
+      @show_legend = true
+      @manual_left_y_scale = nil
+      @manual_right_y_scale = nil
+      @manual_x_grid_line_scale = nil
+      @manual_y_grid_line_scale = nil
+      @unix_epoch_x_values = true
+      @utc_time = false
+    end # def initialize
+
+    # Handles plot specific keywords
+    def handle_keyword(parser, keyword, parameters)
+      case keyword
+      when 'TITLE'
+        # Expect 1 parameter
+        parser.verify_num_parameters(1, 1, "TITLE <Title Text>")
+        @title = parameters[0]
+
+      when 'X_AXIS_TITLE'
+        # Expect 1 parameter
+        parser.verify_num_parameters(1, 1, "X_AXIS_LABEL <Label Text>")
+        @x_axis_title = parameters[0]
+
+      when 'Y_AXIS_TITLE'
+        # Expect 1 or 2 parameters
+        parser.verify_num_parameters(1, 2, "Y_AXIS_LABEL <Label Text> <LEFT or RIGHT (optional)>")
+        if parameters[1] and parameters[1].upcase == 'RIGHT'
+          @right_y_axis_title = parameters[0]
+        else
+          @left_y_axis_title = parameters[0]
+        end
+
+      when 'SHOW_ABS_X_GRID_LABELS'
+        # Expect 1 parameter
+        parser.verify_num_parameters(1, 1, "SHOW_ABS_X_GRID_LABELS <TRUE or FALSE>")
+        @show_abs_x_grid_labels = ConfigParser.handle_true_false(parameters[0])
+
+      when 'SHOW_X_GRID_LINES'
+        # Expect 1 parameter
+        parser.verify_num_parameters(1, 1, "SHOW_X_GRID_LINES <TRUE or FALSE>")
+        @show_x_grid_lines = ConfigParser.handle_true_false(parameters[0])
+
+      when 'SHOW_Y_GRID_LINES'
+        # Expect 1 parameter
+        parser.verify_num_parameters(1, 1, "SHOW_Y_GRID_LINES <TRUE or FALSE>")
+        @show_y_grid_lines = ConfigParser.handle_true_false(parameters[0])
+
+      when 'POINT_SIZE'
+        # Expect 1 parameter
+        parser.verify_num_parameters(1, 1, "POINT_SIZE <0 or more>")
+        @point_size = Integer(parameters[0])
+
+      when 'SHOW_LINES'
+        # Expect 1 parameter
+        parser.verify_num_parameters(1, 1, "SHOW_LINES <TRUE or FALSE>")
+        @show_lines = ConfigParser.handle_true_false(parameters[0])
+
+      when 'SHOW_LEGEND'
+        # Expect 1 parameter
+        parser.verify_num_parameters(1, 1, "SHOW_LEGEND <TRUE or FALSE>")
+        @show_legend = ConfigParser.handle_true_false(parameters[0])
+
+      when 'MANUAL_Y_AXIS_SCALE'
+        # Expect 2 or 3 parameters
+        parser.verify_num_parameters(2, 3, "MANUAL_Y_AXIS_SCALE <Y Min> <Y Max> <LEFT or RIGHT (optional)>")
+        manual_scale    = []
+        manual_scale[0] = parameters[0].to_f
+        manual_scale[1] = parameters[1].to_f
+        if manual_scale[0] >= manual_scale[1]
+          raise parser.error("#{keyword} minimum #{manual_scale[0]} not less than maximum #{manual_scale[1]}")
+        else
+          if parameters[2] and parameters[2].upcase == 'RIGHT'
+            manual_scale[2] = :RIGHT
+            @manual_right_y_scale = manual_scale
+          else
+            manual_scale[2] = :LEFT
+            @manual_left_y_scale = manual_scale
+          end
+        end
+
+      when 'MANUAL_X_GRID_LINE_SCALE'
+        # Expect 1 parameter
+        parser.verify_num_parameters(1, 1, "MANUAL_X_GRID_LINE_SCALE <Scale Value>")
+        @manual_x_grid_line_scale = parameters[0].to_f
+
+      when 'MANUAL_Y_GRID_LINE_SCALE'
+        # Expect 1 parameter
+        parser.verify_num_parameters(1, 1, "MANUAL_Y_GRID_LINE_SCALE <Scale Value>")
+        @manual_y_grid_line_scale = parameters[0].to_f
+
+      when 'UNIX_EPOCH_X_VALUES'
+        # Expect 1 parameter
+        parser.verify_num_parameters(1, 1, "UNIX_EPOCH_X_VALUES <TRUE or FALSE>")
+        @unix_epoch_x_values = ConfigParser.handle_true_false(parameters[0])
+
+      when 'UTC_TIME'
+        @utc_time = true
+
+      else
+        # Unknown keywords are passed to parent data object
+        super(parser, keyword, parameters)
+
+      end # case keyword
+
+    end # def handle_keyword
+
+    protected
+
+    # Returns the configuration lines used to create this plot
+    def plot_configuration_string
+      string = super()
+      string << "    TITLE \"#{@title}\"\n" if @title
+      string << "    X_AXIS_TITLE \"#{@x_axis_title}\"\n" if @x_axis_title
+      string << "    Y_AXIS_TITLE \"#{@left_y_axis_title}\" LEFT\n" if @left_y_axis_title
+      string << "    Y_AXIS_TITLE \"#{@right_y_axis_title}\" RIGHT\n" if @right_y_axis_title
+      string << "    SHOW_ABS_X_GRID_LABELS #{@show_abs_x_grid_labels.to_s.upcase}\n"
+      string << "    SHOW_X_GRID_LINES #{@show_x_grid_lines.to_s.upcase}\n"
+      string << "    SHOW_Y_GRID_LINES #{@show_y_grid_lines.to_s.upcase}\n"
+      string << "    POINT_SIZE #{@point_size}\n"
+      string << "    SHOW_LINES #{@show_lines.to_s.upcase}\n"
+      string << "    SHOW_LEGEND #{@show_legend.to_s.upcase}\n"
+      string << "    MANUAL_Y_AXIS_SCALE #{@manual_left_y_scale[0]} #{@manual_left_y_scale[1]} LEFT\n" if @manual_left_y_scale
+      string << "    MANUAL_Y_AXIS_SCALE #{@manual_right_y_scale[0]} #{@manual_right_y_scale[1]} RIGHT\n" if @manual_right_y_scale
+      string << "    MANUAL_X_GRID_LINE_SCALE #{@manual_x_grid_line_scale}\n" if @manual_x_grid_line_scale
+      string << "    MANUAL_Y_GRID_LINE_SCALE #{@manual_y_grid_line_scale}\n" if @manual_y_grid_line_scale
+      string << "    UNIX_EPOCH_X_VALUES #{@unix_epoch_x_values.to_s.upcase}\n"
+      string << "    UTC_TIME\n" if @utc_time
+      string
+    end # def plot_configuration_string
+
+  end # class LinegraphPlot
+
+end # module Cosmos