MFC
Exascale flow solver
Loading...
Searching...
No Matches
m_amr_advance Module Reference

Fine-block stage advance and the immersed-boundary/Lagrange fine services. More...

Functions/Subroutines

impure subroutine, public s_amr_setup_ib ()
 Compute the fine-grid IB state (markers/ghost points/levelset) for every active block from the body geometry (static-body AMR), once after the coarse IB setup: swap grid and IB globals to each owned block, run the fine IB pipeline, restore.
impure subroutine s_amr_ib_correct_fine (q_prim_b, pb_in, mv_in)
 Apply the IB state correction on the current fine block after its RK update, mirroring the coarse s_ibm_correct_state. amr_cur is set by the caller.
impure subroutine s_amr_fine_hooks_post_ib ()
 The clamps after the IB correction on the current fine block; the species cleanup's report reads the block's own markers.
impure subroutine s_amr_update_mib_fine ()
 Rebuild the current fine block's IB state from the moving body's position (prescribed motion, moving_ibm==1) by reusing the coarse s_update_mib on the swapped-in slot. Must precede s_amr_ib_correct_fine.
impure subroutine, public s_amr_fine_stage_advance_batched (s, coefs, bc_type, q_t_sf, pb_in, rhs_pb, mv_in, rhs_mv, t_step)
 Batched fine advance: owned fine blocks are advanced in batches of up to amr_bat_lim blocks of the same level and (padded) extent, stacked two ghost shells apart along the last active dimension, so one s_compute_rhs call and one RK kernel cover a batch. Blocks are independent, so grouping order is free. Members read the leader's coordinate arrays in the non-stacked dimensions (see s_amr_init_report).
impure subroutine s_amr_form_batch (i, my, done)
 Start a batch at leader my(i): add later same-level blocks that fit the leader's extent, wasting <= amr_bat_pad of the member's cells; marks members done.
impure subroutine s_amr_bat_ib_tables ()
 For the IB face forces on this batch (s_accumulate_ib_face_fluxes): each member's origin relative to the leader's, and the boxes its level+1 children cover, in slab indices.
impure subroutine s_amr_batch_post_rk_hooks (coefs, pb_in, mv_in)
 Per-member post-RK hooks of the coarse stage (q_cons_ts(1), m_time_steppers).
impure logical function f_amr_ib_waits (blk)
 Whether block blk's IB correction waits for the bodies to move: it holds ghost points, or a moving body (one coarse cell beyond the margin s_amr_update_mib_fine keeps it inside, for this stage's displacement) overlaps it.
impure subroutine s_amr_ibp_reserve (my)
 Size amr_ibp for the owned blocks my(:) that wait (their columns need not survive a stage) and start the stage's list.
impure subroutine s_amr_ibp_save (ibm)
 Keep batch member ibm's primitive state from the RHS pass (amr_scr_prim, at its slab offset) in the next amr_ibp column.
impure subroutine, public s_amr_fine_stage_ib (pb_in, mv_in)
 After the bodies have moved on the stage's complete force: the IB rebuild, the correction and the clamps after it, on each block s_amr_batch_post_rk_hooks left waiting, from its saved primitive state.
impure subroutine s_amr_bat_layout ()
 The batch's slab layout: members stacked along the last active dim, stride amr_bat_w.
impure subroutine s_amr_fine_rk_update_batch (nb, q_rhs, c1, c2, c3, c4, dt_in)
 Device RK stage update over the batch: q = (c1*q + c2*q_stor + c3*dt_in*rhs)/c4 (compute in wp, store stp), reading each member's rhs at its slab offset. Keep in lockstep with the non-IGR rk_coef form in s_tvd_rk (m_time_steppers).

Detailed Description

Fine-block stage advance and the immersed-boundary/Lagrange fine services.

Function/Subroutine Documentation

◆ f_amr_ib_waits()

impure logical function m_amr_advance::f_amr_ib_waits ( integer, intent(in) blk)
private

Whether block blk's IB correction waits for the bodies to move: it holds ghost points, or a moving body (one coarse cell beyond the margin s_amr_update_mib_fine keeps it inside, for this stage's displacement) overlaps it.

Definition at line 706 of file m_amr_advance.fpp.f90.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ s_amr_bat_ib_tables()

impure subroutine m_amr_advance::s_amr_bat_ib_tables
private

For the IB face forces on this batch (s_accumulate_ib_face_fluxes): each member's origin relative to the leader's, and the boxes its level+1 children cover, in slab indices.

Definition at line 623 of file m_amr_advance.fpp.f90.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ s_amr_bat_layout()

impure subroutine m_amr_advance::s_amr_bat_layout
private

The batch's slab layout: members stacked along the last active dim, stride amr_bat_w.

Definition at line 945 of file m_amr_advance.fpp.f90.

Here is the caller graph for this function:

◆ s_amr_batch_post_rk_hooks()

impure subroutine m_amr_advance::s_amr_batch_post_rk_hooks ( real(wp), dimension(4), intent(in) coefs,
real(stp), dimension(:,:,:,:,:), intent(inout) pb_in,
real(stp), dimension(:,:,:,:,:), intent(inout) mv_in )
private

Per-member post-RK hooks of the coarse stage (q_cons_ts(1), m_time_steppers).

Definition at line 662 of file m_amr_advance.fpp.f90.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ s_amr_fine_hooks_post_ib()

impure subroutine m_amr_advance::s_amr_fine_hooks_post_ib
private

The clamps after the IB correction on the current fine block; the species cleanup's report reads the block's own markers.

Definition at line 453 of file m_amr_advance.fpp.f90.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ s_amr_fine_rk_update_batch()

impure subroutine m_amr_advance::s_amr_fine_rk_update_batch ( integer, intent(in) nb,
type(scalar_field), dimension(sys_size), intent(in) q_rhs,
real(wp), intent(in) c1,
real(wp), intent(in) c2,
real(wp), intent(in) c3,
real(wp), intent(in) c4,
real(wp), intent(in) dt_in )
private

Device RK stage update over the batch: q = (c1*q + c2*q_stor + c3*dt_in*rhs)/c4 (compute in wp, store stp), reading each member's rhs at its slab offset. Keep in lockstep with the non-IGR rk_coef form in s_tvd_rk (m_time_steppers).

Definition at line 960 of file m_amr_advance.fpp.f90.

Here is the caller graph for this function:

◆ s_amr_fine_stage_advance_batched()

impure subroutine, public m_amr_advance::s_amr_fine_stage_advance_batched ( integer, intent(in) s,
real(wp), dimension(4), intent(in) coefs,
type(integer_field), dimension(1:num_dims,1:2), intent(in) bc_type,
type(scalar_field), intent(inout) q_t_sf,
real(stp), dimension(:,:,:,:,:), intent(inout) pb_in,
real(wp), dimension(:,:,:,:,:), intent(inout) rhs_pb,
real(stp), dimension(:,:,:,:,:), intent(inout) mv_in,
real(wp), dimension(:,:,:,:,:), intent(inout) rhs_mv,
integer, intent(in) t_step )

Batched fine advance: owned fine blocks are advanced in batches of up to amr_bat_lim blocks of the same level and (padded) extent, stacked two ghost shells apart along the last active dimension, so one s_compute_rhs call and one RK kernel cover a batch. Blocks are independent, so grouping order is free. Members read the leader's coordinate arrays in the non-stacked dimensions (see s_amr_init_report).

Definition at line 507 of file m_amr_advance.fpp.f90.

Here is the call graph for this function:

◆ s_amr_fine_stage_ib()

impure subroutine, public m_amr_advance::s_amr_fine_stage_ib ( real(stp), dimension(:,:,:,:,:), intent(inout) pb_in,
real(stp), dimension(:,:,:,:,:), intent(inout) mv_in )

After the bodies have moved on the stage's complete force: the IB rebuild, the correction and the clamps after it, on each block s_amr_batch_post_rk_hooks left waiting, from its saved primitive state.

Definition at line 874 of file m_amr_advance.fpp.f90.

Here is the call graph for this function:

◆ s_amr_form_batch()

impure subroutine m_amr_advance::s_amr_form_batch ( integer, intent(in) i,
integer, dimension(:), intent(in) my,
logical, dimension(:), intent(inout) done )
private

Start a batch at leader my(i): add later same-level blocks that fit the leader's extent, wasting <= amr_bat_pad of the member's cells; marks members done.

Definition at line 599 of file m_amr_advance.fpp.f90.

Here is the caller graph for this function:

◆ s_amr_ib_correct_fine()

impure subroutine m_amr_advance::s_amr_ib_correct_fine ( type(scalar_field), dimension(1:sys_size), intent(inout) q_prim_b,
real(stp), dimension(:,:,:,:,:), intent(inout) pb_in,
real(stp), dimension(:,:,:,:,:), intent(inout) mv_in )
private

Apply the IB state correction on the current fine block after its RK update, mirroring the coarse s_ibm_correct_state. amr_cur is set by the caller.

Parameters
[in,out]q_prim_bthe q_prim the block's RHS pass filled (pooled scratch)
[in,out]mv_inunread: amr prohibits qbmm

Definition at line 429 of file m_amr_advance.fpp.f90.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ s_amr_ibp_reserve()

impure subroutine m_amr_advance::s_amr_ibp_reserve ( integer, dimension(:), intent(in) my)
private

Size amr_ibp for the owned blocks my(:) that wait (their columns need not survive a stage) and start the stage's list.

Definition at line 725 of file m_amr_advance.fpp.f90.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ s_amr_ibp_save()

impure subroutine m_amr_advance::s_amr_ibp_save ( integer, intent(in) ibm)
private

Keep batch member ibm's primitive state from the RHS pass (amr_scr_prim, at its slab offset) in the next amr_ibp column.

Definition at line 812 of file m_amr_advance.fpp.f90.

Here is the caller graph for this function:

◆ s_amr_setup_ib()

impure subroutine, public m_amr_advance::s_amr_setup_ib

Compute the fine-grid IB state (markers/ghost points/levelset) for every active block from the body geometry (static-body AMR), once after the coarse IB setup: swap grid and IB globals to each owned block, run the fine IB pipeline, restore.

Definition at line 400 of file m_amr_advance.fpp.f90.

Here is the call graph for this function:

◆ s_amr_update_mib_fine()

impure subroutine m_amr_advance::s_amr_update_mib_fine
private

Rebuild the current fine block's IB state from the moving body's position (prescribed motion, moving_ibm==1) by reusing the coarse s_update_mib on the swapped-in slot. Must precede s_amr_ib_correct_fine.

Definition at line 464 of file m_amr_advance.fpp.f90.

Here is the call graph for this function:
Here is the caller graph for this function: