User manual

What each screen asks for, what it gives back, and the conventions that apply everywhere in the application.

How the application is arranged

One screen answers one question. The sidebar groups the nineteen screens into four families; picking one opens it directly, and the application starts on a usable stoichiometric methane–air case rather than an empty document. There is nothing to create, nothing to save, and no library to manage — the state of a screen is whatever is typed into it, and it lasts as long as the window is open.

This manual is a reference rather than a tutorial. Each screen's entry is self-contained; nothing later depends on anything earlier except the conventions in the next section. If you want to know why a screen computes what it does rather than how to drive it, the theory manual is the companion to this one and has an entry for every screen here.

Conventions that apply on every screen

Typing a number

Entering a field selects what is already there, so typing replaces the value rather than appending to it. Part-typed numbers such as -, 1. or 1e are allowed to sit in the field while you finish them; they are neither rejected nor submitted until they are complete.

Invalid input is refused, not repaired. A value outside the domain is rejected with the reason beside the field, and the previous value stays in use; it is never silently turned into zero or clamped into range. A calculation that quietly used a number you did not type is worse than one that refuses to run, because the first kind produces a plausible answer and the second kind produces none.

Digits

Screens show four significant figures, which is what stays readable and is what the printed tables this application replaces carry. Counts — a solver's iteration count, for instance — are shown as whole numbers, because there is no such thing as half an iteration and two decimal places there would assert a precision that does not exist.

Export writes seventeen significant figures, which is the shortest count that reproduces a double-precision number exactly. A value taken out as CSV and read back into a spreadsheet is bit for bit the value that was on the screen, not a rounded copy of it.

Units

Everything is computed in SI internally; conversion happens only at the boundary, where you type and where the result is displayed. Each field states its own unit and each result carries the unit it is reported in. Nothing in the application has a unit system that switches, because a unit switch is a class of defect that testing finds late and users find first.

Where a relation has more than one solution

Both are shown. Strong and weak branches, ignition and extinction turning points, frozen and equilibrium flame temperature — the application does not choose one for you, because which one applies is a property of your problem and not of the arithmetic. Where a modelling choice genuinely has to be made, it is a visible control on the screen with the reason the options differ printed beside it. A control offering two names and no reason is a control the reader takes the first item from.

What each screen tells you about itself

Every screen carries the relation it evaluates and, under Relation and assumptions, the same theory material this application's theory manual contains: what the relation assumes, how it is solved, where it stops applying, and how accurate the answer is known to be. Screens with a stated limitation also carry a standing, non-dismissible note of it. The limits of a model are part of its answer.

Exporting

Export CSV in the toolbar writes the conditions, the results and the stated limitations as one file at seventeen significant figures. Charts have their own PNG and PDF buttons: PNG at 2× for a report, PDF as true vector for typesetting. Every export carries the conditions it was computed under and the version that produced it — a curve with no stated conditions cannot be checked by anyone, including the person who exported it.

Licences

About & Licences at the foot of the sidebar shows the version, what data is bundled, and the full licence and NOTICE for that data.

Contents

Thermochemistry

Everything in this family rests on the same thermodynamic data and the same idea: that a chemical state can be described by enthalpies and entropies which are functions of temperature alone, tabulated once and reused. The screens differ in what they hold fixed. Stoichiometry holds the chemistry fixed and asks what the proportions are; heating value holds the temperature fixed and asks what the energy difference is; the flame temperature screens hold the energy fixed and solve for temperature; equilibrium holds temperature and pressure fixed and solves for composition. A reader who follows that thread will find the four screens are one calculation entered from four sides.

Stoichiometry

MOD-01

Equivalence ratio, air–fuel ratio and the soot threshold for a C–H–O–N fuel.

You provide

SymbolMeaningUnit
xCarbon atoms in the fuel molecule—
yHydrogen atoms in the fuel molecule—
zOxygen atoms in the fuel molecule—
wNitrogen atoms in the fuel molecule—
—Air modeltextbook 21/79, or CEA standard dry
A/FAir–fuel ratio of the mixture you are asking aboutkg/kg

It reports

SymbolMeaningUnit
φEquivalence ratio—
Φ̃Normalised equivalence ratio—
aStoichiometric oxygen requirementmol O₂/mol fuel
(A/F)stStoichiometric air–fuel ratiokg/kg
—Stoichiometric air per fuelmol/mol
MFuel molar massg/mol
φSoot threshold equivalence ratio—

Choices you have to make

Settled without asking

Reading the result

The soot threshold is the quantity most often misread here. It is a purely stoichiometric estimate — the equivalence ratio at which oxygen runs out for the carbon-to-CO route — and it is not a measured sooting limit. Real flames begin to soot well before it, because soot forms in locally rich regions long before the mixture as a whole is that rich, and because the kinetics of soot inception have nothing to do with this calculation. Treat it as an upper bound on where sooting could conceivably be avoided, not as a prediction of where it starts.

The second common misreading is comparing an equivalence ratio computed here against one from another source without checking which air model each used. A 0.4% difference in the molar mass of air moves the stoichiometric air–fuel ratio by the same fraction, which is small enough to look like rounding and large enough to matter when you are checking a number to four figures.

Heating Value

MOD-02

Heat of reaction, and the lower and higher heating values of a fuel.

You provide

SymbolMeaningUnit
—Species namemust match the data file exactly
xCarbon atoms—
yHydrogen atoms—
TTemperature at which the reaction is evaluatedK

It reports

SymbolMeaningUnit
LHVLower heating valuekJ/mol
HHVHigher heating valuekJ/mol
LHVLower heating value on a mass basisMJ/kg
ΔHfFormation enthalpy at 298.15 KkJ/mol
cpMolar heat capacity at the stated temperatureJ/(mol·K)

Settled without asking

Reading the result

Which of the two values to use is decided by the application, not by the fuel. If the exhaust leaves above the dew point — almost every engine, furnace and turbine — the water leaves as vapour and its latent heat is never recovered, so the lower value is the one that describes what you got. A condensing boiler recovers part of it and sits between the two. Quoting an efficiency against the lower value and comparing it against someone else's efficiency quoted against the higher one produces a difference of ten per cent that is entirely an artefact of the convention.

The mass-basis value is the one to compare across fuels of different molar mass; the molar value is the one to use in an energy balance where you are tracking moles. Hydrogen and methane rank in opposite orders on the two bases, which is the clearest illustration that the choice of basis is not cosmetic.

Flame Temperature — Frozen

MOD-04

Adiabatic flame temperature with a fixed product composition.

You provide

SymbolMeaningUnit
—Fuel species—
xCarbon atoms—
yHydrogen atoms—
φEquivalence ratio—
T₁Initial temperature of the reactantsK
—Air model—
—Rich product ruleonly when φ > 1

It reports

SymbolMeaningUnit
TadFrozen adiabatic flame temperatureK
TadEquilibrium value, computed alongsideK
ΔTDissociation penaltyK
nProduct moles per mole of fuelmol

Choices you have to make

Settled without asking

Reading the result

This number is an upper bound and should be read as one. It is the temperature a flame would reach if nothing dissociated, nothing leaked heat, and the reaction went to completion; a measured flame temperature below it is not evidence of an error. The quantity worth looking at is not the frozen value alone but the gap between it and the equilibrium value shown beside it, which is labelled the dissociation penalty. For a hydrocarbon in air near stoichiometric that gap is of order a hundred kelvin and grows quickly with temperature, because dissociation is itself strongly temperature dependent.

The frozen value peaks exactly at stoichiometric. The equilibrium value does not — it peaks slightly rich — and the difference between those two statements is visible on the sweep chart. If you are using the peak location to infer anything about a real burner, the equilibrium curve is the one to read.

Stated on the screen

Product composition does not dissociate; the temperature is therefore an upper bound.

Equilibrium Composition

MOD-05

Equilibrium mole fractions at a given temperature and pressure.

You provide

SymbolMeaningUnit
CCarbon atoms availablemol
HHydrogen atoms availablemol
OOxygen atoms availablemol
NNitrogen atoms availablemol
TTemperatureK
pPressureatm

It reports

SymbolMeaningUnit
XjMole fraction of each of the ten product species—
—Iterations taken—
—Largest element residualmol

Settled without asking

Reading the result

The two numbers under the solver heading are not decoration. The iteration count tells you whether the problem was easy or marginal; the largest element residual tells you how exactly atoms were conserved in the answer you are looking at. A residual many orders of magnitude below the element inventory means the composition is trustworthy to well beyond the four figures shown. If it is not, that is visible rather than assumed — which is the point of putting it on the screen.

Equilibrium is a limit, not a prediction. It says where the mixture would end up given unlimited time at that temperature and pressure. A flame with a millisecond of residence time may be nowhere near it, particularly for nitric oxide, whose formation is slow enough that measured concentrations in real devices are routinely far below the equilibrium value shown here. Reading the NO mole fraction as an emissions prediction is the single most common way to misuse this screen.

Stated on the screen

Gas phase only. Condensed species are not considered, so soot-forming rich mixtures are incomplete.

Flame Temperature — Equilibrium

MOD-06

Adiabatic flame temperature with a dissociating product composition.

You provide

SymbolMeaningUnit
—Fuel species—
xCarbon atoms—
yHydrogen atoms—
φEquivalence ratio—
T₁Initial temperatureK
pPressureatm
—Air model—
—Product species considered—

It reports

SymbolMeaningUnit
TadEquilibrium adiabatic flame temperatureK
XjProduct composition at that temperature—
nProduct moles per mole of fuelmol

Choices you have to make

Settled without asking

Reading the result

This value and the frozen value bracket the real adiabatic flame temperature from below and above. That bracket is the reading, more than either endpoint is: a measurement inside it is consistent with both models, and a measurement outside it means something in the problem statement is wrong — usually heat loss, which pushes the real value below the equilibrium bound.

The verification worth knowing about: this screen's results were checked case by case against NASA's own published CEA output. The largest deviation appears in the hydroxyl mole fraction and is explained quantitatively by a known revision to OH's formation enthalpy between the data sets — that is, it is accounted for rather than absorbed into a tolerance wide enough to hide it. A deviation with a name is a different thing from a deviation within a bound.

Stated on the screen

Gas phase only.

The set of product species is a choice: different sets give different answers.

Combustion Waves

These three screens describe the same object — a thin, steady, one-dimensional wave with heat release — from three directions. The Hugoniot screen draws the locus of all end states reachable from a given initial state and asks which of them a given wave speed selects. The Chapman–Jouguet screen asks which wave speed makes that selection degenerate, which is what picks out the self-sustaining detonation. The von Neumann screen looks inside the wave at the shocked state before the heat has been released. The conservation laws are identical in all three; only the unknown moves.

Hugoniot Explorer

MOD-07

Rayleigh line, Hugoniot curve, and which of the seven regions a wave falls in.

You provide

SymbolMeaningUnit
P₁Unburned pressureatm
T₁Unburned temperatureK
RSpecific gas constantJ/(kg·K)
qHeat release per unit mass of mixtureMJ/kg
γ₁Specific heat ratio, unburned—
γ₂Specific heat ratio, burned—
Ma₁Upstream Mach number—
λReaction progress0 to 1

It reports

SymbolMeaningUnit
xSpecific volume ratio, strong and weak solutions—
yPressure ratio, strong and weak solutions—
Ma₂Downstream Mach number—
P₂Downstream pressurekPa
T₂Downstream temperatureK
—Which of the seven regions each solution falls in—

Choices you have to make

Settled without asking

Reading the result

Both solutions are shown because both satisfy the conservation laws, and deciding between them is not something the arithmetic can do. The strong solution has a higher pressure ratio and a subsonic downstream Mach number; the weak solution has a lower pressure ratio and a supersonic one. Which occurs in a real device depends on the downstream boundary condition — what the flow runs into — and that is information this screen does not have. A calculation that silently returned one of them would be answering a question you had not asked.

The region labels are worth reading before the numbers. A solution sitting in the region marked impossible is telling you that the combination of inputs does not describe a wave, even though the algebra produced values for it. And when the screen reports no intersection, that is the honest answer: at that Mach number, with that heat release, no steady wave exists. Reading it as a failure of the calculation rather than a statement about the physics is the most common misreading here.

Chapman–Jouguet

MOD-08

The tangency solution: detonation and deflagration wave speeds and end states.

You provide

SymbolMeaningUnit
P₁Unburned pressureatm
T₁Unburned temperatureK
RSpecific gas constantJ/(kg·K)
qHeat release per unit massMJ/kg
γ₁Specific heat ratio, unburned—
γ₂Specific heat ratio, burned—
λReaction progress—

It reports

SymbolMeaningUnit
Ma₁CJ detonation Mach number—
DCJ detonation wave speedm/s
yCJ detonation pressure ratio—
Ma₁CJ deflagration Mach number—
—CJ deflagration wave speedm/s
—CJ deflagration pressure ratio—

Settled without asking

Reading the result

The CJ detonation speed is the quantity most often compared against measurement, and it usually agrees well — often within a few per cent — which is remarkable for a model containing no chemistry at all. That agreement rests entirely on the heat release you supplied being the right one. Supplying a heating value instead of the heat release per unit mass of mixture is the commonest error, and it inflates the answer substantially: the heating value is per unit mass of fuel, and a stoichiometric hydrocarbon-air mixture is mostly air.

The deflagration branch is a mathematical companion rather than a description of an ordinary flame. Real laminar flames propagate at a metre or two per second, far below even the CJ deflagration speed, and are governed by diffusion and chemistry rather than by this tangency condition. The CJ deflagration is an upper limit on a subsonic combustion wave, not a prediction of one.

Stated on the screen

Frozen composition: the heat release is an input, not derived from equilibrium.

von Neumann State

MOD-09

The state behind the leading shock, overdrive factor and induction length.

You provide

SymbolMeaningUnit
P₁Unburned pressureatm
T₁Unburned temperatureK
γ₁Specific heat ratio, unburned—
Ma₁Upstream Mach number—

It reports

SymbolMeaningUnit
pN/p₁Pressure ratio across the leading shock—
TN/T₁Temperature ratio across the leading shock—
MaNMach number immediately behind the shock—
TNTemperature immediately behind the shockK

Settled without asking

Reading the result

Read this as the peak, not the end state. The sequence is: the gas crosses the leading shock and reaches the von Neumann pressure; it then reacts, and the pressure falls along the Rayleigh line to the Chapman–Jouguet value. If you are sizing something for a detonation load, the von Neumann pressure is the transient peak and the CJ pressure is what follows it — and a design based on the CJ value alone has underestimated the peak by roughly a factor of two.

The temperature behind the shock is what actually initiates the reaction, which is why it is reported. An ignition delay evaluated at the initial temperature rather than at this one will be wrong by orders of magnitude, because the delay depends exponentially on temperature and this temperature is several times the initial one.

Stated on the screen

The ignition delay has no default value and must be supplied.

Laminar Flames & Limits

A laminar flame is a balance between diffusion carrying heat and radicals forward and chemistry consuming reactants. Every screen in this family is a consequence of that balance being tipped one way or another: by activation energy, by heat loss to a wall, by stretch, by residence time. They share a single structural feature — a large activation energy, which makes the reaction rate change by orders of magnitude over a temperature range in which everything else barely moves. That is what produces thresholds rather than gradual transitions, and it is why so many of these screens report a critical value rather than a curve.

Laminar Flame Speed

MOD-10

Asymptotic solution, and scaling a measured flame speed to other conditions.

You provide

SymbolMeaningUnit
Z′Pre-exponential factor, zero-order formkg/(m³·s)
EActivation energyJ/mol
a₀Initial reactant mass concentrationkg/m³
λThermal conductivityW/(m·K)
ρ₀Unburned densitykg/m³
cpSpecific heatJ/(kg·K)
TfFlame temperatureK
T₀Unburned temperatureK
LeLewis number—
S_LMeasured flame speed at the reference conditionm/s
nOverall reaction order—

It reports

SymbolMeaningUnit
S_LFlame speedm/s
f°Mass burning fluxkg/(m²·s)
—Mass flux corrected for the Lewis numberkg/(m²·s)
—Ratio of the scaled speed to the reference—
—Pressure exponent for the speed and for the mass flux—

Choices you have to make

Settled without asking

Reading the result

No default is offered for the pre-exponential factor or for the overall reaction order, and that is deliberate rather than an omission. Any number placed in either field would be read as a property of combustion rather than as a fit to a particular mixture, and the second one has a worse trap: an overall order of exactly two makes the pressure dependence vanish. Offering two as a convenient default would hand a reader a pressure-independent flame speed and no indication that they had been given one.

The mass burning flux, not the speed, is the intrinsic quantity. The speed depends on the unburned density and therefore on pressure and preheat temperature in ways that have nothing to do with the chemistry; the flux does not. When comparing two conditions, or applying the Lewis correction, work with the flux and convert at the end. This is also why the Lewis correction is applied to the flux here rather than to the speed, which is where some presentations put it.

Stated on the screen

The pre-exponential factor and the overall reaction order have no default values: both depend on the mixture.

Flame Scales

MOD-11

Zeldovich and Lewis numbers, preheat and reaction zone thickness, mass burning flux.

You provide

SymbolMeaningUnit
EActivation energyJ/mol
T_bBurned gas temperatureK
T_uUnburned gas temperatureK
S_LLaminar flame speedm/s
ρ_uUnburned densitykg/m³
αThermal diffusivitym²/s
DMass diffusivitym²/s

It reports

SymbolMeaningUnit
ZeZeldovich number—
LeLewis number—
ArArrhenius number—
σExpansion ratio—
ℓ_DPreheat zone thicknessmm
ℓ_RReaction zone thicknessμm
f°Mass burning fluxkg/(m²·s)

Settled without asking

Reading the result

The Lewis number here is defined as thermal diffusivity over mass diffusivity. The reciprocal convention exists and is used in parts of the literature, and under it every statement about stability reverses: a value of 0.8 becomes 1.25 and a diffusively unstable mixture reads as a stable one. If you are comparing against a published value, check which way that source defines it before concluding anything. This is stated on the screen beside the input for the same reason.

The thicknesses are order-of-magnitude quantities. They are computed from constant properties in a flame where the density changes by a factor of six or seven, so a result of 0.05 mm means tens of microns to a hundred, not fifty microns to two significant figures. Their ratio is more reliable than either value, because the property errors largely cancel.

Flammability Limits

MOD-12

Le Chatelier mixing rule and the Burgess-Wheeler limit temperature law.

You provide

SymbolMeaningUnit
(LFL)ALean limit of fuel Avol %
(LFL)BLean limit of fuel Bvol %
XAMole fraction of A among the fuels—
ΔHcHeat of combustionkcal/mol
CBurgess–Wheeler constantkcal/mol

It reports

SymbolMeaningUnit
(LFL)mixLean limit of the mixturevol %
(LFL)Predicted lean limit from the heat of combustionvol %

Settled without asking

Reading the result

These are measurements wearing the clothes of constants, and the screen carries a permanent, non-dismissible panel saying so. They depend on tube diameter, on ignition energy, on whether the flame propagates upward or downward, and on ambient temperature. A published limit without those conditions attached is incomplete, and comparing two such numbers is comparing two experiments.

Where two sources transcribing the same underlying report disagree — methane's rich limit is printed as 14.9 in one and 15.0 in the other — both are kept rather than averaged. Averaging two transcriptions of one measurement invents a third number that nobody measured, and buries the fact that the disagreement exists. If a decision turns on the difference between 14.9 and 15.0, that decision needs the original report, not this screen.

Stated on the screen

Published limits are measurements, not material constants: two sources disagree on methane by 0.7%.

Thermal Explosion

MOD-13

Semenov criterion, critical temperature rise, and Frank-Kamenetskii critical size.

You provide

SymbolMeaningUnit
T₀Ambient temperatureK
EActivation energyJ/mol
—Vessel geometrysphere, cylinder or slab
QHeat of reactionJ/kg
ρDensitykg/m³
APre-exponential factor1/s
λThermal conductivityW/(m·K)

It reports

SymbolMeaningUnit
ΔTcCritical temperature riseK
TcCritical temperatureK
—Reaction rate at criticality× the ambient rate
—Critical sizemm

Choices you have to make

Settled without asking

Reading the result

The critical temperature rise is small — of order twenty or thirty kelvin for a typical activation energy at a few hundred kelvin — and that smallness is the whole point. Ignition is not a slow climb to a high temperature: the steady state is lost within that narrow rise, and after it there is no steady state to return to. A body observed to be twenty kelvin above ambient is not comfortably warm; it may be at the edge.

The critical size is a stability boundary, not a safe size. It is computed for a perfectly uniform body at a fixed ambient temperature with no reactant consumption and no convection, and every one of those idealisations moves the real boundary. Use it to understand how the boundary scales — with the square root of conductivity, inversely with the square root of the rate — rather than as a number to design a store to.

Stirred Reactor

MOD-14

The S-curve: ignition and extinction turning points of a well-stirred reactor.

You provide

SymbolMeaningUnit
T_inInlet temperatureK
T_adAdiabatic temperatureK
EActivation energyJ/mol

It reports

SymbolMeaningUnit
T_ignIgnition temperatureK
Da_ignDamköhler number at ignition—
T_extExtinction temperatureK
Da_extDamköhler number at extinction—

Settled without asking

Reading the result

The Damköhler numbers here span many decades and only their ratio carries meaning. The definition folds the pre-exponential factor into the group, so the absolute value depends on a kinetic constant that was never entered; comparing one of these numbers against a value from another source without checking that both used the same definition will produce nonsense.

With a one-step reaction and a cold inlet the ignition branch sits at an enormous Damköhler number, and that is not an artefact. Such a mixture really is essentially inert at the inlet temperature — a one-step Arrhenius rate at 300 K with a combustion activation energy is vanishingly small, so an absurdly long residence time would be needed to ignite it. Real mixtures ignite far earlier through chain branching, which builds radical pools at temperatures where the one-step rate is still negligible. The model is not wrong; it is answering a question about a mixture that does not chain-branch.

What the screen is genuinely good for is the hysteresis. Once burning, the reactor keeps burning over a range of residence times in which it could never have ignited, and that gap is why a combustor can be stable in operation yet hard to light.

Stated on the screen

Solved with temperature as the independent variable: the turning points have a vertical tangent in the other direction.

Flame Stretch

MOD-15

Markstein length, stretched flame speed, and the stretch rate at extinction.

You provide

SymbolMeaningUnit
s°Unstretched flame speedm/s
LMarkstein lengthm
κStretch rate1/s
δFlame thicknessm

It reports

SymbolMeaningUnit
sStretched flame speedm/s
KaKarlovitz number—
κ_extStretch rate at extinction1/s
—Speed ratio at extinction—

Settled without asking

Reading the result

The sign convention is the thing to get right, and it is the easiest thing to get wrong. This app uses the stretch-rate convention with a plus sign, so a negative Markstein length means stretch slows the flame — which is the case for lean hydrogen and for mixtures with a Lewis number below one. Sources using the curvature convention carry the opposite sign for the same physical situation. A Markstein length copied from a paper without checking its convention will produce a flame that speeds up when it should slow down, and nothing in the numbers will look wrong.

The extinction stretch rate should be read as an order of magnitude. It comes from a linear response extrapolated to the point where the linearity has certainly failed, which is a standard and useful thing to do but not a precise one.

Quenching Distance

MOD-20

Quenching distance, minimum ignition energy, and their pressure scaling.

You provide

SymbolMeaningUnit
UBurning velocitym/s
dQuenching distance at the reference pressuremm
αThermal diffusivitym²/s
pTarget pressureatm

It reports

SymbolMeaningUnit
U·dVelocity–distance productcm²/s
PeQuenching Peclet number—
dQuenching distance at the target pressuremm
—Equivalent parallel-plate spacingmm

Settled without asking

Reading the result

The reference table in this screen deserves a note. It holds independent measurements of quenching distance and minimum ignition energy. The same published report also carries an extrapolated column, and that column is deliberately not offered here as a check — its distances were read off a curve from the ignition energies, so the two columns are not independent of one another. Using one to verify the other would be circular, and the circularity would not be visible in the numbers.

That point generalises. When this screen's cube-law relationship between energy and distance is tested against the independent samples, the spread is real; tested against the extrapolated ones it would look tighter, and the tightness would be an artefact of how the data were produced rather than evidence about the physics. A correlation checked against data derived from the correlation always looks good.

Stated on the screen

Quenching distance depends on the apparatus geometry. It is not a material constant.

In the extrapolated data the distance was read off a curve from the ignition energy: the two columns are not independent.

Non-premixed & Turbulent

When fuel and oxidiser arrive separately, mixing becomes the rate-limiting step and the useful coordinate stops being distance and becomes a conserved scalar. Three of these four screens are consequences of that change of variable; the fourth supplies the transport properties the other three need. The unifying assumption is that all species diffuse at the same rate — which is what makes a single scalar sufficient, and which is also the assumption most likely to be the one that fails.

Mixture Fraction

MOD-16

Mixture fraction, its stoichiometric value, and the Burke-Schumann flame structure.

You provide

SymbolMeaningUnit
xCarbon atoms—
yHydrogen atoms—
zOxygen atoms—
Y_F,1Fuel mass fraction in the fuel stream—
Y_O,2Oxygen mass fraction in the oxidiser stream—
ZMixture fraction at the point of interest—

It reports

SymbolMeaningUnit
Z_stStoichiometric mixture fraction—
νStoichiometric mass ratiokg O₂/kg fuel
φEquivalence ratio at this mixture fraction—
Y_FFuel mass fraction—
Y_OOxygen mass fraction—

Settled without asking

Reading the result

The stoichiometric mixture fraction being small — around 0.05 for a hydrocarbon in air — is the single most useful number here, and it has a physical reading: the flame sheet sits where the mixture is 95% oxidiser by mass. That is why a diffusion flame's luminous region hugs the air side of the mixing layer, and why fuel-side phenomena such as soot formation happen in a region that is nowhere near the flame sheet.

The exactly-zero mass fraction is a property of the limit, not a rounding. If you are comparing against a computation with finite-rate chemistry, both will be small but non-zero near the sheet, and the width of that overlap region is a measure of how far the real flame is from this limit.

Droplet Combustion

MOD-17

Transfer numbers, the square law rate constant, droplet lifetime and flame standoff.

You provide

SymbolMeaningUnit
—Modeevaporation or combustion
T∞Ambient temperatureK
TsDroplet surface temperatureK
cpGas-phase specific heatJ/(kg·K)
qvLatent heat of vaporisationJ/kg
qcHeat of combustionJ/kg
Y_O∞Ambient oxidiser mass fraction—
νStoichiometric oxidiser requirementkg/kg
λGas-phase thermal conductivityW/(m·K)
ρℓLiquid densitykg/m³
r₀Initial droplet radiusμm

It reports

SymbolMeaningUnit
BTransfer number—
KRate constant on radius squaredcm²/s
KRate constant on diameter squaredcm²/s
τDroplet lifetimems
—Flame standoff ratio—

Choices you have to make

Settled without asking

Reading the result

Two numbers here are routinely misread. The first is the rate constant: this screen defines it on the radius squared, and most published constants are defined on the diameter squared and are therefore four times larger. Both are shown for exactly that reason. A lifetime computed with a diameter-based constant and a radius-based initial size is wrong by a factor of four and looks entirely plausible.

The second is the flame standoff ratio. The reaction-sheet prediction puts the flame at ten or more droplet radii; measurements put it far closer, typically a few radii. The discrepancy is not an error in the arithmetic — it is the reaction-sheet assumption failing, together with the constant-property assumption and, in most experiments, buoyant convection. Read the predicted standoff as an upper bound and an indication of which way the assumptions err, not as a measurement to be checked against.

The surface temperature being fixed at the boiling point is what makes the mass-transfer form of the transfer number diverge, which is why the heat-transfer form is the one reported. This is stated on the screen rather than left for a reader to discover by comparing against a source that uses the other form.

Stated on the screen

The surface temperature is taken as the boiling point. The mass-transfer form of B diverges under that simplification.

The rate constant here is defined on the radius squared: the diameter-based constant is four times larger.

Turbulent Regimes

MOD-18

Where a turbulent flame falls on the regime diagram, and the four boundaries.

You provide

SymbolMeaningUnit
s_LLaminar flame speedm/s
DMass diffusivitym²/s
v′Turbulence intensitym/s
ℓIntegral length scalem
δInner layer fraction—

It reports

SymbolMeaningUnit
ReTurbulent Reynolds number—
DaDamköhler number—
KaKarlovitz number—
Ka_δInner layer Karlovitz number—
ℓ_FLaminar flame thicknessmm
ℓ_GGibson scalemm
—Karlovitz number at the broken-zone boundary—
—Regime—

Choices you have to make

Settled without asking

Reading the result

Read the position, not the label. The boundaries are order-of-magnitude divisions drawn on a log-log plot, and a point a factor of two from one of them is not reliably on either side. What the diagram is genuinely good for is showing how far a condition is from a boundary and which way it moves when you change something — raise the turbulence intensity and watch the point climb toward the broken zone; raise the pressure, which thins the flame, and watch it fall back.

The inner layer fraction deserves attention before you trust the broken-zone boundary. It enters as the inverse square, so a factor of two in it is a factor of four in the boundary. The default is a methane–air estimate and nothing more; for another fuel it is a guess.

Stated on the screen

The inner layer fraction defaults to a methane-air estimate. It is editable because it moves a regime boundary.

Transport Properties

MOD-19

Viscosity and thermal conductivity from the official fits, plus the kinetic-theory route.

You provide

SymbolMeaningUnit
—Species name—
TTemperatureK
cpSpecific heatJ/(kg·K)
ρDensitykg/m³

It reports

SymbolMeaningUnit
ηDynamic viscosityPa·s
λThermal conductivityW/(m·K)
PrPrandtl number—
αThermal diffusivitym²/s
νKinematic viscositym²/s

Settled without asking

Reading the result

The transport file mixes two kinds of record, and this is worth knowing even if you never hit it. Of its 107 records, 41 are binary interaction pairs rather than pure species. Treating a pair as the pure property of its first named member returns a number that is quietly wrong — the right shape, the right magnitude, the wrong quantity. The two kinds are indexed separately here so that a lookup can only ever return a pure species. Before that separation existed the code happened to give correct answers, but only because the pure species happen to precede their pairs in the file; that was luck, not design.

The Prandtl number, thermal diffusivity and kinematic viscosity are derived using the specific heat and density **you** supplied, not values from the file. They are therefore no better than those two inputs. If you have entered a specific heat for a different temperature than the one you asked for, the viscosity and conductivity will be right and the three derived quantities will not, and nothing on the screen can detect that.

Stated on the screen

The kinetic-theory route needs a collision integral, which has no default value in this app.