openstudio-ee 0.12.3 → 0.12.5

data/lib/measures/window_enhancement/resources/__pycache__/Original_EC3_lookup.py

@@ -0,0 +1,322 @@
+# EC3 API Call
+import requests
+import json
+import re
+import pprint
+import statistics
+
+print("EC3 API Call:")
+
+EC3_category_array = {
+    "ConstructionMaterials": {
+        "Concrete": [
+            "ReadyMix",
+            "Shotcrete",
+            "CementGrout",
+            "FlowableFill",
+            "Precast",
+            "Rebar",
+            "WireMeshSteel",
+            "SCM",
+            "Cement",
+            "Aggregates"
+        ],
+        "Masonry": [
+            "Brick",
+            "ConcreteUnitMasonry",
+            "Mortar",
+            "Cementitious",
+            "Aggregates"
+        ],
+        "Steel": [],
+        "Aluminum": [],
+        "Wood": [],
+        "Sheathing": [],
+        "ThermalMoistureProtection": [], 
+        "Cladding": [],
+        "Openings": [], 
+        "Finishes": [],
+        "ConveyingEquipment": [],
+        "NetworkInfrastrucure": [], 
+        "Asphalt": [],
+        "Accessories": [], 
+        "ManufacturingInputs": [],
+        "BulkMaterials": [],
+        "Placeholders": []
+    },
+    "BuildingAssemblies": {
+        "NewCoustomAssembly": [],
+        "ReinforcedConcrete": [], 
+        "Walls": [],
+        "Floors": [], 
+        "GlazingFenesration": [], 
+    },
+}
+
+# Define the URL with query parameters (FIXME: Not including API key in public repo. Will need to be included in a gitignored config.ini file)
+windows_url = (
+    "https://api.buildingtransparency.org/api/epds"
+    "?page_number=1&page_size=25&fields=id%2Copen_xpd_uuid%2Cis_failed%2Cfailures%2Cerrors%2Cwarnings"
+    "%2Cdate_validity_ends%2Ccqd_sync_unlocked%2Cmy_capabilities%2Coriginal_data_format%2Ccategory"
+    "%2Cdisplay_name%2Cmanufacturer%2Cplant_or_group%2Cname%2Cdescription%2Cprogram_operator"
+    "%2Cprogram_operator_fkey%2Cverifier%2Cdeveloper%2Cmatched_plants_count%2Cplant_geography%2Cpcr"
+    "%2Cshort_name%2Cversion%2Cdate_of_issue%2Clanguage%2Cgwp%2Cuncertainty_adjusted_gwp%2Cdeclared_unit"
+    "%2Cupdated_on%2Ccorrections_count%2Cdeclaration_type%2Cbox_id%2Cis_downloadable"
+    "&sort_by=-updated_on&name__like=window&description__like=window&q=windows&plant_geography=US&declaration_type=Product%20EPD"
+)
+
+igu_url =  (
+    "https://api.buildingtransparency.org/api/materials"
+    "?page_number=1&page_size=100"
+    "&mf=!EC3%20search(%22InsulatingGlazingUnits%22)%20WHERE%20"
+    "%0A%20%20jurisdiction%3A%20IN(%22021%22)%20AND%0A%20%20"
+    "epd__date_validity_ends%3A%20%3E%20%222024-12-05%22%20AND%0A%20%20"
+    "epd_types%3A%20IN(%22Product%20EPDs%22)%20"
+    "!pragma%20eMF(%222.0%2F1%22)%2C%20lcia(%22TRACI%202.1%22)"
+)
+
+wframe_url = (
+    "https://api.buildingtransparency.org/api/materials"
+    "?page_number=1&page_size=25"
+    "&mf=!EC3%20search(%22AluminiumExtrusions%22)%20WHERE%20"
+    "%0A%20%20jurisdiction%3A%20IN(%22021%22)%20AND%0A%20%20"
+    "epd__date_validity_ends%3A%20%3E%20%222024-12-09%22%20AND%0A%20%20"
+    "epd_types%3A%20IN(%22Product%20EPDs%22)%20"
+    "!pragma%20eMF(%222.0%2F1%22)%2C%20lcia(%22TRACI%202.1%22)"
+)
+
+
+gypsum_url = (
+    "https://api.buildingtransparency.org/api/materials"
+    "?page_number=1&page_size=25"
+    "&mf=!EC3%20search(%22Gypsum%22)%20WHERE%20"
+    "%0A%20%20jurisdiction%3A%20IN(%22US%22%2C%20%22CA%22)%20AND%0A%20%20"
+    "epd__date_validity_ends%3A%20%3E%20%222024-12-24%22%20AND%0A%20%20"
+    "epd_types%3A%20IN(%22Product%20EPDs%22)%20AND%0A%20%20"
+    "gypsum_fire_rating%3A%20IN(%22X%22)%20AND%0A%20%20"
+    "gypsum_thickness%3A%20IN(%220.625%20in%22)%20AND%0A%20%20"
+    "gypsum_facing%3A%20IN(%22Paper%22)%20"
+    "!pragma%20eMF(%222.0%2F1%22)%2C%20lcia(%22TRACI%202.1%22)"
+)
+
+# Headers for the request
+headers = {
+    "Accept": "application/json",
+    "Authorization": "Bearer 5fk7wP4cJg6pcmx6ncZN0ftMdoVR8u"
+}
+
+# Execute the GET request
+igu_response = requests.get(igu_url, headers=headers, verify=False)
+wframe_response = requests.get(wframe_url, headers=headers, verify=False)
+
+# Parse the JSON response
+igu_response = igu_response.json()
+wframe_response = wframe_response.json()
+#print(igu_response)
+# Print the response and the number of EPDs
+print(f"Number of EPDs for IGU: {len(igu_response)}")
+print(f"Number of EPDs for window frame: {len(wframe_response)}")
+
+# Exception for EPD: 0
+if len(igu_response) == 0:
+    print("No EPD returned for IGU, please change the search terms")
+if len(wframe_response) == 0:
+    print("No EPD returned for window frame, please change the search terms")
+
+# List of keys to exclude
+exclude_keys = [
+    'manufacturer', 
+    'plant_or_group', 
+    'category',
+    'created_on',
+    'updated_on',
+    'gwp',
+    'gwp_z',
+    'pct80_gwp_per_category_declared_unit',
+    'conservative_estimate',
+    'best_practice',
+    'standard_deviation',
+    'uncertainty_factor',
+    'uncertainty_adjusted_gwp',
+    'lowest_plausible_gwp',
+    ]
+
+# Create an empty list to store EPDs of IGU
+igu_epd_data = {}
+igu_gwp_per_volume = []
+igu_gwp_per_mass = []
+igu_gwp_per_area = []
+wframe_epd_data = {}
+wframe_gwp_per_volume = []
+wframe_gwp_per_mass = []
+wframe_gwp_per_area = []
+
+for igu_epd_no, igu_epd in enumerate(igu_response, start=1):
+    print(f"========================================EPD No. {igu_epd_no}:==========================================")
+    # Initialize gwp per unit volume of IGU  
+    gwp_per_unit_volume = "Not specified"
+    gwp_per_unit_area = "Not specified"
+    gwp_per_unit_mass = "Not specified"
+    # Create an empty list to store each key,value pair in an individual EPD object 
+    igu_object = {}
+
+    for key, value in igu_epd.items():
+        if value is not None and key not in exclude_keys:
+            # Append the key-value pair to the list
+            igu_object[key] = value
+            # Extract the relevant keys
+            declared_unit = igu_epd.get("declared_unit")
+            thickness_unit = igu_epd.get("thickness")
+            gwp_per_category_declared_unit = igu_epd.get("gwp_per_category_declared_unit")
+            warnings = igu_epd.get("warnings")
+            mass_per_declared_unit = igu_epd.get("mass_per_declared_unit")
+            density_unit = igu_epd.get("density")
+            gwp_per_unit_mass = igu_epd.get("gwp_per_kg")
+
+            # Per volume
+            if declared_unit and "m3" in declared_unit:
+                gwp_per_category_declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_category_declared_unit)).group())
+                declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(declared_unit)).group())
+                gwp_per_unit_volume = gwp_per_category_declared_unit_value/declared_unit_value
+
+            elif declared_unit and "m2" in declared_unit and thickness_unit and "mm" in str(thickness_unit):
+                thickness = float(re.search(r"[-+]?\d*\.?\d+", thickness_unit).group())  # Extract numeric part
+                gwp_per_category_declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_category_declared_unit)).group())
+                thickness = thickness * 1e-3 # Convert thickness to meters
+                gwp_per_unit_volume = round(gwp_per_category_declared_unit_value / thickness,2)
+
+            elif density_unit and gwp_per_unit_mass:
+                density = float(re.search(r"[-+]?\d*\.?\d+", density_unit).group())  # Extract numeric part
+                gwp_per_unit_mass = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_unit_mass)).group())
+                gwp_per_unit_volume = gwp_per_unit_mass*density
+                gwp_per_unit_volume = round(gwp_per_unit_volume,2)
+            
+            elif declared_unit and "t" in declared_unit and density_unit:
+                density = float(re.search(r"[-+]?\d*\.?\d+", density_unit).group())  # Extract numeric part
+                gwp_per_category_declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_category_declared_unit)).group())
+                gwp_per_unit_volume = (gwp_per_category_declared_unit_value / 1000) * density
+                gwp_per_unit_volume = round(gwp_per_unit_volume,2)
+
+            # Per area    
+            if declared_unit and "sf" in declared_unit:
+                gwp_per_category_declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_category_declared_unit)).group())
+                declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(declared_unit)).group())
+                gwp_per_unit_area = (gwp_per_category_declared_unit_value/declared_unit_value)/0.092903
+                gwp_per_unit_area = round(gwp_per_unit_area,2)
+
+    igu_object["gwp_per_unit_volume"] = f"{gwp_per_unit_volume} kg CO2 e/m3"
+    
+    if declared_unit and "m2" in declared_unit:
+        gwp_per_category_declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_category_declared_unit)).group())
+        igu_object["gwp_per_unit_area"] = f"{gwp_per_category_declared_unit_value} kg CO2 e/m2"
+    else:
+        igu_object["gwp_per_unit_area"] = f"{gwp_per_unit_area} kg CO2 e/m2"
+
+    if gwp_per_unit_mass:
+        gwp_per_unit_mass = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_unit_mass)).group())
+        gwp_per_unit_mass = round(gwp_per_unit_mass,2)
+        igu_object["gwp_per_unit_mass"] = f"{gwp_per_unit_mass} kg CO2 e/kg"
+    else:
+        igu_object["gwp_per_unit_mass"] = "Not avaialble in this EPD"
+    object_key = "object" + str(igu_epd_no)
+    igu_epd_data[object_key] = igu_object
+    igu_gwp_per_volume.append(gwp_per_unit_volume)
+    igu_gwp_per_area.append(gwp_per_unit_area)
+    igu_gwp_per_mass.append(gwp_per_unit_mass)
+    pprint.pp(igu_object)
+#print all gwp per volume
+igu_gwp_per_volume = [float(item) for item in igu_gwp_per_volume if isinstance(item, (int, float)) or item.replace('.', '', 1).isdigit()]
+# Calculate the mean
+if igu_gwp_per_volume:  # Check if the list is not empty
+    mean_value = statistics.mean(igu_gwp_per_volume)
+    print("Mean of GWP per volume:", mean_value)
+else:
+    print("No numeric values to calculate mean.")
+print(igu_gwp_per_volume)
+
+for wframe_epd_no, wframe_epd in enumerate(wframe_response, start=1):
+    print(f"========================================EPD No. {wframe_epd_no}:==========================================")
+    # Initialize gwp per unit volume of window frame 
+    gwp_per_unit_volume = "Not specified"
+    gwp_per_unit_area = "Not specified"
+    gwp_per_unit_mass = "Not specified"
+    # Create an empty list to store each key,value pair in an individual EPD object 
+    wframe_object = {}
+
+    for key, value in wframe_epd.items():
+        if value is not None and key not in exclude_keys:
+            # Append the key-value pair to the list
+            wframe_object[key] = value
+            # Extract the relevant keys
+            declared_unit = wframe_epd.get("declared_unit")
+            thickness_unit = wframe_epd.get("thickness")
+            gwp_per_category_declared_unit = wframe_epd.get("gwp_per_category_declared_unit")
+            warnings = wframe_epd.get("warnings")
+            mass_per_declared_unit = wframe_epd.get("mass_per_declared_unit")
+            density_unit = wframe_epd.get("density")
+            gwp_per_unit_mass = wframe_epd.get("gwp_per_kg")
+
+            # Per volume
+            if declared_unit and "m3" in declared_unit:
+                gwp_per_category_declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_category_declared_unit)).group())
+                declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(declared_unit)).group())
+                gwp_per_unit_volume = gwp_per_category_declared_unit_value/declared_unit_value
+
+            elif declared_unit and "m2" in declared_unit and thickness_unit and "mm" in str(thickness_unit):
+                thickness = float(re.search(r"[-+]?\d*\.?\d+", thickness_unit).group())  # Extract numeric part
+                gwp_per_category_declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_category_declared_unit)).group())
+                thickness = thickness * 1e-3 # Convert thickness to meters
+                gwp_per_unit_volume = round(gwp_per_category_declared_unit_value / thickness,2)
+
+            elif density_unit and gwp_per_unit_mass:
+                density = float(re.search(r"[-+]?\d*\.?\d+", density_unit).group())  # Extract numeric part
+                gwp_per_unit_mass = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_unit_mass)).group())
+                gwp_per_unit_volume = gwp_per_unit_mass*density
+                gwp_per_unit_volume = round(gwp_per_unit_volume,2)
+            
+            elif declared_unit and "t" in declared_unit and density_unit:
+                density = float(re.search(r"[-+]?\d*\.?\d+", density_unit).group())  # Extract numeric part
+                gwp_per_category_declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_category_declared_unit)).group())
+                gwp_per_unit_volume = (gwp_per_category_declared_unit_value / 1000) * density
+                gwp_per_unit_volume = round(gwp_per_unit_volume,2)
+
+            # Per area    
+            if declared_unit and "sf" in declared_unit:
+                gwp_per_category_declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_category_declared_unit)).group())
+                declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(declared_unit)).group())
+                gwp_per_unit_area = (gwp_per_category_declared_unit_value/declared_unit_value)/0.092903
+                gwp_per_unit_area = round(gwp_per_unit_area,2)
+
+    wframe_object["gwp_per_unit_volume"] = f"{gwp_per_unit_volume} kg CO2 e/m3"
+    
+    if declared_unit and "m2" in declared_unit:
+        gwp_per_category_declared_unit_value = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_category_declared_unit)).group())
+        wframe_object["gwp_per_unit_area"] = f"{gwp_per_category_declared_unit_value} kg CO2 e/m2"
+    else:
+        wframe_object["gwp_per_unit_area"] = f"{gwp_per_unit_area} kg CO2 e/m2"
+
+    if gwp_per_unit_mass:
+        gwp_per_unit_mass = float(re.search(r"[-+]?\d*\.?\d+", str(gwp_per_unit_mass)).group())
+        gwp_per_unit_mass = round(gwp_per_unit_mass,2)
+        wframe_object["gwp_per_unit_mass"] = f"{gwp_per_unit_mass} kg CO2 e/kg"
+    else:
+        wframe_object["gwp_per_unit_mass"] = "Not avaialble in this EPD"
+    object_key = "object" + str(wframe_epd_no)
+    wframe_epd_data[object_key] = wframe_object
+    wframe_gwp_per_volume.append(gwp_per_unit_volume)
+    wframe_gwp_per_area.append(gwp_per_unit_area)
+    wframe_gwp_per_mass.append(gwp_per_unit_mass)
+    pprint.pp(wframe_object)
+
+#print all gwp per volume
+wframe_gwp_per_volume = [float(item) for item in wframe_gwp_per_volume if isinstance(item, (int, float)) or item.replace('.', '', 1).isdigit()]
+# Calculate the mean
+if wframe_gwp_per_volume:  # Check if the list is not empty
+    mean_value = statistics.mean(wframe_gwp_per_volume)
+    min_value = min(wframe_gwp_per_volume)
+    max_value = max(wframe_gwp_per_volume)
+    print("Mean of GWP per m3:", mean_value)
+    print("Minimum GWP per m3:", min_value)
+    print("Maximum GWP per m3:", max_value)
+else:
+    print("No numeric values to calculate statistical parameters.")

data/lib/measures/window_enhancement/resources/calculate_perimeter.py

@@ -0,0 +1,39 @@
+# save this function for wall construction
+def calculate_geometry(self, sub_surface):
+    """
+    Calculate the length, width, perimeter, and area of the window from its vertices.
+    Assumes the window is a quadrilateral (typically a rectangle).
+    """
+    vertices = sub_surface.vertices()
+    if len(vertices) != 4:
+        return {
+            "length": 0.0,
+            "width": 0.0,
+            "perimeter": 0.0,
+            "area": 0.0
+        }
+
+    # Calculate all edge lengths
+    edge_lengths = []
+    perimeter = 0.0
+    for i in range(4):
+        v1 = vertices[i]
+        v2 = vertices[(i + 1) % 4]
+        edge = v2 - v1
+        length = edge.length()
+        edge_lengths.append(length)
+        perimeter += length
+
+    # Assume opposite edges are equal, so we can group into two unique lengths
+    length = max(edge_lengths)
+    width = min(edge_lengths)
+
+    # Area = length × width
+    area = length * width
+
+    return {
+        "length": length,
+        "width": width,
+        "perimeter": perimeter,
+        "area": area
+    }

data/lib/measures/window_enhancement/test_output.log

@@ -0,0 +1,39 @@
+**************API_TOKEN*************
+"5fk7wP4cJg6pcmx6ncZN0ftMdoVR8u"
+**************IGU_URL*************
+"https://api.buildingtransparency.org/api/materials?page_number=1&page_size=100&mf=!EC3%20search(%22InsulatingGlazingUnits%22)%20WHERE%20%0A%20%20jurisdiction%3A%20IN(%22021%22)%20AND%0A%20%20epd__date_validity_ends%3A%20%3E%20%222024-12-05%22%20AND%0A%20%20epd_types%3A%20IN(%22Product%20EPDs%22)%20!pragma%20eMF(%222.0%2F1%22)%2C%20lcia(%22TRACI%202.1%22)"
+**************WFRAME_URL*************
+"aaa"
+**********************HEADERS**************************
+{'Accept': 'application/json', 'Authorization': 'Bearer 5fk7wP4cJg6pcmx6ncZN0ftMdoVR8u'}
+test_number_of_arguments_and_argument_names() method level...
+test_good_argument_values() method level...
+user_arguments:  igu_component_name (IGU Component Name)
+String, Required
+Value: 
+
+user_arguments:  frame_cross_section_area (Frame Cross Section Area (m�))
+Double, Required
+Value: 
+
+user_arguments:  frame_perimeter_length (Frame Perimeter Length (m))
+Double, Required
+Value: 
+
+user_arguments:  declared_unit (Declared Unit for GWP)
+String, Required
+Value: 
+
+user_arguments:  gwp (Global Warming Potential (GWP) Value)
+Double, Required
+Value: 
+
+user_argument: declared_unit = m2
+user_argument: frame_cross_section_area = 0.02
+user_argument: frame_perimeter_length = 10
+user_argument: gwp = 0
+user_argument: igu_component_name = TestIGU
+Measure result: Success
+Modified model saved to: C:\All_repos\openstudio-ee-gem\lib\measures\window_enhancement\tests\output\example_model_with_enhancements.osm
+Running test_measure_changes_building()...
+Measure success: Fail

data/lib/openstudio/ee_measures/version.rb

@@ -7,6 +7,6 @@
 
 module OpenStudio
   module EeMeasures
-    VERSION = '0.12.3'
+    VERSION = '0.12.5'
   end
 end

data/openstudio-ee.gemspec

@@ -12,10 +12,11 @@ Gem::Specification.new do |spec|
   spec.summary       = 'Library and measures for OpenStudio for energy efficiency use cases'
   spec.description   = 'Library and measures for OpenStudio for energy efficiency use cases'
   spec.metadata = {
-      'bug_tracker_uri' => 'https://github.com/NREL/openstudio-ee-gem/issues',
-      'changelog_uri' => 'https://github.com/NREL/openstudio-ee-gem/blob/develop/CHANGELOG.md',
-      # 'documentation_uri' =>  'https://www.rubydoc.info/gems/openstudio-ee-gem/#{gem.version}',
-      'source_code_uri' => "https://github.com/NREL/openstudio-ee-gem/tree/v#{spec.version}"
+    'bug_tracker_uri' => 'https://github.com/NREL/openstudio-ee-gem/issues',
+    'changelog_uri' => 'https://github.com/NREL/openstudio-ee-gem/blob/develop/CHANGELOG.md',
+    # 'documentation_uri' =>  'https://www.rubydoc.info/gems/openstudio-ee-gem/#{gem.version}',
+    'source_code_uri' => "https://github.com/NREL/openstudio-ee-gem/tree/v#{spec.version}",
+    'rubygems_mfa_required' => 'true'
   }
 
   spec.files = `git ls-files -z`.split("\x0").reject do |f|
@@ -28,15 +29,16 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '~> 3.2.2'
 
   spec.add_dependency 'bundler', '~> 2.4.10'
+  spec.add_dependency 'multipart-post', '2.4.0'
   spec.add_dependency 'openstudio-extension', '~> 0.9.3'
   spec.add_dependency 'openstudio-standards', '0.8.2'
-  spec.add_dependency 'multipart-post', '2.4.0'
 
+  spec.add_development_dependency 'octokit', '4.18.0' # for change logs
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rspec', '~> 3.9'
   spec.add_development_dependency 'rubocop', '1.50'
   spec.add_development_dependency 'rubocop-checkstyle_formatter', '0.6.0'
   spec.add_development_dependency 'rubocop-performance', '1.20.0'
+  spec.add_development_dependency 'rubocop-rake', '~> 0.6.0'
   spec.add_development_dependency 'simplecov', '0.22.0'
-  spec.add_development_dependency 'rake', '~> 13.0'
-  spec.add_development_dependency 'rspec', '~> 3.9'
-  spec.add_development_dependency 'octokit', '4.18.0' # for change logs
 end

data/test-workflow-locally.sh

@@ -0,0 +1,152 @@
+#!/bin/bash
+
+# Local workflow testing script
+# This script tests the key components of the GitHub Actions workflow locally
+
+set -e
+
+echo "🔍 Testing OpenStudio EE Gem Workflow Components Locally"
+echo "========================================================"
+
+# Test 1: Check Docker image availability
+echo "1. Testing Docker image availability..."
+
+# Check if images are already available locally
+if docker images --format "table {{.Repository}}:{{.Tag}}" | grep -q "nrel/openstudio:develop"; then
+    echo "✅ nrel/openstudio:develop image found locally"
+    DOCKER_IMAGE="nrel/openstudio:develop"
+elif docker images --format "table {{.Repository}}:{{.Tag}}" | grep -q "nrel/openstudio:3.10.0"; then
+    echo "✅ nrel/openstudio:3.10.0 image found locally"
+    DOCKER_IMAGE="nrel/openstudio:3.10.0"
+else
+    echo "⚠️  No local OpenStudio Docker images found. Attempting to pull..."
+    
+    # Try to pull the develop image
+    if docker pull nrel/openstudio:develop 2>/dev/null; then
+        echo "✅ Successfully pulled nrel/openstudio:develop image"
+        DOCKER_IMAGE="nrel/openstudio:develop"
+    else
+        echo "❌ Failed to pull nrel/openstudio:develop image"
+        echo "   This might be due to:"
+        echo "   - Repository requires authentication (docker login)"
+        echo "   - Network connectivity issues"
+        echo "   - Repository access restrictions"
+        
+        # Try fallback to 3.10.0
+        echo "   Trying fallback to nrel/openstudio:3.10.0..."
+        if docker pull nrel/openstudio:3.10.0 2>/dev/null; then
+            echo "✅ Successfully pulled nrel/openstudio:3.10.0 image"
+            DOCKER_IMAGE="nrel/openstudio:3.10.0"
+        else
+            echo "❌ Failed to pull any OpenStudio Docker image"
+            echo ""
+            echo "🔧 To fix this issue:"
+            echo "   1. Check if you need to run 'docker login' for private registries"
+            echo "   2. Verify network connectivity to Docker Hub"
+            echo "   3. Contact your system administrator about Docker registry access"
+            echo ""
+            echo "⏭️  Skipping Docker-based tests. The GitHub Actions workflow will"
+            echo "   run in the GitHub environment which should have proper access."
+            exit 0
+        fi
+    fi
+fi
+
+DOCKER_IMAGE="${DOCKER_IMAGE:-nrel/openstudio:develop}"
+echo "Using Docker image: $DOCKER_IMAGE"
+
+# Test 2: Run basic container commands
+echo ""
+echo "2. Testing basic container functionality..."
+docker run --rm -v "$(pwd):/workspace" -w /workspace "$DOCKER_IMAGE" bash -c "
+    echo 'Container started successfully'
+    echo 'Ruby Version:' \$(ruby -v)
+    echo 'Bundle Version:' \$(bundle -v)
+    echo 'OpenStudio Version:' \$(openstudio openstudio_version)
+    echo 'Listing OpenStudio Gems:' \$(openstudio gem_list)
+"
+
+# Test 3: Test locale setup
+echo ""
+echo "3. Testing locale configuration..."
+docker run --rm -u root "$DOCKER_IMAGE" bash -c "
+    apt-get update -qq
+    apt-get install -y locales
+    locale-gen en_US.UTF-8
+    echo 'Locale setup completed'
+    locale -a | grep en_US
+"
+
+# Test 4: Test bundle install
+echo ""
+echo "4. Testing bundle install..."
+docker run --rm -v "$(pwd):/workspace" -w /workspace "$DOCKER_IMAGE" bash -c "
+    if bundle install; then
+        echo '✅ Bundle install successful'
+        bundle list
+    else
+        echo '❌ Bundle install failed'
+        exit 1
+    fi
+"
+
+# Test 5: Test basic rake tasks (if available)
+echo ""
+echo "5. Testing rake tasks availability..."
+docker run --rm -v "$(pwd):/workspace" -w /workspace "$DOCKER_IMAGE" bash -c "
+    bundle install
+    echo 'Available rake tasks:'
+    bundle exec rake -T | head -10
+"
+
+# Test 6: Local environment validation (fallback if Docker fails)
+if [ "$DOCKER_IMAGE" = "" ]; then
+    echo ""
+    echo "6. Testing local Ruby environment (Docker unavailable)..."
+    
+    # Check Ruby version
+    if command -v ruby >/dev/null 2>&1; then
+        echo "Ruby Version: $(ruby -v)"
+    else
+        echo "❌ Ruby not found in local environment"
+    fi
+    
+    # Check Bundle version
+    if command -v bundle >/dev/null 2>&1; then
+        echo "Bundle Version: $(bundle -v)"
+        
+        # Test bundle install
+        if bundle check >/dev/null 2>&1 || bundle install; then
+            echo "✅ Bundle dependencies satisfied"
+            
+            # List available rake tasks
+            echo "Available rake tasks:"
+            bundle exec rake -T | head -5
+        else
+            echo "❌ Bundle install failed"
+        fi
+    else
+        echo "❌ Bundler not found in local environment"
+    fi
+fi
+
+echo ""
+echo "🎉 Local workflow testing completed!"
+echo ""
+echo "📝 Notes:"
+echo "   - Docker image testing completed (using $DOCKER_IMAGE)"
+echo "   - All basic commands work as expected"
+echo "   - Bundle install succeeds"
+echo "   - Ready for GitHub Actions testing"
+echo ""
+echo "⚠️  To test the full workflow:"
+echo "   1. Push changes to a test branch"
+echo "   2. Monitor the GitHub Actions run"
+echo "   3. Check the S3 bucket for uploaded results"
+echo ""
+echo "🔍 Alternative local testing (without Docker):"
+echo "   If Docker testing failed, you can still validate the workflow logic:"
+echo "   1. Check that bundle install works: bundle install"
+echo "   2. List available rake tasks: bundle exec rake -T"
+echo "   3. Test individual rake tasks if available"
+echo "   4. The GitHub Actions environment should have proper Docker access"