This is a list of a few known issues which are generally easily resolved and helpful information below to get the best experience from the software.
Results
Issue: When Calculating Solar Loads in the Building Manager, results do not appear or take a long time to process.
Solution: Please Sign Out and Sign back into the application. (The License token may periodically expire if the Stay Signed in is not checked. Expired license tokens will prevent the application processing results). Use the icon on the bottom toolbar to Sign Out as shown below. Re-launch the application and the Sign in window will appear. Please enter your credentials again to proceed (your email and password).
Note: If you have curtain walls in your project, the panels must be a curtain panel family in Revit. This can be confirmed by selecting a curtain panel and going to Type Properties. If any panels are wall type families, analysis will not be possible. Please see the Section on Model Preparation for guidelines on other criteria for auditing your Revit project before analysis.
No results can also happen if glazing elements do not have analytical properties. Check under Type Properties in Revit if glazing families have analytical properties. Warnings will display in the Facade Navigator for Facades/Surfaces without properties. Internet connection issues can also result in no results being sent back to the application.
Fully glazed door families in Revit will not usually contribute to glazing percentage since their VLT value will typically be zero. There are a few workarounds for this.
- Option 1: Change the door family into a window family. You may select the door family and open Type Properties in Revit. Then duplicate the family and edit the name if required.
2. Select the element and open this family in the Family editor.
3. You can make this a window family instead of a door family. Once in the Family Editor, go to Family Category and Parameters. Change the category by highlighting windows in the list. Save the family and load into the model.
You cannot simply replace a door with a window family by changing the type using Type Properties in Revit (since it will not appear under the door types), you will have to place the window element on the model instead of the door element. This widow element can then have its glass type modified by going to Type Properties in Revit or by using the Glass Database in the application.
If you choose to change the family back to a door family, the glass type will remain in the family with its properties for u-value, SHGC and VLT. If you change this construction type to another in the Type Properties list, it will be lost however, since glass types are not available for door families in Revit.
Option 2: Define analytical properties for the family. You may also hard-code values into the Door family by using the Family Editor and entering values for each parameter. These values will then always display in Type Properties, even if a different construction type is selected. Only parameters which are not hard-coded will change as different construction types are selected.
Select the family type in the model and open the Family Editor in Revit. Open the Family Types dialog and enter values after the equals sign for each parameter. You may copy properties from a known Guardian Glass type. Then save this family with the Guardian Glass Type name so that it is easy to identify.
Note: changing the construction type in Revit will not affect these values now, since they are hard-coded into the family.
When using Linked Elements/Files, they should be set as Room Bounding. These will then contribute to model enclosure (they may be Roof, Floor, Wall elements etc).
Analytical Properties in these elements will not be read by the application however and Glazed Families that are links or are hosted on walls which are linked into the project, cannot be modified by the application. Glass Types in these linked elements cannot be accessed or substituted. Glazed Elements need to be in placed the host project. Rooms or Spaces will also need to be in the Host model (instead of in the linked files). Generally is is best if all elements are accessible in the Project rather than being linked in.
The building enclosure is required to be in the Host model (not linked in). Other solid elements may be linked in (Roofs, Floors, Walls) and if set as Room Bounding, they will help enclose the model and the application will produce results for the glazed elements. Solid elements that are linked into the project, will not provide results or display analytical properties under the Performance tab however, even if these have been set in the linked file.
A separate Revit file may be required for Energy Analysis by binding the links or copying and pasting the linked elements into the Host project. The Model Diagnostic Tool currently will not provide information or on linked elements or display them in the viewer. Surrounding Masses linked into a project, will also not create shading effects on the model which would normally affect the outputs for Solar Loads and Daylight.
Open Building Manager and calculate the Solar Loads again. This will populate the latest results for the model in its current state. Possibly, the model was modified or there was an error contacting the web server to get the solar data.
For Conceptual Mass Models – check that a glazing percentage has been applied to the model. This may be done in Performance or in Revit’s Energy Settings. For Conceptual Mass models – make sure that there is a glazing percentage assigned to the model in Performance. This can also be set in Revit’s Energy Settings.
It is a good idea to extend the panel to the side and leave open the General Tab which will display any errors. You may check there to see if there are any messages about your internet connection or issues with the web server. A poor connection may not allow the application to calculate the Solar Loads or display the Charts.
When creating a Curtain System, they should be created separately on each orientation and for each wall of the project. If Curtain Systems are placed on several orientations and on several different areas of the model at once, it will be read as one object and separating these out into Facades and Surfaces will not be possible.
Creating multiple curtain systems at once in Revit, provides information to the application for one system with a number of grids. The application will get an average orientation across all grids. This could lead to unexpected orientations and results. It is best therefore, if 'Select Multiple' is not used during Curtain System creation.
Curtain System creation is most compatible when the glazed walls are modeled in separate editing sessions in Revit.
If some Surfaces are not highlighting on the model, this may be due to model issues or missing properties for glazing elements.
Please ensure that model issues are reviewed before launching the application and that all glazed elements have thermal properties assigned. You might try to place Rooms in spaces which do not have any. If you are unable to place rooms, this will indicate that there are issues in the model - walls/floors etc may not have a 'room bounding' condition. You may select a wall element and check in the Properties Palette in Revit if this is set.
Please see this article for model preparation issues and for how to assign analytical properties to glazed elements.
https://fenestraguaprd.wpengine.com/knowledgebase/2-0-1-model-preparation/
This is due to the Energy Analytical Model (EAM) being recreated in Revit. While this is happening, it will prevent the application from updating. Please be patient while the Energy model recreates or go to the Analyse Tab in Revit and delete the Energy Model and Create a new one. You may also close and reopen the application which will initiate a new Energy Model.
If the model is changed substantially while the application is open (glazing is created or deleted or geometry is altered), you may need to go back to the Building Manager to Calculate Solar Loads again. In some cases it may be prudent to close the application, make the changes in Revit and then reopen the application to start afresh.
In the Facade Navigator, each Facade should have a list of Surfaces with the same orientation. For example, Facade 1 South, should list all South Surfaces under that Facade.
If you expand an item such as Facade 1 South, and you notice some North Surfaces in this list, this may be due to building enclosure issues. This is where floors, walls, roofs or glazing allow significant gaps in the model. Shafts may penetrate floors or roofs and compromise the enclosure when Revit's Energy Model is generated. There may be issues with parts of a project at an angle to the rest of the building, where bounding boxes are not aligned.
If you notice that Surfaces under a Facade orientation have a mixture of different directions, this may also be due to elements that have have been placed inside out.
If elements such as Curtain Walls and windows are placed facing inside out, this can also affect the orientations in the list. When creating a Curtain Wall, this should be placed in a counter-clockwise direction to ensure that it faces outwards. Windows also have a toggle arrow to flip their directions if necessary.
This happens if the setting in Options for including ‘Surfaces smaller than..’ is set to a higher value than is appropriate for the project. This setting will filter out Surfaces which have areas below this value. In some projects, these may add up significantly. Try setting this value to a lower figure or even zero.
If you have already calculated with Shading Factors on and then calculate Solar Loads without Shading Factors, results may remain at the lower figures. The application may need to be re-launched to reset the results and allow the results to update.
If changes are made to the model geometry, Solar Loads will need to be recalculated in the Building Manager to update any modified orientations. By opening the Building Manager, you may notice that an orientation has gone grey and has reverted to zero. The application has identified that modifications have been made and Solar Loads will need to be recalculated.
If the model is changed substantially while the application is open (glazing is created or deleted or geometry is altered), you may need to go back to the Building Manager to Calculate Solar Loads again. In some cases it may be prudent to close the application to make the model changes in Revit and then relaunch the Add-in to start afresh.
It will be necessary to close the application and re-launch if True North is modified during a session. The Energy Model will need to be recreated and the Solar Loads will need to be recalculated in the Building Manager to update the results to the new site condition.
Please see Section 12.2 for more details on setting True North.
Functions
An error may occur if the Glass Database is used to map glazing properties in the model which has just been modified or deleted. This may occur if the Add Windows or Add Curtain Walls feature is used and then this is reversed (the glazing that was created is then removed/undone). Attempting to apply properties to this glazing in the Glass Database to Surfaces which no longer exist in the model may cause an error.
This may also occur if properties have been applied to glazing which is subsequently deleted. This is not an error but simply a referencing issue where model elements are created or removed, and dependent properties need to update. Users are advised to work methodically and allow the application to refresh and update as changes are made. If major changes to the model geometry are to be done, it is best to close the application, modify the model and open the application when you are ready to analyze again.
If there are multiple entries in Revit’s internal list with the same name, Revit will use the entry which is last in the sequence. An entry which has the same name in the Glass Database and is chosen for selection, may have a set of properties which do not match an entry in Revit. This may occur if you create glass types with the same name in Glass Analytics which have different properties.
This may occur where there are several entries in Revit for Glazing Types which have the same name eg. Glass 1. Once this is applied to a glazing element and is added to Revit, the list may have one entry with one set of properties, a second entry with the same name but with different set of properties.
Revit invariably uses the last entry in the list. An entry chosen in the Glass Database which appears to have the same name, therefore may not map to the correct Revit entry as expected since there are multiple versions.
Users are therefore advised to create custom glass types with different names and to check the thermal properties in Edit Type to confirm that the entry has mapped correctly and that these are the properties that they intend to assign.
If the Glass Database does not appear to add new entries to Revit’s list, there may be an issue with access to this file. In some cases, Revit will require a restart before the new glass type will display in Revit’s properties.
During installation, the application will check that permissions are set to allow the application to update this Revit file. If the Constructions.xml file is subsequently edited manually, substituted by another, restored or permissions are reverted to restrict editing, then updating will cease to function. This may be resolved by re-installing Guardian Glass for BIM where permissions to edit the file will be restored.
Security permissions may be manually set for this file, this is an advanced process and is recommended to be done by those with sufficient expertise. Please contact us if editing permissions are restricted on your machine or if your Revit files are stored in a location other than the C: drive.
Periodically, your license token may expire. This may happen over an extended period or if your application session is left open in Revit. This is easily resolved by signing out and signing back into the application. Use the Sign Out button next to the Settings wheel on the lower right corner of the main window. When signing in, you may also check the option ‘Stay Signed in’. This will prevent the license token from elapsing.
This may occur after elements which were generated on the model are then deleted and Revit must recreate the Energy Model to update. The Surface has changed while Revit is using the older version of the Energy Model. You may see a message in Revit that the ‘Referenced Object is not valid’.
If the Refresh button is used and then the Building Manager is opened again and the Solar Loads are recalculated, the current condition should update. If this does not have an effect, close the application and reopen, a new Energy Model will be created and the current Surface condition will be identified.
This may occur if glazing on an adjacent wall is close to the corner. If possible, move the glazing back away from the corner. There is also a tolerance value in Settings which may be adjusted.
Areas reported are taken from Revit elements, not from the Energy Model which provides a further breakdown of glazed surfaces etc. Please note that where Openings have various materials but only part is glazed, the entire opening area is reported. If you require more detailed areas, please refer to the Revit model itself and glazed families.
These issues are to be addressed in future versions of this tool.
Please close Revit and restart to reset internal references. Open the model again. (Shading Factors needs to have been included in the Building Manager to view shading effects in the Shading Viewer).
If this does not resolve it, it may be necessary to clear previous stored files that are saved in the FenestraPro folder. This may be done in Settings, under the Common tab, use the Clear Cache button and relaunch the application.
There is a known issue in metric models if the Perimeter Zone is adjusted in Revit's Energy Settings before the application opens or while the application is open. This may interfere with the Core Offset function's ability to update the Dashboard. Saving the model and restarting Revit does not resolve.
Adjustments should be done from within the application for Core Offset. This value will also update in Revit's Energy Settings. Modifying the value will affect the Solar Loads and Daylight results on the Dashboard. A smaller value for Core Offset/Perimeter Zone will produce higher results as the Heat Gain and Daylight will be contained in a smaller area. A higher value for Core Offset/Perimeter Zone will produce lower results as the Heat Gain and Daylight are spread over a larger Floor Plan.
Starting with a perimeter zone value in the Energy Setting of other than the standard 6 metres, may prevent the function updating the Dashboard results. Ensure that the starting value in the Energy Settings is 6 metres. Modifying the value in Revit's Energy Settings may also disrupt the function so that it will not update the Dashboard. There are also maximum and minimum values accepted for the input box (Minimum 1.5 metres, Maximum 8 metres). Values that are outside these ranges will default to 6 metres. Excessive values (eg. 20 metres) entered for the Perimeter Zone in the Energy Settings will not be corrected by the application and will remain at this value.
There do not appear to be any issues for imperial models.
You open the Snapshot function and select 'HTML' but the browser window does not open with your report.
This may happen if there is a disconnect with the Account that you are signed into the application on and how you are signed into the Platform/Cloud area.
If you are using a hot-desk for example, another user may have signed into their Account on an open browser but you have signed into Guardian Glass for BIM with a different Account.
If there are may open browsers where this might be the case, please sign out of any open online sessions. You may also check by clicking on Platform on the Welcome Screen. This will take you to a browser window to sign into the platform.
Issues may also happen if permissions are not granted to access Revit's Constructions.xml file. There may be restrictions in your office on user's changing permissions for files on their machine. This permission should be set to Full Control (Read and Write). During installation, this will be automatically be set by the application. It may happen in some instances that there are firm-wide restrictions or User Profile restrictions on modifying file securities. Please contact us for more information.
You may also send a report (log file) to us from your application. This will provide details of the event which caused an issue. This report may be accessed from Settings (1) - Send Report (2). You may add a description of the error if you wish (optional).
Check that the Revit View is not set to the Energy Model view. Rotation and highlighting functions are not compatible with this View. Change to a default 3D View in Revit to see highlights display and to use the rotation feature when selecting Facades or Surfaces.
This feature may be turned on/off in Settings. Once changed, the application should be re-launched to view the effects.
Where the Add Windows function does not become available for a selected area on a model, this may be due to adjacent glazing being too close to the solid wall. Glazing that abuts a solid wall where windows are to be added, may prevent placement of windows there as the joint condition cannot be verified.
This may be overcome by moving the glazing away from the solid wall (eg. 3 feet / 1 metre). This may also occur where internal glazed partitions abut a solid exterior wall – the Add Windows function may be disabled. You may temporarily move the internal glazed partitions back away from the exterior wall in order to place windows using the application and restore them when windows are placed. The Tolerance Setting for openings may also be adjusted in Settings which may help.
This may happen if the previously saved Excel file is still open on your desktop. Further saving of analysis results cannot be written to the same file if it is open.
Search for the open Excel file on your desktop and close this application, then try once again to save a Snapshot.
Errors
This has been known to occur if an element in the Revit model has been modified or deleted and the Energy Model has not yet updated. You may need to click this message several times to close it. When the message has closed, please recalculate the results in the Building Manager to bring the application up to date.
This is may be due to the Energy Analytical Model (EAM) being out of date after changes have been made to the model in Revit. Windows or Curtain Walls may have been created or deleted. In this case, the Surfaces may need to be updated to include the recent changes.
If you try to run calculations but have recently changed the model, the objects may no longer be in that location. The changes may not be updated or Refresh may not have completed. In some cases, after major modifications, it may not be possible to continue without closing down the application and re-launching.
This may happen if the number of Surfaces have now changed and need to be re-assigned.
If major modifications are to be done to the model, it is best to close the application before you embark on these changes. You may relaunch when the model is ready for analysis once again.
Certain windows themes or personalizing your desktop may conflict with the graphics used in the application. If this occurs, please try changing the desktop theme to a simpler Microsoft Windows theme to see if this improves display of the application. Please report any issues to us at guardian@fenestrapro.com
The application supports Windows 10 and Windows 8.1. While all efforts are made to support Windows 7 and earlier versions, these may not have full functionality or enjoy all the features of this release.
This error message may display if you are launching the application.
In this event, please clear the cache files that are periodically stored on your machine as results are gathered.
This may be done by browsing to the FenestraPro folder on your machine.
This may be found at C:\Users\YOUR USERNAME\AppData\Local\FenestraPro. All files here may be safely deleted as they will be recreated when you launch the application again.
Please then relaunch the application and sign in with your credentials.
With some models, loading elements may be affected by other views being open in the background eg. Plan Views open as well as a default 3D View. In this case, please close other views that are open or tiles views before launching the application.
When using the Spatial Elements option (Revit 2020 and earlier) and launching FenestraPro, a Revit message may display:
This message may display, even though there are Roofs and the Room upper extent appears to reach the Roof element.
If you click OK and continue, FenestraPro will launch but Roof properties will not display in the Performance area.
This may be resolved by closing FenestraPro and going to the Properties palette in Revit. Select the Roof element(s) and check the settings for Upper Limit and Limit Offset. The Upper Limit may need to be set to the Level above the Room base. The Limit Offset may need to be adjusted so that the Room Upper extent touches or extends past the Roof.
Where the Upper Limit is set as the Room base level, this message has been seen to display. A Section View can help to visualize and understand the Room extents in the model.
You have forgotten your password or need to reset it. When you enter a new password, you are not able to sign in with this.
Please check that you are using the same email that is in the system for your Account (you may have several email addresses).
Also ensure that the password is correct and that case sensitivity is observed.
Note: You must already have created your Account using the link in your invitation email. You will not be able to use this function to create an Account or password the first time (this button will only allow you to change an existing password).
This may also happen if you are using an older browser version (such as Internet Explorer 7 and older). Older browsers have a know issue that they may not send the updated password information to the system. Please use a more recent version, update your current version or try another browser.
You may also request that you be sent the reset password invitation link. You may copy and paste this link into any browser to reset your password.
You may request a link to reset your password by using the link on the welcome screen.
Recent versions of Revit include several options in the ‘Define Thermal Properties by’ parameter in the Analytical Construction area. You may access this by selecting an element in the Revit model and then using Type Properties/Edit Type in the Properties Browser. The parameter should be set to Schematic Type for glazing properties to update correctly with new Glass Types from the application database.
Note: If this area has been set to User Defined or Building Type, the application will not be able to change the glass type for the Revit element. Please ensure that this setting defines thermal properties by Schematic Type unless there is a specific reason to customize or override.
o 
The application identifies previous versions of the application and will manage the database files which are stored on your machine (previous Solar Load Calculations, Custom Groups and Codes, and Log files etc). Once installed, will rename older folders and save this data.
If an error message appears, try clearing the cache files in the FenestraPro folder. This contains folder contains previous data and calculations from projects which have been analysed. If the project has been modified or was previously viewed in a previous version of the application, this database may need to be deleted to start afresh.
The folder may be found in this location on your machine:
C:Users\< User Name>\AppData\Local\FenestraPro.
All the files may be deleted here. New files will be created when the application is opened again in Revit.
Please check that your version of Revit is up to date. You may do this in the Revit Menu by clicking on About Autodesk Revit.
Please check if your Revit version has the latest update and patches/fixes from Autodesk. The Autodesk Desktop App is available for this purpose. It will suggest relevant updates for your applications.
It is important that whatever Revit version you are using has the most recent updates from Autodesk so that it will work well with the application. Your Revit version may be checked by navigating to the Help Menu and scrolling down to the About Revit section. Clicking on this will open a new window where you may view the current version number that is installed.
Please check regularly that any updates released by Autodesk are installed if required.
This means that there is a problem connecting to the internet. Please check your network connection and retry. If necessary, wait a few minutes before retrying. The application requires an internet connection to calculate Solar Loads for the glazing.
Certain Browsers such as Internet Explorer 7 and older versions may have issues accessing the Platform area.
Please upgrade your Browser to the latest version or use other browsers with up to date builds such as Google Chrome, Microsoft Edge, Firefox etc.
This may also occur when you are creating a password for your online Account. If possible, use a more up to date browser and make this the default browser before clicking on the invitation email link. Alternatively, you may copy and paste the url from the non-functioning browser into another browser.
This may occur if the Energy Model was created but then masses were modified/moved/deleted. The Analytical Surfaces may still be in the model but may be hidden. These can be removed by going to the Energy Settings and changing the Mode to another type. Apply this and then change it back if needed. This should clear the redundant surfaces.
