FaceVector.F90

Go to the documentation of this file.

! *********************************************************************
! * Rocstar Simulation Suite                                          *
! * Copyright@2015, Illinois Rocstar LLC. All rights reserved.        *
! *                                                                   *
! * Illinois Rocstar LLC                                              *
! * Champaign, IL                                                     *
! * www.illinoisrocstar.com                                           *
! * sales@illinoisrocstar.com                                         *
! *                                                                   *
! * License: See LICENSE file in top level of distribution package or *
! * http://opensource.org/licenses/NCSA                               *
! *********************************************************************
! *********************************************************************
! * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,   *
! * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES   *
! * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND          *
! * NONINFRINGEMENT.  IN NO EVENT SHALL THE CONTRIBUTORS OR           *
! * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER       *
! * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,   *
! * Arising FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE    *
! * USE OR OTHER DEALINGS WITH THE SOFTWARE.                          *
! *********************************************************************
!******************************************************************************
!
! Purpose: calculate the face vector of a polygon.
!
! Description: file contains the following subroutines:
!
!  - faceVectorTria = triangle
!  - FaceVectorQuad = quadrilateral
!
! Input: xyzNodes = coordinates (1st index) of the nodes (2nd index) of the
!                   polygon (clockwise ordered).
!
! Output: fVecX, fVecY, fVecZ = x-,y-,z-component of the face vector.
!
! Notes: Gauss formula is used to calculate the face vector. The coordinates
!        should be ordered clockwise (when looking from inside the volume) to
!        obtain an outward facing vector.
!
!******************************************************************************
!
! $Id: FaceVector.F90,v 1.3 2008/12/06 08:44:09 mtcampbe Exp $
!
! Copyright: (c) 2001 by the University of Illinois
!
!******************************************************************************

SUBROUTINE facevectortria( xyzNodes,fVecX,fVecY,fVecZ )

  USE moddatatypes
  IMPLICIT NONE

! ... parameters
  REAL(RFREAL) :: xyznodes(3,3)
  REAL(RFREAL) :: fvecx, fvecy, fvecz

! ... local variables
  REAL(RFREAL) :: dxa,dxb,dya,dyb,dza,dzb

!******************************************************************************

  dxa = xyznodes(1,1) - xyznodes(1,2)
  dya = xyznodes(2,1) - xyznodes(2,2) 
  dza = xyznodes(3,1) - xyznodes(3,2)  
  
  dxb = xyznodes(1,1) - xyznodes(1,3)
  dyb = xyznodes(2,1) - xyznodes(2,3) 
  dzb = xyznodes(3,1) - xyznodes(3,3)
    
  fvecx =  0.5_rfreal*(dya*dzb - dyb*dza)
  fvecy = -0.5_rfreal*(dxa*dzb - dxb*dza)
  fvecz =  0.5_rfreal*(dxa*dyb - dxb*dya)         

END SUBROUTINE facevectortria

! #############################################################################
! #############################################################################

SUBROUTINE facevectorquad( xyzNodes,fVecX,fVecY,fVecZ )

  USE moddatatypes
  IMPLICIT NONE

! ... parameters
  REAL(RFREAL) :: xyznodes(3,4)
  REAL(RFREAL) :: fvecx, fvecy, fvecz

! ... local variables
  REAL(RFREAL) :: dxa, dya, dza, dxb, dyb, dzb

!******************************************************************************

  dxa = xyznodes(1,3) - xyznodes(1,1)
  dya = xyznodes(2,3) - xyznodes(2,1)
  dza = xyznodes(3,3) - xyznodes(3,1)

  dxb = xyznodes(1,2) - xyznodes(1,4)
  dyb = xyznodes(2,2) - xyznodes(2,4)
  dzb = xyznodes(3,2) - xyznodes(3,4)

  fvecx = 0.5_rfreal*(dza*dyb-dya*dzb)
  fvecy = 0.5_rfreal*(dxa*dzb-dza*dxb)
  fvecz = 0.5_rfreal*(dya*dxb-dxa*dyb)

END SUBROUTINE facevectorquad

!******************************************************************************
!
! RCS Revision history:
!
! $Log: FaceVector.F90,v $
! Revision 1.3  2008/12/06 08:44:09  mtcampbe
! Updated license.
!
! Revision 1.2  2008/11/19 22:17:22  mtcampbe
! Added Illinois Open Source License/Copyright
!
! Revision 1.1  2004/12/01 16:48:34  haselbac
! Initial revision after changing case
!
! Revision 1.2  2003/03/27 14:28:47  haselbac
! Substantially simplified faceVectorTria
!
! Revision 1.1  2002/01/08 22:09:16  jblazek
! Added calculation of face vectors and volumes.
!
!******************************************************************************