AcuTrace User-Defined Functions Manual

Instructions to define additional solution quantities of AcuTrace called user equations.

AcuTrace is a particle tracer that runs as a post-processor to or a co-processor with AcuSolve. AcuTrace computes particle traces as a series of segments using a fifth-order time-discontinuous Galerkin (TDG) method with error control for solving ordinary differential equations. AcuTrace typically solves for particle position and, optionally, particle stretch.

The user equations are governed either by evolution equations of the form(1)

or by evaluation equations of the form(2)

where ${\stackrel{\rightharpoonup }{s}}_p$ is the set of user defined particle variables in the current equation, ${\stackrel{\rightharpoonup }{S}}_p$ is the set of user defined variables from the other user equations (if any), ${\stackrel{\rightharpoonup }{U}}_f$ is the set of flow variables, and ${\stackrel{\rightharpoonup }{V}}_{udf}$ is the set of user equation parameters. User-defined functions are used to define the right hand side of these additional evolution and evaluation equations.

User-Defined Functions in AcuTrace are referred to as UFPs (for User-Defined Function Particle) to differentiate them from the UDFs used in AcuSolve.

Any number of user-defined functions may be used in a given problem. As further explained below, the user defined functions are compiled and linked into one or more dynamic shared libraries. The script acuMakeLib on Unix/Linux machines and acuMakeDll on Windows machines may be used for this purpose. A list of these libraries is then given to AcuTrace via the configuration option user_libraries. The solver then sequentially searches through these libraries for the user-defined functions referenced in the input file.