scalar_scheme.f90

Go to the documentation of this file.

! Copyright (c) 2022-2026, 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_scheme
  use gather_scatter, only : gs_t
  use checkpoint, only : chkp_t
  use checkpoint_payload, only : checkpoint_payload_t
  use num_types, only : rp
  use field, only : field_t
  use field_list, only : field_list_t
  use space, only : space_t
  use dofmap, only : dofmap_t
  use krylov, only : ksp_t, krylov_solver_factory, ksp_max_iter, ksp_monitor_t
  use coefs, only : coef_t
  use bc_list, only : bc_list_t
  use bc, only : bc_t
  use precon, only : pc_t, precon_factory
  use mesh, only : mesh_t
  use time_scheme_controller, only : time_scheme_controller_t
  use logger, only : neko_log, log_size, neko_log_verbose
  use registry, only : neko_registry
  use json_utils, only : json_get, json_get_or_default, json_get_or_lookup, &
       json_get_or_lookup_or_default
  use json_module, only : json_file
  use user_intf, only : user_t, dummy_user_material_properties, &
       user_material_properties_intf
  use utils, only : neko_error, neko_typename_len
  use scalar_source_term, only : scalar_source_term_t
  use field_series, only : field_series_t
  use field_math, only : field_cmult2, field_col3, field_cfill, field_add3, &
       field_copy, field_col2
  use neko_config, only : neko_bcknd_device
  use time_step_controller, only : time_step_controller_t
  use scratch_registry, only : neko_scratch_registry
  use time_state, only : time_state_t
  use device, only : device_memcpy, device_to_host
  use scalar_ic, only : set_scalar_ic
  use spectral_vanishing_viscosity, only : svv_t
  implicit none
 
  type, abstract :: scalar_scheme_t
     character(len=:), allocatable :: name
     type(field_t), pointer :: u
     type(field_t), pointer :: v
     type(field_t), pointer :: w
     type(field_t), pointer :: s
     type(field_series_t) :: slag
     type(space_t), pointer :: xh
     type(dofmap_t), pointer :: dm_xh
     type(gs_t), pointer :: gs_xh
     type(coef_t), pointer :: c_xh
     type(field_t), pointer :: f_xh => null()
     type(scalar_source_term_t) :: source_term
     class(ksp_t), allocatable :: ksp
     integer :: ksp_maxiter
     integer :: projection_dim
     
     integer :: projection_activ_step
     class(pc_t), allocatable :: pc
     type(bc_list_t) :: bcs
     type(json_file), pointer :: params => null()
     type(mesh_t), pointer :: msh => null()
     type(chkp_t), pointer :: chkp => null()
     character(len=:), allocatable :: nut_field_name
     character(len=:), allocatable :: alphat_field_name
     type(field_t), pointer :: rho => null()
     type(field_t), pointer :: lambda => null()
     type(field_t), pointer :: cp => null()
     type(field_t), pointer :: lambda_tot => null()
     real(kind=rp) :: pr_turb
     type(field_list_t) :: material_properties
     procedure(user_material_properties_intf), nopass, pointer :: &
          user_material_properties => null()
     logical :: freeze = .false.
     logical :: svv_enabled = .false.
     type(svv_t), allocatable :: svv
   contains
     procedure, pass(this) :: scheme_init => scalar_scheme_init
     procedure, pass(this) :: scheme_free => scalar_scheme_free
     procedure, pass(this) :: validate => scalar_scheme_validate
     procedure, pass(this) :: set_initial_condition => &
          scalar_scheme_set_initial_condition
     procedure, pass(this) :: register_checkpoint => &
          scalar_scheme_register_checkpoint
     procedure, pass(this) :: set_material_properties => &
          scalar_scheme_set_material_properties
     procedure, pass(this) :: update_material_properties => &
          scalar_scheme_update_material_properties
     procedure(scalar_scheme_init_intrf), pass(this), deferred :: init
     procedure(scalar_scheme_free_intrf), pass(this), deferred :: free
     procedure(scalar_scheme_step_intrf), pass(this), deferred :: step
     procedure(scalar_scheme_restart_intrf), pass(this), deferred :: restart
  end type scalar_scheme_t
 
  abstract interface
     subroutine scalar_scheme_init_intrf(this, msh, coef, gs, params, &
          numerics_params, user, chkp, ulag, vlag, wlag, time_scheme, rho)
       import scalar_scheme_t
       import json_file
       import coef_t
       import gs_t
       import mesh_t
       import user_t
       import field_series_t, field_t
       import time_scheme_controller_t
       import rp
       import chkp_t
       class(scalar_scheme_t), target, intent(inout) :: this
       type(mesh_t), target, intent(in) :: msh
       type(coef_t), target, intent(in) :: coef
       type(gs_t), target, intent(inout) :: gs
       type(json_file), target, intent(inout) :: params
       type(json_file), target, intent(inout) :: numerics_params
       type(user_t), target, intent(in) :: user
       type(chkp_t), target, intent(inout) :: chkp
       type(field_series_t), target, intent(in) :: ulag, vlag, wlag
       type(time_scheme_controller_t), target, intent(in) :: time_scheme
       type(field_t), target, intent(in) :: rho
     end subroutine scalar_scheme_init_intrf
  end interface
 
  abstract interface
     subroutine scalar_scheme_restart_intrf(this, chkp)
       import scalar_scheme_t
       import chkp_t
       import rp
       class(scalar_scheme_t), target, intent(inout) :: this
       type(chkp_t), intent(inout) :: chkp
     end subroutine scalar_scheme_restart_intrf
  end interface
 
  abstract interface
     subroutine scalar_scheme_free_intrf(this)
       import scalar_scheme_t
       class(scalar_scheme_t), intent(inout) :: this
     end subroutine scalar_scheme_free_intrf
  end interface
 
  abstract interface
     subroutine scalar_scheme_step_intrf(this, time, ext_bdf, dt_controller, &
          ksp_results)
       import scalar_scheme_t
       import time_state_t
       import time_scheme_controller_t
       import time_step_controller_t
       import ksp_monitor_t
       class(scalar_scheme_t), intent(inout) :: this
       type(time_state_t), intent(in) :: time
       type(time_scheme_controller_t), intent(in) :: ext_bdf
       type(time_step_controller_t), intent(in) :: dt_controller
       type(ksp_monitor_t), intent(inout) :: ksp_results
     end subroutine scalar_scheme_step_intrf
  end interface
 
  ! ========================================================================== !
  ! Helper functions and types for scalar_scheme_t
  ! ========================================================================== !
 
  type, public :: scalar_scheme_wrapper_t
     class(scalar_scheme_t), allocatable :: scalar
   contains
     procedure, pass(this) :: init => scalar_scheme_wrapper_init
     procedure, pass(this) :: free => scalar_scheme_wrapper_free
     procedure, pass(this) :: move_from => &
          scalar_scheme_wrapper_move_from
     procedure, pass(this) :: is_allocated => &
          scalar_scheme_wrapper_is_allocated
  end type scalar_scheme_wrapper_t
 
 
  interface
 
     module subroutine scalar_scheme_factory(object, msh, coef, gs, params, &
          numerics_params, user, chkp, ulag, vlag, wlag, time_scheme, rho)
       class(scalar_scheme_t), allocatable, intent(inout) :: object
       type(mesh_t), target, intent(in) :: msh
       type(coef_t), target, intent(in) :: coef
       type(gs_t), target, intent(inout) :: gs
       type(json_file), target, intent(inout) :: params
       type(json_file), target, intent(inout) :: numerics_params
       type(user_t), target, intent(in) :: user
       type(chkp_t), target, intent(inout) :: chkp
       type(field_series_t), target, intent(in) :: ulag, vlag, wlag
       type(time_scheme_controller_t), target, intent(in) :: time_scheme
       type(field_t), target, intent(in) :: rho
     end subroutine scalar_scheme_factory
  end interface
 
  interface
 
     module subroutine scalar_scheme_allocator(object, type_name)
       class(scalar_scheme_t), allocatable, intent(inout) :: object
       character(len=*), intent(in):: type_name
     end subroutine scalar_scheme_allocator
  end interface
 
  !
  ! Machinery for injecting user-defined types
  !
 
  abstract interface
     subroutine scalar_scheme_allocate(obj)
       import scalar_scheme_t
       class(scalar_scheme_t), allocatable, intent(inout) :: obj
     end subroutine scalar_scheme_allocate
  end interface
 
  interface
 
     module subroutine register_scalar_scheme(type_name, allocator)
       character(len=*), intent(in) :: type_name
       procedure(scalar_scheme_allocate), pointer, intent(in) :: allocator
     end subroutine register_scalar_scheme
  end interface
 
  ! A name-allocator pair for user-defined types. A helper type to define a
  ! registry of custom allocators.
  type scalar_scheme_allocator_entry
     character(len=NEKO_TYPENAME_LEN) :: type_name
     procedure(scalar_scheme_allocate), pointer, nopass :: allocator
  end type scalar_scheme_allocator_entry
 
  type(scalar_scheme_allocator_entry), allocatable, private :: &
       scalar_scheme_registry(:)
 
  integer, private :: scalar_scheme_registry_size = 0
 
contains
 
  subroutine scalar_scheme_init(this, msh, c_Xh, gs_Xh, params, scheme, user, &
       rho)
    class(scalar_scheme_t), target, intent(inout) :: this
    type(mesh_t), target, intent(in) :: msh
    type(coef_t), target, intent(in) :: c_Xh
    type(gs_t), target, intent(inout) :: gs_Xh
    type(json_file), target, intent(inout) :: params
    character(len=*), intent(in) :: scheme
    type(user_t), target, intent(in) :: user
    type(field_t), target, intent(in) :: rho
    ! IO buffer for log output
    character(len=LOG_SIZE) :: log_buf
    ! Variables for retrieving json parameters
    logical :: logical_val
    real(kind=rp) :: real_val, solver_abstol
    integer :: integer_val, ierr
    character(len=:), allocatable :: solver_type, solver_precon
    type(json_file) :: precon_params
    type(json_file) :: json_subdict
    logical :: nut_dependency
 
    this%u => neko_registry%get_field('u')
    this%v => neko_registry%get_field('v')
    this%w => neko_registry%get_field('w')
    this%rho => rho
 
    ! Assign a name
    ! Note that the keyword is added by `scalars_t`, so there is always a
    ! default.
    call json_get(params, 'name', this%name)
 
    ! Set the freeze flag
    call json_get_or_default(params, 'freeze', this%freeze, .false.)
 
    call neko_log%section('Scalar')
    call json_get(params, 'solver.type', solver_type)
    call json_get(params, 'solver.preconditioner.type', &
         solver_precon)
    call json_get(params, 'solver.preconditioner', precon_params)
    call json_get_or_lookup(params, 'solver.absolute_tolerance', &
         solver_abstol)
 
    call json_get_or_lookup_or_default(params, &
         'solver.projection_space_size', &
         this%projection_dim, 0)
    call json_get_or_lookup_or_default(params, &
         'solver.projection_hold_steps', &
         this%projection_activ_step, 5)
 
 
    write(log_buf, '(A, A)') 'Type       : ', trim(scheme)
    call neko_log%message(log_buf)
    write(log_buf, '(A, A)') 'Name       : ', trim(this%name)
    call neko_log%message(log_buf)
    call neko_log%message('Ksp scalar : ('// trim(solver_type) // &
         ', ' // trim(solver_precon) // ')')
    write(log_buf, '(A,ES13.6)') ' `-abs tol :', solver_abstol
    call neko_log%message(log_buf)
 
    this%Xh => this%u%Xh
    this%dm_Xh => this%u%dof
    if (associated(this%params)) then
       deallocate(this%params)
    end if
    allocate(this%params)
    this%params = params
    this%msh => msh
 
    call neko_registry%add_field(this%dm_Xh, this%name, &
         ignore_existing = .true.)
 
    this%s => neko_registry%get_field(this%name)
 
    call this%slag%init(this%s, 2)
 
    this%gs_Xh => gs_xh
    this%c_Xh => c_xh
 
    !
    ! Material properties
    !
    call this%set_material_properties(params, user)
 
    !
    ! Spectral vanishing viscosity
    !
    if (params%valid_path('svv')) then
       call json_get_or_default(params, 'svv.enabled', this%svv_enabled, &
            .false.)
       if (this%svv_enabled) then
          allocate(this%svv)
          call this%svv%init(params, this%c_Xh, this%rho)
       end if
    end if
 
 
    !
    ! Turbulence modelling
    !
    this%alphat_field_name = ""
    this%nut_field_name = ""
    if (params%valid_path('alphat')) then
       call json_get(this%params, 'alphat', json_subdict)
       call json_get(json_subdict, 'nut_dependency', nut_dependency)
       if (nut_dependency) then
          call json_get_or_lookup(json_subdict, 'Pr_t', this%pr_turb)
          call json_get(json_subdict, 'nut_field', this%nut_field_name)
       else
          call json_get(json_subdict, 'alphat_field', this%alphat_field_name)
       end if
    end if
 
    !
    ! Setup right-hand side field.
    !
    allocate(this%f_Xh)
    call this%f_Xh%init(this%dm_Xh, fld_name = "scalar_rhs")
 
    ! Initialize the source term
    call this%source_term%init(this%f_Xh, this%c_Xh, user, this%name)
    call this%source_term%add(params, 'source_terms')
 
    ! todo parameter file ksp tol should be added
    call json_get_or_lookup_or_default(params, &
         'solver.max_iterations', &
         integer_val, ksp_max_iter)
    call json_get_or_default(params, &
         'solver.monitor', &
         logical_val, .false.)
    call scalar_scheme_solver_factory(this%ksp, this%dm_Xh%size(), &
         solver_type, integer_val, solver_abstol, logical_val)
    call scalar_scheme_precon_factory(this%pc, this%ksp, &
         this%c_Xh, this%bcs, &
         solver_precon, precon_params)
 
    call neko_log%end_section()
 
  end subroutine scalar_scheme_init
 
  subroutine scalar_scheme_set_initial_condition(this, user, scalar_index)
    class(scalar_scheme_t), intent(inout) :: this
    type(user_t), intent(in) :: user
    integer, intent(in) :: scalar_index
    character(len=:), allocatable :: ic_type
    type(json_file) :: ic_params
 
    call json_get(this%params, 'initial_condition.type', ic_type)
    call json_get(this%params, 'initial_condition', ic_params)
 
    if (trim(ic_type) .ne. 'user') then
       call set_scalar_ic(this%s, this%c_Xh, this%gs_Xh, ic_type, &
            ic_params, scalar_index)
    else
       call set_scalar_ic(this%name, this%s, this%c_Xh, this%gs_Xh, &
            user%initial_conditions)
    end if
 
    call ic_params%destroy()
    deallocate(ic_type)
 
  end subroutine scalar_scheme_set_initial_condition
 
  subroutine scalar_scheme_register_checkpoint(this, chkp)
    class(scalar_scheme_t), target, intent(inout) :: this
    type(chkp_t), intent(inout) :: chkp
    type(checkpoint_payload_t), pointer :: payload
 
    payload => chkp%add_payload("scalars/" // trim(this%name))
    call payload%add_field(this%s)
    call payload%add_series(this%slag)
 
  end subroutine scalar_scheme_register_checkpoint
 
 
  subroutine scalar_scheme_free(this)
    class(scalar_scheme_t), intent(inout) :: this
    class(bc_t), pointer :: bc
    integer :: i
 
    bc => null()
 
    if (allocated(this%svv)) then
       call this%svv%free()
       deallocate(this%svv)
    end if
    this%svv_enabled = .false.
 
    nullify(this%Xh)
    nullify(this%dm_Xh)
    nullify(this%gs_Xh)
    nullify(this%c_Xh)
    if (associated(this%params)) then
       deallocate(this%params)
       nullify(this%params)
    end if
 
    if (allocated(this%ksp)) then
       call this%ksp%free()
       deallocate(this%ksp)
    end if
 
    if (allocated(this%pc)) then
       call this%pc%free()
       deallocate(this%pc)
    end if
 
    if (allocated(this%name)) then
       deallocate(this%name)
    end if
 
    call this%source_term%free()
 
    if (associated(this%f_Xh)) then
       call this%f_Xh%free()
       deallocate(this%f_Xh)
    end if
 
    do i = 1, this%bcs%size()
       bc => this%bcs%get(i)
       if (associated(bc)) then
          call bc%free()
          deallocate(bc)
       end if
    end do
 
    call this%bcs%free()
    call this%slag%free()
    call this%material_properties%free()
 
    if (allocated(this%nut_field_name)) then
       deallocate(this%nut_field_name)
    end if
 
    if (allocated(this%alphat_field_name)) then
       deallocate(this%alphat_field_name)
    end if
 
    nullify(this%cp)
    nullify(this%lambda)
    nullify(this%lambda_tot)
    nullify(bc)
 
  end subroutine scalar_scheme_free
 
  subroutine scalar_scheme_validate(this)
    class(scalar_scheme_t), target, intent(inout) :: this
 
    if ( (.not. allocated(this%u%x)) .or. &
         (.not. allocated(this%v%x)) .or. &
         (.not. allocated(this%w%x)) .or. &
         (.not. allocated(this%s%x))) then
       call neko_error('Fields are not allocated')
    end if
 
    if (.not. allocated(this%ksp)) then
       call neko_error('No Krylov solver for velocity defined')
    end if
 
    if (.not. associated(this%Xh)) then
       call neko_error('No function space defined')
    end if
 
    if (.not. associated(this%dm_Xh)) then
       call neko_error('No dofmap defined')
    end if
 
    if (.not. associated(this%c_Xh)) then
       call neko_error('No coefficients defined')
    end if
 
    if (.not. associated(this%f_Xh)) then
       call neko_error('No rhs allocated')
    end if
 
    if (.not. associated(this%params)) then
       call neko_error('No parameters defined')
    end if
 
    if (.not. associated(this%rho)) then
       call neko_error('No density field defined')
    end if
 
  end subroutine scalar_scheme_validate
 
  subroutine scalar_scheme_solver_factory(ksp, n, solver, max_iter, &
       abstol, monitor)
    class(ksp_t), allocatable, target, intent(inout) :: ksp
    integer, intent(in), value :: n
    integer, intent(in) :: max_iter
    character(len=*), intent(in) :: solver
    real(kind=rp) :: abstol
    logical, intent(in) :: monitor
 
    call krylov_solver_factory(ksp, n, solver, max_iter, &
         abstol, monitor = monitor)
 
  end subroutine scalar_scheme_solver_factory
 
  subroutine scalar_scheme_precon_factory(pc, ksp, coef, bclst, &
       pctype, json)
    class(pc_t), allocatable, target, intent(inout) :: pc
    class(ksp_t), target, intent(inout) :: ksp
    type(coef_t), target, intent(in) :: coef
    type(bc_list_t), target, intent(inout) :: bclst
    character(len=*) :: pctype
    type(json_file), intent(inout) :: json
 
    call precon_factory(pc, pctype, coef, bclst, json)
 
    call ksp%set_pc(pc)
 
  end subroutine scalar_scheme_precon_factory
 
  subroutine scalar_scheme_update_material_properties(this, time)
    class(scalar_scheme_t), intent(inout) :: this
    type(time_state_t), intent(in) :: time
    type(field_t), pointer :: nut, alphat
    integer :: index
    ! Factor to transform nu_t to lambda_t
    type(field_t), pointer :: lambda_factor
 
    call this%user_material_properties(this%name, this%material_properties, &
         time)
 
    ! factor = rho * cp / pr_turb
    if (len_trim(this%nut_field_name) .gt. 0 &
         .and. len_trim(this%alphat_field_name) .eq. 0 ) then
       nut => neko_registry%get_field(this%nut_field_name)
 
       ! lambda_tot = lambda + rho * cp * nut / pr_turb
       call neko_scratch_registry%request_field(lambda_factor, index, .false.)
       call field_cmult2(lambda_factor, nut, 1.0_rp / this%pr_turb)
       call field_col2(lambda_factor, this%cp)
       call field_col2(lambda_factor, this%rho)
       call field_add3(this%lambda_tot, this%lambda, lambda_factor)
       call neko_scratch_registry%relinquish_field(index)
 
    else if (len_trim(this%alphat_field_name) .gt. 0 &
         .and. len_trim(this%nut_field_name) .eq. 0 ) then
       alphat => neko_registry%get_field(this%alphat_field_name)
 
       ! lambda_tot = lambda + rho * cp * alphat
       call neko_scratch_registry%request_field(lambda_factor, index, .false.)
       call field_col3(lambda_factor, this%cp, alphat)
       call field_col2(lambda_factor, this%rho)
       call field_add3(this%lambda_tot, this%lambda, lambda_factor)
       call neko_scratch_registry%relinquish_field(index)
 
    else if (len_trim(this%alphat_field_name) .gt. 0 &
         .and. len_trim(this%nut_field_name) .gt. 0 ) then
       call neko_error("Conflicting definition of eddy diffusivity " // &
            "for the scalar equation")
    end if
 
    ! Since cp is a fields and we use the %x(1,1,1,1) of the
    ! host array data to pass constant  material properties
    ! to some routines, we need to make sure that the host
    ! values are also filled
    if (neko_bcknd_device .eq. 1) then
       call device_memcpy(this%cp%x, this%cp%x_d, this%cp%size(), &
            device_to_host, sync = .false.)
    end if
 
  end subroutine scalar_scheme_update_material_properties
 
  subroutine scalar_scheme_set_material_properties(this, params, user)
    class(scalar_scheme_t), intent(inout) :: this
    type(json_file), intent(inout) :: params
    type(user_t), target, intent(in) :: user
    character(len=LOG_SIZE) :: log_buf
    ! A local pointer that is needed to make Intel happy
    procedure(user_material_properties_intf), pointer :: dummy_mp_ptr
    real(kind=rp) :: const_cp, const_lambda
    ! Dummy time state set to 0
    type(time_state_t) :: time
 
    dummy_mp_ptr => dummy_user_material_properties
 
    ! Fill lambda field with the physical value
 
    call neko_registry%add_field(this%dm_Xh, this%name // "_lambda")
    call neko_registry%add_field(this%dm_Xh, this%name // "_lambda_tot")
    call neko_registry%add_field(this%dm_Xh, this%name // "_cp")
    this%lambda => neko_registry%get_field(this%name // "_lambda")
    this%lambda_tot => neko_registry%get_field(this%name // "_lambda_tot")
    this%cp => neko_registry%get_field(this%name // "_cp")
 
    call this%material_properties%init(2)
    call this%material_properties%assign(1, this%cp)
    call this%material_properties%assign(2, this%lambda)
 
    if (.not. associated(user%material_properties, dummy_mp_ptr)) then
 
       write(log_buf, '(A)') "Material properties must be set in the user " // &
            "file!"
       call neko_log%message(log_buf)
       this%user_material_properties => user%material_properties
 
       call user%material_properties(this%name, this%material_properties, time)
    else
       this%user_material_properties => dummy_user_material_properties
       if (params%valid_path('Pe') .and. &
            (params%valid_path('lambda') .or. &
            params%valid_path('cp'))) then
          call neko_error("To set the material properties for the scalar, " // &
               "either provide Pe OR lambda and cp in the case file.")
          ! Non-dimensional case
       else if (params%valid_path('Pe')) then
          write(log_buf, '(A)') 'Non-dimensional scalar material properties' //&
               ' input.'
          call neko_log%message(log_buf, lvl = neko_log_verbose)
          write(log_buf, '(A)') 'Specific heat capacity will be set to 1, '
          call neko_log%message(log_buf, lvl = neko_log_verbose)
          write(log_buf, '(A)') 'conductivity to 1/Pe. Assumes density is 1.'
          call neko_log%message(log_buf, lvl = neko_log_verbose)
 
          ! Read Pe into lambda for further manipulation.
          call json_get_or_lookup(params, 'Pe', const_lambda)
          write(log_buf, '(A,ES13.6)') 'Pe         :', const_lambda
          call neko_log%message(log_buf)
 
          ! Set cp and rho to 1 since the setup is non-dimensional.
          const_cp = 1.0_rp
          ! Invert the Pe to get conductivity
          const_lambda = 1.0_rp/const_lambda
          ! Dimensional case
       else
          call json_get_or_lookup(params, 'lambda', const_lambda)
          call json_get_or_lookup(params, 'cp', const_cp)
       end if
    end if
    ! We need to fill the fields based on the parsed const values
    ! if the user routine is not used.
    if (associated(user%material_properties, dummy_mp_ptr)) then
       ! Fill mu and rho field with the physical value
       call field_cfill(this%lambda, const_lambda)
       call field_cfill(this%cp, const_cp)
 
       write(log_buf, '(A,ES13.6)') 'lambda     :', const_lambda
       call neko_log%message(log_buf)
       write(log_buf, '(A,ES13.6)') 'cp         :', const_cp
       call neko_log%message(log_buf)
    end if
 
    ! Copy over material property to the total one
    call field_copy(this%lambda_tot, this%lambda)
 
    ! Since cp is a field and we use the %x(1,1,1,1) of the
    ! host array data to pass constant material properties
    ! to some routines, we need to make sure that the host
    ! values are also filled
    if (neko_bcknd_device .eq. 1) then
       call device_memcpy(this%cp%x, this%cp%x_d, this%cp%size(), &
            device_to_host, sync = .false.)
    end if
  end subroutine scalar_scheme_set_material_properties
 
  ! ========================================================================== !
  ! Scalar scheme wrapper type methods
 
  subroutine scalar_scheme_wrapper_init(this, msh, coef, gs, params, &
       numerics_params, user, chkp, ulag, vlag, wlag, time_scheme, rho)
    class(scalar_scheme_wrapper_t), intent(inout) :: this
    type(mesh_t), target, intent(in) :: msh
    type(coef_t), target, intent(in) :: coef
    type(gs_t), target, intent(inout) :: gs
    type(json_file), target, intent(inout) :: params
    type(json_file), target, intent(inout) :: numerics_params
    type(user_t), target, intent(in) :: user
    type(chkp_t), target, intent(inout) :: chkp
    type(field_series_t), target, intent(in) :: ulag, vlag, wlag
    type(time_scheme_controller_t), target, intent(in) :: time_scheme
    type(field_t), target, intent(in) :: rho
 
    call this%free()
    call scalar_scheme_factory(this%scalar, msh, coef, gs, params, &
         numerics_params, user, chkp, ulag, vlag, wlag, time_scheme, rho)
 
  end subroutine scalar_scheme_wrapper_init
 
  subroutine scalar_scheme_wrapper_free(this)
    class(scalar_scheme_wrapper_t), intent(inout) :: this
 
    if (allocated(this%scalar)) then
       call this%scalar%free()
       deallocate(this%scalar)
    end if
 
  end subroutine scalar_scheme_wrapper_free
 
  subroutine scalar_scheme_wrapper_move_from(this, other)
    class(scalar_scheme_wrapper_t), intent(inout) :: this
    class(scalar_scheme_wrapper_t), intent(inout) :: other
 
    ! Move the pointer
    call move_alloc(other%scalar, this%scalar)
 
  end subroutine scalar_scheme_wrapper_move_from
 
  function scalar_scheme_wrapper_is_allocated(this) result(is_alloc)
    class(scalar_scheme_wrapper_t), intent(in) :: this
    logical :: is_alloc
    is_alloc = allocated(this%scalar)
  end function scalar_scheme_wrapper_is_allocated
 
end module scalar_scheme