urbanopt-scenario 0.2.0.pre1 → 0.4.0

data/lib/urbanopt/scenario/default_reports/reporting_period.rb

@@ -1,301 +0,0 @@
-# *********************************************************************************
-# URBANopt, Copyright (c) 2019-2020, Alliance for Sustainable Energy, LLC, and other
-# contributors. All rights reserved.
-#
-# Redistribution and use in source and binary forms, with or without modification,
-# are permitted provided that the following conditions are met:
-#
-# Redistributions of source code must retain the above copyright notice, this list
-# of conditions and the following disclaimer.
-#
-# Redistributions in binary form must reproduce the above copyright notice, this
-# list of conditions and the following disclaimer in the documentation and/or other
-# materials provided with the distribution.
-#
-# Neither the name of the copyright holder nor the names of its contributors may be
-# used to endorse or promote products derived from this software without specific
-# prior written permission.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
-# IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
-# INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
-# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
-# OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
-# OF THE POSSIBILITY OF SUCH DAMAGE.
-# *********************************************************************************
-
-require 'json'
-require 'urbanopt/scenario/default_reports/end_uses'
-require 'urbanopt/scenario/default_reports/end_use'
-require 'urbanopt/scenario/default_reports/date'
-require 'urbanopt/scenario/default_reports/validator'
-require 'json-schema'
-
-module URBANopt
-  module Scenario
-    module DefaultReports
-      ##
-      # ReportingPeriod includes all the results of a specific reporting period.
-      ##
-      class ReportingPeriod
-        attr_accessor :id, :name, :multiplier, :start_date, :end_date, :month, :day_of_month, :year, :total_site_energy, :total_source_energy,
-                      :net_site_energy, :net_source_energy, :net_utility_cost, :electricity, :natural_gas, :additional_fuel, :district_cooling,
-                      :district_heating, :water, :electricity_produced, :end_uses, :energy_production, :photovoltaic, :utility_costs,
-                      :fuel_type, :total_cost, :usage_cost, :demand_cost, :comfort_result, :time_setpoint_not_met_during_occupied_cooling,
-                      :time_setpoint_not_met_during_occupied_heating, :time_setpoint_not_met_during_occupied_hours, :hours_out_of_comfort_bounds_PMV, :hours_out_of_comfort_bounds_PPD #:nodoc:
-        # ReportingPeriod class initializes the reporting period attributes:
-        # +:id+ , +:name+ , +:multiplier+ , +:start_date+ , +:end_date+ , +:month+ , +:day_of_month+ , +:year+ , +:total_site_energy+ , +:total_source_energy+ ,
-        # +:net_site_energy+ , +:net_source_energy+ , +:net_utility_cost+ , +:electricity+ , +:natural_gas+ , +:additional_fuel+ , +:district_cooling+ ,
-        # +:district_heating+ , +:water+ , +:electricity_produced+ , +:end_uses+ , +:energy_production+ , +:photovoltaic+ , +:utility_costs+ ,
-        # +:fuel_type+ , +:total_cost+ , +:usage_cost+ , +:demand_cost+ , +:comfort_result+ , +:time_setpoint_not_met_during_occupied_cooling+ ,
-        # +:time_setpoint_not_met_during_occupied_heating+ , +:time_setpoint_not_met_during_occupied_hours+
-        ##
-        # [parameters:]
-        # +hash+ - _Hash_ - A hash which may contain a deserialized reporting_period.
-        ##
-        def initialize(hash = {})
-          hash.delete_if { |k, v| v.nil? }
-          hash = defaults.merge(hash)
-
-          @id = hash[:id]
-          @name = hash[:name]
-          @multiplier = hash[:multiplier]
-          @start_date = Date.new(hash[:start_date])
-          @end_date = Date.new(hash[:end_date])
-
-          @total_site_energy = hash[:total_site_energy]
-          @total_source_energy = hash[:total_source_energy]
-          @net_site_energy = hash [:net_site_energy]
-          @net_source_energy = hash [:net_source_energy]
-          @net_utility_cost = hash [:net_utility_cost]
-          @electricity = hash [:electricity]
-          @natural_gas = hash [:natural_gas]
-          @additional_fuel = hash [:additional_fuel]
-          @district_cooling = hash [:district_cooling]
-          @district_heating = hash[:district_heating]
-          @water = hash[:water]
-          @electricity_produced = hash[:electricity_produced]
-          @end_uses = EndUses.new(hash[:end_uses])
-
-          @energy_production = hash[:energy_production]
-
-          @utility_costs = hash[:utility_costs]
-
-          @comfort_result = hash[:comfort_result]
-
-          # initialize class variables @@validator and @@schema
-          @@validator ||= Validator.new
-          @@schema ||= @@validator.schema
-        end
-
-        ##
-        # Assigns default values if values do not exist.
-        ##
-        def defaults
-          hash = {}
-
-          hash[:id] = nil
-          hash[:name] = nil
-          hash[:multiplier] = nil
-          hash[:start_date] = Date.new.to_hash
-          hash[:end_date] = Date.new.to_hash
-
-          hash[:total_site_energy] = nil
-          hash[:total_source_energy] = nil
-          hash [:net_site_energy] = nil
-          hash [:net_source_energy] = nil
-          hash [:net_utility_cost] = nil
-          hash [:electricity] = nil
-          hash [:natural_gas] = nil
-          hash [:additional_fuel] = nil
-          hash [:district_cooling] = nil
-          hash[:district_heating] = nil
-
-          hash[:electricity_produced] = nil
-          hash[:end_uses] = EndUses.new.to_hash
-          hash[:energy_production] = { electricity_produced: { photovoltaic: nil } }
-          hash[:utility_costs] = [{ fuel_type: nil, total_cost: nil, usage_cost: nil, demand_cost: nil }]
-          hash[:comfort_result] = { time_setpoint_not_met_during_occupied_cooling: nil, time_setpoint_not_met_during_occupied_heating: nil,
-                                    time_setpoint_not_met_during_occupied_hours: nil, hours_out_of_comfort_bounds_PMV: nil, hours_out_of_comfort_bounds_PPD: nil }
-
-          return hash
-        end
-
-        ##
-        # Converts to a Hash equivalent for JSON serialization.
-        ##
-        # - Exclude attributes with nil values.
-        # - Validate reporting_period hash properties against schema.
-        #
-        def to_hash
-          result = {}
-
-          result[:id] = @id if @id
-          result[:name] = @name if @name
-          result[:multiplier] = @multiplier if @multiplier
-          result[:start_date] = @start_date.to_hash if @start_date
-          result[:end_date] = @end_date.to_hash if @end_date
-          result[:total_site_energy] = @total_site_energy if @total_site_energy
-          result[:total_source_energy] = @total_source_energy if @total_source_energy
-          result[:net_site_energy] = @net_site_energy if @net_site_energy
-          result[:net_source_energy] = @net_source_energy if @net_source_energy
-          result[:net_utility_cost] = @net_utility_cost if @net_utility_cost
-          result[:electricity] = @electricity if @electricity
-          result[:natural_gas] = @natural_gas if @natural_gas
-          result[:additional_fuel] = @additional_fuel if @additional_fuel
-          result[:district_cooling] = @district_cooling if @district_cooling
-          result[:district_heating] = @district_heating if @district_heating
-          result[:water] = @water if @water
-          result[:electricity_produced] = @electricity_produced if @electricity_produced
-          result[:end_uses] = @end_uses.to_hash if @end_uses
-
-          energy_production_hash = @energy_production if @energy_production
-          energy_production_hash.delete_if { |k, v| v.nil? }
-          energy_production_hash.each do |eph|
-            eph.delete_if { |k, v| v.nil? }
-          end
-
-          result[:energy_production] = energy_production_hash if @energy_production
-
-          if @utility_costs.any?
-            result[:utility_costs] = @utility_costs
-            @utility_costs.each do |uc|
-              uc.delete_if { |k, v| v.nil? } if uc
-            end
-          end
-
-          comfort_result_hash = @comfort_result if @comfort_result
-          comfort_result_hash.delete_if { |k, v| v.nil? }
-          result[:comfort_result] = comfort_result_hash if @comfort_result
-
-          # validates +reporting_period+ properties against schema for reporting period.
-          if @@validator.validate(@@schema[:definitions][:ReportingPeriod][:properties], result).any?
-            raise "feature_report properties does not match schema: #{@@validator.validate(@@schema[:definitions][:ReportingPeriod][:properties], result)}"
-          end
-
-          return result
-        end
-
-        ##
-        # Adds up +existing_value+ and +new_values+ if not nill.
-        ##
-        # [parameter:]
-        # +existing_value+ - _Float_ - A value corresponding to a ReportingPeriod attribute.
-        ##
-        # +new_value+ - _Float_ - A value corresponding to a ReportingPeriod attribute.
-        ##
-        def self.add_values(existing_value, new_value)
-          if existing_value && new_value
-            existing_value += new_value
-          elsif new_value
-            existing_value = new_value
-          end
-          return existing_value
-        end
-
-        ##
-        # Merges an +existing_period+ with a +new_period+ if not nil.
-        ##
-        # [Parameters:]
-        # +existing_period+ - _ReportingPeriod_ - An object of ReportingPeriod class.
-        ##
-        # +new_period+ - _ReportingPeriod_ - An object of ReportingPeriod class.
-        ##
-        # rubocop: disable Metrics/AbcSize
-        def self.merge_reporting_period(existing_period, new_period)
-          # modify the existing_period by summing up the results
-          existing_period.total_site_energy = add_values(existing_period.total_site_energy, new_period.total_site_energy)
-          existing_period.total_source_energy = add_values(existing_period.total_source_energy, new_period.total_source_energy)
-          existing_period.net_source_energy = add_values(existing_period.net_source_energy, new_period.net_source_energy)
-          existing_period.net_utility_cost = add_values(existing_period.net_utility_cost, new_period.net_utility_cost)
-          existing_period.electricity = add_values(existing_period.electricity, new_period.electricity)
-          existing_period.natural_gas = add_values(existing_period.natural_gas, new_period.natural_gas)
-          existing_period.additional_fuel = add_values(existing_period.additional_fuel, new_period.additional_fuel)
-          existing_period.district_cooling = add_values(existing_period.district_cooling, new_period.district_cooling)
-          existing_period.district_heating = add_values(existing_period.district_heating, new_period.district_heating)
-          existing_period.water = add_values(existing_period.water, new_period.water)
-          existing_period.electricity_produced = add_values(existing_period.electricity_produced, new_period.electricity_produced)
-
-          # merge end uses
-          new_end_uses = new_period.end_uses
-          existing_period.end_uses.merge_end_uses!(new_end_uses) if existing_period.end_uses
-
-          if existing_period.energy_production
-            if existing_period.energy_production[:electricity_produced]
-              existing_period.energy_production[:electricity_produced][:photovoltaic] = add_values(existing_period.energy_production[:electricity_produced][:photovoltaic], new_period.energy_production[:electricity_produced][:photovoltaic])
-            end
-          end
-
-          if existing_period.utility_costs
-
-            existing_period.utility_costs.each_with_index do |item, i|
-              existing_period.utility_costs[i][:fuel_type] = add_values(existing_period.utility_costs[i][:fuel_type], new_period.utility_costs[i][:fuel_type])
-              existing_period.utility_costs[i][:total_cost] = add_values(existing_period.utility_costs[i][:total_cost], new_period.utility_costs[i][:total_cost])
-              existing_period.utility_costs[i][:usage_cost] = add_values(existing_period.utility_costs[i][:usage_cost], new_period.utility_costs[i][:usage_cost])
-              existing_period.utility_costs[i][:demand_cost] = add_values(existing_period.utility_costs[i][:demand_cost], new_period.utility_costs[i][:demand_cost])
-            end
-
-          end
-
-          if existing_period.comfort_result
-            existing_period.comfort_result[:time_setpoint_not_met_during_occupied_cooling] = add_values(existing_period.comfort_result[:time_setpoint_not_met_during_occupied_cooling], new_period.comfort_result[:time_setpoint_not_met_during_occupied_cooling])
-            existing_period.comfort_result[:time_setpoint_not_met_during_occupied_heating] = add_values(existing_period.comfort_result[:time_setpoint_not_met_during_occupied_heating], new_period.comfort_result[:time_setpoint_not_met_during_occupied_heating])
-            existing_period.comfort_result[:time_setpoint_not_met_during_occupied_hours] = add_values(existing_period.comfort_result[:time_setpoint_not_met_during_occupied_hours], new_period.comfort_result[:time_setpoint_not_met_during_occupied_hours])
-            existing_period.comfort_result[:hours_out_of_comfort_bounds_PMV] = add_values(existing_period.comfort_result[:hours_out_of_comfort_bounds_PMV], new_period.comfort_result[:hours_out_of_comfort_bounds_PMV])
-            existing_period.comfort_result[:hours_out_of_comfort_bounds_PPD] = add_values(existing_period.comfort_result[:hours_out_of_comfort_bounds_PPD], new_period.comfort_result[:hours_out_of_comfort_bounds_PPD])
-          end
-
-          return existing_period
-        end
-        # rubocop: enable Metrics/AbcSize # :nodoc:
-
-        ##
-        # Merges multiple reporting periods together.
-        # - If +existing_periods+ and +new_periods+ ids are equal,
-        # modify the existing_periods by merging the new periods results
-        # - If existing periods are empty, initialize with new_periods.
-        # - Raise an error if the existing periods are not identical with new periods (cannot have different reporting period ids).
-        ##
-        # [parameters:]
-        ##
-        # +existing_periods+ - _Array_ - An array of ReportingPeriod objects.
-        ##
-        # +new_periods+ - _Array_ - An array of ReportingPeriod objects.
-        ##
-        def self.merge_reporting_periods(existing_periods, new_periods)
-          id_list_existing = []
-          id_list_new = []
-          id_list_existing = existing_periods.collect(&:id)
-          id_list_new = new_periods.collect(&:id)
-
-          if id_list_existing == id_list_new
-
-            existing_periods.each_index do |index|
-              # if +existing_periods+ and +new_periods+ ids are equal,
-              # modify the existing_periods by merging the new periods results
-              existing_periods[index] = merge_reporting_period(existing_periods[index], new_periods[index])
-            end
-
-          elsif existing_periods.empty?
-
-            # if existing periods are empty, initialize with new_periods
-            # the = operator would link existing_periods and new_periods to the same object in memory
-            # we want to initialize with a deep clone of new_periods
-            existing_periods = Marshal.load(Marshal.dump(new_periods))
-
-          else
-            # raise an error if the existing periods are not identical with new periods (cannot have different reporting period ids)
-            raise 'cannot merge different reporting periods'
-
-          end
-
-          return existing_periods
-        end
-      end
-    end
-  end
-end

data/lib/urbanopt/scenario/default_reports/scenario_report.rb

@@ -1,311 +0,0 @@
-# *********************************************************************************
-# URBANopt, Copyright (c) 2019-2020, Alliance for Sustainable Energy, LLC, and other
-# contributors. All rights reserved.
-#
-# Redistribution and use in source and binary forms, with or without modification,
-# are permitted provided that the following conditions are met:
-#
-# Redistributions of source code must retain the above copyright notice, this list
-# of conditions and the following disclaimer.
-#
-# Redistributions in binary form must reproduce the above copyright notice, this
-# list of conditions and the following disclaimer in the documentation and/or other
-# materials provided with the distribution.
-#
-# Neither the name of the copyright holder nor the names of its contributors may be
-# used to endorse or promote products derived from this software without specific
-# prior written permission.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
-# IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
-# INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
-# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
-# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
-# OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
-# OF THE POSSIBILITY OF SUCH DAMAGE.
-# *********************************************************************************
-
-require 'urbanopt/scenario/default_reports/construction_cost'
-require 'urbanopt/scenario/default_reports/feature_report'
-require 'urbanopt/scenario/default_reports/logger'
-require 'urbanopt/scenario/default_reports/program'
-require 'urbanopt/scenario/default_reports/reporting_period'
-require 'urbanopt/scenario/default_reports/timeseries_csv'
-require 'urbanopt/scenario/default_reports/distributed_generation'
-require 'urbanopt/scenario/default_reports/validator'
-require 'json-schema'
-
-require 'json'
-require 'pathname'
-
-module URBANopt
-  module Scenario
-    module DefaultReports
-      ##
-      # ScenarioReport can generate two types of reports from a scenario.
-      # The first is a JSON format saved to 'default_scenario_report.json'.
-      # The second is a CSV format saved to 'default_scenario_report.csv'.
-      ##
-      class ScenarioReport
-        attr_accessor :id, :name, :directory_name, :timesteps_per_hour, :number_of_not_started_simulations,
-                      :number_of_started_simulations, :number_of_complete_simulations, :number_of_failed_simulations,
-                      :timeseries_csv, :location, :program, :construction_costs, :reporting_periods, :feature_reports, :distributed_generation # :nodoc:
-        # ScenarioReport class intializes the scenario report attributes:
-        # +:id+ , +:name+ , +:directory_name+, +:timesteps_per_hour+ , +:number_of_not_started_simulations+ ,
-        # +:number_of_started_simulations+ , +:number_of_complete_simulations+ , +:number_of_failed_simulations+ ,
-        # +:timeseries_csv+ , +:location+ , +:program+ , +:construction_costs+ , +:reporting_periods+ , +:feature_reports+
-        ##
-        # Each ScenarioReport object corresponds to a single Scenario.
-        ##
-        # [parameters:]
-        # +hash+ - _Hash_ - A hash of a previously serialized ScenarioReport.
-        ##
-        def initialize(hash = {})
-          hash.delete_if { |k, v| v.nil? }
-          hash = defaults.merge(hash)
-
-          @id = hash[:id]
-          @name = hash[:name]
-          @directory_name = hash[:directory_name]
-          @timesteps_per_hour = hash[:timesteps_per_hour]
-          @number_of_not_started_simulations = hash[:number_of_not_started_simulations]
-          @number_of_started_simulations = hash[:number_of_started_simulations]
-          @number_of_complete_simulations = hash[:number_of_complete_simulations]
-          @number_of_failed_simulations = hash[:number_of_failed_simulations]
-          @timeseries_csv = TimeseriesCSV.new(hash[:timeseries_csv])
-          @location = Location.new(hash[:location])
-          @program = Program.new(hash[:program])
-          @distributed_generation = DistributedGeneration.new(hash[:distributed_generation] || {})
-
-          @construction_costs = []
-          hash[:construction_costs].each do |cc|
-            @constructiion_costs << ConstructionCost.new(cc)
-          end
-
-          @reporting_periods = []
-          hash[:reporting_periods].each do |rp|
-            @reporting_periods << ReportingPeriod.new(rp)
-          end
-
-          # feature_report is intialized here to be used in the add_feature_report method
-          @feature_reports = []
-          hash[:feature_reports].each do |fr|
-            @feature_reports << FeatureReport.new(fr)
-          end
-
-          @file_name = 'default_scenario_report'
-
-          # initialize class variables @@validator and @@schema
-          @@validator ||= Validator.new
-          @@schema ||= @@validator.schema
-
-          # initialize @@logger
-          @@logger ||= URBANopt::Scenario::DefaultReports.logger
-        end
-
-        ##
-        # Assigns default values if values do not exist.
-        ##
-        def defaults
-          hash = {}
-          hash[:id] = nil.to_s
-          hash[:name] = nil.to_s
-          hash[:directory_name] = nil.to_s
-          hash[:timesteps_per_hour] = nil # unknown
-          hash[:number_of_not_started_simulations] = 0
-          hash[:number_of_started_simulations] = 0
-          hash[:number_of_complete_simulations] = 0
-          hash[:number_of_failed_simulations] = 0
-          hash[:timeseries_csv] = TimeseriesCSV.new.to_hash
-          hash[:location] = Location.new.defaults
-          hash[:program] = Program.new.to_hash
-          hash[:construction_costs] = []
-          hash[:reporting_periods] = []
-          hash[:feature_reports] = []
-          return hash
-        end
-
-        ##
-        # Gets the saved JSON file path.
-        ##
-        def json_path
-          File.join(@directory_name, @file_name + '.json')
-        end
-
-        ##
-        # Gets the saved CSV file path.
-        ##
-        def csv_path
-          File.join(@directory_name, @file_name + '.csv')
-        end
-
-        ##
-        # Saves the 'default_scenario_report.json' and 'default_scenario_report.csv' files
-        ##
-        # [parameters]:
-        # +file_name+ - _String_ - Assign a name to the saved scenario results file without an extension
-        def save(file_name = 'default_scenario_report')
-          # reassign the initialize local variable @file_name to the file name input.
-          @file_name = file_name
-
-          # save the csv data
-          old_timeseries_path = nil
-          if !@timeseries_csv.path.nil?
-            old_timeseries_path = @timeseries_csv.path
-          end
-
-          @timeseries_csv.path = File.join(@directory_name, file_name + '.csv')
-          @timeseries_csv.save_data
-
-          hash = {}
-          hash[:scenario_report] = to_hash
-          hash[:feature_reports] = []
-          @feature_reports.each do |feature_report|
-            hash[:feature_reports] << feature_report.to_hash
-          end
-
-          json_name_path = File.join(@directory_name, file_name + '.json')
-
-          File.open(json_name_path, 'w') do |f|
-            f.puts JSON.pretty_generate(hash)
-            # make sure data is written to the disk one way or the other
-            begin
-              f.fsync
-            rescue StandardError
-              f.flush
-            end
-          end
-
-          if !old_timeseries_path.nil?
-            @timeseries_csv.path = old_timeseries_path
-          else
-            @timeseries_csv.path = File.join(@directory_name, file_name + '.csv')
-          end
-          return true
-        end
-
-        ##
-        # Converts to a Hash equivalent for JSON serialization.
-        ##
-        # - Exclude attributes with nil values.
-        # - Validate reporting_period hash properties against schema.
-        ##
-        def to_hash
-          result = {}
-          result[:id] = @id if @id
-          result[:name] = @name if @name
-          result[:directory_name] = @directory_name if @directory_name
-          result[:timesteps_per_hour] = @timesteps_per_hour if @timesteps_per_hour
-          result[:number_of_not_started_simulations] = @number_of_not_started_simulations if @number_of_not_started_simulations
-          result[:number_of_started_simulations] = @number_of_started_simulations if @number_of_started_simulations
-          result[:number_of_complete_simulations] = @number_of_complete_simulations if @number_of_complete_simulations
-          result[:number_of_failed_simulations] = @number_of_failed_simulations if @number_of_failed_simulations
-          result[:timeseries_csv] = @timeseries_csv.to_hash if @timeseries_csv
-          result[:location] = @location.to_hash if @location
-          result[:program] = @program.to_hash if @program
-          result[:distributed_generation] = @distributed_generation.to_hash if @distributed_generation
-
-          result[:construction_costs] = []
-          @construction_costs.each { |cc| result[:construction_costs] << cc.to_hash } if @construction_costs
-
-          result[:reporting_periods] = []
-          @reporting_periods.each { |rp| result[:reporting_periods] << rp.to_hash } if @reporting_periods
-
-          # result[:feature_reports] = []
-          # @feature_reports.each { |fr| result[:feature_reports] << fr.to_hash } if @feature_reports
-
-          # validate scenario_report properties against schema
-          if @@validator.validate(@@schema[:definitions][:ScenarioReport][:properties], result).any?
-            raise "scenario_report properties does not match schema: #{@@validator.validate(@@schema[:definitions][:ScenarioReport][:properties], result)}"
-          end
-
-          # have to use the module method because we have not yet initialized the class one
-          @@logger.info("Scenario name: #{@name}")
-
-          return result
-        end
-
-        ##
-        # Add feature reports to each other.
-        ##
-        # - check if a feature report have been already added.
-        # - check feature simulation status
-        # - merge timeseries_csv information
-        # - merge program information
-        # - merge construction_cost information
-        # - merge reporting_periods information
-        # - add the array of feature_reports
-        # - scenario report location takes the location of the first feature in the list
-        ##
-        # [parmeters:]
-        # +feature_report+ - _FeatureReport_ - An object of FeatureReport class.
-        ##
-        def add_feature_report(feature_report)
-          # check if the timesteps_per_hour are identical
-          if @timesteps_per_hour.nil? || @timesteps_per_hour == ''
-            @timesteps_per_hour = feature_report.timesteps_per_hour
-          else
-            if feature_report.timesteps_per_hour.is_a?(Integer) && feature_report.timesteps_per_hour != @timesteps_per_hour
-              raise "FeatureReport timesteps_per_hour = '#{feature_report.timesteps_per_hour}' does not match scenario timesteps_per_hour '#{@timesteps_per_hour}'"
-            end
-          end
-
-          # check if first report_report_datetime are identical.
-          if @timeseries_csv.first_report_datetime.nil? || @timeseries_csv.first_report_datetime == ''
-            @timeseries_csv.first_report_datetime = feature_report.timeseries_csv.first_report_datetime
-          else
-            if feature_report.timeseries_csv.first_report_datetime != @timeseries_csv.first_report_datetime
-              raise "first_report_datetime '#{@first_report_datetime}' does not match other.first_report_datetime '#{feature_report.timeseries_csv.first_report_datetime}'"
-            end
-          end
-
-          # check that we have not already added this feature
-          id = feature_report.id
-          @feature_reports.each do |existing_feature_report|
-            if existing_feature_report.id == id
-              raise "FeatureReport with id = '#{id}' has already been added"
-            end
-          end
-
-          # check feature simulation status
-          if feature_report.simulation_status == 'Not Started'
-            @number_of_not_started_simulations += 1
-          elsif feature_report.simulation_status == 'Started'
-            @number_of_started_simulations += 1
-          elsif feature_report.simulation_status == 'Complete'
-            @number_of_complete_simulations += 1
-          elsif feature_report.simulation_status == 'Failed'
-            @number_of_failed_simulations += 1
-          else
-            raise "Unknown feature_report simulation_status = '#{feature_report.simulation_status}'"
-          end
-
-          # merge timeseries_csv information
-          @timeseries_csv.add_timeseries_csv(feature_report.timeseries_csv)
-
-          @timeseries_csv.run_dir_name(@directory_name)
-
-          # merge program information
-          @program.add_program(feature_report.program)
-
-          # merge construction_cost information
-          @construction_costs = ConstructionCost.merge_construction_costs(@construction_costs, feature_report.construction_costs)
-
-          # merge reporting_periods information
-          @reporting_periods = ReportingPeriod.merge_reporting_periods(@reporting_periods, feature_report.reporting_periods)
-
-          @distributed_generation = DistributedGeneration.merge_distributed_generation(@distributed_generation, feature_report.distributed_generation)
-
-          # add feature_report
-          @feature_reports << feature_report
-
-          # scenario report location takes the location of the first feature in the list
-          @location = feature_reports[0].location
-        end
-      end
-    end
-  end
-end