honeybee-openstudio 2.6.9 → 2.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9807e9ab401382c3e1b8e98b86e5fe65c3efa5172ddd77103964f5bf69a7a8b
-  data.tar.gz: bec119606bedf177e4d6c77a80f6768fddd248545c73082d5808d0245724611c
+  metadata.gz: 0c308040a73a632d6641d26c48070ce70d7d5330759f4a7f218c8f28b59eb22f
+  data.tar.gz: 9e07605c838a6f27c172aafb9e86bf2182d038b15b50009328eb8c2a0c9e9051
 SHA512:
-  metadata.gz: 3a68b8ffb0e9cbf31578366fde5120249016529862a1c984339b3946110c7a526de5375291d22e43f2fd565655dda0ddf1310eeec11d9d17b7c2000677e0214e
-  data.tar.gz: 8fddadbc9346bc173447a88a747dc4cd424966d4050a686be799fe52b64643977efe4d33b8e83269b395fc9b4233e9f08ff810a854b10c10b69e9281b0c9c982
+  metadata.gz: 120ea2c1d4b8f7d9cfef3d504ac0a10de92672d0e51866016503e65b5af020b89c8971599d758b0e06530ee9937bb0b3c3b0b68ca07cc491fa3aa81f47538948
+  data.tar.gz: fb9ae57299da465ae81a8a6e1c758842cd616f1ab5623a80d53b8c6f1166bf528ce32ae6d1a6e3ebc6b56fe7ee47c39f20927ce937f065237bf14ddade7a7125

data/.github/workflows/pull_request.yaml

@@ -0,0 +1,25 @@
+name: Pull Request CI
+
+on:
+  pull_request:
+    branches:
+      - master
+      - develop
+
+jobs:
+  test_3x:
+    runs-on: ubuntu-18.04
+    steps:
+    - name: Check out repository
+      uses: actions/checkout@v2
+    - name: Run Tests
+      run: |
+        echo $(pwd)
+        echo $(ls)
+        docker pull nrel/openstudio:3.1.0
+        docker run --name test --rm -d -t -v $(pwd):/work -w /work nrel/openstudio:3.1.0
+        docker exec -t test pwd
+        docker exec -t test ls
+        docker exec -t test bundle update
+        docker exec -t test bundle exec rake
+        docker kill test

data/.gitignore

@@ -7,6 +7,7 @@
 /coverage/
 /doc/
 /pkg/
+/spec/output/
 /spec/reports/
 /spec/test/
 /tmp/

data/README.md

@@ -18,15 +18,15 @@ parameter JSON files to the measures. Here is a sample where the items in parent
 should be replaced with specific file paths:
 
 ```
-{ 
-    "measure_paths": [(PATH TO THIS REPOSITORY)/lib/measures"], 
+{
+    "measure_paths": [(PATH TO THIS REPOSITORY)/lib/measures"],
     "steps": [
         {
-            "arguments": {"model_json": (PATH TO MODEL JSON)}, 
+            "arguments": {"model_json": (PATH TO MODEL JSON)},
             "measure_dir_name": "from_honeybee_model"
-        }, 
+        },
         {
-            "arguments": {"simulation_parameter_json": (PATH TO SIMULATION PARAMETER JSON)}, 
+            "arguments": {"simulation_parameter_json": (PATH TO SIMULATION PARAMETER JSON)},
             "measure_dir_name": "from_honeybee_simulation_parameter"
         }
     ]

data/Rakefile

@@ -8,14 +8,9 @@ RuboCop::RakeTask.new
 
 # Load in the rake tasks from the base openstudio-extension gem
 require 'openstudio/extension/rake_task'
-require 'from_honeybee/extension'
-#require 'from_honeybee/simulation/extension'
+require 'honeybee/extension'
 
 os_extension = OpenStudio::Extension::RakeTask.new
-os_extension.set_extension_class(FromHoneybee::Extension)
-
-#TODO: Does this need to be implemented?
-#os_extension.set_extension_class(FromHoneybee::ExtensionSimulationParameter)
+os_extension.set_extension_class(Honeybee::Extension)
 
 task default: :spec
- 

data/doc_templates/README.md.erb

@@ -0,0 +1,42 @@
+<%#= README.md.erb is used to auto-generate README.md. %>
+<%#= To manually maintain README.md throw away README.md.erb and manually edit README.md %>
+###### (Automatically generated documentation)
+
+# <%= name %>
+
+## Description
+<%= description %>
+
+## Modeler Description
+<%= modelerDescription %>
+
+## Measure Type
+<%= measureType %>
+
+## Taxonomy
+<%= taxonomy %>
+
+## Arguments
+
+<% arguments.each do |argument| %>
+### <%= argument[:display_name] %>
+<%= argument[:description] %>
+**Name:** <%= argument[:name] %>,
+**Type:** <%= argument[:type] %>,
+**Units:** <%= argument[:units] %>,
+**Required:** <%= argument[:required] %>,
+**Model Dependent:** <%= argument[:model_dependent] %>
+<% end %>
+
+<% if arguments.size == 0 %>
+<%= "This measure does not have any user arguments" %>
+<% end %>
+
+<% if outputs.size > 0 %>
+## Outputs
+<% output_names = [] %>
+<% outputs.each do |output| %>
+<% output_names << output[:display_name] %>
+<% end %>
+<%= output_names.join(", ") %>
+<% end %>

data/doc_templates/copyright_erb.txt

@@ -1,8 +1,8 @@
 <%
   # *******************************************************************************
-  # Honeybee OpenStudio Gem, Copyright (c) 2020, Alliance for Sustainable 
+  # Honeybee OpenStudio Gem, Copyright (c) 2020, Alliance for Sustainable
   # Energy, LLC, Ladybug Tools LLC and other contributors. All rights reserved.
-  # 
+  #
   # Redistribution and use in source and binary forms, with or without
   # modification, are permitted provided that the following conditions are met:
   #

data/doc_templates/copyright_ruby.txt

@@ -1,7 +1,7 @@
 # *******************************************************************************
-# Honeybee OpenStudio Gem, Copyright (c) 2020, Alliance for Sustainable 
+# Honeybee OpenStudio Gem, Copyright (c) 2020, Alliance for Sustainable
 # Energy, LLC, Ladybug Tools LLC and other contributors. All rights reserved.
-# 
+#
 # Redistribution and use in source and binary forms, with or without
 # modification, are permitted provided that the following conditions are met:
 #

data/honeybee-openstudio.gemspec

@@ -4,7 +4,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 
 Gem::Specification.new do |spec|
   spec.name          = 'honeybee-openstudio'
-  spec.version       = '2.6.9'
+  spec.version       = '2.7.0'
   spec.authors       = ['Tanushree Charan', 'Dan Macumber', 'Chris Mackey', 'Mostapha Sadeghipour Roudsari']
   spec.email         = ['tanushree.charan@nrel.gov', 'chris@ladybug.tools']
 
@@ -21,14 +21,18 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_development_dependency 'bundler', '~> 2.1'
-  spec.add_development_dependency 'rake', '13.0'
-  spec.add_development_dependency 'rspec', '3.9'
-  spec.add_development_dependency 'rubocop', '~> 0.54.0'
+  if /^2.5/.match(RUBY_VERSION)
+    spec.required_ruby_version = "~> 2.5.0"
+
+    spec.add_development_dependency "bundler",        "~> 2.1"
+    spec.add_development_dependency "public_suffix",  "~> 3.1.1"
+    spec.add_development_dependency "json-schema",    "~> 2.8.1"
+    spec.add_development_dependency "rake",           "~> 13.0"
+    spec.add_development_dependency "rspec",          "~> 3.9"
+    spec.add_development_dependency "rubocop",        "~> 0.54.0"
+  end
 
-  spec.add_dependency 'json-schema'
   spec.add_dependency 'json_pure'
   spec.add_dependency 'openstudio-extension', '0.2.3'
   spec.add_dependency 'openstudio-standards', '~> 0.2.11'
-  spec.add_dependency 'public_suffix', '~> 3.1.1'
 end

data/lib/files/Honeybee.rb

@@ -1,7 +1,7 @@
 # *******************************************************************************
-# Honeybee OpenStudio Gem, Copyright (c) 2020, Alliance for Sustainable 
+# Honeybee OpenStudio Gem, Copyright (c) 2020, Alliance for Sustainable
 # Energy, LLC, Ladybug Tools LLC and other contributors. All rights reserved.
-# 
+#
 # Redistribution and use in source and binary forms, with or without
 # modification, are permitted provided that the following conditions are met:
 #
@@ -49,7 +49,7 @@ module URBANopt
         # do initialization of class variables in thread safe way
         @@instance_lock.synchronize do
             if @@osw.nil?
-  
+
               # load the OSW for this class
               osw_path = File.join(File.dirname(__FILE__), 'honeybee_workflow.osw')
               File.open(osw_path, 'r') do |file|
@@ -74,7 +74,7 @@ module URBANopt
         feature_name = feature.name
         if feature_names.size == 1
           feature_name = feature_names[0]
-        end        
+        end
 
         # deep clone of @@osw before we configure it
         osw = Marshal.load(Marshal.dump(@@osw))
@@ -84,7 +84,7 @@ module URBANopt
         osw[:description] = feature_name
 
         if feature_type == 'Building'
-            # set the honeybee JSON key to the from_honeybee_model measure
+            # set the honeybee JSON key to the honeybee_model measure
             OpenStudio::Extension.set_measure_argument(
                 osw, 'from_honeybee_model', 'model_json', feature.detailed_model_filename)
 
@@ -95,7 +95,7 @@ module URBANopt
               OpenStudio::Extension.set_measure_argument(
                   osw, 'create_typical_building_from_model', 'system_type', system_type)
             end
-            
+
             # add the feature id and name to the reporting measure
             OpenStudio::Extension.set_measure_argument(
               osw, 'default_feature_reports', 'feature_id', feature_id)
@@ -107,7 +107,7 @@ module URBANopt
         end
         return osw
       end
-    
+
     end #HoneybeeMapper
   end #Scenario
 end #URBANopt

data/lib/from_openstudio.rb

@@ -0,0 +1,49 @@
+# *******************************************************************************
+# Honeybee OpenStudio Gem, Copyright (c) 2020, Alliance for Sustainable
+# Energy, LLC, Ladybug Tools LLC and other contributors. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# (1) Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer.
+#
+# (2) Redistributions in binary form must reproduce the above copyright notice,
+# this list of conditions and the following disclaimer in the documentation
+# and/or other materials provided with the distribution.
+#
+# (3) Neither the name of the copyright holder nor the names of any contributors
+# may be used to endorse or promote products derived from this software without
+# specific prior written permission from the respective party.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) AND ANY CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S), ANY CONTRIBUTORS, THE
+# UNITED STATES GOVERNMENT, OR THE UNITED STATES DEPARTMENT OF ENERGY, NOR ANY OF
+# THEIR EMPLOYEES, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+# OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+# *******************************************************************************
+
+# import the honeybee objects which we will extend
+require 'honeybee'
+
+# extend the compound objects that house the other objects
+require 'from_openstudio/model'
+require 'from_openstudio/model_object'
+
+# extend the geometry objects
+require 'from_openstudio/geometry/aperture'
+require 'from_openstudio/geometry/door'
+require 'from_openstudio/geometry/face'
+require 'from_openstudio/geometry/room'
+require 'from_openstudio/geometry/shade'
+
+# extend the simulation objects
+require 'from_openstudio/simulation/design_day'
+require 'from_openstudio/simulation/parameter_model'
+require 'from_openstudio/simulation/simulation_output'

data/lib/from_openstudio/geometry/aperture.rb

@@ -0,0 +1,136 @@
+# *******************************************************************************
+# Honeybee OpenStudio Gem, Copyright (c) 2020, Alliance for Sustainable
+# Energy, LLC, Ladybug Tools LLC and other contributors. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# (1) Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer.
+#
+# (2) Redistributions in binary form must reproduce the above copyright notice,
+# this list of conditions and the following disclaimer in the documentation
+# and/or other materials provided with the distribution.
+#
+# (3) Neither the name of the copyright holder nor the names of any contributors
+# may be used to endorse or promote products derived from this software without
+# specific prior written permission from the respective party.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) AND ANY CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S), ANY CONTRIBUTORS, THE
+# UNITED STATES GOVERNMENT, OR THE UNITED STATES DEPARTMENT OF ENERGY, NOR ANY OF
+# THEIR EMPLOYEES, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+# OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+# *******************************************************************************
+
+require 'honeybee/geometry/aperture'
+
+require 'to_openstudio/model_object'
+
+module Honeybee
+  class Aperture < ModelObject
+
+    def self.from_sub_surface(sub_surface, site_transformation)
+      hash = {}
+      hash[:type] = 'Aperture'
+      hash[:identifier] = clean_identifier(sub_surface.nameString)
+      hash[:display_name] = sub_surface.nameString
+      hash[:user_data] = {handle: sub_surface.handle.to_s}
+      hash[:properties] = properties_from_sub_surface(sub_surface)
+      hash[:geometry] = geometry_from_sub_surface(sub_surface, site_transformation)
+      hash[:boundary_condition] = boundary_condition_from_sub_surface(sub_surface)
+
+      sub_surface_type = sub_surface.subSurfaceType
+      hash[:is_operable] = (sub_surface_type == 'OperableWindow')
+
+      indoor_shades = indoor_shades_from_sub_surface(sub_surface)
+      hash[:indoor_shades] = indoor_shades if !indoor_shades.empty?
+
+      outdoor_shades = outdoor_shades_from_sub_surface(sub_surface)
+      hash[:outdoor_shades] = outdoor_shades if !outdoor_shades.empty?
+
+      hash
+    end
+
+    def self.properties_from_sub_surface(sub_surface)
+      hash = {}
+      hash[:type] = 'AperturePropertiesAbridged'
+      hash[:energy] = energy_properties_from_sub_surface(sub_surface)
+      hash
+    end
+
+    def self.energy_properties_from_sub_surface(sub_surface)
+      hash = {}
+      hash[:type] = 'ApertureEnergyPropertiesAbridged'
+
+      construction = sub_surface.construction
+      if !construction.empty?
+        hash[:construction] = clean_identifier(construction.get.nameString)
+      end
+
+      hash
+    end
+
+    def self.geometry_from_sub_surface(sub_surface, site_transformation)
+      result = {}
+      result[:type] = 'Face3D'
+      result[:boundary] = []
+      vertices = site_transformation * sub_surface.vertices
+      vertices.each do |v|
+        result[:boundary] << [v.x, v.y, v.z]
+      end
+      result
+    end
+
+    def self.boundary_condition_from_sub_surface(sub_surface)
+      result = {}
+      surface = sub_surface.surface.get
+      surface_type = surface.surfaceType
+      adjacent_sub_surface = sub_surface.adjacentSubSurface
+      if !adjacent_sub_surface.empty?
+        adjacent_space = clean_identifier(adjacent_sub_surface.get.space.get.nameString)
+        adjacent_surface = clean_identifier(adjacent_sub_surface.get.surface.get.nameString)
+        adjacent_sub_surface = clean_identifier(adjacent_sub_surface.get.nameString)
+        result = {type: 'Surface', boundary_condition_objects: [adjacent_sub_surface, adjacent_surface, adjacent_space]}
+      elsif surface.isGroundSurface
+        result = {type: 'Ground'}
+      elsif surface_type == 'Adiabatic'
+        result = {type: 'Adiabatic'}
+      else
+        sun_exposure = (surface.sunExposure == 'SunExposed')
+        wind_exposure = (surface.windExposure == 'WindExposed')
+        view_factor = sub_surface.viewFactortoGround
+        if view_factor.empty?
+          view_factor = {type: 'Autocalculate'}
+        else
+          view_factor = view_factor.get
+        end
+        result = {type: 'Outdoors', sun_exposure: sun_exposure,
+                  wind_exposure: wind_exposure, view_factor: view_factor}
+      end
+      result
+    end
+
+    def self.indoor_shades_from_sub_surface(sub_surface)
+      []
+    end
+
+    def self.outdoor_shades_from_sub_surface(sub_surface)
+      result = []
+      sub_surface.shadingSurfaceGroups.each do |shading_surface_group|
+        site_transformation = shading_surface_group.siteTransformation
+        shading_surface_group.shadingSurfaces.each do |shading_surface|
+          result << Shade.from_shading_surface(shading_surface, site_transformation)
+        end
+      end
+      result
+    end
+
+  end # Aperture
+end # Honeybee

data/lib/from_openstudio/geometry/door.rb

@@ -0,0 +1,136 @@
+# *******************************************************************************
+# Honeybee OpenStudio Gem, Copyright (c) 2020, Alliance for Sustainable
+# Energy, LLC, Ladybug Tools LLC and other contributors. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# (1) Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer.
+#
+# (2) Redistributions in binary form must reproduce the above copyright notice,
+# this list of conditions and the following disclaimer in the documentation
+# and/or other materials provided with the distribution.
+#
+# (3) Neither the name of the copyright holder nor the names of any contributors
+# may be used to endorse or promote products derived from this software without
+# specific prior written permission from the respective party.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER(S) AND ANY CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER(S), ANY CONTRIBUTORS, THE
+# UNITED STATES GOVERNMENT, OR THE UNITED STATES DEPARTMENT OF ENERGY, NOR ANY OF
+# THEIR EMPLOYEES, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+# OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+# *******************************************************************************
+
+require 'honeybee/geometry/door'
+
+require 'to_openstudio/model_object'
+
+module Honeybee
+  class Door
+
+  def self.from_sub_surface(sub_surface, site_transformation)
+      hash = {}
+      hash[:type] = 'Door'
+      hash[:identifier] = clean_identifier(sub_surface.nameString)
+      hash[:display_name] = sub_surface.nameString
+      hash[:user_data] = {handle: sub_surface.handle.to_s}
+      hash[:properties] = properties_from_sub_surface(sub_surface)
+      hash[:geometry] = geometry_from_sub_surface(sub_surface, site_transformation)
+      hash[:boundary_condition] = boundary_condition_from_sub_surface(sub_surface)
+
+      sub_surface_type = sub_surface.subSurfaceType
+      hash[:is_glass] = (sub_surface_type == 'GlassDoor')
+
+      indoor_shades = indoor_shades_from_sub_surface(sub_surface)
+      hash[:indoor_shades] = indoor_shades if !indoor_shades.empty?
+
+      outdoor_shades = outdoor_shades_from_sub_surface(sub_surface)
+      hash[:outdoor_shades] = outdoor_shades if !outdoor_shades.empty?
+
+      hash
+    end
+
+    def self.properties_from_sub_surface(sub_surface)
+      hash = {}
+      hash[:type] = 'DoorPropertiesAbridged'
+      hash[:energy] = energy_properties_from_sub_surface(sub_surface)
+      hash
+    end
+
+    def self.energy_properties_from_sub_surface(sub_surface)
+      hash = {}
+      hash[:type] = 'DoorEnergyPropertiesAbridged'
+
+      construction = sub_surface.construction
+      if !construction.empty?
+        hash[:construction] = clean_identifier(construction.get.nameString)
+      end
+
+      hash
+    end
+
+    def self.geometry_from_sub_surface(sub_surface, site_transformation)
+      result = {}
+      result[:type] = 'Face3D'
+      result[:boundary] = []
+      vertices = site_transformation * sub_surface.vertices
+      vertices.each do |v|
+        result[:boundary] << [v.x, v.y, v.z]
+      end
+      result
+    end
+
+    def self.boundary_condition_from_sub_surface(sub_surface)
+      result = {}
+      surface = sub_surface.surface.get
+      surface_type = surface.surfaceType
+      adjacent_sub_surface = sub_surface.adjacentSubSurface
+      if !adjacent_sub_surface.empty?
+        adjacent_space = clean_identifier(adjacent_sub_surface.get.space.get.nameString)
+        adjacent_surface = clean_identifier(adjacent_sub_surface.get.surface.get.nameString)
+        adjacent_sub_surface = clean_identifier(adjacent_sub_surface.get.nameString)
+        result = {type: 'Surface', boundary_condition_objects: [adjacent_sub_surface, adjacent_surface, adjacent_space]}
+      elsif surface.isGroundSurface
+        result = {type: 'Ground'}
+      elsif surface_type == 'Adiabatic'
+        result = {type: 'Adiabatic'}
+      else
+        sun_exposure = (surface.sunExposure == 'SunExposed')
+        wind_exposure = (surface.windExposure == 'WindExposed')
+        view_factor = sub_surface.viewFactortoGround
+        if view_factor.empty?
+          view_factor = {type: 'Autocalculate'}
+        else
+          view_factor = view_factor.get
+        end
+        result = {type: 'Outdoors', sun_exposure: sun_exposure,
+                  wind_exposure: wind_exposure, view_factor: view_factor}
+      end
+      result
+    end
+
+    def self.indoor_shades_from_sub_surface(sub_surface)
+      []
+    end
+
+    def self.outdoor_shades_from_sub_surface(sub_surface)
+      result = []
+      sub_surface.shadingSurfaceGroups.each do |shading_surface_group|
+        site_transformation = shading_surface_group.siteTransformation
+        shading_surface_group.shadingSurfaces.each do |shading_surface|
+          result << Shade.from_shading_surface(shading_surface, site_transformation)
+        end
+      end
+      result
+    end
+
+  end # Door
+end # Honeybee