cosmos 3.0.1 → 3.1.0

data/lib/cosmos/core_ext/io.rb

@@ -1,75 +1,75 @@
-# 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/core_ext/cosmos_io'
-
-class IO
-  include CosmosIO
-
-  SELECT_BASE_TIMEOUT = 0.0004
-  SELECT_MAX_TIMEOUT = 0.016
-
-  def self.fast_select(read_sockets = nil, write_sockets = nil, error_array = nil, timeout = nil)
-    # Always try a zero timeout first
-    current_timeout = SELECT_BASE_TIMEOUT
-    total_timeout = 0.0
-
-    while true
-      result = IO.select(read_sockets, write_sockets, error_array, current_timeout)
-      return result if result or current_timeout.nil?
-      return nil if timeout and total_timeout >= timeout
-
-      if current_timeout <= 0.0001
-        # Always try the base timeout next
-        current_timeout = SELECT_BASE_TIMEOUT
-        total_timeout = SELECT_BASE_TIMEOUT
-      else
-        # Then start doubling the timeout
-        current_timeout = current_timeout * 2
-
-        # Until it is bigger than our max timeout
-        if current_timeout >= SELECT_MAX_TIMEOUT
-          if timeout
-            # Block for the remaining requested timeout
-            current_timeout = timeout - total_timeout
-            total_timeout = timeout
-          else
-            # Or block forever
-            current_timeout = nil
-          end
-        else
-          # Or it is bigger than the given timeout
-          if timeout and current_timeout >= timeout
-            # Block for the remaining requested timeout
-            current_timeout = timeout - total_timeout
-            total_timeout = timeout
-          else
-            # Up our total time in select
-            total_timeout += current_timeout
-          end
-          if timeout and total_timeout > timeout
-            # Block for the remaining requested timeout
-            current_timeout = timeout - total_timeout
-            total_timeout = timeout
-          end
-        end
-        return nil if current_timeout and current_timeout < 0
-      end
-    end # while true
-  end # fast_select
-
-  def self.fast_read_select(read_sockets, timeout)
-    return fast_select(read_sockets, nil, nil, timeout)
-  end
-
-  def self.fast_write_select(write_sockets, timeout)
-    return fast_select(nil, write_sockets, nil, timeout)
-  end
-end
+# 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/core_ext/cosmos_io'
+
+class IO
+  include CosmosIO
+
+  SELECT_BASE_TIMEOUT = 0.0004
+  SELECT_MAX_TIMEOUT = 0.016
+
+  def self.fast_select(read_sockets = nil, write_sockets = nil, error_array = nil, timeout = nil)
+    # Always try a zero timeout first
+    current_timeout = SELECT_BASE_TIMEOUT
+    total_timeout = 0.0
+
+    while true
+      result = IO.select(read_sockets, write_sockets, error_array, current_timeout)
+      return result if result or current_timeout.nil?
+      return nil if timeout and total_timeout >= timeout
+
+      if current_timeout <= 0.0001
+        # Always try the base timeout next
+        current_timeout = SELECT_BASE_TIMEOUT
+        total_timeout = SELECT_BASE_TIMEOUT
+      else
+        # Then start doubling the timeout
+        current_timeout = current_timeout * 2
+
+        # Until it is bigger than our max timeout
+        if current_timeout >= SELECT_MAX_TIMEOUT
+          if timeout
+            # Block for the remaining requested timeout
+            current_timeout = timeout - total_timeout
+            total_timeout = timeout
+          else
+            # Or block forever
+            current_timeout = nil
+          end
+        else
+          # Or it is bigger than the given timeout
+          if timeout and current_timeout >= timeout
+            # Block for the remaining requested timeout
+            current_timeout = timeout - total_timeout
+            total_timeout = timeout
+          else
+            # Up our total time in select
+            total_timeout += current_timeout
+          end
+          if timeout and total_timeout > timeout
+            # Block for the remaining requested timeout
+            current_timeout = timeout - total_timeout
+            total_timeout = timeout
+          end
+        end
+        return nil if current_timeout and current_timeout < 0
+      end
+    end # while true
+  end # fast_select
+
+  def self.fast_read_select(read_sockets, timeout)
+    return fast_select(read_sockets, nil, nil, timeout)
+  end
+
+  def self.fast_write_select(write_sockets, timeout)
+    return fast_select(nil, write_sockets, nil, timeout)
+  end
+end

data/lib/cosmos/core_ext/kernel.rb

@@ -1,38 +1,38 @@
-# 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
-
-# COSMOS specific additions to the Ruby Kernel module
-module Kernel
-  # @return [Boolean] Whether the current platform is Windows
-  def is_windows?
-    _, platform, *_ = RUBY_PLATFORM.split("-")
-    result = false
-    if platform == 'mswin32' or platform == 'mingw32'
-      result = true
-    end
-    return result
-  end
-
-  # @return [Boolean] Whether the current platform is Mac
-  def is_mac?
-    _, platform, *_ = RUBY_PLATFORM.split("-")
-    result = false
-    if platform =~ /darwin/
-      result = true
-    end
-    return result
-  end
-
-  # @param start [Integer] The number of stack entries to skip
-  # @return [Symbol] The name of the calling method
-  def calling_method(start = 1)
-    caller[start][/`([^']*)'/, 1].intern
-  end
-end
+# 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
+
+# COSMOS specific additions to the Ruby Kernel module
+module Kernel
+  # @return [Boolean] Whether the current platform is Windows
+  def is_windows?
+    _, platform, *_ = RUBY_PLATFORM.split("-")
+    result = false
+    if platform == 'mswin32' or platform == 'mingw32'
+      result = true
+    end
+    return result
+  end
+
+  # @return [Boolean] Whether the current platform is Mac
+  def is_mac?
+    _, platform, *_ = RUBY_PLATFORM.split("-")
+    result = false
+    if platform =~ /darwin/
+      result = true
+    end
+    return result
+  end
+
+  # @param start [Integer] The number of stack entries to skip
+  # @return [Symbol] The name of the calling method
+  def calling_method(start = 1)
+    caller[start][/`([^']*)'/, 1].intern
+  end
+end

data/lib/cosmos/core_ext/math.rb

@@ -1,119 +1,119 @@
-# 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
-
-# COSMOS specific additions to the Ruby Math module. The algorithms implemented
-# here are based on standard deviation algorithms based on Wikipedia Algorithms
-# for calculating variance, Section 3.
-module Math
-  # Add all the module instance methods as module functions so we can call them
-  # either as Math.sin_squared or directly if we "include Math"
-  extend self
-
-  # Power reduction formula. Calculates sin squared which is
-  # (1 - cos(2 * angle)) / 2
-  #
-  # @param angle [Float] Angle in degrees
-  # @return [Float] sin(angle) squared
-  def sin_squared(angle)
-    return (1.0 - Math.cos(2.0 * angle)) / 2.0
-  end
-
-  # Power reduction formula. Calculates cos squared which is
-  # (1 + cos(2 * angle)) / 2
-  #
-  # @param angle [Float] Angle in degrees
-  # @return [Float] cos(angle) squared
-  def cos_squared(angle)
-    return (1.0 + Math.cos(2.0 * angle)) / 2.0
-  end
-
-  # Calculates the population variance of a group of numbers. If the population
-  # is finite the population variance is the variance of the underlying
-  # probability distribution.
-  #
-  # @param array [Array<Numeric>] Array of values
-  # @return [Float, Float] The first value is the mean and the second is the
-  #   variance
-  def variance_population(array)
-    mean, m2, num_values = variance_generic(array)
-    if num_values != 0.0
-      return [mean, m2 / num_values]
-    else
-      return [mean, 0.0]
-    end
-  end
-
-  # Calculates the sample variance of a group of numbers. If the population of
-  # numbers is very large, it is not possible to count every value in the
-  # population, so the computation must be performed on a sample of the
-  # population.
-  #
-  # @param array [Array<Numeric>] Array of values
-  # @return [Float, Float] The first value is the mean and the second is the
-  #   variance
-  def variance_sample(array)
-    mean, m2, num_values = variance_generic(array)
-    if num_values != 1.0
-      return [mean, m2 / (num_values - 1.0)]
-    else
-      return [mean, 0.0]
-    end
-  end
-
-  # Calculates the standard deviation of the population variation by taking the
-  # square root of the population variance.
-  #
-  # @param array [Array<Numeric>] Array of values
-  # @return [Float, Float] The first value is the mean and the second is the
-  #   standard deviation
-  def stddev_population(array)
-    mean, variance = self.variance_population(array)
-    return [mean, Math.sqrt(variance)]
-  end
-
-  # Calculates the standard deviation of the sample variation by taking the
-  # square root of the sample variance.
-  #
-  # @param array [Array<Numeric>] Array of values
-  # @return [Float, Float] The first value is the mean and the second is the
-  #   standard deviation
-  def stddev_sample(array)
-    mean, variance = self.variance_sample(array)
-    return [mean, Math.sqrt(variance)]
-  end
-
-  # Calculates luma, the brightness, given RGB values.
-  #
-  # @param red [Numeric] Red RGB value (0 - 255)
-  # @param green [Numeric] Green RGB value (0 - 255)
-  # @param blue [Numeric] Blue RGB value (0 - 255)
-  # @return [Float] The calculated luma
-  def luma_from_rgb_max_255(red, green, blue)
-    (0.2126 * (red.to_f / 255.0)) + (0.7152 * (green.to_f / 255.0)) + (0.0722 * (blue.to_f / 255.0))
-  end
-
-  protected
-
-  def variance_generic(array)
-    num_values = 0.0
-    mean = 0.0
-    m2 = 0.0
-
-    array.each do |value|
-      value = value.to_f # so we work for arrays of floats or ints
-      num_values += 1.0
-      delta = value - mean
-      mean = mean + (delta / num_values)
-      m2 = m2 + delta * (value - mean)
-    end
-
-    return [mean, m2, num_values]
-  end
-end
+# 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
+
+# COSMOS specific additions to the Ruby Math module. The algorithms implemented
+# here are based on standard deviation algorithms based on Wikipedia Algorithms
+# for calculating variance, Section 3.
+module Math
+  # Add all the module instance methods as module functions so we can call them
+  # either as Math.sin_squared or directly if we "include Math"
+  extend self
+
+  # Power reduction formula. Calculates sin squared which is
+  # (1 - cos(2 * angle)) / 2
+  #
+  # @param angle [Float] Angle in degrees
+  # @return [Float] sin(angle) squared
+  def sin_squared(angle)
+    return (1.0 - Math.cos(2.0 * angle)) / 2.0
+  end
+
+  # Power reduction formula. Calculates cos squared which is
+  # (1 + cos(2 * angle)) / 2
+  #
+  # @param angle [Float] Angle in degrees
+  # @return [Float] cos(angle) squared
+  def cos_squared(angle)
+    return (1.0 + Math.cos(2.0 * angle)) / 2.0
+  end
+
+  # Calculates the population variance of a group of numbers. If the population
+  # is finite the population variance is the variance of the underlying
+  # probability distribution.
+  #
+  # @param array [Array<Numeric>] Array of values
+  # @return [Float, Float] The first value is the mean and the second is the
+  #   variance
+  def variance_population(array)
+    mean, m2, num_values = variance_generic(array)
+    if num_values != 0.0
+      return [mean, m2 / num_values]
+    else
+      return [mean, 0.0]
+    end
+  end
+
+  # Calculates the sample variance of a group of numbers. If the population of
+  # numbers is very large, it is not possible to count every value in the
+  # population, so the computation must be performed on a sample of the
+  # population.
+  #
+  # @param array [Array<Numeric>] Array of values
+  # @return [Float, Float] The first value is the mean and the second is the
+  #   variance
+  def variance_sample(array)
+    mean, m2, num_values = variance_generic(array)
+    if num_values != 1.0
+      return [mean, m2 / (num_values - 1.0)]
+    else
+      return [mean, 0.0]
+    end
+  end
+
+  # Calculates the standard deviation of the population variation by taking the
+  # square root of the population variance.
+  #
+  # @param array [Array<Numeric>] Array of values
+  # @return [Float, Float] The first value is the mean and the second is the
+  #   standard deviation
+  def stddev_population(array)
+    mean, variance = self.variance_population(array)
+    return [mean, Math.sqrt(variance)]
+  end
+
+  # Calculates the standard deviation of the sample variation by taking the
+  # square root of the sample variance.
+  #
+  # @param array [Array<Numeric>] Array of values
+  # @return [Float, Float] The first value is the mean and the second is the
+  #   standard deviation
+  def stddev_sample(array)
+    mean, variance = self.variance_sample(array)
+    return [mean, Math.sqrt(variance)]
+  end
+
+  # Calculates luma, the brightness, given RGB values.
+  #
+  # @param red [Numeric] Red RGB value (0 - 255)
+  # @param green [Numeric] Green RGB value (0 - 255)
+  # @param blue [Numeric] Blue RGB value (0 - 255)
+  # @return [Float] The calculated luma
+  def luma_from_rgb_max_255(red, green, blue)
+    (0.2126 * (red.to_f / 255.0)) + (0.7152 * (green.to_f / 255.0)) + (0.0722 * (blue.to_f / 255.0))
+  end
+
+  protected
+
+  def variance_generic(array)
+    num_values = 0.0
+    mean = 0.0
+    m2 = 0.0
+
+    array.each do |value|
+      value = value.to_f # so we work for arrays of floats or ints
+      num_values += 1.0
+      delta = value - mean
+      mean = mean + (delta / num_values)
+      m2 = m2 + delta * (value - mean)
+    end
+
+    return [mean, m2, num_values]
+  end
+end