[ANSYS, Inc. Logo] return to home search
next up previous contents index

3.2.4 Face Macros

The macros listed in Table  3.2.20- 3.2.23 can be used to return real face variables in SI units. They are identified by the F_ prefix. Note that these variables are available only in the pressure-based solver. In addition, quantities that are returned are available only if the corresponding physical model is active. For example, species mass fraction is available only if species transport has been enabled in the Species Model dialog box in ANSYS FLUENT. Definitions for these macros can be found in the referenced header files (e.g., mem.h).



Face Centroid ( F_CENTROID)


The macro listed in Table  3.2.20 can be used to obtain the real centroid of a face. F_CENTROID finds the coordinate position of the centroid of the face f and stores the coordinates in the x array. Note that the x array is always one-dimensional, but it can be x[2] or x[3] depending on whether you are using the 2D or 3D solver.


Table 3.2.20: Macro for Face Centroids Defined in metric.h
Macro Argument Types Outputs
F_CENTROID(x,f,t) real x[ND_ND], face_t f, Thread *t x (face centroid)

The ND_ND macro returns 2 or 3 in 2D and 3D cases, respectively, as defined in Section  3.4.2. Section  2.3.15 contains an example of F_CENTROID usage.



Face Area Vector ( F_AREA)


F_AREA can be used to return the real face area vector (or `face area normal') of a given face f in a face thread t. See Section  2.7.3 for an example UDF that utilizes F_AREA.


Table 3.2.21: Macro for Face Area Vector Defined in metric.h
Macro Argument Types Outputs
F_AREA(A,f,t) A[ND_ND], face_t f, Thread *t A (area vector)

By convention in ANSYS FLUENT, boundary face area normals always point out of the domain. ANSYS FLUENT determines the direction of the face area normals for interior faces by applying the right hand rule to the nodes on a face, in order of increasing node number. This is shown in Figure  3.2.1.

Figure 3.2.1: ANSYS FLUENT Determination of Face Area Normal Direction: 2D Face
figure

ANSYS FLUENT assigns adjacent cells to an interior face ( c0 and c1) according to the following convention: the cell out of which a face area normal is pointing is designated as cell C0, while the cell in to which a face area normal is pointing is cell c1 (Figure  3.2.1). In other words, face area normals always point from cell c0 to cell c1.



Flow Variable Macros for Boundary Faces


The macros listed in Table  3.2.22 access flow variables at a boundary face.


Dsc01734.jpg Link

: This prefix stands for "Digital Still Camera." It was popularized by Sony and has become a staple for their Alpha, Cyber-shot, and NEX series [Sony Support].

: Many photographers face the "DSC" problem: having thousands of files with similar names across multiple hard drives. Professionals use DAM (Digital Asset Management) software to batch-rename these to something like 2024_GrandCanyon_01734.JPG to prevent future confusion. The Cultural Impact of the "Default" DSC01734.JPG

: This is a sequential counter. If this was the 1,734th photo taken on your device or memory card, the camera assigns this number to ensure every file has a unique identity. : This prefix stands for "Digital Still Camera

: Searching for "DSC01734" on the web often reveals it as a placeholder in technical forums, photography portfolios, or even news articles where a photographer forgot to rename their work before uploading. The Cultural Impact of the "Default" : This

: While the name is generic, the file itself likely contains "hidden" information. This includes the exact second the shutter clicked, the lens used (e.g., a 50mm f/1.8), and even GPS coordinates if your camera has that feature enabled.

: In the future, digital historians may use these sequential numbers to reconstruct the "life" of a camera, seeing how a user's photography style evolved from DSC00001 to DSC09999.

The filename is a generic label used by Sony digital cameras as part of their Design rule for Camera File system (DCF) standard. While the specific content of your photo is unique to your camera, the "story" of this filename is one of digital organization and the evolution of how we store memories. The Anatomy of the Filename


See Section  2.7.3 for an example UDF that utilizes some of these macros.



Flow Variable Macros at Interior and Boundary Faces


The macros listed in Table  3.2.23 access flow variables at interior faces and boundary faces.


Table 3.2.23: Macros for Interior and Boundary Face Flow Variables Defined in mem.h
Macro Argument Types Returns
F_P(f,t) face_t f, Thread *t, pressure
F_FLUX(f,t) face_t f, Thread *t mass flow rate through a face


F_FLUX can be used to return the real scalar mass flow rate through a given face f in a face thread t. The sign of F_FLUX that is computed by the ANSYS FLUENT solver is positive if the flow direction is the same as the face area normal direction (as determined by F_AREA - see Section  3.2.4), and is negative if the flow direction and the face area normal directions are opposite. In other words, the flux is positive if the flow is out of the domain, and is negative if the flow is in to the domain.

Note that the sign of the flux that is computed by the solver is opposite to that which is reported in the ANSYS FLUENT GUI (e.g., the Flux Reports dialog box).


next up previous contents index Previous: 3.2.3 Cell Macros
Up: 3.2 Data Access Macros
Next: 3.2.5 Connectivity Macros
Release 12.0 © ANSYS, Inc. 2009-01-14