variables.h File Reference

Main header file for a complex fluid dynamics solver. More...

#include "petscvec.h"
#include "petscdmda.h"
#include "petscksp.h"
#include "petscsnes.h"
#include "petscdmswarm.h"
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>

Include dependency graph for variables.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	Cmpnts
	A 3D point or vector with PetscScalar components. More...
struct	Cmpnts2
	A 2D point or vector with PetscScalar components. More...
struct	Cpt2D
	A 2D vector of PETSc real numbers (for geometry/coordinates). More...
struct	FlowWave
	Represents a single point in a time-varying flow waveform. More...
struct	BCS
	Boundary condition data used by the BC pipeline and ghost cell machinery. More...
struct	BoundingBox
	Defines a 3D axis-aligned bounding box. More...
struct	Cell
	Defines the vertices of a single hexahedral grid cell. More...
struct	Particle
	Defines a particle's core properties for Lagrangian tracking. More...
struct	RankNeighbors
	Stores the MPI ranks of neighboring subdomains. More...
struct	RankCellInfo
	A lean struct to hold the global cell ownership range for a single MPI rank. More...
struct	MigrationInfo
	Information needed to migrate a single particle between MPI ranks. More...
struct	VerificationDiffusivityConfig
	Verification-only analytical diffusivity override settings. More...
struct	VerificationScalarConfig
	Verification-only analytical scalar override settings. More...
struct	SearchMetricsState
	Aggregated per-timestep search instrumentation counters. More...
struct	BC_Param_s
	A node in a linked list for storing key-value parameters from the bcs.dat file. More...
struct	BCContext
	Provides execution context for a boundary condition handler. More...
struct	BoundaryCondition
	The "virtual table" struct for a boundary condition handler object. More...
struct	BoundaryFaceConfig
	Holds the complete configuration for one of the six boundary faces. More...
struct	IBMInfo
	Holds interpolation and distance information for a single IBM point. More...
struct	IBMNodes
	Represents a collection of nodes forming a surface for the IBM. More...
struct	IBMVNodes
	Represents a collection of nodes forming a volume for the IBM. More...
struct	node
	A generic C-style linked list node for integers. More...
struct	list
	Head of a generic C-style linked list. More...
struct	list_node
	A generic C-style linked list node for indices. More...
struct	IBMListNode
	A linked list node containing IBM interpolation info. More...
struct	IBMList
	Head of a linked list for IBM data. More...
struct	SurfElmtInfo
	Information about a surface element for FSI calculations. More...
struct	FSInfo
	Holds all data related to the state and motion of a body in FSI. More...
struct	Cstart
	Defines prescribed body motion using splines. More...
struct	MGCtx
	Context for Multigrid operations. More...
struct	UserMG
	User-level context for managing the entire multigrid hierarchy. More...
struct	PostProcessParams
	Holds all configuration parameters for a post-processing run. More...
struct	VTKFieldInfo
	Stores all necessary information for a single data array in a VTK file. More...
struct	VTKMetaData
struct	ScalingCtx
struct	SimCtx
	The master context for the entire simulation. More...
struct	UserCtx
	User-defined context containing data specific to a single computational grid level. More...

Macros
#define	COEF_TIME_ACCURACY   1.5
	Coefficient controlling the temporal accuracy scheme (e.g., 1.5 for 2nd Order Backward Difference).
#define	MAX_PIPELINE_LENGTH   1024
#define	MAX_FIELD_LIST_LENGTH   1024
#define	MAX_FILENAME_LENGTH   256
#define	MAX_POINT_DATA_FIELDS   20
	Defines the maximum number of data fields for VTK point data.
#define	MAX_VTK_FIELD_NAME_LENGTH   64
	Maximum length for VTK field names.
#define	mom_dt_rk4_residual_norm_noise_allowance_factor   mom_dt_jameson_residual_norm_noise_allowance_factor

Typedefs
typedef struct SimCtx	SimCtx
	The master context for the entire simulation.
typedef struct UserCtx	UserCtx
	User-defined context containing data specific to a single computational grid level.
typedef struct BC_Param_s	BC_Param
typedef struct BoundaryCondition	BoundaryCondition
	The "virtual table" struct for a boundary condition handler object.
typedef struct BoundaryFaceConfig	BoundaryFaceConfig
	Holds the complete configuration for one of the six boundary faces.
typedef struct IBMNodes	IBMNodes
	Represents a collection of nodes forming a surface for the IBM.
typedef struct IBMVNodes	IBMVNodes
	Represents a collection of nodes forming a volume for the IBM.
typedef struct FSInfo	FSInfo
	Holds all data related to the state and motion of a body in FSI.
typedef struct UserMG	UserMG
	User-level context for managing the entire multigrid hierarchy.
typedef struct BoundingBox	BoundingBox
	Defines a 3D axis-aligned bounding box.
typedef struct Cell	Cell
	Defines the vertices of a single hexahedral grid cell.
typedef struct Particle	Particle
	Defines a particle's core properties for Lagrangian tracking.
typedef struct RankNeighbors	RankNeighbors
	Stores the MPI ranks of neighboring subdomains.
typedef struct RankCellInfo	RankCellInfo
	A lean struct to hold the global cell ownership range for a single MPI rank.
typedef struct MigrationInfo	MigrationInfo
	Information needed to migrate a single particle between MPI ranks.
typedef struct Cstart	Cstart
	Defines prescribed body motion using splines.
typedef struct MGCtx	MGCtx
	Context for Multigrid operations.
typedef struct PostProcessParams	PostProcessParams
	Holds all configuration parameters for a post-processing run.
typedef struct VTKFieldInfo	VTKFieldInfo
	Stores all necessary information for a single data array in a VTK file.
typedef struct VTKMetaData	VTKMetaData
typedef struct IBMInfo	IBMInfo
	Holds interpolation and distance information for a single IBM point.
typedef struct SurfElmtInfo	SurfElmtInfo
	Information about a surface element for FSI calculations.
typedef struct ScalingCtx	ScalingCtx
typedef struct Cmpnts	Cmpnts
	A 3D point or vector with PetscScalar components.
typedef struct Cmpnts2	Cmpnts2
	A 2D point or vector with PetscScalar components.
typedef struct Cpt2D	Cpt2D
	A 2D vector of PETSc real numbers (for geometry/coordinates).
typedef struct FlowWave	FlowWave
	Represents a single point in a time-varying flow waveform.
typedef struct BCS	BCS
	Boundary condition data used by the BC pipeline and ghost cell machinery.
typedef struct VerificationDiffusivityConfig	VerificationDiffusivityConfig
	Verification-only analytical diffusivity override settings.
typedef struct VerificationScalarConfig	VerificationScalarConfig
	Verification-only analytical scalar override settings.
typedef struct SearchMetricsState	SearchMetricsState
	Aggregated per-timestep search instrumentation counters.
typedef struct BCContext	BCContext
	Provides execution context for a boundary condition handler.
typedef struct node	node
	A generic C-style linked list node for integers.
typedef struct list	List
	Head of a generic C-style linked list.
typedef struct list_node	Node_List
	A generic C-style linked list node for indices.
typedef struct IBMListNode	IBMListNode
	A linked list node containing IBM interpolation info.
typedef struct IBMList	IBMList
	Head of a linked list for IBM data.

Enumerations
enum	ParticleLocationStatus {   NEEDS_LOCATION , ACTIVE_AND_LOCATED , MIGRATING_OUT , LOST ,   UNINITIALIZED }
	Defines the state of a particle with respect to its location and migration status during the iterative SettleParticles() process. More...
enum	Face {   LEFT = 0 , RIGHT , BOTTOM , TOP ,   FRONT , BACK , NUM_FACES }
	Enumerates the six faces of a cubic cell for distance calculations. More...
enum	InitialConditionMode {   IC_MODE_ZERO = 0 , IC_MODE_CONSTANT_CARTESIAN = 1 , IC_MODE_POISEUILLE = 2 , IC_MODE_CONSTANT_STREAMWISE = 3 ,   IC_MODE_FILE = 4 }
	Selects the algorithm used to populate a fresh Eulerian velocity field. More...
enum	InitialConditionField { IC_FIELD_UCAT = 0 , IC_FIELD_UCONT = 1 }
	Selects the authoritative velocity representation in a staged file IC. More...
enum	BCFace {   BC_FACE_NEG_X = 0 , BC_FACE_POS_X = 1 , BC_FACE_NEG_Y = 2 , BC_FACE_POS_Y = 3 ,   BC_FACE_NEG_Z = 4 , BC_FACE_POS_Z = 5 }
	Identifies the six logical faces of a structured computational block. More...
enum	FlowDirection {   FLOW_DIR_POS_XI = 0 , FLOW_DIR_NEG_XI = 1 , FLOW_DIR_POS_ETA = 2 , FLOW_DIR_NEG_ETA = 3 ,   FLOW_DIR_POS_ZETA = 4 , FLOW_DIR_NEG_ZETA = 5 , FLOW_DIR_UNSET = -1 }
	Primary flow direction for streamwise IC and Poiseuille modes. More...
enum	BCType {   WALLFUNCTION = -1 , INTERFACE = 0 , WALL = 1 , MOVING_WALL = 2 ,   SYMMETRY = 3 , OUTLET = 4 , INLET = 5 , FARFIELD = 6 ,   PERIODIC = 7 , CHARACTERISTIC_BC = 8 , ANALYTICAL_VORTEX = 9 , JUNCTION = 10 ,   ANNULUS = 11 , OGRID = 12 , RHEOLOGY = 13 }
	Defines the general mathematical/physical Category of a boundary. More...
enum	BCHandlerType {   BC_HANDLER_UNDEFINED = 0 , BC_HANDLER_WALL_NOSLIP = 1 , BC_HANDLER_WALL_MOVING = 2 , BC_HANDLER_SYMMETRY_PLANE = 3 ,   BC_HANDLER_INLET_CONSTANT_VELOCITY = 4 , BC_HANDLER_INLET_PARABOLIC = 5 , BC_HANDLER_INLET_PROFILE_FROM_FILE = 6 , BC_HANDLER_INLET_INTERP_FROM_FILE = 7 ,   BC_HANDLER_INLET_PULSATILE_FLUX = 8 , BC_HANDLER_FARFIELD_NONREFLECTING = 9 , BC_HANDLER_OUTLET_CONSERVATION = 10 , BC_HANDLER_OUTLET_PRESSURE = 11 ,   BC_HANDLER_PERIODIC_GEOMETRIC = 12 , BC_HANDLER_INTERFACE_OVERSET = 13 , BC_HANDLER_PERIODIC_DRIVEN_CONSTANT_FLUX = 14 , BC_HANDLER_PERIODIC_DRIVEN_INITIAL_FLUX = 15 }
	Defines the specific computational "strategy" for a boundary handler. More...
enum	BCPriorityType {   BC_PRIORITY_UNDEFINED = -1 , BC_PRIORITY_INLET = 0 , BC_PRIORITY_FARFIELD = 1 , BC_PRIORITY_WALL = 2 ,   BC_PRIORITY_OUTLET =3 }
enum	LESModelType { NO_LES_MODEL = 0 , CONSTANT_SMAGORINSKY = 1 , DYNAMIC_SMAGORINSKY = 2 }
	Identifies the six logical faces of a structured computational block. More...
enum	MomentumSolverType { MOMENTUM_SOLVER_EXPLICIT_RK = 0 , MOMENTUM_SOLVER_DUALTIME_PICARD_JAMESON_RK = 1 , MOMENTUM_SOLVER_NEWTON_KRYLOV = 2 , MOMENTUM_SOLVER_DUALTIME_PICARD_RK4 = MOMENTUM_SOLVER_DUALTIME_PICARD_JAMESON_RK }
	Enumerator to identify the implemented momentum solver strategies. More...
enum	SolutionConvergenceMode { SOLUTION_CONVERGENCE_STEADY_DETERMINISTIC = 0 , SOLUTION_CONVERGENCE_PERIODIC_DETERMINISTIC = 1 , SOLUTION_CONVERGENCE_STATISTICAL_STEADY = 2 , SOLUTION_CONVERGENCE_TRANSIENT = 3 }
	Selects the runtime solution-convergence diagnostics mode. More...
enum	ParticleInitializationType { PARTICLE_INIT_SURFACE_RANDOM = 0 , PARTICLE_INIT_VOLUME = 1 , PARTICLE_INIT_POINT_SOURCE = 2 , PARTICLE_INIT_SURFACE_EDGES = 3 }
	Enumerator to identify the particle initialization strategy. More...
enum	InterpolationMethod { INTERP_TRILINEAR = 0 , INTERP_CORNER_AVERAGED = 1 }
	Selects the grid-to-particle interpolation method. More...
enum	VTKFileType { VTK_STRUCTURED , VTK_POLYDATA }
	Enumerates the type of VTK file to be written. More...
enum	ExecutionMode { EXEC_MODE_SOLVER , EXEC_MODE_POSTPROCESSOR , EXEC_MODE_UNKNOWN }
	Defines the execution mode of the application. More...

Detailed Description

Main header file for a complex fluid dynamics solver.

Author

Vishal Kandala

This file defines the core data structures, global variables, and function prototypes for a CFD application. It combines features for a curvilinear, multi-block, immersed boundary (IBM) solver with fluid-structure interaction (FSI), a modern particle tracking system, a modular boundary condition framework, and post-processing utilities. It heavily utilizes the PETSc library.

*** REVISION NOTE *** This version introduces a central SimulationContext struct to encapsulate all simulation-wide configuration, replacing the legacy system of global variables. The UserCtx struct has been refactored to hold only data specific to a single grid level and now contains a back-pointer to the SimulationContext. All struct definitions now follow the typedef struct Name { ... } Name; convention.

Definition in file variables.h.

---

Data Structure Documentation

Cmpnts

struct Cmpnts

A 3D point or vector with PetscScalar components.

Definition at line 102 of file variables.h.

Data Fields
PetscScalar	x
PetscScalar	y
PetscScalar	z

Cmpnts2

struct Cmpnts2

A 2D point or vector with PetscScalar components.

Definition at line 107 of file variables.h.

Data Fields
PetscScalar	x
PetscScalar	y

Cpt2D

struct Cpt2D

A 2D vector of PETSc real numbers (for geometry/coordinates).

Definition at line 112 of file variables.h.

Data Fields
PetscReal	x
PetscReal	y

FlowWave

struct FlowWave

Represents a single point in a time-varying flow waveform.

Definition at line 117 of file variables.h.

Data Fields
PetscReal	t
PetscReal	f

BCS

struct BCS

Boundary condition data used by the BC pipeline and ghost cell machinery.

Definition at line 122 of file variables.h.

Data Fields
Vec	Ubcs	Physical Cartesian velocity at boundary faces. Full 3D array but only boundary-face entries are meaningful; interior is unused. Consumed by UpdateDummyCells for ghost cell extrapolation.
Vec	Uch	Characteristic velocity for boundary conditions.

BoundingBox

struct BoundingBox

Defines a 3D axis-aligned bounding box.

Definition at line 171 of file variables.h.

Collaboration diagram for BoundingBox:

Data Fields
Cmpnts	min_coords	Minimum x, y, z coordinates of the bounding box.
Cmpnts	max_coords	Maximum x, y, z coordinates of the bounding box.

Cell

struct Cell

Defines the vertices of a single hexahedral grid cell.

Definition at line 177 of file variables.h.

Collaboration diagram for Cell:

Data Fields
Cmpnts	vertices[8]	Coordinates of the eight vertices of the cell.

Particle

struct Particle

Defines a particle's core properties for Lagrangian tracking.

Definition at line 182 of file variables.h.

Collaboration diagram for Particle:

Data Fields
PetscInt64	PID
PetscInt	cell[3]
Cmpnts	loc
Cmpnts	vel
Cmpnts	weights
ParticleLocationStatus	location_status
PetscMPIInt	destination_rank
PetscReal	diffusivity
Cmpnts	diffusivitygradient
PetscReal	psi

RankNeighbors

struct RankNeighbors

Stores the MPI ranks of neighboring subdomains.

Definition at line 196 of file variables.h.

Data Fields
PetscMPIInt	rank_xm
PetscMPIInt	rank_xp
PetscMPIInt	rank_ym
PetscMPIInt	rank_yp
PetscMPIInt	rank_zm
PetscMPIInt	rank_zp

RankCellInfo

struct RankCellInfo

A lean struct to hold the global cell ownership range for a single MPI rank.

Definition at line 203 of file variables.h.

Data Fields
PetscInt	xs_cell
PetscInt	ys_cell
PetscInt	zs_cell
PetscInt	xm_cell
PetscInt	ym_cell
PetscInt	zm_cell

MigrationInfo

struct MigrationInfo

Information needed to migrate a single particle between MPI ranks.

Definition at line 209 of file variables.h.

Data Fields
PetscInt	local_index
PetscInt	target_rank

VerificationDiffusivityConfig

struct VerificationDiffusivityConfig

Verification-only analytical diffusivity override settings.

Definition at line 215 of file variables.h.

Data Fields
PetscBool	enabled
char	mode[32]
char	profile[32]
PetscReal	gamma0
PetscReal	slope_x

VerificationScalarConfig

struct VerificationScalarConfig

Verification-only analytical scalar override settings.

Definition at line 224 of file variables.h.

Data Fields
PetscBool	enabled
char	mode[32]
char	profile[32]
PetscReal	value
PetscReal	phi0
PetscReal	slope_x
PetscReal	amplitude
PetscReal	kx
PetscReal	ky
PetscReal	kz

SearchMetricsState

struct SearchMetricsState

Aggregated per-timestep search instrumentation counters.

Definition at line 238 of file variables.h.

Data Fields
PetscInt64	searchAttempts
PetscInt64	searchPopulation
PetscInt64	searchLocatedCount
PetscInt64	searchLostCount
PetscInt64	traversalStepsSum
PetscInt64	reSearchCount
PetscInt64	maxTraversalSteps
PetscInt64	maxTraversalFailCount
PetscInt64	tieBreakCount
PetscInt64	boundaryClampCount
PetscInt64	bboxGuessSuccessCount
PetscInt64	bboxGuessFallbackCount
PetscInt64	maxParticlePassDepth
PetscInt	currentSettlementPass

BC_Param_s

struct BC_Param_s

A node in a linked list for storing key-value parameters from the bcs.dat file.

Definition at line 336 of file variables.h.

Collaboration diagram for BC_Param_s:

Data Fields
char *	key
char *	value
struct BC_Param_s *	next

BCContext

struct BCContext

Provides execution context for a boundary condition handler.

Definition at line 343 of file variables.h.

Collaboration diagram for BCContext:

Data Fields
UserCtx *	user
BCFace	face_id
const PetscReal *	global_inflow_sum
const PetscReal *	global_farfield_inflow_sum
const PetscReal *	global_farfield_outflow_sum
const PetscReal *	global_outflow_sum

BoundaryFaceConfig

struct BoundaryFaceConfig

Holds the complete configuration for one of the six boundary faces.

Definition at line 366 of file variables.h.

Collaboration diagram for BoundaryFaceConfig:

Data Fields
BCFace	face_id
BCType	mathematical_type
BCHandlerType	handler_type
BC_Param *	params
BoundaryCondition *	handler

IBMInfo

struct IBMInfo

Holds interpolation and distance information for a single IBM point.

Definition at line 379 of file variables.h.

Collaboration diagram for IBMInfo:

Data Fields
PetscInt	i1
PetscInt	j1
PetscInt	k1
PetscInt	i2
PetscInt	j2
PetscInt	k2
PetscInt	i3
PetscInt	j3
PetscInt	k3
PetscReal	cr1
PetscReal	cr2
PetscReal	cr3
PetscReal	d_i
PetscInt	imode
PetscInt	ni
PetscInt	nj
PetscInt	nk
PetscReal	d_s
Cmpnts	pmin
PetscInt	cell
PetscReal	cs1
PetscReal	cs2
PetscReal	cs3
PetscInt	i11
PetscInt	j11
PetscInt	k11
PetscInt	i22
PetscInt	j22
PetscInt	k22
PetscInt	i33
PetscInt	j33
PetscInt	k33
PetscReal	cr11
PetscReal	cr22
PetscReal	cr33
PetscReal	d_ii
PetscInt	iimode
PetscReal	cs11
PetscReal	cs22
PetscReal	cs33
PetscInt	ii1
PetscInt	jj1
PetscInt	kk1
PetscInt	ii2
PetscInt	jj2
PetscInt	kk2
PetscInt	ii3
PetscInt	jj3
PetscInt	kk3
PetscReal	ct1
PetscReal	ct2
PetscReal	ct3
PetscInt	smode
PetscInt	ii11
PetscInt	jj11
PetscInt	kk11
PetscInt	ii22
PetscInt	jj22
PetscInt	kk22
PetscInt	ii33
PetscInt	jj33
PetscInt	kk33
PetscReal	ct11
PetscReal	ct22
PetscReal	ct33
PetscReal	d_ss
PetscInt	ssmode

IBMNodes

struct IBMNodes

Represents a collection of nodes forming a surface for the IBM.

Definition at line 404 of file variables.h.

Collaboration diagram for IBMNodes:

Data Fields
PetscInt	nbnumber
PetscInt	n_v
PetscInt	n_elmt
PetscInt *	nv1
PetscInt *	nv2
PetscInt *	nv3
PetscReal *	nf_x
PetscReal *	nf_y
PetscReal *	nf_z
PetscReal *	x_bp
PetscReal *	y_bp
PetscReal *	z_bp
PetscReal *	x_bp0
PetscReal *	y_bp0
PetscReal *	z_bp0
PetscReal *	x_bp_o
PetscReal *	y_bp_o
PetscReal *	z_bp_o
PetscReal *	cf
PetscReal *	cfsum
PetscReal *	CCp
PetscReal	x_bp_in[101][3270]
PetscReal	y_bp_in[101][3270]
PetscReal	z_bp_in[101][3270]
Cmpnts *	u
Cmpnts *	uold
Cmpnts *	urm1
PetscReal *	dA
PetscReal *	nt_x
PetscReal *	nt_y
PetscReal *	nt_z
PetscReal *	ns_x
PetscReal *	ns_y
PetscReal *	ns_z
PetscReal *	cent_x
PetscReal *	cent_y
PetscReal *	cent_z
PetscReal *	pres
PetscReal *	tau0
PetscReal *	tauN
PetscReal *	Bvel_u
PetscReal *	Bvel_v
PetscReal *	Bvel_w
PetscReal	x_min
PetscReal	x_max
PetscReal	y_min
PetscReal	y_max
PetscReal	z_min
PetscReal	z_max
Cmpnts *	qvec
PetscReal *	radvec

IBMVNodes

struct IBMVNodes

Represents a collection of nodes forming a volume for the IBM.

Definition at line 424 of file variables.h.

Collaboration diagram for IBMVNodes:

Data Fields
PetscInt	nbnumber
PetscInt	n_v
PetscInt	n_elmt
PetscInt *	nv1
PetscInt *	nv2
PetscInt *	nv3
PetscInt *	nv4
PetscReal *	x_bp
PetscReal *	y_bp
PetscReal *	z_bp
PetscReal *	x_bp0
PetscReal *	y_bp0
PetscReal *	z_bp0
PetscReal *	x_bp_o
PetscReal *	y_bp_o
PetscReal *	z_bp_o
Cmpnts *	u
Cmpnts *	uold
Cmpnts *	urm1
PetscReal	V
PetscReal *	dV0
PetscReal *	cent_x
PetscReal *	cent_y
PetscReal *	cent_z
PetscReal	x_c
PetscReal	y_c
PetscReal	z_c
PetscReal	J[3][3]
PetscReal	I_inv[3][3]

node

struct node

A generic C-style linked list node for integers.

Definition at line 439 of file variables.h.

Collaboration diagram for node:

Data Fields
PetscInt	Node
struct node *	next

list

struct list

Head of a generic C-style linked list.

Definition at line 445 of file variables.h.

Collaboration diagram for list:

Data Fields
node *	head

list_node

struct list_node

A generic C-style linked list node for indices.

Definition at line 450 of file variables.h.

Collaboration diagram for list_node:

Data Fields
PetscInt	index
struct list_node *	next

IBMListNode

struct IBMListNode

A linked list node containing IBM interpolation info.

Definition at line 456 of file variables.h.

Collaboration diagram for IBMListNode:

Data Fields
IBMInfo	ibm_intp
struct IBMListNode *	next

IBMList

struct IBMList

Head of a linked list for IBM data.

Definition at line 462 of file variables.h.

Collaboration diagram for IBMList:

Data Fields
IBMListNode *	head

SurfElmtInfo

struct SurfElmtInfo

Information about a surface element for FSI calculations.

Definition at line 467 of file variables.h.

Data Fields
PetscReal	P
PetscInt	n_P
PetscReal	Tow_ws
PetscReal	Tow_wt
PetscReal	Tow_wn
PetscInt	Clsnbpt_i
PetscInt	Clsnbpt_j
PetscInt	Clsnbpt_k
PetscInt	icell
PetscInt	jcell
PetscInt	kcell
PetscInt	FoundAroundcell
PetscInt	Need3rdPoint

FSInfo

struct FSInfo

Holds all data related to the state and motion of a body in FSI.

Definition at line 477 of file variables.h.

Collaboration diagram for FSInfo:

Data Fields
PetscReal	S_new[6]
PetscReal	S_old[6]
PetscReal	S_real[6]
PetscReal	S_realm1[6]
PetscReal	S_ang_n[6]
PetscReal	S_ang_o[6]
PetscReal	S_ang_r[6]
PetscReal	S_ang_rm1[6]
PetscReal	red_vel
PetscReal	damp
PetscReal	mu_s
PetscReal	F_x
PetscReal	F_y
PetscReal	F_z
PetscReal	A_tot
PetscReal	F_x_old
PetscReal	F_y_old
PetscReal	F_z_old
PetscReal	F_x_real
PetscReal	F_y_real
PetscReal	F_z_real
PetscReal	M_x
PetscReal	M_y
PetscReal	M_z
PetscReal	M_x_old
PetscReal	M_y_old
PetscReal	M_z_old
PetscReal	M_x_real
PetscReal	M_y_real
PetscReal	M_z_real
PetscReal	M_x_rm2
PetscReal	M_y_rm2
PetscReal	M_z_rm2
PetscReal	M_x_rm3
PetscReal	M_y_rm3
PetscReal	M_z_rm3
PetscReal	x_c
PetscReal	y_c
PetscReal	z_c
PetscReal	a_c[3]
PetscReal	Mdpdn_x
PetscReal	Mdpdn_y
PetscReal	Mdpdn_z
PetscReal	Mdpdn_x_old
PetscReal	Mdpdn_y_old
PetscReal	Mdpdn_z_old
PetscReal	Power
PetscReal	clone
PetscInt	pbc[3]
PetscReal	I_inv[3][3]
PetscReal	L_n[3]
PetscReal	L_o[3]
PetscReal	L_r[3]
PetscReal	alpha[3]
PetscReal	acc[3]
PetscReal	R[3][3]
PetscReal	q[4]
PetscReal	q_r[4]
PetscReal	dS[6]
PetscReal	dS_o[6]
PetscReal	atk
PetscReal	atk_o
SurfElmtInfo *	elmtinfo
IBMInfo *	fsi_intp
PetscReal	Max_xbc
PetscReal	Min_xbc
PetscReal	Max_ybc
PetscReal	Min_ybc
PetscReal	Max_zbc
PetscReal	Min_zbc
PetscInt	CV_ys
PetscInt	CV_ye
PetscInt	CV_zs
PetscInt	CV_ze

Cstart

struct Cstart

Defines prescribed body motion using splines.

Definition at line 507 of file variables.h.

Data Fields
PetscInt	n_time
PetscInt	n_midp
PetscInt	n_subit
PetscReal *	x_midp
PetscReal *	y_midp
PetscReal *	z_midp
PetscReal *	x_com
PetscReal *	y_com
PetscReal *	head_ang
PetscReal *	s1
PetscReal *	s2
PetscReal *	s3
PetscReal *	st1
PetscReal *	st2
PetscReal *	st3
Mat	Mphi
PetscReal	xmin
PetscReal	xmax
PetscReal	ymin
PetscReal	ymax
PetscReal	zmin
PetscReal	zmax

MGCtx

struct MGCtx

Context for Multigrid operations.

Definition at line 570 of file variables.h.

Collaboration diagram for MGCtx:

Data Fields
UserCtx *	user
PetscInt	thislevel
DM	packer

UserMG

struct UserMG

User-level context for managing the entire multigrid hierarchy.

Definition at line 577 of file variables.h.

Collaboration diagram for UserMG:

Data Fields
PetscInt	mglevels
PetscInt	thislevel
PetscBool	isc
PetscBool	jsc
PetscBool	ksc
MGCtx *	mgctx
DM	packer
SNES	snespacker

PostProcessParams

struct PostProcessParams

Holds all configuration parameters for a post-processing run.

This is an enhanced version combining command-line and file-based settings.

Definition at line 596 of file variables.h.

Data Fields
char	source_dir[PETSC_MAX_PATH_LEN]
PetscInt	startTime
PetscInt	endTime
PetscInt	timeStep
PetscBool	outputParticles
char	process_pipeline[1024]
char	output_fields_instantaneous[1024]
char	output_prefix[256]
char	particle_pipeline[1024]
char	particle_fields[1024]
char	particle_output_prefix[256]
PetscInt	particle_output_freq
char	statistics_pipeline[1024]	e.g. "ComputeMSD"
char	statistics_output_prefix[256]	basename for CSV output, e.g. "Stats"
char	field_statistics_windows[1024]	Comma-separated window names to derive; empty disables the pipeline.
char	field_statistics_outputs[1024]	Comma-separated outputs: mean, reynolds_stress, rms, tke, flux.
char	field_statistics_formats[1024]	Comma-separated formats: vtk for derived fields, csv for the convergence history.
PetscInt	field_statistics_source_step	Committed step supplying the state; negative means the step being processed.
char	eulerianExt[8]
char	particleExt[8]
PetscInt	reference[3]

VTKFieldInfo

struct VTKFieldInfo

Stores all necessary information for a single data array in a VTK file.

Definition at line 641 of file variables.h.

Data Fields
char	name[64]
PetscInt	num_components
PetscScalar *	data

VTKMetaData

struct VTKMetaData

Definition at line 653 of file variables.h.

Collaboration diagram for VTKMetaData:

Data Fields
VTKFileType	fileType
PetscInt	mx
PetscInt	my
PetscInt	mz
PetscInt	npoints
PetscScalar *	coords
VTKFieldInfo	point_data_fields[20]
PetscInt	num_point_data_fields
PetscInt *	connectivity
PetscInt *	offsets

ScalingCtx

struct ScalingCtx

Definition at line 676 of file variables.h.

Data Fields
PetscReal	L_ref
PetscReal	U_ref
PetscReal	rho_ref
PetscReal	P_ref

SimCtx

struct SimCtx

The master context for the entire simulation.

This struct encapsulates all global configuration flags, physical parameters, simulation control settings, and top-level data objects. It replaces the numerous global variables from the legacy codebase, providing a single, explicit source of truth for the simulation's setup.

Definition at line 695 of file variables.h.

Collaboration diagram for SimCtx:

Data Fields
PetscMPIInt	rank
PetscMPIInt	size
PetscInt	step
PetscReal	ti
PetscInt	StartStep
PetscInt	StepsToRun
PetscInt	tiout
PetscInt	particleConsoleOutputFreq
PetscReal	StartTime
PetscReal	dt
PetscBool	OnlySetup
PetscBool	continueMode
PetscViewer	logviewer
ExecutionMode	exec_mode
char	eulerianSource[PETSC_MAX_PATH_LEN]
char	restart_dir[PETSC_MAX_PATH_LEN]
char	output_dir[PETSC_MAX_PATH_LEN]
char	log_dir[PETSC_MAX_PATH_LEN]
char	_io_context_buffer[PETSC_MAX_PATH_LEN]
char *	current_io_directory
char	checkpointGeometrySHA256[65]
PetscBool	checkpointGeometryHashReady
PetscBool	restartHistoryAvailable
PetscInt	immersed
PetscInt	movefsi
PetscInt	rotatefsi
PetscInt	sediment
PetscInt	rheology
PetscInt	invicid
PetscInt	TwoD
PetscInt	thin
PetscInt	moveframe
PetscInt	rotateframe
PetscInt	blank
PetscInt	dgf_x
PetscInt	dgf_y
PetscInt	dgf_z
PetscInt	dgf_ax
PetscInt	dgf_ay
PetscInt	dgf_az
char	AnalyticalSolutionType[PETSC_MAX_PATH_LEN]
PetscInt	cop
PetscInt	fish
PetscInt	fish_c
PetscInt	fishcyl
PetscInt	eel
PetscInt	pizza
PetscInt	turbine
PetscInt	Pipe
PetscInt	wing
PetscInt	hydro
PetscInt	MHV
PetscInt	LV
PetscInt	channelz
MomentumSolverType	mom_solver_type
PetscInt	mom_max_pseudo_steps
PetscReal	mom_atol
PetscReal	mom_rtol
PetscReal	mom_resid_atol
PetscReal	mom_resid_rtol
PetscReal	imp_stol
PetscInt	mglevels
PetscInt	mg_MAX_IT
PetscInt	mg_idx
PetscInt	mg_preItr
PetscInt	mg_poItr
PetscInt	poisson
PetscReal	poisson_tol
PetscInt	STRONG_COUPLING
PetscInt	central
PetscReal	ren
PetscReal	pseudo_cfl
PetscReal	cdisx
PetscReal	cdisy
PetscReal	cdisz
PetscReal	pseudo_cfl_reduction_factor
PetscReal	pseudo_cfl_growth_factor
PetscReal	max_pseudo_cfl
PetscReal	min_pseudo_cfl
PetscReal	mom_dt_jameson_residual_norm_noise_allowance_factor
PetscBool	no_pseudo_cfl_backtrack
PetscReal	mom_ratio_ema_alpha
PetscBool	mom_last_converged
PetscReal	mom_last_lambda_max
PetscBool	mom_nk_monitor_history
PetscBool	ps_ksp_pic_monitor_true_residual
InitialConditionMode	initialConditionMode
InitialConditionField	initialConditionField
char	initialConditionDirectory[PETSC_MAX_PATH_LEN]
Cmpnts	InitialConstantContra
FlowDirection	flowDirection
PetscReal	icVelocityPhysical
Cmpnts	AnalyticalUniformVelocity
PetscBool	solutionConvergenceEnabled
SolutionConvergenceMode	solutionConvergenceMode
PetscInt	solutionConvergencePeriodSteps
PetscInt	solutionConvergenceWindowSteps
PetscInt	solutionConvergenceSamplesRecorded
PetscReal *	solutionConvergenceMeanSpeedHistory
PetscReal *	solutionConvergenceMeanKEHistory
PetscBool	fieldStatisticsEnabled
PetscInt	fieldStatisticsWindowCount
struct PicurvWindow *	fieldStatisticsWindows
PetscInt	statisticsConsoleOutputFreq
PetscBool	fieldStatisticsContinue
VerificationDiffusivityConfig	verificationDiffusivity
VerificationScalarConfig	verificationScalar
PetscInt	NumberOfBodies
PetscReal	Flux_in
PetscReal	angle
PetscReal	max_angle
PetscReal	CMx_c
PetscReal	CMy_c
PetscReal	CMz_c
PetscReal	psrc_x
PetscReal	psrc_y
PetscReal	psrc_z	Point source location for PARTICLE_INIT_POINT_SOURCE.
ScalingCtx	scaling
PetscReal	wall_roughness_height
PetscReal	schmidt_number
PetscReal	Turbulent_schmidt_number
PetscInt	block_number
PetscInt	inletprofile
PetscInt	grid1d
PetscInt	Ogrid
PetscInt	i_periodic
PetscInt	j_periodic
PetscInt	k_periodic
PetscInt	blkpbc
PetscInt	pseudo_periodic
PetscBool	generate_grid
PetscReal	grid_rotation_angle
PetscReal	Croty
PetscReal	Crotz
char	grid_file[PETSC_MAX_PATH_LEN]
PetscInt	da_procs_x
PetscInt	da_procs_y
PetscInt	da_procs_z
PetscInt	num_bcs_files
char **	bcs_files
PetscReal	FluxInSum
PetscReal	FluxOutSum
PetscReal	Fluxsum
PetscReal	FarFluxInSum
PetscReal	FarFluxOutSum
PetscReal	drivingForceMagnitude
PetscReal	forceScalingFactor
PetscInt	drivingForceStep
PetscReal	targetVolumetricFlux
PetscBool	drivenFluxTargetLatched
PetscReal	bulkVelocityCorrection
PetscReal	boundaryVelocityCorrection
PetscReal	AreaInSum
PetscReal	AreaOutSum
PetscReal	U_bc
PetscInt	ccc
PetscReal	ratio
PetscInt	les
PetscInt	rans
PetscInt	wallfunction
PetscInt	mixed
PetscInt	clark
PetscInt	dynamic_freq
PetscReal	max_cs
PetscReal	Const_CS
PetscInt	testfilter_ik
PetscInt	testfilter_1d
PetscInt	i_homo_filter
PetscInt	j_homo_filter
PetscInt	k_homo_filter
PetscInt	np
PetscBool	readFields
DM	dm_swarm
BoundingBox *	bboxlist
ParticleInitializationType	ParticleInitialization
InterpolationMethod	interpolationMethod
char	particleRestartMode[16]
PetscInt	particlesLostLastStep
PetscInt	particlesLostCumulative
PetscInt	migrationPassesLastStep
PetscInt	particlesMigratedLastStep
PetscInt	occupiedCellCount
PetscReal	particleLoadImbalance
SearchMetricsState	searchMetrics
PetscRandom	BrownianMotionRNG
PetscReal	C_IEM
IBMNodes *	ibm
IBMVNodes *	ibmv
FSInfo *	fsi
PetscBool	rstart_fsi
PetscInt	duplicate
UserMG	usermg
char	allowedFile[PETSC_MAX_PATH_LEN]
PetscBool	useCfg
char **	allowedFuncs
PetscInt	nAllowed
PetscInt	LoggingFrequency
PetscReal	summationRHS
PetscReal	MaxDiv
PetscInt	MaxDivFlatArg
PetscInt	MaxDivx
PetscInt	MaxDivy
PetscInt	MaxDivz
char	profilingSelectedFuncsFile[PETSC_MAX_PATH_LEN]
PetscBool	useProfilingSelectedFuncsCfg
char **	profilingSelectedFuncs
PetscInt	nProfilingSelectedFuncs
char	profilingTimestepMode[32]
char	profilingTimestepFile[PETSC_MAX_PATH_LEN]
PetscBool	profilingFinalSummary
PetscBool	walltimeGuardEnabled
PetscBool	walltimeGuardActive
PetscInt	walltimeGuardWarmupSteps
PetscReal	walltimeGuardMultiplier
PetscReal	walltimeGuardMinSeconds
PetscReal	walltimeGuardEstimatorAlpha
PetscReal	walltimeGuardJobStartEpochSeconds
PetscReal	walltimeGuardLimitSeconds
PetscInt	walltimeGuardCompletedSteps
PetscReal	walltimeGuardWarmupTotalSeconds
PetscReal	walltimeGuardWarmupAverageSeconds
PetscBool	walltimeGuardHasEWMA
PetscReal	walltimeGuardEWMASeconds
PetscReal	walltimeGuardLatestStepSeconds
PetscBool	runtimeMemoryLogEnabled	Enable the rank-reduced runtime memory log.
char	runtimeMemoryLogFile[PETSC_MAX_PATH_LEN]	File name written under log_dir.
PetscBool	runtimeMemoryLogStarted	True after rank 0 writes the log header.
PetscBool	runtimeMemoryLogHasPrevious	True after the first process-memory sample.
PetscReal	runtimeMemoryLogPreviousProcessMB	Previous local process memory sample in MB.
char	PostprocessingControlFile[PETSC_MAX_PATH_LEN]
PostProcessParams *	pps
PetscReal	r[101]
PetscReal	tin[101]
PetscReal	uinr[101][1001]

UserCtx

struct UserCtx

User-defined context containing data specific to a single computational grid level.

This is the primary data structure passed to low-level numerical and solver functions.

Definition at line 906 of file variables.h.

Collaboration diagram for UserCtx:

Data Fields
SimCtx *	simCtx	Back-pointer to the master simulation context.
DM	da
DM	fda
DM	fda2
DM	fda6
DMDALocalInfo	info
AO	ao
PetscInt	IM
PetscInt	JM
PetscInt	KM
PetscReal	Max_X
PetscReal	Max_Y
PetscReal	Max_Z
PetscReal	Min_X
PetscReal	Min_Y
PetscReal	Min_Z
BoundingBox	bbox
RankNeighbors	neighbors
PetscInt	GridOrientation
PetscInt	isc
PetscInt	jsc
PetscInt	ksc
PetscInt	_this
PetscReal	rx
PetscReal	ry
PetscReal	rz
PetscInt	cgrid
Cmpnts	periodic_translation[3]
PetscBool	periodic_translation_valid[3]
BoundaryFaceConfig	boundary_faces[6]
PetscBool	inletFaceDefined
BCFace	identifiedInletBCFace
BCS	Bcs
Vec	lFriction_Velocity
PetscReal	FluxIntpSum
PetscReal	FluxIntfcSum
Vec	Ucont
Vec	lUcont
Vec	Ucat
Vec	lUcat
Vec	P
Vec	lP
Vec	Phi
Vec	lPhi
Vec	Nvert
Vec	lNvert
Vec	Diffusivity
Vec	lDiffusivity
Vec	DiffusivityGradient
Vec	lDiffusivityGradient
Vec	Ucont_o
Vec	lUcont_o
Vec	Ucat_o
Vec	P_o
Vec	Nvert_o
Vec	lNvert_o
Vec	Ucont_rm1
Vec	lUcont_rm1
Vec	Rhs
Vec	dUcont
Vec	pUcont
Vec *	solutionConvergencePeriodicUcatRef
Vec *	solutionConvergencePeriodicPRef
Vec	CellScalarAtCorner
Vec	lCellScalarAtCorner
Vec	CellVectorAtCorner
Vec	lCellVectorAtCorner
Vec	PostScalar
Vec	lPostScalar
Vec	PostScalarNodal
Vec	PostVector
Vec	lPostVector
Vec	PostVectorNodal
struct PicurvWindowStorage *	fieldStatisticsStorage
Mat	A
Mat	C
KSP	ksp
MatNullSpace	nullsp
PetscInt *	KSKE
PetscBool	multinullspace
Vec	B
Vec	R
Mat	MR
Mat	MP
PetscBool	assignedA
Vec	Cent
Vec	lCent
Vec	Csi
Vec	Eta
Vec	Zet
Vec	Aj
Vec	lCsi
Vec	lEta
Vec	lZet
Vec	lAj
Vec	GridSpace
Vec	lGridSpace
Vec	Centx
Vec	Centy
Vec	Centz
Vec	lCentx
Vec	lCenty
Vec	lCentz
Vec	ICsi
Vec	IEta
Vec	IZet
Vec	IAj
Vec	lICsi
Vec	lIEta
Vec	lIZet
Vec	lIAj
Vec	JCsi
Vec	JEta
Vec	JZet
Vec	JAj
Vec	lJCsi
Vec	lJEta
Vec	lJZet
Vec	lJAj
Vec	KCsi
Vec	KEta
Vec	KZet
Vec	KAj
Vec	lKCsi
Vec	lKEta
Vec	lKZet
Vec	lKAj
Vec	Nu_t
Vec	lNu_t
Vec	CS
Vec	lCs
Vec	K_Omega
Vec	lK_Omega
Vec	K_Omega_o
Vec	lK_Omega_o
Vec	Distance
IBMNodes *	ibm
IBMList *	ibmlist
PetscInt	thislevel
PetscInt	mglevels
UserCtx *	user_f
UserCtx *	user_c
DM *	da_f
DM *	da_c
Vec *	lNvert_c
DM	swarm
RankCellInfo *	RankCellInfoMap
Vec	ParticleCount
Vec	lParticleCount
Vec	Psi
Vec	lPsi
DM	post_swarm
Vec	P_nodal
Vec	Ucat_nodal
Vec	Qcrit
Vec	Psi_nodal

Macro Definition Documentation

COEF_TIME_ACCURACY

#define COEF_TIME_ACCURACY   1.5

Coefficient controlling the temporal accuracy scheme (e.g., 1.5 for 2nd Order Backward Difference).

Definition at line 57 of file variables.h.

MAX_PIPELINE_LENGTH

#define MAX_PIPELINE_LENGTH   1024

Definition at line 586 of file variables.h.

MAX_FIELD_LIST_LENGTH

#define MAX_FIELD_LIST_LENGTH   1024

Definition at line 587 of file variables.h.

MAX_FILENAME_LENGTH

#define MAX_FILENAME_LENGTH   256

Definition at line 588 of file variables.h.

MAX_POINT_DATA_FIELDS

#define MAX_POINT_DATA_FIELDS   20

Defines the maximum number of data fields for VTK point data.

Definition at line 590 of file variables.h.

MAX_VTK_FIELD_NAME_LENGTH

#define MAX_VTK_FIELD_NAME_LENGTH   64

Maximum length for VTK field names.

Definition at line 591 of file variables.h.

mom_dt_rk4_residual_norm_noise_allowance_factor

#define mom_dt_rk4_residual_norm_noise_allowance_factor   mom_dt_jameson_residual_norm_noise_allowance_factor

Deprecated:

Use mom_dt_jameson_residual_norm_noise_allowance_factor.

Definition at line 898 of file variables.h.

Typedef Documentation

SimCtx

typedef struct SimCtx SimCtx

The master context for the entire simulation.

This struct encapsulates all global configuration flags, physical parameters, simulation control settings, and top-level data objects. It replaces the numerous global variables from the legacy codebase, providing a single, explicit source of truth for the simulation's setup.

Definition at line 73 of file variables.h.

UserCtx

typedef struct UserCtx UserCtx

User-defined context containing data specific to a single computational grid level.

This is the primary data structure passed to low-level numerical and solver functions.

Definition at line 76 of file variables.h.

BC_Param

typedef struct BC_Param_s BC_Param

Definition at line 77 of file variables.h.

BoundaryCondition

typedef struct BoundaryCondition BoundaryCondition

The "virtual table" struct for a boundary condition handler object.

Definition at line 78 of file variables.h.

BoundaryFaceConfig

typedef struct BoundaryFaceConfig BoundaryFaceConfig

Holds the complete configuration for one of the six boundary faces.

Definition at line 79 of file variables.h.

IBMNodes

typedef struct IBMNodes IBMNodes

Represents a collection of nodes forming a surface for the IBM.

Definition at line 80 of file variables.h.

IBMVNodes

typedef struct IBMVNodes IBMVNodes

Represents a collection of nodes forming a volume for the IBM.

Definition at line 81 of file variables.h.

FSInfo

typedef struct FSInfo FSInfo

Holds all data related to the state and motion of a body in FSI.

Definition at line 82 of file variables.h.

UserMG

typedef struct UserMG UserMG

User-level context for managing the entire multigrid hierarchy.

Definition at line 83 of file variables.h.

BoundingBox

typedef struct BoundingBox BoundingBox

Defines a 3D axis-aligned bounding box.

Definition at line 84 of file variables.h.

Cell

typedef struct Cell Cell

Defines the vertices of a single hexahedral grid cell.

Definition at line 85 of file variables.h.

Particle

typedef struct Particle Particle

Defines a particle's core properties for Lagrangian tracking.

Definition at line 86 of file variables.h.

RankNeighbors

typedef struct RankNeighbors RankNeighbors

Stores the MPI ranks of neighboring subdomains.

Definition at line 87 of file variables.h.

RankCellInfo

typedef struct RankCellInfo RankCellInfo

A lean struct to hold the global cell ownership range for a single MPI rank.

Definition at line 88 of file variables.h.

MigrationInfo

typedef struct MigrationInfo MigrationInfo

Information needed to migrate a single particle between MPI ranks.

Definition at line 89 of file variables.h.

Cstart

typedef struct Cstart Cstart

Defines prescribed body motion using splines.

Definition at line 90 of file variables.h.

MGCtx

typedef struct MGCtx MGCtx

Context for Multigrid operations.

Definition at line 91 of file variables.h.

PostProcessParams

typedef struct PostProcessParams PostProcessParams

Holds all configuration parameters for a post-processing run.

This is an enhanced version combining command-line and file-based settings.

Definition at line 92 of file variables.h.

VTKFieldInfo

typedef struct VTKFieldInfo VTKFieldInfo

Stores all necessary information for a single data array in a VTK file.

Definition at line 93 of file variables.h.

VTKMetaData

typedef struct VTKMetaData VTKMetaData

Definition at line 94 of file variables.h.

IBMInfo

typedef struct IBMInfo IBMInfo

Holds interpolation and distance information for a single IBM point.

Definition at line 95 of file variables.h.

SurfElmtInfo

typedef struct SurfElmtInfo SurfElmtInfo

Information about a surface element for FSI calculations.

Definition at line 96 of file variables.h.

ScalingCtx

typedef struct ScalingCtx ScalingCtx

Definition at line 97 of file variables.h.

Cmpnts

typedef struct Cmpnts Cmpnts

A 3D point or vector with PetscScalar components.

Cmpnts2

typedef struct Cmpnts2 Cmpnts2

A 2D point or vector with PetscScalar components.

Cpt2D

typedef struct Cpt2D Cpt2D

A 2D vector of PETSc real numbers (for geometry/coordinates).

FlowWave

typedef struct FlowWave FlowWave

Represents a single point in a time-varying flow waveform.

BCS

typedef struct BCS BCS

Boundary condition data used by the BC pipeline and ghost cell machinery.

VerificationDiffusivityConfig

typedef struct VerificationDiffusivityConfig VerificationDiffusivityConfig

Verification-only analytical diffusivity override settings.

VerificationScalarConfig

typedef struct VerificationScalarConfig VerificationScalarConfig

Verification-only analytical scalar override settings.

SearchMetricsState

typedef struct SearchMetricsState SearchMetricsState

Aggregated per-timestep search instrumentation counters.

BCContext

typedef struct BCContext BCContext

Provides execution context for a boundary condition handler.

node

typedef struct node node

A generic C-style linked list node for integers.

List

typedef struct list List

Head of a generic C-style linked list.

Node_List

typedef struct list_node Node_List

A generic C-style linked list node for indices.

IBMListNode

typedef struct IBMListNode IBMListNode

A linked list node containing IBM interpolation info.

IBMList

typedef struct IBMList IBMList

Head of a linked list for IBM data.

Enumeration Type Documentation

ParticleLocationStatus

enum ParticleLocationStatus

Defines the state of a particle with respect to its location and migration status during the iterative SettleParticles() process.

Enumerator
NEEDS_LOCATION
ACTIVE_AND_LOCATED
MIGRATING_OUT
LOST
UNINITIALIZED

Definition at line 137 of file variables.h.

             {
    NEEDS_LOCATION,
    ACTIVE_AND_LOCATED,
    MIGRATING_OUT,
    LOST,
    UNINITIALIZED
} ParticleLocationStatus;

Face

enum Face

Enumerates the six faces of a cubic cell for distance calculations.

Enumerator
LEFT
RIGHT
BOTTOM
TOP
FRONT
BACK
NUM_FACES

Definition at line 146 of file variables.h.

             {
    LEFT = 0, RIGHT, BOTTOM, TOP, FRONT, BACK, NUM_FACES
} Face;

InitialConditionMode

enum InitialConditionMode

Selects the algorithm used to populate a fresh Eulerian velocity field.

Enumerator
IC_MODE_ZERO
IC_MODE_CONSTANT_CARTESIAN
IC_MODE_POISEUILLE
IC_MODE_CONSTANT_STREAMWISE
IC_MODE_FILE

Definition at line 151 of file variables.h.

             {
    IC_MODE_ZERO = 0,
    IC_MODE_CONSTANT_CARTESIAN = 1,
    IC_MODE_POISEUILLE = 2,
    IC_MODE_CONSTANT_STREAMWISE = 3,
    IC_MODE_FILE = 4
} InitialConditionMode;

InitialConditionField

enum InitialConditionField

Selects the authoritative velocity representation in a staged file IC.

Enumerator
IC_FIELD_UCAT
IC_FIELD_UCONT

Definition at line 160 of file variables.h.

             {
    IC_FIELD_UCAT = 0,
    IC_FIELD_UCONT = 1
} InitialConditionField;

BCFace

enum BCFace

Identifies the six logical faces of a structured computational block.

Enumerator
BC_FACE_NEG_X
BC_FACE_POS_X
BC_FACE_NEG_Y
BC_FACE_POS_Y
BC_FACE_NEG_Z
BC_FACE_POS_Z

Definition at line 261 of file variables.h.

             {
    BC_FACE_NEG_X = 0, BC_FACE_POS_X = 1,
    BC_FACE_NEG_Y = 2, BC_FACE_POS_Y = 3,
    BC_FACE_NEG_Z = 4, BC_FACE_POS_Z = 5
} BCFace;

FlowDirection

enum FlowDirection

Primary flow direction for streamwise IC and Poiseuille modes.

Even values = positive-face-normal direction; odd = negative. axis = value / 2 (0=Xi, 1=Eta, 2=Zeta). sign = (value % 2 == 0) ? +1 : -1.

Enumerator
FLOW_DIR_POS_XI
FLOW_DIR_NEG_XI
FLOW_DIR_POS_ETA
FLOW_DIR_NEG_ETA
FLOW_DIR_POS_ZETA
FLOW_DIR_NEG_ZETA
FLOW_DIR_UNSET

Definition at line 272 of file variables.h.

             {
    FLOW_DIR_POS_XI   = 0,
    FLOW_DIR_NEG_XI   = 1,
    FLOW_DIR_POS_ETA  = 2,
    FLOW_DIR_NEG_ETA  = 3,
    FLOW_DIR_POS_ZETA = 4,
    FLOW_DIR_NEG_ZETA = 5,
    FLOW_DIR_UNSET    = -1
} FlowDirection;

BCType

enum BCType

Defines the general mathematical/physical Category of a boundary.

Enumerator
WALLFUNCTION
INTERFACE
WALL
MOVING_WALL
SYMMETRY
OUTLET
INLET
FARFIELD
PERIODIC
CHARACTERISTIC_BC
ANALYTICAL_VORTEX
JUNCTION
ANNULUS
OGRID
RHEOLOGY

Definition at line 283 of file variables.h.

             {
    WALLFUNCTION       = -1,
    INTERFACE          = 0,
    WALL               = 1 , 
    MOVING_WALL        = 2,
    SYMMETRY           = 3,
    OUTLET             = 4,
    INLET              = 5, 
    FARFIELD           = 6,
    PERIODIC           = 7,
    CHARACTERISTIC_BC  = 8,
    ANALYTICAL_VORTEX  = 9,
    JUNCTION           = 10,
    ANNULUS            = 11,
    OGRID              = 12,
    RHEOLOGY           = 13,
    // Note:  Legacy 14 can be a JUNCTION with a specific handler.
} BCType;

BCHandlerType

enum BCHandlerType

Defines the specific computational "strategy" for a boundary handler.

Enumerator
BC_HANDLER_UNDEFINED
BC_HANDLER_WALL_NOSLIP
BC_HANDLER_WALL_MOVING
BC_HANDLER_SYMMETRY_PLANE
BC_HANDLER_INLET_CONSTANT_VELOCITY
BC_HANDLER_INLET_PARABOLIC
BC_HANDLER_INLET_PROFILE_FROM_FILE
BC_HANDLER_INLET_INTERP_FROM_FILE
BC_HANDLER_INLET_PULSATILE_FLUX
BC_HANDLER_FARFIELD_NONREFLECTING
BC_HANDLER_OUTLET_CONSERVATION
BC_HANDLER_OUTLET_PRESSURE
BC_HANDLER_PERIODIC_GEOMETRIC
BC_HANDLER_INTERFACE_OVERSET
BC_HANDLER_PERIODIC_DRIVEN_CONSTANT_FLUX
BC_HANDLER_PERIODIC_DRIVEN_INITIAL_FLUX

Definition at line 303 of file variables.h.

             {
    BC_HANDLER_UNDEFINED = 0,
    BC_HANDLER_WALL_NOSLIP = 1, 
    BC_HANDLER_WALL_MOVING = 2,
    BC_HANDLER_SYMMETRY_PLANE = 3,
    BC_HANDLER_INLET_CONSTANT_VELOCITY = 4,
    BC_HANDLER_INLET_PARABOLIC = 5,
    BC_HANDLER_INLET_PROFILE_FROM_FILE = 6,
    BC_HANDLER_INLET_INTERP_FROM_FILE = 7,
    BC_HANDLER_INLET_PULSATILE_FLUX = 8,
    BC_HANDLER_FARFIELD_NONREFLECTING = 9,
    BC_HANDLER_OUTLET_CONSERVATION = 10, 
    BC_HANDLER_OUTLET_PRESSURE = 11,
    BC_HANDLER_PERIODIC_GEOMETRIC = 12, 
    BC_HANDLER_INTERFACE_OVERSET = 13,
    BC_HANDLER_PERIODIC_DRIVEN_CONSTANT_FLUX =  14,
    BC_HANDLER_PERIODIC_DRIVEN_INITIAL_FLUX = 15
  } BCHandlerType;

BCPriorityType

enum BCPriorityType

Enumerator
BC_PRIORITY_UNDEFINED
BC_PRIORITY_INLET
BC_PRIORITY_FARFIELD
BC_PRIORITY_WALL
BC_PRIORITY_OUTLET

Definition at line 323 of file variables.h.

            {
    BC_PRIORITY_UNDEFINED = -1,
    BC_PRIORITY_INLET = 0,
    BC_PRIORITY_FARFIELD = 1,
    BC_PRIORITY_WALL = 2,
    BC_PRIORITY_OUTLET =3
} BCPriorityType;

LESModelType

enum LESModelType

Identifies the six logical faces of a structured computational block.

Enumerator
NO_LES_MODEL
CONSTANT_SMAGORINSKY
DYNAMIC_SMAGORINSKY

Definition at line 520 of file variables.h.

             {
    NO_LES_MODEL = 0,
    CONSTANT_SMAGORINSKY = 1,
    DYNAMIC_SMAGORINSKY = 2
} LESModelType;

MomentumSolverType

enum MomentumSolverType

Enumerator to identify the implemented momentum solver strategies.

Add new enum values only when the parser, runtime dispatch, docs, and tests are updated in the same change.

Enumerator
MOMENTUM_SOLVER_EXPLICIT_RK
MOMENTUM_SOLVER_DUALTIME_PICARD_JAMESON_RK
MOMENTUM_SOLVER_NEWTON_KRYLOV
MOMENTUM_SOLVER_DUALTIME_PICARD_RK4	Deprecated: Use MOMENTUM_SOLVER_DUALTIME_PICARD_JAMESON_RK.

Definition at line 534 of file variables.h.

            {
    MOMENTUM_SOLVER_EXPLICIT_RK = 0,
    MOMENTUM_SOLVER_DUALTIME_PICARD_JAMESON_RK = 1,
    MOMENTUM_SOLVER_NEWTON_KRYLOV = 2,
    /** @deprecated Use MOMENTUM_SOLVER_DUALTIME_PICARD_JAMESON_RK. */
    MOMENTUM_SOLVER_DUALTIME_PICARD_RK4 = MOMENTUM_SOLVER_DUALTIME_PICARD_JAMESON_RK
} MomentumSolverType;

SolutionConvergenceMode

enum SolutionConvergenceMode

Selects the runtime solution-convergence diagnostics mode.

Enumerator
SOLUTION_CONVERGENCE_STEADY_DETERMINISTIC
SOLUTION_CONVERGENCE_PERIODIC_DETERMINISTIC
SOLUTION_CONVERGENCE_STATISTICAL_STEADY
SOLUTION_CONVERGENCE_TRANSIENT

Definition at line 543 of file variables.h.

            {
    SOLUTION_CONVERGENCE_STEADY_DETERMINISTIC = 0,
    SOLUTION_CONVERGENCE_PERIODIC_DETERMINISTIC = 1,
    SOLUTION_CONVERGENCE_STATISTICAL_STEADY = 2,
    SOLUTION_CONVERGENCE_TRANSIENT = 3
} SolutionConvergenceMode;

ParticleInitializationType

enum ParticleInitializationType

Enumerator to identify the particle initialization strategy.

Enumerator
PARTICLE_INIT_SURFACE_RANDOM	Random placement on the inlet face.
PARTICLE_INIT_VOLUME	Random volumetric distribution across the domain.
PARTICLE_INIT_POINT_SOURCE	All particles at a fixed (psrc_x,psrc_y,psrc_z) — for validation.
PARTICLE_INIT_SURFACE_EDGES	Deterministic placement at inlet face edges.

Definition at line 551 of file variables.h.

             {
    PARTICLE_INIT_SURFACE_RANDOM = 0, /**< Random placement on the inlet face */
    PARTICLE_INIT_VOLUME         = 1, /**< Random volumetric distribution across the domain */
    PARTICLE_INIT_POINT_SOURCE   = 2, /**< All particles at a fixed (psrc_x,psrc_y,psrc_z) — for validation */
    PARTICLE_INIT_SURFACE_EDGES  = 3  /**< Deterministic placement at inlet face edges */
} ParticleInitializationType;

InterpolationMethod

enum InterpolationMethod

Selects the grid-to-particle interpolation method.

• INTERP_TRILINEAR: Direct trilinear from 8 nearest cell centers (second-order on curvilinear grids).
• INTERP_CORNER_AVERAGED: Legacy center-to-corner average, then trilinear from corners.

Enumerator
INTERP_TRILINEAR
INTERP_CORNER_AVERAGED

Definition at line 564 of file variables.h.

             {
    INTERP_TRILINEAR       = 0,
    INTERP_CORNER_AVERAGED = 1
} InterpolationMethod;

VTKFileType

enum VTKFileType

Enumerates the type of VTK file to be written.

Enumerator
VTK_STRUCTURED
VTK_POLYDATA

Definition at line 648 of file variables.h.

             {
    VTK_STRUCTURED,
    VTK_POLYDATA
} VTKFileType;

ExecutionMode

enum ExecutionMode

Defines the execution mode of the application.

Enumerator
EXEC_MODE_SOLVER
EXEC_MODE_POSTPROCESSOR
EXEC_MODE_UNKNOWN

Definition at line 667 of file variables.h.

             {
    EXEC_MODE_SOLVER,          // The application is running as the main fluid solver.
    EXEC_MODE_POSTPROCESSOR,   // The application is running as the post-processor.
    EXEC_MODE_UNKNOWN          // Default/error state.
} ExecutionMode;