bc.f90

Go to the documentation of this file.

! Copyright (c) 2020-2025, The Neko Authors
! All rights reserved.
!
! Redistribution and use in source and binary forms, with or without
! modification, are permitted provided that the following conditions
! are met:
!
!   * Redistributions of source code must retain the above copyright
!     notice, this list of conditions and the following disclaimer.
!
!   * Redistributions in binary form must reproduce the above
!     copyright notice, this list of conditions and the following
!     disclaimer in the documentation and/or other materials provided
!     with the distribution.
!
!   * Neither the name of the authors nor the names of its
!     contributors may be used to endorse or promote products derived
!     from this software without specific prior written permission.
!
! THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
! "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
! LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
! FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
! COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
! INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
! BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
! LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
! CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
! LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
! ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
! POSSIBILITY OF SUCH DAMAGE.
!
module bc
  use neko_config, only : neko_bcknd_device
  use num_types, only : rp
  use device, only : host_to_device, device_memcpy, &
       device_unmap, device_map, device_to_host, glb_cmd_queue
  use iso_c_binding, only : c_associated
  use dofmap, only : dofmap_t
  use coefs, only : coef_t
  use space, only : space_t
  use mesh, only : mesh_t, neko_msh_max_zlbls, neko_msh_max_zlbl_len
  use facet_zone, only : facet_zone_t
  use stack, only : stack_i4t2_t
  use tuple, only : tuple_i4_t
  use field, only : field_t
  use gs_ops, only : gs_op_add
  use math, only : relcmp
  use utils, only : neko_error, linear_index, split_string
  use logger, only : neko_log, log_size
  use, intrinsic :: iso_c_binding, only : c_ptr, c_null_ptr
  use json_module, only : json_file
  use time_state, only : time_state_t
  use field, only : field_t
  use file, only : file_t
 
  implicit none
  private
 
  type, public, abstract :: bc_t
     integer, allocatable :: msk(:)
     integer, allocatable :: facet(:)
     type(dofmap_t), pointer :: dof => null()
     type(coef_t), pointer :: coef => null()
     type(mesh_t), pointer :: msh => null()
     type(space_t), pointer :: xh => null()
     type(stack_i4t2_t) :: marked_facet
     type(c_ptr) :: msk_d = c_null_ptr
     type(c_ptr) :: facet_d = c_null_ptr
     logical :: strong = .true.
     logical :: updated = .false.
     !!> Name of the bc
     character(len=:), allocatable :: name
     !!> Zone indices where the bc is applied
     integer, allocatable :: zone_indices(:)
   contains
     procedure, pass(this) :: init_base => bc_init_base
     procedure, pass(this) :: free_base => bc_free_base
     procedure, pass(this) :: mark_facet => bc_mark_facet
     procedure, pass(this) :: mark_facets => bc_mark_facets
     procedure, pass(this) :: mark_zone => bc_mark_zone
     procedure, pass(this) :: finalize_base => bc_finalize_base
 
     procedure, pass(this) :: apply_scalar_generic => bc_apply_scalar_generic
     procedure, pass(this) :: apply_vector_generic => bc_apply_vector_generic
     procedure, pass(this) :: debug_mask_ => bc_debug_mask
     procedure(bc_apply_scalar), pass(this), deferred :: apply_scalar
     procedure(bc_apply_vector), pass(this), deferred :: apply_vector
     procedure(bc_apply_scalar_dev), pass(this), deferred :: apply_scalar_dev
     procedure(bc_apply_vector_dev), pass(this), deferred :: apply_vector_dev
     procedure(bc_destructor), pass(this), deferred :: free
     procedure(bc_constructor), pass(this), deferred :: init
     procedure(bc_finalize), pass(this), deferred :: finalize
  end type bc_t
 
  type, public :: bc_ptr_t
     class(bc_t), pointer :: ptr => null()
  end type bc_ptr_t
 
  ! Helper type to have an array of polymorphic bc_t objects.
  type, public :: bc_alloc_t
     class(bc_t), allocatable :: obj
  end type bc_alloc_t
 
 
  abstract interface
 
     subroutine bc_constructor(this, coef, json)
       import :: bc_t, coef_t, json_file
       class(bc_t), intent(inout), target :: this
       type(coef_t), target, intent(in) :: coef
       type(json_file), intent(inout) :: json
     end subroutine bc_constructor
  end interface
 
  abstract interface
 
     subroutine bc_destructor(this)
       import :: bc_t
       class(bc_t), intent(inout), target :: this
     end subroutine bc_destructor
  end interface
 
  abstract interface
 
     subroutine bc_finalize(this, only_facets)
       import :: bc_t
       class(bc_t), intent(inout), target :: this
       logical, optional, intent(in) :: only_facets
     end subroutine bc_finalize
  end interface
 
  abstract interface
 
     subroutine bc_apply_scalar(this, x, n, time, strong)
       import :: bc_t, time_state_t
       import :: rp
       class(bc_t), intent(inout) :: this
       integer, intent(in) :: n
       real(kind=rp), intent(inout), dimension(n) :: x
       type(time_state_t), intent(in), optional :: time
       logical, intent(in), optional :: strong
     end subroutine bc_apply_scalar
  end interface
 
  abstract interface
 
     subroutine bc_apply_vector(this, x, y, z, n, time, strong)
       import :: bc_t, time_state_t
       import :: rp
       class(bc_t), intent(inout) :: this
       integer, intent(in) :: n
       real(kind=rp), intent(inout), dimension(n) :: x
       real(kind=rp), intent(inout), dimension(n) :: y
       real(kind=rp), intent(inout), dimension(n) :: z
       type(time_state_t), intent(in), optional :: time
       logical, intent(in), optional :: strong
     end subroutine bc_apply_vector
  end interface
 
  abstract interface
 
     subroutine bc_apply_scalar_dev(this, x_d, time, strong, strm)
       import :: c_ptr
       import :: bc_t, time_state_t
       import :: rp
       class(bc_t), intent(inout), target :: this
       type(c_ptr), intent(inout) :: x_d
       type(time_state_t), intent(in), optional :: time
       logical, intent(in), optional :: strong
       type(c_ptr), intent(inout) :: strm
     end subroutine bc_apply_scalar_dev
  end interface
 
  abstract interface
 
     subroutine bc_apply_vector_dev(this, x_d, y_d, z_d, time, strong, strm)
       import :: c_ptr, bc_t, time_state_t
       import :: rp
       class(bc_t), intent(inout), target :: this
       type(c_ptr), intent(inout) :: x_d
       type(c_ptr), intent(inout) :: y_d
       type(c_ptr), intent(inout) :: z_d
       type(time_state_t), intent(in), optional :: time
       logical, intent(in), optional :: strong
       type(c_ptr), intent(inout) :: strm
     end subroutine bc_apply_vector_dev
  end interface
 
contains
 
  subroutine bc_init_base(this, coef)
    class(bc_t), intent(inout) :: this
    type(coef_t), target, intent(in) :: coef
 
    call this%free_base
 
    this%dof => coef%dof
    this%coef => coef
    this%Xh => this%dof%Xh
    this%msh => this%dof%msh
 
    call this%marked_facet%init()
 
  end subroutine bc_init_base
 
  subroutine bc_free_base(this)
    class(bc_t), intent(inout) :: this
 
    call this%marked_facet%free()
 
    nullify(this%Xh)
    nullify(this%msh)
    nullify(this%dof)
    nullify(this%coef)
 
    if (allocated(this%msk)) then
       if (neko_bcknd_device .eq. 1) then
          call device_unmap(this%msk, this%msk_d)
       end if
       deallocate(this%msk)
    end if
 
    if (allocated(this%facet)) then
       if (neko_bcknd_device .eq. 1) then
          call device_unmap(this%facet, this%facet_d)
       end if
       deallocate(this%facet)
    end if
 
    if (allocated(this%name)) then
       deallocate(this%name)
    end if
 
    if (allocated(this%zone_indices)) then
       deallocate(this%zone_indices)
    end if
 
    ! Back to the state of a freshly declared bc, so that a condition which is
    ! reinitialised does not inherit an `updated` from its previous life and
    ! skip its first update.
    this%updated = .false.
 
  end subroutine bc_free_base
 
  subroutine bc_apply_vector_generic(this, x, y, z, time, strong, strm)
    class(bc_t), intent(inout) :: this
    type(field_t), intent(inout) :: x
    type(field_t), intent(inout) :: y
    type(field_t), intent(inout) :: z
    type(time_state_t), intent(in), optional :: time
    logical, intent(in), optional :: strong
    type(c_ptr), intent(inout), optional :: strm
    type(c_ptr) :: strm_
    integer :: n
    character(len=256) :: msg
 
    ! Get the size of the fields
    n = x%size()
 
    ! Ensure all fields are the same size
    if (y%size() .ne. n .or. z%size() .ne. n) then
       msg = "Fields x, y, z must have the same size in " // &
            "bc_list_apply_vector_field"
       call neko_error(trim(msg))
    end if
 
    if (neko_bcknd_device .eq. 1) then
 
       if (present(strm)) then
          strm_ = strm
       else
          strm_ = glb_cmd_queue
       end if
 
       call this%apply_vector_dev(x%x_d, y%x_d, z%x_d, time = time, &
            strong = strong, strm = strm_)
    else
       call this%apply_vector(x%x, y%x, z%x, n, time = time, strong = strong)
    end if
 
  end subroutine bc_apply_vector_generic
 
  subroutine bc_apply_scalar_generic(this, x, time, strong, strm)
    class(bc_t), intent(inout) :: this
    type(field_t), intent(inout) :: x
    type(time_state_t), intent(in), optional :: time
    logical, intent(in), optional :: strong
    type(c_ptr), intent(inout), optional :: strm
    type(c_ptr) :: strm_
    integer :: n
 
    ! Get the size of the field
    n = x%size()
 
    if (neko_bcknd_device .eq. 1) then
 
       if (present(strm)) then
          strm_ = strm
       else
          strm_ = glb_cmd_queue
       end if
 
       call this%apply_scalar_dev(x%x_d, time = time, strong = strong, &
            strm = strm_)
    else
       call this%apply_scalar(x%x, n, time = time)
    end if
 
  end subroutine bc_apply_scalar_generic
 
  subroutine bc_mark_facet(this, facet, el)
    class(bc_t), intent(inout) :: this
    integer, intent(in) :: facet
    integer, intent(in) :: el
    type(tuple_i4_t) :: t
 
    t%x = [facet, el]
    call this%marked_facet%push(t)
 
  end subroutine bc_mark_facet
 
  subroutine bc_mark_facets(this, facet_list)
    class(bc_t), intent(inout) :: this
    type(stack_i4t2_t), intent(inout) :: facet_list
    type(tuple_i4_t), pointer :: fp(:)
    integer :: i
 
    fp => facet_list%array()
    do i = 1, facet_list%size()
       call this%marked_facet%push(fp(i))
    end do
 
  end subroutine bc_mark_facets
 
  subroutine bc_mark_zone(this, bc_zone)
    class(bc_t), intent(inout) :: this
    class(facet_zone_t), intent(in) :: bc_zone
    integer :: i
    do i = 1, bc_zone%size
       call this%marked_facet%push(bc_zone%facet_el(i))
    end do
  end subroutine bc_mark_zone
 
  subroutine bc_finalize_base(this, only_facets)
    class(bc_t), target, intent(inout) :: this
    logical, optional, intent(in) :: only_facets
    type(tuple_i4_t), pointer :: bfp(:)
    type(tuple_i4_t) :: bc_facet
    type(field_t) :: test_field
    integer :: facet_size, facet, el
    logical :: only_facet = .false.
    integer :: i, j, k, l, msk_c
    integer :: lx, ly, lz, n
    character(len=LOG_SIZE) :: log_buf
    lx = this%Xh%lx
    ly = this%Xh%ly
    lz = this%Xh%lz
    if ( present(only_facets)) then
       only_facet = only_facets
    else
       only_facet = .false.
    end if
 
    ! Note we assume that lx = ly = lz
    facet_size = lx**2
    allocate(this%msk(0:facet_size * this%marked_facet%size()))
    allocate(this%facet(0:facet_size * this%marked_facet%size()))
 
    msk_c = 0
    bfp => this%marked_facet%array()
 
    ! Loop through each (facet, element) id tuple
    ! Then loop over all the nodes of the face and compute their linear index
    ! This index goes into this%msk, whereas the corresponding face id goes into
    ! this%facet
    do i = 1, this%marked_facet%size()
       bc_facet = bfp(i)
       facet = bc_facet%x(1)
       el = bc_facet%x(2)
       select case (facet)
       case (1)
          do l = 1, lz
             do k = 1, ly
                msk_c = msk_c + 1
                this%msk(msk_c) = linear_index(1, k, l, el, lx, ly, lz)
                this%facet(msk_c) = 1
             end do
          end do
       case (2)
          do l = 1, lz
             do k = 1, ly
                msk_c = msk_c + 1
                this%msk(msk_c) = linear_index(lx, k, l, el, lx, ly, lz)
                this%facet(msk_c) = 2
             end do
          end do
       case (3)
          do l = 1, lz
             do j = 1, lx
                msk_c = msk_c + 1
                this%msk(msk_c) = linear_index(j, 1, l, el, lx, ly, lz)
                this%facet(msk_c) = 3
             end do
          end do
       case (4)
          do l = 1, lz
             do j = 1, lx
                msk_c = msk_c + 1
                this%msk(msk_c) = linear_index(j, ly, l, el, lx, ly, lz)
                this%facet(msk_c) = 4
             end do
          end do
       case (5)
          do k = 1, ly
             do j = 1, lx
                msk_c = msk_c + 1
                this%msk(msk_c) = linear_index(j, k, 1, el, lx, ly, lz)
                this%facet(msk_c) = 5
             end do
          end do
       case (6)
          do k = 1, ly
             do j = 1, lx
                msk_c = msk_c + 1
                this%msk(msk_c) = linear_index(j, k, lz, el, lx, ly, lz)
                this%facet(msk_c) = 6
             end do
          end do
       end select
    end do
    this%facet(0) = msk_c
    if (neko_bcknd_device .eq. 1) then
       !Observe the facet_mask is junk if only_facet is false
       n = msk_c + 1
       call device_map(this%facet, this%facet_d, n)
       call device_memcpy(this%facet, this%facet_d, n, &
            host_to_device, sync = .true.)
    end if
    if ( .not. only_facet) then
       !Makes check for points not on facet that should have bc applied
       call test_field%init(this%dof)
 
       n = test_field%size()
       test_field%x = 0.0_rp
       !Apply this bc once
       do i = 1, msk_c
          test_field%x(this%msk(i),1,1,1) = 1.0
       end do
       if (neko_bcknd_device .eq. 1) then
          call device_memcpy(test_field%x, test_field%x_d, n, &
               host_to_device, sync = .true.)
       end if
       !Check if some point that was not zeroed was zeroed on another element
       call this%coef%gs_h%op(test_field, gs_op_add)
       if (neko_bcknd_device .eq. 1) then
          call device_memcpy(test_field%x, test_field%x_d, n, &
               device_to_host, sync = .true.)
       end if
       msk_c = 0
       do i = 1, this%dof%size()
          if (test_field%x(i,1,1,1) .gt. 0.5) then
             msk_c = msk_c + 1
          end if
       end do
       !Allocate new mask
       deallocate(this%msk)
       allocate(this%msk(0:msk_c))
       j = 1
       do i = 1, this%dof%size()
          if (test_field%x(i,1,1,1) .gt. 0.5) then
             this%msk(j) = i
             j = j + 1
          end if
       end do
 
       call test_field%free()
    end if
 
    this%msk(0) = msk_c
 
    if (neko_bcknd_device .eq. 1) then
       n = msk_c + 1
       call device_map(this%msk, this%msk_d, n)
       call device_memcpy(this%msk, this%msk_d, n, &
            host_to_device, sync = .true.)
    end if
 
    if (.not. allocated(this%name)) then
! gives plenty of empty info lines during AMR restart
!       this%name = ""
    else
       write(log_buf, '(A,A)') 'BC assigned name :   ', trim(this%name)
       call neko_log%message(log_buf)
    end if
 
! causes trouble for AMR restart
!    if (.not. allocated(this%zone_indices)) then
!       allocate(this%zone_indices(1))
!       this%zone_indices(1) = -1
!    end if
 
  end subroutine bc_finalize_base
 
  subroutine bc_debug_mask(this, file_name)
    class(bc_t), intent(inout) :: this
    character(len=*), intent(in) :: file_name
    type(field_t) :: bdry_field
    integer:: i, m, k
    type(file_t) :: dump_file
 
    call bdry_field%init(this%coef%dof, 'bdry')
    m = this%msk(0)
    do i = 1, m
       k = this%msk(i)
       bdry_field%x(k,1,1,1) = 1.0_rp
    end do
    call dump_file%init(file_name)
    call dump_file%write(bdry_field)
 
  end subroutine bc_debug_mask
end module bc