Skip to content

Test Cases

Adrian Harwood edited this page Oct 15, 2018 · 6 revisions

In order to verify that LUMA has been properly installed there are a number of test cases available. In order to build and run a test case you will need to download the files for each case and follow the instructions below for configuring a test case.

Installing a Test Case

LUMA relies on a number of input files to define a particular case. As parameters are a mixture of compile-time and run-time variables, it is advisable to incrementally recompile parts of LUMA when setting up a new case.

File Types

Test cases downloaded from this page will be supplied with a mixture of different files depending on the input required. Below we list all the file types you could get in a test case package and where to copy them before compiling and running LUMA.

definitions.h

This file specifies the compile-time parameters required for LUMA to run a particular case. It must be copied to the inc directory, overwriting any previous version. LUMA must be recompiled after changing this file.

hdf_RXNX_restart.h5

This file is used to restart a simulation from a particular state. For a multi-grid simulation, there will be one file for each grid. For a parallel simulation there will be one file for every rank in the topology. These file are to be copied without renaming into the input directory and will be read at initialisation if LUMA was built with the L_RESTARTING flag set in the definitions.h file. These files can be changed and LUMA re-run without the need to recompile.

geometry.config

This file specifies the configuration of any geometrical objects to be inserted into the flow simulation. It is read by LUMA at initialisation if LUMA was built with the L_GEOMETRY_FILE flag enabled in the definitions.h file. This file can be changed and LUMA re-run without the need to recompile. It must be copied into the input directory.

XXX.pointcloud

General geometries are specified in the form of a 3-column, tab separated point cloud file. This file can be named anything and even have an extension other than *.pointcloud. However, for consistency we recommend using the *.pointcloud extension. Each point cloud file holds the spatial information associated with a particular object. To add the object into the simulation, each point cloud file must be referenced in the geometry.config file and LUMA must be built with the L_GEOMETRY_FILE flag enabled.

Test Cases

The following test cases are available. Copy the files into the project folders as indicated above then recompile and run LUMA.

2D FSI Cylinder Validation Case