AERCalc V 1.2
User Guide
Lawrence Berkeley National Laboratory
December 13, 2017
AERCalc Workflow
● Import the attachment products from the WINDOW Window Library
○ When you first open AERCalc, there are no records in the main screen
● Save as a Project if desired ○ The default location is C:\Users\<usename>\AppData\LBNL\aercalc but a project can be
saved to any directory
● Edit the record as needed ○ Adjust the AL value if needed ○ Add an AERC ID value if needed ○ Edit the manufacturer value if needed
● Simulate the products (select the records and click the simulate button)
● Export the products (for the AERC CPD) and edit as needed ○ Edit the Manufacturer or Material Manufacturer if needed ○ For Venetian blinds and vertical louvers, copy the U-factor, SHGC and Tvis values from the
appropriate child record to the parent record
Main Screen: Overview
Total number of products in this Project
Grid of attachment products (imported from WINDOW)
Directory path of the current Project
Menu options Date and time of last
simulation
Button to import attachment products from a WINDOW database Button to calculate the EPc
and EPh values for the highlighted records
Main Screen: File Menu
Open Open a project, which will open a Browse window to select the folder containing the desired Project
Save As Save the current products to a Project. This opens a Browse window to select the folder which will contain the saved Project
Preferences Opens the Preferences window, where the following can be specified ● General Tab:
○ Log: Creates a log with messages that can be used for debugging ○ Precision: allows control of the number of decimal places for the EPc and EPh values. The default is 0 decimal points. ○ Product List: An option to show (or not) the ID column in the main screen
● WINDOW7 tab: ○ Allows specification of the WINDOW 7 database from which the attachment products will be Imported
Quit Closes the program
Main Screen: Products Menu
Select All Selects all products in the grid
Deselect All Unselects all the products in the grid
Simulate Starts the calculation of the EPc and EPh values for all the selected products. Equivalent to clicking the Simulate button
Import Opens the Import dialog box, which allows selection of attachment products to be imported into AERCalc from the WINDOW database specified in the File/Preferences menu, WINDOW tab
Export as CSV
Exports all the records in the grid to a CSV file
Delete Deletes any selected records
Main Screen: Help Menu
About AERCalc
Shows the About screen, which indicates the version numbers of AERCalc and associated components, as well as developers and license information. The version numbers for the program and associated components are included in the Export file
Main Screen: Fields
Abbreviation for the Attachment type
U-factor
Solar Heat Gain
Coefficient
Visible Transmittanc
e
These properties are calculated in WINDOW 7
Air Leakage The program automatically defaults AL to 2.0 cfm/ft2, but this value can be edited
Energy Performance
results (blank means they have not
been simulated yet)
Abbreviation for the Baseline Window
Product ID (Window ID from WINDOW 7)
Glazing System ID for the Window from WINDOW 7
Name of WINDOW db where the record
originated Product Name (from WINDOW
Window Library name)
Attachment Manufacturer
Used editable ID
If the products are from a previous version of AERCalc, this column will show an error icon, and the products will need to be re-imported and re-simulated in this version of AERCalc
This column indicates if the required BSDF file exists (created on import)
CGDB ID (WINDOW Shading System ID)
CGDB Version number
Main Screen: Field Descriptions
The table below lists all of the fields in the main screen.
Name Name of the Attachment product, from the Window Library in WINDOW. It must have a prescribed format. A Window record without this name format can not be imported into AERCalc <name>::<shadeType><slat tilt>::<attachment position>::BW<basecase window ID>
BSDF When importing a product from WINDOW, a BSDF file is generated (and stored in a subfolder called BSDF below where the AERCalc database is located). This must exist in order to calculate the EPc/EPh values. The program will show an icon indicating the existence (or not) of this file.
● A green checkmark means that the file exists and the product can be simulated ● A red X means that the file does not exist and the product must be re-imported into AERCalc from WINDOW.
Error Status If the product was imported in a previous version of AERCalc, a warning icon appears, showing the older version numbers. In this case the product must be re-imported (and a new BSDF file generated) and re-simulated in AERCalc
ID A user-editable field that can be used for any type of identifying reference. It is blank by default.
Manufacturer The Manufacturer from WINDOW as follows: ● For CS, RS, VB, VL, PS, SS, it is the Manufacturer from the WINDOW Shading Layer Library ● For AP and WP, it is the Manufacturer from the WINDOW Glass Library
W7 Product ID The ID from the WINDOW Window Library (that was imported into AERCalc)
W7 Glazing System ID The ID from the WINDOW Glazing System Library used for this product
CGDB ID The ID from the WINDOW Shading Layer Library
CGDB Version The CGDB Version number for the product, as shown in the WINDOW Shading Layer Library
Main Screen: Field Descriptions
The table below lists all of the fields in the main screen.
W7 DB The name (including complete directory path) of the WINDOW database the product was imported from.
W7 Version The WINDOW 7 program version used when importing the product from WINDOW into AERCalc. This can be found in WINDOW in the Help/About menu option
Window Attachment
The abbreviation for the Attachment Product Type ● SS: Solar Screen ● CS: Cellular Shade ● PS: Pleated Shade ● RS: Roller Shade ● AF: Applied Film ● WP: Window Panel ● VB: Venetian Blind ● VL: Vertical Louver
Baseline Window
The abbreviation for the AERC baseline window. The initial window is BW-B, but in the future there will be windows BW-A through BW-G
U-factor (Btu/h-ft2-oF)
U-factor of the product from the WINDOW Window Library. This is calculated by WINDOW. If this value is zero, recalculate it in WINDOW and reimport the product into AERCalc
SHGC Solar Heat Gain Coefficient of the product from the WINDOW Window Library. This is calculated by WINDOW. If this value is zero, recalculate it in WINDOW and reimport the product into AERCalc
TVIS Visible Transmittance of the product from the WINDOW Window Library. This is calculated by WINDOW. If this value is zero, recalculate it in WINDOW and reimport the product into AERCalc
AL (cfm/ft2) Air Leakage of the product. The default value assigned on import is 2.0 cfm/ft2, but this field is user editable and can be changed as needed.
EPc The Energy Performance value for cooling, calculated by highlighting records and clicking the Simulate button on the main AERCalc screen.
EPh The Energy Performance value for heating, calculated by highlighting records and clicking the Simulate button on the main AERCalc screen.
Import Products: Specify WINDOW 7 Database
File / Preferences: Specify the WINDOW 7 database to import products from ● The default WINDOW database in File/Preferences is located in the W7
subdirectory of the default AERCalc working directory: C:\Users\<username>\AppData\LBNL\aercalc\W7
● To change to another database ○ Click on the File/Preferences menu option ○ Select the WINDOW7 tab and use the Browse button
to select another WINDOW 7 database ○ The database specified here will be the database that EP Calc opens when the
Import button is clicked Use the Browse button to select another WINDOW 7 database, such as the default database in the WINDOW 7 working directory, or any other WINDOW 7 database. (The default database is called AERCalcSample.mdb and is located in: C:\Users\<username>\AppData\LBNL\aercalc\W7
Make sure that all the needed XML, THMX, and other associated files (referenced by WINDOW) are in the correct folders for the selected database. The easiest way to check this is to calculate (in WINDOW) the Windows that you want to import. If they calculate in WINDOW, AERCalc will be able to simulate them
Go to the File/ Preferences menu option
Select the WINDOW7 tab
Import Products: Calculate Products in WINDOW
In WINDOW: Make sure to calculate the products in WINDOW before importing them
If the products have not been calculated in WINDOW, when the program imports them, there will be zeros for SHGC, TVis and U-factor.
Import Products: Import from WINDOW database
Click the Import Products button on the main screen to open the import window
The products modeled in WINDOW will be displayed (AERCalc reads the WINDOW database)
Click the Import Products button on the main screen to see the list of products from a WINDOW database
The program uses a strict naming convention to interpret what products are represented, so it is important to get the naming convention right. (See the next page)
Change the screen size with this resize handle
The Unavailable for Import button will show products in the WINDOW database Window Library that do not conform to the correct naming convention
Import Products: Naming Convention
Here is the naming convention to use in WINDOW when creating products
Examples:
● Sample Solar Screen Outside::SS::O::BW-B
For Venetian blinds, all four slat angles must be defined
● White Venetian Blind Outside::VB0::O::BW-B
● White Venetian Blind Outside::VB45::O::BW-B
● White Venetian Blind Outside::VB-45::O::BW-B
● White Venetian Blind Outside::VB90::O::BW-B
The name of the product ● Make sure to NOT
use any of the following characters
○ / ○ \ ○ < ○ > ○ “
<name>::<attachment type><slat tilt>::<attachment position>::BW<basecase window ID>
Attachment Type abbreviation ● SS: Solar Screen ● CS: Cellular Shade ● PS: Pleated Shade ● RS: Roller Shade ● AF: Applied Film ● WP: Window Panel ● VB: Venetian Blind ● VL: Vertical Louver
Slat Tilt ( only for Venetian Blinds and Vertical Louvers)
● 0 ● 45 ● -45 ● 90
Base Case Window abbreviation For now, there is only one choice
● BW-B
Double semi colons divide the name sections
For Venetian Blinds, make sure that all the names are IDENTICAL except for the slat tilt -- the program will not be able to import them if they are not identical
If the products are not correctly named, they will appear in the Unavailable for Import tab
Attachment Position ● I = Indoor ● O = Outdoor ● B = Between
(currently not used by AERC)
Import Products: Select Products to Import
Highlight the products to import and click the Import button
Highlight the products you want to import ● Holding the Shift key down will allow selecting multiple consecutive records ● Holding the Ctrl key down will allow selecting multiple non-consecutive records
Click the Import button to import the highlighted records
Click the Done button to close the window
When importing Venetian Blinds, import records for all 4 slat angles at the same time
Import Products: Select Products to Import
Importing products takes a while
When the Import button is clicked, the program will put up a progress bar for the import It will take several minutes to import each product. Behind the scenes, an EnergyPlus BSDF IDF file (for the Window) is being created by WINDOW, which takes a bit of time to generate. The BSDF files can be found in the following directory C:\Users\<username>\AppData\LBNL\epcalculator\bsdf When the import is completed, the imported products will have green checkmarks next to them.
Click the Done button to close this screen and see the imported records in the Main screen
Import Products: Imported Products in Main Screen
The imported products are now shown in the Main Screen
Parent Venetian Blind Product Click the arrow icon to expand the records to show the associated “child” records or collapse the records to just show the “parent” record
Child Venetian Blind Product records, one for each slat angle
The “X” in the BSDF field means that for some reason the BSDF file needed for the simulation does not exist. The record must be reimported
Simulating Products
Select the products to be simulated and click the Run Simulation button
Highlight the products to simulate
For Venetian Blinds, you can hide the child records and just highlight the parent record
Click the Run Simulation button
Simulating Products
During the simulations, the program displays the progress The simulations for each product will take quite a while, many minutes each When all the simulations are complete, the Main Screen will again have focus and there will be results in the EPc and EPh columns
This dialog box shows the progress of the EnergyPlus simulations The program uses multiple computer cores (total cores - 1) to speed up the simulation process.
In this example, 4 EnergyPlus simulations will be run
● Fully deployed Minneapolis ● Half deployed Minneapolis ● Fully deployed Houston ● Half deployed Houston
When the simulations are complete, the EPc and EPh values will be displayed in the Main Screen
Simulating Products: Venetian Blind Simulation Results
The main screen after the Venetian Blinds have finished calculating
The results for EPc and EPh are shown only for the master Venetian Blind record
Delete Products
Delete products by highlighting them, then using the Products/Delete menu
● Highlight the records to delete ● Click the Products / Delete menu
option
The program will ask you to confirm the deletion
Projects
AERCalc is organized around a concept of Projects A Project is defined as a folder which contains the minimum set of files needed by AERCalc. These folders are
○ bsdf: a folder containing the Energy Plus BSDF IDF files (generated by WINDOW when records are imported into AERCalc) needed for the simulations that are used to calculate EPc and EPh. There should be one BSDF IDF file for every product in the AERCalc main screen
○ db: a folder that contains the AERCalc sqlite database
You may also want to copy the associated WINDOW database file. If you do that, make a subdirectory called W7, and copy the WINDOW database and all the files in the XML subdirectory needed to each of the WINDOW records (such as XML, THMX, GenBSDF files)
Export
Export a CSV file of all the Products in the Main Screen
Click the Product / Export menu option
The program allows you to save the file to any folder and with any name (keep the CSV extension)
The program confirms the filename and location
Open the file to view the exported results
Export: Venetian Blinds and Vertical Louvers
For Venetian Blinds and Vertical Louvers, the Parent record in the export file will not have values for U-factor SHCG Tvis These values are associated with the Child records for each of the four slat angle cases. For the file to be uploaded to the CPD, the values for those field from the appropriate Child record must be copied into the Parent record.
The table below lists all of the fields in the AERCalc export file.
AERCalc Record ID Auto-incrementing ID given to each record that is imported from WINDOW into AERCalc. It can be turned on and off in File/Preferences
Parent ID For Venetian blinds and vertical slats that have Parent and child records, this is the ID of the parent record
Parent/Child For Venetian blinds and vertical slate that have Parent and child records, this indicates which is the Parent (P) and the child (C)
CGDB Version The CGDB version number for the shading layer
Simulated Product Name Name of Window (product) as defined in the Window Library, that the record was imported from (from the WINDOW database)
W7 ID Window ID from the Window Library (from the WINDOW database)
W7 Glz Sys ID Glazing System ID used in the Window (from the WINDOW database)
CGDB ID The Shading System ID used in the Glazing System in the Window (from the WINDOW database)
Shading System Type Abbreviation for Shading system
AERC Baseline Window Type Abbreviation for the AERC Baseline Window Type
U-factor (Btu/h-ft2-oF) U-factor of the AERC Baseline Window with the shading system (from the WINDOW database)
SHGC Solar Heat Gain Coefficient of the AERC Baseline Window with the shading system (from the WINDOW database)
VT Visible Transmittance of the AERC Baseline Window with the shading system (from the WINDOW database)
TvT
AL (cfm/ft2) Air Leakage of the AERC Baseline Window with the shading system
EPc Ratio Energy Performance ratio for cooling
EPh Ratio Energy Performance ratio for heating
EPc EPc Ratio multiplied by 100
EPh EPh Ratio multiplied by 100
Export: Fields
The table below lists all of the fields in the main screen.
WINDOW Origin DB Filepath WINDOW database name including full path
THERM Files THERM files used to define the frames for the product being modeled
Manufacturer Manufacturer of the product, from the Manufacturer field in the Shading Layer Library (WINDOW database)
Material Manufacturer Material Manufacturer of the product, from the Shade Material Library reference in the Shading Layer Library (WINDOW database)
AERCalc Version Version of AERCalc used to calculate the EPh and EPc results
WINDOW Version Version of WINDOW used to import the products from the WINDOW database
EnergyPlus Version Version of EnergyPlus used to simulate the models used to calculate the EPh and EPc values
ESCalc Version Version of the internal AERCalc calculation module called “ESCalc”, which calculates EPh and EPc from the EnergyPlus results
BSDF The status of the EnergyPlus BSDF IDF file generated by WINDOW when a record is imported
Status Indication of a record having been calculated with a previous version of AERCalc, EnergyPlus, WINDOW or ESCalc
AERC ID An ID input by the user
Emissivity Front Emissivity of the front side (Outside) of the product
Emissivity Back Emissivity of the back side (Inside) of the product
Tsol Solar transmittance of the product
Attachment Position Position of the attachment in the glazing system, either Indoor or Outdoor.
Export: Fields