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	SymTensor
	A symmetric second-order tensor stored by its six independent components. More...

struct	Cpt2D
	A 2D vector of PETSc real numbers (for geometry/coordinates). 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	LESConfig
	Every user-selectable parameter of the LES closure. More...

struct	LESDiagnosticsState
	Pre-clipping volume statistics captured by one dynamic-coefficient update. More...

struct	WallModelDiagnosticsState
	Near-wall statistics captured by one wall-model pass. 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	PICURV_RELEASE_VERSION "0.0.0"

#define	PICURV_GIT_COMMIT "unknown"

#define	PICURV_BUILD_DIRTY "unknown"

#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 SymTensor	SymTensor
	A symmetric second-order tensor stored by its six independent components.

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

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.

typedef struct LESConfig	LESConfig
	Every user-selectable parameter of the LES closure.

typedef struct LESDiagnosticsState	LESDiagnosticsState
	Pre-clipping volume statistics captured by one dynamic-coefficient update.

typedef struct WallModelDiagnosticsState	WallModelDiagnosticsState
	Near-wall statistics captured by one wall-model pass.

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_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 , VREMAN = 3 , WALE = 4 }
	Identifies the subgrid-scale closure evaluated during a timestep. More...

enum	WallFunctionModel { WALL_FUNCTION_NONE = 0 , WALL_FUNCTION_LOG_LAW = 1 , WALL_FUNCTION_WERNER = 2 , WALL_FUNCTION_CABOT = 3 }
	Selects the wall model applied on WALL faces. More...

enum	LESFilterWidthModel { LES_FILTER_WIDTH_CUBE_ROOT_VOLUME = 0 , LES_FILTER_WIDTH_GEOMETRIC_MEAN = 1 , LES_FILTER_WIDTH_MAX_EDGE = 2 , LES_FILTER_WIDTH_SCOTTI = 3 }
	Selects how a cell's grid filter width is derived from its metrics. More...

enum	LESTestFilterKernel { LES_TEST_FILTER_VOLUME_WEIGHTED_BOX = 0 , LES_TEST_FILTER_SIMPSON_IK = 1 }
	Selects the discrete test-filter kernel used by the dynamic procedure. More...

enum	LESAveragingMode { LES_AVERAGING_LOCAL = 0 , LES_AVERAGING_HOMOGENEOUS = 1 , LES_AVERAGING_GLOBAL = 2 }
	Selects the set over which the Germano contractions are averaged. More...

enum	LESClipMode { LES_CLIP_CLAMP = 0 , LES_CLIP_CLIP_NEGATIVE = 1 , LES_CLIP_NONE = 2 }
	Selects the admissible range imposed on the dynamic model coefficient. 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 121 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 126 of file variables.h.

Data Fields
PetscScalar	x
PetscScalar	y

◆ SymTensor

struct SymTensor

A symmetric second-order tensor stored by its six independent components.

The three missing components are recovered by symmetry: yx == xy, zx == xz, and zy == yz. Contractions must therefore double the off-diagonal terms, which is what SymTensorContract() exists to do in one place instead of at every call site. Used for strain rates and for the Germano identity's Leonard and model tensors.

Definition at line 138 of file variables.h.

Data Fields
PetscReal	xx
PetscReal	xy
PetscReal	xz
PetscReal	yy
PetscReal	yz
PetscReal	zz

◆ Cpt2D

struct Cpt2D

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

Definition at line 143 of file variables.h.

Data Fields
PetscReal	x
PetscReal	y

◆ BCS

struct BCS

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

Definition at line 148 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 197 of file variables.h.

Collaboration diagram for BoundingBox:

[legend]

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 203 of file variables.h.

Collaboration diagram for Cell:

[legend]

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 208 of file variables.h.

Collaboration diagram for Particle:

[legend]

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 222 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 229 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 235 of file variables.h.

Data Fields
PetscInt	local_index
PetscInt	target_rank

◆ VerificationDiffusivityConfig

struct VerificationDiffusivityConfig

Verification-only analytical diffusivity override settings.

Definition at line 241 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 250 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 264 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 360 of file variables.h.

Collaboration diagram for BC_Param_s:

[legend]

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 367 of file variables.h.

Collaboration diagram for BCContext:

[legend]

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 390 of file variables.h.

Collaboration diagram for BoundaryFaceConfig:

[legend]

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 403 of file variables.h.

Collaboration diagram for IBMInfo:

[legend]

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 428 of file variables.h.

Collaboration diagram for IBMNodes:

[legend]

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 448 of file variables.h.

Collaboration diagram for IBMVNodes:

[legend]

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 463 of file variables.h.

Collaboration diagram for node:

[legend]

Data Fields
PetscInt	Node
struct node *	next

◆ list

struct list

Head of a generic C-style linked list.

Definition at line 469 of file variables.h.

Collaboration diagram for list:

[legend]

Data Fields
node *	head

◆ list_node

struct list_node

A generic C-style linked list node for indices.

Definition at line 474 of file variables.h.

Collaboration diagram for list_node:

[legend]

Data Fields
PetscInt	index
struct list_node *	next

◆ IBMListNode

struct IBMListNode

A linked list node containing IBM interpolation info.

Definition at line 480 of file variables.h.

Collaboration diagram for IBMListNode:

[legend]

Data Fields
IBMInfo	ibm_intp
struct IBMListNode *	next

◆ IBMList

struct IBMList

Head of a linked list for IBM data.

Definition at line 486 of file variables.h.

Collaboration diagram for IBMList:

[legend]

Data Fields
IBMListNode *	head

◆ SurfElmtInfo

struct SurfElmtInfo

Information about a surface element for FSI calculations.

Definition at line 491 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 501 of file variables.h.

Collaboration diagram for FSInfo:

[legend]

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 531 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

◆ LESConfig

struct LESConfig

Every user-selectable parameter of the LES closure.

Resolved once from the generated control file by CreateSimulationContext and read-only thereafter. The model selector itself stays on SimCtx::les, because dispatch and field availability are decided from it throughout the runtime.

Definition at line 629 of file variables.h.

Data Fields
PetscInt	dynamic_frequency	Recompute the dynamic coefficient every N steps.
PetscReal	constant_cs	Fixed Cs for CONSTANT_SMAGORINSKY; unused by the dynamic model.
PetscReal	vreman_coefficient	Model constant c for VREMAN (Vreman 2004: 2.5 Cs^2).
PetscReal	wale_coefficient	Model constant C_w for WALE (Nicoud & Ducros 1999).
LESFilterWidthModel	filter_width_model	How the grid filter width Delta is derived per cell.
LESTestFilterKernel	test_filter_kernel	Discrete test-filter stencil.
PetscReal	test_filter_width_ratio	Test-to-grid ratio per filtered direction; alpha is its square for the box, ratio^(4/3) for Simpson.
LESAveragingMode	averaging_mode	Averaging set for the Germano contractions.
PetscBool	averaging_direction[3]	Averaged-over logical directions (xi, eta, zeta).
LESClipMode	clip_mode	Admissible range for the coefficient.
PetscReal	max_cs	Ceiling on Cs under LES_CLIP_CLAMP.
PetscReal	min_viscosity_ratio	Enforce nu + nu_t >= ratio * nu.
PetscReal	yoshizawa_ci	Yoshizawa constant for the reported SGS kinetic energy.
PetscBool	diagnostics_enabled	Append per-step coefficient statistics to the run log directory.
PetscInt	diagnostics_cadence	Steps between diagnostic rows.

◆ LESDiagnosticsState

struct LESDiagnosticsState

Pre-clipping volume statistics captured by one dynamic-coefficient update.

The backscattering and limited fractions describe the coefficient field as the Germano contraction produced it. Clipping overwrites that state, and no stored field preserves it, so it is recorded here on the way past and consumed by LogLESDiagnostics.

Definition at line 654 of file variables.h.

Data Fields
PetscReal	contraction_lm	Volume-weighted sum of `L_ij M_ij` over fluid cells.
PetscReal	contraction_mm	Volume-weighted sum of `M_ij M_ij` over fluid cells.
PetscReal	backscatter_volume	Fluid volume whose raw coefficient was negative.
PetscReal	limited_volume	Fluid volume whose coefficient the clip modified.
PetscReal	fluid_volume	Total fluid volume sampled.
PetscBool	valid	Set once a dynamic update has populated this state.

◆ WallModelDiagnosticsState

struct WallModelDiagnosticsState

Near-wall statistics captured by one wall-model pass.

The wall model evaluates the wall distance and the friction velocity together at each corrected cell. y+ is the number that says whether the model is being asked to work in the range it is valid for, and it cannot be recovered afterwards from the corrected velocity field, which no longer carries the law that produced it. Recomputing the wall distance in the diagnostic would duplicate geometry the correction already has in hand, so it is accumulated on the way past and consumed by LogWallModelDiagnostics.

Definition at line 672 of file variables.h.

Data Fields
PetscReal	friction_velocity_sum	Sum of `u_tau` over corrected cells.
PetscReal	friction_velocity_sq	Sum of `u_tau^2`, for the RMS.
PetscReal	friction_velocity_min	Smallest `u_tau` this rank corrected.
PetscReal	friction_velocity_max	Largest `u_tau` this rank corrected.
PetscReal	wall_distance_sum	Sum of the first-cell wall distance.
PetscReal	y_plus_sum	Sum of `u_tau * y / nu` over corrected cells.
PetscReal	y_plus_max	Largest first-cell `y+` this rank corrected.
PetscReal	wall_viscosity_sum	Sum of the effective wall eddy viscosity.
PetscInt	cells	Number of cells this rank corrected.

◆ MGCtx

struct MGCtx

Context for Multigrid operations.

Definition at line 728 of file variables.h.

Collaboration diagram for MGCtx:

[legend]

Data Fields
UserCtx *	user
PetscInt	thislevel
DM	packer

◆ UserMG

struct UserMG

User-level context for managing the entire multigrid hierarchy.

Definition at line 735 of file variables.h.

Collaboration diagram for UserMG:

[legend]

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 754 of file variables.h.

Data Fields
char	source_dir[PETSC_MAX_PATH_LEN]
PetscInt	startTime
PetscInt	endTime
PetscInt	timeStep
char	step_list_file[PETSC_MAX_PATH_LEN]	File listing the exact steps to process, one per line; empty uses the time controls.
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.
char	field_statistics_output_prefix[PETSC_MAX_PATH_LEN]	Analysis prefix for CSV summaries; VTK continues to use output_prefix.
PetscBool	dimensionalize	Whether derived output leaves non-dimensional form, from global_operations.dimensionalize.
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 805 of file variables.h.

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

◆ VTKMetaData

struct VTKMetaData

Definition at line 817 of file variables.h.

Collaboration diagram for VTKMetaData:

[legend]

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 840 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 859 of file variables.h.

Collaboration diagram for SimCtx:

[legend]

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	analysis_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	Refused at setup: immersed boundaries and moving bodies are not implemented.
PetscInt	invicid
PetscInt	TwoD
PetscInt	moveframe
PetscInt	rotateframe	moveframe/rotateframe are refused at setup.
char	AnalyticalSolutionType[PETSC_MAX_PATH_LEN]
PetscInt	MHV
PetscInt	LV	Heart-valve flux corrections for immersed bodies; refused at setup.
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_preItr
PetscInt	mg_poItr
PetscInt	poisson
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
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
PetscReal	iem_constant	IEM mixing constant C_IEM in Omega = C_IEM Gamma / Delta^2 (default 2.0).
PetscInt	block_number
PetscInt	inletprofile
PetscInt	i_periodic
PetscInt	j_periodic
PetscInt	k_periodic
PetscInt	pseudo_periodic
PetscBool	generate_grid
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	drivenFluxMeasured
PetscReal	drivenFluxArea
PetscReal	AreaInSum
PetscReal	AreaOutSum
PetscInt	ccc
PetscReal	ratio
PetscInt	les	Active LES closure; an LESModelType value.
PetscInt	wallfunction	Enable wall functions on WALL faces.
PetscInt	les_gradient_model	Add the Clark gradient (tensor-diffusivity) term to the viscous flux.
LESConfig	les_config	Parameters of the LES closure selected by `les`.
PetscInt	np
PetscInt	particleRandomSeed	Base seed for every particle RNG stream (-particle_random_seed).
DM	dm_swarm
BoundingBox *	bboxlist
ParticleInitializationType	ParticleInitialization
InterpolationMethod	interpolationMethod
char	particleRestartMode[16]
PetscInt	particlesLostLastStep
PetscInt	particlesLostCumulative
PetscReal	particlesLostScalarLastStep	Sum of Psi over the particles removed this step.
struct ParticleFieldPlan *	particleFieldPlan	Configured initial particle-field values, or NULL.
PetscInt	migrationPassesLastStep
PetscInt	particlesMigratedLastStep
PetscInt	occupiedCellCount
PetscReal	particleLoadImbalance
SearchMetricsState	searchMetrics
PetscRandom	BrownianMotionRNG
PetscReal	C_IEM
IBMNodes *	ibm
IBMVNodes *	ibmv
FSInfo *	fsi
UserMG	usermg
char	allowedFile[PETSC_MAX_PATH_LEN]
PetscBool	useCfg
char **	allowedFuncs
PetscInt	nAllowed
PetscInt	LoggingFrequency
PetscReal	poissonSourceImbalance
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 1074 of file variables.h.

Collaboration diagram for UserCtx:

[legend]

Data Fields
SimCtx *	simCtx	Back-pointer to the master simulation context.
DM	da
DM	fda
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	Friction_Velocity
Vec	lFriction_Velocity
Vec	Nu_Wall
Vec	lNu_Wall
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
KSP	ksp
MatNullSpace	nullsp
Vec	B
Vec	R
Mat	MR
Mat	MP
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	Distance
LESDiagnosticsState	les_diagnostics	Pre-clipping statistics from the last dynamic update.
WallModelDiagnosticsState	wall_diagnostics	Near-wall statistics from the last wall-model pass.
PetscInt	wall_yplus_excursions	Consecutive diagnostic samples with the first cell outside the selected law's valid y+ range.
IBMNodes *	ibm
IBMList *	ibmlist
PetscInt	thislevel
PetscInt	mglevels
UserCtx *	user_f
UserCtx *	user_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	lQcrit	Cell-centred Q-criterion and its ghosted copy for nodal averaging.
Vec	Qcrit_nodal	Q-criterion averaged to grid nodes; the field a .vts can place correctly.
Vec	Psi_nodal

Macro Definition Documentation

◆ PICURV_RELEASE_VERSION

#define PICURV_RELEASE_VERSION "0.0.0"

Definition at line 32 of file variables.h.

◆ PICURV_GIT_COMMIT

#define PICURV_GIT_COMMIT "unknown"

Definition at line 35 of file variables.h.

◆ PICURV_BUILD_DIRTY

#define PICURV_BUILD_DIRTY "unknown"

Definition at line 38 of file variables.h.

◆ 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 75 of file variables.h.

◆ MAX_PIPELINE_LENGTH

#define MAX_PIPELINE_LENGTH 1024

Definition at line 744 of file variables.h.

◆ MAX_FIELD_LIST_LENGTH

#define MAX_FIELD_LIST_LENGTH 1024

Definition at line 745 of file variables.h.

◆ MAX_FILENAME_LENGTH

#define MAX_FILENAME_LENGTH 256

Definition at line 746 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 748 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 749 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 1066 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 91 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 95 of file variables.h.

◆ BC_Param

typedef struct BC_Param_s BC_Param

Definition at line 96 of file variables.h.

◆ BoundaryCondition

typedef struct BoundaryCondition BoundaryCondition

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

Definition at line 97 of file variables.h.

◆ BoundaryFaceConfig

typedef struct BoundaryFaceConfig BoundaryFaceConfig

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

Definition at line 98 of file variables.h.

◆ IBMNodes

typedef struct IBMNodes IBMNodes

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

Definition at line 99 of file variables.h.

◆ IBMVNodes

typedef struct IBMVNodes IBMVNodes

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

Definition at line 100 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 101 of file variables.h.

◆ UserMG

typedef struct UserMG UserMG

User-level context for managing the entire multigrid hierarchy.

Definition at line 102 of file variables.h.

◆ BoundingBox

typedef struct BoundingBox BoundingBox

Defines a 3D axis-aligned bounding box.

Definition at line 103 of file variables.h.

◆ Cell

typedef struct Cell Cell

Defines the vertices of a single hexahedral grid cell.

Definition at line 104 of file variables.h.

◆ Particle

typedef struct Particle Particle

Defines a particle's core properties for Lagrangian tracking.

Definition at line 105 of file variables.h.

◆ RankNeighbors

typedef struct RankNeighbors RankNeighbors

Stores the MPI ranks of neighboring subdomains.

Definition at line 106 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 107 of file variables.h.

◆ MigrationInfo

typedef struct MigrationInfo MigrationInfo

Information needed to migrate a single particle between MPI ranks.

Definition at line 108 of file variables.h.

◆ Cstart

typedef struct Cstart Cstart

Defines prescribed body motion using splines.

Definition at line 109 of file variables.h.

◆ MGCtx

typedef struct MGCtx MGCtx

Context for Multigrid operations.

Definition at line 110 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 111 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 112 of file variables.h.

◆ VTKMetaData

typedef struct VTKMetaData VTKMetaData

Definition at line 113 of file variables.h.

◆ IBMInfo

typedef struct IBMInfo IBMInfo

Holds interpolation and distance information for a single IBM point.

Definition at line 114 of file variables.h.

◆ SurfElmtInfo

typedef struct SurfElmtInfo SurfElmtInfo

Information about a surface element for FSI calculations.

Definition at line 115 of file variables.h.

◆ ScalingCtx

typedef struct ScalingCtx ScalingCtx

Definition at line 116 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.

◆ SymTensor

typedef struct SymTensor SymTensor

A symmetric second-order tensor stored by its six independent components.

The three missing components are recovered by symmetry: yx == xy, zx == xz, and zy == yz. Contractions must therefore double the off-diagonal terms, which is what SymTensorContract() exists to do in one place instead of at every call site. Used for strain rates and for the Germano identity's Leonard and model tensors.

◆ Cpt2D

typedef struct Cpt2D Cpt2D

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

◆ 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.

◆ LESConfig

typedef struct LESConfig LESConfig

Every user-selectable parameter of the LES closure.

Resolved once from the generated control file by CreateSimulationContext and read-only thereafter. The model selector itself stays on SimCtx::les, because dispatch and field availability are decided from it throughout the runtime.

◆ LESDiagnosticsState

typedef struct LESDiagnosticsState LESDiagnosticsState

Pre-clipping volume statistics captured by one dynamic-coefficient update.

The backscattering and limited fractions describe the coefficient field as the Germano contraction produced it. Clipping overwrites that state, and no stored field preserves it, so it is recorded here on the way past and consumed by LogLESDiagnostics.

◆ WallModelDiagnosticsState

typedef struct WallModelDiagnosticsState WallModelDiagnosticsState

Near-wall statistics captured by one wall-model pass.

The wall model evaluates the wall distance and the friction velocity together at each corrected cell. y+ is the number that says whether the model is being asked to work in the range it is valid for, and it cannot be recovered afterwards from the corrected velocity field, which no longer carries the law that produced it. Recomputing the wall distance in the diagnostic would duplicate geometry the correction already has in hand, so it is accumulated on the way past and consumed by LogWallModelDiagnostics.

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 163 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 172 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 177 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 186 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 287 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 298 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 309 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_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 329 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_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 347 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 subgrid-scale closure evaluated during a timestep.

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

Enumerator
NO_LES_MODEL
CONSTANT_SMAGORINSKY
DYNAMIC_SMAGORINSKY
VREMAN
WALE

Definition at line 548 of file variables.h.

             {
    NO_LES_MODEL = 0,
    CONSTANT_SMAGORINSKY = 1,
    DYNAMIC_SMAGORINSKY = 2,
    VREMAN = 3,
    WALE = 4
} LESModelType;

◆ WallFunctionModel

enum WallFunctionModel

Selects the wall model applied on WALL faces.

The value doubles as the enable switch: WALL_FUNCTION_NONE disables the treatment, and every other value both enables it and names the law. Configured independently of the LES closure.

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

Enumerator
WALL_FUNCTION_NONE
WALL_FUNCTION_LOG_LAW
WALL_FUNCTION_WERNER
WALL_FUNCTION_CABOT

Definition at line 565 of file variables.h.

             {
    WALL_FUNCTION_NONE    = 0,
    WALL_FUNCTION_LOG_LAW = 1,
    WALL_FUNCTION_WERNER  = 2,
    WALL_FUNCTION_CABOT   = 3
} WallFunctionModel;

◆ LESFilterWidthModel

enum LESFilterWidthModel

Selects how a cell's grid filter width is derived from its metrics.

CUBE_ROOT_VOLUME is exact for a cube and progressively underestimates the width as a cell is stretched. The others use the cell's extents along its own grid directions: SCOTTI corrects the cube root for the cell's aspect ratios, and MAX_EDGE takes the longest extent. See ComputeCellFilterWidth.

Enumerator
LES_FILTER_WIDTH_CUBE_ROOT_VOLUME
LES_FILTER_WIDTH_GEOMETRIC_MEAN
LES_FILTER_WIDTH_MAX_EDGE
LES_FILTER_WIDTH_SCOTTI

Definition at line 579 of file variables.h.

             {
    LES_FILTER_WIDTH_CUBE_ROOT_VOLUME = 0,
    LES_FILTER_WIDTH_GEOMETRIC_MEAN   = 1,
    LES_FILTER_WIDTH_MAX_EDGE         = 2,
    LES_FILTER_WIDTH_SCOTTI           = 3
} LESFilterWidthModel;

◆ LESTestFilterKernel

enum LESTestFilterKernel

Selects the discrete test-filter kernel used by the dynamic procedure.

SIMPSON_IK collapses onto the central eta-plane and is valid only when the xi and zeta directions are homogeneous; the ingress layer enforces that.

Enumerator
LES_TEST_FILTER_VOLUME_WEIGHTED_BOX
LES_TEST_FILTER_SIMPSON_IK

Definition at line 591 of file variables.h.

             {
    LES_TEST_FILTER_VOLUME_WEIGHTED_BOX = 0,
    LES_TEST_FILTER_SIMPSON_IK          = 1
} LESTestFilterKernel;

◆ LESAveragingMode

enum LESAveragingMode

Selects the set over which the Germano contractions are averaged.

Lilly's least-squares closure assumes the model coefficient is constant across the averaging set, so the set should span directions in which the flow really is statistically homogeneous. LOCAL makes no such claim and is the only choice valid on arbitrary geometry. HOMOGENEOUS derives its directions from the periodic boundary pairs unless they are named explicitly.

Enumerator
LES_AVERAGING_LOCAL
LES_AVERAGING_HOMOGENEOUS
LES_AVERAGING_GLOBAL

Definition at line 604 of file variables.h.

             {
    LES_AVERAGING_LOCAL       = 0,
    LES_AVERAGING_HOMOGENEOUS = 1,
    LES_AVERAGING_GLOBAL      = 2
} LESAveragingMode;

◆ LESClipMode

enum LESClipMode

Selects the admissible range imposed on the dynamic model coefficient.

NONE keeps the coefficient signed, so subgrid-to-resolved energy transfer (backscatter) survives; stability then rests on the total-viscosity floor rather than on the coefficient's sign. The clipping modes discard the negative tail, which removes backscatter and biases the mean dissipation upward.

Enumerator
LES_CLIP_CLAMP
LES_CLIP_CLIP_NEGATIVE
LES_CLIP_NONE

Definition at line 617 of file variables.h.

             {
    LES_CLIP_CLAMP         = 0,
    LES_CLIP_CLIP_NEGATIVE = 1,
    LES_CLIP_NONE          = 2
} LESClipMode;

◆ 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 692 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 701 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 709 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 722 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 812 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 831 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;

Data Structures

Macros

Typedefs

Enumerations

Detailed Description

Data Structure Documentation

◆ Cmpnts

◆ Cmpnts2

◆ SymTensor

◆ Cpt2D

◆ BCS

◆ BoundingBox

◆ Cell

◆ Particle

◆ RankNeighbors

◆ RankCellInfo

◆ MigrationInfo

◆ VerificationDiffusivityConfig

◆ VerificationScalarConfig

◆ SearchMetricsState

◆ BC_Param_s

◆ BCContext

◆ BoundaryFaceConfig

◆ IBMInfo

◆ IBMNodes

◆ IBMVNodes

◆ node

◆ list

◆ list_node

◆ IBMListNode

◆ IBMList

◆ SurfElmtInfo

◆ FSInfo

◆ Cstart

◆ LESConfig

◆ LESDiagnosticsState

◆ WallModelDiagnosticsState

◆ MGCtx

◆ UserMG

◆ PostProcessParams

◆ VTKFieldInfo

◆ VTKMetaData

◆ ScalingCtx

◆ SimCtx

◆ UserCtx

Macro Definition Documentation

◆ PICURV_RELEASE_VERSION

◆ PICURV_GIT_COMMIT

◆ PICURV_BUILD_DIRTY

◆ COEF_TIME_ACCURACY

◆ MAX_PIPELINE_LENGTH

◆ MAX_FIELD_LIST_LENGTH

◆ MAX_FILENAME_LENGTH

◆ MAX_POINT_DATA_FIELDS

◆ MAX_VTK_FIELD_NAME_LENGTH

◆ mom_dt_rk4_residual_norm_noise_allowance_factor

Typedef Documentation

◆ SimCtx

◆ UserCtx

◆ BC_Param

◆ BoundaryCondition

◆ BoundaryFaceConfig

◆ IBMNodes

◆ IBMVNodes

◆ FSInfo

◆ UserMG

◆ BoundingBox

◆ Cell

◆ Particle

◆ RankNeighbors

◆ RankCellInfo

◆ MigrationInfo

◆ Cstart

◆ MGCtx

◆ PostProcessParams

◆ VTKFieldInfo

◆ VTKMetaData

◆ IBMInfo

◆ SurfElmtInfo

◆ ScalingCtx