Read spray model and injector properties.

particleInterpolationOrder

MInt LPTBase::s_interpolationOrder
default = 2

Choose velocity-interpolation order:

2 Second-order
3 Third-order

Keywords: PARTICLE

s_lengthFactor

MFloat LPTSpherical::s_lengthFactor
default = 1.0

Length factor conversion between the grid reference length as defined by the STL (aka STL-length) to the reference length used in the LPT solver! For numerical reasons and sake of clarity it is advised to use the reference-diameter of the particles (d_p0) as a reference length in the LPT-solver! L_ref / L_grid
Keywords: PARTICLE, NON-DIMENSIONALISATION,REFERENCE-LENGTH

particleInitNoPartperCell

MFloat LPT::particleInitNoPartperCell
default = 0.0

number of particles to be initialized per cell.
It can be a double value not only a MInt, but if it is double, the number of initialized Particle depends on the number of processors in massive parallel concept
Keywords: PARTICLE

particleDiameters

MFloat particleDiameters
default = (0.00001, 0.00002, 0.00003, 0.00004, 0.00005, 0.00006, 0.00007, 0.00008, 0.00009, 0.00010)

diameters of particles.
Keywords: PARTICLE

particleInitRatesOfDiameters

MInt(*) particleInitQuotasOfDiameters
default = 1

quota of particles with associated diameter.
Keywords: PARTICLE

particleInitOffsets

MFloat(*) particleInitOffsets
default = bounding box == no Offsets

provide offsets to restrict particle initialization
Keywords: PARTICLE

particleRandLocWthCell

MBool particleRandomizeLocWthCell
default = true

Randomize the location of the added particles within each cell.
Keywords: PARTICLE

particleInitVelocity

MFloat[dim] particleInitVelocity
default = 0.0, 0.0, 0.0

Velocity of the particles to be initialized.
Keywords: PARTICLE

inflowDir

MInt particleInflowDir
default = 1.0

Defines the inflow direction of particles initialized at the inflow! PARTICLE

particleDiameters

MFloat particleDiameter
default = (0.00001, 0.00002, 0.00003, 0.00004, 0.00005, 0.00006, 0.00007, 0.00008, 0.00009, 0.00010)

diameters of particles.
Keywords: PARTICLE

particleExchangeBufferSize

MInt LPT::m_particleExchangeBufferSize
default = 1000

Specifies the size of the buffer used for transfer between cpus
of particles.
Keywords: PARTICLE

particleSizeLimit

MFloat LPT::m_sizeLimit
default = 1E-12

Remove particles smaller than this size
Keywords: PARTICLE

spawnParticles

MBool LPT::m_spawnParticles
default = false

Spawn particles
Keywords: PARTICLE

sprayPrimaryBUp

MBool LPT::m_activePrimaryBUp
default = false

Activate primary break-up
Keywords: PARTICLE

spraySecondaryBUp

MBool LPT::m_activeSecondaryBUp
default = false

Activate secondary break-up
Keywords: PARTICLE

particleIncludeEllipsoids

MBool LPT::m_particleIncludeEllipsoids
default = false

Exclude (false) or include (true) ellipsoidal particles
in addition to spheres.
Keywords: PARTICLE

particleCollisions

MInt LPT::m_collisions
default = 0

Specify the method for collision detection and execution.
(Note that for ellipsoids the collision detection is different,
it is currently hard-coded as option 6)

Possible values:

0 No collision detection
1 Retroactive detection; elastic collisions
2 Proactive detection; elastic collision
3 Retroactive detection; coagulation
4 Proactive detection; coagulation
5 Retroactive detection; no particle interaction
6 Proactive detection; no particle interaction

Keywords: PARTICLE

particleWallCollisions

MInt LPT::m_particleWallCollisions
default = true

Specify if wall-collisions should be taken into account.

Possible values: true/false
Keywords: PARTICLE

particleInitializationMethod

MInt LPT::m_initializationMethod
default = 0

Choose the method for the particle initialization:

0 Initializes particleInitNoPartperCell particles per cell
1 Initializes particles in the cell center of all inflow cells
2/3 Initializes particles according to the input file part.txt. Specify particle diameter, density and position
4 Same as 2/3 but now specify also particle velocity

Keywords: PARTICLE

particleDrag

MInt LPT::m_dragModelType
default = 1

Choose drag formulation (spheres):

0 No drag force
1 Linear Stokes drag
2 Schiller-Naumann correlation \( f_D = 1 + 0.15 Re^{0.687} \)
3 Pinsky-Khain correlation \( f_D = 1 + 0.17 Re^{0.632} + 10^{-6}Re^{2.25} \)
4 Baumgarten, 2005
4 Rowe, 1961
5 Drag limited to 10% of fluid fraction

Choose drag formulation (ellipsoids):

0 No drag force
1 Linear
2 Schiller-Naumann correlation \( f_D = 1 + 0.15 Re^{0.687} \)
1 Drag correlation for prolates by Konstantin et al. (2020)

Keywords: PARTICLE

particleLift

MInt LPT::m_liftModelType
default = 1

Choose lift formulation:

0 No lift force
2 Linear
1 Lift correlation for prolates by Konstantin et al. (2020)

Keywords: PARTICLE

particleTorque

MInt LPT::m_torqueModelType
default = 1

Choose torque formulation:

0 No torque
1 Linear
1 Torque correlation for prolates by Konstantin et al. (2020)

Keywords: PARTICLE

motionEquation

MInt LPT::m_motionEquationType
default = 0

Choose correctorStep formulation:

0 Motion equation based on the analytical solution of the simplified motion equation under the assumption of constant drag. See Crowe et al., Multiphase Flows with Droplets and Particles, 1998.
1 Non dimensional version based on C. Baumgarten, Mixture formation in internal combustion engines, 2005
2 Particles move with fluid velocity

Keywords: PARTICLE

particleRespawn

MInt LPT::m_particleRespawn
default = false

Specifies whether particles that leave the domain are reintroduced.

0 Particles are not reintroduced
>0 Particles are reintroduced in a plane perpendicular to direction (m_particleRespawn - 1)

Keywords: PARTICLE

particleRespawnPlane

MFloat LPT::m_respawnPlane
default = nullptr

The coordinate plane in which particles are respawned.
Keywords: PARTICLE

particlePartOffset

MFloat LPT::m_xCutOff
default = -1000.0

Specify a lower limit for the x coordinate of particle to be
written. This property is useful to allow for an "relaxation \n distance" for newly introduced particles.
Note that at the default value no limit is used.
Keywords: PARTICLE

particleMomentumCoupling

MBool LPT::m_momentumCoupling
default = false

Activate momentum coupling.
Keywords: PARTICLE

particleHeatCoupling

MBool LPT::m_heatCoupling
default = false

Activate heat coupling.
Keywords: PARTICLE

particleMassCoupling

MBool LPT::m_massCoupling
default = false

Activate mass coupling.
Keywords: PARTICLE

particleEvaporation

MBool LPT::m_evaporation
default = false

Activate evaporation modeling.
Keywords: PARTICLE

maxNoBndryCells

MInt LPT::m_maxNoBndryCells
default = ""

Maximum number of boundary cells to be allocated. (Used for wall-collision)

Any positiv integer

Keywords: LPT, ALLOCATION, BNDRY

particleAdapRange

MFloat cell-range
default = {2.0, 0.0}
Range around particles, which should be refined during adaptation. First value is on maxRefinementLevel, second value is on all lower levels
Keywords: PARTICLE, ADAPTATION

referenceTemperature

MFloat LPT::m_referenceTemperature
default = 273.15

Reference temperature \( T_{\mathrm{ref}}\) Used to scale the Sutherland's constant as follows: \( S/T_{\mathrm{ref}} \) possible values are:

Non-negative floating point values

Keywords: LPT, VARIABLES

sutherlandConstant

MFloat LPT::m_sutherlandConstant
default = 110.4 K

Sutherland's constant. Used by Sutherland's law. possible values are:

Non-negative floating point values

Keywords: LPT, VARIABLES

cfl

MFloat LPT::m_cfl
default = 1.0

Courant number C - Factor of the CFL condition

possible values are:

positive floating point values

Keywords: LPT, TIME_INTEGRATION

timeStepVar

MInt LPT::m_timeStepComputationInterval
default = -1
Specifies on which interval the time-step will be recomputed.

-1 -> default (when restart): never - read from restart file, requires m_restart == true.
0 -> default (when no restart): once at the beginning
1 -> every time-step
2 -> every two time-steps
N -> every Ntime-steps

Keywords: LPT, TIME_INTEGRATION

weightBaseCell

MFloat LPT::m_weightBaseCell
default = 0.0

Weight applied for any lpt-cell during static weight computation for domain decomposition during balance. Keywords: LPT, WEIGHTING, BALANCE

weightBaseCell

MFloat LPT::m_weightBaseCell
default = 0.0

Weight applied for any lpt-cell during static weight computation for domain decomposition during balance, good value could be 0.05. Keywords: LPT, WEIGHTING, BALANCE

weightBaseCell

MFloat LPT::m_weightBaseCell
default = 0.0

Weight applied for any lpt-cell during static weight computation for domain decomposition during balance, good value could be 0.1 Keywords: LPT, WEIGHTING, BALANCE

weightParticle

MFloat LPT::m_weightParticle
default = 0.0

Weight applied for each particle in a lpt-leaf cell during static weight computation for domain decomposition during balance, good value could be 0.1 Keywords: LPT, WEIGHTING, BALANCE

weightSpawnCell

MFloat LPT::m_weightSpawnCell
default = 0.0

Weight applied for the cell holding the injector during static weight computation for domain decomposition during balance, good value could be 5.0 Keywords: LPT, WEIGHTING, BALANCE

weightMulitSolverFactor

MFloat LPT::m_weightMulitSolverFactor
default = 1.0

Multi-solver factor for lpt weight in comparison with the computational load of the other numerical schems -> 1.0 for single solver Keywords: LPT, WEIGHTING, BALANCE

limitWeights

MBool LPT::m_limitWeights
default = false

Weight applied for any lpt-cell during static weight computation for domain decomposition during balance. Keywords: LPT, WEIGHTING, BALANCE

spawnSeed

MLong LPT::m_spawnSeed
default = Default Seed (5489u)

Initialize PRNG with given seed.
Keywords: PARTICLE

particleDiameter

MFloat LPT::m_spawnDiameter
default = 0.00001
REQUIRED
Spawn particles with the given diameter
Keywords: PARTICLE

spawnParticlesInitVelo

MFloat LPT::m_spawnParticlesInitVelo
default = 0
REQUIRED
Spawn particles with the given speed
Keywords: PARTICLE

spawnParticlesCount

MInt LPT::m_spawnParticlesCount
default = 1
REQUIRED
Spawn the given number of particles per time unit
Keywords: PARTICLE

spawnDistSigmaCoeff

MFloat LPT::m_spawnDistSigmaCoeff
default = 1
Sigma coefficient for the normal distribution.
Keywords: PARTICLE

spawnDir

MFloat* LPT::m_spawnDir
default = {1, 0, 0}

Normal vector of the particle spawn direction.
Keywords: PARTICLE

particleEllipsoidRandomOrientation

MInt LPT::m_ellipsoidRandomOrientation
default = 1

if any number unequal 0, ellipoids are initialized with random orientation, if equal 0 b-axis is orientated in x-direction
Keywords: PARTICLE

particleCouplingRedist

MBool LPT::m_couplingRedist
default = false

Activate coupling redistribution.
Keywords: PARTICLE

particleNoRedistLayer

MBool LPT::m_noRedistLayer
default = 1

Activate momentum coupling redistribution area.
Keywords: PARTICLE

spawnCoordinates

MFloat* spawnCoord
default = N/A

Spawn particles in the given coordinate
Keywords: PARTICLE

particleCollOutputStep

MInt LPT::m_outputStep
default = 50

Number of time steps between output of collision data.
Keywords: PARTICLE

particleCollOffset

MFloat LPT::m_offset
default = -1000.0

Specify a lower limit for the x coordinate of a collision to be
detected. This property is useful to allow for an "relaxation \n distance" for newly introduced particles.
Note that at the default value no limit is used.
Keywords: PARTICLE

particleEllipsoidCCD

MFloat LPT::m_particleEllipsoidCCD
default = 1

Specifies if ContinousCollisionDetction (Choi) or DistanceOfClosedApproach is used
Keywords: PARTICLE

particleSubDomainFactor

default = 1

Number of subdomains per coordinate direction for collision detection. Note that each solver is divided separately into the specified number of subdomains per direction, and the subdomains are rectangular divisions of the solver bounding box.
Keywords: PARTICLE

Author: Tim Wegmann

Date: January 2023

injectorNeedleLiftTime

MFloat SprayModel::m_needleLiftTime
default = 0

Dimensionless time for the needle to reach maximum lift (e.g. maximum flow-rate)
Non-dimensionalised by the injection duration(which can also be non-dimensional!) Keywords: PARTICLE, SPRAY

injectorInjectionTime

MFloat SprayModel::m_injDuration
default = 0.00055

Time during which fuel is injected.
Keywords: PARTICLE, SPRAY

injectionCrankAngle

MFloat SprayModel::m_injectionCrankAngle
default = -1

Meaning, injection crank angle is not applied and the injection starts at timeStep zero! Otherwise specify an injection crank-angle, valid values are in the range of 0-720.
Keywords: PARTICLE, SPRAY

sprayPrimRosinRammler

MInt SprayModel::m_primRosinRammler
default = true

Use Rosin-Rammler distribution to determine initial droplet size.
Keywords: PARTICLE

injectorType

MFloat SprayModel::m_injectorType
default = single-hole fullCone injector

Specific typ of injector to be used for the simulation, falls into the following categories: single-hole, multi-hole,hollow-cone
Options are: "FULLCONE", "HOLLOWCONE", "MULTIHOLE", "MULTIHOLE_OPT" Keywords: PARTICLE, SPRAY

injectorNozzleDiameter

MFloat SprayModel::m_injectorNozzleDiameter
default = NA

Injector exit diameter
Keywords: PARTICLE, SPRAY

injectorDiameter

MFloat SprayModel::m_injectorDiameter
default = NA

Diameter of multi-hole injector. If specified as an array, the radius to the central injector point can be specified for individually for each hole..
Keywords: PARTICLE, SPRAY

injectorOrificeAngle

MFloat SprayModel::m_injectorOrificeAngle
default = NA

Orientation angle of the individual orifices in degree. default = 37 degree (spray-G injector) Keywords: PARTICLE, SPRAY

orificePositionAngle

MFloat SprayModel::m_orificePositionAngle
default = NA

Orientation angle of the individual orifices in degree. default = number-holes/360 degree (spray-G injector) Keywords: PARTICLE, SPRAY

injectorOrficeSize

MFloat SprayModel::m_injectorOrficeSize
default = NA

Injector outer orfices size of the injector
Keywords: PARTICLE, SPRAY

RosinRammlerSpread

MFloat SprayModel::m_RosinRammlerSpread
default = 3

Spread of Rosin-Rammler distribution function
Keywords: PARTICLE, SPRAY

RosinRammlerMin

MFloat SprayModel::m_RosinRammlerMin
default = 90

Factor of nominal nozzle diameter for Rosin-Rammler min distribution parameter
Keywords: PARTICLE, SPRAY

injectorNozzleDiameter

MFloat SprayModel::m_RosinRammlerMax
default = 5

Factor of nominal nozzle diameter for Rosin-Rammler max distribution parameter
Keywords: PARTICLE, SPRAY

injectorNozzleDiameter

MFloat SprayModel::m_RosinRammlerMean
default = 15

Factor of nominal nozzle diameter for Rosin-Rammler mean distribution parameter
Keywords: PARTICLE, SPRAY

spawnDistSigmaCoeff

MFloat SprayModel::m_injectionDistSigmaCoeff
default = 1
Sigma coefficient for the normal distribution.
Keywords: PARTICLE

partEmittDist

MInt SprayModel::m_partEmittDist
default = None

Distributes particles according to a given distribution
Keywords: PARTICLE

injectionSpeed

MFloat SprayModel::m_injectionSpeed
default = NA

Injection speed
Keywords: PARTICLE, SPRAY

sprayInjectionRate

MFloatTensor SprayModel::m_injectionRateList
default = NA

Time variable injection rate
Keywords: PARTICLE, SPRAY

sprayInjectionTiming

MFloatTensor SprayModel::m_injectionTimings
default = NA

Time of provided injection rate
Keywords: PARTICLE, SPRAY

injectorDir

MFloat* SprayModel::injectorDir
default = {0, 0, 1}

Normal vector of the injector direction.
Keywords: PARTICLE

sprayPrimaryMaxPrimParcels

MInt SprayModel::m_maxNoPrimParcels
default = 1

Set the maximum number (and spawn locations) of parcels generated per time step.
Keywords: PARTICLE

sprayPrimaryParcelsPerInj

MInt SprayModel::m_primParcelsPerInj
default = 1000000

Number of parcels to be generated per injection
Keywords: PARTICLE

injectorAngularGap

default = -1

Injector angular gap which can be used as a condition for the primary breakup.
-1 Meaning that the angularGap is not used! Keywords: PARTICLE, SPRAY

sprayPrimaryBUpParcelSize

MInt SprayModel::m_primBrkUpParcelSize
default = 1
Activate primary break-up.
Valid values:
Any positive integer values.
Keywords: PARTICLE

model configuration properties

spawnSeed

MLong LPT::m_spawnSeed
default = Default Seed (5489u)

Initialize PRNG with given seed.
Keywords: PARTICLE

sprayBUPEventOutput

MInt SprayModel::m_secBUDisplayMessage
default = false

Activate break-up event output
Keywords: PARTICLE

predictivePRNG

MBool SprayModel::m_predictivePRNG
default = true

Trigger a predictive PRNG which is independend of the number of used Ranks and particle ordering! However, in this case the PRNG needs to be initialised each time before generating a number for the secondary Breakup. This is computationally very expensive and thus not recommended for large production runs!
Keywords: PARTICLE, SPRAY

secondaryBreakup

MFloat SprayModel::m_sprayAngleKH
default = 1

Defines spray angle descripting for KH-secondary break-up. Options: -1: const. property based spray angle 2: const. property based spray angle with near nozzle correction 0-1: calculated spray angle with A1 value given by secSprayAngleMode!
Keywords: PARTICLE, SPRAY

sprayWeberLimitRT

MFloat SprayModel::m_weberLimitRT
default = 300

KHRT-model property
Keywords: PARTICLE, SPRAY

sprayB0

MFloat SprayModel::m_B0
default = 0.61

KHRT-model property
Keywords: PARTICLE, SPRAY

sprayB1

MFloat SprayModel::m_B1
default = 40

KHRT-model property
Keywords: PARTICLE, SPRAY

sprayC3

MFloat SprayModel::m_c3
default = 0.1

KHRT-model property
Keywords: PARTICLE, SPRAY

sprayCT

MFloat SprayModel::m_CT
default = 1.0

KHRT-model property
Keywords: PARTICLE, SPRAY

sprayWeberLimitKH

MFloat SprayModel::m_weberLimitKH
default = 6

KHRT-model property
Keywords: PARTICLE, SPRAY

voumeKHLimit

MFloat SprayModel::m_massLimit
default = 0.03

KHRT-model property
Dimensionless mass fraction of shedded particle to particle
Keywords: PARTICLE, SPRAY

sprayMaxRTChilds

MInt SprayModel::m_maxRTChildParcels
default = 3

Maximum number of parcels generated by RT
Keywords: PARTICLE, SPRAY

sprayRTDiameterMode

MInt SprayModel::m_
default = 0

Choosen version of RT child diameter
0: use RT-diameter 1: use d_old^(2/3)* d_RT^(1/3) 2: use Rosin-Rammer distribution function for the diameter Keywords: PARTICLE, SPRAY

sprayCbu

MFloat SprayModel::m_Cbu
default = m_B1/2

KHRT-model property
Model parameter for liquid breakup length Keywords: PARTICLE, SPRAY