Mr.Comfy is freeware, but not free software. Personal, educational and professional use is allowed- with the kind request that if you end up using it regularly in your work, I would like to network with you and be made aware of projects supported by the software. Nice to meet you, I’m Max.

By downloading the software, you further agree to the license agreement. Please consult the full text, especially if you want to do anything else than just use the tool.

Includes pre-wired *.gh definition, Cupertino sample building, EnergyPlus results files, low spatial resolution Daysim results files.

Unpack and open *.3dm & *.gh, reference *.eio/*.csv. Surfaces are pre-referenced for sample file.
Reference *.pts/*.ill for daylight co-display.

Set daylight mode switch to any “on” state (unless you only visualize daylight, then pick “daylight only”).
Note: due to the large data volume, daylight co-mapping is not as fast as thermal display.

Consult the Input Glossary for a quick description of GUI elements.
A discussion of the sample building & additional data sets are on the Example files & data sets page.

Grasshopper definition only, pre-wired with GUI elements
Mr.Comfy is not distributed as a GH user object to retain the set inputs, described in the user guide.

Reference your own *.eio and *.csv, wait for parse to run successfully.
Select & pick display surfaces through input zone indices panel & surface component(s).
Specify report variable and set custom schedule and report ranges.

For daylight co-mapping,  select your own *.pts and *.ill, enable daylight mode switch.

Known issues

Daylight mapping is not as fast as thermal visualization; this is because the data sets are potentially very large (8760 values per sensor, of which there might be thousands). I recommend you use fewer nodes in simulations- something the tool is good at displaying in a nice fashion – and interrupt daylight display through the toggle when scrolling through time ranges and display performance deteriorates. Grasshopper can choke on large display pipeline updates, which is not something I can fix on my end- be gentle with the sliders and give the display time to refresh, and you should be fine.

Building-wide meter variables are currently not supported in Mr.Comfy; fabric data is not parsed, either, and should not be included in *.csv files- only regular report variables.

Also currently, the custom visualization input range slider does *not* wrap around. That’s probably not a big limitation, but I might fix it at some point.


0.21 06/18/2014
- added user custom thermal report variable mapping expressions
- added single condition check quick frequency mode
- daylight display & referencing now independent of thermal data availability
- builtin natural logarithm daylight display range remapping
- Mr.Comfy component performance boost (independent of no. of variables)
- updated quick converts (Wh to kWh, J to Wh, J to kWh)
- improved startup behaviour
- several bug fixes (e.g. in report time range display output)
- updated DIVA/viper parser to work with daylight co-mapping
- updated documentation & input glossary

0.2 01/31/2014
- added daylight co-mapping components; updated GUI & labeling
- latest GHPython & Grasshopper compatibility checks, updated GH components

0.19 11/12/2013
– hourly/daily/monthly input ranges made to wrap, enabling e.g. all-winter selection in one go

0.18 10/24/2013
– parser rewrite to support conditioned/non-conditioned zone mix with energy use variables

0.17 10/21/2013
– added conditional percentage reporting mode
– decluttered parsing data handover
– processing speed increase

0.16 10/08/2013
- added normalisation & unit conversion
– fixed erroneous custom bounds schedule inclusion
– improved processing & parsing speed