butterworth.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/.
!||====================================================================
!||    butterworth      ../engine/source/tools/univ/butterworth.F
!||--- called by ------------------------------------------------------
!||    e_period         ../engine/source/general_controls/damping/static.F
!||    sensor_contact   ../engine/source/tools/sensor/sensor_contact.F
!||    sensor_vel       ../engine/source/tools/sensor/sensor_vel.F
!||====================================================================
      SUBROUTINE butterworth (DT,FREQ,X2,X1,X,FX2,FX1,FX)
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-----------------------------------------------
      my_real, INTENT (IN) :: 
     .   dt,freq,x2,x1,x,fx2,fx1
      my_real, INTENT (OUT) ::
     .   fx
C-----------------------------------------------
C   L o c a l   V a r i a b l e s
C-----------------------------------------------
      my_real
     .   dt2,wd,wa,wa2,a0,a1,a2,b1,b2,c1
C=======================================================================
C    INPUT variables:
C    DT   - actual timestep
C    FREQ - filtering frequency
C    X    - current unfiltered variable
C    X1   - unfiltered variable (timestep -1)
C    X2   - unfiltered variable (timestep -2)
C    FX1  - filtered variable (timestep -1)
C    FX2  - filtered variable (timestep -2)
C-----------------------------------------------------------------------
C    OUTPUT variables:
C    FX - current filtered variable
C=======================================================================
      dt2  = dt / two                           
      wd = sqr2*pi*freq*5.0/3.0  
      wa = sin(wd*dt2) / cos(wd*dt2)                     
      wa2 = wa*wa                                      
      c1 = one + sqr2*wa + wa2                           
      a0 = wa2 / c1                                    
      a1 = two * a0                                   
      a2 = a0                                          
      b1 = -two*(wa2 - one) / c1                       
      b2 = (-one + sqr2*wa - wa2) / c1                   
      fx = a0*x + a1*x1 + a2*x2 + b1*fx1 + b2*fx2           
C---
      RETURN
      END SUBROUTINE butterworth