urbanopt-reopt 0.3.0.pre1 → 0.5.4

data/lib/urbanopt/reopt/utilities.rb

@@ -0,0 +1,107 @@
+def convert_powerflow_resolution(timeseries_kw, original_res, destination_res)	
+	if timeseries_kw.length == 0
+		return nil
+	end
+	
+	if original_res > destination_res
+		# Timesteps will be reduced, i.e. 35040 -> 8760
+		
+    	# This algorithm works by stepping along the origin timeseries at an interval equal to
+    	# one timestep in the destintion timeseries and then averaging all origin values that
+    	# coincide with the interval. Averages are weighted if a destination timestep
+    	# only partaially overlaps an origin timestep.
+    	
+    	# EX 1
+    	# stepping interval 2
+    	# origin stepping       | 1 | 2 | 2 | 4 |
+    	# destination stepping  |  1.5  |   3   |
+
+    	# EX 2
+    	# stepping interval 2.5
+    	# origin stepping       | 1 | 1 | 4 | 2 | 2 |
+    	# destination stepping  |   1.6   |  2.4    |
+    	
+    	result = []
+    	stepping_interval = Float(original_res) / Float(destination_res)
+    	current_origin_ts = 0 # fraction stepped along the origin time series
+		current_origin_idx = 0 # current integer index of the origin timeseries
+		(0..(8760*destination_res-1)).each do |ts|
+			next_stopping_ts = current_origin_ts + stepping_interval #stop at the next destination interval
+			total_power = [] #create to store wieghted origin timestep values to average
+			while current_origin_ts != next_stopping_ts do
+				next_origin_ts_int = Integer(current_origin_ts) + 1
+				# Calc next stopping point that will being you to the next origin or destination time step
+				next_origin_ts = [next_origin_ts_int, next_stopping_ts].min 
+				# Calc next step length
+				delta_to_next_origin_ts = next_origin_ts - current_origin_ts 
+				# Add the proportional origin timestep value to the total power variable
+				total_power.push(Float(timeseries_kw[current_origin_idx]) *  delta_to_next_origin_ts)
+				# Only move on to the next origin timestep if you are not ending mid way though an origin timestep
+				# i.e  in EX 2 above, the value 4 is needed in destination timestep 1 and 2 
+				if next_origin_ts_int <= next_stopping_ts
+					current_origin_idx += 1
+				end
+				# Step to the next stopping point
+				current_origin_ts += delta_to_next_origin_ts
+			end
+			# Add averaged total power variable for the destination time step
+			result.push(Float(total_power.sum) / stepping_interval)
+		end
+    end
+    if destination_res > original_res
+		#Timesteps will be expanded, i.e. 8760 -> 35040
+
+		# This algorithm works by stepping along the destination timeseries. Steps are made to the next 
+		# destination or origin breakpoint, and at each step the propotional amount of the origin stepped
+		# is added to the destination. For example, in in EX 1 below 4 steps are made each with adding the full amount of
+		# the origin (1, 1, 2 and 2) since each in the destination overlaps perfectly with 2 origin
+		# timesteps. In EX 2, the origin overlaps with the first 2 destination timesteps but the third
+		# destination value much be compose of half the 1st origin timestep value and half the second
+		# (i.e  4, 4, (4 * 1/2) + (3 * 1/2), 3, and 3 are added to the destination). 
+    	
+    	# EX 1
+    	# stepping interval 2
+    	# origin stepping       |   1   |   2   |
+    	# destination stepping  | 1 | 1 | 2 | 2 |
+
+    	# EX 2
+    	# stepping interval 2.5
+    	# origin stepping       |     4    |    3     |
+    	# destination stepping  | 4 | 4 | 3.5 | 3 | 3 |
+	
+		result = []
+		stepping_interval = (Float(destination_res) / Float(original_res))
+		current_destination_ts = 0 # fraction stepped along the origin time series
+		(0..(8760*original_res-1)).each do |original_ts|
+			# keep track of step length along the destination time series
+			original_indices_stepped = 0
+			# See if you are start in the middle of a destination time step and add the proportional
+			# value to the most recent (and incomplete) destination value
+			remainder = (current_destination_ts - Integer(current_destination_ts))
+			if remainder > 0
+				current_destination_ts += (1 - remainder)
+				original_indices_stepped += (1 - remainder)
+				result[-1] = result[-1] + (Float(timeseries_kw[original_ts])*(1-remainder))
+			end
+			# Make whole steps along the destination timeseries that overlap perfectly with the 
+			# origin timeseries
+			while (original_indices_stepped < stepping_interval) and ((original_indices_stepped + 1) <= stepping_interval)
+				result.push(Float(timeseries_kw[original_ts]))
+				original_indices_stepped += 1
+				current_destination_ts += 1
+			end
+			# See if you need to end your step in the middle of a destination time step and 
+			# just add the proportional value from the current origin timestep
+			remainder = (stepping_interval - original_indices_stepped)
+			if remainder > 0
+				result.push((Float(timeseries_kw[original_ts]) * remainder))
+				current_destination_ts += remainder
+			end
+		end
+    end
+    if destination_res == original_res
+    	#No resolution conversion necessary
+		result = timeseries_kw
+    end
+    return result
+end

data/lib/urbanopt/reopt/version.rb

@@ -1,5 +1,5 @@
 # *********************************************************************************
-# URBANopt, Copyright (c) 2019-2020, Alliance for Sustainable Energy, LLC, and other
+# URBANopt (tm), 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,
@@ -30,6 +30,6 @@
 
 module URBANopt # :nodoc:
   module REopt # :nodoc:
-    VERSION = '0.3.0.pre1'.freeze
+    VERSION = '0.5.4'.freeze
   end
 end

data/lib/urbanopt/reopt_scenario.rb

@@ -1,5 +1,5 @@
 # *********************************************************************************
-# URBANopt, Copyright (c) 2019-2020, Alliance for Sustainable Energy, LLC, and other
+# URBANopt (tm), 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,

data/urbanopt-reopt.gemspec

@@ -8,8 +8,9 @@ Gem::Specification.new do |spec|
   spec.version       = URBANopt::REopt::VERSION
   spec.authors       = ['']
   spec.email         = ['']
+  spec.licenses      = 'Nonstandard'
 
-  spec.summary       = 'Classes and measures for utilizing the REopt Lite API within OpenStudio workflows.'
+  spec.summary       = 'Accessing the REopt Lite API within OpenStudio workflows.'
   spec.description   = 'Classes and measures for utilizing the REopt Lite API within OpenStudio workflows.'
   spec.homepage      = 'https://github.com/urbanopt/urbanopt-reopt-gem'
 
@@ -22,14 +23,16 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
+  spec.required_ruby_version = '~> 2.5.0'
+
   spec.add_development_dependency 'bundler', '~> 2.1'
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.7'
-
   spec.add_development_dependency 'rubocop', '~> 0.54.0'
+  spec.add_development_dependency 'rdoc', '~> 4.3.0'
 
-  spec.add_dependency 'certified'
-  spec.add_dependency 'json_pure'
-  spec.add_dependency 'urbanopt-scenario', '~> 0.3.0.pre1'
+  spec.add_dependency 'certified', '~> 1'
+  spec.add_dependency 'json_pure', '~> 2'
+  spec.add_dependency 'urbanopt-scenario', '~> 0.5.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: urbanopt-reopt
 version: !ruby/object:Gem::Version
-  version: 0.3.0.pre1
+  version: 0.5.4
 platform: ruby
 authors:
 - ''
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-05-19 00:00:00.000000000 Z
+date: 2021-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -66,48 +66,62 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.54.0
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.3.0
 - !ruby/object:Gem::Dependency
   name: certified
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1'
 - !ruby/object:Gem::Dependency
   name: json_pure
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: urbanopt-scenario
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0.pre1
+        version: 0.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0.pre1
+        version: 0.5.0
 description: Classes and measures for utilizing the REopt Lite API within OpenStudio
   workflows.
 email:
@@ -124,7 +138,6 @@ files:
 - ".rdoc_options"
 - ".rspec"
 - ".rubocop.yml"
-- ".travis.yml"
 - CHANGELOG.md
 - CONTRIBUTING.md
 - Gemfile
@@ -169,11 +182,13 @@ files:
 - lib/urbanopt/reopt/reopt_schema/reopt_output_schema.json
 - lib/urbanopt/reopt/scenario/reopt_scenario_csv.rb
 - lib/urbanopt/reopt/scenario_report_adapter.rb
+- lib/urbanopt/reopt/utilities.rb
 - lib/urbanopt/reopt/version.rb
 - lib/urbanopt/reopt_scenario.rb
 - urbanopt-reopt.gemspec
 homepage: https://github.com/urbanopt/urbanopt-reopt-gem
-licenses: []
+licenses:
+- Nonstandard
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -181,17 +196,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - "~>"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
-summary: Classes and measures for utilizing the REopt Lite API within OpenStudio workflows.
+summary: Accessing the REopt Lite API within OpenStudio workflows.
 test_files: []

data/.travis.yml

@@ -1,22 +0,0 @@
----
-sudo: false
-language: ruby
-#cache: bundler
-rvm:
-  - 2.2.4
-matrix:
-  include:
-  - env: OPENSTUDIO_VERSION=2.7.0 && OPENSTUDIO_SHA=544f363db5 && RUBYLIB=/usr/local/openstudio-2.7.0/Ruby:/usr/Ruby
-before_install: 
-  - gem install bundler -v '1.17'
-  - gem install bundler -v '~> 1.17'
-install: 
-  - bundle install
-before_script:
-  - curl -sLO https://raw.githubusercontent.com/NREL/OpenStudio-server/develop/docker/deployment/scripts/install_openstudio.sh
-  - chmod +x install_openstudio.sh
-  - sudo ./install_openstudio.sh $OPENSTUDIO_VERSION $OPENSTUDIO_SHA  
-  - sudo ./install_openstudio.sh $OPENSTUDIO_VERSION $OPENSTUDIO_SHA  
-script:
-  - bundle exec rake 
-  - bundle exec rake