Ventus User Manual

1.1. Introduction

Ventus is a graphical user interface for CONTAM version 3.4.0.1. CONTAM is closely integrated into Ventus, and is developed at the National Institute of Standards and Technology (NIST).

Below is an overview of CONTAM from the NIST website:

Over time, more of the capabilities in the CONTAM simulator will be exposed through the Ventus interface.

The Ventus interface provides immediate input feedback and ensures the correct format for the CONTAM input file.

In summary, Ventus helps you quickly and reliably build complex pressurization and ventilation models.

1.2. Download and Install

You can download the current version, sign up for a free trial, and purchase the software from the Ventus Support Page. This page also provides instructions for installation and activation. Troubleshooting info can be found on the Ventus Knowledge Base. There is no functional difference between the trial version of Ventus and the full version, the only limitation is the trial license duration.

When installing Ventus, the installer will either upgrade an existing version or install Ventus if it doesn’t exist yet.

Administrator privileges are required to install Ventus. This is necessary because the installer adds processes to the operating system for license management and CONTAM simulation. The Ventus installer will also add Windows Defender exclusions for the bundled CONTAM executables in order to avoid performance issues related to Windows Security.

Ventus will regularly check for and notify the user of available updates to the software when configured to do so. By default, Ventus will check for updates on startup and display the relevant information in the Check For Updates dialog when one is available.

Users can also access this dialog by navigating to Help › Check For Updates.

The dialog can be disabled on startup by unchecking Check for newer version on startup. Users can skip the current update by clicking the Skip Update button, preventing update notifications until a new version is released beyond the latest version.

1.3. Some Modeling Suggestions

1.4. Additional CONTAM Documentation

In preparing this manual, we have liberally used descriptions from the CONTAM User’s Guide (Dols and Polidoro 2020). Links to the CONTAM Users Guide and the CONTAM Technical Reference, are included in Ventus on the Help menu. You can also download documentation, executables, and verification and validation examples from the CONTAM webpage.

1.5. Contact Us

Thunderhead Engineering
403 Poyntz Avenue, Suite B
Manhattan, KS 66502-6081
USA

Sales Information: sales@thunderheadeng.com
Product Support: support@thunderheadeng.com
Help Site & Forum
Phone: +1.785.770.8511

2.1. Object Tree

The Object Tree helps you quickly find objects and data that are not always easily accessible from the Workspace.

The Object Tree is arranged in the following groups:

The buttons directly above the Object Tree performs the following actions:

The Level selection box above the Object Tree (see the top of Figure 2) can be used to manage levels. Any time a Zone is created it is added to a level group matching the current selection in the Level box. Changing the selection in the Level box will cause the newly selected level to be shown and all other levels to be hidden. Also, the Z property for all drawing tools will automatically default to the height of the level currently selected in the Level box. The visibility of any object or group of objects can always be manually set using the right-click context menu. This technique is useful if you want to show two levels at the same time (e.g. when creating a stairwell shaft).

There are additional options available to manage level view and selection in the Level Creation panel (Figure 17), which is detailed in Section 7.1. This panel is available when nothing is selected and no tools are active.

The Show lower level option in the Active Level section, when selected, will always show the level immediately below the current active level. This is to help with drawing snap references and to check alignment of zones and components in the model. If unselected, the level immediately below the active level will be hidden.

If Show lower level is selected, then an additional option will be available to Limit selection to active level. This will limit selection to only items that belong to the current active level.

2.1.1. Groups

Groups can be used to hierarchically organize the model. Groups can only be seen in the Object Tree. Users can nest groups inside other groups, allowing the user to work with thousands of objects in an organized way. When the user performs an action on a group, that action will be propagated to all objects in the group.

2.1.1.1. Creating Groups

To create a new group:

1. Right-click the desired parent group in the Object Tree
2. Select New Group or select New Group Node from the Model menu.
3. A dialog will display allowing the user to select the parent group (which will automatically be selected if performed from the right-click menu) and a name for the new group.
4. Click "OK" to create the new group.

2.1.1.2. Adding Objects to Groups

An object can be moved from one group to another at any time.

To change an object’s group:

1. Drag the object to the desired group in the Object Tree or right-click the object and select Change Group.
2. This will show a dialog that will allow the user to choose the new group. The options shown for the new group will only be valid groups for which the group can be changed.
3. Select "OK" to change the group.

2.2. 2D/3D Workspace

The 2D/3D Workspace as shown in Figure 5 is the panel where much of the modeling work is performed in Ventus. The Workspace contains tools to draw Zone geometry, Flow Paths, AHS zone point locations and navigate the model. There are two camera projection modes. The main difference between the two modes is that the 3D mode allows the model to be viewed from any direction, whereas the 2D mode only allows viewing from one, orthographic direction. In addition, the 3D mode contains no snap grid, whereas the 2D mode does. The 3D mode is entered by selecting the perspective camera, , and the 2D mode is entered by selecting one of the orthographic cameras, , , or .

Several buttons are located at the top of the Workspace, providing various camera modes, display options, and navigation modes. The panel under this is known as the Property Panel and is selection context-sensitive. If a drawing tool is selected, it will show properties that can used to help draw. If no drawing tool is selected, and an object or several objects are selected, this panel will show the properties relevant to the selection. The panel of buttons on the left shows move/copy and drawing tools. The small panel at the bottom displays messages relevant to the current tool.

2.3. Resetting the View

At any time, the camera can be reset by pressing CTRL+R on the keyboard, or selecting Reset All tool, . This will cause the entire model to be visible in the current view. For all navigation tools but the Roam tool, reset will make the camera look down the negative Z axis at the model. For the roam tool, however, reset will make the camera look along the positive Y axis at the model.

The camera can also be reset to the current selection at any time by pressing CTRL+E. This will cause the camera to zoom in on the selected objects and the orbit tool to rotate about the center of their bounding sphere.

2.4. Filling the View

Very similar to resetting the camera, the view can be fit by pressing F on the keyboard or selecting the Fill View tool, . The difference between the Fill View and Reset All tools is that filling the screen does not change the view angle of the camera. Instead, the camera will recenter/rezoom to fit the screen.

3.1. Drawing/Editing Tool Overview

Ventus provides several drawing and editing tools. These tools are located on the drawing toolbar at the left side of the Workspace as shown in Figure 6.

The sections referenced below provide more detail on the specific tools available.

For each tool there are often two ways to create its object.

The property panel will update the graphical preview immediately to reflect changes in the input. This allows fine-grained control in creating the object.

Drawing can be performed in both the 2D and 3D modes. The 3D mode allows the user to see the model from any angle, but most tools restrict drawing in the XY plane. The top view completely restricts drawing to the XY plane, but it also displays an optional snap grid. The snap grid size can be set under View › Edit snap grid spacing, and it can be turned off by deselecting View › Show Snap Grid.

3.2. 2D Versus 3D Modes

There are some key differences between drawing in the 2D and 3D modes. The 2D mode is useful when drawing should be restricted to one pre-defined plane. It is also useful for lining up objects along the X, Y, or Z axes. The 3D mode is useful when an object such as a flow path needs to be snapped to the face of an obstruction or if the user would like to build objects by stacking them on top of one another.

3.2.3. Projected Drawing in 3D Mode

Once the drawing plane for a tool has been established by moving the cursor to a general position, a dotted line will appear and show how the snapped point was projected to another plane, in helping determine an accurate position. For instance, Figure 7 shows a new flow path being drawn to a side wall of the zone.

3.3. Object Selection

Ventus relies heavily on the idea of selected objects. For almost all operations, the user first selects an object(s) and then changes the selected object(s). The Selection Tool () is used to select objects.

Once objects have been selected, the user can modify the object using the menus.

Selection can be made in any of the views using the Selection tool. Multiple objects can be selected using the Ctrl key or click and drag to define a box. In the Object Tree, the Shift key can be used to select a consecutive list of objects.

3.4. Double-Click to Edit

Double-clicking on an object opens the appropriate dialog for editing the object properties, when such a dialog exists.

3.5. Context Menus

A right-click on a selection displays a context menu. This menu includes the most common options for working with the object. The user may also right-click on individual objects for immediate display of the context menu.

3.6. Editing Objects

Nearly all geometric objects can also be graphically edited in the Workspace with the Select/Manipulate Tool ().

Editing is performed through an object’s editing Handles. Handles appear on an object either as a blue dot as shown in Figure 8 or a face with a different color. The dots indicate a point that can be moved in either two or three dimensions. A discolored face indicates that a face can be moved or extruded along a line.

To graphically edit an object, perform the following:

3.7. Transforming Objects

Ventus provides a variety of tools to transform geometry objects. With the transform tools, users can move, rotate, and mirror objects.

3.8. Measuring Length/Distance

Ventus provides a Measure Tool () to measure distances in the model.

To measure a distance, perform the following:

3.9. Snapping

Snapping is one way to precisely draw and edit objects. It is the process of finding some element in the scene, such as a vertex or edge close to the cursor, and snapping the cursor to that element like a magnet.

In Ventus, snapping can be performed against objects in the model and orthographic constraints. The 2D mode additionally provides a sketch grid and polar (angle) constraints. If a snap point is found, an indicator dot, shown in Figure 9, will appear at the snap point.

By default, snapping is enabled. It can be disabled by holding ALT on the keyboard while using a drawing/editing tool.

3.10. Undo/Redo

All geometric changes to the model can be undone and redone using the Undo () and Redo () buttons, as well as Ctrl+Z and Ctrl+Y, respectively.

3.11. Copy/Paste

Select an object to copy, then either use Ctrl+C or Edit→Copy to copy. Alternately, right-click on an object to display the context menu with Copy.

Either use Ctrl+V or Edit→Paste to paste a copy of the object. Alternately, right-click on an object to display the context menu with Paste.

3.12. View Options

Ventus provides a variety of view options for displaying both model geometry and imported geometry that can also aid with drawing. This includes options for rendering geometry, coloring zones, and setting the transparency of zones.

3.12.2. Render Options

In the toolbar above the properties window in the Workspace, there is a drop-down as shown in Figure 10 and buttons as shown in Figure 11 that control how geometry is rendered.

Wireframe

This renders geometry with only outlines.

Solid

This renders geometry without Materials.

Solid with Outlines

This renders geometry without Materials, but with outlines.

Realistic

This renders geometry with Materials.

Realistic with Outlines

This renders geometry with Materials and outlines.

X-Ray

This is similar to the Realistic with Outlines option, except it makes all geometry semi-transparent.

From left to right in Figure 11, the buttons are:

Show Zones

This toggles the visibility of all Zone geometry.

Show Imported Geometry

This toggles the visibility of all imported 3D geometry.

Show Flowpaths

This toggles the visibility of all flowpaths in the model.

Show Flowpath Area

This toggles the visibility of the projected/calculated area of certain flowpath types.

Show AHS Zone Points

This toggles the visibility of all Air Handling System zone points.

Show Results

Show simulation results vectors in the Workspace.

3.13. Scenarios

In some parts of the Ventus user interface, individual single-value parameters can be entered as a list. In these cases, entering multiple values causes Ventus to run multiple scenarios as a batch. When running a multiple scenario model, Ventus will automatically calculate the Cartesian product of scenario parameter assignments, name the scenarios based on the parameter values, run individual simulations for scenario, and show all results in the Object Tree.

Examples where parameters can be entered as multiple scenario parameters are the Ambient Temperature and Wind Direction values in the Weather and Wind dialog, on the Weather tab.

3.14. Snapshots of Display

Images of the current display can be saved to a file by opening the File menu and clicking Snapshot. The user can specify the file name, image type (png, jpg, tif, bmp), and the resolution. A good choice for image type is Portable Network Graphics (png).

3.15. Preferences

Ventus preferences can be set by going to the File menu and choosing Preferences. Any changes to the preferences will be set for the current Ventus session and be remembered the next time Ventus is started.

3.15.1. General Preferences

Keyboard Shortcuts

The Keyboard Shortcuts dialog is launched from the Ventus preferences panel. These preferences bind combinations of modifier keys (ALT, CTRL, SHIFT, etc.) with other key presses to activate Ventus actions.

The dialog is split into sections similar to those used in the Ventus toolbar menus. There are additional tabs for shortcuts related to tool activation, object selection, and context sensitive actions.

To change the keybinding for an action, click the value in the Key Press column. This launches an editor window (Figure 13) with four options.

Awaiting Input

Press a key to assign the desired keybinding and map it to the action.

Cancel

Exit the editor window without making any changes.

Reset

Assign the action it’s default keybinding.

Clear

Remove the currently assigned keybinding from the action.

Some keyboard shortcuts are used by Java UI components. If a shortcut does not result in the expected behavior, it may be in direct conflict with a preexisting Java shortcut. It is best practice to avoid these conflicts (Default Swing key bindings).

Autosave

Instructs Ventus to periodically create a backup of the current model that is deleted when the Ventus model is closed. This backup is useful in case Ventus crashes or the computer loses power. The backup file is stored in the same directory as your Ventus file. If your working Ventus file (testing.vnts for example) becomes corrupted, then you can find the file that starts with a tilde like ~testing.vnts. This file is sometimes preferred if you have a crash, as it will be the most up-to-date version of your work before your crash. If it cannot be opened or results in an immediate crash, there is another backup file described next that is the second-best option. The default setting enables this feature and saves every 10 minutes. In some cases, when working with large models, this can cause unexpected delays during the save and some users prefer to disable the feature and save manually.

Create Backup on Open

Controls whether Ventus makes a backup copy of the Ventus file after last successfully opening it. This backup remains on disk when the main Ventus file is closed, and so it can be used in case the main file somehow becomes corrupted. The backup file is stored in the same directory as your Ventus file. If your working Ventus file or the automatic backup file becomes corrupted, then you can find the autosave backup file that has a tilde in the file extension, like testing.~nts. Rename (recommended) or delete your current working file, then change the file extension on this backup file, changing the tilde in the extension (.~nts) to a v character to get .vnts. You can now open the new .vnts file as you normally would.

3.16. Configuration Files

Ventus stores data related to user preferences in a file called Ventus.props. By default, this file can be found in one of the following locations.

%APPDATA%\Ventus\Ventus.props
%PROGRAMDATA%\Ventus\Ventus.props

If at least one of these files exists, Ventus will use it to load the user preferences. If both files exist, Ventus will load user preferences from both files, giving preference to the file located in the APPDATA folder. This way the preference file located in the PROGRAMDATA folder can be shared among multiple machines, and the file located in the APPDATA folder on each machine overrides the shared settings.

The PROPS file is stored in a plaintext format, and can be viewed or edited with any conventional text editor. While it is not recommended to edit the file directly, some troubleshooting techniques may involve deleting the PROPS file so that a new one can be created from scratch by Ventus.

Configurations for hotkeys in Ventus is stored in a separate file named keybindings.json located in the APPDATA folder.

3.17. Units

Models can be created in either English or the International System of Units (SI, metric). To select a system of units, on the View menu, click Units, then click the desired unit. There are also toggle buttons to change units in the top toolbar of the UI. Ventus will automatically convert your previous input values into the unit system you select.

3.18. Color Schemes

To select a Default, Black Background, White Background, or Custom color scheme, on the View menu, click Color Scheme. The custom color scheme is defined in the Ventus.props file in the Ventus installation directory (For Windows 10+ look in %USERPROFILE%\AppData\Roaming\Ventus\Ventus.props while some older operating systems use C:\Program Files\Ventus).

Colors.Custom.axis=0xffff00
Colors.Custom.axis.box=0x404040
Colors.Custom.axis.text=0xffffff
Colors.Custom.background=0x54596E
Colors.Custom.background2=0x2E3348
Colors.Custom.boundary.line=0xffffff
Colors.Custom.origin2D=0x737373
Colors.Custom.snap.point=0xff00
Colors.Custom.snapto.grid=0x404040
Colors.Custom.snapto.points=0xc0c0c0
Colors.Custom.text=0xffffff
Colors.Custom.tool=0xff00
Colors.Custom.tool.guides=0x7c00

4.1. Creating a New Ventus Model

When Ventus is started, it begins with an empty model. You can close the current model and create a new empty model by opening the File menu and clicking New. Ventus always has one (and only one) active model.

4.2. Saving a Ventus Model

The Ventus model file (referred to as VNTS, with the extension .vnts), is stored in a binary format that represents a Ventus model. The Ventus model contains all the information needed to write a CONTAM input file. This format is ideal for sharing your models with other Ventus users.

To save a new model:

4.3. Open a Saved Ventus Model

To open a saved model:

A list of recently opened files is also available. To open recent files, on the File menu, click Recent Files, then click the desired file.

Ventus has an auto-save feature which stores a copy of your current model every 10 minutes. This file is automatically deleted if Ventus exits normally, but if Ventus crashes, you can recover your work by opening the autosave file. It can be found either in the same directory as your most recent VNTS file, or in the Ventus installation directory if your model was unsaved.

4.4. Exporting CONTAM Models

Ventus also allows you to export the current model to a CONTAM PRJ file. You can manually edit the file to take advantage of advanced CONTAM features, or to easily transfer the input file to a different machine or special version of CONTAM.

To export an CONTAM PRJ file:

The file exported by Ventus will be compatible with version 3 of CONTAM.

4.5. Working with Images

Working with background images requires the user to draw zones over the background image (Figure 14). Because the drawn zone geometry will cover the background image, it may be preferable to make the zone geometry transparent. This can be accomplished by selecting the drawn zones and lowering the opacity in the property panel. Figure 15 shows a background image with rooms and doors drawn on top, with a lowered opacity for the drawn rooms.

To draw zones on top of a background image, refer to Section 8.1.2.

4.6. Importing CAD Files

Ventus can import geometry from several CAD formats, including buildingSMART’s IFC format for Building Information Models (BIM), AutoCAD’s DXF (Drawing Exchange Format), DWG, FBX, DAE, OBJ, GLTF/GLB 2.0, and STL files. Each type of file provides a variety of geometry that can either be directly represented as obstructions or as drawing guides in the Ventus model.

CAD import appends the data to the current model. This facilitates the ability to import data from several CAD files into one Ventus model. This is useful when there is one blueprint per floor of a building or a 3D building has been split into several sections, each in a separate file.

To import one of these files, under the File menu, select Import and select the desired file.

Once the file is imported, Ventus creates a hierarchy of groups and objects, such that there is one top group, named after the file. The next levels depend on the imported file type. For non-DWG/DXF files, the structure will mimic the node structure in the source file. For DWG/FXF files, the next level contains a group for every layer containing geometry. Under each layer group there are one or more objects representing the entities in the file. The following illustrates the hierarchy as it would appear in the Object Tree:

If the DWG/DXF file contains a block insert and the block contains entities from multiple layers, the block insert is split into several Ventus objects, one for each layer of the block’s originating entities. If all the entities in the block are from the same layer, however, there will be one resulting Ventus object that will belong to the group corresponding to the block’s entities' layer rather than the block insert’s layer.

5.1. Advanced Material Properties

Additional material properties can be edited by pressing the Advanced Materials button. This will show the Advanced Materials Dialog for the currently selected material.

Most properties in this dialog can be specified as either a constant color/value or as a texture image. For those properties that represent a single value as opposed to a color, such as the Roughness value for PBR workflow, a dropdown next to the texture chooser can be used to pick which color component is the source of the values. This is useful when multiple properties are packed into a single image, but in different color components. For instance, say the PBR parameters, metallic, roughness, and ambient occlusion, are packed into the red, green, and blue color components of a single image. In this case, the same image can be chosen for the metallic, roughness, and ambient occlusion textures. The dropdowns next to each texture would be set to R, G, and B, respectively.

The following material properties can be edited from this dialog:

Depending on which workflow is selected, the following additional properties are provided:

6.1. Managing Views

Views are managed in the Object Tree. From there, they can be created, deleted, grouped, rearranged, etc.

A view can be created in one of the following ways:

This will add a new view to the model, saving the current camera viewpoint into the new view. The new view will become the active view.

To delete a view, select it in the Object Tree and in the Edit menu, select Delete. A view can only be deleted if it is not active.

To activate a view, perform one of the following:

Activating a view will restore all its saved state as described in the following sections.

View settings can be copied or moved between views. To copy settings select Copy, located in either the Object Tree or in the Edit menu. To paste the settings to another view, select the desired target view and in the Edit menu select Paste. To move settings from one view to another, in the Object Tree, drag the setting to the desired view.

6.2. Viewpoints

Each view can have one viewpoint associated with it. A viewpoint includes the 2D or 3D camera’s position, orientation, zoom, and camera type (3D versus 2D). When a viewpoint is saved, the current navigation tool is also saved with the view (Orbit, Roam, etc.). A viewpoint appears in the Object Tree as a child item of a view and is labelled Viewpoint.

A viewpoint is automatically saved to newly created views. A viewpoint can also be explicitly saved in one of the following ways:

The scene camera can be reset to a viewpoint in one of the following ways:

A viewpoint can be removed from a view by selecting the item, Viewpoint, in the Object Tree and deleting it.

When a view with a viewpoint is activated, the following occurs:

7.1. Automatically Creating Levels

When nothing is selected in the model and no tools are active, the Level Creation panel is shown, as in Figure 17. This panel controls the automatic creation of levels and automatic sorting of new objects into levels. It also provides some options for level view and selection.

The following scenario demonstrates how objects are organized when auto-sort and auto-level-creation are enabled (organization of the model is shown in Figure 18):

In this example, only zones were created. The levels were automatically created and the zones were automatically sorted into the appropriate ones.

7.2. Manually Creating Levels

Levels can also be created manually at any time.

There are two other options in this dialog:

By default, the name of the level is Level \(x\) where \(x\) is the working plane of the level.

7.3. Changing the Active Level

To change the active level, click the level drop-down box as shown in Figure 19, and select the desired level. This will make that level active and all other levels non-active.

Whenever the active level is changed, the following additional changes take place in the model:

7.4. Showing All Levels

To show all levels click the level drop-down box as shown in Figure 19, and click <Show All>.

This will additionally show all sub-objects of the levels groups, and it will set the import filter to the union of all the levels' filters.

7.5. Level Properties

To edit a level’s properties, first select the desired level. The property panel as shown in Figure 20 will appear, showing the level’s name, its Working Z location, and the Z clipping planes (Z Min Filter and Z Max Filter) for imported 3D geometry.

It also shows some statistics of the level including the total area of the level (Area).

8.1. Zones

CONTAM calculations are performed between zones. A zone is a volume of air that is typically contained within the bounds of a room. Zones are the basic units between which airflow is calculated. Zones have properties that determine airflow, including air temperature and pressure, as well as flow paths (Chapter 10), which define the air leakage relationship between two adjacent zones.

8.1.1. Zone Properties

The following properties are available on the Zone Panel (Figure 22) for zones:

Pressure

Ventus currently supports variable zone pressure, which is determined at run time and cannot be explicitly set.

Temperature

The air temperature within the zone. A default value can be set in the Simulation Parameters dialog (Section 13.1).

8.1.2. Room Tools

Zones in Ventus are created using the Room Tools. The volume of a zone is determined by the floor area of the room and its ceiling height. The ceiling height of a zone can extend to either:

1. The default room height.
2. The floor of a zone that exists immediately above it in 3D space.
3. A ceiling that exists immediately above it in 3D space.

Ventus provides two tools for adding new zone geometry:

Polygonal Room Tool

The Polygonal Room tool allows for the creation of complex shapes with any number of vertices (Figure 23).

Left-click anywhere in the model to set the first point, and continue left-clicking to add more points to the polygon. When at least three points are defined, right-clicking will close the polygon and complete the shape.

Alternatively, X,Y coordinates can be entered from the keyboard with the Add Point and Close Polygon buttons from the property panel.

Rectangular Room Tool

The Rectangular Room tool creates simple rectangular geometry by left-clicking two points in the model (Figure 24).

The rectangular area can also be created by entering coordinates for two points in the property panel and clicking Create.

In addition to creating new areas, both of these tools can be used on existing geometry to create negative areas. Creating new geometry over existing areas removes any interfering portion from those areas. The newly created geometry can then be deleted, leaving the negative space behind.

8.2. Walls

Wall tools are available in Ventus to split existing rooms into more than one zone.

8.2.1. Thin Walls

Thin, internal walls or boundaries can be added to zones with the Thin Wall tool .

To use this tool, click two points in the model as shown in Figure 25. Ventus will attempt to connect these two points with an internal boundary edge.

8.2.2. Thick Walls

The wall tool can also be used to add internal walls or boundaries to zones (Figure 26). It differs from the thin wall tool in that it operates by subtracting area from any room that lies in its specified Z plane. This subtraction will generally leave a gap in space in the zone the wall tool is separating. This gap will be determined by the thickness property of the wall tool which can be set by the user.

To make a thick wall:

1. Click on the wall tool.
2. Enter the desired wall width in the property panel.
3. Click or click-drag the two points the wall is to pass through. Holding the shift key will switch between alignment left and right of the defining line.

9.1. Powerlaw Models

CONTAM provides a number of powerlaw models for modeling mass flow for different types of common building features. Each flow path element will model one-way flow using one of these powerlaw models. The general mass flow powerlaw model is of the form:

\(F = C(\Delta P)^n\)

Where \(F\) is the Mass Flow Rate, \(C\) is the Flow Coefficient, \(\Delta P\) is the Pressure Difference across the flow path, and \(n\) is the Flow Exponent. These values are either taken as input or statically derived during the creation of flow path elements. The following powerlaw models are available in Ventus:

10.1. Creating a Flow Path in Ventus

Flow paths can be created in Ventus using the Flow Path Tools.

There are two flow path tools in Ventus, one point and two-point (). A one point flow path tool is used to create a flow path by choosing one point on a face. And a two-point flow path tool is to create a flow path between two walls.

To draw a flow path with the one point flow path tool perform the following:

To draw a flow path with the two-point flow path tool perform the following:

10.2. Flow Path Properties

The following properties are available on the Flow Path Panel for a flow path: (Figure 28):

12.1. AHS Zone Point Tool

The AHS Zone Point Tool () can be used to add supply or return points in order to add or remove gasses from the zones they are added to.

To add a supply or return point:

13.1. Simulation Parameters

Some options that impact the entire simulation rather than specific elements like flow paths and zones can be controlled using the Simulation Parameters dialog.

To edit or review simulation parameters: on the Analysis menu, select Simulation Parameters.

Using this dialog, edit or review the following parameters:

13.2. Run Simulation

To run a simulation: on the Analysis menu, select Run Simulation.

If the model has not yet been saved, a prompt for the location to save the VNTS file will appear. The simulation data will be created in a subfolder of this save location. If the model has previously been saved to a VNTS file, no prompt will appear and Ventus will not automatically save simulation data.

When the simulation is launched, the Run Simulation dialog will appear. This dialog displays scrolling text associated with running the executables responsible for performing the simulation.

Typically, a simulation will contain output from two commands: one for contamx.exe which is the simulator and one for prjread.exe which is used to convert the SIM binary output file to human-readable output that will be collected by Ventus.

Most simulations are completed within just a few seconds.

To keep a record of the output text shown in the Run Simulation dialog, click Save Log.

To close this dialog and review simulation results, in the Run Simulation dialog, click OK.

14.1. Results in the Object Tree

After running a simulation, results data is added to the Object Tree for viewing and analysis. All output data is available for viewing as text output data.

To view text output data:

When finished, you can close the browser window and reopen at any time. The temporary file displayed by the browser will be deleted when Ventus exits.

For convenience, the node of interest can also be double-clicked to display text output data.

To view Vector data in the Workspace:

By default, vector data for the first simulation will automatically be shown and this procedure will only be necessary when using multiple scenarios.

Any results data appearing in the Object Tree has been integrated with the Ventus data model and will be saved with the VNTS file. It is not necessary to keep any simulation files other than the VNTS file when sharing or archiving simulation data. However, Ventus does not automatically save the VNTS file when simulations are run. This makes experimentation with what-if simulation adjustments convenient but does impose the risk of losing results data if the VNTS file is not re-saved after running the simulation.

The following table describes each of the Object Tree results nodes:

In the nodes above, id is the scenario identifier. For single scenario simulations, this identifier will match the VNTS filename. For multiple scenario simulations, all scenarios will be added to the Object Tree and their identifiers will additionally include a text representation of the scenario parameter values used to generate the input for that simulation.

14.2. Results in the Workspace

Ventus uses the SQLITE3 simulation output data to identify pressure change (dP) and flow volume (Flow0) data associated with each flow path. This data is in the Vector Data results subtree and appears in the Workspace as colored vectors rooted at the corresponding flow path.

The direction of vectors displayed in the Workspace is determined by the direction of positive flow for the flow path and the sign of the output data. For example, if a pressure difference vector is positive and the flow path indicates that the direction of positive flow is from Zone A to ambient, that vector will extend from the flow path into the ambient zone. If the pressure difference vector is negative, the vector will be drawn extending into Zone A.

The position of the vector origin for single-point flow paths is the location of the flow path. In situations where a flow path connects two zones across a gap, the vector will be drawn originating from the flow path point attached to the zone in the direction of the vector.

The length of vectors displayed in the Workspace is proportional to the vector with the greatest magnitude in that simulation. Lengths for pressure differences and flow volume are calculated independently.

When viewing results data, the flow paths themselves can sometimes obscure or crowd vector data and it can be helpful to hide them.

To hide flow paths: in the Object Tree, right-click Flow Paths and select Hide.

To restore flow path visibility: in the Object Tree, right-click Flow Paths and select Show. If this shows all flow paths and not just those in the current shown level, toggle the level selection box to restore the level visibility filter.

15.1. How to Activate a Node-Locked License

15.1.1. Online

With the License dialog open, as shown in Figure 29:

1. Click the Online button under the 'License File' option.
2. Paste the activation key that you received from Thunderhead and click OK.

15.2. Floating License Server Problems

The floating license server provides an administration web service that can assist with diagnosing many floating license problems.

If the license server is installed on the local machine, the license administration server can be accessed at the following web address:

http://localhost:5054

If the license server is installed on a remote machine, replace "localhost" with the name of the remote machine (i.e. the host name of the floating license server).

Once you have opened the Reprise License Server Administration page, you can use the Status commands to attempt to debug the license server problem yourself, or you can send a diagnostic report to support@thunderheadeng.com for assistance. To generate a diagnostic report:

If you are having trouble getting the License Manager to work as expected, please see the Floating License Manager Knowledge Base Articles and then contact support@thunderheadeng.com as needed.

15.3. Licensing/Registration Problems

If you experience trouble registering Ventus contact support@thunderheadeng.com.

15.4. Video Display Problems and Crashes on Startup

Ventus utilizes many advanced graphics card features in order to provide accelerated and enhanced display of models.

Sometimes these graphics features combined with certain display drivers can cause display issues or crashes on startup. The first step in these cases is to ensure you have the latest operating system updates and graphics drivers installed. If you do, and you still have display problems or crashing on startup, you can start Ventus in Safe Mode, which disables several graphics features.

To start in Safe Mode:

If you encounter display problems or crashes, please let us know the make/model of your video card and what video driver you are using, even if Safe Mode fixes your issues. That will help us improve the software in future updates.

15.5. Memory for Large Models

When running large models, it is possible that an out of memory error will be encountered. If this occurs, you can increase the default Java heap size. In our experience, the maximum size can be specified to approximately 70% of physical memory. By default, Ventus will specify a java heap size of 50% of physical memory.

To specify the memory, you can either run from a command line or change the Start Menu shortcut properties. To run from a command line, open a command window and then go to the Ventus installation directory (usually C:\Program Files\Ventus 2023). Execute Ventus on the command line using the -JXmx argument. In this argument, the J specifies that the command will be passed along to the Java VM, not Ventus. For example, ventus -JXmx1200m will request 1200 MB of memory.

To edit the Ventus shortcut properties . Right-click on the Ventus icon . Select the Shortcut tab . Edit the Target by adding a space and -JXmx1200m to the end of the Target.

A typical Target will then read C:\Program Files\Ventus 2023\ventus.exe" -JXmx1200m.

15.6. Additional Support Resources

If you are unable to resolve your issues from the suggestions in the table, please visit the Thunderhead Engineering Help Site.

Mail should be sent to:

Thunderhead Engineering
403 Poyntz Ave. Suite B
Manhattan, KS 66502-6081
USA