earth-ruby19 0.2.3

data/lib/earth/residence/residence_fuel_type.rb

@@ -0,0 +1,32 @@
+class ResidenceFuelType < ActiveRecord::Base
+  set_primary_key :name
+  
+  has_many :prices, :class_name => 'ResidenceFuelPrice', :foreign_key => 'residence_fuel_type_name'
+  
+  data_miner do
+    tap "Brighter Planet's residence fuel types data", Earth.taps_server
+  end
+  
+  def price_per_unit(relaxations = [])
+    conditions = { :residence_fuel_type_name => self }
+    relaxations.push Hash.new
+    relaxations.grab do |relaxation|
+      relaxation_conditions = Hash.new
+      if timeframe = relaxation[:timeframe]
+        relaxation_conditions[:year] = timeframe.from.year
+        relaxation_conditions[:month] = timeframe.from.month..timeframe.to.yesterday.month
+      end
+      if location = relaxation[:location]
+        relaxation_conditions[:locatable_type] = location.class.to_s
+        relaxation_conditions[:locatable_id] = location.id
+      end
+      ResidenceFuelPrice.average :price, :conditions => conditions.merge(relaxation_conditions)
+    end
+  end
+
+  class << self
+    def [](fuel)
+      find_by_name fuel.to_s.humanize.downcase
+    end
+  end
+end

data/lib/earth/residence/residence_fuel_type/data_miner.rb

@@ -0,0 +1,18 @@
+ResidenceFuelType.class_eval do
+  data_miner do
+    schema Earth.database_options do
+      string   'name'
+      float    'emission_factor'
+      string   'emission_factor_units'
+      # float    'energy_content'
+      # string   'energy_content_units'
+    end
+    
+    import "a list of residential fuels and their emissions factors",
+           :url => 'http://spreadsheets.google.com/pub?key=rukxnmuhhsOsrztTrUaFCXQ' do
+      key 'name'
+      store 'emission_factor', :field_name => 'emission_factor', :units_field_name => 'units'
+    end
+  end
+end
+

data/lib/earth/residence/residential_energy_consumption_survey_response.rb

@@ -0,0 +1,39 @@
+class ResidentialEnergyConsumptionSurveyResponse < ActiveRecord::Base
+  set_primary_key :department_of_energy_identifier
+    
+  belongs_to :census_division,     :foreign_key => 'census_division_number'
+  belongs_to :census_region,       :foreign_key => 'census_region_number'
+  # what follows are entirely derived here
+  belongs_to :residence_class
+  belongs_to :urbanity
+  belongs_to :dishwasher_use
+  belongs_to :air_conditioner_use
+  belongs_to :clothes_machine_use
+  
+  extend CohortScope
+  self.minimum_cohort_size = 5
+  SUBCOHORT_THRESHOLD = 5 # per Matt
+  
+  INPUT_CHARACTERISTICS = [
+    :census_region,
+    :heating_degree_days,
+    :cooling_degree_days,
+    :residence_class,
+    :rooms,
+    :bedrooms,
+    :bathrooms,
+    :floorspace,
+    :residents,
+    :urbanity,
+    :construction_year,
+    :ownership,
+  ]
+  
+  data_miner do
+    tap "Brighter Planet's sanitized RECS 2005", Earth.taps_server
+
+    process "pull dependencies" do
+      run_data_miner_on_belongs_to_associations
+    end
+  end
+end

data/lib/earth/residence/residential_energy_consumption_survey_response/data_miner.rb

@@ -0,0 +1,283 @@
+ResidentialEnergyConsumptionSurveyResponse.class_eval do
+  data_miner do
+    # sabshere 9/20/10 sorted with sort -d -t "'" -k 2 ~/Desktop/parts.txt
+    schema Earth.database_options do
+      integer  'department_of_energy_identifier'
+      integer  'air_conditioner_use_id'
+      float    'annual_energy_from_electricity_for_air_conditioners'
+      string   'annual_energy_from_electricity_for_air_conditioners_units'
+      float    'annual_energy_from_electricity_for_clothes_driers'
+      string   'annual_energy_from_electricity_for_clothes_driers_units'
+      float    'annual_energy_from_electricity_for_dishwashers'
+      string   'annual_energy_from_electricity_for_dishwashers_units'
+      float    'annual_energy_from_electricity_for_freezers'
+      string   'annual_energy_from_electricity_for_freezers_units'
+      float    'annual_energy_from_electricity_for_heating_space'
+      string   'annual_energy_from_electricity_for_heating_space_units'
+      float    'annual_energy_from_electricity_for_heating_water'
+      string   'annual_energy_from_electricity_for_heating_water_units'
+      float    'annual_energy_from_electricity_for_other_appliances'
+      string   'annual_energy_from_electricity_for_other_appliances_units'
+      float    'annual_energy_from_electricity_for_refrigerators'
+      string   'annual_energy_from_electricity_for_refrigerators_units'
+      float    'annual_energy_from_fuel_oil_for_appliances'
+      string   'annual_energy_from_fuel_oil_for_appliances_units'
+      float    'annual_energy_from_fuel_oil_for_heating_space'
+      string   'annual_energy_from_fuel_oil_for_heating_space_units'
+      float    'annual_energy_from_fuel_oil_for_heating_water'
+      string   'annual_energy_from_fuel_oil_for_heating_water_units'
+      float    'annual_energy_from_kerosene'
+      string   'annual_energy_from_kerosene_units'
+      float    'annual_energy_from_natural_gas_for_appliances'
+      string   'annual_energy_from_natural_gas_for_appliances_units'
+      float    'annual_energy_from_natural_gas_for_heating_space'
+      string   'annual_energy_from_natural_gas_for_heating_space_units'
+      float    'annual_energy_from_natural_gas_for_heating_water'
+      string   'annual_energy_from_natural_gas_for_heating_water_units'
+      float    'annual_energy_from_propane_for_appliances'
+      string   'annual_energy_from_propane_for_appliances_units'
+      float    'annual_energy_from_propane_for_heating_space'
+      string   'annual_energy_from_propane_for_heating_space_units'
+      float    'annual_energy_from_propane_for_heating_water'
+      string   'annual_energy_from_propane_for_heating_water_units'
+      float    'annual_energy_from_wood'
+      string   'annual_energy_from_wood_units'
+      boolean  'attached_1car_garage'
+      boolean  'attached_2car_garage'
+      boolean  'attached_3car_garage'
+      float    'bathrooms'
+      integer  'bedrooms'
+      string   'census_division_name'
+      integer  'census_division_number'
+      string   'census_region_name'
+      integer  'census_region_number'
+      string   'central_ac_use'
+      string   'clothes_dryer_use'
+      integer  'clothes_machine_use_id'
+      string   'clothes_washer_use'
+      string   'construction_period'
+      date     'construction_year'
+      integer  'cooling_degree_days'
+      string   'cooling_degree_days_units'
+      boolean  'detached_1car_garage'
+      boolean  'detached_2car_garage'
+      boolean  'detached_3car_garage'
+      string   'dishwasher_use_id'
+      integer  'efficient_lights_on_1_to_4_hours'
+      integer  'efficient_lights_on_4_to_12_hours'
+      integer  'efficient_lights_on_over_12_hours'
+      float    'floorspace'
+      string   'floorspace_units'
+      integer  'freezer_count'    
+      integer  'full_bathrooms'
+      integer  'half_bathrooms'
+      boolean  'heated_garage'
+      integer  'heating_degree_days'
+      string   'heating_degree_days_units'
+      float    'lighting_efficiency'
+      float    'lighting_use'
+      string   'lighting_use_units'
+      integer  'lights_on_1_to_4_hours'
+      integer  'lights_on_4_to_12_hours'
+      integer  'lights_on_over_12_hours'
+      integer  'outdoor_all_night_gas_lights'
+      integer  'outdoor_all_night_lights'
+      boolean  'ownership'
+      integer  'refrigerator_count'
+      string   'residence_class_id'
+      integer  'residents'
+      float    'rooms'
+      boolean  'thermostat_programmability'
+      integer  'total_rooms'
+      string   'urbanity_id'
+      float    'weighting'
+      string   'window_ac_use'
+    end
+    
+    process "Define some unit conversions" do
+      Conversions.register :kbtus, :joules, 1_000.0 * 1_055.05585
+      Conversions.register :square_feet, :square_metres, 0.09290304
+    end
+
+    # conversions are NOT performed here, since we first have to zero out legitimate skips
+    # otherwise you will get values like "999 pounds = 453.138778 kilograms" (where 999 is really a legit skip)
+    import 'the 2005 EIA Residential Energy Consumption Survey microdata',
+           :url => 'http://www.eia.doe.gov/emeu/recs/recspubuse05/datafiles/RECS05alldata.csv',
+           :headers => :upcase do
+      key   'department_of_energy_identifier', :field_name => 'DOEID'
+      
+      store 'residence_class_id', :field_name => 'TYPEHUQ', :dictionary => { :input => 'Code', :output => 'Description', :url => 'http://github.com/brighterplanet/manually_curated_data/raw/master/typehuq/typehuq.csv' }
+      store 'construction_year', :field_name => 'YEARMADE', :dictionary => { :input => 'Code', :sprintf => '%02d', :output => 'Date in the middle (synthetic)', :url => 'http://github.com/brighterplanet/manually_curated_data/raw/master/yearmade/yearmade.csv' }
+      store 'construction_period', :field_name => 'YEARMADE', :dictionary => { :input => 'Code', :sprintf => '%02d', :output => 'Description', :url => 'http://github.com/brighterplanet/manually_curated_data/raw/master/yearmade/yearmade.csv' }
+      store 'urbanity_id', :field_name => 'URBRUR', :dictionary => { :input => 'Code', :output => 'Description', :url => 'http://github.com/brighterplanet/manually_curated_data/raw/master/urbrur/urbrur.csv' }
+      store 'dishwasher_use_id', :field_name => 'DWASHUSE', :dictionary => { :input => 'Code', :output => 'Description', :url => 'http://github.com/brighterplanet/manually_curated_data/raw/master/dwashuse/dwashuse.csv' }
+      store 'central_ac_use', :field_name => 'USECENAC', :dictionary => { :input => 'Code', :output => 'Description', :url => 'http://github.com/brighterplanet/manually_curated_data/raw/master/usecenac/usecenac.csv' }
+      store 'window_ac_use', :field_name => 'USEWWAC', :dictionary => { :input => 'Code', :output => 'Description', :url => 'http://github.com/brighterplanet/manually_curated_data/raw/master/usewwac/usewwac.csv' }
+      store 'clothes_washer_use', :field_name => 'WASHLOAD', :dictionary => { :input => 'Code', :output => 'Description', :url => 'http://github.com/brighterplanet/manually_curated_data/raw/master/washload/washload.csv' }
+      store 'clothes_dryer_use', :field_name => 'DRYRUSE', :dictionary => { :input => 'Code', :output => 'Description', :url => 'http://github.com/brighterplanet/manually_curated_data/raw/master/dryruse/dryruse.csv' }
+      
+      store 'census_division_number', :field_name => 'DIVISION'
+      store 'census_division_name', :field_name => 'DIVISION', :dictionary => { :input => 'number', :output => 'name', :url => 'http://data.brighterplanet.com/census_divisions.csv' }
+      store 'census_region_number', :field_name => 'DIVISION', :dictionary => { :input => 'number', :output => 'census_region_number', :url => 'http://data.brighterplanet.com/census_divisions.csv' }
+      store 'census_region_name', :field_name => 'DIVISION', :dictionary => { :input => 'number', :output => 'census_region_name', :url => 'http://data.brighterplanet.com/census_divisions.csv' }
+      
+      store 'floorspace', :field_name => 'TOTSQFT', :units => :square_metres
+      store 'residents', :field_name => 'NHSLDMEM'
+      store 'refrigerator_count', :field_name => 'NUMFRIG'
+      store 'freezer_count', :field_name => 'NUMFREEZ'
+      store 'heating_degree_days', :field_name => 'HD65', :units => :degrees_fahrenheit_days # FIXME imperial
+      store 'cooling_degree_days', :field_name => 'CD65', :units => :degrees_fahrenheit_days # FIXME imperial
+      store 'annual_energy_from_fuel_oil_for_heating_space', :field_name => 'BTUFOSPH', :units => :joules
+      store 'annual_energy_from_fuel_oil_for_heating_water', :field_name => 'BTUFOWTH', :units => :joules
+      store 'annual_energy_from_fuel_oil_for_appliances', :field_name => 'BTUFOAPL', :units => :joules
+      store 'annual_energy_from_natural_gas_for_heating_space', :field_name => 'BTUNGSPH', :units => :joules
+      store 'annual_energy_from_natural_gas_for_heating_water', :field_name => 'BTUNGWTH', :units => :joules
+      store 'annual_energy_from_natural_gas_for_appliances', :field_name => 'BTUNGAPL', :units => :joules
+      store 'annual_energy_from_propane_for_heating_space', :field_name => 'BTULPSPH', :units => :joules
+      store 'annual_energy_from_propane_for_heating_water', :field_name => 'BTULPWTH', :units => :joules
+      store 'annual_energy_from_propane_for_appliances', :field_name => 'BTULPAPL', :units => :joules
+      store 'annual_energy_from_wood', :field_name => 'BTUWOOD', :units => :joules
+      store 'annual_energy_from_kerosene', :field_name => 'BTUKER', :units => :joules
+      store 'annual_energy_from_electricity_for_clothes_driers', :field_name => 'BTUELCDR', :units => :joules
+      store 'annual_energy_from_electricity_for_dishwashers', :field_name => 'BTUELDWH', :units => :joules
+      store 'annual_energy_from_electricity_for_freezers', :field_name => 'BTUELFZZ', :units => :joules
+      store 'annual_energy_from_electricity_for_refrigerators', :field_name => 'BTUELRFG', :units => :joules
+      store 'annual_energy_from_electricity_for_air_conditioners', :field_name => 'BTUELCOL', :units => :joules
+      store 'annual_energy_from_electricity_for_heating_space', :field_name => 'BTUELSPH', :units => :joules
+      store 'annual_energy_from_electricity_for_heating_water', :field_name => 'BTUELWTH', :units => :joules
+      store 'annual_energy_from_electricity_for_other_appliances', :field_name => 'BTUELAPL', :units => :joules
+      store 'weighting', :field_name => 'NWEIGHT'
+      store 'lighting_use', :static => nil, :units => :hours
+      store 'total_rooms', :field_name => 'TOTROOMS'
+      store 'full_bathrooms', :field_name => 'NCOMBATH'
+      store 'half_bathrooms', :field_name => 'NHAFBATH'
+      store 'bedrooms', :field_name => 'BEDROOMS'
+      store 'lights_on_1_to_4_hours', :field_name => 'LGT1'
+      store 'efficient_lights_on_1_to_4_hours', :field_name => 'LGT1EE'
+      store 'lights_on_4_to_12_hours', :field_name => 'LGT4'
+      store 'efficient_lights_on_4_to_12_hours', :field_name => 'LGT4EE'
+      store 'lights_on_over_12_hours', :field_name => 'LGT12'
+      store 'efficient_lights_on_over_12_hours', :field_name => 'LGT12EE'
+      store 'outdoor_all_night_lights', :field_name => 'NOUTLGTNT'
+      store 'outdoor_all_night_gas_lights', :field_name => 'NGASLIGHT'
+      # booleans where we treat anything other than true (for example legitimate skip or "occupied without paying rent") as false
+      store 'ownership', :synthesize => lambda { |row| row['KOWNRENT'] == '1' }
+      store 'thermostat_programmability', :synthesize => lambda { |row| row['PROTHERM'] == '1' }
+      store 'heated_garage', :synthesize => lambda { |row| row['GARGHEAT'] == '1' }
+      store 'attached_1car_garage', :synthesize => lambda { |row| row['GARAGE1C'] == '1' }
+      store 'detached_1car_garage', :synthesize => lambda { |row| row['DGARG1C'] == '1' }
+      store 'attached_2car_garage', :synthesize => lambda { |row| row['GARAGE2C'] == '1' }
+      store 'detached_2car_garage', :synthesize => lambda { |row| row['DGARG2C'] == '1' }
+      store 'attached_3car_garage', :synthesize => lambda { |row| row['GARAGE3C'] == '1' }
+      store 'detached_3car_garage', :synthesize => lambda { |row| row['DGARG3C'] == '1' }
+    end
+
+    # Rather than nullify the continuous variables that EIA identifies as LEGITIMATE SKIPS, we convert them to zero
+    # This makes it easier to derive useful information like "how many rooms does the house have?"
+    process "Zero out what the EIA calls LEGITIMATE SKIPS" do
+      %w{
+        annual_energy_from_electricity_for_air_conditioners
+        annual_energy_from_electricity_for_clothes_driers
+        annual_energy_from_electricity_for_dishwashers
+        annual_energy_from_electricity_for_freezers
+        annual_energy_from_electricity_for_heating_space
+        annual_energy_from_electricity_for_heating_water
+        annual_energy_from_electricity_for_other_appliances
+        annual_energy_from_electricity_for_refrigerators
+        annual_energy_from_fuel_oil_for_appliances
+        annual_energy_from_fuel_oil_for_heating_space
+        annual_energy_from_fuel_oil_for_heating_water
+        annual_energy_from_kerosene
+        annual_energy_from_propane_for_appliances
+        annual_energy_from_propane_for_heating_space
+        annual_energy_from_propane_for_heating_water
+        annual_energy_from_natural_gas_for_appliances
+        annual_energy_from_natural_gas_for_heating_space
+        annual_energy_from_natural_gas_for_heating_water
+        annual_energy_from_wood
+        lights_on_1_to_4_hours
+        lights_on_over_12_hours
+        efficient_lights_on_over_12_hours
+        efficient_lights_on_1_to_4_hours
+        lights_on_4_to_12_hours
+        efficient_lights_on_4_to_12_hours
+        outdoor_all_night_gas_lights
+        outdoor_all_night_lights
+      }.each do |attr_name|
+        max = maximum attr_name, :select => "CONVERT(#{attr_name}, UNSIGNED INTEGER)"
+        # if the maximum value of a row is all 999's, then it's a LEGITIMATE SKIP and we should set it to zero
+        if /^9+$/.match(max.to_i.to_s)
+          update_all "#{attr_name} = 0", "#{attr_name} = #{max}"
+        end
+      end
+    end
+
+    process "Convert units to metric" do
+      [
+        [ 'floorspace', :square_feet, :square_metres ],
+        [ 'annual_energy_from_fuel_oil_for_heating_space', :kbtus, :joules ],
+        [ 'annual_energy_from_fuel_oil_for_heating_water', :kbtus, :joules ],
+        [ 'annual_energy_from_fuel_oil_for_appliances', :kbtus, :joules ],
+        [ 'annual_energy_from_natural_gas_for_heating_space', :kbtus, :joules ],
+        [ 'annual_energy_from_natural_gas_for_heating_water', :kbtus, :joules ],
+        [ 'annual_energy_from_natural_gas_for_appliances', :kbtus, :joules ],
+        [ 'annual_energy_from_propane_for_heating_space', :kbtus, :joules ],
+        [ 'annual_energy_from_propane_for_heating_water', :kbtus, :joules ],
+        [ 'annual_energy_from_propane_for_appliances', :kbtus, :joules ],
+        [ 'annual_energy_from_wood', :kbtus, :joules ],
+        [ 'annual_energy_from_kerosene', :kbtus, :joules ],
+        [ 'annual_energy_from_electricity_for_clothes_driers', :kbtus, :joules ],
+        [ 'annual_energy_from_electricity_for_dishwashers', :kbtus, :joules ],
+        [ 'annual_energy_from_electricity_for_freezers', :kbtus, :joules ],
+        [ 'annual_energy_from_electricity_for_refrigerators', :kbtus, :joules ],
+        [ 'annual_energy_from_electricity_for_air_conditioners', :kbtus, :joules ],
+        [ 'annual_energy_from_electricity_for_heating_space', :kbtus, :joules ],
+        [ 'annual_energy_from_electricity_for_heating_water', :kbtus, :joules ],
+        [ 'annual_energy_from_electricity_for_other_appliances', :kbtus, :joules ],
+      ].each do |attr_name, from_units, to_units|
+        update_all "#{attr_name} = #{attr_name} * #{Conversions::Unit.exchange_rate from_units, to_units}"
+      end
+    end
+      
+    process 'Add a new field "rooms" that estimates how many rooms are in the house' do
+      update_all 'rooms = total_rooms + full_bathrooms/2 + half_bathrooms/4 + heated_garage*(attached_1car_garage + detached_1car_garage + 2*(attached_2car_garage + detached_2car_garage) + 3*(attached_3car_garage + detached_3car_garage))'
+    end
+    
+    process 'Add a new field "bathrooms" that synthesizes half and full bathrooms into one number' do
+      update_all 'bathrooms = full_bathrooms + 0.5 * half_bathrooms'
+    end
+    
+    process 'Add a new field "lighting_use" that estimates how many hours light bulbs are turned on in the house' do
+      update_all 'lighting_use = 2*(lights_on_1_to_4_hours + efficient_lights_on_1_to_4_hours) + 8*(lights_on_4_to_12_hours + efficient_lights_on_4_to_12_hours) + 16*(lights_on_over_12_hours + efficient_lights_on_over_12_hours) + 12*(outdoor_all_night_lights + outdoor_all_night_gas_lights)'
+    end
+    
+    process 'Add a new field "lighting_efficiency" that estimates what percentage of light bulbs in a house are energy-efficient' do
+      update_all 'lighting_efficiency = (2*efficient_lights_on_1_to_4_hours + 8*efficient_lights_on_4_to_12_hours + 16*efficient_lights_on_over_12_hours) / lighting_use'
+    end
+    
+    process "synthesize air conditioner use from central AC and window AC use" do
+      update_all "air_conditioner_use_id = 'Turned on just about all summer'",                        " central_ac_use = 'Turned on just about all summer'                        OR window_ac_use = 'Turned on just about all summer'"
+      update_all "air_conditioner_use_id = 'Turned on quite a bit'",                                  "(central_ac_use = 'Turned on quite a bit'                                  OR window_ac_use = 'Turned on quite a bit')                                  AND air_conditioner_use_id IS NULL"
+      update_all "air_conditioner_use_id = 'Turned on only a few days or nights when really needed'", "(central_ac_use = 'Turned on only a few days or nights when really needed' OR window_ac_use = 'Turned on only a few days or nights when really needed') AND air_conditioner_use_id IS NULL"
+      update_all "air_conditioner_use_id = 'Not used at all'",                                        "(central_ac_use = 'Not used at all'                                        OR window_ac_use = 'Not used at all')                                        AND air_conditioner_use_id IS NULL"
+    end
+    
+    process "synthesize clothes machine use from washer and dryer use" do
+      update_all "clothes_machine_use_id = clothes_washer_use",         "                                                    clothes_dryer_use = 'Use it every time you wash clothes'"
+      update_all "clothes_machine_use_id = NULL",                       "clothes_washer_use IS NULL                      AND clothes_dryer_use = 'Use it for some, but not all, loads of wash'"
+      update_all "clothes_machine_use_id = '1 load or less each week'", "clothes_washer_use = '1 load or less each week' AND clothes_dryer_use = 'Use it for some, but not all, loads of wash'"
+      update_all "clothes_machine_use_id = '1 load or less each week'", "clothes_washer_use = '2 to 4 loads'             AND clothes_dryer_use = 'Use it for some, but not all, loads of wash'"
+      update_all "clothes_machine_use_id = '2 to 4 loads'",             "clothes_washer_use = '5 to 9 loads'             AND clothes_dryer_use = 'Use it for some, but not all, loads of wash'"
+      update_all "clothes_machine_use_id = '5 to 9 loads'",             "clothes_washer_use = '10 to 15 loads'           AND clothes_dryer_use = 'Use it for some, but not all, loads of wash'"
+      update_all "clothes_machine_use_id = '10 to 15 loads'",           "clothes_washer_use = 'More than 15 loads'       AND clothes_dryer_use = 'Use it for some, but not all, loads of wash'"
+      update_all "clothes_machine_use_id = NULL",                       "clothes_washer_use IS NULL                      AND clothes_dryer_use = 'Use it infrequently'"
+      update_all "clothes_machine_use_id = '1 load or less each week'", "clothes_washer_use = '1 load or less each week' AND clothes_dryer_use = 'Use it infrequently'"
+      update_all "clothes_machine_use_id = '1 load or less each week'", "clothes_washer_use = '5 to 9 loads'             AND clothes_dryer_use = 'Use it infrequently'"
+      update_all "clothes_machine_use_id = '2 to 4 loads'",             "clothes_washer_use = '10 to 15 loads'           AND clothes_dryer_use = 'Use it infrequently'"
+      update_all "clothes_machine_use_id = '5 to 9 loads'",             "clothes_washer_use = 'More than 15 loads'       AND clothes_dryer_use = 'Use it infrequently'"
+    end
+    
+    # FIXME add precalc bathrooms per https://github.com/brighterplanet/cm1/commit/77df97c50311f3c59aad891f018bf3d487afeb98
+  end
+end
+

data/spec/lib/earth_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe Earth do
+  before :all do
+    Earth.init :all, :apply_schemas => true
+  end
+
+  it 'should require all Earth models' do
+    lambda do
+      Earth.resource_names.each { |k| k.constantize }
+    end.should_not raise_error(NameError)
+  end
+
+  it 'should include data_miner definitions' do
+    lambda do
+      Earth.resource_names.each { |k| k.constantize.should_receive(:data_miner) }
+    end
+    require 'earth/data_miner'
+  end
+
+  it 'should create a fallbacks table' do
+    Fallback.should be_table_exists
+  end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+require 'rubygems'
+require 'bundler'
+Bundler.setup
+
+require 'active_record'
+require 'sqlite3'
+ActiveRecord::Base.establish_connection :adapter => 'sqlite3',
+  :database => ':memory:'
+
+$:.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+require 'earth' # we do require Earth to live

data/vendor/geokit-rails/CHANGELOG.rdoc

@@ -0,0 +1,46 @@
+== 2009-10-02 / Version 1.2.0
+* Overhaul the test suite to be independent of a Rails project
+* Added concept of database adapter. Ported mysql/postgresql conditional code to their own adapter.
+* Added SQL Server support. THANKS http://github.com/brennandunn for all the improvements in this release
+
+== 2009-09-26 / Version 1.1.3
+* documentation updates and updated to work with Geokit gem v1.5.0
+* IMPORTANT: in the Geokit gem, Geokit::Geocoders::timeout became Geokit::Geocoders::request_timeout for jruby compatibility.
+The plugin sets this in config/initializers/geokit_config.rb. So if you've upgraded the gem to 1.5.0, you need to
+make the change manually from Geokit::Geocoders::timeout to Geokit::Geocoders::request_timeout in config/initializers/geokit_config.rb
+
+== 2009-06-08 / Version 1.1.2
+* Added support for hashes in :through. So you can do: acts_as_mappable :through => { :state => :country } (Thanks José Valim).
+
+== 2009-05-22 / Version 1.1.1
+* Support for multiple ip geocoders (Thanks dreamcat4)
+* Now checks if either :origin OR :bounds is passed, and proceeds with geokit query if this is true (Thanks Glenn Powell)
+* Raises a helpful error if someone uses through but the association does not exists or was not defined yet (Thanks José Valim)
+
+== 2009-04-11 / Version 1.1.0
+* Fixed :through usages so that the through model is only included in the query if there 
+	is an :origin passed in (Only if it is a geokit search) (Thanks Glenn Powell)
+* Move library initialisation into lib/geokit-rails. init.rb uses lib/geokit-rails now (thanks Alban Peignier)
+* Handle the case where a user passes a hash to the :conditions Finder option (thanks Adam Greene)
+* Added ability to specify domain-specific API keys (Thanks Glenn Powell)
+
+== 2009-02-20
+* More powerful assosciations in the Rails Plugin:You can now specify a model as mappable "through" an associated model. 
+In other words, that associated model is the actual mappable model with "lat" and "lng" attributes, but this "through" model 
+can still utilize all Geokit's "find by distance" finders. Also Rails 2.3 compatibility (thanks github/glennpow)
+
+== 2008-12-18
+* Split Rails plugin from geocoder gem
+* updated for Rails 2.2.2
+
+== 2008-08-20
+* Further fix of distance calculation, this time in SQL. Now uses least() function, which is available in MySQL version 3.22.5+ and postgres versions 8.1+
+
+== 2008-01-16
+* fixed the "zero-distance" bug (calculating between two points that are the same)
+
+== 2007-11-12
+* fixed a small but with queries crossing meridian, and also fixed find(:closest)
+
+== 2007-10-11
+* Fixed Rails2/Edge compatability