urbanopt-reopt 0.12.0 → 1.1.0

data/lib/urbanopt/reopt/reopt_ghp_api.rb

@@ -0,0 +1,156 @@
+# *********************************************************************************
+# URBANopt (tm), Copyright (c) Alliance for Sustainable Energy, LLC.
+# See also https://github.com/urbanopt/urbanopt-reopt-gem/blob/develop/LICENSE.md
+# *********************************************************************************
+
+require 'net/https'
+require 'openssl'
+require 'uri'
+require 'json'
+require 'securerandom'
+require_relative '../../../developer_nrel_key'
+require 'urbanopt/reopt/reopt_logger'
+
+module URBANopt # :nodoc:
+  module REopt  # :nodoc:
+    class REoptLiteGHPAPI
+
+        def initialize(reopt_input_file, nrel_developer_key = nil, reopt_output_file, use_localhost)
+
+            # Store developer key
+            if [nil, '', '<insert your key here>'].include? nrel_developer_key
+                if [nil, '', '<insert your key here>'].include? DEVELOPER_NREL_KEY
+                    raise 'A developer.nrel.gov API key is required. Please see https://developer.nrel.gov/signup/ then update the file urbanopt-reopt-gem/developer_nrel_key.rb'
+                else
+                    #Store the NREL developer key
+                    nrel_developer_key = DEVELOPER_NREL_KEY
+                end
+            end
+
+            @use_localhost = use_localhost
+            if @use_localhost
+                @root_url = "http://localhost:8000/v3"
+            else
+                @root_url = "https://developer.nrel.gov/api/reopt/v3"
+            end
+            # add REopt URL
+            @nrel_developer_key = nrel_developer_key
+            @reopt_input_file = reopt_input_file
+            @reopt_output_file = reopt_output_file
+            # initialize @@logger
+            @@logger ||= URBANopt::REopt.reopt_logger
+            @@logger.level = Logger::INFO
+        end
+
+
+        def get_api_results(run_id=nil)
+
+            reopt_input_file = @reopt_input_file
+            nrel_developer_key = @nrel_developer_key
+            root_url = @root_url
+            reopt_output_file = @reopt_output_file
+
+            if run_id.nil?
+                run_id = get_run_uuid(reopt_input_file, nrel_developer_key, reopt_output_file)
+            end
+            if !run_id.nil?
+                results_url = "#{@root_url}/job/#{run_id}/results/?api_key=#{nrel_developer_key}"
+                puts "This is results URL #{results_url}"
+                results = reopt_request(results_url)
+
+                File.open(reopt_output_file, 'w') do |f|
+                    f.write(JSON.pretty_generate(results))
+                    @@logger.info("Saved results to #{reopt_output_file}")
+                end
+            else
+                results = nil
+                @@logger.error("Unable to get results: no UUID returned.")
+            end
+            results
+        end
+
+        def get_run_uuid(reopt_input_file, nrel_developer_key, root_url)
+
+            reopt_input_file = @reopt_input_file
+            nrel_developer_key = @nrel_developer_key
+            root_url = @root_url
+            post_url = "#{root_url}/job/?api_key=#{nrel_developer_key}"
+            puts "This is URL: #{post_url}"
+            @@logger.info("Connecting to #{post_url}")
+
+            # Parse the URL and prepare the HTTP request
+            uri = URI.parse(post_url)
+            request = Net::HTTP::Post.new(uri)
+            request.content_type = 'application/json'
+
+            # Add the JSON payload (assuming 'post' is the body data)
+            request.body = reopt_input_file.to_json
+
+            # Send the HTTP request
+            response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
+                http.request(request)
+            end
+
+            run_id = nil
+
+            if !response.is_a?(Net::HTTPSuccess)
+                @@logger.error("Status code #{response.code}. #{response.body}")
+                @@logger.error("Status code #{response.code}")
+            else
+                @@logger.info("Response OK from #{post_url}.")
+                run_id_dict = JSON.parse(response.body)
+
+                begin
+                    run_id = run_id_dict['run_uuid']
+                rescue KeyError
+                    msg = "Response from #{post_url} did not contain run_uuid."
+                    @@logger.error(msg)
+                end
+            end
+            # Return run_id
+            run_id
+        end
+
+        def reopt_request(results_url, poll_interval = 5, max_timeout = 300)
+
+            key_error_count = 0
+            key_error_threshold = 3
+            status = "Optimizing..."
+            @@logger.info("Polling #{results_url} for results with interval of #{poll_interval}...")
+            resp_dict = {}
+            start_time = Time.now
+
+            loop do
+                uri = URI.parse(results_url)
+                response = Net::HTTP.get_response(uri)
+                resp_dict = JSON.parse(response.body)
+
+                begin
+                  status = resp_dict['status']
+                rescue KeyError
+                  key_error_count += 1
+                  @@logger.info("KeyError count: #{key_error_count}")
+                  if key_error_count > key_error_threshold
+                    @@logger.info("Breaking polling loop due to KeyError count threshold of #{key_error_threshold} exceeded.")
+                    break
+                  end
+                end
+
+                if status != "Optimizing..."
+                    break
+                end
+
+                if Time.now - start_time > max_timeout
+                    @@logger.info("Breaking polling loop due to max timeout of #{max_timeout} seconds exceeded.")
+                    break
+                end
+
+                sleep(poll_interval)
+
+            end
+            resp_dict
+        end
+
+    end
+  end
+end

data/lib/urbanopt/reopt/reopt_ghp_files/reopt_ghp_assumption.json

@@ -0,0 +1,27 @@
+{
+    "Site": {
+        "latitude": 42.81428490645775,
+        "longitude": -78.84701778930912
+    },
+    "SpaceHeatingLoad": {
+    },
+    "DomesticHotWaterLoad": {
+    },
+    "ElectricLoad": {
+        "year": 2017
+    },
+    "ElectricTariff": {
+        "urdb_label": "594976725457a37b1175d089"
+    },
+    "GHP":{
+        "installed_cost_heatpump_per_ton": 1075,
+        "installed_cost_ghx_per_ft": 14,
+        "installed_cost_building_hydronic_loop_per_sqft": 1.7,
+        "om_cost_per_sqft_year": 0,
+        "macrs_bonus_fraction": 0.6,
+        "macrs_itc_reduction": 0.5,
+        "federal_itc_fraction": 0.3
+    },
+    "ExistingBoiler": {
+    }
+}

data/lib/urbanopt/reopt/reopt_ghp_post_processor.rb

@@ -0,0 +1,149 @@
+# *********************************************************************************
+# URBANopt (tm), Copyright (c) Alliance for Sustainable Energy, LLC.
+# See also https://github.com/urbanopt/urbanopt-reopt-gem/blob/develop/LICENSE.md
+# *********************************************************************************
+
+require 'bundler/setup'
+require 'urbanopt/reopt/reopt_logger'
+require 'urbanopt/reopt/reopt_ghp_api'
+require 'csv'
+require 'json'
+require 'fileutils'
+
+module URBANopt # :nodoc:
+  module REopt # :nodoc:
+    class REoptGHPPostProcessor
+      def initialize(run_dir, system_parameter, modelica_result, reopt_ghp_assumptions = nil, nrel_developer_key = nil, localhost)
+        # initialize @@logger
+        @@logger ||= URBANopt::REopt.reopt_logger
+
+        @nrel_developer_key = nrel_developer_key
+        @localhost = localhost
+        @reopt_ghp_output_district = nil
+        @reopt_ghp_output_building = []
+        @reopt_ghp_assumptions_hash = nil
+        @reopt_ghp_assumptions = nil
+        @system_parameter = nil
+        @system_parameter_hash = nil
+        @modelica_result = nil
+        @building_ids = nil
+        @run_dir = run_dir
+
+        if !reopt_ghp_assumptions.nil?
+          @reopt_ghp_assumptions = reopt_ghp_assumptions
+          File.open(reopt_ghp_assumptions, 'r') do |file|
+            @reopt_ghp_assumptions_input_hash = JSON.parse(file.read, symbolize_names: true)
+          end
+        end
+
+        if !system_parameter.nil?
+          @system_parameter = system_parameter
+          File.open(system_parameter, 'r') do |file|
+            @system_parameter_input_hash = JSON.parse(file.read, symbolize_names: true)
+          end
+          # Determine loop order
+          loop_order = File.join(File.dirname(system_parameter), '_loop_order.json')
+          if File.exist?(loop_order)
+            File.open(loop_order, 'r') do |file|
+              loop_order_input = JSON.parse(file.read, symbolize_names: true)
+              # Check the type of the parsed data
+              if loop_order_input.is_a?(Array)
+                @loop_order_input_hash = loop_order_input
+                @loop_order_input_hash.each do |item|
+                  puts "Building IDs in group: #{item[:list_bldg_ids_in_group].inspect}"
+                  puts "GHE IDs in group: #{item[:list_ghe_ids_in_group].inspect}"
+                end
+              elsif loop_order_input.is_a?(Hash)
+                @loop_order_input_hash = [loop_order_input] # Wrap in array if a single object
+                @loop_order_input_hash.each do |item|
+                  puts "Building IDs in group: #{item[:list_bldg_ids_in_group].inspect}"
+                  puts "GHE IDs in group: #{item[:list_ghe_ids_in_group].inspect}"
+                end
+              else
+                puts 'Unexpected JSON structure'
+              end
+            end
+          end
+
+        end
+
+        if !modelica_result.nil?
+          @modelica_result_input = modelica_result
+        end
+      end
+
+      attr_accessor :run_dir, :system_parameter_input_hash, :reopt_ghp_assumptions_input_hash, :loop_order_input_hash, :modelica_result_input
+
+      # # Create REopt input and output building report
+      def run_reopt_lcca(system_parameter_hash: nil, reopt_ghp_assumptions_hash: nil, modelica_result: nil)
+        adapter = URBANopt::REopt::REoptGHPAdapter.new
+
+        # if these arguments are specified, use them
+        if !system_parameter_hash.nil?
+          @system_parameter_input_hash = system_parameter_hash
+        end
+
+        if !reopt_ghp_assumptions_hash.nil?
+          @reopt_ghp_assumptions_input_hash = reopt_ghp_assumptions_hash
+        end
+
+        if !modelica_result.nil?
+          @modelica_result_input = modelica_result
+        end
+
+        # Create folder for REopt input files only if they dont exist
+        reopt_ghp_dir = File.join(@run_dir, 'reopt_ghp')
+        reopt_ghp_input = File.join(reopt_ghp_dir, 'reopt_ghp_inputs')
+        unless Dir.exist?(reopt_ghp_dir)
+          FileUtils.mkdir_p(reopt_ghp_dir)
+        end
+        unless Dir.exist?(reopt_ghp_input)
+          FileUtils.mkdir_p(reopt_ghp_input)
+        end
+
+        reopt_ghp_output = File.join(reopt_ghp_dir, 'reopt_ghp_outputs')
+        unless Dir.exist?(reopt_ghp_output)
+          FileUtils.mkdir_p(reopt_ghp_output)
+        end
+
+        # get building IDs from _loop_order.json
+        building_ids = []
+        ghp_ids = []
+        @loop_order_input_hash.each do |loop|
+          building_ids.concat(loop[:list_bldg_ids_in_group].flatten)
+          ghp_ids.concat(loop[:list_ghe_ids_in_group].flatten)
+        end
+
+        building_ids.each do |building_id|
+          # create REopt building input file for all buildings in loop order list
+          reopt_input_building = adapter.create_reopt_input_building(@run_dir, @system_parameter_input_hash, @reopt_ghp_assumptions_input_hash, building_id, @modelica_result_input)
+        end
+        ghp_ids.each do |ghp_id|
+          # create REopt district input file
+          reopt_input_district = adapter.create_reopt_input_district(@run_dir, @system_parameter_input_hash, @reopt_ghp_assumptions_input_hash, ghp_id, @modelica_result_input)
+        end
+
+        Dir.foreach(reopt_ghp_input) do |input_file|
+          # Skip '.' and '..' (current and parent directory entries)
+          next if input_file == '.' || input_file == '..'
+
+          reopt_ghp_input_file_path = File.join(reopt_ghp_input, input_file)
+
+          reopt_input_data = nil
+
+          File.open(reopt_ghp_input_file_path, 'r') do |f|
+            reopt_input_data = JSON.parse(f.read)
+          end
+
+          base_name = File.basename(input_file, '.json')
+
+          # reopt_ghp_output_file
+          reopt_output_file = File.join(reopt_ghp_output, "#{base_name}_output.json")
+          # call the REopt API
+          api = URBANopt::REopt::REoptLiteGHPAPI.new(reopt_input_data, DEVELOPER_NREL_KEY, reopt_output_file, @localhost)
+          api.get_api_results
+        end
+      end
+    end # REoptGHPPostProcessor
+  end # REopt
+end # URBANopt

data/lib/urbanopt/reopt/reopt_lite_api.rb

@@ -8,7 +8,6 @@ require 'openssl'
 require 'uri'
 require 'json'
 require 'securerandom'
-require 'certified'
 require_relative '../../../developer_nrel_key'
 require 'urbanopt/reopt/reopt_logger'
 
@@ -16,7 +15,7 @@ module URBANopt # :nodoc:
   module REopt  # :nodoc:
     class REoptLiteAPI
       ##
-      # \REoptLiteAPI manages submitting optimization tasks to the \REopt API  and recieving results.
+      # \REoptLiteAPI manages submitting optimization tasks to the \REopt API  and receiving results.
       # Results can either be sourced from the production \REopt API with an API key from developer.nrel.gov, or from
       # a version running at localhost.
       ##
@@ -55,7 +54,7 @@ module URBANopt # :nodoc:
       #
       # * +run_uuid+ - _String_ - Unique run_uuid obtained from the \REopt job submittal URL for a specific optimization task.
       #
-      # [*return:*] _URI_ - Returns URI object for use in calling the \REopt results endpoint for a specifc optimization task.
+      # [*return:*] _URI_ - Returns URI object for use in calling the \REopt results endpoint for a specific optimization task.
       ##
       def uri_results(run_uuid) # :nodoc:
         if @use_localhost
@@ -73,7 +72,7 @@ module URBANopt # :nodoc:
       #
       # * +run_uuid+ - _String_ - Resilience statistics for a unique run_uuid obtained from the \REopt job submittal URL for a specific optimization task.
       #
-      # [*return:*] _URI_ - Returns URI object for use in calling the \REopt resilience statistics endpoint for a specifc optimization task.
+      # [*return:*] _URI_ - Returns URI object for use in calling the \REopt resilience statistics endpoint for a specific optimization task.
       ##
       def uri_resilience(run_uuid) # :nodoc:
         if @use_localhost
@@ -112,11 +111,11 @@ module URBANopt # :nodoc:
             end
             tries = max_tries
           rescue StandardError => e
-            @@logger.debug("error from REopt API: #{e}")
+            @@logger.error("error from REopt API: #{e}")
             if tries + 1 < max_tries
               @@logger.debug('trying again...')
             else
-              @@logger.debug('max tries reached!')
+              @@logger.warn('max tries reached!')
               return result
             end
             tries += 1
@@ -133,7 +132,7 @@ module URBANopt # :nodoc:
       #
       # * +data+ - _Hash_ - Default \REopt formatted post containing at least all the required parameters.
       #
-      # [*return:*] _Bool_ - Returns true if the post succeeeds. Otherwise returns false.
+      # [*return:*] _Bool_ - Returns true if the post succeeds. Otherwise returns false.
       ##
       def check_connection(data)
         header = { 'Content-Type' => 'application/json' }
@@ -166,7 +165,7 @@ module URBANopt # :nodoc:
       # * +reopt_input+ - _Hash_ - \REopt formatted post containing at least required parameters.
       # * +filename+ - _String_ - Path to file that will be created containing the full \REopt response.
       #
-      # [*return:*] _Bool_ - Returns true if the post succeeeds. Otherwise returns false.
+      # [*return:*] _Bool_ - Returns true if the post succeeds. Otherwise returns false.
       ##
       def resilience_request(run_uuid, filename)
         if File.directory? filename
@@ -246,7 +245,7 @@ module URBANopt # :nodoc:
       # * +reopt_input+ - _Hash_ - \REopt formatted post containing at least required parameters.
       # * +filename+ - _String_ - Path to file that will be created containing the full \REopt response.
       #
-      # [*return:*] _Bool_ - Returns true if the post succeeeds. Otherwise returns false.
+      # [*return:*] _Bool_ - Returns true if the post succeeds. Otherwise returns false.
       ##
       def reopt_request(reopt_input, filename)
         description = reopt_input[:description]

data/lib/urbanopt/reopt/reopt_logger.rb

@@ -12,7 +12,7 @@ module URBANopt
     # Set Logger::DEBUG for development
     @@reopt_logger.level = Logger::WARN
     ##
-    # Definining class variable "@@logger" to log errors, info and warning messages.
+    # Defining class variable "@@logger" to log errors, info and warning messages.
     def self.reopt_logger
       @@reopt_logger
     end

data/lib/urbanopt/reopt/reopt_post_processor.rb

@@ -33,7 +33,6 @@ module URBANopt # :nodoc:
         end
         @nrel_developer_key = nrel_developer_key
         @localhost = localhost
-        @reopt_base_post = { ElectricTariff: {}, ElectricLoad: {}, Wind: { max_kw: 0 } }
 
         @scenario_reopt_default_output_file = nil
         @scenario_timeseries_default_output_file = nil
@@ -182,7 +181,7 @@ module URBANopt # :nodoc:
       #
       # [*parameters:*]
       #
-      # * +feature_reports+ - _Array_ -  An array of _URBANopt::Reporting::DefaultReports::FeatureReport_ objetcs which will each be used to create (and are subsquently updated by) a \REopt opimization response.
+      # * +feature_reports+ - _Array_ -  An array of _URBANopt::Reporting::DefaultReports::FeatureReport_ objects which will each be used to create (and are subsequently updated by) a \REopt opimization response.
       # * +reopt_assumptions_hashes+ - _Array_ - Optional. An array of \REopt formatted hashes containing default parameters (i.e. utility rate, escalation rate) which will be updated by the ScenarioReport (i.e. location, roof availability). The number and order of the hashes should match the feature_reports array.
       # * +reopt_output_files+ - _Array_ - Optional. A array of paths to files at which REpopt responses will be saved. The number and order of the paths should match the feature_reports array.
       # * +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.
@@ -276,7 +275,7 @@ module URBANopt # :nodoc:
       #
       # [*parameters:*]
       #
-      # * +scenario_report+ - _Array_ -  A _URBANopt::Reporting::DefaultReports::ScenarioReport_ which will each be used to create (and is subsquently updated by) \REopt opimization responses for each of its FeatureReports.
+      # * +scenario_report+ - _Array_ -  A _URBANopt::Reporting::DefaultReports::ScenarioReport_ which will each be used to create (and is subsequently updated by) \REopt opimization responses for each of its FeatureReports.
       # * +reopt_assumptions_hashes+ - _Array_ - Optional. An array of \REopt formatted hashes containing default parameters (i.e. utility rate, escalation rate) which will be updated by the ScenarioReport (i.e. location, roof availability). The number and order of the hashes should match the array in ScenarioReport.feature_reports.
       # * +reopt_output_files+ - _Array_ - Optional. An array of paths to files at which REpopt responses will be saved. The number and order of the paths should match the array in ScenarioReport.feature_reports.
       # * +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.

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

@@ -0,0 +1,148 @@
+{
+    "Site": {
+        "latitude": {
+            "type": "float",
+            "required": true
+        },
+        "longitude": {
+            "type": "float",
+            "required": true
+        }
+    },
+    "SpaceHeatingLoad": {
+        "fuel_loads_mmbtu_per_hour": {
+            "type": "array",
+            "required": true,
+            "description": "8760 timeseries",
+            "note": "This parameter is required to run REopt's GHP module but is not used to calculate URBANopt's GHP system LCCA. Users can set this to small numbers in GHP scenario"
+        }
+    },
+    "DomesticHotWaterLoad": {
+        "fuel_loads_mmbtu_per_hour": {
+            "type": "array",
+            "required": true,
+            "description": "8760 timeseries, if GHP not providing DHW set to zeros"
+        }
+    },
+    "ElectricLoad": {
+        "load_kw": {
+            "type": "array",
+            "required": true,
+            "description": "8760 timeseries",
+            "note": "15 min interval data do not work in GHP module. Please make sure all timeseries are 8760"
+        }
+    },
+    "ElectricTarriff": {
+        "urdb_label": "string",
+        "required": true
+    },
+    "GHP": {
+        "require_ghp_purchase": {
+            "type": "boolean",
+            "required": true,
+            "description": "choices of 0 or 1. Always set at 1 for URBANopt's LCCA"
+        },
+        "building_sqft": {
+            "type": "float",
+            "required": true,
+            "description": "to calculate cost of hydronic loop",
+            "note": "for the GHX iteration, set building_sqft to a number close to 0 but not exactly 0"
+        },
+        "heatpump_capacity_sizing_factor_on_peak_load": {
+            "type": "float",
+            "required": true,
+            "description": "always set to 1"
+        },
+        "ghpghx_responses":{
+            "outputs": {
+                "heat_pump_configuration": {
+                    "type": "string",
+                    "required": true,
+                    "description": "set as WSHP"
+                },
+                "peak_combined_heatpump_thermal_ton": {
+                    "type": "float",
+                    "required": true,
+                    "description": "size of GHP in ton",
+                    "note": "in the GHX iteration, set this value to a number close to 0 but NOT exactly 0S"
+                },
+                "number_of_boreholes": {
+                    "type": "int",
+                    "required": true,
+                    "note": "in the GHP iteration, set this value to 0"
+                },
+                "length_boreholes_ft": {
+                    "type": "float",
+                    "required": true,
+                    "note": "in the GHP iteration, set this value to 0"
+                },
+                "yearly_total_electric_consumption_series_kw": {
+                    "type": "array",
+                    "required": true,
+                    "description": "8760 timeseries of building total electric consumption",
+                    "note": "in the GHX iteration, set this value to a number close to 0 but not exactly 0"
+                },
+                "yearly_ghx_pump_electric_consumption_series_kw": {
+                    "type": "array",
+                    "required": true,
+                    "description": "8760 timeseries of ghx's total electric consumption",
+                    "note": "in the GHP iteration, set this value to 0"
+                }
+            },
+            "inputs": {
+                "heating_thermal_load_mmbtu_per_hr": {
+                    "type": "array",
+                    "required": true,
+                    "description": "not used for URBANopt's GHP LCCA but required for formatting, set to number close to 0"
+                },
+                "cooling_thermal_load_ton": {
+                    "type": "array",
+                    "required": true,
+                    "description": "not used for URBANopt's GHP LCCA but required for formatting, can set as zeros"
+                }
+            }
+        },
+        "installed_cost_heatpump_per_ton": {
+            "type": "float",
+            "required": false,
+            "description": "installation cost per unit (ton) of GHP"
+        },
+        "installed_cost_ghx_per_ft": {
+            "type": "float",
+            "required": false,
+            "description": "installation cost per unit (ft) of GHX"
+        },
+        "installed_cost_building_hydronic_loop_per_sqft": {
+            "type": "float",
+            "required": false,
+            "description": "installation cost per sqft of building hydronic loop"
+        },
+        "om_cost_per_sqft_year": {
+            "type": "float",
+            "required": false,
+            "description": "if not specified, the value is -$0.51, capturing saving from HVAC operation. Recommended setting at 0"
+        },
+        "macrs_bonus_fraction": {
+            "type": "float",
+            "required": false,
+            "description": "Percentage of macrs benefits for GHP. Value between 0 and 1"
+        },
+        "macrs_itc_reduction": {
+            "type": "float",
+            "required": false,
+            "description": "Percentage of macrs benefits for GHP. Value between 0 and 1"
+        },
+        "federal_itc_fraction": {
+            "type": "float",
+            "required": false,
+            "description": "Percentage of ITC benefits for GHP. Value between 0 and 1"
+        }
+    },
+    "ExistingBoiler": {
+        "fuel_cost_per_mmbtu": {
+            "type": "float",
+            "required": true,
+            "description": "to calculate BAU cost, and required for formatting in GHP scenario"
+        }
+    }
+}

data/lib/urbanopt/reopt/reopt_schema/reopt_input_schema.json

@@ -101,7 +101,7 @@
 					"min": 0,
 					"max": 1000000.0,
 					"type": "number",
-					"description": "Value placed on unmet site load during grid outages. Units are US dollars per unmet kilowatt-hour. The value of lost load (VoLL) is used to determine the avoided outage costs by multiplying VoLL [$/kWh] with the average number of hours that the critical load can be met by the energy system (determined by simulating outages occuring at every hour of the year), and multiplying by the mean critical load."
+					"description": "Value placed on unmet site load during grid outages. Units are US dollars per unmet kilowatt-hour. The value of lost load (VoLL) is used to determine the avoided outage costs by multiplying VoLL [$/kWh] with the average number of hours that the critical load can be met by the energy system (determined by simulating outages occurring at every hour of the year), and multiplying by the mean critical load."
 				},
 				"analysis_years": {
 					"default": 20,
@@ -711,7 +711,7 @@
 					"min": 0,
 					"max": 1,
 					"type": "number",
-					"description": "Fraction of upfront project costs to depreciate under MACRS in year one in addtion to scheduled depreciation"
+					"description": "Fraction of upfront project costs to depreciate under MACRS in year one in addition to scheduled depreciation"
 				},
 				"inverter_replacement_year": {
 					"default": 10,

data/lib/urbanopt/reopt/reopt_schema/reopt_output_schema.json

@@ -103,6 +103,46 @@
               }
             }
           },
+          "Financial_GHP": {
+            "type": "object",
+            "properties": {
+              "lcc": {
+                "type": "number",
+                "description": "Optimal lifecycle cost for GHP",
+                "units": "dollars"
+              },
+              "net_present_cost": {
+                "type": "number",
+                "description": "",
+                "units": "dollars"
+              },
+              "lifecycle_om_costs_before_tax_bau": {
+                "type": "number",
+                "description": "",
+                "units": "dollars"
+              },
+              "lifecycle_om_costs_after_tax": {
+                "type": "number",
+                "description": "",
+                "units": "$"
+              },
+              "year_one_om_costs_before_tax": {
+                "type": "number",
+                "description": "",
+                "units": "$"
+              },
+              "lifecycle_generation_tech_capital_costs": {
+                "type": "number",
+                "description": "",
+                "units": "$"
+              },
+              "lifecycle_offgrid_other_annual_costs_after_tax": {
+                "type": "number",
+                "description": "",
+                "units": "$"
+              }
+            }
+          },
           "PV": {
             "type": "object",
             "properties": {