MFC
Exascale flow solver
Loading...
Searching...
No Matches
m_phase_change.fpp.f90
Go to the documentation of this file.
1# 1 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
2!>
3!! @file
4!! @brief Contains module m_phase_change
5
6# 1 "/home/runner/work/MFC/MFC/src/common/include/case.fpp" 1
7! This file exists so that Fypp can be run without generating case.fpp files for
8! each target. This is useful when generating documentation, for example. This
9! should also let MFC be built with CMake directly, without invoking mfc.sh.
10
11! For pre-process.
12# 8 "/home/runner/work/MFC/MFC/src/common/include/case.fpp"
13
14! For moving immersed boundaries in simulation
15# 12 "/home/runner/work/MFC/MFC/src/common/include/case.fpp"
16# 6 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp" 2
17# 1 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp" 1
18# 1 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp" 1
19# 1 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp" 1
20# 2 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
21# 3 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
22# 4 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
23# 5 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
24# 6 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
25
26# 8 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
27# 9 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
28# 10 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
29
30# 12 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
31# 1 "/home/runner/work/MFC/MFC/src/common/include/defaults/thermochem.fpp" 1
32! Default for Fypp runs outside the toolchain (e.g. documentation). Searched last, so the
33! build/include/<target>/thermochem.fpp the toolchain writes from m_thermochem takes precedence.
34# 4 "/home/runner/work/MFC/MFC/src/common/include/defaults/thermochem.fpp"
35# 5 "/home/runner/work/MFC/MFC/src/common/include/defaults/thermochem.fpp"
36# 13 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp" 2
37
38# 16 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
39# 17 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
40
41# 24 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
42
43# 53 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
44
45# 65 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
46
47# 75 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
48
49# 105 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
50
51# 117 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
52
53# 127 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
54
55# 174 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
56! New line at end of file is required for FYPP
57# 2 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp" 2
58# 1 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp" 1
59# 1 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp" 1
60# 2 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
61# 3 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
62# 4 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
63# 5 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
64# 6 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
65
66# 8 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
67# 9 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
68# 10 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
69
70# 12 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
71# 1 "/home/runner/work/MFC/MFC/src/common/include/defaults/thermochem.fpp" 1
72! Default for Fypp runs outside the toolchain (e.g. documentation). Searched last, so the
73! build/include/<target>/thermochem.fpp the toolchain writes from m_thermochem takes precedence.
74# 4 "/home/runner/work/MFC/MFC/src/common/include/defaults/thermochem.fpp"
75# 5 "/home/runner/work/MFC/MFC/src/common/include/defaults/thermochem.fpp"
76# 13 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp" 2
77
78# 16 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
79# 17 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
80
81# 24 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
82
83# 53 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
84
85# 65 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
86
87# 75 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
88
89# 105 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
90
91# 117 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
92
93# 127 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
94
95# 174 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
96! New line at end of file is required for FYPP
97# 2 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp" 2
98
99# 4 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
100# 5 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
101# 6 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
102# 7 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
103# 8 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
104
105# 20 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
106
107# 49 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
108
109# 54 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
110
111# 59 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
112
113# 64 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
114
115# 69 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
116
117# 74 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
118
119# 87 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
120
121# 101 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
122
123# 106 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
124
125# 111 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
126
127# 116 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
128
129# 121 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
130
131# 126 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
132
133# 131 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
134
135# 136 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
136
137# 141 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
138
139# 171 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
140
141# 231 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
142
143# 245 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
144
145# 270 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
146
147# 281 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
148
149# 283 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
150# 294 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
151
152# 343 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
153
154# 353 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
155
156# 363 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
157
158# 372 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
159
160# 389 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
161
162# 399 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
163
164# 406 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
165
166# 412 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
167
168# 418 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
169
170# 424 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
171
172# 430 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
173
174# 436 "/home/runner/work/MFC/MFC/src/common/include/omp_macros.fpp"
175! New line at end of file is required for FYPP
176# 3 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp" 2
177# 1 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp" 1
178# 1 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp" 1
179# 2 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
180# 3 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
181# 4 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
182# 5 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
183# 6 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
184
185# 8 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
186# 9 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
187# 10 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
188
189# 12 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
190# 1 "/home/runner/work/MFC/MFC/src/common/include/defaults/thermochem.fpp" 1
191! Default for Fypp runs outside the toolchain (e.g. documentation). Searched last, so the
192! build/include/<target>/thermochem.fpp the toolchain writes from m_thermochem takes precedence.
193# 4 "/home/runner/work/MFC/MFC/src/common/include/defaults/thermochem.fpp"
194# 5 "/home/runner/work/MFC/MFC/src/common/include/defaults/thermochem.fpp"
195# 13 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp" 2
196
197# 16 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
198# 17 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
199
200# 24 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
201
202# 53 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
203
204# 65 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
205
206# 75 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
207
208# 105 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
209
210# 117 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
211
212# 127 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
213
214# 174 "/home/runner/work/MFC/MFC/src/common/include/shared_parallel_macros.fpp"
215! New line at end of file is required for FYPP
216# 2 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp" 2
217
218# 7 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
219
220# 17 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
221
222# 22 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
223
224# 27 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
225
226# 32 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
227
228# 37 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
229
230# 42 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
231
232# 47 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
233
234# 52 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
235
236# 57 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
237
238# 62 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
239
240# 73 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
241
242# 78 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
243
244# 83 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
245
246# 88 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
247
248# 103 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
249
250# 131 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
251
252# 161 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
253
254# 176 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
255
256# 194 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
257
258# 216 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
259
260# 245 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
261
262# 260 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
263
264# 270 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
265
266# 279 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
267
268# 295 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
269
270# 305 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
271
272# 312 "/home/runner/work/MFC/MFC/src/common/include/acc_macros.fpp"
273! New line at end of file is required for FYPP
274# 4 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp" 2
275
276! GPU parallel region (scalar reductions, maxval/minval)
277# 23 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
278
279! GPU parallel loop over threads (most common GPU macro)
280# 44 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
281
282! Required closing for GPU_PARALLEL_LOOP
283# 56 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
284
285! Mark routine for device compilation
286# 113 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
287
288! Declare device-resident data
289# 131 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
290
291! Inner loop within a GPU parallel region
292# 146 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
293
294! Scoped GPU data region
295# 165 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
296
297! Host code with device pointers (for MPI with GPU buffers)
298# 191 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
299
300! Allocate device memory (unscoped)
301# 205 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
302
303! Free device memory
304# 217 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
305
306! Atomic operation on device
307# 229 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
308
309! End atomic capture block
310# 240 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
311
312! Copy data between host and device
313# 252 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
314
315! Synchronization barrier
316# 264 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
317
318! Import GPU library module (openacc or omp_lib)
319# 273 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
320
321! Emit code only for AMD compiler
322# 280 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
323
324! Emit code for non-Cray compilers
325# 287 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
326
327! Emit code only for Cray compiler
328# 294 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
329
330! Cray compiler directive, emitted from Fypp so the formatter cannot turn it into a comment
331# 301 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
332
333! Emit code for non-NVIDIA compilers
334# 308 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
335
336# 310 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
337# 311 "/home/runner/work/MFC/MFC/src/common/include/parallel_macros.fpp"
338! New line at end of file is required for FYPP
339# 2 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp" 2
340
341# 14 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp"
342
343! Caution: This macro requires the use of a binding script to set CUDA_VISIBLE_DEVICES, such that we have one GPU device per MPI
344! rank. That's because for both cudaMemAdvise (preferred location) and cudaMemPrefetchAsync we use location = device_id = 0. For an
345! example see misc/nvidia_uvm/bind.sh.
346# 52 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp"
347
348! Allocate and create GPU device memory
349# 72 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp"
350
351! Free GPU device memory and deallocate
352# 80 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp"
353
354! Cray-specific GPU pointer setup for vector fields
355# 104 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp"
356
357! Cray-specific GPU pointer setup for scalar fields
358# 120 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp"
359
360! Cray-specific GPU pointer teardown for scalar fields - exact inverse of ACC_SETUP_SFs. Removes the
361! present-table entries ACC_SETUP_SFs added (the scalar_field descriptor and its %sf copyin). REQUIRED when
362! an ACC_SETUP'd field is freed MID-RUN (e.g. AMR slot free on regrid/restart): Cray 'exit data delete'
363! decrements the reference counter, so the lone @:DEALLOCATE(arg%sf) only undoes the @:ALLOCATE create ref
364! and leaves the descriptor + the ACC_SETUP %sf copyin dangling. Call BEFORE @:DEALLOCATE(arg%sf).
365# 140 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp"
366
367! Cray-specific GPU pointer setup for acoustic source spatials
368# 165 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp"
369
370! Whether stress index idx is a shear component. Spelled out because NVHPC 26.9 at -O2 vectorizes any(idx == shear_indices)
371! inside a loop to always true, which doubled the normal-stress elastic energy.
372# 171 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp"
373
374# 177 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp"
375
376# 184 "/home/runner/work/MFC/MFC/src/common/include/macros.fpp"
377! New line at end of file is required for FYPP
378# 7 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp" 2
379
380!> @brief Phase transition relaxation solvers for liquid-vapor flows with cavitation and boiling
382
385 use m_mpi_proxy
387 use m_eos
388 use ieee_arithmetic
390 use m_constants, only: model_eqns_6eq
391
392 implicit none
393
394 private
396
397 !> @name Parameters for the first order transition phase change
398 !> @{
399 integer, parameter :: max_iter = 100000 !< max Newton iterations before accepting the last iterate
400 real(wp), parameter :: pcr = 4.94e7_wp !< Critical pressure of water [Pa]
401 real(wp), parameter :: tcr = 385.05_wp + 273.15_wp !< Critical temperature of water [K]
402 integer, parameter :: ptg_ls_max = 30 !< max backtracking-line-search halvings in the pTg solver
403 real(wp), parameter :: mixm = 1.0e-8_wp !< Mixture mass fraction threshold for triggering phase change
404 integer, parameter :: lp = 1 !< index for the liquid phase of the reacting fluid
405 integer, parameter :: vp = 2 !< index for the vapor phase of the reacting fluid
406 !> @}
407
408contains
409
410 !> Dispatch to the correct relaxation solver. Replaces the procedure pointer, which CCE is breaking on.
411 impure subroutine s_relaxation_solver(q_cons_vf)
412
413 type(scalar_field), dimension(sys_size), intent(inout) :: q_cons_vf
414 ! This is empty because in current master the procedure pointer was never assigned
415
416 if (.not. (.false.)) then
417# 44 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
418 call s_mpi_abort("m_phase_change.fpp:44: " // "Assertion failed: .false.. " &
419# 44 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
420 & // "s_relaxation_solver called but it currently does nothing")
421# 44 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
422 end if
423# 45 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
424
425 end subroutine s_relaxation_solver
426
427 !> Initialize the phase change module (no module-level state to set up; the pT/pTg relaxation solvers are self-contained)
429
431
432 !> Apply pT- or pTg-equilibrium relaxation with mass depletion based on the incoming state conditions.
433 subroutine s_infinite_relaxation_k(q_cons_vf)
434
435 type(scalar_field), dimension(sys_size), intent(inout) :: q_cons_vf
436 real(wp) :: ps !< equilibrium pressure
437 real(wp) :: ts !< equilibrium temperature
438 real(wp) :: rhoe, dyne, rhos !< total internal energy, kinetic energy, and total entropy
439 real(wp) :: rho, rm, m1, m2, mct !< total density, total reacting mass, individual reacting masses
440 real(wp) :: tvf !< total volume fraction
441 logical :: ptg_conv !< pTg Newton solver converged
442
443# 67 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
444 real(wp), dimension(num_fluids) :: p_infpt, sk, hk, gk, ek, rhok
445# 69 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
446
447 !> Generic loop iterators
448 integer :: i, j, k, l
449
450#ifdef MFC_OpenACC
451 ! CCE 19 IPA workaround: prevent bring_routine_resident SIGSEGV
452#ifdef _CRAYFTN
453# 75 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
454!DIR$ NOINLINE s_infinite_pt_relaxation_k
455# 75 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
456#endif
457# 76 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
458#ifdef _CRAYFTN
459# 76 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
460!DIR$ NOINLINE s_infinite_ptg_relaxation_k
461# 76 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
462#endif
463# 77 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
464#ifdef _CRAYFTN
465# 77 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
466!DIR$ NOINLINE s_correct_partial_densities
467# 77 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
468#endif
469# 78 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
470#endif
471
472 ! starting equilibrium solver
473
474
475# 82 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
476
477# 82 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
478#if defined(MFC_OpenACC)
479# 82 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
480!$acc parallel loop collapse(3) gang vector default(present) private(i, j, k, l, p_infpT, sk, hk, gk, ek, rhok, pS, TS, rhoe, dynE, rhos, rho, rM, m1, m2, MCT, TvF, ptg_conv)
481# 82 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
482#elif defined(MFC_OpenMP)
483# 82 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
484
485# 82 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
486
487# 82 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
488
489# 82 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
490!$omp target teams loop defaultmap(firstprivate:scalar) bind(teams,parallel) collapse(3) defaultmap(tofrom:aggregate) defaultmap(tofrom:allocatable) defaultmap(tofrom:pointer) &
491# 82 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
492!$omp& private(i, j, k, l, p_infpT, sk, hk, gk, ek, rhok, pS, TS, rhoe, dynE, rhos, rho, rM, m1, m2, MCT, TvF, ptg_conv)
493# 82 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
494#endif
495# 84 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
496 do j = 0, m
497 do k = 0, n
498 do l = 0, p
499 rho = 0.0_wp; tvf = 0.0_wp
500
501# 88 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
502#if defined(MFC_OpenACC)
503# 88 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
504!$acc loop seq
505# 88 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
506#elif defined(MFC_OpenMP)
507# 88 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
508
509# 88 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
510#endif
511# 89 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
512 do i = 1, num_fluids
513 ! Mixture density
514 rho = rho + q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, l)
515
516 ! Total Volume Fraction
517 tvf = tvf + q_cons_vf(i + eqn_idx%adv%beg - 1)%sf(j, k, l)
518 end do
519
520 ! calculating the total reacting mass for the phase change process. By hypothesis, this should not change
521 ! throughout the phase-change process.
522 rm = q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, l) + q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, k, l)
523
524 ! correcting negative (reacting) mass fraction values in case they happen
525 call s_correct_partial_densities(mct, q_cons_vf, rm, j, k, l)
526
527 ! fixing m1 and m2 AFTER correcting the partial densities. Note that these values must be stored for the phase
528 ! change process that will happen a posteriori
529 m1 = q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, l)
530
531 m2 = q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, k, l)
532
533 ! kinetic energy as an auxiliary variable to the calculation of the total internal energy
534 dyne = 0.0_wp
535
536# 112 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
537#if defined(MFC_OpenACC)
538# 112 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
539!$acc loop seq
540# 112 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
541#elif defined(MFC_OpenMP)
542# 112 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
543
544# 112 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
545#endif
546# 113 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
547 do i = eqn_idx%mom%beg, eqn_idx%mom%end
548 dyne = dyne + 5.0e-1_wp*q_cons_vf(i)%sf(j, k, l)**2/rho
549 end do
550
551 ! calculating the total energy that MUST be preserved throughout the pT- and pTg-relaxation procedures at each
552 ! of the cells. The internal energy is calculated as the total energy minus the kinetic energy to preserved its
553 ! value at sharp interfaces
554 rhoe = q_cons_vf(eqn_idx%E)%sf(j, k, l) - dyne
555
556 ! Calling pT-equilibrium for either finishing phase-change module, or as an IC for the pTg-equilibrium for this
557 ! case, MFL cannot be either 0 or 1, so I chose it to be 2
558 call s_infinite_pt_relaxation_k(j, k, l, 2, ps, p_infpt, q_cons_vf, rhoe, ts)
559
560 ! Check if pTg-equilibrium needed; only partial densities require updating
561 if ((relax_model == 6) .and. ((q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, &
562 & l) > mixm*rm) .and. (q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, k, &
563 & l) > mixm*rm)) .and. (ps < pcr) .and. (ts < tcr)) then
564 ! Solve pTg-equilibrium directly on the actual reacting masses. The Newton solver projects
565 ! the liquid mass onto [0, mT], so it recovers the single-phase limits itself (ml -> 0 for
566 ! all-vapor, ml -> mT for all-liquid). The former overheated-vapor / subcooled-liquid pT
567 ! shortcuts were removed: their pT states differ O(1) from the pTg equilibrium, so the
568 ! sub-ULP shortcut/pTg branch decision flipped across backends (CPU vs GPU) near a phase
569 ! boundary and destroyed cross-backend reproducibility.
570 q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, l) = m1
571 q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, k, l) = m2
572
573 call s_infinite_ptg_relaxation_k(j, k, l, ps, rhoe, q_cons_vf, ts, ptg_conv)
574
575 ! Unconverged pTg; solve pT equilibrium again for the final masses
576 if (.not. ptg_conv) call s_infinite_pt_relaxation_k(j, k, l, 2, ps, p_infpt, q_cons_vf, rhoe, ts)
577 end if
578
579 ! Calculations AFTER equilibrium
580
581
582# 147 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
583#if defined(MFC_OpenACC)
584# 147 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
585!$acc loop seq
586# 147 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
587#elif defined(MFC_OpenMP)
588# 147 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
589
590# 147 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
591#endif
592# 148 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
593 do i = 1, num_fluids
594 ! entropy
595 sk(i) = cvs(i)*log((ts**isentrope_n(i))/((ps + isentrope_b(i))**(isentrope_n(i) - 1.0_wp))) + qvps(i)
596
597 ! enthalpy
598 hk(i) = isentrope_n(i)*cvs(i)*ts + qvs(i)
599
600 ! Gibbs-free energy
601 gk(i) = hk(i) - ts*sk(i)
602
603 ! densities
604 rhok(i) = f_sg_thermal(ps, ts, isentrope_n(i), isentrope_b(i), cvs(i))
605
606 ! internal energy
607 ek(i) = (ps + isentrope_n(i)*isentrope_b(i))/(ps + isentrope_b(i))*cvs(i)*ts + qvs(i)
608 end do
609
610 ! calculating volume fractions, internal energies, and total entropy
611 rhos = 0.0_wp
612
613# 167 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
614#if defined(MFC_OpenACC)
615# 167 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
616!$acc loop seq
617# 167 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
618#elif defined(MFC_OpenMP)
619# 167 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
620
621# 167 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
622#endif
623# 168 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
624 do i = 1, num_fluids
625 ! volume fractions
626 q_cons_vf(i + eqn_idx%adv%beg - 1)%sf(j, k, l) = q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, l)/rhok(i)
627
628 ! alpha*rho*e
629 if (model_eqns == model_eqns_6eq) then
630 q_cons_vf(i + eqn_idx%int_en%beg - 1)%sf(j, k, l) = q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, &
631 & l)*ek(i)
632 end if
633
634 ! Total entropy
635 rhos = rhos + q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, l)*sk(i)
636 end do
637 end do
638 end do
639 end do
640
641# 184 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
642#if defined(MFC_OpenACC)
643# 184 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
644!$acc end parallel loop
645# 184 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
646#elif defined(MFC_OpenMP)
647# 184 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
648
649# 184 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
650!$omp end target teams loop
651# 184 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
652#endif
653# 185 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
654
655 end subroutine s_infinite_relaxation_k
656
657 !> Apply pT-equilibrium relaxation for N fluids
658 !! @param MFL flag: 0=gas, 1=liquid, 2=mixture
659 subroutine s_infinite_pt_relaxation_k(j, k, l, MFL, pS, p_infpT, q_cons_vf, rhoe, TS)
660
661
662# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
663#ifdef _CRAYFTN
664# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
665#if MFC_OpenACC
666# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
667!$acc routine seq
668# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
669#elif MFC_OpenMP
670# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
671
672# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
673
674# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
675!$omp declare target device_type(any)
676# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
677#else
678# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
679!DIR$ NOINLINE s_infinite_pt_relaxation_k
680# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
681#endif
682# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
683#elif MFC_OpenACC
684# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
685!$acc routine seq
686# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
687#elif MFC_OpenMP
688# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
689
690# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
691
692# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
693!$omp declare target device_type(any)
694# 192 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
695#endif
696# 193 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
697
698 ! initializing variables
699 integer, intent(in) :: j, k, l, MFL
700 real(wp), intent(out) :: pS
701 real(wp), dimension(1:), intent(out) :: p_infpT
702 type(scalar_field), dimension(sys_size), intent(in) :: q_cons_vf
703 real(wp), intent(in) :: rhoe
704 real(wp), intent(out) :: TS
705 real(wp) :: gp, gpp, hp, pO, mCP, mQ !< variables for the Newton Solver
706 real(wp) :: p_infpT_sum
707 integer :: i, ns !< generic loop iterators
708 ! auxiliary variables for the pT-equilibrium solver
709 mcp = 0.0_wp; mq = 0.0_wp; p_infpt_sum = 0._wp
710
711# 206 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
712#if defined(MFC_OpenACC)
713# 206 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
714!$acc loop seq
715# 206 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
716#elif defined(MFC_OpenMP)
717# 206 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
718
719# 206 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
720#endif
721# 207 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
722 do i = 1, num_fluids
723 p_infpt(i) = isentrope_b(i)
724 p_infpt_sum = p_infpt_sum + abs(p_infpt(i))
725 end do
726 ! Performing tests before initializing the pT-equilibrium
727
728# 212 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
729#if defined(MFC_OpenACC)
730# 212 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
731!$acc loop seq
732# 212 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
733#elif defined(MFC_OpenMP)
734# 212 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
735
736# 212 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
737#endif
738# 213 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
739 do i = 1, num_fluids
740 ! sum of the total alpha*rho*cp of the system
741 mcp = mcp + q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, l)*cvs(i)*isentrope_n(i)
742
743 ! sum of the total alpha*rho*q of the system
744 mq = mq + q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, l)*qvs(i)
745 end do
746
747# 229 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
748
749 ! Checking energy constraint
750 if ((rhoe - mq - minval(p_infpt)) < 0.0_wp) then
751 if ((mfl == 0) .or. (mfl == 1)) then
752 ! Assigning zero values for mass depletion cases pressure
753 ps = 0.0_wp
754
755 ! temperature
756 ts = 0.0_wp
757
758 return
759 end if
760 end if
761
762 ! calculating initial estimate for pressure in the pT-relaxation procedure. I will also use this variable to iterate over
763 ! the Newton's solver
764 po = 0.0_wp
765
766 ! Maybe improve this condition afterwards. As long as the initial guess is in between -min(isentrope_B) and infinity, a
767 ! solution
768 ! should be able to be found.
769 ps = 1.0e4_wp
770
771 ! Newton Solver for the pT-equilibrium
772 ns = 0
773 ! change this relative error metric. 1.e4_wp is just arbitrary
774 ! Relative criterion written in multiply form to avoid dividing by pO (pO = 0 on the first pass).
775 do while ((abs(ps - po) > palpha_eps) .and. (abs(ps - po) > (palpha_eps/1.e4_wp)*abs(po)) .or. (ns == 0))
776 ! increasing counter
777 ns = ns + 1
778 ! guard against non-convergence: accept the last iterate rather than looping forever
779 if (ns >= max_iter) exit
780
781 ! updating old pressure
782 po = ps
783
784 ! updating functions used in the Newton's solver
785 gpp = 0.0_wp; gp = 0.0_wp; hp = 0.0_wp
786
787# 267 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
788#if defined(MFC_OpenACC)
789# 267 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
790!$acc loop seq
791# 267 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
792#elif defined(MFC_OpenMP)
793# 267 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
794
795# 267 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
796#endif
797# 268 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
798 do i = 1, num_fluids
799 gp = gp + (isentrope_n(i) - 1.0_wp)*q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, &
800 & l)*cvs(i)*(rhoe + ps - mq)/(mcp*(ps + p_infpt(i)))
801
802 gpp = gpp + (isentrope_n(i) - 1.0_wp)*q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, &
803 & l)*cvs(i)*(p_infpt(i) - rhoe + mq)/(mcp*(ps + p_infpt(i))**2)
804 end do
805
806 hp = 1.0_wp/(rhoe + ps - mq) + 1.0_wp/(ps + minval(p_infpt))
807
808 ! updating common pressure for the newton solver
809 ps = po + ((1.0_wp - gp)/gpp)/(1.0_wp - (1.0_wp - gp + abs(1.0_wp - gp))/(2.0_wp*gpp)*hp)
810 end do
811
812 ! common temperature; same closure as f_mixture_temperature in m_eos, written in conservative variables
813 ts = (rhoe + ps - mq)/mcp
814
815 end subroutine s_infinite_pt_relaxation_k
816
817 !> Evaluate the pTg-equilibrium residual R2D and temperature TS at a trial state (ml, pS) WITHOUT mutating q_cons_vf, so the
818 !! Newton driver can line-search. The total reacting mass mT is conserved, so the reacting masses are (ml, mT - ml) and only the
819 !! inert fluids are read from q_cons_vf. Also returns the mixture sums the Jacobian and the final temperature need.
820 subroutine s_compute_ptg_residual(ml, mT, pS, j, k, l, q_cons_vf, rhoe, R2D, TS, mCP, mQ, mCVGP, mCVGP2, mCPD)
821
822
823# 292 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
824#if MFC_OpenACC
825# 292 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
826!$acc routine seq
827# 292 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
828#elif MFC_OpenMP
829# 292 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
830
831# 292 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
832
833# 292 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
834!$omp declare target device_type(any)
835# 292 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
836#endif
837# 293 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
838
839 real(wp), intent(in) :: ml, mT, pS, rhoe
840 integer, intent(in) :: j, k, l
841 type(scalar_field), dimension(sys_size), intent(in) :: q_cons_vf
842 real(wp), dimension(2), intent(out) :: R2D
843 real(wp), intent(out) :: TS, mCP, mQ, mCVGP, mCVGP2, mCPD
844 real(wp) :: mQD
845 integer :: i
846
847 ! reacting fluids contribute via (ml, mT - ml); inert fluids are summed from q_cons_vf
848 mcp = ml*cvs(lp)*isentrope_n(lp) + (mt - ml)*cvs(vp)*isentrope_n(vp)
849 mq = ml*qvs(lp) + (mt - ml)*qvs(vp)
850 mcvgp = 0.0_wp; mcvgp2 = 0.0_wp; mcpd = 0.0_wp; mqd = 0.0_wp
851
852# 306 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
853#if defined(MFC_OpenACC)
854# 306 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
855!$acc loop seq
856# 306 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
857#elif defined(MFC_OpenMP)
858# 306 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
859
860# 306 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
861#endif
862# 307 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
863 do i = 1, num_fluids
864 if ((i /= lp) .and. (i /= vp)) then
865 mcp = mcp + q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, l)*cvs(i)*isentrope_n(i)
866 mq = mq + q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, l)*qvs(i)
867 mcvgp = mcvgp + q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, l)*cvs(i)*(isentrope_n(i) - 1)/(ps + isentrope_b(i))
868 mcvgp2 = mcvgp2 + q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, &
869 & l)*cvs(i)*(isentrope_n(i) - 1)/((ps + isentrope_b(i))**2)
870 mqd = mqd + q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, l)*qvs(i)
871 mcpd = mcpd + q_cons_vf(i + eqn_idx%cont%beg - 1)%sf(j, k, l)*cvs(i)*isentrope_n(i)
872 end if
873 end do
874
875 ts = 1.0_wp/(mt*cvs(vp)*(isentrope_n(vp) - 1)/(ps + isentrope_b(vp)) + ml*(cvs(lp)*(isentrope_n(lp) - 1)/(ps &
876 & + isentrope_b(lp)) - cvs(vp)*(isentrope_n(vp) - 1)/(ps + isentrope_b(vp))) + mcvgp)
877
878 ! (i) Gibbs free-energy equality
879 r2d(1) = ts*((cvs(lp)*isentrope_n(lp) - cvs(vp)*isentrope_n(vp))*(1 - log(ts)) - (qvps(lp) - qvps(vp)) + cvs(lp) &
880 & *(isentrope_n(lp) - 1)*log(ps + isentrope_b(lp)) - cvs(vp)*(isentrope_n(vp) - 1)*log(ps + isentrope_b(vp))) &
881 & + qvs(lp) - qvs(vp)
882
883 ! (ii) constant-energy condition
884 r2d(2) = rhoe + ps + ml*(qvs(vp) - qvs(lp)) - mt*qvs(vp) - mqd + (ml*(isentrope_n(vp)*cvs(vp) - isentrope_n(lp)*cvs(lp)) &
885 & - mt*isentrope_n(vp)*cvs(vp) - mcpd)/(ml*(cvs(lp)*(isentrope_n(lp) - 1)/(ps + isentrope_b(lp)) - cvs(vp) &
886 & *(isentrope_n(vp) - 1)/(ps + isentrope_b(vp))) + mt*cvs(vp)*(isentrope_n(vp) - 1)/(ps + isentrope_b(vp)) + mcvgp)
887
888 end subroutine s_compute_ptg_residual
889
890 !> Apply pTg-equilibrium relaxation: a damped (backtracking line search) Newton solve for the reacting liquid mass ml and
891 !! pressure pS enforcing Gibbs equality and energy conservation, converging on the residual norm (absolute ptgalpha_eps, or the
892 !! rhoe-relative branch). Every step is projected onto the physical bounds 0 <= ml <= mT, pS > pmin. This converges in a handful
893 !! of iterations with a bounded, uniform count (no GPU warp divergence), unlike the former fixed 1e-3 underrelaxation that
894 !! stalled far from the root.
895 subroutine s_infinite_ptg_relaxation_k(j, k, l, pS, rhoe, q_cons_vf, TS, ptg_conv)
896
897
898# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
899#ifdef _CRAYFTN
900# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
901#if MFC_OpenACC
902# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
903!$acc routine seq
904# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
905#elif MFC_OpenMP
906# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
907
908# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
909
910# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
911!$omp declare target device_type(any)
912# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
913#else
914# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
915!DIR$ NOINLINE s_infinite_ptg_relaxation_k
916# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
917#endif
918# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
919#elif MFC_OpenACC
920# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
921!$acc routine seq
922# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
923#elif MFC_OpenMP
924# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
925
926# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
927
928# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
929!$omp declare target device_type(any)
930# 341 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
931#endif
932# 342 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
933
934 integer, intent(in) :: j, k, l
935 real(wp), intent(inout) :: pS
936 real(wp), intent(in) :: rhoe
937 type(scalar_field), dimension(sys_size), intent(inout) :: q_cons_vf
938 real(wp), intent(inout) :: TS
939 logical, intent(out) :: ptg_conv
940 real(wp), dimension(2, 2) :: Jac, InvJac
941 real(wp), dimension(2) :: R2D, R2D_try, DeltamP
942 real(wp) :: mCP, mCPD, mCVGP, mCVGP2, mQ
943 real(wp) :: ml, ml_try, mT, pS_try, pmin, lambda, resnorm, resnorm_try
944 real(wp) :: dFdT, dTdm, dTdp, detJ
945 integer :: ns, ls
946
947 ! total reacting mass is conserved; the liquid mass ml is the primary unknown, vapor mass = mT - ml
948 mt = q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, l) + q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, k, l)
949 ml = q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, l)
950
951 ! recover a physical pressure guess when the incoming pS is non-physical
952 if (((ps < 0.0_wp) .and. ((q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, l) + q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, &
953 & k, &
954 & l)) > ((rhoe - isentrope_n(lp)*isentrope_b(lp)/(isentrope_n(lp) - 1))/qvs(lp)))) .or. ((ps >= 0.0_wp) &
955 & .and. (ps < 1.0e-1_wp))) then
956 ps = 1.0e4_wp
957 end if
958
959 ! pressure floor (stiffened gas requires pS + isentrope_B > 0 for both phases)
960 pmin = -min(isentrope_b(lp), isentrope_b(vp)) + 1.0_wp
961
962 call s_compute_ptg_residual(ml, mt, ps, j, k, l, q_cons_vf, rhoe, r2d, ts, mcp, mq, mcvgp, mcvgp2, mcpd)
963 resnorm = sqrt(r2d(1)**2 + r2d(2)**2)
964
965 do ns = 1, max_iter
966 ! converged on the absolute residual, or on the rhoe-relative residual (multiply form, rhoe > 0)
967 ptg_conv = (resnorm <= ptgalpha_eps) .or. (resnorm <= (ptgalpha_eps/1.e6_wp)*rhoe)
968 if (ptg_conv .or. (ns == max_iter)) exit
969
970 ! 2x2 Jacobian of (Gibbs equality, energy) with respect to (ml, pS) at the current state
971 dfdt = -(cvs(lp)*isentrope_n(lp) - cvs(vp)*isentrope_n(vp))*log(ts) - (qvps(lp) - qvps(vp)) + cvs(lp)*(isentrope_n(lp) &
972 & - 1)*log(ps + isentrope_b(lp)) - cvs(vp)*(isentrope_n(vp) - 1)*log(ps + isentrope_b(vp))
973 dtdm = -(cvs(lp)*(isentrope_n(lp) - 1)/(ps + isentrope_b(lp)) - cvs(vp)*(isentrope_n(vp) - 1)/(ps + isentrope_b(vp))) &
974 & *ts**2
975 dtdp = (mt*cvs(vp)*(isentrope_n(vp) - 1)/(ps + isentrope_b(vp))**2 + ml*(cvs(lp)*(isentrope_n(lp) - 1)/(ps &
976 & + isentrope_b(lp))**2 - cvs(vp)*(isentrope_n(vp) - 1)/(ps + isentrope_b(vp))**2) + mcvgp2)*ts**2
977
978 jac(1, 1) = dfdt*dtdm
979 jac(1, &
980 & 2) = dfdt*dtdp + ts*(cvs(lp)*(isentrope_n(lp) - 1)/(ps + isentrope_b(lp)) - cvs(vp)*(isentrope_n(vp) - 1)/(ps &
981 & + isentrope_b(vp)))
982 jac(2, &
983 & 1) = qvs(vp) - qvs(lp) + (cvs(vp)*isentrope_n(vp) - cvs(lp)*isentrope_n(lp))/(ml*(cvs(lp)*(isentrope_n(lp) - 1) &
984 & /(ps + isentrope_b(lp)) - cvs(vp)*(isentrope_n(vp) - 1)/(ps + isentrope_b(vp))) + mt*cvs(vp)*(isentrope_n(vp) &
985 & - 1)/(ps + isentrope_b(vp)) + mcvgp) - (ml*(cvs(vp)*isentrope_n(vp) - cvs(lp)*isentrope_n(lp)) - mt*cvs(vp) &
986 & *isentrope_n(vp) - mcpd)*(cvs(lp)*(isentrope_n(lp) - 1)/(ps + isentrope_b(lp)) - cvs(vp)*(isentrope_n(vp) - 1) &
987 & /(ps + isentrope_b(vp)))/((ml*(cvs(lp)*(isentrope_n(lp) - 1)/(ps + isentrope_b(lp)) - cvs(vp)*(isentrope_n(vp) &
988 & - 1)/(ps + isentrope_b(vp))) + mt*cvs(vp)*(isentrope_n(vp) - 1)/(ps + isentrope_b(vp)) + mcvgp)**2)
989 jac(2, &
990 & 2) = 1 + (ml*(cvs(vp)*isentrope_n(vp) - cvs(lp)*isentrope_n(lp)) - mt*cvs(vp)*isentrope_n(vp) - mcpd) &
991 & *(ml*(cvs(lp)*(isentrope_n(lp) - 1)/(ps + isentrope_b(lp))**2 - cvs(vp)*(isentrope_n(vp) - 1)/(ps &
992 & + isentrope_b(vp))**2) + mt*cvs(vp)*(isentrope_n(vp) - 1)/(ps + isentrope_b(vp))**2 + mcvgp2)/(ml*(cvs(lp) &
993 & *(isentrope_n(lp) - 1)/(ps + isentrope_b(lp)) - cvs(vp)*(isentrope_n(vp) - 1)/(ps + isentrope_b(vp))) &
994 & + mt*cvs(vp)*(isentrope_n(vp) - 1)/(ps + isentrope_b(vp)) + mcvgp)**2
995
996 detj = jac(1, 1)*jac(2, 2) - jac(1, 2)*jac(2, 1)
997 ! singular Jacobian: no usable Newton direction, accept the current (best) state
998 if (detj == 0.0_wp) exit
999
1000 invjac(1, 1) = jac(2, 2)/detj
1001 invjac(1, 2) = -jac(1, 2)/detj
1002 invjac(2, 1) = -jac(2, 1)/detj
1003 invjac(2, 2) = jac(1, 1)/detj
1004
1005 deltamp(1) = -(invjac(1, 1)*r2d(1) + invjac(1, 2)*r2d(2))
1006 deltamp(2) = -(invjac(2, 1)*r2d(1) + invjac(2, 2)*r2d(2))
1007
1008 ! backtracking line search: halve the step until the residual decreases, keeping the state
1009 ! physical (0 <= ml <= mT, pS above the stiffened-gas floor)
1010 lambda = 1.0_wp
1011 do ls = 1, ptg_ls_max
1012 ml_try = min(max(ml + lambda*deltamp(1), 0.0_wp), mt)
1013 ps_try = max(ps + lambda*deltamp(2), pmin)
1014 call s_compute_ptg_residual(ml_try, mt, ps_try, j, k, l, q_cons_vf, rhoe, r2d_try, ts, mcp, mq, mcvgp, mcvgp2, mcpd)
1015 resnorm_try = sqrt(r2d_try(1)**2 + r2d_try(2)**2)
1016 if ((resnorm_try < resnorm) .or. (ls == ptg_ls_max)) exit
1017 lambda = 0.5_wp*lambda
1018 end do
1019
1020 ! accept the trial state (TS, mCP, mQ, mCVGP, mCVGP2, mCPD already set to it by the last call)
1021 ml = ml_try; ps = ps_try; r2d = r2d_try; resnorm = resnorm_try
1022 end do
1023
1024 ! commit the reacting masses (mT conserved) and set the common temperature
1025 q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, l) = ml
1026 q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, k, l) = mt - ml
1027
1028 ts = (rhoe + ps - mq)/mcp
1029
1030 end subroutine s_infinite_ptg_relaxation_k
1031
1032 !> Correct the partial densities of the reacting fluids in case one of them is negative but their sum is positive. Inert phases
1033 !! are not corrected at this moment
1034 subroutine s_correct_partial_densities(MCT, q_cons_vf, rM, j, k, l)
1035
1036
1037# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1038#ifdef _CRAYFTN
1039# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1040#if MFC_OpenACC
1041# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1042!$acc routine seq
1043# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1044#elif MFC_OpenMP
1045# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1046
1047# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1048
1049# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1050!$omp declare target device_type(any)
1051# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1052#else
1053# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1054!DIR$ NOINLINE s_correct_partial_densities
1055# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1056#endif
1057# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1058#elif MFC_OpenACC
1059# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1060!$acc routine seq
1061# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1062#elif MFC_OpenMP
1063# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1064
1065# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1066
1067# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1068!$omp declare target device_type(any)
1069# 445 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1070#endif
1071# 446 "/home/runner/work/MFC/MFC/src/common/m_phase_change.fpp"
1072
1073 !> @name variables for the correction of the reacting partial densities
1074 !> @{
1075 real(wp), intent(out) :: mct
1076 type(scalar_field), dimension(sys_size), intent(inout) :: q_cons_vf
1077 real(wp), intent(inout) :: rm
1078 integer, intent(in) :: j, k, l
1079 !> @}
1080 if (rm < 0.0_wp) then
1081 if ((q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, &
1082 & l) >= -1.0_wp*mixm) .and. (q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, k, l) >= -1.0_wp*mixm)) then
1083 q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, l) = 0.0_wp
1084
1085 q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, k, l) = 0.0_wp
1086
1087 rm = q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, l) + q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, k, l)
1088 end if
1089 end if
1090
1091 ! TODO: Consider partitioning partial densities instead of absolute-value correction
1092 mct = 2*mixm
1093
1094 ! correcting the partial densities of the reacting fluids. What to do for the nonreacting ones?
1095 if (q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, l) < 0.0_wp) then
1096 q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, l) = mct*rm
1097
1098 q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, k, l) = (1.0_wp - mct)*rm
1099 else if (q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, k, l) < 0.0_wp) then
1100 q_cons_vf(lp + eqn_idx%cont%beg - 1)%sf(j, k, l) = (1.0_wp - mct)*rm
1101
1102 q_cons_vf(vp + eqn_idx%cont%beg - 1)%sf(j, k, l) = mct*rm
1103 end if
1104
1105 end subroutine s_correct_partial_densities
1106
1107 !> Finalize the phase change module
1111
1112end module m_phase_change
type(scalar_field), dimension(sys_size), intent(inout) q_cons_vf
real(wp), intent(inout) rm
integer, intent(in) k
real(wp), intent(out) mct
integer, intent(in) j
integer, intent(in) l
Compile-time constant parameters: default values, tolerances, and physical constants.
integer, parameter model_eqns_6eq
Shared derived types for field data, patch geometry, bubble dynamics, and MPI I/O structures.
Equations of state in Gamma/Pi form, rho e = Gamma(rho) p + Pi(rho).
real(wp) function, public f_sg_thermal(pres, rho_or_t, n, b, cv)
Stiffened-gas thermal law p + B = (n - 1)*cv*rho*T. Pass rho to get T, or T to get rho.
Global parameters for the post-process: domain geometry, equation of state, and output database setti...
Basic floating-point utilities: approximate equality, default detection, and coordinate bounds.
MPI gather and scatter operations for distributing post-process grid and flow-variable data.
Phase transition relaxation solvers for liquid-vapor flows with cavitation and boiling.
subroutine s_infinite_ptg_relaxation_k(j, k, l, ps, rhoe, q_cons_vf, ts, ptg_conv)
Apply pTg-equilibrium relaxation: a damped (backtracking line search) Newton solve for the reacting l...
impure subroutine, public s_finalize_relaxation_solver_module
Finalize the phase change module.
subroutine, public s_infinite_relaxation_k(q_cons_vf)
Apply pT- or pTg-equilibrium relaxation with mass depletion based on the incoming state conditions.
integer, parameter vp
index for the vapor phase of the reacting fluid
integer, parameter lp
index for the liquid phase of the reacting fluid
subroutine s_infinite_pt_relaxation_k(j, k, l, mfl, ps, p_infpt, q_cons_vf, rhoe, ts)
Apply pT-equilibrium relaxation for N fluids.
impure subroutine, public s_relaxation_solver(q_cons_vf)
Dispatch to the correct relaxation solver. Replaces the procedure pointer, which CCE is breaking on.
real(wp), parameter tcr
Critical temperature of water [K].
subroutine s_compute_ptg_residual(ml, mt, ps, j, k, l, q_cons_vf, rhoe, r2d, ts, mcp, mq, mcvgp, mcvgp2, mcpd)
Evaluate the pTg-equilibrium residual R2D and temperature TS at a trial state (ml,...
integer, parameter ptg_ls_max
max backtracking-line-search halvings in the pTg solver
integer, parameter max_iter
max Newton iterations before accepting the last iterate
impure subroutine, public s_initialize_phasechange_module
Initialize the phase change module (no module-level state to set up; the pT/pTg relaxation solvers ar...
real(wp), parameter mixm
Mixture mass fraction threshold for triggering phase change.
real(wp), parameter pcr
Critical pressure of water [Pa].
Conservative-to-primitive variable conversion, mixture property evaluation, and pressure computation.
Derived type annexing a scalar field (SF).