gravitheque 0.4.0 → 0.5.0

data/lib/calories.rb

@@ -0,0 +1,52 @@
+# Calculate how many calories a beer contains
+module Calories
+
+  # Calculates calories from alcohol
+  #
+  # @note
+  #     Extract must be measured in specific gravity
+  #
+  # @example
+  #    Calories.from_alcohol 1.055, 1.01
+  #
+  # @param [Float] original original gravity
+  # @param [Float] terminal terminal gravity
+  # @return [Fixnum] calories from alcohol
+  def self.from_alcohol original, terminal
+    ((1881.22 * terminal) *
+    ((original - terminal) / (1.775 - original))).round
+  end
+
+  # Calculates calories from extract
+  #
+  # @note
+  #     Extract must be measured in specific gravity
+  #
+  # @example
+  #    Calories.from_extract 1.055, 1.01
+  #
+  # @param [Float] original original gravity
+  # @param [Float] terminal terminal gravity
+  # @return [Fixnum] calories from extract
+  def self.from_extract original, terminal
+     (3550.0 * terminal *
+    ((0.1808 * original) + (0.8192 * terminal) - 1.0004)).round
+  end
+
+  # Calculates calories per serving; i.e. 500ml
+  #
+  # @note
+  #     Extract must be measured in specific gravity
+  #
+  # @example
+  #    Calories.per_serving 1.055, 1.01
+  #
+  # @param [Float] original original gravity
+  # @param [Float] terminal terminal gravity
+  # @return [Fixnum] calories per serving
+  def self.per_serving original, terminal
+    (from_alcohol original, terminal) +
+    (from_extract original, terminal)
+  end
+
+end

data/lib/hops.rb

@@ -0,0 +1,140 @@
+# Various hop calculations
+module Hops
+
+  # Calculates hop utilization.
+  #
+  # @note
+  #     Extract must be measured in specific gravity
+  #
+  # @example
+  #     Hops.utilization 20, 1.055
+  #
+  # @param [Fixnum] time remaining boil time
+  # @param [Float] extract specific gravity of wort
+  # @return [Float] hop utilization
+  def self.utilization time, extract
+    ((extract_adjustment extract) *
+    ((time_adjustment time) / 4.15)).round 2
+  end
+
+  # Calculate boil time adjustment
+  #
+  # @example
+  #    Hops.time_adjustment 60
+  #
+  # @param [Fixnum] time remaining boil time
+  # @return [Float] boil time adjustment
+  def self.time_adjustment time
+    (1 - Math.exp(-0.04 * time)).round 2
+  end
+
+  # Calculate extract adjustment
+  #
+  # @note
+  #     Extract must be measured in specific gravity
+  #
+  # @example
+  #    Hops.extract_adjustment 1.065
+  #
+  # @param [Float] extract specific gravity of wort
+  # @return [Float] extract adjustment
+  def self.extract_adjustment extract
+    (1.65 * 0.000125 ** (extract - 1)).round 2
+  end
+
+  # Calculates IBUs for hop addition
+  #
+  # @note
+  #     Extract must be measured specific gravity, mass in grams and volume in liters
+  #
+  # @example
+  #     Hops.ibus({
+  #       alpha: 12.4,
+  #       extract: 1.055,
+  #       mass: 56,
+  #       time: 90,
+  #       volume: 20
+  #     })
+  #
+  # @param [Hash] data data required to calculate IBUs; `alpha`, `extract`, `mass`, `time`, `volume`
+  # @return [Fixnum] IBUs from hop addition
+  def self.ibus data
+    (extract_adjustment(data[:extract]) *
+     time_adjustment(data[:time]) * (data[:alpha] / 100) *
+     data[:mass] * 1000 / (data[:volume] * 4.15)).round
+  end
+
+  # Calculates hop mass required to achieve specific IBUs.
+  #
+  # @note
+  #     Extract must be measured specific gravity, mass in grams and volume in liters
+  #
+  # @example
+  #     Hops.hop_mass_required({
+  #       alpha: 1.05,
+  #       extract: 16,
+  #       ibus: 25,
+  #       time: 60,
+  #       volume: 20
+  #     })
+  #
+  # @param [Hash] data data required to calculate hop mass required; `alpha`, `extract`, `ibus`, `time`, `volume`
+  # @return [Float] hop mass required to achieve specific IBUs
+  def self.mass_required data
+    ((data[:volume] * data[:ibus]) /
+     (utilization(data[:time], data[:extract]) *
+      data[:alpha] * 10)).round
+  end
+
+  # Calculate milliliters of HopShot required to achieve specific IBUs.
+  #
+  # @note
+  #     Extract must be measured specific gravity, mass in grams and volume in liters
+  #
+  # @example
+  #     Hops.hopshot_required({
+  #       alpha: 13.5,
+  #       extract: 1.05,
+  #       ibus: 25,
+  #       time: 60,
+  #       volume: 20
+  #     })
+  #
+  # @param [Hash] data data required to calculate HopShot required; `alpha`, `extract`, `ibus`, `time`, `volume`
+  # @return [Float] milliliters of HopShot required to achieve specific IBUs
+  def self.hopshot_required data
+    unadjusted_amount = (data[:ibus] / 10.0) * (data[:volume] / 19.0)
+
+    hopshot_required =  unadjusted_amount +
+                       (unadjusted_amount * hopshot_extract_adjustment(data[:extract]))
+
+    if data[:time] >= 90
+      hopshot_required = hopshot_required - (unadjusted_amount * 0.1)
+    end
+
+    hopshot_required.round 1
+  end
+
+  # Calculate extract adjustment for HopShot
+  #
+  # @note
+  #     Extract must be measured in specific gravity
+  #
+  # @example
+  #    Hops.hopshot_extract_adjustment 1.065
+  #
+  # @param [Float] extract specific gravity of wort
+  # @return [Float] HopShot extract adjustment
+  def self.hopshot_extract_adjustment extract
+    if extract >= 1.08 && extract < 1.1
+      0.1
+    elsif extract >= 1.1 && extract < 1.15
+      0.2
+    elsif extract >= 1.15
+      0.3
+    else
+      0
+    end
+  end
+
+end

data/lib/mash.rb

@@ -0,0 +1,57 @@
+# Various mash calculations
+module Mash
+
+  # Calculates strike water temperature
+  #
+  # @note
+  #     Temperatures must be measured in Celsius, ratio is liters per kilograms
+  #
+  # @example
+  #     Mash.strike_water({
+  #       initial: 20, # temperature of grain; i.e. ambient temperature
+  #       target: 60,  # target mash temperature
+  #       ratio: 1.25  # water to grain ratio; e.g. 1.25L/kg
+  #     })
+  #
+  #     Mash.strike_water({
+  #       initial: 20,
+  #       target: 60,
+  #       ratio: 1.25,
+  #       adjustment: 1.015 # calculated temperature is multiplied by the adjustment to compensate for heat lost to the mash tun
+  #     })
+  #
+  # @param [Hash] data data required to calculate strike temperature; `initial`, `target`, `ratio` and optionally `adjustment`
+  # @return [Fixnum] strike water temperature
+  def self.strike_temperature data
+    adjustment = data[:adjustment] || 1
+    target = data[:target]
+
+    (((0.41 / data[:ratio]) *
+      (target - data[:initial]) +
+       target) * adjustment).round
+  end
+
+  # Calculates volume of boiling water needed to increase mash temperature
+  #
+  # @note
+  #     Temperatures must be measured in Celsius, mass in kilograms and volume in liters
+  #
+  # @example
+  #     Mash.infusion_volume({
+  #       initial: 40, # current mash temperature
+  #       target: 60,  # target mash temperature
+  #       mass: 4,     # grain mass in mash
+  #       volume: 6    # water volume in mash
+  #     })
+  #
+  # @param [Hash] data data required to calculate strike temperature; `initial`, `target`, `mass`, `volume`
+  # @return [Float] liters of infusion water needed for step
+  def self.infusion_volume data
+    target = data[:target]
+
+    ((target - data[:initial]) *
+    ((0.41 * data[:mass]) + data[:volume]) /
+     (100 - target)).round 1
+  end
+
+end

data/lib/numbers.rb

@@ -0,0 +1,201 @@
+# Methods for converting Fixnums between units
+class Fixnum
+
+  # Covert Plato to specific gravity
+  #
+  # @example
+  #     14.to_specific_gravity
+  #
+  # @return [Float] degrees Plato
+  def to_specific_gravity
+    self.to_f.to_specific_gravity
+  end
+
+  # Covert Fahrenheit to Celsius
+  #
+  # @example
+  #     104.to_celsius
+  #
+  # @return [Fixnum] temperature in Celsius
+  def to_celsius
+    ((self - 32) / 1.8).round
+  end
+
+  # Covert Celsius to Fahrenheit
+  #
+  # @example
+  #     60.to_fahrenheit
+  #
+  # @return [Fixnum] temperature in Fahrenheit
+  def to_fahrenheit
+    ((self * 1.8) + 32).round
+  end
+
+  # Covert gallons (or quarts) to liters
+  #
+  # @example
+  #     5.to_liters
+  #     15.to_liters :quarts
+  #
+  # @return [Float] volume in liters
+  def to_liters unit = :gallons
+    self.to_f.to_liters unit
+  end
+
+  # Covert ounces to grams
+  #
+  # @example
+  #     2.to_grams
+  #
+  # @return [Float] mass in grams
+  def to_grams
+    self.to_f.to_grams
+  end
+
+  # Covert grams to ounces
+  #
+  # @example
+  #     56.to_ounces
+  #
+  # @return [Float] mass in ounces
+  def to_ounces
+    self.to_f.to_ounces
+  end
+
+  # Covert pounds to kilograms
+  #
+  # @example
+  #     10.to_kilograms
+  #
+  # @return [Float] mass in kilograms
+  def to_kilograms
+    self.to_f.to_kilograms
+  end
+
+  # Covert kilograms to pounds
+  #
+  # @example
+  #     10.to_pounds
+  #
+  # @return [Float] mass in pounds
+  def to_pounds
+    self.to_f.to_pounds
+  end
+
+  # Gravity correction based on sample temperature
+  #
+  # @note
+  #     Temperature must be measured in Celsius
+  #
+  # @example
+  #     40.gravity_correction
+  #
+  # @return [Float] mass in pounds
+  def gravity_correction
+    if self < 3.98
+      -0.000032692 * self - 0.000740644
+    elsif self < 50
+      -0.0008031922 - 0.0000473773 * self + 0.000007231263 * self * self - 0.00000003078278 * self * self * self
+    else
+      -0.005431719 + 0.0001963596 * self + 0.000002661056 * self * self
+    end
+  end
+
+end
+
+# Methods for converting Floats between units
+class Float
+
+  # Covert specific gravity to Plato
+  #
+  # @example
+  #     1.055.to_plato
+  #
+  # @return [Float] degrees Plato
+  def to_plato
+    (-676.67 + 1286.4 * self - 800.47 * self * self + 190.74 * self * self * self).round 1
+  end
+
+  # Covert Plato to specific gravity
+  #
+  # @example
+  #     13.6.to_specific_gravity
+  #
+  # @return [Float] degrees Plato
+  def to_specific_gravity
+    (self / (258.6 - ((self / 258.2) * 227.1)) + 1.0).round 3
+  end
+
+  # Covert specific gravity to temperature corrected specific gravity
+  #
+  # @example
+  #     1.055.to_temperature_corrected_specific_gravity 40
+  #     1.055.to_temperature_corrected_specific_gravity 110, :fahrenheit
+  #
+  # @param [Fixnum] temperature temperature of sample
+  # @param [Symbol] unit unit of temperature used; `:celsius` or `:fahrenheit`
+  # @return [Float] temperature corrected specific gravity
+  def to_temperature_corrected_specific_gravity temperature, unit = :celsius
+    temperature = temperature.to_celsius unless unit == :celsius
+    correction  = temperature.gravity_correction
+
+    (self + correction).round 3
+  end
+
+  # Covert gallons (or quarts) to liters
+  #
+  # @example
+  #     5.to_liters
+  #     15.to_liters :quarts
+  #
+  # @return [Float] volume in liters
+  def to_liters unit = :gallons
+    case unit
+    when :gallons
+      (self * 3.785412).round 1
+    when :quarts
+      (self * 0.946353).round 1
+    end
+  end
+
+  # Covert ounces to grams
+  #
+  # @example
+  #     5.5.to_grams
+  #
+  # @return [Float] mass in grams
+  def to_grams
+    (self * 28.3495231).round 1
+  end
+
+  # Covert grams to ounces
+  #
+  # @example
+  #     100.5.to_ounces
+  #
+  # @return [Float] mass in ounces
+  def to_ounces
+    (self * 0.0352739619).round 1
+  end
+
+  # Covert pounds to kilograms
+  #
+  # @example
+  #     15.5.to_kilograms
+  #
+  # @return [Float] mass in kilograms
+  def to_kilograms
+    (self * 0.453592).round 1
+  end
+
+  # Covert kilograms to pounds
+  #
+  # @example
+  #     7.5.to_pounds
+  #
+  # @return [Float] mass in pounds
+  def to_pounds
+    (self * 2.204623).round 1
+  end
+
+end