urbanopt-reopt 1.0.0 → 1.2.0

data/lib/urbanopt/reopt/reopt_ghp_result.rb

@@ -0,0 +1,145 @@
+require 'json'
+require 'fileutils'
+
+module URBANopt # :nodoc:
+    module REopt # :nodoc:
+        class REoptGHPResult
+
+            def initialize
+                @@logger ||= URBANopt::REopt.reopt_logger
+            end
+
+            def result_calculate(reopt_ghp_dir)
+                reopt_output = File.join(reopt_ghp_dir, 'reopt_ghp_outputs')
+                bau_outputs = []
+                ghp_outputs = []
+
+                # Collect all valid output files with building ID
+                Dir.glob(File.join(reopt_output, '*_output.json')) do |file|
+                    filename = File.basename(file)
+                    parts = filename.split('_') # ["BAU", "building", "1", "output.json"]
+                    next unless parts.length >= 4
+
+                    scenario = parts[0] # "BAU", "GHP", etc.
+                    building_id = parts[1..2].join('_') # "building_1"
+
+                    if scenario == 'BAU'
+                        bau_outputs << [file, building_id]
+                    elsif ['GHP', 'GHX'].include?(scenario)
+                        ghp_outputs << [file, building_id]
+                    end
+                end
+
+                # Initialize grouped results
+                lcc = {}
+                lifecycle_capital_costs = {}
+                initial_capital_costs = {}
+                initial_capital_costs_after_incentives = {}
+                lifecycle_elecbill_after_tax = {}
+                npv = {}
+
+                # Totals
+                lcc_total_bau = 0
+                lcc_total_ghp = 0
+                lifecycle_capital_costs_total_bau = 0
+                lifecycle_capital_costs_total_ghp = 0
+                initial_capital_costs_total_bau = 0
+                initial_capital_costs_total_ghp = 0
+                initial_capital_costs_after_incentives_total_bau = 0
+                initial_capital_costs_after_incentives_total_ghp = 0
+                lifecycle_elecbill_after_tax_total_bau = 0
+                lifecycle_elecbill_after_tax_total_ghp = 0
+                npv_total_bau = 0
+                npv_total_ghp = 0
+
+                # Process BAU files
+                bau_outputs.each do |file, building_id|
+                    data = JSON.parse(File.read(file), symbolize_names: true)
+                    financial = data.dig(:outputs, :Financial) || {}
+
+                    lcc["lcc_bau_#{building_id}"] = financial[:lcc] || 0
+                    lcc_total_bau += lcc["lcc_bau_#{building_id}"]
+
+                    lifecycle_capital_costs["bau_#{building_id}"] = financial[:lifecycle_capital_costs] || 0
+                    lifecycle_capital_costs_total_bau += lifecycle_capital_costs["bau_#{building_id}"]
+
+                    initial_capital_costs["bau_#{building_id}"] = financial[:initial_capital_costs] || 0
+                    initial_capital_costs_total_bau += initial_capital_costs["bau_#{building_id}"]
+
+                    initial_capital_costs_after_incentives["bau_#{building_id}"] = financial[:initial_capital_costs_after_incentives] || 0
+                    initial_capital_costs_after_incentives_total_bau += initial_capital_costs_after_incentives["bau_#{building_id}"]
+
+                    lifecycle_elecbill_after_tax["bau_#{building_id}"] = financial[:lifecycle_elecbill_after_tax_bau] || 0
+                    lifecycle_elecbill_after_tax_total_bau += lifecycle_elecbill_after_tax["bau_#{building_id}"]
+
+                    npv["bau_#{building_id}"] = financial[:npv] || 0
+                    npv_total_bau += npv["bau_#{building_id}"]
+                end
+
+                # Process GHP files
+                ghp_outputs.each do |file, building_id|
+                    data = JSON.parse(File.read(file), symbolize_names: true)
+                    financial = data.dig(:outputs, :Financial) || {}
+
+                    lcc["lcc_ghp_#{building_id}"] = financial[:lcc] || 0
+                    lcc_total_ghp += lcc["lcc_ghp_#{building_id}"]
+
+                    lifecycle_capital_costs["ghp_#{building_id}"] = financial[:lifecycle_capital_costs] || 0
+                    lifecycle_capital_costs_total_ghp += lifecycle_capital_costs["ghp_#{building_id}"]
+
+                    initial_capital_costs["ghp_#{building_id}"] = financial[:initial_capital_costs] || 0
+                    initial_capital_costs_total_ghp += initial_capital_costs["ghp_#{building_id}"]
+
+                    initial_capital_costs_after_incentives["ghp_#{building_id}"] = financial[:initial_capital_costs_after_incentives] || 0
+                    initial_capital_costs_after_incentives_total_ghp += initial_capital_costs_after_incentives["ghp_#{building_id}"]
+
+                    lifecycle_elecbill_after_tax["ghp_#{building_id}"] = financial[:lifecycle_elecbill_after_tax] || 0
+                    lifecycle_elecbill_after_tax_total_ghp += lifecycle_elecbill_after_tax["ghp_#{building_id}"]
+
+                    npv["ghp_#{building_id}"] = financial[:npv] || 0
+                    npv_total_ghp += npv["ghp_#{building_id}"]
+                end
+
+                # Add totals and net values
+                lcc["lcc_bau_total"] = lcc_total_bau
+                lcc["lcc_ghp_total"] = lcc_total_ghp
+                lcc["lcc_net"] = lcc_total_ghp - lcc_total_bau
+
+                lifecycle_capital_costs["bau_total"] = lifecycle_capital_costs_total_bau
+                lifecycle_capital_costs["ghp_total"] = lifecycle_capital_costs_total_ghp
+                lifecycle_capital_costs["net"] = lifecycle_capital_costs_total_ghp - lifecycle_capital_costs_total_bau
+
+                initial_capital_costs["bau_total"] = initial_capital_costs_total_bau
+                initial_capital_costs["ghp_total"] = initial_capital_costs_total_ghp
+                initial_capital_costs["net"] = initial_capital_costs_total_ghp - initial_capital_costs_total_bau
+
+                initial_capital_costs_after_incentives["bau_total"] = initial_capital_costs_after_incentives_total_bau
+                initial_capital_costs_after_incentives["ghp_total"] = initial_capital_costs_after_incentives_total_ghp
+                initial_capital_costs_after_incentives["net"] = initial_capital_costs_after_incentives_total_ghp - initial_capital_costs_after_incentives_total_bau
+
+                lifecycle_elecbill_after_tax["bau_total"] = lifecycle_elecbill_after_tax_total_bau
+                lifecycle_elecbill_after_tax["ghp_total"] = lifecycle_elecbill_after_tax_total_ghp
+                lifecycle_elecbill_after_tax["net"] = lifecycle_elecbill_after_tax_total_ghp - lifecycle_elecbill_after_tax_total_bau
+
+                npv["bau_total"] = npv_total_bau
+                npv["ghp_total"] = npv_total_ghp
+                npv["net"] = npv_total_ghp - npv_total_bau
+
+                # Final result structure
+                result_data = {
+                    lcc: lcc,
+                    lifecycle_capital_cost: lifecycle_capital_costs,
+                    initial_capital_costs: initial_capital_costs,
+                    initial_capital_costs_after_incentives: initial_capital_costs_after_incentives,
+                    lifecycle_elecbill_after_tax: lifecycle_elecbill_after_tax,
+                    npv: npv
+                }
+
+                output_path = File.join(reopt_ghp_dir, "reopt_ghp_result_summary.json")
+                File.open(output_path, "w") { |file| file.write(JSON.pretty_generate(result_data)) }
+                puts "Wrote summary to #{output_path}"
+            end
+
+        end
+    end
+end

data/lib/urbanopt/reopt/reopt_lite_api.rb

@@ -1,5 +1,5 @@
 # *********************************************************************************
-# URBANopt (tm), Copyright (c) Alliance for Sustainable Energy, LLC.
+# URBANopt (tm), Copyright (c) Alliance for Energy Innovation, LLC.
 # See also https://github.com/urbanopt/urbanopt-reopt-gem/blob/develop/LICENSE.md
 # *********************************************************************************
 
@@ -29,7 +29,8 @@ module URBANopt # :nodoc:
         @use_localhost = use_localhost
         if @use_localhost
           @uri_submit = URI.parse('http//:127.0.0.1:8000/v3/job/')
-          @uri_submit_outagesimjob = URI.parse('http//:127.0.0.1:8000/v3/outagesimjob/')
+          @uri_submit_outagesimjob = URI.parse('http://127.0.0.1:8000/v3/erp/')
+
         else
           if [nil, '', '<insert your key here>'].include? nrel_developer_key
             if [nil, '', '<insert your key here>'].include? DEVELOPER_NREL_KEY
@@ -40,7 +41,7 @@ module URBANopt # :nodoc:
           end
           @nrel_developer_key = nrel_developer_key
           @uri_submit = URI.parse("https://developer.nrel.gov/api/reopt/v3/job?api_key=#{@nrel_developer_key}")
-          @uri_submit_outagesimjob = URI.parse("https://developer.nrel.gov/api/reopt/v3/outagesimjob?api_key=#{@nrel_developer_key}")
+          @uri_submit_outagesimjob = URI.parse("https://developer.nrel.gov/api/reopt/v3/erp?api_key=#{@nrel_developer_key}")
           # initialize @@logger
           @@logger ||= URBANopt::REopt.reopt_logger
         end
@@ -76,10 +77,10 @@ module URBANopt # :nodoc:
       ##
       def uri_resilience(run_uuid) # :nodoc:
         if @use_localhost
-          return URI.parse("http://127.0.0.1:8000/v3/job/#{run_uuid}/resilience_stats")
+          return URI.parse("http://127.0.0.1:8000/v3/erp/#{run_uuid}/results")
         end
 
-        return URI.parse("https://developer.nrel.gov/api/reopt/v3/job/#{run_uuid}/resilience_stats?api_key=#{@nrel_developer_key}")
+        return URI.parse("https://developer.nrel.gov/api/reopt/v3/erp/#{run_uuid}/results?api_key=#{@nrel_developer_key}")
       end
 
       def make_request(http, req, max_tries = 3)
@@ -167,7 +168,7 @@ module URBANopt # :nodoc:
       #
       # [*return:*] _Bool_ - Returns true if the post succeeds. Otherwise returns false.
       ##
-      def resilience_request(run_uuid, filename)
+      def resilience_request(run_uuid, filename, reopt_input, erp_assumptions_file)
         if File.directory? filename
           if run_uuid.nil?
             run_uuid = 'error'
@@ -176,23 +177,60 @@ module URBANopt # :nodoc:
             run_uuid = "error#{SecureRandom.uuid}"
           end
           filename = File.join(filename, "#{run_uuid}_resilience.json")
+          # Save the REopt resilience results to a file
           @@logger.info("REopt results saved to #{filename}")
         end
 
-        # Submit Job
-        @@logger.info("Submitting Resilience Statistics job for #{run_uuid}")
+        # Add info message to logger
+        @@logger.info("Submitting Resilience Statistics job for #{run_uuid}")  
+        
+        # Format HTTP request
         header = { 'Content-Type' => 'application/json' }
         http = Net::HTTP.new(@uri_submit_outagesimjob.host, @uri_submit_outagesimjob.port)
         if !@use_localhost
           http.use_ssl = true
         end
+        
+        # POST to erp endpoint
         post_request = Net::HTTP::Post.new(@uri_submit_outagesimjob, header)
-        post_request.body = ::JSON.generate({ 'run_uuid' => run_uuid, 'bau' => false }, allow_nan: true)
+        post = erp_assumptions_file
+        post["reopt_run_uuid"] = run_uuid
+        
+        post_request.body = ::JSON.generate(post, allow_nan: true)
+
+        # Send the request
         submit_response = make_request(http, post_request)
+        if !submit_response.is_a?(Net::HTTPSuccess)
+          @@logger.error('make_request Failed')
+          raise 'REopt connection Failed'
+        end
         @@logger.debug(submit_response.body)
 
-        # Fetch Results
-        uri = uri_resilience(run_uuid)
+        # Get <erp_run_uuid>
+        erp_run_uuid = JSON.parse(submit_response.body, allow_nan: true)['run_uuid']
+        
+        
+        if File.directory? filename
+          if erp_run_uuid.nil?
+            erp_run_uuid = 'error'
+          end
+          if erp_run_uuid.downcase.include? 'error'
+            erp_run_uuid = "error#{SecureRandom.uuid}"
+          end
+          filename = File.join(filename, "#{description}_#{erp_run_uuid}.json")
+          @@logger.info("REopt ERP results saved to #{filename}")
+        end
+
+        text = JSON.parse(submit_response.body, allow_nan: true)
+        if submit_response.code != '201'
+          File.open(filename, 'w+') do |f|
+            f.puts(JSON.pretty_generate(text))
+          end
+          raise "Error in REopt optimization post - see #{filename}"
+        end
+
+        # Fetch Results, pass on <erp_run_uuid>
+        uri = uri_resilience(erp_run_uuid)
         http = Net::HTTP.new(uri.host, uri.port)
         if !@use_localhost
           http.use_ssl = true
@@ -305,7 +343,7 @@ module URBANopt # :nodoc:
           response = make_request(http, get_request)
 
           data = JSON.parse(response.body, allow_nan: true)
-
+          
           if !data['outputs']['PV']
             pv_sizes = 0
             sizes = 0
@@ -389,7 +427,10 @@ module URBANopt # :nodoc:
         end
 
         if status == 'optimal'
-          return data
+          return {
+            'data' => data,
+            'run_uuid' => run_uuid
+          }
         end
 
         error_message = data['messages']['error']

data/lib/urbanopt/reopt/reopt_logger.rb

@@ -1,5 +1,5 @@
 # *********************************************************************************
-# URBANopt (tm), Copyright (c) Alliance for Sustainable Energy, LLC.
+# URBANopt (tm), Copyright (c) Alliance for Energy Innovation, LLC.
 # See also https://github.com/urbanopt/urbanopt-reopt-gem/blob/develop/LICENSE.md
 # *********************************************************************************
 

data/lib/urbanopt/reopt/reopt_post_processor.rb

@@ -1,5 +1,5 @@
 # *********************************************************************************
-# URBANopt (tm), Copyright (c) Alliance for Sustainable Energy, LLC.
+# URBANopt (tm), Copyright (c) Alliance for Energy Innovation, LLC.
 # See also https://github.com/urbanopt/urbanopt-reopt-gem/blob/develop/LICENSE.md
 # *********************************************************************************
 
@@ -24,7 +24,7 @@ module URBANopt # :nodoc:
       # * +use_localhost+ - _Bool_ - If this is true, requests will be sent to a version of the \REopt API running on localhost. Default is false, such that the production version of \REopt is accessed.
       # * +nrel_developer_key+ - _String_ - API used to access the \REopt APi. Required only if +localhost+ is false. Obtain from https://developer.nrel.gov/signup/
       ##
-      def initialize(scenario_report, scenario_reopt_assumptions_file = nil, reopt_feature_assumptions = [], nrel_developer_key = nil, localhost = false)
+      def initialize(scenario_report, scenario_reopt_assumptions_file = nil, reopt_feature_assumptions = [], nrel_developer_key = nil, localhost = false, erp_assumptions_file = nil)
         # initialize @@logger
         @@logger ||= URBANopt::REopt.reopt_logger
 
@@ -75,9 +75,17 @@ module URBANopt # :nodoc:
             @feature_reports_reopt_default_assumption_hashes << JSON.parse(File.open(file, 'r').read, symbolize_names: true)
           end
         end
+
+        if !erp_assumptions_file.nil?
+          @erp_assumptions_file = erp_assumptions_file
+          File.open(erp_assumptions_file, 'r') do |file|
+            @scenario_erp_default_assumptions_hash = JSON.parse(file.read, symbolize_names: true)
+          end
+        end
+
       end
 
-      attr_accessor :scenario_reopt_default_assumptions_hash, :scenario_reopt_default_output_file, :scenario_timeseries_default_output_file, :feature_reports_reopt_default_assumption_hashes, :feature_reports_reopt_default_output_files, :feature_reports_timeseries_default_output_files
+      attr_accessor :scenario_reopt_default_assumptions_hash, :scenario_reopt_default_output_file, :scenario_timeseries_default_output_file, :feature_reports_reopt_default_assumption_hashes, :feature_reports_reopt_default_output_files, :feature_reports_timeseries_default_output_files, :erp_assumptions_file
 
       ##
       # Updates a FeatureReport based on an optional set of \REopt optimization assumptions.
@@ -101,8 +109,9 @@ module URBANopt # :nodoc:
           reopt_output_file = File.join(feature_report.directory_name, 'reopt')
         end
         reopt_output = api.reopt_request(reopt_input, reopt_output_file)
-        @@logger.debug("REOpt output file: #{reopt_output_file}")
+
         if run_resilience
+          # get run UUID from the reopt output
           run_uuid = reopt_output['outputs']['run_uuid']
           if File.directory? reopt_output_file
             resilience_stats = api.resilience_request(run_uuid, reopt_output_file)
@@ -128,11 +137,11 @@ module URBANopt # :nodoc:
       #
       # * +feature_report+ - _URBANopt::Reporting::DefaultReports::ScenarioReport_ -  ScenarioReport which will be used in creating and then updated by a \REopt opimization response.
       # * +reopt_assumptions_hash+ - _Hash_ - Optional. A \REopt formatted hash containing default parameters (i.e. utility rate, escalation rate) which will be updated by the ScenarioReport (i.e. location, roof availability)
-      # * +reopt_output_file+ - _String_ - Optional. Path to a file at which REpopt responses will be saved.
+      # * +reopt_output_file+ - _String_ - Optional. Path to a file at which REopt responses will be saved.
       # * +timeseries_csv_path+ - _String_ - Optional. Path to a file at which the new timeseries CSV for the ScenarioReport will be saved.
       #
       # [*return:*] _URBANopt::Scenario::DefaultReports::ScenarioReport_ Returns an updated ScenarioReport
-      def run_scenario_report(scenario_report:, reopt_assumptions_hash: nil, reopt_output_file: nil, timeseries_csv_path: nil, save_name: nil, run_resilience: false, community_photovoltaic: nil)
+      def run_scenario_report(scenario_report:, reopt_assumptions_hash: nil, reopt_output_file: nil, timeseries_csv_path: nil, save_name: nil, run_resilience: false, community_photovoltaic: nil, erp_assumptions_file: nil)
         @save_assumptions_filepath = false
         if !reopt_assumptions_hash.nil?
           @scenario_reopt_default_assumptions_hash = reopt_assumptions_hash
@@ -145,26 +154,44 @@ module URBANopt # :nodoc:
         if !timeseries_csv_path.nil?
           @scenario_timeseries_default_output_file = timeseries_csv_path
         end
-
+        if !erp_assumptions_file.nil?
+          @erp_assumptions_file = erp_assumptions_file
+          File.open(erp_assumptions_file, 'r') do |file|
+            @scenario_erp_default_assumptions_hash = JSON.parse(file.read, symbolize_names: true)
+          end
+        end
         api = URBANopt::REopt::REoptLiteAPI.new(@nrel_developer_key, @localhost)
         adapter = URBANopt::REopt::ScenarioReportAdapter.new
 
         reopt_input = adapter.reopt_json_from_scenario_report(scenario_report, @scenario_reopt_default_assumptions_hash, community_photovoltaic)
+        
+        # Save inputs file (just in case)
+        # Get the directory of the output file
+        input_save_dir = File.dirname(@scenario_reopt_default_output_file)
+        input_save_path = File.join(input_save_dir, "reopt_input.json")
+        File.open(input_save_path, 'w') do |f|
+          f.write(JSON.pretty_generate(reopt_input))
+        end
+        @@logger.info("Saving REopt inputs to for inspection: #{input_save_path}.")
+
         reopt_output = api.reopt_request(reopt_input, @scenario_reopt_default_output_file)
+        reopt_output = api.reopt_request(reopt_input, @scenario_reopt_default_output_file)['data']
+    
+        run_uuid = reopt_output['run_uuid']
+        # if run resilience is set to true by user, then we will run the resilience request
 
         if run_resilience
-          run_uuid = reopt_output['outputs']['run_uuid']
+
           if File.directory? @scenario_reopt_default_output_file
-            resilience_stats = api.resilience_request(run_uuid, @scenario_reopt_default_output_file)
+            resilience_stats = api.resilience_request(run_uuid, @scenario_reopt_default_output_file, reopt_input, @scenario_erp_default_assumptions_hash)
           else
-            resilience_stats = api.resilience_request(run_uuid, @scenario_reopt_default_output_file.sub('.json', '_resilience.json'))
+            resilience_stats = api.resilience_request(run_uuid, @scenario_reopt_default_output_file.sub('.json', '_resilience.json'), reopt_input, @scenario_erp_default_assumptions_hash)
           end
         else
           resilience_stats = nil
         end
-
+        
         result = adapter.update_scenario_report(scenario_report, reopt_output, @scenario_timeseries_default_output_file, resilience_stats)
-        # can you save the assumptions file path that was used?
         if @save_assumptions_filepath && @scenario_reopt_assumptions_file
           result.distributed_generation.reopt_assumptions_file_path = @scenario_reopt_assumptions_file
         end
@@ -187,7 +214,7 @@ module URBANopt # :nodoc:
       # * +timeseries_csv_path+ - _Array_ - Optional. A array of paths to files at which the new timeseries CSV for the FeatureReports will be saved. The number and order of the paths should match the feature_reports array.
       #
       # [*return:*] _Array_ Returns an array of updated _URBANopt::Scenario::DefaultReports::FeatureReport_ objects
-      def run_feature_reports(feature_reports:, reopt_assumptions_hashes: [], reopt_output_files: [], timeseries_csv_paths: [], save_names: nil, run_resilience: false, keep_existing_output: false, groundmount_photovoltaic: nil)
+      def run_feature_reports(feature_reports:, reopt_assumptions_hashes: [], reopt_output_files: [], timeseries_csv_paths: [], save_names: nil, run_resilience: false, keep_existing_output: false, groundmount_photovoltaic: nil, erp_assumptions_file: nil)
         if !reopt_assumptions_hashes.empty?
           @feature_reports_reopt_default_assumption_hashes = reopt_assumptions_hashes
         end
@@ -211,6 +238,12 @@ module URBANopt # :nodoc:
             @feature_reports_timeseries_default_output_files << File.join(fr.directory_name, "feature_report_#{fr.id}_timeseries.csv")
           end
         end
+        if erp_assumptions_file && !erp_assumptions_file.empty?
+          @erp_assumptions_file = erp_assumptions_file
+          File.open(erp_assumptions_file, 'r') do |file|
+            @feature_erp_default_assumptions_hash = JSON.parse(file.read, symbolize_names: true)
+          end
+        end
 
         api = URBANopt::REopt::REoptLiteAPI.new(@nrel_developer_key, @localhost)
         feature_adapter = URBANopt::REopt::FeatureReportAdapter.new
@@ -220,13 +253,16 @@ module URBANopt # :nodoc:
           if !(keep_existing_output && output_exists(@feature_reports_reopt_default_output_files[idx]))
             begin
               reopt_input = feature_adapter.reopt_json_from_feature_report(feature_report, @feature_reports_reopt_default_assumption_hashes[idx], groundmount_photovoltaic)
+                            
               reopt_output = api.reopt_request(reopt_input, @feature_reports_reopt_default_output_files[idx])
+              reopt_output = reopt_output['data'] || reopt_output
+              
               if run_resilience
-                run_uuid = reopt_output['outputs']['run_uuid']
+                run_uuid = reopt_output['run_uuid']
                 if File.directory? @feature_reports_reopt_default_output_files[idx]
-                  resilience_stats = api.resilience_request(run_uuid, @feature_reports_reopt_default_output_files[idx])
+                  resilience_stats = api.resilience_request(run_uuid, @feature_reports_reopt_default_output_files[idx], reopt_input, @feature_erp_default_assumptions_hash)
                 else
-                  resilience_stats = api.resilience_request(run_uuid, @feature_reports_reopt_default_output_files[idx].sub('.json', '_resilience.json'))
+                  resilience_stats = api.resilience_request(run_uuid, @feature_reports_reopt_default_output_files[idx].sub('.json', '_resilience.json'), reopt_input, @feature_erp_default_assumptions_hash)
                 end
               else
                 resilience_stats = nil
@@ -281,8 +317,8 @@ module URBANopt # :nodoc:
       # * +feature_report_timeseries_csv_paths+ - _Array_ - Optional. An array of paths to files at which the new timeseries CSV for the FeatureReports will be saved. The number and order of the paths should match the array in ScenarioReport.feature_reports.
       #
       # [*return:*] _URBANopt::Scenario::DefaultReports::ScenarioReport_ - Returns an updated ScenarioReport
-      def run_scenario_report_features(scenario_report:, reopt_assumptions_hashes: [], reopt_output_files: [], feature_report_timeseries_csv_paths: [], save_names_feature_reports: nil, save_name_scenario_report: nil, run_resilience: false, keep_existing_output: false, groundmount_photovoltaic: nil)
-        new_feature_reports = run_feature_reports(feature_reports: scenario_report.feature_reports, reopt_assumptions_hashes: reopt_assumptions_hashes, reopt_output_files: reopt_output_files, timeseries_csv_paths: feature_report_timeseries_csv_paths, save_names: save_names_feature_reports, run_resilience: run_resilience, keep_existing_output: keep_existing_output, groundmount_photovoltaic: groundmount_photovoltaic)
+      def run_scenario_report_features(scenario_report:, reopt_assumptions_hashes: [], reopt_output_files: [], feature_report_timeseries_csv_paths: [], save_names_feature_reports: nil, save_name_scenario_report: nil, run_resilience: false, keep_existing_output: false, groundmount_photovoltaic: nil, erp_assumptions_file: nil)
+        new_feature_reports = run_feature_reports(feature_reports: scenario_report.feature_reports, reopt_assumptions_hashes: reopt_assumptions_hashes, reopt_output_files: reopt_output_files, timeseries_csv_paths: feature_report_timeseries_csv_paths, save_names: save_names_feature_reports, run_resilience: run_resilience, keep_existing_output: keep_existing_output, groundmount_photovoltaic: groundmount_photovoltaic, erp_assumptions_file: erp_assumptions_file)
 
         # only do this if you have run feature reports
         new_scenario_report = URBANopt::Reporting::DefaultReports::ScenarioReport.new

data/lib/urbanopt/reopt/reopt_schema/REopt-BAU-input.json

@@ -0,0 +1,174 @@
+{
+  "title": "REopt GHP BAU Inputs (Minimal Valid Schema Wrapper)",
+  "type": "object",
+  "properties": {
+    "Site": {
+      "type": "object",
+      "properties": {
+        "latitude": {
+          "type": "number",
+          "minimum": -90,
+          "maximum": 90,
+          "description": "The approximate latitude of the site in decimal degrees."
+        },
+        "longitude": {
+          "type": "number",
+          "minimum": -180,
+          "maximum": 180,
+          "description": "The approximate longitude of the site in decimal degrees."
+        }
+      },
+      "required": ["latitude", "longitude"]
+    },
+
+    "SpaceHeatingLoad": {
+      "type": "object",
+      "properties": {
+        "fuel_loads_mmbtu_per_hour": {
+          "type": "array",
+          "description": "This is the fuel energy consumption for space heating at the individual building level. This is used in the business as usual (BAU) LCCA analysis in the GHP module to calculate BAU bills. These are 8760 hourly timeseries values.",
+          "note": "This parameter is required to run REopt's BAU for GHP module. If there is no fuel based heating in BAU, add values close to 0."
+        }
+      },
+      "required": ["fuel_loads_mmbtu_per_hour"]
+    },
+
+    "DomesticHotWaterLoad": {
+      "type": "object",
+      "properties": {
+        "fuel_loads_mmbtu_per_hour": {
+          "type": "array",
+          "description": "This is the fuel enegry consumption for providing domestic hot water at the individual building level. This is used in the business as usual (BAU) LCCA analysis in the GHP module. These are 8760 hourly timeseries values.",
+          "note": "Only required if BAU system has DHW load and uses fuel for this load. If BAU system has no DHW load, or does not use fuel for DHW heating, set to values close to zeros. If BAU system uses electricity for DHW, please add this electric DHW load to ElectricLoad"
+        }
+      }
+    },
+
+    "CoolingLoad": {
+      "type": "object",
+      "properties": {
+        "fuel_loads_mmbtu_per_hour": {
+          "type": "array",
+          "description": "This is the fuel energy consumption for space cooling at the individual building level. This is used in the business as usual (BAU) LCCA analysis in the GHP module to calculate BAU bills. These are 8760 hourly timeseries values.",
+          "note": "Only required if BAU system uses fuel for cooling. If BAU system uses electricity for cooling (AC), please add this load to ElectricLoad defined below. If BAU system has no cooling load, set to values close to zeros."
+        }
+      },
+      "required": ["fuel_loads_mmbtu_per_hour"]
+    },
+
+    "ElectricLoad": {
+      "type": "object",
+      "properties": {
+        "loads_kw": {
+          "type": "array",
+          "description": "8760 timeseries",
+          "note": "This is the electric load profile for heating and cooling in the BAU scenario (kW). It is an hourly timeseries load profile with 8760 values. If there is no electricity based heating or cooling in BAU, set these values close to 0."
+        }
+      },
+      "required": ["loads_kw"]
+    },
+
+    "ElectricTarriff": {
+      "type": "object",
+      "description": "Label attribute of utility rate structure from https://openei.org/services/doc/rest/util_rates/?version=3.",
+      "properties": {
+        "urdb_label": { "type": "string" }
+      },
+      "required": ["urdb_label"]
+    },
+
+    "ExistingBoiler": {
+      "type": "object",
+      "properties": {
+        "fuel_cost_per_mmbtu": {
+          "type": "number",
+          "description": "Only required if BAU system use fuel for heating. In this case, fuel cost needs to be specified"
+        },
+        "installed_cost_per_mmbtu_per_hour": {
+          "type": "number",
+          "description": "Capital cost of ExistingBoiler. Include if counting the capital cost of upgrading ExistingBoiler in the BAU system in NPV calculation. Default is $56,000/MMBtu (EIA). The peak heating load is considered to be the size of the system and is multiplied by this field to get total capital cost. Note: this option can only be called from the API after July 2, 2025"
+        }
+      }
+    },
+
+    "ElectricHeater": {
+      "type": "object",
+      "properties": {
+        "installed_cost_per_mmbtu_per_hour": {
+          "type": "number",
+          "description": "Capital cost of ElectricHeater/Electric furnace. Include if BAU system use electric heater/electric furnace for heating and if counting capital cost of upgrading electric heater/furnace in the BAU system in NPV calculation. Default value is $59,412/MMBtu (EIA)"
+        },
+        "min_mmbtu_per_hour": {
+          "type": "number",
+          "description": "User defined input for the size of electric heater system. This value should be the same in min_mmbtu_per_hour and max_mmbtu_per_hour."
+        },
+        "max_mmbtu_per_hour": {
+          "type": "number",
+          "description": "User defined input for the size of electric heater system. This value should be the same in min_mmbtu_per_hour and max_mmbtu_per_hour."
+        },
+        "can_serve_space_heating": {
+          "type": "boolean",
+          "description": "true if electric heater can serve space heating load in the BAU system"
+        },
+        "can_serve_dhw": {
+          "type": "boolean",
+          "description": "true if electric heater can serve water heating load in the BAU system"
+        }
+      }
+    },
+
+    "Financial": {
+      "type": "object",
+      "properties": {
+        "elec_cost_escalation_rate_fraction": {
+          "default": 0.026,
+          "minimum": -1,
+          "maximum": 1,
+          "type": "number",
+          "description": "Annual nominal utility electricity cost escalation rate",
+          "required": false
+        },
+        "owner_discount_rate_fraction": {
+          "default": 0.081,
+          "minimum": 0,
+          "maximum": 1,
+          "type": "number",
+          "description": "Nominal host discount rate. This is used when host site owns the investment",
+          "required": false
+        },
+        "offtaker_discount_rate_fraction": {
+          "default": 0.081,
+          "minimum": 0,
+          "maximum": 1,
+          "type": "number",
+          "description": "Nominal discount rate. This is used when site finances the investment through a third party",
+          "required": false
+        },
+        "owner_tax_rate_fraction": {
+          "default": 0.26,
+          "minimum": 0,
+          "maximum": 1,
+          "type": "number",
+          "description": "Tax rate site when host site owns the investment",
+          "required": false
+        },
+        "offtaker_tax_rate_fraction": {
+          "default": 0.26,
+          "minimum": 0,
+          "maximum": 1,
+          "type": "number",
+          "description": "Tax rate when site finances the investment through a third party",
+          "required": false
+        },
+        "om_cost_escalation_rate_fraction": {
+          "default": 0.025,
+          "minimum": -1,
+          "maximum": 1,
+          "type": "number",
+          "description": "Annual nominal O&M cost escalation rate",
+          "required": false
+        }
+      }
+    }
+  }
+}