We need your help! 🔥

Please consider disabling your ad-blocker to support this website! 🔑
We are a free, community-supported website! 🥰
We only display small unobtrusive ads which help us stay online! 💯
Thank you in advance! ❤️

00 | Honeybee


01 \| Daylight \| Material


02 \| Daylight \| Light Source


03 \| Daylight \| Recipes

04 | Daylight | Daylight


05 \| Energy \| Building Program


06 \| Energy \| Material \| Construction


07 \| Energy \| Schedule


08 \| Energy \| Set Zone Properties


09 \| Energy \| HVACSystems

10 | Energy | Energy


11 \| THERM

12 | Developers


13 \| WIP

Export To Open Studio

Use this component to export HBZones into an OpenStudio file, and run them through EnergyPlus.
The component outputs the report from the simulation, the file path of the IDF file, and the CSV result file from the EnergyPlus run, and two other result files that record outputs in different formats.

Inputs

Name	ID	Description	Type
North	north_	Input a vector to be used as a true North direction for the energy simulation or a number between 0 and 360 that represents the degrees off from the y-axis to make North. The default North direction is set to the Y-axis (0 degrees).	Goo
Epw Weather File	_epwWeatherFile	An .epw file path on your system as a text string.	Goo
Analysis Period	_analysisPeriod_	An optional analysis period from the Ladybug_Analysis Period component. If no Analysis period is given, the energy simulation will be run for the enitre year.	Goo
Energy Sim Par	_energySimPar_	Optional Energy Simulation Parameters from the "Honeybee_Energy Simulation Par" component. If no value is connected here, the simulation will run with the following parameters: 1 - 6 timeSteps per hour 2 - A shadow calculation that averages over multiple days (as opposed to running it for each timeStep) 3 - A shadow calculation frequency of 30 (meaning that the shadow calulation is averaged over every 30 days) 4 - A maximum of 3000 points used in the shadow calculation. (This may need to be higher if you have a lot of detailed context geometry) 5 - A solar energy calculation that includes both interior and exterior light reflections. 6 - A simulation including a zone sizing calculation, a system sizing calculation, a plat sizing calculation, and a full run of the energy use ofver the analysis period. The simulation is not run for the sizing period by default. 7 - A system sizing period that runs from the extreme periods of the weather file and not a ddy file. 8 - City terrian.	Goo
::::::::::::::::::::::::::::::::::::::	::::::::::::::::::::::::::::::::::::::	Script variable exportToOpenStudio	Goo
HBZones	_HBZones	The HBZones that you wish to write into an OSM file and/or run through EnergyPlus. These can be from any of the components that output HBZones.	Goo
HVACSystem	HVACSystem_	A customized HVAC system modeled with Ironbug.	Goo
HBContext	HBContext_	Optional HBContext geometry from the "Honeybee_EP Context Surfaces." component.	Goo
HBGenerators	HBGenerators_	Script variable exportToOpenStudio	Goo
Simulation Outputs	simulationOutputs_	A list of the outputs that you would like EnergyPlus to write into the result CSV file. This can be any set of any outputs that you would like from EnergyPlus, writen as a list of text that will be written into the IDF. It is recommended that, if you are not expereinced with writing EnergyPlus outputs, you should use the "Honeybee_Write EP Result Parameters" component to request certain types of common outputs.	Goo
OSMeasures	OSMeasures_	Script variable exportToOpenStudio	Goo
Additional Strings	additionalStrings_	THIS OPTION IS JUST FOR ADVANCED USERS OF ENERGYPLUS. You can input additional text strings here that you would like written into the IDF. The strings input here should be complete EnergyPlus objects that are correctly formatted. You can input as many objects as you like in a list. This input can be used to write objects into the IDF that are not currently supported by Honeybee.	Goo
::::::::::::::::::::::::::::::::::::::	::::::::::::::::::::::::::::::::::::::	Script variable exportToOpenStudio	Goo
Write OSM	_writeOSM	Set to "True" to have the component take your HBZones and other inputs and write them into an OSM file. Note that only setting this to "True" and not setting the output below to "True" will not automatically run the file through EnergyPlus for you.	Goo
Run Simulation	runSimulation_	Set to "True" to have the component generate an IDF file from the OSM file and run the IDF through through EnergyPlus. Set to "False" to not run the file (this is the default). You can also connect an integer for the following options: 0 = Do Not Run OSM and IDF thrrough EnergyPlus 1 = Run the OSM and IDF through EnergyPlus with a command prompt window that displays the progress of the simulation 2 = Run the OSM and IDF through EnergyPlus in the background (without the command line popup window). 3 = Generate an IDF from the OSM file but do not run it through EnergyPlus	Goo
Open Open Studio	openOpenStudio_	Set to "True" to open the OSM file in the OpenStudio interface. This is useful if you want to visualize the HVAC system in OpenStudio, you want to edit the HVAC further in OpenStudio, or just want to run the simulation from OpenStudio instead of Rhino/GH. Note that, for this to work, you must have .osm files associated with the OpenStudio application.	Goo
File Name	fileName_	Optional text which will be used to name your OSM, IDF and result files. Change this to aviod over-writing results of previous energy simulations.	Goo
Working Dir	workingDir_	An optional working directory to a folder on your system, into which your OSM, IDF and result files will be written. NOTE THAT DIRECTORIES INPUT HERE SHOULD NOT HAVE ANY SPACES OR UNDERSCORES IN THE FILE PATH.	Goo

Outputs

Name	ID	Description	Type
Out	readMe!	Check here to see a report of the EnergyPlus run, including errors.	String
Osm File Address	osmFileAddress	The file path of the OSM file that has been generated on your machine.	Goo
Idf File Address	idfFileAddress	The file path of the IDF file that has been generated on your machine. This file is only generated when you set "runSimulation_" to "True."	Goo
Result File Address	resultFileAddress	The file path of the CSV result file that has been generated on your machine. This file is only generated when you set "runSimulation_" to "True."	Goo
Eio File Address	eioFileAddress	The file path of the EIO file that has been generated on your machine. This file contains information about the sizes of all HVAC equipment from the simulation. This file is only generated when you set "runSimulation_" to "True."	Goo
Rdd File Address	rddFileAddress	The file path of the Result Data Dictionary (.rdd) file that is generated after running the file through EnergyPlus. This file contains all possible outputs that can be requested from the EnergyPlus model. Use the "Honeybee_Read Result Dictionary" to see what outputs can be requested.	Goo
Html Report	htmlReport	The file path to the HTML report that was generated after running the file through EnergyPlus. Open this in a web browser for an overview of the energy model results.	Goo
Study Folder	studyFolder	The directory in which the simulation has been run. Connect this to the 'Honeybee_Lookup EnergyPlus' folder to bring many of the files in this directory into Grasshopper.	Goo
Model	model	The openStudio model ojbect. Use this output to generate gbXML files from your OpwnStudio models.	Goo