What are the steps to specify Room Type via Room polylines for Registration?

  • Create layers for room type in the strict format of Room_Polylines_Roomtype e.g. Room_Polylines_Bedroom
  • The room type name must be present on the RoomType.txt file. The list can be viewed on Register dialog /Room tab/ Room type combobox
  • Room type will be set based on the layer name of the room polyline during registration
  • Avoid these characters (‘<‘, ‘>’, ‘^’, ‘\”‘, ‘:’, ‘?’, ‘*’, ‘|’, ‘;’, ‘=’, ‘,’, ‘@’) in the room type name as it is not supported by Autocad on layer names

How to specify the values for the new Maintenance Factor (dirt factor)?

It is based on the BS 8206-2:2008 guideline (Lighting for buildings. Code of practice for daylighting).
Maintenance factor = 100% – (loss% x exposure multiplier x special exposure multiplier) e.g. 100% – 8%x1x1 = 92% (0.92)

  • The default value used are loss of daylight = 8 (Urban, Residential), exposure = 1(Normal exposure, Vertical), special exposure = 1(not used).
  • The exposure multiplier depends on the exposure type and the window inclination.


Exposure Exposure multiplier
Vertical glazing Inclined glazing Horizontal glazing
Normal exposure x1 x2 x3
Exposed to heavy Rain x0.5 x1.5 x3
Exposed to snow x1 x3 x4


  • For example, Glazing transmittance of BRE recommended clean, clear double glazing with a low emissivity window is 0.68.
  • In the old version of software, this value used to be modified to include the maintenance factor and value of 0.63(0.68 x 0.92) would be used as glazing transmittance.
  • In the new version of software, full glazing transmittance of 0.68 should be used instead of 0.63 to avoid maintenance factor to be applied twice.
  • Would the result change if model registered with old version is used on new version of software?
    No. The maintenance factor will be assumed to be 1 for old version windows to keep the results same. However, it is important to modify the glazing transmittance if any maintenance factor is included with it when the windows are updated on the new version of software.
  • Is it possible to not use the maintenance factor completely to avoid any mix up?
    Yes. If the loss of daylight is set to 0. The maintenance factor will remain 1 which will work like the old version of the software

How to specify offset values for VSC, APSH and ADF?

  • Offset value should be positive to go towards the room and negative to go away from the room
  • For example, Assuming VSC and APSH calculation point is on the outside of a 0.3 meter wall, ADF calculation point is on the mid-point of the wall, the offset can be set as below
Window Location\Calculation VSC & APSH Offset ADF Offset
Window on Outside Wall 0 0.15
Window on Centre of Wall -0.15 0
Window on the Inside Wall -0.30 -0.15

What are the steps to modify shape of registered Room polylines?

  • Change the shape of the Room polyline
  • Query the Room address or Select polyline for the concerned Room(s) on Register dialog/ Update Mode/ Room
  • If the room was already listed when the changes were made, Re-Query the room
  • Register dialog /Update Mode /Room. Update
  • DrawRoomGridPnts command can be used to confirm shape change has been updated correctly.

What are the steps to restore Room-Window link after copying rooms and windows?

  • Copy the required Rooms and windows
  • Paste the copied rooms and windows
  • Register dialog /Tools/ Copy Room-Window Link (Select the original rooms)
  • Register dialog /Tools/ Paste Room-Window Link (Select the copied rooms and windows)
  • Register dialog /Update Mode /Room. The ReReg checkbox should be Ticked. If it has remained unticked, Use ForceReregister button before update to enforce re-registration.
  • DrawRoomGridPnts command should be used to confirm the room has been updated correctly.

What are the steps to copy amenity to another model?

  • Copy the required Amenities and Paste to a new model
  • Register/Update Mode/ Amenity. Update the Amenity
  • Use DrawAmenityGridPnts command to confirm the copy is done correctly

Can room/amenity polyline have a curve?

  • No. It’s not possible because of Autocad issues on triangulation of such polylines.

Can window polyline have a curve?

  • Yes

Can a room/amenity polyline with a slope be registered?

  • No. The polyline must be horizontal and coplanar.

Can a 3D polyline be registered as room/amenity/window?

  • No. It must be a Lightweight 2D polyline. Heavyweight 2D polylines can be converted to Lightweight using convertpoly command.

Why is Amenity registration taking a very long time?

  • The default grid spacing of 0.3 means there could be thousands of calculation points within the area which causes the registration time to increase. Grid spacing can be increased slightly to improve the registration time.

Can room/window groups be automaticaly created?

  • Yes. Register dialog/Create Groups

Register by Model

  1. Can only windows be registered on their own?
    Yes. Without Rooms option should be ticked
  2. Can Rooms be registered on their own?
    Yes. If windows are already registered with same building and floor address.
    Perform 1.Pre-Reg Room then 3. Register by model. Windows will be linked to the roomsNo. If windows are not registered with same building and floor address.
  3. How can window/room address be updated if they are added/removed after the initial registration?Register dialog /Update Mode/ Re-Number button allows to renumber windows and rooms. Building polyline and building name block are required. Re-Numbering can be done for partial floor, single floor or entire building.
  4. Can window/room name be started from a different location in the building?The first window and the order is determined by the starting point and order of building polyline vertices. Redraw the polyline to match the requirement and perform renumbering.
  5. Why could not the building name and/or starting floor be determined from the building detail block?
    • The block must be on Building_Polylines layer.
    • The block’s base point must be within the outlining building polyline
    • The starting floor name must already exist on the floor name combobox(loaded from FloorList.txt)

What unit is used by the software?

  • Meters. If the model is in millimeters, Registration and conversion process would take forever and/or give error. Model must be scaled to meters.

Where is Rasterize(XNB) option?

  • The Rasterize rendering option is discontinued from Version 4.1 onwards. The new default Raycasting rendering option can create waldram images similar to the rasterize option.

Can PROPOSED group be created automatically when doing ROL cutbacks?

  • Yes. Tick the Auto create PROPOSED group option in Asset tab.
    It will re create the group from objects in 3D_PROPOSED_BUILDINGS layer.

No Contour is created after running ROL/DD Calculation

  • Use DrawRoomGridPoints to check calculation points position. They should be located in the WP height. If not update the room(this is usually the case if the room is moved/rotated/reshaped without being updated).
  • Check if the window is facing inside, it must face outside. Use SpinWindows command to fix.
  • Convert the model if windows have been updated but the model has not been converted again.
  • View the model in Conceptual mode and check if any entities block the window.
  • Use DrawRoomTriangles command to check the triangulation. If it gives error, then the problem may be the room is not registered properly.

What transparency value should be used for Waldram image?

  • Transparency: 0 = When overlapping, Proposed on top, Existing Hidden
  • Transparency: 255 = When overlapping, Existing on top, Proposed Hidden
  • Transparency :155 (or anything in middle) = Both visible

What does the color of the dot indicate in APSH Waldram diagram?

  • Dark Blue dot indicates winter sun
  • Dark Yellow dot indicates summer sun
  • light Blue dot indicates blocked winter sun
  • light yellow dot indicates blocked summer sun
  • Dot with hole indicate that the dot is seen by more than one window.

What are the steps to Preview the results?

  • Select the required tab Window(s)/Room(s)/Amenity
  • Tick Self Test option if the result is only for Proposed group
  • Use a Group or Select items on combo box below the calculation name
  • VSC and APSH results are shown together and uses VSC group
  • Click Preview
  • Note: There is no need select the tick boxes next to the calculation name for Preview

What are the steps to Export the results?

  • Select the tick boxes next to the calculation name to be exported. (ROL, DD, ADF, VSC, APSH, Amenity or ALL)
  • Tick Self Test option if the result is only for Proposed group
  • Tick CSV Report option to export the results in csv format
  • Use a Group or Select items on combo box below the calculation name
  • VSC and APSH results are exported in same sheet for (default) report and uses VSC group. Bespoke reports may vary.
  • Click Export to File

How to use tags from Project Settings in Reports?

  • Replaceable tags can be inserted in Excel template including header and footer. They should be specified as <tag> e.g. <Project Name> <Report Title>. The values can be defined in Project Settings dialog.

What are the steps to add results to the label?

  • Select entity type Window/Room/Amenity
  • Tick Existing, Proposed or both options as necessary
  • Select the result to be added VSC/APSH/ADF/DD/ROL
  • Tick Show Failures option to highlight the failed results with red coloured labels
  • Click on Add Labels to add/update labels

Why are Mesh colours not seen in Autocad?

  • Mesh objects are visible by layer colour in Wireframe view. Change view to Realistic/Shaded to see the individual Mesh face colours.
    To see Mesh face colours in Wireframe view, explode the Mesh so that it gives faces whose colours can be seen in any view.

Rendered image is too bright. Most objects in the image are washed out and are not visible.

Adjust the exposure using the slider in Render dialogue. This linearly changes the image brightness. if the image is too bright or too dark, the level of the brightness can be adjusted
by changing the exposure level through the slider.

In Path tracing mode the slider updates the image immediately without a need to render the image.

In Radiance mode, the exposure takes effect after rendering it image again. Alternatively you may tick “Open Radiance image with wxfalsecolor” option in Setting > General tab to open the Radiance image in wxfalsecolor application to set the exposure directly. This  immediately updates the image without re-run.

The colour banding legend info font on the image is too big.

The legend font for “Potential Glare” images are set via Settings dialogue > Color tab > Font dialogue.
The hours text font name and size displayed on the “Potential Glare” image is set through Render dialogue > Settings tab > Glare > Font dialogue

Dialog Commands

  • waldOpens the Calculation dialog.This dialog can be used to convert the model and to run various calculations.
  • rgstOpens the Register dialog.This dialog can be used to register and update rooms, windows and amenities.
  • rptOpens the Report dialog.This dialog can be used to preview and export various calculation results.
  • lblsOpens the Label dialog.This dialog can be used to add and modify reference labels, results and solids to rooms, windows and amenities.
  • facadeOpens the Facade dialog.This dialog can be used to register the facades, unRegister facades and to clear Facade results.
  • mbsrndrOpens the Render dialog. This dialog can be used to render images.
  • cutbackmbsOpens the Cutback dialog.This dialog can be used to facilitate a cutback.

All dialogs consist of menu to access general settings, project specific settings and software version information.

Scripts for dialogs

  • cnvrtmbsAllows to convert Groups.This command can be used to quickly convert the groups
  • waldscriptAllows to run calculations from saved scriptsThis command can be used to quickly run calculation if it is being run repeatedly. The script can be saved locally or
    in a shared folder.
  • rptscriptAllows to export reports from saved scriptsThis dialog can be used to quickly export results. The script can only be saved locally.

Both waldscript and rptscript allow to save groups or selected entities

Utility Commands

  • SkyScannerCommand to visualize the irradiance and sky component calculation from centre of the window
  • SunAPSHCommand to visualize APSH calculation from the centre of the window.
  • HrSCCommand to calculate ROL and DD for a given set of points under uniform and CIE overcast sky
  • CalcIrradCommand to calculate daylight factor for given points. Settings are taken from Settings dialogue.
  • CreateSectionLayersCommand to create layers required for Sections
    This command can be used to automatically create layers for section. Layers will be created in the format of BuildingName_FloorName_Plans for all floors of all buildings in the model. User can change the _Plans suffix if needed. It also creates a layer property filter named plans
  • CalcshortestdistanceCommand to check distance to the nearest obstruction from centre of the window (View calculation).
  • CalchzangleCommand to check % of room (utilised area) with minimum, medium and Maximum horizontal sight angle (View calculation).
  • LayersseenCommand to check number of layers seen (sky layer, landscape layer, ground layer) from the selected point in a room (View calculation).
    Sky layer is indicated with yellow color, Landscape layer is indicated with green color and Ground layer is indicated with red color.
  • CnvrtMBS 

    Converts all or selected groups

Debugging Commands

  • MBSVersionCommand to show current version of Waldram Tools Software
    This command shows Waldram Tools version, Company Code and last update date.
  • MBSJobFolderCommand to open waldram job folder for the active model
    This folder contains the exported report files, images, backup results, log file and model specific settings.
  • MBSConfigFolderCommand to open waldram config/settings folder for the current user
    This folder contains user specific settings, master copies of model specific settings, report templates and other software related files.
  • MBSLogFileCommand to open the waldram log file for the active model
    The log file contains debug information and error log related to the model.
  • RoomInfoCommand to show basic information about registered Room
    This command shows Room id, attached windows, setting values and calculation results.
  • WindowInfoCommand to show basic information about registered Window
    This command shows Window id, attached room, setting values and calculation results.
  • DrawRoomGridPntsCommand to draw grid points for rooms
    This command can be used to draw grid points used for the calculation of contours. It is useful to check the grid points are in correct location in the model when the contour doesn’t appear after running calculation.
  • DrawAmenityGridPntsCommand to draw grid points for amenities
    This command can be used to draw grid points used for the calculation of contours. It is useful to check the grid points are in correct location in the model when the contour doesn’t appear after running calculation.
  • DrawModelGridCommand to draw grid points for the whole model
    This command can be used to draw grid structure of the whole model created by the conversion process.
  • DrawRoomTriCommand to draw triangles for rooms
    This command can be used to draw triangles used for the calculation of contours.
  • DrawAmntTriCommand to draw triangles for amenities
    This command can be used to draw triangles used for the calculation of contours.
  • DrawModelTriCommand to draw triangles for the whole model
    This command can be used to draw triangles created by the conversion process.
  • MinBBCommand to draw minimum bounding box for windows
  • TraceCommand to visualize Raytracing and material behaviour
  • NoResultsCommand to highlight entities with 0 or no results.
  • CheckLayersForRegCommand to check if room, window, building polylines are in correct layer for registration
    This command also checks if the building name block is in correct layer.

Error Fixing Commands

  • SpinWindowsCommand to display Window normals and fix inside facing windows.This command can be used to rotate windows, which are facing towards the room, by 180 degrees to make them face away
    from the room.
  • SlopeWindowsCommand to display Window which are inclined below certain angle and to remove the inclination.This command can be used to remove inclination from windows which are accidently inclined by few degrees.
  • CExtDicCommand to fix corrupted extension dictionary for windowsThis command is useful for example if waldram images are created but no results appear on report.
  • CopyLinkW2RCommand to fix Room to Window linkThis command can be used to fix Room-window link when Window-Room link is correct but Room-Window link is broken.