ACU-T: 1000 HyperWorks CFD UI Introduction

This tutorial introduces you to the workflow for setting up a Computational Fluid Dynamics (CFD) analysis using Altair HyperWorks CFD. HyperWorks CFD is a powerful tool which provides a single, streamlined platform for performing a CFD analysis, starting from importing CAD through post-processing results. In this tutorial, you will learn how to use HyperWorks CFD for setting up a CFD analysis while exploring different capabilities available within the software for importing a geometric model, validating the geometry, setting up simulation parameters and boundary conditions, and generating a mesh. You will then launch AcuSolve simulation directly from HyperWorks CFD and post-process the results using HyperWorks CFD Post.


To run this simulation, you will need access to a licensed version of HyperWorks CFD and AcuSolve.

Prior to running through this tutorial, copy from <Altair_installation_directory>\hwcfdsolvers\acusolve\win64\model_files\tutorials\AcuSolve to a local directory. Extract ACU-T1000_manifold.x_t from

Analyze the Problem

An important step in any CFD simulation is to examine the engineering problem at hand and determine the important parameters that need to be provided to AcuSolve. Parameters can be based on geometrical elements, such as inlets, outlets, or walls, and on flow conditions, such as fluid properties, velocity, or whether the flow should be modeled as turbulent or as laminar.

The system being simulated here is a manifold pipe, analogous to an inlet manifold in an engine. An inlet manifold distributes the incoming flow to multiple outputs. As can be seen in the image below, the pipe has a single inlet and multiple outlets, thus distributing a fraction of the flow among each outlet. Ideally in an inlet manifold used in an engine, the manifold design is such that it ensures near-equal distribution of flow among all the outlets. However, the geometry being used here is purely a demonstration case and not an optimized manifold geometry.

Figure 1. Schematic of the Problem

Introduction to HyperWorks CFD

Figure 2.
The tools and entities displayed in the HyperWorks CFD graphical user interface can be divided into six general categories as shown in the figure above.
  1. Menu bar
  2. Ribbons
  3. Modeling window
  4. Entity selector
  5. View Controls toolbar
  6. Browsers
  1. The menu bar (1) contains the drop-down menus for File input-output, Edit, and View operations.
  2. Ribbons (2) contain various functionalities and tools available in HW-CFD. Navigate between various ribbons by clicking the ribbon tabs to the right of the menu bar. After selecting a ribbon, the corresponding tool icons are displayed on the screen. The functionalities of various ribbons and corresponding tools are briefly explained in this section.
    Geometry ribbon
    The Geometry ribbon consists of tools for converting, repairing, creating, editing, and validating the geometry. The tools available under the FE Geometry sub-section can be used to convert a geometry model to an FE model, cap the openings automatically, define local or proximity-based wrap controls, wrap the model, remesh the wrapped results, and fix the mesh quality.

    Figure 3.
    When a geometry file is imported, the Repair tools can be used to detect any defects present in the CAD model like intersections, free edges, duplicates, sliver surfaces, etc. and fix those errors.

    Figure 4.
    The tools available under the Create sub-section can be used to create geometric entities like points, lines, surfaces, etc.

    Figure 5.
    The tools required for performing operations like plugging cavities, stitching surfaces, etc. are available under the Edit sub-section.

    Figure 6.
    The Defeature tool can be used to resolve these defects or model a new geometry, while the Validate tool can be used to detect any defects present in the CAD model. This process is usually known as CAD cleanup.

    Figure 7.
    Flow ribbon
    The Flow ribbon contains tools for setting up simulation parameters, solver settings, and reference properties such as material properties, heat sources, porous media, etc. The Setup sub-section is where you set up the physics equations and solver settings as well as create material models, multiplier functions, and parameters.

    Figure 8.
    The Domain sub-section contains tools for assigning reference properties such as materials, heat and momentum sources, reference frames, etc. to volumes.

    Figure 9.
    Surface boundary conditions such as inlets, outlets, far fields, etc. can be assigned using the tools under the Boundaries sub-section. By default, all the surfaces are assigned a boundary condition of type ‘auto_wall’ and are placed under Default wall. Please refer to the AcuSolve Surface Processing manual for more information about auto_wall. As you assign boundary conditions to the surfaces, they are moved into the respective group.

    Figure 10.
    Radiation ribbon
    The Radiation ribbon is where you define radiation physics, create thermal, solar, and participating media models, and apply radiation parameters.

    Figure 11.
    Motion ribbon
    Mesh boundary conditions and mesh-motion-related parameters can be defined using the tools available in the Motion ribbon. Parameters such as mesh motion type and mesh displacement constraints can be defined here. In addition to the mesh boundary conditions, code coupling with external codes such as OptiStruct and MotionSolve can be defined here

    Figure 12.
    Mesh ribbon
    Meshing parameters such as surface mesh controls, boundary layer parameters, volume mesh parameters, and zone meshing parameters can be defined here. This ribbon also has tools for local remeshing. Once all the mesh controls are defined, you can generate the mesh using the Batch tool.

    Figure 13.
    Solution ribbon
    The Solution ribbon is used to set up monitors for any individual point, surface, or volume set output. The Field tool is used to set the nodal output frequency for the entire model. The Initialize tools are used to set the nodal initial conditions for variables like pressure, velocity, and variables specific to each turbulence model.

    Figure 14.

    Once the complete set up is done, the Run tool is used to launch AcuSolve. Once the AcuSolve run parameters are set, the simulation can be started, and you can monitor the status of the run using the run manager.

    Post ribbon
    The Post ribbon is where you can post-process the results. The Visualize tools under the Post ribbon can be used to create contour plots, vector plots, streamlines, iso surfaces, and section cuts. The Measures tools can be used to probe variables at desired locations.

    Figure 15.
  3. The modeling window (3) is where the model is displayed. The model display can be manipulated using the view controls shown in the table below. Clicking on the model will highlight the entity being selected and right-clicking on an entity will give you additional options for the operations that can be done based on the context. Some of the functions available using right-click are Show, Hide, Isolate, Select, Advanced select, Create groups, and so on.
    Button Operation
    Middle mouse scroll Zoom in and out
    Right-click hold and drag Pan the model
    Middle mouse click hold and drag Rotate the model
    Left-click Select entity
    Ctrl + Left-click Select multiple entities
    Left-click hold and drag Window select
    Shift + Left-click Deselect entities
  4. The entity selector (4) enables you to control what entities can be selected using the left-mouse button. The selector can be set to any of the entities shown in the figure below. When you open any tool, the selector is automatically set to the entity (entities) which are appropriate for that command.

    Figure 16.
  5. The visualization of the model can be controlled using the tools available in View Controls toolbar (5). The display of mesh, model display mode (e.g. Topology, part, assembly, etc.), section cuts, standard views, etc. can be controlled using these tools.

    Figure 17.
  6. The Browsers (6) show the entities and setup parameters in the model and list them in a tree structure. They can be turned on or off from the View menu. Some common functions that can be performed in all browsers are show, hide, and isolate. The Part Browser can be used to manage the model's parts, surface bodies, and solid bodies The Setup Browser can be used to create and edit instances of model setup parameters such as boundary conditions, domains, mesh controls, and so on. Neither the Part Browser nor the Setup Browser are available when working in the Post ribbon. The Post Browser can be used to control the view and edit various post-processing visualizations. The Post Browser is only available when working in the Post ribbon.

Start HyperWorks CFD and Create the HyperMesh Model Database

  1. Start HyperWorks CFD from the Windows Start menu by clicking Start > Altair <version> > HyperWorks CFD.
    When HyperWorks CFD is loaded, the Geometry ribbon is open by default.
  2. Create a new .hm database in one of the following ways:
    • From the menu bar, click File > Save.

      Figure 18.
    • From the Home tools, Files tool group, click the Save As tool.

      Figure 19.
  3. In the Save File As dialog, navigate to the directory where you would like to save the database.
    This will be your problem directory and all the files related to the simulation will be stored in this location.
  4. Enter a name for the database (Manifold, for example) then click Save.

Import and Validate the Geometry

Import the Geometry

Before you start this step, copy the input file, ACU-T1000_manifold.x_t, to your problem directory.
  1. From the menu bar, click File > Import > Geometry Model.
  2. In the Import File dialog, browse to your working directory then select ACU-T1000_manifold.x_t and click Open.
  3. In the Geometry Import Options dialog, leave all the default options unchanged then click Import.

    Figure 20.
  4. Once the geometry is loaded, rotate and observe the features of the model.
    The view of the model displayed in the modeling window can be controlled using the following view controls.
    Button View Control
    Middle mouse scroll Zoom in and out
    Right-click hold and drag Pan the model
    Middle mouse click hold and drag Rotate the model

    Figure 21.

Validate the Geometry

  1. From the Geometry ribbon, click the Validate tool.

    Figure 22.
    The Validate tool scans through the entire model, performs checks on the surfaces and solids, and flags any defects in the geometry, such as free edges, closed shells, intersections, duplicates, and slivers.

    The current model doesn’t have any of the issues mentioned above. Alternatively, if any issues are found, they are indicated by the number in the brackets adjacent to the tool name.

    Observe that a blue check mark appears on the top-left corner of the Validate icon. This indicates that the tool found no issues with the geometry model.

    Figure 23.
  2. Press Esc or right-click in the modeling window and swipe the cursor over the green check mark from right to left.
  3. Save the database.

Set Up the Problem

In this step, you will set the general simulation parameters such as equation, solver settings, etc. Then, you will assign the surface boundary conditions and material properties to the fluid domain.

Set Up the Simulation Parameters and Solver Settings

  1. From the Flow ribbon, click the Physics tool.

    Figure 24.
    The Setup dialog opens.
  2. Under the Physics models setting:
    1. Verify that the Incompressible option is selected under Single phase flow.
    2. Set the Time marching to Steady.
    3. Select Spalart-Allmaras as the Turbulence model.
      The robustness and accuracy of the Spalart Allmaras turbulence model makes it an excellent choice for simulation of steady state flows.

    Figure 25.
  3. Click the Solver controls setting and verify that the parameters are set as shown in the figure below.

    Figure 26.
  4. Close the dialog and save the model.

Assign Material Properties

  1. From the Flow ribbon, click the Material tool.

    Figure 27.
  2. From the modeling window, click anywhere on the manifold.
    The entire manifold geometry is highlighted and a Material microdialog appears.

    Figure 28.
  3. Click the drop-down menu and select Water from the list of materials.
  4. On the guide bar, click to execute the command.
    The changes made in the tool are not effective until they are executed by clicking the icon.
    Once the command is executed, the color of the geometry changes to indicate the material assigned to the volume. In this case, there is only one volume in the geometry so there is a single color. Alternatively, if there are multiple volumes with different materials assigned, the model will be displayed accordingly with distinct colors for each material assigned.

    Figure 29.
  5. On the guide bar, click to exit the tool.

Assign the Flow Boundary Conditions

The current model has one inlet, three outlets, and walls for the rest of the surfaces. When a geometry model is imported into HyperWorks CFD, all the surfaces are placed in the Default Wall (i.e. Type = auto_wall). As you start assigning the surface boundary conditions, those surfaces are moved into a new boundary condition group. All the surface boundary condition tools are placed under the Boundaries sub-section of the Flow ribbon.

  1. From the Flow ribbon, Profiled tool group, click the Profiled Inlet tool.

    Figure 30.
  2. In the modeling window, click the surface of the inlet.

    Figure 31.
    Observe that a new group named "Inlet" is created under the Boundaries list in the top-left corner of the modeling window. Once the current command is executed, the highlighted surface will be moved into the Inlet group.
  3. In the microdialog, enter a value of 2.0 m/sec for Average velocity.

    Figure 32.
  4. On the guide bar, click to execute the command.
    The color of the inlet surface in the modeling window is updated.
    Note: The color assigned to the surfaces is random. Therefore, the color of the surfaces shown in the images below might be different from what you see on your screen.

    Figure 33.
  5. Click the Outlet tool.

    Figure 34.
  6. Click the three outlet surfaces shown in the figure below.

    Figure 35.
  7. Leave the default options in the dialog unchanged then click on the guide bar to execute the command.
    The color of the outlet surfaces change and the list of boundaries on the left are updated. The number of surfaces under each group are shown in the brackets.

    Figure 36.
    • To update the color of any group, click on the colored-square on the left of the group name and select the color of your choice from the palette.
    • To update the name of any group, right-click on the group name and select Rename from the context menu.
  8. On the guide bar, click to exit the tool.
  9. Save the model.

Define Mesh Controls

Now that you have assigned the material properties and boundary conditions, you will define the meshing parameters for the model and then generate the mesh.

Define the Surface Mesh Controls

  1. From the Mesh ribbon, click the Surface tool.

    Figure 37.
  2. Right-click in the modeling window and go to Select > All.

    Figure 38.
    All the surfaces in the model are highlighted and a dialog for surface mesh parameters appears.
  3. Enter 0.003 for the Average element size.

    Figure 39.
  4. Leave the default values for the remaining parameters unchanged then click on the guide bar to execute the command.

Define the Boundary Layer Mesh Parameters

  1. From the Mesh ribbon, click the Boundary Layer tool.

    Figure 40.
  2. Right-click in the modeling window and go to Select > Advanced Select > By Boundaries > Default Wall.

    Figure 41.
    All the wall surfaces are highlighted and a dialog for boundary layer parameters appears.
  3. Enter the values in the dialog as shown in the figure below.

    Figure 42.
  4. On the guide bar, click to execute the command.

Generate the Mesh

  1. From the Mesh ribbon, click the Batch tool.

    Figure 43.
  2. In the Meshing Operations dialog, enter an Average element size of 0.005.

    Figure 44.
  3. Click Mesh.
    Once the meshing process has started, the Run Status dialog appears. To view the status of the meshing process, right-click on the process row and select View log file.
    Once the meshing is done, the run status is updated accordingly, and you are automatically moved to the Solution ribbon.

    Figure 45.

Run AcuSolve

  1. From the Solution ribbon, click the Run tool.

    Figure 46.
  2. In the Launch AcuSolve dialog, verify that the Problem directory and AcuRun path are pointing to the correct location.
  3. Set the Parallel processing option to Intel MPI.
  4. Optional: Set the number of processors to 4 or 8 based on availability.
  5. Deactivate the Automatically define pressure reference option.
  6. Expand the Default initial conditions menu.
  7. Deactivate the Pre-compute flow option and enter 2.0 for x-velocity.
  8. Deactivate the Pre-compute turbulence flow option and enter 1e-5 for Eddy viscosity.
  9. Leave the remaining options as default and click Run to launch AcuSolve.

    Figure 47.
    The Run Status dialog opens again and the AcuSolve run appears on the list.
  10. Right-click on the AcuSolve run and select View log file.

    A summary of the run printed in the dialog indicates that AcuSolve has finished running the simulation. Once the solution is converged, the Status will be updated accordingly.

    Figure 48.
  11. In the Run Status dialog, right-click on AcuSolve and select Plot time history from the context menu.
  12. In the Plot Utility dialog, double-click on the Residual Ratio row to open the plot of residual ratios.

    Figure 49.

    The above plot shows the residuals of the equations as the solution progresses through each time step. You can see the residuals dropping smoothly. Once the pressure and velocity residual ratios reach a value less than the specified convergence tolerance (0.001), the solution is considered to be converged. By default, the eddy viscosity convergence tolerance is set to a magnitude of one order higher than the specified convergence tolerance (0.01).

Post-Process the Results with HyperWorks CFD Post

This part of the tutorial shows you how to work with a steady state solution using HyperWorks CFD Post.

Load the Results

  1. Once the solution is completed, navigate to the Post ribbon.
  2. From the menu bar, click File > Open > Results.
  3. Browse to your working directory. Select the file Manifold.1.Log and click Open.
    The solid and all the surfaces are loaded in the Post Browser.

Create Pressure Contours on Boundary Surfaces

  1. Click the Boundary Groups tool.

    Figure 50.
  2. Select all surfaces in the model by holding the left mouse button, dragging, and drawing a rectangle across the manifold.

    Figure 51.
  3. In the microdialog, set the Display variable to pressure.
  4. Activate the Legend toggle and click to reset the range.
  5. Click and set the Colormap Name to Rainbow Uniform.

    Figure 52.
  6. Click on the guide bar.

    Figure 53.
  7. In the Post Browser, right-click on Boundary Group 4 and select Rename. Name it Pressure_plot.

Plot Velocity and Pressure Contours on a Section Cut

  1. In the Post Browser, turn off the display of the boundary surfaces by clicking on the icon next to Flow Boundaries.

    Figure 54.
  2. Click the Slice Planes tool.

    Figure 55.
  3. Select the x-z plane in the modeling window.

    Figure 56.
  4. In the microdialog, click to adjust the plane with the Vector tool.
  5. In the Vector tool dialog, click to define the coordinates of the center of plane. Set the value of Y to -0.015 and press Enter.

    Figure 57.
  6. Press Esc twice.
  7. In the slice plane microdialog, click to create the slice plane.
  8. In the display properties microdialog, set the Display variable to pressure.
  9. Activate the Legend toggle and click to reset the range.
  10. Click and set the Colormap Name to Rainbow Uniform.

    Figure 58.
  11. Click on the guide bar.

    Figure 59.
  12. In the Post Browser, right-click on Slice Plane 1 and select Edit.
  13. In the microdialog, change the Display variable to velocity then click on the guide bar.

    Figure 60.


In this tutorial, you worked through a basic workflow to carry out a CFD simulation and post-process the results using HyperWorks CFD. You started by importing the geometry and meshing the model in HyperWorks CFD. You also set up the model and launchedAcuSolve directly from within HyperWorks CFD. Upon completion of the solution by AcuSolve, you post-processed the results in the Post ribbon. You learned how to create contours on the boundary surfaces and section cuts.