scalar_mixing_objective_function.f90

! Copyright (c) 2023, 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 scalar_mixing_objective
  use num_types, only: rp
  use objective, only: objective_t
  use simulation_m, only: simulation_t
  use design, only: design_t
  use json_module, only: json_file
  use json_utils, only: json_get_or_default
  use field, only: field_t
  use field_math, only: field_copy, field_cadd, field_col2, field_cmult
  use neko_config, only: neko_bcknd_device
  use math, only: glsc2, copy
  use device_math, only: device_glsc2, device_copy
  use mask_ops, only: mask_exterior_const, compute_masked_volume
  use coefs, only: coef_t
  use scratch_registry, only: neko_scratch_registry
  use utils, only: neko_error
  use adjoint_mixing_scalar_source_term, only: &
       adjoint_mixing_scalar_source_term_t
  ! delete after the simulation computes u u_adj
  use field_math, only: field_addcol3, field_col3
  implicit none
  private
 
  type, public, extends(objective_t) :: scalar_mixing_objective_t
     private
 
     type(field_t), pointer :: phi
     real(kind=rp) :: phi_ref
     class(coef_t), pointer :: coef
     real(kind=rp) :: domain_volume
 
     ! -----------------------------------------------------------------
     ! THESE SHOULD BE DELETED WHEN THE DESIGN UPDATE COMES IN.
     ! These sensitivity should return zero, and the simulation
     ! should compute the u u_adj component
     type(field_t), pointer :: u, v, w, u_adj, v_adj, w_adj
 
   contains
 
     procedure, public, pass(this) :: init_json_sim => &
          scalar_mixing_init_json_sim
     procedure, public, pass(this) :: init_from_attributes => &
          scalar_mixing_init_attributes
     procedure, public, pass(this) :: free => scalar_mixing_free
     procedure, public, pass(this) :: update_value => &
          scalar_mixing_update_value
     procedure, public, pass(this) :: update_sensitivity => &
          scalar_mixing_update_sensitivity
 
  end type scalar_mixing_objective_t
 
contains
 
  subroutine scalar_mixing_init_json_sim(this, json, design, simulation)
    class(scalar_mixing_objective_t), intent(inout) :: this
    type(json_file), intent(inout) :: json
    class(design_t), intent(in) :: design
    type(simulation_t), target, intent(inout) :: simulation
    real(kind=rp) :: weight
    real(kind=rp) :: phi_ref
    character(len=:), allocatable :: name
    character(len=:), allocatable :: mask_name
 
    call json_get_or_default(json, "weight", weight, 1.0_rp)
    call json_get_or_default(json, "mask_name", mask_name, "")
    call json_get_or_default(json, "target_concentration", phi_ref, 0.5_rp)
    call json_get_or_default(json, "name", name, "Scalar Mixing")
 
    ! initialize
    call this%init_from_attributes(design, simulation, weight, name, &
         mask_name, phi_ref)
  end subroutine scalar_mixing_init_json_sim
 
  subroutine scalar_mixing_init_attributes(this, design, simulation, weight, &
       name, mask_name, phi_ref)
    class(scalar_mixing_objective_t), intent(inout) :: this
    class(design_t), intent(in) :: design
    type(simulation_t), target, intent(inout) :: simulation
    real(kind=rp), intent(in) :: weight
    real(kind=rp), intent(in) :: phi_ref
    character(len=*), intent(in) :: mask_name
    character(len=*), intent(in) :: name
    type(adjoint_mixing_scalar_source_term_t) :: adjoint_forcing
 
    ! Start by checking if the adjoint scalar has been initialized
    if (.not.allocated(simulation%adjoint_case%scalar_adj)) then
       call neko_error("adjoint passive scalar not initialized")
    end if
 
    ! Call the base initializer
    call this%init_base(name, design%size(), weight, mask_name)
 
    ! Associate the integration weights
    this%coef => simulation%fluid%c_Xh
 
    ! Compute the masked volume
    if (this%has_mask) then
       this%domain_volume = compute_masked_volume(this%mask, this%coef)
    else
       this%domain_volume = this%coef%volume
    end if
 
    associate(f_phi_adj => simulation%adjoint_scalar%f_Xh)
 
      ! Associate json parameters
      this%phi_ref = phi_ref
 
      ! Associate forward passive scalar
      this%phi => simulation%scalar%s
 
      ! Initialize the scalar mixing adjoint source term
      call adjoint_forcing%init_from_components(f_phi_adj, this%phi, &
           this%weight, this%phi_ref, this%mask, this%has_mask, this%coef)
 
    end associate
 
    ! append adjoint source term to the adjoint passive scalar equation
    call simulation%adjoint_scalar%source_term%add_source_term(adjoint_forcing)
 
    !--------------------------------------------------------------------------
    ! THIS SHOULD BE REPLACED WHEN THE DESIGN UPDATE OCCURS
    this%u => simulation%fluid%u
    this%v => simulation%fluid%v
    this%w => simulation%fluid%w
    this%u_adj => simulation%adjoint_fluid%u_adj
    this%v_adj => simulation%adjoint_fluid%v_adj
    this%w_adj => simulation%adjoint_fluid%w_adj
  end subroutine scalar_mixing_init_attributes
 
  subroutine scalar_mixing_free(this)
    class(scalar_mixing_objective_t), intent(inout) :: this
    call this%free_base()
 
    this%u => null()
    this%v => null()
    this%w => null()
    this%phi => null()
    this%u_adj => null()
    this%v_adj => null()
    this%w_adj => null()
 
  end subroutine scalar_mixing_free
 
  subroutine scalar_mixing_update_value(this, design)
    class(scalar_mixing_objective_t), intent(inout) :: this
    class(design_t), intent(in) :: design
    type(field_t), pointer :: work
    integer :: temp_indices(1), n
 
 
    ! The objective being computed is
    !
    ! \f$1/2 \int_\Omega_{obj} (\phi - \phi_ref)^2 d\Omega\f$
 
    ! get a working array
    call neko_scratch_registry%request_field(work, temp_indices(1))
    n = work%size()
 
    ! \f$ \phi \f$
    call field_copy(work, this%phi)
    ! \f$ \phi - \phi_ref \f$
    call field_cadd(work, -this%phi_ref)
    ! \f$ (\phi - \phi_ref)^2 \f$
    call field_col2(work, work)
    ! \f$ mask to \Omega_{obj} \f$
    if (this%has_mask) then
       call mask_exterior_const(work, this%mask, 0.0_rp)
    end if
    ! integrate
    if (neko_bcknd_device .eq. 1) then
       this%value = device_glsc2(work%x_d, this%coef%B_d, n)
    else
       this%value = glsc2(work%x, this%coef%B, n)
    end if
 
    ! \f$ scale by 1/2 and 1/|\Omega_{obj}| \f$
    this%value = 0.5_rp * this%value / this%domain_volume
 
    ! relingush the scratch field
    call neko_scratch_registry%relinquish_field(temp_indices)
  end subroutine scalar_mixing_update_value
 
  subroutine scalar_mixing_update_sensitivity(this, design)
    class(scalar_mixing_objective_t), intent(inout) :: this
    class(design_t), intent(in) :: design
 
    !--------------------------------------------------------------------------
    ! THIS SHOULD BE REPLACED WITH A ZERO CONTRIBUTION AFTER THE DESIGN UPDATE
    type(field_t), pointer :: work
    integer :: temp_indices(1)
 
    call neko_scratch_registry%request_field(work, temp_indices(1))
 
    ! here it should just be an inner product between the forward and adjoint
    call field_col3(work, this%u, this%u_adj)
    call field_addcol3(work, this%v, this%v_adj)
    call field_addcol3(work, this%w, this%w_adj)
    ! but negative
    call field_cmult(work, -1.0_rp)
 
    if (neko_bcknd_device .eq. 1) then
       call device_copy(this%sensitivity%x_d, work%x_d, this%sensitivity%size())
    else
       call copy(this%sensitivity%x, work%x, this%sensitivity%size())
    end if
 
    call neko_scratch_registry%relinquish_field(temp_indices)
 
  end subroutine scalar_mixing_update_sensitivity
 
end module scalar_mixing_objective