!=============================================================================== ! User source terms definition. ! ! 1) Momentum equation (coupled solver) ! 2) Species transport ! 3) Turbulence (k-epsilon, k-omega, Rij-epsilon, v2-f, Spalart-Allmaras) !=============================================================================== !------------------------------------------------------------------------------- ! Code_Saturne version 6.0-beta ! -------------------------- ! This file is part of Code_Saturne, a general-purpose CFD tool. ! ! Copyright (C) 1998-2019 EDF S.A. ! ! This program is free software; you can redistribute it and/or modify it under ! the terms of the GNU General Public License as published by the Free Software ! Foundation; either version 2 of the License, or (at your option) any later ! version. ! ! This program is distributed in the hope that it will be useful, but WITHOUT ! ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS ! FOR A PARTICULAR PURPOSE. See the GNU General Public License for more ! details. ! ! You should have received a copy of the GNU General Public License along with ! this program; if not, write to the Free Software Foundation, Inc., 51 Franklin ! Street, Fifth Floor, Boston, MA 02110-1301, USA. !------------------------------------------------------------------------------- !=============================================================================== ! Purpose: ! ------- !> \file cs_user_source_terms.f90 !> !> \brief Additional right-hand side source terms !> !> See \subpage cs_user_source_terms and \subpage cs_user_source_terms-scalar_in_a_channel !> for examples. !> !> \brief Additional right-hand side source terms for velocity components equation !> (Navier-Stokes) !> !> \section ustsnv_use Usage !> !> The additional source term is decomposed into an explicit part (\c crvexp) and !> an implicit part (\c crvimp) that must be provided here. !> The resulting equation solved by the code for a velocity is: !> \f[ !> \rho \norm{\vol{\celli}} \DP{\vect{u}} + .... !> = \tens{crvimp} \cdot \vect{u} + \vect{crvexp} !> \f] !> !> Note that \c crvexp and \c crvimp are defined after the Finite Volume integration !> over the cells, so they include the "volume" term. More precisely: !> - crvexp is expressed in kg.m/s2 !> - crvimp is expressed in kg/s !> !> The \c crvexp and \c crvimp arrays are already initialized to 0 !> before entering the !> the routine. It is not needed to do it in the routine (waste of CPU time). !> !> \remark The additional force on \f$ x_i \f$ direction is given by !> \c crvexp(i, iel) + vel(j, iel)* crvimp(j, i). !> !> For stability reasons, Code_Saturne will not add -crvimp directly to the !> diagonal of the matrix, but Max(-crvimp,0). This way, the crvimp term is !> treated implicitely only if it strengthens the diagonal of the matrix. !> However, when using the second-order in time scheme, this limitation cannot !> be done anymore and -crvimp is added directly. The user should therefore test !> the negativity of crvimp by himself. !> !> When using the second-order in time scheme, one should supply: !> - crvexp at time n !> - crvimp at time n+1/2 !> !> The selection of cells where to apply the source terms is based on a !> \ref getcel command. For more info on the syntax of the \ref getcel command, !> refer to the user manual or to the comments on the similar command !> \ref getfbr in the routine \ref cs_user_boundary_conditions. ! !------------------------------------------------------------------------------- !------------------------------------------------------------------------------- ! Arguments !______________________________________________________________________________. ! mode name role ! !______________________________________________________________________________! !> \param[in] nvar total number of variables !> \param[in] nscal total number of scalars !> \param[in] ncepdp number of cells with head loss terms !> \param[in] ncesmp number of cells with mass source terms !> \param[in] ivar index number of the current variable !> \param[in] icepdc index number of cells with head loss terms !> \param[in] icetsm index number of cells with mass source terms !> \param[in] itypsm type of mass source term for each variable !> (see \ref cs_user_mass_source_terms) !> \param[in] dt time step (per cell) !> \param[in] ckupdc head loss coefficient !> \param[in] smacel value associated to each variable in the mass !> source terms or mass rate (see !> \ref cs_user_mass_source_terms) !> \param[out] crvexp explicit part of the source term !> \param[out] crvimp implicit part of the source term !_______________________________________________________________________________ subroutine ustsnv & ( nvar , nscal , ncepdp , ncesmp , & ivar , & icepdc , icetsm , itypsm , & dt , & ckupdc , smacel , & crvexp , crvimp ) !=============================================================================== !=============================================================================== ! Module files !=============================================================================== use paramx use numvar use entsor use optcal use cstphy use parall use period use mesh use field use cs_c_bindings !=============================================================================== implicit none !< [arg_1] ! Arguments integer nvar , nscal integer ncepdp , ncesmp integer ivar integer icepdc(ncepdp) integer icetsm(ncesmp), itypsm(ncesmp,nvar) double precision dt(ncelet) double precision ckupdc(6,ncepdp), smacel(ncesmp,nvar) double precision crvexp(3,ncelet), crvimp(3,3,ncelet) !< [arg_1] !< [loc_var_dec_1] ! Local variables character*80 chaine integer iel , nlelt double precision ckp, qdm, beta, srcvel, tau, velx integer, allocatable, dimension(:) :: lstelt double precision, dimension(:,:), pointer :: cvar_vel double precision, dimension(:), pointer :: cpro_rom type(var_cal_opt) :: vcopt !< [loc_var_dec_1] !=============================================================================== ! 1. Initialization !=============================================================================== !< [allocate_1] ! Allocate a temporary array for cells selection allocate(lstelt(ncel)) call getcel('Source_cells', nlelt, lstelt) ! --- Get variable calculation options call field_get_key_struct_var_cal_opt(ivarfl(ivar), vcopt) if (vcopt%iwarni.ge.1) then call field_get_label(ivarfl(ivar), chaine) write(nfecra,1000) chaine(1:8) endif ! --- Get density values and store it in cpro_rom call field_get_val_s(icrom, cpro_rom) !< [allocate_1] !< [remaining_1] srcvel = 8.d0 tau = 1.d0 do iel = 1, nlelt call field_get_val_v(ivarfl(iu), cvar_vel) velx = cvar_vel(1, iel) crvexp(1, iel) = cell_f_vol(iel) * cpro_rom(iel) * (srcvel - velx) / tau crvexp(2, iel) = 0 crvexp(3, iel) = 0 crvimp(1, 1, iel) = - cpro_rom(iel) / tau enddo !< [remaining_1] !-------- ! Formats !-------- !< [format_1] 1000 format(' User source termes for variable ',A8,/) !< [format_1] !---- ! End !---- !< [deallocate_1] ! Deallocate the temporary array deallocate(lstelt) !< [deallocate_1] return end subroutine ustsnv