curl_simcomp.f90

Go to the documentation of this file.

! Copyright (c) 2023-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 curl_simcomp
  use num_types, only : rp, dp, sp
  use json_module, only : json_file
  use simulation_component, only : simulation_component_t
  use field_registry, only : neko_field_registry
  use field, only : field_t
  use time_state, only : time_state_t
  use operators, only : curl
  use case, only : case_t
  use fld_file_output, only : fld_file_output_t
  use json_utils, only : json_get, json_get_or_default
  use field_writer, only : field_writer_t
  use device, only : glb_cmd_event
  use scratch_registry, only : neko_scratch_registry
  use time_based_controller, only : time_based_controller_t
  use utils, only : neko_error
  implicit none
  private
 
  type, public, extends(simulation_component_t) :: curl_t
     type(field_t), pointer :: u
     type(field_t), pointer :: v
     type(field_t), pointer :: w
 
     type(field_t), pointer :: curl_x
     type(field_t), pointer :: curl_y
     type(field_t), pointer :: curl_z
 
     type(field_writer_t) :: writer
 
   contains
     procedure, pass(this) :: init => curl_init_from_json
     generic :: init_from_components => &
          init_from_controllers, init_from_controllers_properties
     procedure, pass(this) :: init_from_controllers => &
          curl_init_from_controllers
     procedure, pass(this) :: init_from_controllers_properties => &
          curl_init_from_controllers_properties
     procedure, private, pass(this) :: init_common => curl_init_common
     procedure, pass(this) :: free => curl_free
     procedure, pass(this) :: compute_ => curl_compute
  end type curl_t
 
contains
 
  subroutine curl_init_from_json(this, json, case)
    class(curl_t), intent(inout), target :: this
    type(json_file), intent(inout) :: json
    class(case_t), intent(inout), target :: case
    character(len=20) :: fields(3)
    character(len=20), allocatable :: field_names(:)
    character(len=:), allocatable :: computed_field
 
 
    call json_get_or_default(json, "computed_field", computed_field, "curl")
    call json_get(json, "fields", field_names)
 
    if (size(field_names) .ne. 3) then
       call neko_error("The curl simcomp requires exactly 3 entries in " // &
            "fields.")
    end if
 
    fields(1) = trim(computed_field) // "_x"
    fields(2) = trim(computed_field) // "_y"
    fields(3) = trim(computed_field) // "_z"
 
    ! This is needed for the field writer to pick up the fields.
    call json%add("fields", fields)
 
    call this%init_base(json, case)
    call this%writer%init(json, case)
 
    call curl_init_common(this, field_names, computed_field)
  end subroutine curl_init_from_json
 
  subroutine curl_init_common(this, field_names, computed_field)
    class(curl_t), intent(inout) :: this
    character(len=*) :: field_names(3)
    character(len=*) :: computed_field
 
    this%u => neko_field_registry%get_field_by_name(field_names(1))
    this%v => neko_field_registry%get_field_by_name(field_names(2))
    this%w => neko_field_registry%get_field_by_name(field_names(3))
 
    this%curl_x => neko_field_registry%get_field_by_name(computed_field // &
         "_x")
    this%curl_y => neko_field_registry%get_field_by_name(computed_field // &
 
         "_y")
    this%curl_z => neko_field_registry%get_field_by_name(computed_field // &
         "_z")
 
  end subroutine curl_init_common
 
  subroutine curl_init_from_controllers(this, case, order, &
       preprocess_controller, compute_controller, output_controller, &
       field_names, computed_field, filename, precision)
    class(curl_t), intent(inout) :: this
    class(case_t), intent(inout), target :: case
    integer :: order
    type(time_based_controller_t), intent(in) :: preprocess_controller
    type(time_based_controller_t), intent(in) :: compute_controller
    type(time_based_controller_t), intent(in) :: output_controller
    character(len=*) :: field_names(3)
    character(len=*) :: computed_field
    character(len=*), intent(in), optional :: filename
    integer, intent(in), optional :: precision
 
    character(len=20) :: fields(3)
 
    fields(1) = trim(computed_field) // "_x"
    fields(2) = trim(computed_field) // "_y"
    fields(3) = trim(computed_field) // "_z"
 
    call this%init_base_from_components(case, order, preprocess_controller, &
         compute_controller, output_controller)
    call this%writer%init_from_components(case, order, preprocess_controller, &
         compute_controller, output_controller, fields, filename, precision)
    call this%init_common(field_names, computed_field)
 
  end subroutine curl_init_from_controllers
 
  subroutine curl_init_from_controllers_properties(this, &
       case, order, preprocess_control, preprocess_value, compute_control, &
       compute_value, output_control, output_value, field_names, computed_field, &
       filename, precision)
    class(curl_t), intent(inout) :: this
    class(case_t), intent(inout), target :: case
    integer :: order
    character(len=*), intent(in) :: preprocess_control
    real(kind=rp), intent(in) :: preprocess_value
    character(len=*), intent(in) :: compute_control
    real(kind=rp), intent(in) :: compute_value
    character(len=*), intent(in) :: output_control
    real(kind=rp), intent(in) :: output_value
    character(len=*) :: field_names(3)
    character(len=*) :: computed_field
    character(len=*), intent(in), optional :: filename
    integer, intent(in), optional :: precision
 
    character(len=20) :: fields(3)
 
    fields(1) = trim(computed_field) // "_x"
    fields(2) = trim(computed_field) // "_y"
    fields(3) = trim(computed_field) // "_z"
 
    call this%init_base_from_components(case, order, preprocess_control, &
         preprocess_value, compute_control, compute_value, output_control, &
         output_value)
    call this%writer%init_from_components(case, order, preprocess_control, &
         preprocess_value, compute_control, compute_value, output_control, &
         output_value, fields, filename, precision)
    call this%init_common(field_names, computed_field)
 
  end subroutine curl_init_from_controllers_properties
 
  subroutine curl_free(this)
    class(curl_t), intent(inout) :: this
    call this%free_base()
    call this%writer%free()
 
    nullify(this%u)
    nullify(this%v)
    nullify(this%w)
    nullify(this%curl_x)
    nullify(this%curl_y)
    nullify(this%curl_z)
  end subroutine curl_free
 
  subroutine curl_compute(this, time)
    class(curl_t), intent(inout) :: this
    type(time_state_t), intent(in) :: time
    type(field_t), pointer :: temp1, temp2
    integer :: tmp_idx(2)
 
    call neko_scratch_registry%request_field(temp1, tmp_idx(1))
    call neko_scratch_registry%request_field(temp2, tmp_idx(2))
 
    call curl(this%curl_x, this%curl_y, this%curl_z, this%u, this%v, &
         this%w, temp1, temp2, this%case%fluid%c_Xh, &
         glb_cmd_event)
 
    call neko_scratch_registry%relinquish_field(tmp_idx)
  end subroutine curl_compute
 
end module curl_simcomp