Presets/domain.xml

Introduction

domain.xml is a preset used to define a computational domain, such that all the (fluid/boundary) particles outside such domain will be transformed in fixed particles with null mass, clamping their position to the specified domain.

The main purpose of this tool is controlling singular particles which may scape from the confinement, causing the program failure (due to the constant increase of the grid size).

Usage

To use it the following tag should be added to include the preset:

<Include file="/usr/share/aquagpusph/resources/Presets/domain.xml" />

Where /usr/share/aquagpusph/ should be conveniently modified.

After that, the domain should be defined setting the associated variables. For instance (extracted from the Standing Wave example):

<Variables>
    <Variable name="domain_min" type="vec" value="-0.4, -0.21" />
    <Variable name="domain_max" type="vec" value="2.4, 1.26" />
</Variables>

where we are setting an upright rectangular shaped computational domain by its bottom-left (domain_min) and top-right (domain_max) corners.

This preset should be loaded after cfd.xml.

Variables defined

When this preset is loaded some variables are generated (on top of the default variables of AQUAgpusph):

NAME	TYPE	LENGTH	DESCRIPTION
domain_min	vec	1	First corner of the computational domain.
domain_max	vec	1	Second corner of the computational domain.

It is intended that domain_max > domain_min (for all the components).

Definitions

This preset is not adding new definitions (see Definitions).

Tools

The following tools are set to be executed each time step, just before the "FixedTimeStep" tool. (see Tools and cfd.xml to learn more about this):

NAME	TYPE	DESCRIPTION
Domain	kernel	Look for the particles outside the computational domain, and "destroy" them (see the introduction).

Reports

This preset is not adding new reports (see Reports).