# Adaptive Comfort Map
Adaptive thermal comfort map recipe for Pollination.
Compute spatially-resolved operative temperature and adaptive thermal comfort from
a Honeybee model and EPW. Raw results are written into a `results/` folder and
include CSV matrices of hourly operative temperatures and thermal conditions. Processed
metrics of Thermal Comfort Percent (TCP) can be found in the `metrics/` folder.
## Methods
This recipe uses EnergyPlus to obtain longwave radiant temperatures and indoor air
temperatures. The outdoor air temperature and air speed are taken directly from
the EPW. All outdoor points are assumed to be at one half of the EPW meteorological
wind speed (effectively representing wind speed at ground/human height).
Longwave radiant temperatures are achieved by computing spherical view factors
from each sensor to the surfaces of the model using Radiance. These view factors
are then multiplied by the surface temperatures output by EnergyPlus to yield
longwave MRT at each sensor. All indoor shades (eg. those representing furniture)
are assumed to be at the room-average MRT. For outdoor sensors, the EnergyPlus
outdoor surface temperatures are used and each sensor's sky view is multiplied by
the EPW sky temperature to account for longwave radiant exchange with the sky.
All outdoor context shades and the ground are assumed to be at the EPW air
temperature unless they have been modeled as Honeybee rooms.
A Radiance-based enhanced 2-phase method is used for all shortwave MRT calculations,
which precisely represents direct sun by tracing a ray from each sensor to the
solar position. The energy properties of the model geometry are what determine
the reflectance and transmittance of the Radiance materials in this shortwave
calculation.
To determine Thermal Comfort Percent (TCP), the occupancy schedules of the energy
model are used. Any hour of the occupancy schedule that is 0.1 or greater will be
considered occupied. For outdoor sensors, all hours are considered occupied.
Raw data
{
"_id": null,
"home_page": "https://github.com/pollination/adaptive-comfort-map",
"name": "pollination-adaptive-comfort-map",
"maintainer": "chris, ladybug-tools",
"docs_url": null,
"requires_python": null,
"maintainer_email": "chris@ladybug.tools, info@ladybug.tools",
"keywords": "honeybee, ladybug-tools, thermal, comfort, adaptive",
"author": "ladybug-tools",
"author_email": "info@ladybug.tools",
"download_url": "https://files.pythonhosted.org/packages/f0/39/e322dee247f372ba201052ec5c827c348cdd3aa63b2a09ce55c47abf68c2/pollination-adaptive-comfort-map-0.9.3.tar.gz",
"platform": null,
"description": "# Adaptive Comfort Map\n\nAdaptive thermal comfort map recipe for Pollination.\n\nCompute spatially-resolved operative temperature and adaptive thermal comfort from\na Honeybee model and EPW. Raw results are written into a `results/` folder and\ninclude CSV matrices of hourly operative temperatures and thermal conditions. Processed\nmetrics of Thermal Comfort Percent (TCP) can be found in the `metrics/` folder.\n\n## Methods\n\nThis recipe uses EnergyPlus to obtain longwave radiant temperatures and indoor air\ntemperatures. The outdoor air temperature and air speed are taken directly from\nthe EPW. All outdoor points are assumed to be at one half of the EPW meteorological\nwind speed (effectively representing wind speed at ground/human height).\n\nLongwave radiant temperatures are achieved by computing spherical view factors\nfrom each sensor to the surfaces of the model using Radiance. These view factors\nare then multiplied by the surface temperatures output by EnergyPlus to yield\nlongwave MRT at each sensor. All indoor shades (eg. those representing furniture)\nare assumed to be at the room-average MRT. For outdoor sensors, the EnergyPlus\noutdoor surface temperatures are used and each sensor's sky view is multiplied by\nthe EPW sky temperature to account for longwave radiant exchange with the sky.\nAll outdoor context shades and the ground are assumed to be at the EPW air\ntemperature unless they have been modeled as Honeybee rooms.\n\nA Radiance-based enhanced 2-phase method is used for all shortwave MRT calculations,\nwhich precisely represents direct sun by tracing a ray from each sensor to the\nsolar position. The energy properties of the model geometry are what determine\nthe reflectance and transmittance of the Radiance materials in this shortwave\ncalculation.\n\nTo determine Thermal Comfort Percent (TCP), the occupancy schedules of the energy\nmodel are used. Any hour of the occupancy schedule that is 0.1 or greater will be\nconsidered occupied. For outdoor sensors, all hours are considered occupied.\n",
"bugtrack_url": null,
"license": "PolyForm Shield License 1.0.0, https://polyformproject.org/wp-content/uploads/2020/06/PolyForm-Shield-1.0.0.txt",
"summary": "Adaptive thermal comfort map for Pollination.",
"version": "0.9.3",
"project_urls": {
"Homepage": "https://github.com/pollination/adaptive-comfort-map",
"icon": "https://raw.githubusercontent.com/ladybug-tools/artwork/master/icons_components/honeybee/png/adaptivemap.png"
},
"split_keywords": [
"honeybee",
" ladybug-tools",
" thermal",
" comfort",
" adaptive"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c889e1e00a568faee53658c4d8a6822bc3807acc7240f541658a1d94553d5fa9",
"md5": "a32a4a15257ac7d8602c015db46bbbf5",
"sha256": "4d01e5aecb8da265daed4a94cf55fad018de04d73511a0c02b64f267fc1f0b78"
},
"downloads": -1,
"filename": "pollination_adaptive_comfort_map-0.9.3-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "a32a4a15257ac7d8602c015db46bbbf5",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 24348,
"upload_time": "2024-09-11T08:03:43",
"upload_time_iso_8601": "2024-09-11T08:03:43.886191Z",
"url": "https://files.pythonhosted.org/packages/c8/89/e1e00a568faee53658c4d8a6822bc3807acc7240f541658a1d94553d5fa9/pollination_adaptive_comfort_map-0.9.3-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f039e322dee247f372ba201052ec5c827c348cdd3aa63b2a09ce55c47abf68c2",
"md5": "a8b5228b833842ac683c0a39459c9ac7",
"sha256": "668e508ed0520f19fad1c9ba12c0c26161c56b204466db0d5dc996375979dc6b"
},
"downloads": -1,
"filename": "pollination-adaptive-comfort-map-0.9.3.tar.gz",
"has_sig": false,
"md5_digest": "a8b5228b833842ac683c0a39459c9ac7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 279406,
"upload_time": "2024-09-11T08:03:45",
"upload_time_iso_8601": "2024-09-11T08:03:45.240952Z",
"url": "https://files.pythonhosted.org/packages/f0/39/e322dee247f372ba201052ec5c827c348cdd3aa63b2a09ce55c47abf68c2/pollination-adaptive-comfort-map-0.9.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-11 08:03:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pollination",
"github_project": "adaptive-comfort-map",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "pollination-adaptive-comfort-map"
}
JSON
