freupwind.F

Go to the documentation of this file.

Copyright>        OpenRadioss
Copyright>        Copyright (C) 1986-2025 Altair Engineering Inc.
Copyright>
Copyright>        This program is free software: you can redistribute it and/or modify
Copyright>        it under the terms of the GNU Affero General Public License as published by
Copyright>        the Free Software Foundation, either version 3 of the License, or
Copyright>        (at your option) any later version.
Copyright>
Copyright>        This program is distributed in the hope that it will be useful,
Copyright>        but WITHOUT ANY WARRANTY; without even the implied warranty of
Copyright>        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Copyright>        GNU Affero General Public License for more details.
Copyright>
Copyright>        You should have received a copy of the GNU Affero General Public License
Copyright>        along with this program.  If not, see <https://www.gnu.org/licenses/>.
Copyright>
Copyright>
Copyright>        Commercial Alternative: Altair Radioss Software
Copyright>
Copyright>        As an alternative to this open-source version, Altair also offers Altair Radioss
Copyright>        software under a commercial license.  Contact Altair to discuss further if the
Copyright>        commercial version may interest you: https://www.altair.com/radioss/.
!||====================================================================
!||    freupwind     ../engine/source/input/freupwind.F
!||--- called by ------------------------------------------------------
!||    freform       ../engine/source/input/freform.F
!||--- calls      -----------------------------------------------------
!||    ancmsg        ../engine/source/output/message/message.F
!||    arret         ../engine/source/system/arret.F
!||    wriusc2       ../engine/source/input/wriusc2.F
!||--- uses       -----------------------------------------------------
!||    ale_mod       ../common_source/modules/ale/ale_mod.F
!||    message_mod   ../engine/share/message_module/message_mod.F
!||====================================================================
      SUBROUTINE freupwind(IKAD,KEY0,KUPWM)
C-----------------------------------------------
C   M o d u l e s
C-----------------------------------------------
      USE message_mod
      USE ale_mod
C-----------------------------------------------
C   I m p l i c i t   T y p e s
C-----------------------------------------------
#include      "implicit_f.inc"
C-----------------------------------------------
C   D u m m y   A r g u m e n t s
C-----------------------------------------------
      INTEGER IKAD(0:*),KUPWM
      CHARACTER KEY0(*)*5
C-----------------------------------------------
C   C o m m o n   B l o c k s
C-----------------------------------------------
#include      "units_c.inc"
C-----------------------------------------------
C   L o c a l   V a r i a b l e s
C-----------------------------------------------
      INTEGER IKEY
C-----------------------------------------------
C   D e s c r i p t i o n
C-----------------------------------------------
C  This subrouting is reading updated coefficient eta1 eta2 eta3
C  initially defined with starter card /UPWIND or from previous run
C  with engine card /UPWIND
C  Additional details
         ! ALE%UPWIND%UPWSM2 : READ HERE BUT UPDATED IN LECTUR.F FOR ALE PRINTOUT UPWSM=UPWSM2
         ! ALE%UPWIND%UPWMG  : READ HERE BUT UPDATED IN LECTUR.F FOR ALE PRINTOUT PM(15,IMAT)=UPWMG2                                 
         ! ALE%UPWIND%UPWOG  : READ HERE BUT UPDATED IN LECTUR.F FOR ALE PRINTOUT PM(16,IMAT)=UPWOG2
C
         ! ALE%UPWIND%UPW_UPDATE == 1 : ENGINE /UPWIND CARD DETECTED
         ! ALE%UPWIND%UPW_UPDATE == 2 : /UPWIND CARD IS CHANGING AT LEAST ONE PARAMETER
         ! ALE%UPWIND%UPW_UPDATE modified in lectur.F (checking change for 1st and 2nd parameter)
C-----------------------------------------------
      ale%UPWIND%UPW_UPDATE = 0  !now initialized in freform.F because SUPG is default option
      ale%UPWIND%UPWMG2     = 0  !now initialized in freform.F because SUPG is default option
      ale%UPWIND%UPWOG2     = 0
      ale%UPWIND%UPWSM2     = 0
      ikey=kupwm
      IF(ikad(ikey)/=ikad(ikey+1))THEN
       CALL wriusc2(ikad(ikey)+1,1,key0(ikey))
       READ(iusc2,*,err=9990)ale%UPWIND%UPWMG2, ale%UPWIND%UPWOG2, ale%UPWIND%UPWSM2
 
       ale%UPWIND%UPW_UPDATE = 1       
 
       IF(ale%UPWIND%UPWMG2==zero)ale%UPWIND%UPWMG2=one 
       IF(ale%UPWIND%UPWOG2==zero)ale%UPWIND%UPWOG2=one 
       IF(ale%UPWIND%UPWSM2==zero)ale%UPWIND%UPWSM2=one 
 
       !Upwind coefficient for Momentum Advection
       IF(ale%UPWIND%UPWMG2<=zero .OR. ale%UPWIND%UPWMG2>one)THEN
         WRITE(istdo,*)' ** ERROR IN CARD /UPWIND'
         WRITE(istdo,*)'     MOMENTUM COEFFICIENT IS OUT OF BOUNDS [0,1]'
         CALL arret(2)          
       ENDIF
 
       !Upwind coefficient for Mass and Energy Advection
       IF(ale%UPWIND%UPWOG2<zero.OR.ale%UPWIND%UPWOG2>one)THEN
         WRITE(istdo,*)' ** ERROR IN CARD /UPWIND'
         WRITE(istdo,*)'     MASS & ENERGY COEFFICIENT IS OUT OF BOUNDS [0,1]'
         CALL arret(2)          
       ENDIF
       
       !Upwind coefficient for Wet Surface (Mulimaterial specific advection)
       IF(ale%UPWIND%UPWSM2<-one.OR.ale%UPWIND%UPWSM2>one)THEN
         WRITE(istdo,*)' ** ERROR IN CARD /UPWIND'
         WRITE(istdo,*)'     WET SURFACE COEFFICIENT IS OUT OF BOUNDS [-1,1]'          
         CALL arret(2) 
       ENDIF
 
      ENDIF
 
      RETURN
 
 9990 CONTINUE
      CALL ancmsg(msgid=73,anmode=aninfo,c1=key0(ikey))
      CALL arret(0)
      END