1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
/*============================================================================
* Code_Saturne documentation page
*============================================================================*/
/*
This file is part of Code_Saturne, a general-purpose CFD tool.
Copyright (C) 1998-2018 EDF S.A.
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
/*-----------------------------------------------------------------------------*/
/*!
\page cs_lagrangian_particle_tracking_module Lagrangian module
\section cs_user_lagr_boundary_conditions_h Boundary conditions
Lagrangian boundary conditions are based on boundary zone
(\ref cs_boundary_zone_t) definitions. Additional information may be
provided for Lagrangian boundary types and injections.
As usual, definitions may be created using the GUI and extended
with user functions.
Access to the Lagrangian boundary conditions structure,
which is necessary to most of the following examples, may be done as
follows:
\snippet cs_user_lagr_boundary_conditions.c lagr_bc_variables
\subsection cs_user_lagr_boundary_conditions_h_zones Boundary zones
In this example, we assign rebound conditions to all boundary zones,
except for an inlet and outlet type to specified zones.
The type assigned is an integer based on the \ref cs_lagr_bc_type_t
enumerator type.
\snippet cs_user_lagr_boundary_conditions.c lagr_bc_define_type_1
\subsection cs_user_lagr_boundary_conditions_h_injection Injection sets
In the following example, a first injection set for an inlet zone is defined.
Note that newly injected particles may also be modified using the
\ref cs_user_lagr_in function.
\snippet cs_user_lagr_boundary_conditions.c lagr_bc_define_injection_1
In the next example, a profile is assigned to the second injection set
of an inlet zone (it is assumed this et was previously defined either
through the GUI or user function).
This requires first defining a profile definition function, matching
the profile of \ref cs_lagr_injection_profile_compute_t.
An example based on experimental profiles is given here:
\snippet cs_user_lagr_boundary_conditions.c lagr_bc_profile_func_2
Assigning the profile to the injection set simply requires
assigning the function to the pointer in the injection set structure:
\snippet cs_user_lagr_boundary_conditions.c lagr_bc_define_injection_2
An optional user-defined input function may also be associated.
\section cs_user_lagr_volume_conditions_h Volume conditions
Lagrangian volume conditions are based on volume zone
(\ref cs_volume_zone_t) definitions. Additional information may be
provided for Lagrangian injections.
As usual, definitions may be created using the GUI and extended
with user functions.
Access to the Lagrangian volume conditions structure,
which is necessary to most of the following examples, may be done as
follows:
\snippet cs_user_lagr_volume_conditions.c lagr_vol_cond_variables
\subsection cs_user_lagr_volume_conditions_h_injection Injection sets
In the following example, we inject 1 particle set at each time step:
\snippet cs_user_lagr_volume_conditions.c lagr_vol_define_injection_1
\snippet cs_user_lagr_volume_conditions.c lagr_vol_define_injection_2
In the following example, we inject 2 particle sets at computation
initialization (i.e. at the first time step of a computation sequence
in which the Lagrangian module is activated).
Note that newly injected particles may also be modified using the
\ref cs_user_lagr_in function.
\snippet cs_user_lagr_volume_conditions.c lagr_vol_define_injection_2
*/
|
