# Ground

![](https://459479801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ma9N5K8lMbAhbyBVgms%2Fuploads%2Fgit-blob-46a8439f46e4f5ce66b6efb01ef86fd0cc137b29%2FGround.png?alt=media)

![](https://459479801-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Ma9N5K8lMbAhbyBVgms%2Fsync%2F3f452de91283aabb0a5668c4d64a37ffaa358e59.png?generation=1621524669709717\&alt=media) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-energy/blob/master/honeybee_grasshopper_energy/src/HB%20Ground.py)

Change the properties of Honeybee Rooms to reflect those of a ground surface.

This is particularly useful for setting up outdoor thermal comfort maps that account for the surface temperature of the ground. Modeling the ground as a room this way will ensure that shadows other objects cast upon it are accounted for along with the storage of heat in the ground surface.

The turning of a Room into a ground entails:

* Setting all constructions to be indicative of a certain soil type. \* Setting all Faces except the roof to have a Ground boundary condition. \* Removing all loads and schedules assigned to the Room.

All values for the typical soil\_types are taken from the Engineering Toolbox, specifically these pages: Soil Conductivity - <http://www.engineeringtoolbox.com/thermal-conductivity-d\\_429.html> Soil Density - <http://www.engineeringtoolbox.com/dirt-mud-densities-d\\_1727.html> Soil Heat Capacity - <http://www.engineeringtoolbox.com/specific-heat-capacity-d\\_391.html>

### Inputs

* **rooms \[Required]**

Honeybee Rooms to be converted into ground objects.

* **soil\_constr**

An OpaqueConstruction that reflects the soil type of the ground. This can also be text for a construction to be looked up in the opaque construction library. If a multi-layered construction is input, the multiple layers will only be used for the roof Face of the Room and all other Faces will get a construction with the inner-most layer assigned. Some common types of soil constructions contained in the default honeybee standards library are listed below. (Default: Concrete Pavement). Grassy Lawn Dry Sand Dry Dust Moist Soil Mud Concrete Pavement Asphalt Pavement Solid Rock

### Outputs

* **rooms**

Rooms that have had their properties altered to be representative of ground conditions.
