# PMV Comfort Map
PMV thermal comfort map recipe for Pollination.
Compute spatially-resolved PMV thermal comfort from a Honeybee model and EPW.
This recipe also computes operative temperature or (optionally) Standard
Effective Temperature (SET). Raw results are written into a `results/` folder and
include CSV matrices of hourly temperatures, thermal conditions and PMV. Processed
metrics of Thermal Comfort Percent (TCP) can be found in the `metrics/` folder.
Input conditions to the comfort model are written to an `initial_results/conditions`
folder.
## Methods
This recipe uses EnergyPlus to obtain surface temperatures and indoor air
temperatures + humidities. Outdoor air temperatures, relative humidities, and
air speeds 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/pmv-comfort-map",
"name": "pollination-pmv-comfort-map",
"maintainer": "chris, ladybug-tools",
"docs_url": null,
"requires_python": "",
"maintainer_email": "chris@ladybug.tools, info@ladybug.tools",
"keywords": "honeybee,ladybug-tools,thermal,comfort,pmv",
"author": "ladybug-tools",
"author_email": "info@ladybug.tools",
"download_url": "https://files.pythonhosted.org/packages/df/cc/f10698ea95716c00c9ca29b2897de97bba4d2f7d92ce58bc6152a8d3f8bf/pollination-pmv-comfort-map-0.8.17.tar.gz",
"platform": null,
"description": "# PMV Comfort Map\n\nPMV thermal comfort map recipe for Pollination.\n\nCompute spatially-resolved PMV thermal comfort from a Honeybee model and EPW.\nThis recipe also computes operative temperature or (optionally) Standard\nEffective Temperature (SET). Raw results are written into a `results/` folder and\ninclude CSV matrices of hourly temperatures, thermal conditions and PMV. Processed\nmetrics of Thermal Comfort Percent (TCP) can be found in the `metrics/` folder.\nInput conditions to the comfort model are written to an `initial_results/conditions`\nfolder.\n\n## Methods\n\nThis recipe uses EnergyPlus to obtain surface temperatures and indoor air\ntemperatures + humidities. Outdoor air temperatures, relative humidities, and\nair speeds are taken directly from the EPW. All outdoor points are assumed to be\nat one half of the EPW meteorological wind speed (effectively representing wind\nspeed 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": "PMV thermal comfort map for Pollination.",
"version": "0.8.17",
"project_urls": {
"Homepage": "https://github.com/pollination/pmv-comfort-map",
"icon": "https://raw.githubusercontent.com/ladybug-tools/artwork/master/icons_components/honeybee/png/pmvmap.png"
},
"split_keywords": [
"honeybee",
"ladybug-tools",
"thermal",
"comfort",
"pmv"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b41969e6133606ba463f145dac1376bfa660c0b8320345caf70f07f975c28d22",
"md5": "9a6b3cc35913740be09c879b7086d30f",
"sha256": "251ad50a52d22414924bb0020f54c372f747073c7158f0efe04fde74e0f6ad6b"
},
"downloads": -1,
"filename": "pollination_pmv_comfort_map-0.8.17-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "9a6b3cc35913740be09c879b7086d30f",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 20004,
"upload_time": "2023-09-15T00:17:52",
"upload_time_iso_8601": "2023-09-15T00:17:52.176653Z",
"url": "https://files.pythonhosted.org/packages/b4/19/69e6133606ba463f145dac1376bfa660c0b8320345caf70f07f975c28d22/pollination_pmv_comfort_map-0.8.17-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dfccf10698ea95716c00c9ca29b2897de97bba4d2f7d92ce58bc6152a8d3f8bf",
"md5": "dbf318175afdde5ad16d6d86e1b33a11",
"sha256": "65107dfee176e303e57f1cbd48fc849e0003e0242acb2622784098b850ac9d4e"
},
"downloads": -1,
"filename": "pollination-pmv-comfort-map-0.8.17.tar.gz",
"has_sig": false,
"md5_digest": "dbf318175afdde5ad16d6d86e1b33a11",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 17290,
"upload_time": "2023-09-15T00:17:53",
"upload_time_iso_8601": "2023-09-15T00:17:53.979741Z",
"url": "https://files.pythonhosted.org/packages/df/cc/f10698ea95716c00c9ca29b2897de97bba4d2f7d92ce58bc6152a8d3f8bf/pollination-pmv-comfort-map-0.8.17.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-15 00:17:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pollination",
"github_project": "pmv-comfort-map",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "pollination-pmv-comfort-map"
}
JSON
