gravitheque 0.4.0 → 0.5.0

data/lib/yeast.rb

@@ -0,0 +1,50 @@
+# Various yeast related calculations
+module Yeast
+
+  # Calculates yeast cells required for fermentation
+  #
+  # @note
+  #     Extract must be measured in Plato, volume in liters
+  #
+  # @example
+  #     Yeast.cells_required({
+  #       extract: 15,
+  #       volume: 20
+  #     })
+  #
+  #     Yeast.cells_required({
+  #       extract: 15,
+  #       volume: 20,
+  #       type: lager
+  #     })
+  #
+  # @param [Hash] data data required to calculate yeast cells required; `extract`, `volume` and optionally `type`. `type` defaults to `:ale` but may also be `:hybrid` or `:lager`
+  # @return [Fixnum] yeast cells required
+  def self.cells_required data
+    type = data[:type] || :ale
+
+    cells_per_milliliter = case type
+    when :ale     then 750_000
+    when :hybrid  then 1_125_000
+    when :lager   then 1_500_000
+    end
+
+    (cells_per_milliliter * (data[:volume] * 1000) * data[:extract]).round
+  end
+
+  # Calculates apparent attenuation
+  #
+  # @note
+  #     Extract must be measured in Plato
+  #
+  # @example
+  #     Yeast.attenuation 13.5, 3.1
+  #
+  # @param [Float] original original Plato
+  # @param [Float] current current Plato
+  # @return [Fixnum] apparent attenuation
+  def self.attenuation original, current
+    (((original - current) / original) * 100).round
+  end
+
+end

data/test/helper.rb

@@ -0,0 +1,3 @@
+$:.push File.expand_path "../../lib", __FILE__
+
+require "minitest/autorun"

data/test/test_alcohol.rb

@@ -0,0 +1,14 @@
+require_relative "helper"
+require "alcohol"
+
+describe Alcohol do
+
+  it "must calculate alcohol by weight" do
+    (Alcohol.by_weight 13, 2.5).must_equal 4.5
+  end
+
+  it "must calculate alcohol by volume" do
+    (Alcohol.by_volume 13, 2.5).must_equal 5.7
+  end
+
+end

data/test/test_calories.rb

@@ -0,0 +1,18 @@
+require_relative "helper"
+require "calories"
+
+describe Calories do
+
+  it "must calculate calories from alcohol" do
+    (Calories.from_alcohol 1.053, 1.01).must_equal 113
+  end
+
+  it "must calculate calories from extract" do
+    (Calories.from_extract 1.053, 1.01).must_equal 62
+  end
+
+  it "must calculate calories per serving" do
+    (Calories.per_serving 1.053, 1.01).must_equal 175
+  end
+
+end

data/test/test_hops.rb

@@ -0,0 +1,68 @@
+require_relative "helper"
+require "hops"
+
+describe Hops do
+
+  it "must adjust IBUs based on boil time" do
+    (Hops.time_adjustment 60).must_equal 0.91
+  end
+
+  it "must adjust IBUs based on extract" do
+    (Hops.extract_adjustment 1.055).must_equal 1.01
+  end
+
+  it "must calculate hop utilization" do
+    (Hops.utilization 10, 1.065).must_equal 0.07
+  end
+
+  it "must calculate IBUs from hop addition" do
+    Hops.ibus({
+      extract: 1.05,
+      time: 60,
+      alpha: 5.0,
+      mass: 56,
+      volume: 19
+    }).must_equal 34
+  end
+
+  it "must calculate hop mass required" do
+    Hops.mass_required({
+      extract: 1.05,
+      time: 60,
+      alpha: 5.0,
+      ibus: 34,
+      volume: 19
+    }).must_equal 56
+  end
+
+  it "must calculate milliliters of HopShot required" do
+    Hops.hopshot_required({
+      ibus: 35,
+      time: 60,
+      volume: 19,
+      extract: 1.045
+    }).must_equal 3.5
+  
+    Hops.hopshot_required({
+      ibus: 80,
+      time: 60,
+      volume: 38,
+      extract: 1.085
+    }).must_equal 17.6
+  
+    Hops.hopshot_required({
+      ibus: 80,
+      time: 60,
+      volume: 38,
+      extract: 1.1
+    }).must_equal 19.2
+  
+    Hops.hopshot_required({
+      ibus: 60,
+      time: 90,
+      volume: 19,
+      extract: 1.15
+    }).must_equal 7.2
+  end
+
+end

data/test/test_mash.rb

@@ -0,0 +1,30 @@
+require_relative "helper"
+require "mash"
+
+describe Mash do
+
+  it "must calculate strike temperature" do
+    Mash.strike_temperature({
+      initial: 21,
+      target: 40,
+      ratio: 1.5
+    }).must_equal 45
+
+    Mash.strike_temperature({
+      initial: 16,
+      target: 66,
+      ratio: 1.5,
+      adjustment: 1.015
+    }).must_equal 81
+  end
+
+  it "must calculate infusion volume" do
+    Mash.infusion_volume({
+      initial: 40,
+      target: 60,
+      mass: 3.6,
+      volume: 3.6
+    }).must_equal 2.5
+  end
+
+end

data/test/test_numbers.rb

@@ -0,0 +1,68 @@
+require_relative "helper"
+require "numbers"
+
+describe "Numbers" do
+
+  it "must convert specific gravity to Plato" do
+    1.055.to_plato.must_equal 13.5
+    1.120.to_plato.must_equal 28.0
+  end
+
+  it "must convert Plato to specific gravity" do
+    13.5.to_specific_gravity.must_equal 1.055
+    28.0.to_specific_gravity.must_equal 1.120
+      28.to_specific_gravity.must_equal 1.120
+  end
+
+  it "must convert specific gravity to temperature corrected specific gravity" do
+    (1.055.to_temperature_corrected_specific_gravity  3).must_equal 1.054
+    (1.055.to_temperature_corrected_specific_gravity 40).must_equal 1.062
+    (1.055.to_temperature_corrected_specific_gravity 80).must_equal 1.082
+    (1.055.to_temperature_corrected_specific_gravity  37, :fahrenheit).must_equal 1.054
+    (1.055.to_temperature_corrected_specific_gravity 104, :fahrenheit).must_equal 1.062
+    (1.055.to_temperature_corrected_specific_gravity 176, :fahrenheit).must_equal 1.082
+  end
+
+  it "must convert Fahenheit to Celsius" do
+     37.to_celsius.must_equal 3
+    104.to_celsius.must_equal 40
+    176.to_celsius.must_equal 80
+  end
+
+  it "must convert Celsius to Fahenheit" do
+     3.to_fahrenheit.must_equal 37
+    40.to_fahrenheit.must_equal 104
+    80.to_fahrenheit.must_equal 176
+  end
+
+  it "must convert gallons to liters" do
+    5.5.to_liters.must_equal 20.8
+      5.to_liters.must_equal 18.9
+  end
+
+  it "must convert quarts to liters" do
+    (20.5.to_liters :quarts).must_equal 19.4
+      (16.to_liters :quarts).must_equal 15.1
+  end
+
+  it "must convert ounces to grams" do
+      2.to_grams.must_equal 56.7
+    4.5.to_grams.must_equal 127.6
+  end
+
+  it "must convert grams to ounces" do
+       56.to_ounces.must_equal 2.0
+    127.6.to_ounces.must_equal 4.5
+  end
+
+  it "must convert pounds to kilograms" do
+      10.to_kilograms.must_equal 4.5
+    20.5.to_kilograms.must_equal 9.3
+  end
+
+  it "must convert kilograms to pounds" do
+       4.to_pounds.must_equal 8.8
+    10.6.to_pounds.must_equal 23.4
+  end
+
+end

data/test/test_yeast.rb

@@ -0,0 +1,47 @@
+require_relative "helper"
+require "yeast"
+
+describe Yeast do
+
+  it "must calculate yeast cells required" do
+    Yeast.cells_required({
+      extract: 12,
+      volume: 20
+    }).must_equal 180_000_000_000
+
+    Yeast.cells_required({
+      extract: 12,
+      volume: 20,
+      type: :hybrid
+    }).must_equal 270_000_000_000
+
+    Yeast.cells_required({
+      extract: 12,
+      volume: 20,
+      type: :lager
+    }).must_equal 360_000_000_000
+  end
+
+  it "must calculate apparent attenuation" do
+    (Yeast.attenuation 13.5, 3.1).must_equal 77
+  end
+
+end
+
+#   it "must calculate apparent attenuation" do
+#     (Calculate.apparent_attenuation 13.5, 3.1).must_equal 77
+#   end
+#
+#   it "must calculate apparent attenuation from specific gravity" do
+#     (Calculate.apparent_attenuation 1.055, 1.012, :specific_gravity).must_equal 77
+#   end
+#
+#   it "must calculate apparent attenuation from brix" do
+#     (Calculate.apparent_attenuation 13.3, 7.1, :brix).must_equal 77
+#   end
+#
+#   it "must raise an exception when the extract unit is unrecognized" do
+#     lambda { Calculate.apparent_attenuation 10, 5, :dunno }.must_raise ArgumentError
+#   end
+#
+# end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gravitheque
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-02 00:00:00.000000000 Z
+date: 2012-02-05 00:00:00.000000000 Z
 dependencies: []
 description: Tools for brewers.
 email:
@@ -27,28 +27,19 @@ files:
 - README.md
 - bin/test
 - gravitheque.gemspec
-- lib/calculators.rb
-- lib/calculators/alcohol.rb
-- lib/calculators/calories.rb
-- lib/calculators/hops.rb
-- lib/calculators/mash.rb
-- lib/calculators/yeast.rb
-- lib/conversions.rb
-- lib/conversions/extract.rb
-- lib/conversions/mass.rb
-- lib/conversions/temperature.rb
-- lib/conversions/volume.rb
-- lib/gravitheque.rb
-- test/calculators/test_alcohol.rb
-- test/calculators/test_calories.rb
-- test/calculators/test_hops.rb
-- test/calculators/test_mash.rb
-- test/calculators/test_yeast.rb
-- test/conversions/test_extract.rb
-- test/conversions/test_mass.rb
-- test/conversions/test_temperature.rb
-- test/conversions/test_volume.rb
-- test/test_helper.rb
+- lib/alcohol.rb
+- lib/calories.rb
+- lib/hops.rb
+- lib/mash.rb
+- lib/numbers.rb
+- lib/yeast.rb
+- test/helper.rb
+- test/test_alcohol.rb
+- test/test_calories.rb
+- test/test_hops.rb
+- test/test_mash.rb
+- test/test_numbers.rb
+- test/test_yeast.rb
 homepage: http://gravitheque.herokuapp.com/
 licenses: []
 post_install_message: 
@@ -74,14 +65,11 @@ signing_key:
 specification_version: 3
 summary: The library that will eventually power the web application of the same name.
 test_files:
-- test/calculators/test_alcohol.rb
-- test/calculators/test_calories.rb
-- test/calculators/test_hops.rb
-- test/calculators/test_mash.rb
-- test/calculators/test_yeast.rb
-- test/conversions/test_extract.rb
-- test/conversions/test_mass.rb
-- test/conversions/test_temperature.rb
-- test/conversions/test_volume.rb
-- test/test_helper.rb
+- test/helper.rb
+- test/test_alcohol.rb
+- test/test_calories.rb
+- test/test_hops.rb
+- test/test_mash.rb
+- test/test_numbers.rb
+- test/test_yeast.rb
 has_rdoc: 

data/lib/calculators.rb

@@ -1,6 +0,0 @@
-require "calculators/alcohol"
-require "calculators/calories"
-
-# Zymological mathematics.
-module Calculate
-end

data/lib/calculators/alcohol.rb

@@ -1,71 +0,0 @@
-require "conversions/extract"
-
-module Calculate
-
-  # Calculates alcohol by weight given original and terminal extract levels.
-  # Supported extract units are `:brix`, `:plato` and `:specific_gravity`. Default: `:plato`
-  #
-  # @example
-  #     Calculate.alcohol_by_weight({ original: 17.5, terminal: 3.2 })
-  #
-  #     Calculate.alcohol_by_weight({
-  #       original: 1.055,
-  #       terminal: 1.010
-  #     }, :specific_gravity)
-  #
-  #     Calculate.alcohol_by_weight({
-  #       original: 15.2,
-  #       terminal: 7.8
-  #     }, :brix)
-  #
-  # @param [Hash] extract the original and terminal extract levels
-  # @param [Symbol] unit the unit used to measure extract
-  # @return [Float] the alcohol content by weight
-  def self.alcohol_by_weight extract, units = :plato
-    original = extract[:original]
-    terminal = extract[:terminal]
-
-    unless units == :plato
-      case units
-      when :specific_gravity
-        original = Convert.specific_gravity_to_plato(extract[:original])
-        terminal = Convert.specific_gravity_to_plato(extract[:terminal])
-      when :brix
-        original = Convert.specific_gravity_to_plato(
-          Convert.brix_to_specific_gravity(extract[:original]))
-        terminal = Convert.specific_gravity_to_plato(
-          Convert.terminal_brix_to_terminal_gravity(
-            extract[:original], extract[:terminal]))
-      else
-        raise ArgumentError, "#{units} is an unknown unit of extract. Use :brix, :plato or :specific_gravity"
-      end
-    end
-
-    ((original - ((0.1808 * original) + (0.8192 * terminal))) /
-     (2.0665 - (0.010665 * original))).round 1
-  end
-
-  # Calculates alcohol by volume given original and terminal extract levels.
-  # Supported extract units are `:brix`, `:plato` and `:specific_gravity`. Default: `:plato`
-  #
-  # @example
-  #     Calculate.alcohol_by_volume({ original: 17.5, terminal: 3.2 })
-  #
-  #     Calculate.alcohol_by_volume({
-  #       original: 1.055,
-  #       terminal: 1.010
-  #     }, :specific_gravity)
-  #
-  #     Calculate.alcohol_by_volume({
-  #       original: 15.2,
-  #       terminal: 7.8
-  #     }, :brix)
-  #
-  # @param [Hash] extract the original and terminal extract levels
-  # @param [Symbol] unit the unit used to measure extract
-  # @return [Float] the alcohol content by volume
-  def self.alcohol_by_volume extract, units = :plato
-    ((alcohol_by_weight extract, units) / 0.793573).round 1
-  end
-
-end