tbd 3.3.0 → 3.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 840a07d7ac8aab45d2c2e377c9aecfc7bfb6e02a2aa00736bd3d07da271d619e
-  data.tar.gz: 0f41e81875c54f81c00e8788b40569bde04e75233fd3a7d1f9b5e905aecf866c
+  metadata.gz: 4d894d405f77c1eb33517cb957ca0a9a8f87319841c983047acdb8055aa5d79c
+  data.tar.gz: 6788f593ac0bb66c52b81d0be2f5140dd6c4ef9c6dfb0f9df5e684bdd41c714a
 SHA512:
-  metadata.gz: bf7839e2518c1fdff231b7f9ad9ac8a8b8fd6a2e3ca79e7441ca58c5c8d6dcf22d64ee6414fecd9160ec0cc1203f1a07ec862e7337ed27b1812f0ef59617d94b
-  data.tar.gz: f3fe90266432320e562a7119a4f11c9097cb958533c4b9e1c53089330b2fd79ca15884c798f9f49f3cb751ca8374f10801f77a0b070f8f039c242e4874338863
+  metadata.gz: 753541a1202a93df6346b8ce164679fbecdce11413d017977d62f9edb386ad0ab03e8b4b2a43be00eac01f0b0d3f45f9f4c91d9ec3db9c5e34a482a2b45a3600
+  data.tar.gz: 945278734bc73490690e8fdc37e0bf9fe910ea29f4eef43370234f76f3032c8f0d25cf38a648ffde44f990db39c17fcc0fc115662dc4150b4fa1b0c5df8a8776

data/.github/workflows/pull_request.yml

@@ -111,8 +111,8 @@ jobs:
       run: |
         echo $(pwd)
         echo $(ls)
-        docker pull nrel/openstudio:dev-3.7.0-alpha
-        docker run --name test --rm -d -t -v $(pwd):/work -w /work nrel/openstudio:dev-3.7.0-alpha
+        docker pull nrel/openstudio:3.7.0
+        docker run --name test --rm -d -t -v $(pwd):/work -w /work nrel/openstudio:3.7.0
         docker exec -t test pwd
         docker exec -t test ls
         docker exec -t test bundle update

data/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020-2023 Denis Bourgeois & Dan Macumber
+Copyright (c) 2020-2024 Denis Bourgeois & Dan Macumber
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/json/tbd_z5.json

@@ -0,0 +1,12 @@
+{
+  "schema": "https://github.com/rd2/tbd/blob/master/tbd.schema.json",
+  "description": "testing TBD JSON for 5Zone (plenum)",
+  "psis": [{
+      "id": "salk",
+      "ceiling": 0.1
+  }],
+  "spaces": [{
+    "id": "PLENUM-1",
+    "psi": "salk"
+  }]
+}

data/lib/measures/tbd/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020-2023 Denis Bourgeois & Dan Macumber
+Copyright (c) 2020-2024 Denis Bourgeois & Dan Macumber
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/lib/measures/tbd/measure.rb

@@ -1,6 +1,6 @@
 # MIT License
 #
-# Copyright (c) 2020-2023 Denis Bourgeois & Dan Macumber
+# Copyright (c) 2020-2024 Denis Bourgeois & Dan Macumber
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal

data/lib/measures/tbd/measure.xml

@@ -3,8 +3,8 @@
   <schema_version>3.1</schema_version>
   <name>tbd_measure</name>
   <uid>8890787b-8c25-4dc8-8641-b6be1b6c2357</uid>
-  <version_id>80f7038a-762a-4f4d-81f4-f4e9daa64925</version_id>
-  <version_modified>2023-10-22T13:14:49Z</version_modified>
+  <version_id>4eec2792-b3ef-4152-95c8-a7dd6a6bf9c4</version_id>
+  <version_modified>2024-04-17T14:29:06Z</version_modified>
   <xml_checksum>99772807</xml_checksum>
   <class_name>TBDMeasure</class_name>
   <display_name>Thermal Bridging and Derating - TBD</display_name>
@@ -464,7 +464,7 @@
       <filename>LICENSE.md</filename>
       <filetype>md</filetype>
       <usage_type>license</usage_type>
-      <checksum>A91E64A0</checksum>
+      <checksum>5C9BFB50</checksum>
     </file>
     <file>
       <filename>README.md</filename>
@@ -493,13 +493,13 @@
       <filename>measure.rb</filename>
       <filetype>rb</filetype>
       <usage_type>script</usage_type>
-      <checksum>D1FC18B2</checksum>
+      <checksum>A472E915</checksum>
     </file>
     <file>
       <filename>geo.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>7A491A3B</checksum>
+      <checksum>6C7ACC99</checksum>
     </file>
     <file>
       <filename>geometry.rb</filename>
@@ -517,19 +517,19 @@
       <filename>oslog.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>E4978588</checksum>
+      <checksum>8CD57B9A</checksum>
     </file>
     <file>
       <filename>psi.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>0CBB060B</checksum>
+      <checksum>5ABDEC60</checksum>
     </file>
     <file>
       <filename>tbd.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>A4E8433C</checksum>
+      <checksum>E8D38E59</checksum>
     </file>
     <file>
       <filename>transformation.rb</filename>
@@ -541,13 +541,13 @@
       <filename>ua.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>1AEE3C54</checksum>
+      <checksum>928C5E7B</checksum>
     </file>
     <file>
       <filename>utils.rb</filename>
       <filetype>rb</filetype>
       <usage_type>resource</usage_type>
-      <checksum>7385DFE0</checksum>
+      <checksum>E3B4AF4B</checksum>
     </file>
     <file>
       <filename>version.rb</filename>
@@ -565,7 +565,7 @@
       <filename>tbd_tests.rb</filename>
       <filetype>rb</filetype>
       <usage_type>test</usage_type>
-      <checksum>85067AF6</checksum>
+      <checksum>2ECE06CA</checksum>
     </file>
   </files>
 </measure>

data/lib/measures/tbd/resources/geo.rb

@@ -1,6 +1,6 @@
 # MIT License
 #
-# Copyright (c) 2020-2023 Denis Bourgeois & Dan Macumber
+# Copyright (c) 2020-2024 Denis Bourgeois & Dan Macumber
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -251,7 +251,7 @@ module TBD
   #
   # @return [Topolys::Vector3D] true normal vector of s
   # @return [nil] if invalid input (see logs)
-  def trueNormal(s = nil, r = 0)
+  def truNormal(s = nil, r = 0)
     mth = "TBD::#{__callee__}"
     cl  = OpenStudio::Model::PlanarSurface
     return mismatch("surface", s, cl, mth)   unless s.is_a?(cl)
@@ -285,18 +285,18 @@ module TBD
     surf   = {}
     subs   = {}
     fd     = false
-    return invalid("#{nom}",     mth, 1, FTL) if poly(surface).empty?
+    return invalid("#{nom}",     mth, 1, ERR) if poly(surface).empty?
     return empty("#{nom} space", mth,    ERR) if surface.space.empty?
 
     space  = surface.space.get
     stype  = space.spaceType
     story  = space.buildingStory
     tr     = transforms(space)
-    return   invalid("#{nom} transform", mth, 0, FTL) unless tr[:t] && tr[:r]
+    return   invalid("#{nom} transform", mth, 0, ERR) unless tr[:t] && tr[:r]
 
     t      = tr[:t]
-    n      = trueNormal(surface, tr[:r])
-    return   invalid("#{nom} normal", mth, 0, FTL) unless n
+    n      = truNormal(surface, tr[:r])
+    return   invalid("#{nom} normal", mth, 0, ERR) unless n
 
     type   = surface.surfaceType.downcase
     facing = surface.outsideBoundaryCondition
@@ -347,6 +347,7 @@ module TBD
 
     surf[:conditioned] = surf.key?(:heating) || surf.key?(:cooling)
     surf[:space      ] = space
+    surf[:occupied   ] = space.partofTotalFloorArea
     surf[:boundary   ] = facing
     surf[:ground     ] = surface.isGroundSurface
     surf[:type       ] = :floor

data/lib/measures/tbd/resources/oslog.rb

@@ -1,6 +1,6 @@
 # BSD 3-Clause License
 #
-# Copyright (c) 2022-2023, Denis Bourgeois
+# Copyright (c) 2022-2024, Denis Bourgeois
 # All rights reserved.
 #
 # Redistribution and use in source and binary forms, with or without

data/lib/measures/tbd/resources/psi.rb

@@ -1,6 +1,6 @@
 # MIT License
 #
-# Copyright (c) 2020-2023 Denis Bourgeois & Dan Macumber
+# Copyright (c) 2020-2024 Denis Bourgeois & Dan Macumber
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -156,6 +156,7 @@ module TBD
         rimjoist:        1.000000, # re: BETBG
         parapet:         0.800000, # re: BETBG
         roof:            0.800000, # same as parapet
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.500000, # re: BETBG
         door:            0.500000, # inferred, same as (vertical) fenestration
         skylight:        0.500000, # inferred, same as (vertical) fenestration
@@ -176,6 +177,7 @@ module TBD
         rimjoist:        0.500000, # re: BETBG
         parapet:         0.450000, # re: BETBG
         roof:            0.450000, # same as parapet
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.350000, # re: BETBG
         door:            0.350000, # inferred, same as (vertical) fenestration
         skylight:        0.350000, # inferred, same as (vertical) fenestration
@@ -196,6 +198,7 @@ module TBD
         rimjoist:        0.200000, # re: BETBG
         parapet:         0.200000, # re: BETBG
         roof:            0.200000, # same as parapet
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.199999, # re: BETBG
         door:            0.199999, # inferred, same as (vertical) fenestration
         skylight:        0.199999, # inferred, same as (vertical) fenestration
@@ -216,6 +219,7 @@ module TBD
         rimjoist:        0.615000, # Detail 1.2.1
         parapet:         1.000000, # Detail 1.3.2
         roof:            1.000000, # same as parapet
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.000000, # inferred, generally part of clear-field RSi
         door:            0.000000, # inferred, generally part of clear-field RSi
         skylight:        0.350000, # same as "regular (BETBG)"
@@ -236,6 +240,7 @@ module TBD
         rimjoist:        0.170000, # Detail 1.2.7
         parapet:         0.660000, # Detail 1.3.2
         roof:            0.660000, # same as parapet
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.000000, # inferred, generally part of clear-field RSi
         door:            0.000000, # inferred, generally part of clear-field RSi
         skylight:        0.350000, # same as "regular (BETBG)"
@@ -256,6 +261,7 @@ module TBD
         rimjoist:        0.300000, # re I1
         parapet:         0.325000, # re I1
         roof:            0.325000, # same as parapet
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.200000, # re I1
         door:            0.200000, # re I1
         skylight:        0.200000, # re I1
@@ -276,6 +282,7 @@ module TBD
         rimjoist:        0.850000, # re I1
         parapet:         0.800000, # re I1
         roof:            0.800000, # same as parapet
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.500000, # re I1
         door:            0.500000, # re I1
         skylight:        0.500000, # re I1
@@ -296,6 +303,7 @@ module TBD
         rimjoist:        0.307000, # "intermediate floor to wall intersection"
         parapet:         0.260000, # "parapet" edge
         roof:            0.020000, # (non-parapet) "roof" edge
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.194000, # "wall to vertical fenestration intersection"
         door:            0.000000, # (unspecified, defaults to 0)
         skylight:        0.000000, # (unspecified, defaults to 0)
@@ -316,6 +324,7 @@ module TBD
         rimjoist:        0.842000, # "intermediate floor to wall intersection"
         parapet:         0.500000, # "parapet" edge
         roof:            0.650000, # (non-parapet) "roof" edge
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.505000, # "wall to vertical fenestration intersection"
         door:            0.000000, # (unspecified, defaults to 0)
         skylight:        0.000000, # (unspecified, defaults to 0)
@@ -336,6 +345,7 @@ module TBD
         rimjoist:        0.205000, # "intermediate floor to wall intersection"
         parapet:         0.217000, # "parapet" edge
         roof:            0.150000, # (non-parapet) "roof" edge
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.226000, # "wall to vertical fenestration intersection"
         door:            0.000000, # (unspecified, defaults to 0)
         skylight:        0.000000, # (unspecified, defaults to 0)
@@ -356,6 +366,7 @@ module TBD
         rimjoist:        0.824000, # "intermediate floor to wall intersection"
         parapet:         0.412000, # "parapet" edge
         roof:            0.750000, # (non-parapet) "roof" edge
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.325000, # "wall to vertical fenestration intersection"
         door:            0.000000, # (unspecified, defaults to 0)
         skylight:        0.000000, # (unspecified, defaults to 0)
@@ -376,6 +387,7 @@ module TBD
         rimjoist:        0.495000, # "intermediate floor to wall intersection"
         parapet:         0.393000, # "parapet" edge
         roof:            0.150000, # (non-parapet) "roof" edge
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.143000, # "wall to vertical fenestration intersection"
         door:            0.000000, # (unspecified, defaults to 0)
         skylight:        0.000000, # (unspecified, defaults to 0)
@@ -396,6 +408,7 @@ module TBD
         rimjoist:        0.824000, # "intermediate floor to wall intersection"
         parapet:         0.884000, # "parapet" edge
         roof:            0.750000, # (non-parapet) "roof" edge
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.543000, # "wall to vertical fenestration intersection"
         door:            0.000000, # (unspecified, defaults to 0)
         skylight:        0.000000, # (unspecified, defaults to 0)
@@ -416,6 +429,7 @@ module TBD
         rimjoist:        0.084000, # "intermediate floor to wall intersection"
         parapet:         0.056000, # "parapet" edge
         roof:            0.020000, # (non-parapet) "roof" edge
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.171000, # "wall to vertical fenestration intersection"
         door:            0.000000, # (unspecified, defaults to 0)
         skylight:        0.000000, # (unspecified, defaults to 0)
@@ -436,6 +450,7 @@ module TBD
         rimjoist:        0.582000, # "intermediate floor to wall intersection"
         parapet:         0.056000, # "parapet" edge
         roof:            0.150000, # (non-parapet) "roof" edge
+        ceiling:         0.000000, # e.g. suspended ceiling tiles
         fenestration:    0.260000, # "wall to vertical fenestration intersection"
         door:            0.000000, # (unspecified, defaults to 0)
         skylight:        0.000000, # (unspecified, defaults to 0)
@@ -452,20 +467,22 @@ module TBD
 
       @set["(non thermal bridging)"] =
       {
-        rimjoist:     0.000000, # defaults to 0
-        parapet:      0.000000, # defaults to 0
-        roof:         0.000000, # defaults to 0
-        fenestration: 0.000000, # defaults to 0
-        door:         0.000000, # defaults to 0
-        skylight:     0.000000, # defaults to 0
-        spandrel:     0.000000, # defaults to 0
-        corner:       0.000000, # defaults to 0
-        balcony:      0.000000, # defaults to 0
-        balconysill:  0.000000, # defaults to 0
-        party:        0.000000, # defaults to 0
-        grade:        0.000000, # defaults to 0
-        joint:        0.000000, # defaults to 0
-        transition:   0.000000  # defaults to 0
+        rimjoist:        0.000000, # defaults to 0
+        parapet:         0.000000, # defaults to 0
+        roof:            0.000000, # defaults to 0
+        ceiling:         0.000000, # defaults to 0
+        fenestration:    0.000000, # defaults to 0
+        door:            0.000000, # defaults to 0
+        skylight:        0.000000, # defaults to 0
+        spandrel:        0.000000, # defaults to 0
+        corner:          0.000000, # defaults to 0
+        balcony:         0.000000, # defaults to 0
+        balconysill:     0.000000, # defaults to 0
+        balconydoorsill: 0.000000, # defaults to 0
+        party:           0.000000, # defaults to 0
+        grade:           0.000000, # defaults to 0
+        joint:           0.000000, # defaults to 0
+        transition:      0.000000  # defaults to 0
       }.freeze
 
       @set.keys.each { |k| self.gen(k) }
@@ -530,6 +547,9 @@ module TBD
       h[:roof                  ] = @set[id].key?(:roof)
       h[:roofconcave           ] = @set[id].key?(:roofconcave)
       h[:roofconvex            ] = @set[id].key?(:roofconvex)
+      h[:ceiling               ] = @set[id].key?(:ceiling)
+      h[:ceilingconcave        ] = @set[id].key?(:ceilingconcave)
+      h[:ceilingconvex         ] = @set[id].key?(:ceilingconvex)
       h[:grade                 ] = @set[id].key?(:grade)
       h[:gradeconcave          ] = @set[id].key?(:gradeconcave)
       h[:gradeconvex           ] = @set[id].key?(:gradeconvex)
@@ -562,6 +582,7 @@ module TBD
       v[:corner         ] = 0; v[:cornerconcave         ] = 0; v[:cornerconvex         ] = 0
       v[:parapet        ] = 0; v[:parapetconcave        ] = 0; v[:parapetconvex        ] = 0
       v[:roof           ] = 0; v[:roofconcave           ] = 0; v[:roofconvex           ] = 0
+      v[:ceiling        ] = 0; v[:ceilingconcave        ] = 0; v[:ceilingconvex        ] = 0
       v[:party          ] = 0; v[:partyconcave          ] = 0; v[:partyconvex          ] = 0
       v[:grade          ] = 0; v[:gradeconcave          ] = 0; v[:gradeconvex          ] = 0
       v[:balcony        ] = 0; v[:balconyconcave        ] = 0; v[:balconyconvex        ] = 0
@@ -697,6 +718,11 @@ module TBD
       v[:roofconvex            ] = @set[id][:roof                  ] if h[:roof                  ]
       v[:roofconcave           ] = @set[id][:roofconcave           ] if h[:roofconcave           ]
       v[:roofconvex            ] = @set[id][:roofconvex            ] if h[:roofconvex            ]
+      v[:ceiling               ] = @set[id][:ceiling               ] if h[:ceiling               ]
+      v[:ceilingconcave        ] = @set[id][:ceiling               ] if h[:ceiling               ]
+      v[:ceilingconvex         ] = @set[id][:ceiling               ] if h[:ceiling               ]
+      v[:ceilingconcave        ] = @set[id][:ceilingconcave        ] if h[:ceilingconcave        ]
+      v[:ceilingconvex         ] = @set[id][:ceilingconvex         ] if h[:ceilingconvex         ]
       v[:party                 ] = @set[id][:party                 ] if h[:party                 ]
       v[:partyconcave          ] = @set[id][:party                 ] if h[:party                 ]
       v[:partyconvex           ] = @set[id][:party                 ] if h[:party                 ]
@@ -764,6 +790,7 @@ module TBD
 
       max = [v[:roofconcave], v[:roofconvex]].max
       v[:roof] = max unless @has[:roof]
+
       @val[id] = v
 
       true
@@ -783,6 +810,9 @@ module TBD
     # @option set [#to_f] :roof roof-to-wall intersection
     # @option set [#to_f] :roofconcave basilaire variant
     # @option set [#to_f] :roofconvex typical
+    # @option set [#to_f] :ceiling intermediate (uninsulated) ceiling perimeter
+    # @option set [#to_f] :ceilingconcave cantilever variant
+    # @option set [#to_f] :ceilingconvex colonnade variant
     # @option set [#to_f] :fenestration head/sill/jamb interface
     # @option set [#to_f] :head (fenestrated) header interface
     # @option set [#to_f] :headconcave (fenestrated) basilaire variant
@@ -870,6 +900,9 @@ module TBD
       s[:roof                  ] = set[:roof                  ] if set.key?(:roof)
       s[:roofconcave           ] = set[:roofconcave           ] if set.key?(:roofconcave)
       s[:roofconvex            ] = set[:roofconvex            ] if set.key?(:roofconvex)
+      s[:ceiling               ] = set[:ceiling               ] if set.key?(:ceiling)
+      s[:ceilingconcave        ] = set[:ceilingconcave        ] if set.key?(:ceilingconcave)
+      s[:ceilingconvex         ] = set[:ceilingconvex         ] if set.key?(:ceilingconvex)
       s[:fenestration          ] = set[:fenestration          ] if set.key?(:fenestration)
       s[:head                  ] = set[:head                  ] if set.key?(:head)
       s[:headconcave           ] = set[:headconcave           ] if set.key?(:headconcave)
@@ -926,6 +959,7 @@ module TBD
 
       s[:joint                 ] = 0.000  unless set.key?(:joint)
       s[:transition            ] = 0.000  unless set.key?(:transition)
+      s[:ceiling               ] = 0.000  unless set.key?(:ceiling)
 
       @set[id] = s
       self.gen(id)
@@ -941,13 +975,13 @@ module TBD
     #
     # @param id [#to_s] PSI set identifier
     # @example intermediate floor slab intersection
-    #   shorthands("A901")
+    #   shorthands("90.1.22|steel.m|default")
     #
     # @return [Hash] has: Hash (Bool), val: Hash (PSI factors) see logs if empty
     def shorthands(id = "")
       mth = "TBD::#{__callee__}"
       sh  = { has: {}, val: {} }
-      id = trim(id)
+      id  = trim(id)
       return mismatch("set ID", id, String, mth, ERR, a)      if id.empty?
       return hashkey(id, @set , id,         mth, ERR, sh) unless @set.key?(id)
       return hashkey(id, @has , id,         mth, ERR, sh) unless @has.key?(id)
@@ -969,7 +1003,7 @@ module TBD
     def complete?(id = "")
       mth = "TBD::#{__callee__}"
       a   = false
-      id = trim(id)
+      id  = trim(id)
       return mismatch("set ID", id, String, mth, ERR, a)     if id.empty?
       return hashkey(id, @set , id,         mth, ERR, a) unless @set.key?(id)
       return hashkey(id, @has , id,         mth, ERR, a) unless @has.key?(id)
@@ -1564,14 +1598,14 @@ module TBD
       tr      = transforms(group)
       t       = tr[:t] if tr[:t] && tr[:r]
 
-      log(FTL, "Can't process '#{id}' transformation (#{mth})") unless t
-      return tbd                                                unless t
+      log(ERR, "Can't process '#{id}' transformation (#{mth})") unless t
+      next                                                      unless t
 
       space   = group.space
       tr[:r] += space.get.directionofRelativeNorth unless space.empty?
-      n       = trueNormal(s, tr[:r])
-      log(FTL, "Can't process '#{id}' true normal (#{mth})") unless n
-      return tbd                                             unless n
+      n       = truNormal(s, tr[:r])
+      log(ERR, "Can't process '#{id}' true normal (#{mth})") unless n
+      next                                                   unless n
 
       points = (t * s.vertices).map { |v| Topolys::Point3D.new(v.x, v.y, v.z) }
 
@@ -1661,14 +1695,10 @@ module TBD
       dx         = (origin.x - terminal.x).abs
       dy         = (origin.y - terminal.y).abs
       dz         = (origin.z - terminal.z).abs
-      horizontal = dz.abs < TOL
+      horizontal = dz < TOL
       vertical   = dx < TOL && dy < TOL
       edge_V     = terminal - origin
-
-      if edge_V.magnitude < TOL
-        invalid("1x edge length < TOL", mth, 0, ERROR)
-        next
-      end
+      next if edge_V.magnitude < TOL
 
       edge_plane = Topolys::Plane3D.new(origin, edge_V)
 
@@ -1732,10 +1762,8 @@ module TBD
             farthest_V = origin_point_V if farther
           end
 
-          angle = reference_V.angle(farthest_V)
-          invalid("#{id} polar angle", mth, 0, ERROR, 0) if angle.nil?
-          angle = 0                                      if angle.nil?
-
+          angle  = reference_V.angle(farthest_V)
+          angle  = 0 if angle.nil?
           adjust = false # adjust angle [180°, 360°] if necessary
 
           if vertical
@@ -1853,9 +1881,6 @@ module TBD
 
         # Evaluate current set content before processing a new linked surface.
         is                    = {}
-        is[:head            ] = set.keys.to_s.include?("head")
-        is[:sill            ] = set.keys.to_s.include?("sill")
-        is[:jamb            ] = set.keys.to_s.include?("jamb")
         is[:doorhead        ] = set.keys.to_s.include?("doorhead")
         is[:doorsill        ] = set.keys.to_s.include?("doorsill")
         is[:doorjamb        ] = set.keys.to_s.include?("doorjamb")
@@ -1866,6 +1891,7 @@ module TBD
         is[:corner          ] = set.keys.to_s.include?("corner")
         is[:parapet         ] = set.keys.to_s.include?("parapet")
         is[:roof            ] = set.keys.to_s.include?("roof")
+        is[:ceiling         ] = set.keys.to_s.include?("ceiling")
         is[:party           ] = set.keys.to_s.include?("party")
         is[:grade           ] = set.keys.to_s.include?("grade")
         is[:balcony         ] = set.keys.to_s.include?("balcony")
@@ -1873,6 +1899,12 @@ module TBD
         is[:balconydoorsill ] = set.keys.to_s.include?("balconydoorsill")
         is[:rimjoist        ] = set.keys.to_s.include?("rimjoist")
 
+        if is.empty?
+          is[:head] = set.keys.to_s.include?("head")
+          is[:sill] = set.keys.to_s.include?("sill")
+          is[:jamb] = set.keys.to_s.include?("jamb")
+        end
+
         # Label edge as ...
         #         :head,         :sill,         :jamb (vertical fenestration)
         #     :doorhead,     :doorsill,     :doorjamb (opaque door)
@@ -2092,6 +2124,41 @@ module TBD
            is[:corner       ] = true
         end
 
+        # Label edge as :ceiling if linked to:
+        #   +1 deratable surfaces
+        #   1x underatable CONDITIONED floor linked to an unoccupied space
+        #   1x adjacent CONDITIONED ceiling linked to an occupied space
+        edge[:surfaces].keys.each do |i|
+          break     if is[:ceiling]
+          break unless deratables.size > 0
+          break     if floors.key?(id)
+          next      if i == id
+          next  unless floors.key?(i)
+          next      if floors[i][:ground     ]
+          next  unless floors[i][:conditioned]
+          next      if floors[i][:occupied   ]
+
+          ceiling = floors[i][:boundary]
+          next  unless ceilings.key?(ceiling)
+          next  unless ceilings[ceiling][:conditioned]
+          next  unless ceilings[ceiling][:occupied   ]
+
+          other = deratables.first unless deratables.first == id
+          other = deratables.last  unless deratables.last  == id
+          other = id                   if deratables.size  == 1
+
+          s1      = edge[:surfaces][id]
+          s2      = edge[:surfaces][other]
+          concave = concave?(s1, s2)
+          convex  = convex?(s1, s2)
+          flat    = !concave && !convex
+
+          set[:ceiling       ] = shorts[:val][:ceiling       ] if flat
+          set[:ceilingconcave] = shorts[:val][:ceilingconcave] if concave
+          set[:ceilingconvex ] = shorts[:val][:ceilingconvex ] if convex
+           is[:ceiling       ] = true
+        end
+
         # Label edge as :parapet/:roof if linked to:
         #   1x deratable wall
         #   1x deratable ceiling
@@ -2172,22 +2239,23 @@ module TBD
            is[:grade       ] = true
         end
 
-        # Label edge as :rimjoist, :balcony, :balconysill or :balconydoorsill if linked to:
+        # Label edge as :rimjoist, :balcony, :balconysill or :balconydoorsill,
+        # if linked to:
         #   1x deratable surface
         #   1x CONDITIONED floor
         #   1x shade (optional)
         #   1x subsurface (optional)
-        #
-        # Despite referring to 'sill' or 'doorsill', a 'balconysill' or
-        # 'balconydoorsill' edge may instead link (rarer) cases of balcony and a
-        # fenestratio/door head. ASHRAE 90.1 2022 does not make the distinction
-        # between sill vs head when intermediatre floor, balcony and vertical
-        # fenestration meet. 'Sills' are simply the most common occurrence.
         balcony         = false
         balconysill     = false # vertical fenestration
         balconydoorsill = false # opaque door
 
+        # Despite referring to 'sill' or 'doorsill', a 'balconysill' or
+        # 'balconydoorsill' edge may instead link (rarer) cases of balcony and a
+        # fenestration/door head. ASHRAE 90.1 2022 does not make the distinction
+        # between sill vs head when intermediate floor, balcony and vertical
+        # fenestration meet. 'Sills' are simply the most common occurrence.
         edge[:surfaces].keys.each do |i|
+          break if is[:ceiling]
           break if balcony
           next  if i == id
 
@@ -2259,15 +2327,17 @@ module TBD
         end
 
         edge[:surfaces].keys.each do |i|
-          break     if is[:rimjoist   ] || is[:balcony        ] ||
-                       is[:balconysill] || is[:balconydoorsill]
+          break     if is[:ceiling        ]
+          break     if is[:rimjoist       ]
+          break     if is[:balcony        ]
+          break     if is[:balconysill    ]
+          break     if is[:balconydoorsill]
           break unless deratables.size > 0
           break     if floors.key?(id)
           next      if i == id
           next  unless floors.key?(i)
-          next  unless floors[i].key?(:conditioned)
-          next  unless floors[i][:conditioned]
           next      if floors[i][:ground     ]
+          next  unless floors[i][:conditioned]
 
           other = deratables.first unless deratables.first == id
           other = deratables.last  unless deratables.last  == id

data/lib/measures/tbd/resources/tbd.rb

@@ -1,6 +1,6 @@
 # MIT License
 #
-# Copyright (c) 2020-2023 Denis Bourgeois & Dan Macumber
+# Copyright (c) 2020-2024 Denis Bourgeois & Dan Macumber
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal

data/lib/measures/tbd/resources/ua.rb

@@ -1,6 +1,6 @@
 # MIT License
 #
-# Copyright (c) 2020-2023 Denis Bourgeois & Dan Macumber
+# Copyright (c) 2020-2024 Denis Bourgeois & Dan Macumber
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"), to deal
@@ -1000,7 +1000,7 @@ module TBD
       model  = "* modèle : #{ua[:file]}"    if ua.key?(:file)  && lang == :fr
       model += " (v#{ua[:version]})"        if ua.key?(:version)
       report << model                   unless model.empty?
-      report << "* TBD : v3.3.0"
+      report << "* TBD : v3.4.0"
       report << "* date : #{ua[:date]}"
 
       if lang == :en