residential-window-cleaning-2026 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c7b97d475c6b6c90e731be8271a5cf3e783e42150d527e50ccb4fab8e8d7f3e1
+  data.tar.gz: d23246245df6248fb182b8ccf3e70177ce77a8687eb4ae1d13dfa3a6bdb10dec
+SHA512:
+  metadata.gz: 784f182f62cfcea45d0dfe7ec2bfe4ae4843c2fe15d4a91a953a309fab98624a10a5ed1f26861831fc02f11dd041adc0fbe4fd1eba38e987409830c2ee6b1727
+  data.tar.gz: '08f1b9d8085a69bf4e042de796c7af5b528b283d06fbba24a03b5e7bd9e8eab748056b380ae42faba4206dda53033e1e19d3ff8efd984530b121742c07d5b962'

data/lib/residential_window_cleaning_2026.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+# ResidentialWindowCleaning2026
+#
+# Thermal shock risk and WFP solution freeze-point calculator for
+# cold-weather residential window cleaning in Northern Ontario.
+#
+# Reference: https://www.binx.ca/guides/residential-window-cleaning-2026.pdf
+
+module ResidentialWindowCleaning2026
+  VERSION = "0.1.0"
+
+  GLASS_PARAMS = {
+    single_annealed:  { min_surface: -10.0, max_delta: 30.0, low_max: 10.0, med_max: 20.0 },
+    single_tempered:  { min_surface: -15.0, max_delta: 55.0, low_max: 18.0, med_max: 36.0 },
+    double_igu:       { min_surface: -20.0, max_delta: 40.0, low_max: 13.0, med_max: 26.0 },
+    double_igu_lowe:  { min_surface: -25.0, max_delta: 45.0, low_max: 15.0, med_max: 30.0 },
+    triple_igu:       { min_surface: -30.0, max_delta: 50.0, low_max: 16.0, med_max: 33.0 },
+    triple_igu_lowe:  { min_surface: -30.0, max_delta: 52.0, low_max: 17.0, med_max: 34.0 },
+    laminated:        { min_surface: -10.0, max_delta: 35.0, low_max: 11.0, med_max: 23.0 },
+    wired:            { min_surface: -10.0, max_delta: 25.0, low_max:  8.0, med_max: 16.0 },
+  }.freeze
+
+  # Estimate glass surface temperature from ambient conditions.
+  #
+  # @param ambient_temp_c [Float] outdoor air temperature (°C)
+  # @param wind_speed_kmh [Float] wind speed (km/h)
+  # @param sun_factor [Float] solar exposure 0.0–1.0
+  # @return [Float] estimated glass surface temperature (°C)
+  def self.estimate_glass_surface_temp(ambient_temp_c, wind_speed_kmh, sun_factor)
+    solar_gain = sun_factor * 8.0
+    wind_factor = [wind_speed_kmh / 40.0, 1.0].min
+    solar_adjusted = solar_gain * (1.0 - 0.6 * wind_factor)
+    convective = ambient_temp_c < 5.0 ? -0.5 * wind_factor : 0.0
+    (ambient_temp_c + solar_adjusted + convective).round(1)
+  end
+
+  # Assess thermal shock risk for a cleaning operation.
+  #
+  # @param glass_type [Symbol] one of GLASS_PARAMS keys
+  # @param ambient_temp_c [Float]
+  # @param wind_speed_kmh [Float]
+  # @param sun_factor [Float]
+  # @param solution_temp_c [Float] cleaning solution temperature at application (°C)
+  # @return [Hash] assessment result
+  def self.assess_thermal_shock_risk(glass_type:, ambient_temp_c:, wind_speed_kmh:, sun_factor:, solution_temp_c:)
+    params = GLASS_PARAMS.fetch(glass_type) { raise ArgumentError, "Unknown glass_type: #{glass_type}" }
+    glass_temp = estimate_glass_surface_temp(ambient_temp_c, wind_speed_kmh, sun_factor)
+    delta_t = (solution_temp_c - glass_temp).abs.round(1)
+
+    band, proceed, advisory =
+      if glass_temp < params[:min_surface]
+        [:do_not_clean, false,
+         "Glass surface at #{glass_temp}°C is below minimum safe temp of #{params[:min_surface]}°C. Do not clean."]
+      elsif delta_t > params[:max_delta]
+        [:high, false,
+         "ΔT of #{delta_t}°C exceeds safe maximum of #{params[:max_delta]}°C. Cool solution or warm glass."]
+      elsif delta_t > params[:med_max]
+        [:moderate, true,
+         "Moderate risk (ΔT = #{delta_t}°C). Apply in small sections; avoid pooling at edges."]
+      elsif delta_t > params[:low_max]
+        [:low, true,
+         "Low risk (ΔT = #{delta_t}°C). Pre-wet glass before applying solution."]
+      else
+        [:safe, true,
+         "Safe conditions (ΔT = #{delta_t}°C). Proceed with normal technique."]
+      end
+
+    {
+      glass_type: glass_type,
+      estimated_glass_surface_temp_c: glass_temp,
+      delta_t_c: delta_t,
+      risk_band: band,
+      proceed: proceed,
+      advisory: advisory,
+    }
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: residential-window-cleaning-2026
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Veronica Caledon
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-04-13 00:00:00.000000000 Z
+dependencies: []
+description: Assess glass thermal shock risk and water-fed pole solution freeze feasibility
+  for residential window cleaning in cold-weather Northern Ontario conditions.
+email:
+- service@binx.ca
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/residential_window_cleaning_2026.rb
+homepage: https://www.binx.ca/residential-windows.php
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/veronica_caledon/residential-window-cleaning-2026
+  documentation_uri: https://residential-window-cleaning-2026.readthedocs.io
+  homepage_uri: https://www.binx.ca/residential-windows.php
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.20
+signing_key:
+specification_version: 4
+summary: Thermal shock risk and WFP freeze-point calculator for cold-weather residential
+  window cleaning
+test_files: []