3.6. Element Loading Routines

3.6.1. epriqr Function (Getting Information About Element Pressure/Convection)

*deck,epriqr
      function epriqr (ielem,iface,key)
c *** primary function: get information about element pressure/convection

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number
c                                      should be zero for key=DB_NUMDEFINED or 
c                                      DB_MAXRECLENG
c        iface    (int,sc,in)       - face number for inquire (0-6)
c                                      face number is needed for key=5. for 
c                                      other values of key, iface has different
c                                      meaning (see below)
c        key      (int,sc,in)       - key as to the information needed
c                 = 1              - return pressure mask for element
c                 = 5              - return number of pressures for this 
c                                      element face
c                 = DB_NUMDEFINED,
c                 = DB_MAXDEFINED  - return value is based on setting of iface
c                                     NOTE: both DB_NUMDEFINED and 
c                                     DB_MAXDEFINED produce the same 
c                                     functionality
c                             iface = 0 - return number of surface loads defined
c                                   = 1-6 - return number of pressure loads 
c                                      defined for this element.  
c                                      NOTE:  only 1-6 is valid, but this 
c                                      routine simply checks that iface is in 
c                                      the range.  The actual value of iface 
c                                      does not matter in this case.
c                 = DB_MAXRECLENG  - return the maximum number of element 
c                                     pressures on any element (max record
c                                     length)

c     output arguments:
c        epriqr   (int,func,out)    - the returned value of epriqr is based on 
c                                      setting of key.

3.6.2. eprget Function (Getting an Element Face Pressure)

*deck,eprget
      function eprget (elem,iface,value)
c *** primary function:    get an element face pressure

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        elem     (int,sc,in)       - element number (negative value for
c                                       no partabeval)
c        iface    (int,sc,in)       - face number (1-68)

c     output arguments:
c        eprget   (int,func,out)    - status of element.
c                                     =-1 - element has no pressures
c                                     = 0 - this element face has no pressures
c                                     > 0 - number of values defined
c        value    (dp ,ar(*),out)   - the element pressures (real,imag) at each
c                                      face


3.6.3. eprput Subroutine (Storing an Element Face Pressure)

*deck,eprput
      subroutine eprput (ielem,iface,nval,value)
c *** primary function:    store an element face pressure.

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number for operation.
c        iface    (int,sc,in)       - face number (1-68)
c        nval     (int,sc,in)       - number of values to put
c        value    (dp ,ar(nval),in) - the element pressures (real,imag) at each
c                                      face

c     output arguments:  none.


3.6.4. eprdel Subroutine (Deleting an Element Pressure/Convection)

*deck,eprdel
      subroutine eprdel (ielem,iface)
c *** primary function:    delete a pressure/convection on an element

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem     (int,sc,in)       - element number
c        iface     (int,sc,in)       - face number
c                                      = 0 - delete all pressures on this 
c                                             element
c                                      = 1-6 - delete pressure on this face

c     output arguments:  none.


3.6.5. ecviqr Function (Getting Information About Element Convections)

*deck,ecviqr
      function ecviqr (ielem,iface,key)
c *** primary function: get information about element convections

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number for inquire
c                                      should be zero for key=DB_NUMDEFINED or 
c                                      DB_MAXRECLENG
c        iface    (int,sc,in)       - face number for inquire (0-6)
c                                      face number is needed for key=5. for 
c                                      other values of key, iface has different
c                                       meaning (see below)
c        key      (int,sc,in)       - key as to the information needed
c                 = 1              - return convection mask for element
c                 = 5              - return number of convections for this 
c                                     element face
c                 = DB_NUMDEFINED,
c                 = DB_MAXDEFINED  - return value is based on setting of iface
c                                     NOTE: both DB_NUMDEFINED and 
c                                     DB_MAXDEFINED produce the same 
c                                     functionality
c                              iface = 0 - return number of surface loads 
c                                           defined (rec length)
c                                    = 1-6 - return number of convection loads 
c                                       defined for this element.  
c                                       NOTE:  only 1-6 is valid, but this 
c                                       routine simply checks that iface is in
c                                       the range.  The actual value of iface 
c                                       does not matter in this case.
c                 = DB_MAXRECLENG  - return the maximum number of convections
c                                     on any element (max rec length)

c     output arguments:
c        ecviqr   (int,func,out)    - the returned value of ecviqr is based on 
c                                      setting of key.

3.6.6. ecvget Function (Getting an Element Face Convection)

*deck,ecvget
       function ecvget (elem,iface,value)
c *** primary function:    get an element face convection (in raw form)

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        elem     (int,sc,in)       - element number
c        iface    (int,sc,in)       - face number (1-6)

c     output arguments:
c        ecvget   (int,func,out)    - status of element.
c                                     =-1 - element has no convections/heat
c                                            fluxes
c                                     = 0 - this element face has no 
c                                            convections/heat fluxes
c                                     > 0 - number of values defined
c        value    (dp ,ar(*),out)   - the element convections

c                                    NOTE: Two values at each node of an 
c                                     element face: if loading is a convection,
c                                     the first first value is the film 
c                                     coefficient and the second value is the 
c                                     bulk temperature. If loading is a heat
c                                     flux, the first value is the heat flux, 
c                                     and the second value is a large number 
c                                     (2**100)

3.6.7. ecvput Subroutine (Storing an Element Face Convection)

*deck,ecvput
      subroutine ecvput (ielem,iface,nval,value)
c *** primary function:    store an element face convection.

c *** Notice - This file contains ANSYS Confidential information ***

c     typ=int,dp,log,chr,dcp   siz=sc,ar(n),func    intent=in,out,inout

c     input arguments:
c     variable (typ,siz,intent)     description
c        ielem    (int,sc,in)       - element number
c        iface    (int,sc,in)       - face number (1-6)
c        nval     (int,sc,in)       - number of values to put
c        value    (dp ,ar(nval),in) - the element convections.
c                                     NOTE: Two values at each node of an 
c                                      element face: if loading is a convection,
c                                      the first first value is the film 
c                                      coefficient and the second value is the 
c                                      bulk temperature. If loading is a heat
c                                      flux, the first value is the heat flux, 
c                                      and the second value is a large number 
c                                      (2**100)
c     output arguments:
c        none.


3.6.8. ecvdel Subroutine (Deleting a Convection on an Element)

*deck,ecvdel
      subroutine ecvdel (ielem,iface)
c *** primary function:    delete a convection on an element

c *** Notice - This file contains ANSYS Confidential information ***

c     typ=int,dp,log,chr,dcp   siz=sc,ar(n),func    intent=in,out,inout

c     input arguments:
c     variable (typ,siz,intent)     description
c        ielem     (int,sc,in)       - element number.
c        iface     (int,sc,in)       - face number
c                                      = 0 - delete all convections on this 
c                                             element
c                                      = 1-6 - delete convections on this face

c     output arguments:
c        none.


3.6.9. etpiqr Function (Getting Information About Element Temperatures)

*deck,etpiqr
      function etpiqr (ielem,key)
c *** primary function: get information about element temperatures.

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number
c                                      Should be 0 for key=11, DB_NUMDEFINED,
c                                      DB_MAXDEFINED, and DB_MAXRECLENG
c        key      (int,sc,in)       - information flag.
c                 = DB_SELECTED    - return status:
c                      etpiqr = 0 - element has no temperatures
c                             = 1 - element has temperatures defined
c                 = DB_NUMDEFINED  - return number of temperatures defined for 
c                                     this element (rec length)
c                 = DB_MAXDEFINED  - return number of temperatures defined in 
c                                     model
c                 = DB_MAXRECLENG  - return maximum number of temperatures 
c                                     defined for any element (max rec length)
c                 = 2 - return length (dp words)
c                 = 3 - return layer number (for cross reference files return
c                             number of entities)
c                 = 4 - return address of first data word
c                 = 5 - return length (dp words)
c                 = 6 - return compressed record number.
c                 = 11 - return void percent (integer)
c                 = 16 - return location of next record (this increments the 
c                             next record count)
c                 = 18 - return type of file.
c                          etpiqr = 0 - integer
c                                 = 1 - double precision
c                                 = 2 - real
c                                 = 3 - complex
c                                 = 4 - character*8
c                                 = 7 - index
c                 = 19 - return virtual type of file.
c                          etpiqr = 0 - fixed length (4.4 form)
c                                 = 1 - indexed variable length
c                                         (layer data)
c                                 = 2 - xref data tables
c                                 = 3 - bitmap data (for 32 data item packed 
c                                         records)
c                                 = 4 - data tables (three dimensional arrays)


c     output arguments:
c        etpiqr   (int,func,out)    - the returned value of etpiqr is based on 
c                                      setting of key.

3.6.10. etpget Function (Getting an Element Temperature)

*deck,etpget
      function etpget (ielem,tem)
c *** primary function:    get element temperatures (in raw form)

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number

c     output arguments:
c        etpget   (int,func,out)    - status of element.
c                                     = 0 - this element has no element 
c                                            temperatures
c                                     > 0 - number of element temperatures 
c                                            retrieved
c        tem     (dp,ar(n,2),out)  - the element temperatures (new,old).

c    NOTE THAT TEM MUST DOUBLE THE NUMBER OF DESIRED 
c    TEMPERATURES IN THE CALLING ROUTINE!

c                                     NOTE: If a value is not defined (i.e., 
c                                           defaults to TUNIF), value will be a
c                                           very small number (2**-100)


3.6.11. etpput Subroutine (Storing an Element Temperature)

*deck,etpput
      subroutine etpput (ielem,n,temp)
c *** primary function:    store element temperatures.

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number
c        n        (int,sc,in)       - number of element temperature values
c        temp     (dp ,ar(n),in)    - element temperatures.

c     output arguments:  none.
c                                     NOTE: If a value is not defined (i.e., 
c                                           defaults to TUNIF), a very small 
c                                           number should be used (2**-100)


3.6.12. etpdel Subroutine (Deleting an Element Temperature)

*deck,etpdel
      subroutine etpdel (ielem)
c *** primary function:    delete element temperatures.

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number

c     output arguments:  none.


3.6.13. ehgiqr Function (Getting Information About Element Heat Generation)

*deck,ehgiqr
      function ehgiqr (ielem,key)
c *** primary function: get information about element heat generations.

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number
c                                      should be 0 for key=11, DB_NUMDEFINED, 
c                                      DB_MAXDEFINED, and DB_MAXRECLENG
c        key      (int,sc,in)       - information flag.
c                 = DB_SELECTED    - return status:
c                      ehgiqr = 0 - heat generation is undefined
c                             = 1 - heat generation is defined
c                 = DB_NUMDEFINED  - return number of defined heat generations 
c                                     in model
c                 = DB_MAXRECLENG  - return maximum number of heat generations 
c                                     on any element (max rec length)
c                 = 2 - return length (dp words)
c                 = 3 - return layer number (for cross reference files return 
c                                      number of entities)
c                 = 4 - return address of first data word
c                 = 5 - return length (record type units)
c                 = 6 - return compressed record number.
c                 = 11 - return void percent (integer)
c                 = 16 - return location of next record (this increments the
c                                      next record count)
c                 = 18 - return type of file.
c                      ehgiqr = 0 - integer
c                             = 1 - double precision
c                             = 2 - real
c                             = 3 - complex
c                             = 4 - character*8
c                             = 7 - index
c                 = 19 - return virtual type of file.
c                      ehgiqr = 0 - fixed length (4.4 form)
c                             = 1 - indexed variable length
c                                              (layer data)
c                             = 2 - xref data tables
c                             = 3 - bitmap data (for 32 data
c                                              item packed records)
c                             = 4 - data tables (three
c                                              dimensional arrays)


c     output arguments:
c        ehgiqr   (int,func,out)    - the returned value of ehgiqr is based on 
c                                      setting of key.


3.6.14. ehgget Function (Getting an Element Heat Generation)

*deck,ehgget
      function ehgget (ielem,qgen)
c *** primary function:    get element heat generations (in raw form)

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number

c     output arguments:
c        ehgget   (int,func,out)    - status of element.
c                                     = 0 - heat generations undefined for this
c                                            element
c                                     > 0 - number of heat generations defined
c        qgen     (dp ,ar(*),out)   - the element heat generations.
c                                     NOTE: If a value is not defined, it will 
c                                           be a very small number (2**-100)


3.6.15. ehgput Subroutine (Storing an Element Heat Generation)

*deck,ehgput
      subroutine ehgput (ielem,n,qgen)
c *** primary function:    store element heat generations

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number
c        n        (int,sc,in)       - number of element heat generation values
c        qgen     (dp ,ar(n),in)    - element heat generations

c     output arguments:  none
c                                     NOTE: If a value is not defined, a very 
c                                        small number should be used (2**-100)


3.6.16. ehgdel Subroutine (Deleting an Element Heat Generation)

*deck,ehgdel
      subroutine ehgdel (ielem)
c *** primary function:    delete element heat generations.

c *** Notice - This file contains ANSYS Confidential information ***

c     typ=int,dp,log,chr,dcp   siz=sc,ar(n),func    intent=in,out,inout

c     input arguments:
c     variable (typ,siz,intent)     description
c        ielem    (int,sc,in)       - element number

c     output arguments:
c        none


3.6.17. efuiqr Function (Getting Information About Element Fluences)

*deck,efuiqr
      function efuiqr (ielem,key)
c *** primary function:    get information about element fluences

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number or zero (see below)
c        key      (int,sc,in)       - key as to the information needed
c                 = 1 or DB_MAXRECLENG - return element fluences info
c                         for ielem > 0 - return number of fluences for this 
c                                          element (record length)
c                                   = 0 - return maximum number of fluences
c                                          defined for any element 
c                                          (max rec length)
c                 = DB_NUMDEFINED,
c                 = DB_MAXDEFINED  - return number of defined fluences 
c                                     in model
c                                    NOTE: both DB_NUMDEFINED and DB_MAXDEFINED
c                                          produce the same functionality

c     output arguments:
c        efuiqr   (int,func,out)    - the returned value of efuiqr is based on 
c                                       setting of key


3.6.18. efuget Function (Getting an Element Fluence)

*deck,efuget
      function efuget (ielem,value)
c *** primary function:    get element fluences.

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number

c     output arguments:
c        efuget   (int,func,out)    - status of element.
c                                      = 0 - element has no fluences defined
c                                      > 0 - number of element fluences defined
c        value    (dp,ar(*),out)    -  element fluences.

c                                     NOTE: If a value is not defined, it will 
c                                           be a very small number (2**-100)


3.6.19. efuput Subroutine (Storing an Element Fluence)

*deck,efuput
      subroutine efuput (ielem,n,value)
c *** primary function:    store element fluences

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)        - element number
c        n        (int,sc,in)        - the number of values to store
c        value    (dp,ar(n),in)      - element fluences.

c     output arguments:  none

c                                     NOTE: If a value is not defined, a very 
c                                        small number should be used (2**-100)


3.6.20. efudel Subroutine (Deleting an Element Fluence)

*deck,efudel
      subroutine efudel (ielem)
c *** primary function:    delete element fluences

c *** Notice - This file contains ANSYS Confidential information ***

c     variable (typ,siz,intent)     description
c        ielem    (int,sc,in)       - element number

c     output arguments:  none


3.6.21. edciqr Function (Getting Information About Element Current Densities)

*deck,edciqr
      function edciqr (ielem,key)
c *** primary function:    get information about element current densities

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number or zero (see below)
c        key      (int,sc,in)       - key as to the information needed
c                 = 1 or DB_MAXRECLENG - return element densities info
c                         for ielem > 0 - number of current densities for this
c                                          element (rec length)
c                                   = 0 - maximum number of current densities 
c                                          defined for any element 
c                                          (max rec length)
c                 = DB_NUMDEFINED,
c                 = DB_MAXDEFINED  - return total number of current densities 
c                                      defined in model
c                                    NOTE: both DB_NUMDEFINED and DB_MAXDEFINED
c                                          produce the same functionality

c     output arguments:
c        edciqr   (int,func,out)    - the returned value of edciqr is based on 
c                                       setting of key

3.6.22. edcget Function (Getting Element Current Densities)

*deck,edcget
      function edcget (ielem,value)
c *** primary function:    get element current densities

c *** Notice - This file contains ANSYS Confidential information ***

c     typ=int,dp,log,chr,dcp   siz=sc,ar(n),func    intent=in,out,inout

c        ielem    (int,sc,in)       - element number
c     output arguments:

c                                     = 0 - element has no current densities
c                                            defined
c                                     > 0 - number of element current 
c                                            densities defined
c        value    (dp,ar(*),out)    -  element current densities

c                                     NOTE: If a value is not defined, it will 
c                                           be a very small number (2**-100)

3.6.23. edcput Subroutine (Storing an Element Current Density)

*deck,edcput
      subroutine edcput (ielem,n,value)
c *** primary function:    store element current densities

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)        - element number
c        n        (int,sc,in)        - the number of current densities to store
c        value    (dp,ar(n),in)      - element current densities

c     output arguments:
c        none
c                                     NOTE: If a value is not defined, a very 
c                                        small number should be used (2**-100)

3.6.24. edcdel Subroutine (Deleting an Element Current Density)

*deck,edcdel
      subroutine edcdel (ielem)
c *** primary function:    delete element current densities

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number

c     output arguments:  none


3.6.25. evdiqr Function (Getting Information About Element Virtual Displacements)

*deck,evdiqr
      function evdiqr (ielem,key)
c *** primary function:    get information about element virt disps

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number or zero (see below)
c        key      (int,sc,in)       - key as to the information needed
c                 = 1 or DB_MAXRECLENG - return element virt disps info
c                         for ielem > 0 - number of virt disps defined for this
c                                          element (rec length)
c                                   = 0 - maximum number of virt disps defined 
c                                          for any element (max rec length)
c                 = DB_NUMDEFINED,
c                 = DB_MAXDEFINED  - return total number of virt disps defined 
c                                     in model
c                                    NOTE: both DB_NUMDEFINED and DB_MAXDEFINED
c                                          produce the same functionality

c     output arguments:
c        evdiqr   (int,func,out)    - the returned value of evdiqr is based on 
c                                       setting of key

3.6.26. evdget Function (Getting an Element Virtual Displacement)

*deck,evdget
      function evdget (ielem,value)
c *** primary function:    get element virtual displacements

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number
c
c     output arguments:
c        evdget   (int,func,out)    - status of element.
c                                     = 0 - no virt disps defined for this
c                                            element
c                                     > 0 - number of  element virtual 
c                                            displacements
c        value    (dp,ar(*),out)    -  element virtual displacements
c
c                                     NOTE: If a value is not defined, it will 
c                                           be a very small number (2**-100)

3.6.27. evdput Subroutine (Storing an Element Virtual Displacement)

*deck,evdput
      subroutine evdput (ielem,n,value)
c *** primary function:    store element virtual displacements

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)        - element number
c        n        (int,sc,in)        - the total number of values
c        value    (dp,ar(n),in)      - element virtual displacements

c     output arguments:  none
c                                     NOTE: If a value is not defined, a very 
c                                        small number should be used (2**-100)

3.6.28. eimiqr Function (Getting Information About Element Impedances)

*deck,eimiqr
      function eimiqr (ielem,iface,key)
c *** primary function: get information about element impedences

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number for inquire.
c                                       should be zero for key=DB_NUMDEFINED,
c                                       DB_MAXDEFINED or DB_MAXRECLENG
c        iface    (int,sc,in)       - face number for inquire (0-6)
c                                       face number is needed for key=5. for 
c                                       other values of key, iface has different
c                                       meaning (see below)
c        key      (int,sc,in)       - key as to the information needed
c                 =  1             - return impedence mask for element
c                 =  5             - return number of impedences for this 
c                                      element face
c                 = DB_NUMDEFINED,
c                 = DB_MAXDEFINED  - return value is based on setting of iface
c                                     NOTE: both DB_NUMDEFINED and 
c                                     DB_MAXDEFINED produce the same 
c                                     functionality
c                             iface = 0 - return number of surface loads defined
c                                          in model
c                                   = 1-6 - return number of pressure loads 
c                                       defined for this element. (rec length)
c                                       NOTE:  only 1-6 is valid, but this 
c                                       routine simply checks that iface is in 
c                                       the range.  The actual value of iface 
c                                       does not matter in this case.
c                 = DB_MAXRECLENG  - return the maximum number of element 
c                                     impedences defined for any element 
c                                     (max rec length)

c     output arguments:
c        eimiqr   (int,func,out)    - the returned value of eimiqr is based on 
c                                      setting of key.

3.6.29. eimget Function (Getting an Element Face Impedance)

*deck,eimget
       function eimget (elem,iface,value)
c *** primary function:    get an element face impedance (in raw form)

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        elem     (int,sc,in)       - element number
c        iface    (int,sc,in)       - face number (1-6)

c     output arguments:
c        eimget   (int,func,out)    - status of element.
c                                     =-1 - element has no impedance
c                                     = 0 - this element face has no impedance
c                                     > 0 - number of values defined
c        value    (dp ,ar(*),out)   - the element impedances


3.6.30. eimput Subroutine (Storing an Element Impedance)

*deck,eimput
      subroutine eimput (ielem,iface,nval,value)
c *** primary function:    store an element face impedance.

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number
c        iface    (int,sc,in)       - face number (1-6)
c        nval     (int,sc,in)       - number of values to put
c        value    (dp ,ar(nval),in) - the element impedances (real,imag)

c     output arguments:  none


3.6.31. eimdel Subroutine (Deleting an Element Impedance)

*deck,eimdel
      subroutine eimdel (ielem,iface)
c *** primary function:    delete an impedance on a element

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem     (int,sc,in)       - element number
c        iface     (int,sc,in)       - face number
c                                      = 0 - delete all impedances on this 
c                                             element
c                                      = 1-6 - delete impedance on this face

c     output arguments:  none


3.6.32. esfiqr Function (Getting Information About Element Surface Stress Data)

*deck,esfiqr
      function esfiqr (ielem,key)
c *** primary function:    get information about element surface stress data

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem     (int,sc,in)      - element number (or zero, see below)
c        key     (int,sc,in)        - key as to the information needed
c                 = 1 - return info about surface stress 
c                         ielem > 0 - return number of surface stresses on this
c                                      element (rec length)
c                               = 0 - return maximum number of surface stresses
c                                      on any element (max rec length)
c                 = DB_NUMDEFINED - return the number of surface stresses 
c                                    defined in model

c     output arguments:
c        esfiqr   (int,func,out)    - the returned value of esfiqr is based on 
c                                       setting of key



3.6.33. esfget Function (Getting Element Surface Stress Data)

*deck,esfget
      function esfget (ielem,value)
c *** primary function:    get element surface stress data.

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number

c     output arguments:
c        esfget   (int,func,out)    - status of element.
c                                     = 0 - element undefined
c                                     > 0 - number of values returned
c        value    (dp,ar(*),out)    - element surface stress data.


3.6.34. esfput Subroutine (Storing Element Surface Stress Data)

*deck,esfput
      subroutine esfput (ielem,nval,value)
c *** primary function:    store surface stresses for an element.

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem     (int,sc,in)       - element number
c        nval      (int,sc,in)       - the total number of values
c                                       (19 * number of stress faces)
c                                       There is a max of 2 stress faces
c        value    (dp,ar(nval),in)   - the values

c     output arguments:  none


3.6.35. esfdel Subroutine (Deleting an Element's Surface Stress Data)

*deck,esfdel
      subroutine esfdel (ielem)
c *** primary function:    delete element surface stress data

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number
c                                     = 0 - delete for all defined elements

c     output arguments:  none.


3.6.36. efsdel Subroutine (Deleting a Flagged Surface on an Element)

*deck,efsdel
      subroutine efsdel (ielem,iface)
c *** primary function:    delete a flagged surface on an element

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem     (int,sc,in)       - element number
c        iface     (int,sc,in)       - face number
c                                      = 0 - all flagged surfaces
c                                      = 1-6 - this flagged surface

c     output arguments:  none.


3.6.37. efsget function (Getting Element Face Flagged Surfaces)

*deck,efsget
      function efsget (ielem,iface,value)
c *** primary function:    get element face flagged surfaces

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number
c        iface    (int,sc,in)       - face number (1-6)

c     output arguments:
c        efsget   (int,func,out)    - status of element.
c                                     =-1 - no values for this element
c                                     = 0 - zero flagged surfaces defined
c                                     > 0 - number of values defined
c        value    (dp ,ar(*),out)   - the element flagged surfaces


3.6.38. efsiqr function (Getting Information About Flagged Surfaces)

*deck,efsiqr
      function efsiqr (ielem,iface,key)
c *** primary function: get information about flagged surfaces

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number for inquire.
c                                       should be zero for key=DB_NUMDEFINED,
c                                       DB_MAXDEFINED or DB_MAXRECLENG
c        iface    (int,sc,in)       - face number for inquire (0-6)
c                                       face number is needed for key=5. for 
c                                       other values of key, iface has different
c                                       meaning (see below)
c        key      (int,sc,in)       - key as to the information needed
c                 =  1             - return flagged surfaces mask for element
c                 =  5             - return number of flagged surfaces for this
c                                      element face
c                 = DB_NUMDEFINED,
c                 = DB_MAXDEFINED  - return value is based on setting of iface
c                                     NOTE: both DB_NUMDEFINED and 
c                                     DB_MAXDEFINED produce the same 
c                                     functionality
c                             iface = 0 - return total number of pressures, 
c                                          convections, etc defined in model
c                                   = 1-6 - return number of flagged surfaces
c                                       defined for this element. (rec length)
c                                       NOTE:  only 1-6 is valid, but this 
c                                       routine simply checks that iface is in
c                                       the range.  The actual value of iface
c                                       does not matter in this case.
c                 = DB_MAXRECLENG  - return maximum number of flagged surfaces 
c                                       for any element (max rec length)

c     output arguments:
c        efsiqr   (int,func,out)    - the returned value of efsiqr is based on 
c                                      setting of key.


3.6.39. efsput Subroutine (Storing an Element Face Flagged Surface)

*deck,efsput
      subroutine efsput (ielem,iface,nval,value)
c *** primary function:    store an element face flagged surface.

c *** Notice - This file contains ANSYS Confidential information ***

c     input arguments:
c        ielem    (int,sc,in)       - element number
c        iface    (int,sc,in)       - face number (1-6)
c        nval     (int,sc,in)       - number of values to put
c        value    (dp ,ar(nval),in) - the element flagged surface values

c     output arguments:  none.



Release 18.2 - © ANSYS, Inc. All rights reserved.