Академический Документы
Профессиональный Документы
Культура Документы
Tutorial 1
by
Dr. Vishal Garg
Aviruch Bhatia
RathishArumugam
Contents
1.
Objective ......................................................................................................................................... 3
2.
Overview ......................................................................................................................................... 3
3.
Installation ...................................................................................................................................... 3
4.
5.
6.
7.
8.
9.
Timestep ......................................................................................................................................... 8
10.
RunPeriod.................................................................................................................................... 8
11.
12.
Construction.............................................................................................................................. 11
13.
14.
Zone .......................................................................................................................................... 13
15.
Wall:Exterior ............................................................................................................................. 14
16.
Roof ........................................................................................................................................... 16
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
Page 2 of 28
1. Objective
This tutorial introduces EnergyPlus in simple steps. The tutorial uses a simple building
example to explain the basics of how to use EnergyPlus, give input and read the output of
EnergyPlus. The emphasis is on a very simple square single zone model without any internal
gains and uses IdealLoadAirSystem for cooling and heating.
Most of the information is referred from the Energy plus documentation. You can access
Energy Plus documentation from the following link
http://apps1.eere.energy.gov/buildings/energyplus/energyplus_documentation.cfm
2. Overview
About
EnergyPlus:(from http://apps1.eere.energy.gov/buildings/energyplus/)EnergyPlus,
DOEs fully integrated building; heating, ventilation, and air conditioning (HVAC); and
renewables simulation program is one of the most robust simulation tools available in the
world today. It models building heating, cooling, lighting, ventilating, and other energy
flows, as well as water. The program includes many innovative simulation capabilities, such
as time steps of less than an hour, modular systems and plant integrated with heat balancebased zone simulation, multizone air flow, thermal comfort, water use, natural ventilation,
and photovoltaic systems.
EnergyPlus is a stand-alone simulation program without a 'user friendly' graphical interface.
EnergyPlus reads input and writes output as text files. Many graphical user interfaces for
EnergyPlus are available or under development.CYPE-Building Services, Demand Response
QuickAssessmentTool, DesignBuilder, Easy energyPlus, EFEN, AECOsim, Hevacomp, MC4
Suite, and SMART ENERGY are now available.
Software tools that were specifically designed to create Energyplus input file includeEasy
EnergyPlus, ECOTECT, EP Geo, EP Sys, EP-Quick, IFCtoIDF, ESP-r, Green Building
Studio, and IHIT.
You can give input to EnergyPlus by either making the input file (*.idf) in a simple test editor
(such as TextEdit or notepad) or by using a simple user interface ( IDF Editor) which comes
with EnergyPlus installation. This tutorial uses IDF editor for creating the input file.
The tutorial assumes that the reader knows the basics of energy simulation.
3. Installation
How to install EnergyPlus?
Download and install EnergyPlus from:http://www.eere.energy.gov .
If you find any difficulty in download and installation of EnergyPlus, you can write it to
EnergyPlus help desk at http://energyplus.helpserve.com/.
Page 3 of 28
4. The problem
We will simulate a simple single zone square model with following parameters:
Dimension of the building (5m X 5m X 3m)
No windows, doors or any openings
Single zone with no partitions
Surface Construction:
To simplify the problem it is assumed that all the surfaces (walls, roof and floor) are made of
concrete and plaster with the following properties:
Name
Roughness
Thickness {m}
Conductivity {W/m-K}
Density {kg/m3}
Specific Heat {J/kg-K}
Absorptance:Thermal
Absorptance:Solar
Absorptance:Visible
Concrete
MediumRough
0.10
0.81
977.00
830.00
0.90
0.65
0.65
Plaster
MediumRough
0.015
0.160
600.00
1000.00
0.90
0.50
0.50
Windows: None
Internal Load: None
Heating and cooling system: IdealLoadAirSystem
Page 4 of 28
Click on IDF
Editor to Start
Any EnergyPlus object may be viewed and edited using a spreadsheet-like grid. For inputs
with several options, a list is provided. When a numeric input has a range of valid values,
Page 5 of 28
6. Add Version
Click 'Version' in the 'Class List' on the top left of the IDF editor and then click 'New Obj'
from the tool bar on the top.
'Obj1' will appear in the first line of the bottom window.
Enter '7.1' in the 'Version Identifier' Field of 'Obj1' as shown in the figure below:
Step 2: Click
on New Obj
Step 1: Click on
Version
"The Version object allows you to enter the proper version that your IDF was created for.
This is checked against the current version of EnergyPlus and a severe error issued
(nonterminating) if it does not match the current version string."
Save your file: You can save your file with any name. In this tutorial the file is names as
'tutorial.idf'. Keep saving your work frequently as IDF editor does not save file
automatically.
7. SimulationControl
The input for Simulation Control allows the user to specify what kind of calculations a given
EnergyPlus simulation will perform. For instance the user may want to perform one or more
of the sizing calculations but not proceed to a annual weather file simulation. Or the user
Page 6 of 28
8. Building Object
The Building object describes parameters that are used during the simulation of the building.
Click the 'Building' Object in 'Simulation Parameters' Class and then click 'New Obj'. Fill the
data as shown below:
Click on Building
and add new Obj
Page 7 of 28
This syntax simplifies building geometry specification by designating onewall of the building
as the buildings north pointing axis. The building model North axis ismeasured from true
(compass) North. Surface facing angles are then specified relative to the building north axis.
The North Axis entry illustrates specification of the building north axis.
9. Timestep
The Timestep object specifies the "basic" time step for the simulation. The value entered here
is usually known as the Zone Timestep. This is used in the Zone Heat Balance Model
calculation as the driving time step for heat transfer and load calculations. The value entered
here is the number of time steps to use within an hour. Longer length time steps have lower
values for Number of Timesteps per Hour. For example a value of 6 entered here directs the
program to use a zone time step of 10 minutes and a value of 60 means a 1 minute time step.
The users choice for Number of Timesteps per Hour must be evenly divisible into 60;
theNumber in hour: normal validity 4 to 60.
Click on Timestep
and add new Obj
10.
Retain default
value for this field
RunPeriod
The RunPeriod object describes the elements necessary to run simulation with use of a
weather file. Multiple run periods may be input. TheRunPeriod object allows the user to
override the use of both the Daylight Saving Period (i.e. use or ignore) and holidays that are
embedded within the weather file.
Field: Name
Page 8 of 28
Page 9 of 28
Page 10 of 28
12. Construction
For walls, roofs, floors, windows, and doors, constructions are built from the included
materials. Each layer of the construction is a material name listed in order from outside to
inside. Up to ten layers (eight for windows) may be specified. Outside is the layer
furthest away from the Zone airs (not necessarily the outside environment). Inside is the
layer next to the Zone air.
Define Construction name and select
Layer material from Dropdown list
Click on
Construction
and add Obj
13.
GlobalGeometryRules
EnergyPlus uses a three dimensional (3D) Cartesian coordinate system for surface
vertexspecification. This Right Hand coordinate system has the X-axis pointing east, the Yaxispointing north, and the Z-axis pointing up.
Page 11 of 28
Page 12 of 28
Click on
GlobalGeometryRules
and add new Obj
14. Zone
Now we start with a new group - Thermal Zone Description/Geometry. Without thermal
zones and surfaces, the building cant be simulated. This group of objects (Zone, Surface)
describes the thermal zone characteristics as well as the details of each surface to be modeled.
Included here are shading surfaces.
This element sets up the parameters to simulate each thermal zone of the building.
Field: North Axis
The Zone North Axis is specified relative to the Building North Axis. This value is specified
in degrees (clockwise is positive).
Field(s): Origin (X,Y,Z)
The X,Y,Z coordinates of a zone origin can be specified, for convenience in vertices entry.
Depending on the values in SurfaceGeometry, these will be used to completely specify the
Page 13 of 28
15.
Wall:Exterior
The Wall:Exterior object is used to describe walls that are exposed to the
externalenvironment. They receive sun, wind all the characteristics of the external world.
Field: Name
This is a unique name associated with the exterior wall. It is used in several other places as
areference (e.g. as the base surface name for a Window or Door).
Field: Construction Name
This is the name of the construction (ref: Construction) used in the surface.
Field: Zone Name
This is the zone name to which the surface belongs.
Field: Azimuth Angle
The Azimuth Angle indicates the direction that the wall faces (outward normal). The angle
isspecified in degrees where East=90, South=180, West=270, North=0.
Field: Tilt Angle
The tilt angle is the angle (in degrees) that the wall is tilted from horizontal (or the ground).
Normally, walls are tilted 90 degrees and that is the default for this field.
Starting Corner for the surface
The rectangular surfaces specify the lower left corner of the surface for their
startingcoordinate. This is specified with (x,y,z) and can be relative to the zone origin or in
worldcoordinates, depending on the value for rectangular surfaces specified in
theGlobalGeometryRules object.
Field: Starting X Coordinate
This field is the X coordinate (in meters).
Field: Starting Y Coordinate
Page 14 of 28
Click on Wall:
Exterior and add four
Objects
Page 15 of 28
1.
2.
3.
4.
5.
6.
7.
16.
Roof
The Roof object is used to describe roofs that are exposed to the external environment.
Field: Name
This is a unique name associated with the roof.
Field: Construction Name
This is the name of the construction (ref: Construction) used in the surface. Regardless
oflocation in the building, the full construction (all layers) is used.
Field: Zone Name
This is the zone name to which the surface belongs.
Field: Azimuth Angle
The Azimuth Angle indicates the direction of the outward normal for the roof. The angle
isspecified in degrees where East=90, South=180, West=270, North=0.
Page 16 of 28
Page 17 of 28
17.
Floor:Adiabatic
The Floor:Adiabatic object is used to describe interior floors or floors that you wish to
modelwith no heat transfer from the exterior to the floor.
Field: Name
This is a unique name associated with the floor.
Field: Construction Name
This is the name of the construction (ref: Construction) used in the surface.
Field: Zone Name
This is the zone name to which the surface belongs.
Field: Azimuth Angle
The Azimuth Angle indicates the direction of the outward normal for the roof. The angle
isspecified in degrees where East=90, South=180, West=270, North=0.
Field: Tilt Angle
The tilt angle is the angle (in degrees) that the wall is tilted from horizontal (or the ground).
Flat floors are tilted 180 degrees and that is the default for this field.
Starting Corner for the surface
The rectangular surfaces specify the lower left corner of the surface for their
startingcoordinate. This is specified with (x,y,z) and can be relative to the zone origin or in
worldcoordinates, depending on the value for rectangular surfaces specified in
theGlobalGeometryRules object.
Field: Starting X Coordinate
This field is the X coordinate (in meters).
Field: Starting Y Coordinate
This field is the Y coordinate (in meters).
Field: Starting Z Coordinate
This field is the Z coordinate (in meters).
Field: Length
Page 18 of 28
Page 19 of 28
Page 20 of 28
Field: Name
This field should contain a unique (within all Schedules) designation for this schedule. It is
referenced by various scheduled items (e.g. Lights, People, Infiltration) to define the
appropriate schedule values.
Field: ScheduleType
This field contains a reference to the ScheduleType. If found in a list of ScheduleTypes (see
above), then the restrictions on the ScheduleType could be used to validate the referenced
WeekSchedule (which reference DaySchedule) hourly field values. Field-Set (Through, For,
Interpolate, Until, Value) each compact schedule must contain the elements Through (date),
For (days), Interpolate (optional), Until (time of day) and Value. In general, each of the
titled fields must include the title.
Field: Through
This field starts with Through: and contains the ending date for the schedule period (may
be more than one). Date Field Interpretation for information on date entry note that only
Month-Day combinations are allowed for this field. Each through field generates a new
WeekSchedule named Schedule Name_wk_# where # is the sequential number for this
compact schedule.
Field: For
This field starts with For: and contains the applicable days (reference the compact week
schedule object above for complete description) for the 24 hour period that must be
described. Each for field generates a new DaySchedule named Schedule Name_dy_#
where # is the sequential number for this compact schedule.
Field: Until
This field contains the ending time (again, reference the interval day schedule discussion
above) for the current days and day schedule being defined.
Field: Value
Page 21 of 28
20.
21.
HVACTemplateZone:IdealLoadsAirSystem
Page 22 of 28
22.
Output Table:SummaryReport
This object allows the user to call report types that are predefined and will appear with the
other tabular reports.
These predefined reports are sensitive to the
OutputControl:Table:Styleobject and appear in the same files as the tabular reports. The
entry for this object is a list of the predefined reports that should appear in the tabular report
output file.
Select AllSummary
from Dropdown list
Page 23 of 28
23. OutputControl:Table:Style
The OutputControl:Table:Style object controls how all standardized reports are
produced.There are seven different option available for output table style such that Comma,
Tab Fixed,HTML,CommaAndHTML,TabAndHTML, All.
The Comma style produces a text file (eplustbl.csv) with the values of the table separated
bycommas. This is a good format for importing the results into a spreadsheet. If you do
openthe file with a spreadsheet, make sure you close the file prior to rerunning
EnergyPlusotherwise the file will not be updated.
The HTML style produces a file (eplustbl.htm) that can be opened with an internet
browserprogram. The values are shown in a tabular format that is easy to view. One
advantage of theHTML style is that the results can be viewed in an internet browser program
and EnergyPluscan be rerun and the refresh button pressed in the internet browser program
to see the newresults.
Select HTML from
Dropdown list
Now Save this file to correct path and you have finished creating the input file
for Tutorial: 1.It is time to run the simulation.
24. Start EP launch
To run the simulation you have to start the programme EP Launch Go to Start > All
Programs > EnergyPlus V7-1 Programs >EP-Launch as shown in the figure below.
Page 24 of 28
Click on EP-Launch
Select
weather
file for
simulation
26.
You can check your 3D model with EP-launch. If you have installed any 3D viewer such that Autodesk
DesignReview, the DXF drawing will be opened in it.
Page 25 of 28
The drawing should look like as shown in the figure below. If it does not match there is some error in
the data given for surfaces.
Page 26 of 28
Step 2: Press OK
Page 27 of 28
Click on HTML
to view results
You should get the same numbers as shown in above figure. If you are getting the
same numbers, congratulations, you have successfully completed the getting started tutorial.
You can also download tutorial.idf from following link
XXXXXTutorial.idf
Write us for comments or feedback at energyplustutorials@gmail.com
Page 28 of 28