urbanopt-reporting 0.10.0 → 0.10.1

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: '09a91049832525b175fdf4dacdd43861183d07284a773e3edc942daf46c2e69f'
4
- data.tar.gz: a3ad57f274c24e9105240ce4c70e038e562d65dc5f58cae3c5ab40fa800a9733
3
+ metadata.gz: b1877280e45c42b9a43bfd39dbd5305079fdcd3e4fad3cfba9894d0b7a05940c
4
+ data.tar.gz: 4380403c78776ac9ffa650859cf14a607b25bd910a0b1347c5c0f94362e21a55
5
5
  SHA512:
6
- metadata.gz: cef7169b7257bc0b59a8bafad086e3c55bde3f0f9ed8f353d2f3d6abf7af8a95cb36e167316f85a8aee58aeafd66abcfa54636370165e0e17908ac3d8e854fb6
7
- data.tar.gz: 56694ad3398c8198f37dac1ceee0ccfd03d15960645cbaa527f73b5c2a000d771790448db78f547f84f83bc41e38e032473f8466ff1fd1972764785e67fcf9ec
6
+ metadata.gz: 45de5ba3805fa748b1b6630ba7ca655643c28bc611c9aa4771944d6ffb40f296c0500f46dc700c293d54522a20a6d6f3c8205482e704436bff369f6386d1d569
7
+ data.tar.gz: 69a9b1ee7e94e14faa98f4cfd64f9f5cd0efdc9939f5c0ea8490018b14596f2a26590622efee2e23a602a1f1f34548756dabe2123f9b251df39c22a088a9dbd1
data/CHANGELOG.md CHANGED
@@ -1,7 +1,12 @@
1
1
  # URBANopt Reporting Gem
2
2
 
3
+ ## Version 0.10.1
4
+ * Other Fuel emission factors update by @rawadelkontar in https://github.com/urbanopt/urbanopt-reporting-gem/pull/153
5
+
6
+
7
+ **Full Changelog**: https://github.com/urbanopt/urbanopt-reporting-gem/compare/v0.10.0...v0.10.1
8
+
3
9
  ## Version 0.10.0
4
- ## What's Changed
5
10
  * Additional reporting tests by @vtnate in https://github.com/urbanopt/urbanopt-reporting-gem/pull/147
6
11
  * Update formatting and version in export_modelica_loads by @nllong in https://github.com/urbanopt/urbanopt-reporting-gem/pull/149
7
12
  * Update feature reports for Reopt v3 by @vtnate in https://github.com/urbanopt/urbanopt-reporting-gem/pull/148
data/Gemfile CHANGED
@@ -15,6 +15,8 @@ allow_local = ENV['FAVOR_LOCAL_GEMS']
15
15
  gem 'addressable', '2.8.1'
16
16
  # pin this dependency to avoid using racc dependency (which has native extensions)
17
17
  gem 'parser', '3.2.2.2'
18
+ # pin this dependency because 2.9.2 breaks OS tests (openstudio:test_with_openstudio)
19
+ gem 'regexp_parser', '2.9.0'
18
20
 
19
21
  # if allow_local && File.exist?('../openstudio-extension-gem')
20
22
  # gem 'openstudio-extension', path: '../openstudio-extension-gem'
@@ -798,7 +798,7 @@ class DefaultFeatureReports < OpenStudio::Measure::ReportingMeasure
798
798
  enduses.each do |eu|
799
799
  sql_r = sql_query(runner, sql_file, 'AnnualBuildingUtilityPerformanceSummary', "TableName='End Uses' AND RowName='#{eu}' AND ColumnName='#{ft}'")
800
800
 
801
- # report each query in its corresponding feature report obeject
801
+ # report each query in its corresponding feature report object
802
802
  x = ft.tr(' ', '_').downcase
803
803
  if x.include? 'water'
804
804
  x_u = "#{x}_qbft"
@@ -931,14 +931,14 @@ class DefaultFeatureReports < OpenStudio::Measure::ReportingMeasure
931
931
  conv_kg_mt = 0.001 # kg to metric ton
932
932
  conv_kbtu_J = 1054852.32 # KBtu to J (1kBtu = 1054852.32 J)
933
933
 
934
- ##### Emisison factors for natural gas, propane, and fuel oil based on EPA eGRID data and calculated using 20-year GWP horizon based on ASHRAE 189.1
935
- ## natural gas : 277.358126 KG/MWH
936
- ## propane : 323.896704 KG/MWH
937
- ## Fuel oil : 294.962046 KG/MWH
938
- nat_gas_val = 277.358126
939
- lpg_val = 323.896704
940
- fo1_val = 294.962046
941
- fo2_val = 294.962046
934
+ ##### Emisison factors for natural gas, propane, and fuel oil based on https://portfoliomanager.energystar.gov/pdf/reference/Emissions.pdf
935
+ ## natural gas : 181.7 KG/MWH
936
+ ## propane : 219.2 KG/MWH
937
+ ## Fuel oil #1: 250.8 KG/MWH
938
+ nat_gas_val = 181.7
939
+ lpg_val = 219.2
940
+ fo1_val = 250.8
941
+ fo2_val = 253.2
942
942
 
943
943
  ##########################################################################################################################
944
944
  ######################################## Reporting TImeseries Results FOR CSV File #######################################
@@ -1046,7 +1046,7 @@ class DefaultFeatureReports < OpenStudio::Measure::ReportingMeasure
1046
1046
  total_hours = 1 / timesteps_per_hour.to_f # make sure timesteps_per_hour is a float in the division
1047
1047
  # set power_conversion
1048
1048
  power_conversion = total_hours # we set the power conversio to total_hours since we want to convert lWh to kW
1049
- puts "Power Converion: to convert kWh to kW values will be divided by #{power_conversion}"
1049
+ puts "Power Conversion: to convert kWh to kW values will be divided by #{power_conversion}"
1050
1050
 
1051
1051
  # number of values in each timeseries
1052
1052
  n = nil
@@ -1184,14 +1184,13 @@ class DefaultFeatureReports < OpenStudio::Measure::ReportingMeasure
1184
1184
  # conv_kg_mt = 0.001 # kg to metric ton
1185
1185
  # conv_kbtu_J = 1054852.32 # KBtu to J (1kBtu = 1054852.32 J)
1186
1186
 
1187
- # ##### Emisison factors for natural gas, propane, and fuel oil based on EPA eGRID data and calculated using 20-year GWP horizon based on ASHRAE 189.1
1188
- # ## natural gas : 277.358126 KG/MWH
1189
- # ## propane : 323.896704 KG/MWH
1190
- # ## Fuel oil : 294.962046 KG/MWH
1191
- # nat_gas_val = 277.358126
1192
- # lpg_val = 323.896704
1193
- # fo1_val = 294.962046
1194
- # fo2_val = 294.962046
1187
+ # ##### Emisison factors for natural gas, propane, and fuel oil based on https://portfoliomanager.energystar.gov/pdf/reference/Emissions.pdf
1188
+ # ## natural gas : 181.7 KG/MWH
1189
+ # ## propane : 219.2 KG/MWH
1190
+ # nat_gas_val = 181.7
1191
+ # lpg_val = 219.2
1192
+ # fo1_val = 250.8
1193
+ # fo2_val = 253.2
1195
1194
 
1196
1195
  if timeseries_name == 'Natural_Gas_Emissions'
1197
1196
  newVals = Array.new(n, 0)
@@ -1441,7 +1440,7 @@ class DefaultFeatureReports < OpenStudio::Measure::ReportingMeasure
1441
1440
  else
1442
1441
  raise 'ELECTRICITY and GAS results are not initiaized'
1443
1442
  end
1444
- # get formated datetimes
1443
+ # get formatted datetimes
1445
1444
  timeseries_d.dateTimes.each do |datetime|
1446
1445
  datetimes << format_datetime(datetime.to_s)
1447
1446
  end
@@ -3,8 +3,8 @@
3
3
  <schema_version>3.1</schema_version>
4
4
  <name>default_feature_reports</name>
5
5
  <uid>9ee3135a-8070-4408-bfa1-b75fecf9dd4f</uid>
6
- <version_id>0d079df4-5b14-465d-9b3c-d00e30b3def2</version_id>
7
- <version_modified>2024-01-08T22:54:10Z</version_modified>
6
+ <version_id>1f0dd70a-ddad-4bb8-a54b-0aeb696e80d0</version_id>
7
+ <version_modified>2024-06-20T19:28:12Z</version_modified>
8
8
  <xml_checksum>FB304155</xml_checksum>
9
9
  <class_name>DefaultFeatureReports</class_name>
10
10
  <display_name>DefaultFeatureReports</display_name>
@@ -128,7 +128,7 @@
128
128
  <filename>measure.rb</filename>
129
129
  <filetype>rb</filetype>
130
130
  <usage_type>script</usage_type>
131
- <checksum>A0464D25</checksum>
131
+ <checksum>005CDD6D</checksum>
132
132
  </file>
133
133
  <file>
134
134
  <filename>USA_CO_Golden-NREL.724666_TMY3.epw</filename>
@@ -1,6 +1,6 @@
1
1
  <?xml version="1.0"?>
2
2
  <measure>
3
- <schema_version>3.0</schema_version>
3
+ <schema_version>3.1</schema_version>
4
4
  <name>export_modelica_loads</name>
5
5
  <uid>7051db01-2e55-4223-b5b5-fee615b68dd0</uid>
6
6
  <version_id>e682f518-4785-4917-802e-600023816cc3</version_id>
@@ -77,7 +77,7 @@ class ExportTimeSeriesLoadsCSV < OpenStudio::Measure::ReportingMeasure
77
77
  # use the built-in error checking
78
78
  return false unless runner.validateUserArguments(arguments(model), user_arguments)
79
79
 
80
- # #Read in argumetns related to variables for output requests
80
+ # #Read in arguments related to variables for output requests
81
81
  hhw_loop_name = runner.getStringArgumentValue('hhw_loop_name', user_arguments)
82
82
  chw_loop_name = runner.getStringArgumentValue('chw_loop_name', user_arguments)
83
83
 
@@ -17,7 +17,7 @@ module URBANopt
17
17
  attr_accessor :category, :item_name, :unit_cost, :cost_units, :item_quantity, :total_cost # :nodoc:
18
18
 
19
19
  ##
20
- # ConstructionCost class intialize all construction_cost attributes:
20
+ # ConstructionCost class initialize all construction_cost attributes:
21
21
  # +:category+ , +:item_name+ , +:unit_cost+ , +:cost_units+ , +:item_quantity+ , +:total_cost+
22
22
  ##
23
23
  # [parameters:]
@@ -108,7 +108,7 @@ module URBANopt
108
108
  end
109
109
 
110
110
  ##
111
- # Merges muliple construction costs together.
111
+ # Merges multiple construction costs together.
112
112
  # - loops over the new_costs and find the index of the cost with identical +:item_name+.
113
113
  # - if +item_name+ is identical then modify the existing_cost array by summing the :total_cost and :item_quantity. Else add the new_cost to existing_costs array.
114
114
  ##
@@ -17,7 +17,7 @@ module URBANopt
17
17
  attr_accessor :month, :day_of_month, :year #:nodoc:
18
18
 
19
19
  ##
20
- # Date class intialize all date attributes:
20
+ # Date class initialize all date attributes:
21
21
  # +:month+ , +:day_of_month+ , +:year+
22
22
  ##
23
23
  # [parameters:]
@@ -17,7 +17,7 @@ module URBANopt
17
17
  :fans, :pumps, :heat_rejection, :humidification, :heat_recovery, :water_systems, :refrigeration, :generators # :nodoc:
18
18
 
19
19
  ##
20
- # EndUse class intialize all enduse atributes: +:heating+ , +:cooling+ , +:interior_lighting+ ,
20
+ # EndUse class initialize all enduse attributes: +:heating+ , +:cooling+ , +:interior_lighting+ ,
21
21
  # +:exterior_lighting+ , +:interior_equipment+ , +:exterior_equipment+ ,
22
22
  # +:fans+ , +:pumps+ , +:heat_rejection+ , +:humidification+ , +:heat_recovery+ , +:water_systems+ , +:refrigeration+ , +:generators+
23
23
  ##
@@ -11,13 +11,13 @@ module URBANopt
11
11
  module Reporting
12
12
  module DefaultReports
13
13
  ##
14
- # Enduses class inlclude results for each fuel type.
14
+ # Enduses class include results for each fuel type.
15
15
  ##
16
16
  class EndUses
17
17
  attr_accessor :electricity_kwh, :natural_gas_kwh, :propane_kwh, :fuel_oil_kwh, :other_fuels_kwh, :district_cooling_kwh, :district_heating_kwh, :water_qbft # :nodoc:
18
18
 
19
19
  ##
20
- # EndUses class intialize end_uses(fuel type) attributes: +:electricity_kwh+ , +:natural_gas_kwh+ , +:propane_kwh+ , +:fuel_oil_kwh+ , +:other_fuels_kwh+ ,
20
+ # EndUses class initialize end_uses(fuel type) attributes: +:electricity_kwh+ , +:natural_gas_kwh+ , +:propane_kwh+ , +:fuel_oil_kwh+ , +:other_fuels_kwh+ ,
21
21
  # +:district_cooling_kwh+ , +:district_heating_kwh+ , +:water_qbft+
22
22
  ##
23
23
  # [parameters:]
@@ -297,7 +297,7 @@ module URBANopt
297
297
  ##
298
298
  # Saves the 'default_feature_report.csv' file to the results directory
299
299
  # This method only copies the CSV feature reports from the folder generated by the reporting measure
300
- # (<meausure number>_default_feature_reports/) to the new feature_reports/ folder
300
+ # (<measure number>_default_feature_reports/) to the new feature_reports/ folder
301
301
  ##
302
302
  # [parameters]:
303
303
  # +file_name+ - _String_ - Assign a name to the saved feature report file without an extension
@@ -19,11 +19,11 @@ module URBANopt
19
19
  attr_accessor :size_kw
20
20
 
21
21
  ##
22
- # Intialize Generator attributes from a hash. Generator attributes currently are limited to power capacity.
22
+ # Initialize Generator attributes from a hash. Generator attributes currently are limited to power capacity.
23
23
  ##
24
24
  # [parameters:]
25
25
  #
26
- # * +hash+ - _Hash_ - A hash containting a +:size_kw+ key/value pair which represents the nameplate capacity in kilowatts (kW)
26
+ # * +hash+ - _Hash_ - A hash containing a +:size_kw+ key/value pair which represents the nameplate capacity in kilowatts (kW)
27
27
  #
28
28
  def initialize(hash = {})
29
29
  hash.delete_if { |k, v| v.nil? }
@@ -12,7 +12,7 @@ module URBANopt
12
12
 
13
13
  @@logger.level = Logger::WARN
14
14
  ##
15
- # Definining class variable "@@logger" to log errors, info and warning messages.
15
+ # Defining class variable "@@logger" to log errors, info and warning messages.
16
16
  def self.logger
17
17
  @@logger
18
18
  end
@@ -12,7 +12,7 @@ module URBANopt
12
12
  module Reporting
13
13
  module DefaultReports
14
14
  ##
15
- # power_distributio include eletrical power distribution systems information.
15
+ # power_distribution include eletrical power distribution systems information.
16
16
  ##
17
17
  class PowerDistribution
18
18
  attr_accessor :under_voltage_hours, :over_voltage_hours, :nominal_capacity,
@@ -89,7 +89,7 @@ module URBANopt
89
89
  end
90
90
 
91
91
  ##
92
- # Merges muliple power distribution results together.
92
+ # Merges multiple power distribution results together.
93
93
  ##
94
94
  # +new_costs+ - _Array_ - An array of ConstructionCost objects.
95
95
  def merge_power_distribution
@@ -33,7 +33,7 @@ module URBANopt
33
33
  :timeseries_csv, :location, :program, :construction_costs, :reporting_periods, :feature_reports, :distributed_generation,
34
34
  :scenario_power_distribution, :scenario_power_distribution_cost, :qaqc_flags # :nodoc:
35
35
 
36
- # ScenarioReport class intializes the scenario report attributes:
36
+ # ScenarioReport class initializes the scenario report attributes:
37
37
  # +:id+ , +:name+ , +:directory_name+, +:timesteps_per_hour+ , +:number_of_not_started_simulations+ ,
38
38
  # +:number_of_started_simulations+ , +:number_of_complete_simulations+ , +:number_of_failed_simulations+ ,
39
39
  # +:timeseries_csv+ , +:location+ , +:program+ , +:construction_costs+ , +:reporting_periods+ , +:feature_reports+,
@@ -74,7 +74,7 @@ module URBANopt
74
74
  @reporting_periods << ReportingPeriod.new(rp)
75
75
  end
76
76
 
77
- # feature_report is intialized here to be used in the add_feature_report method
77
+ # feature_report is initialized here to be used in the add_feature_report method
78
78
  @feature_reports = []
79
79
  hash[:feature_reports].each do |fr|
80
80
  @feature_reports << FeatureReport.new(fr)
@@ -246,7 +246,7 @@ module URBANopt
246
246
  # - add the array of feature_reports
247
247
  # - scenario report location takes the location of the first feature in the list
248
248
  ##
249
- # [parmeters:]
249
+ # [parameters:]
250
250
  # +feature_report+ - _FeatureReport_ - An object of FeatureReport class.
251
251
  ##
252
252
  def add_feature_report(feature_report)
@@ -719,7 +719,7 @@
719
719
  ]
720
720
  },
721
721
  "simultaneous_heating_and_cooling": {
722
- "description": "Whether heating and cooling are occuring during the same hour when cooling load exists",
722
+ "description": "Whether heating and cooling are occurring during the same hour when cooling load exists",
723
723
  "type": [
724
724
  "integer",
725
725
  "null"
@@ -784,7 +784,7 @@
784
784
  "type": "string"
785
785
  },
786
786
  "name": {
787
- "description": "name refers to the name of the feature (eg. Building 1, tranformer 5)",
787
+ "description": "name refers to the name of the feature (eg. Building 1, transformer 5)",
788
788
  "type": "string"
789
789
  },
790
790
  "directory_name": {
@@ -870,7 +870,7 @@
870
870
  "type": "string"
871
871
  },
872
872
  "multiplier": {
873
- "description": "Multiplier used if this reporting period is representative of mulitple periods. For example one week simulation that represents entire month.",
873
+ "description": "Multiplier used if this reporting period is representative of multiple periods. For example one week simulation that represents entire month.",
874
874
  "type": "number",
875
875
  "default": 1
876
876
  },
@@ -24,7 +24,7 @@ module URBANopt
24
24
  ##
25
25
  # [parameters:]
26
26
  #
27
- # * +hash+ - _Hash_ - A hash containting a +:size_kw+ key/value pair which represents the nameplate capacity in kilowatts (kW)
27
+ # * +hash+ - _Hash_ - A hash containing a +:size_kw+ key/value pair which represents the nameplate capacity in kilowatts (kW)
28
28
  #
29
29
  def initialize(hash = {})
30
30
  hash.delete_if { |k, v| v.nil? }
@@ -28,7 +28,7 @@ module URBANopt
28
28
  ##
29
29
  # [parameters:]
30
30
  #
31
- # * +hash+ - _Hash_ - A hash containting +:size_kw+ and +:size_kwh+ key/value pair which represents the power and storage capacity in kilowatts (kW) and kilowatt-hours respectively.
31
+ # * +hash+ - _Hash_ - A hash containing +:size_kw+ and +:size_kwh+ key/value pair which represents the power and storage capacity in kilowatts (kW) and kilowatt-hours respectively.
32
32
  #
33
33
  def initialize(hash = {})
34
34
  hash.delete_if { |k, v| v.nil? }
@@ -14,7 +14,7 @@ module URBANopt
14
14
  module Reporting
15
15
  module DefaultReports
16
16
  ##
17
- # TimeseriesCSV include timesries reults reported in a CSV file.
17
+ # TimeseriesCSV include timesries results reported in a CSV file.
18
18
  ##
19
19
  class TimeseriesCSV
20
20
  attr_accessor :path, :first_report_datetime, :column_names #:nodoc:
@@ -33,7 +33,7 @@ module URBANopt
33
33
  @path = hash[:path]
34
34
  @first_report_datetime = hash[:first_report_datetime]
35
35
 
36
- # from scenario csv shema get required reults to be aggregated
36
+ # from scenario csv shema get required results to be aggregated
37
37
  @required_column_names = load_scenario_csv_schema_headers
38
38
 
39
39
  @column_names = hash[:column_names]
@@ -23,7 +23,7 @@ module URBANopt
23
23
  ##
24
24
  # [parameters:]
25
25
  #
26
- # * +hash+ - _Hash_ - A hash containting a +:size_kw+ key/value pair which represents the nameplate capacity in kilowatts (kW)
26
+ # * +hash+ - _Hash_ - A hash containing a +:size_kw+ key/value pair which represents the nameplate capacity in kilowatts (kW)
27
27
  #
28
28
  def initialize(hash = {})
29
29
  hash.delete_if { |k, v| v.nil? }
@@ -5,6 +5,6 @@
5
5
 
6
6
  module URBANopt
7
7
  module Reporting
8
- VERSION = '0.10.0'.freeze
8
+ VERSION = '0.10.1'.freeze
9
9
  end
10
10
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: urbanopt-reporting
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.10.0
4
+ version: 0.10.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Rawad El Kontar
@@ -9,7 +9,7 @@ authors:
9
9
  autorequire:
10
10
  bindir: exe
11
11
  cert_chain: []
12
- date: 2024-05-06 00:00:00.000000000 Z
12
+ date: 2024-06-25 00:00:00.000000000 Z
13
13
  dependencies:
14
14
  - !ruby/object:Gem::Dependency
15
15
  name: bundler