Chemical

Overview

Introduction Chemical engineering property and safety calculations connect molecular identity, thermophysical behavior, combustion chemistry, and occupational risk into a single decision workflow. In practical terms, this category helps users move from “What substance is this?” to “How does it behave in a process?” and then to “Can this be handled and burned safely?” In mathematical terms, it combines lookup functions (deterministic retrieval by identifier), algebraic balance relations (element and energy conservation), and threshold checks (flammability and exposure constraints).

At the business level, this matters because early-stage engineering decisions often fail due to inconsistent data references. A process team may size heat exchangers with one property source, estimate burner air demand with another, and check worker exposure with a third. If identifiers, units, or assumptions drift, errors propagate into capex, operating costs, safety margins, and compliance reporting. Boardflare’s chemical category reduces that drift by unifying these jobs around a consistent set of calculators backed primarily by the chemicals and thermo Python libraries.

The category spans three layers. First, chemical properties establish identity and core constants such as T_c, P_c, and boiling point. Second, combustion fuels quantify stoichiometric oxygen demand, air-fuel ratios, and heating values. Third, process safety evaluates fire/explosion limits and occupational exposure thresholds. This layered design mirrors real engineering work: identify, model, then protect. It also aligns with accepted concepts in chemical engineering, combustion, and process safety.

In this category, users can resolve identifiers with CAS_FROM_ANY and SEARCH_CHEMICAL, retrieve constants with CHEMICAL_PROPS, DIPOLE, OMEGA, PC, TC, TB, TM, and VC, then transition into combustion with COMBUSTION_STOICH, AIR_FUEL_RATIO, FUEL_AIR_SPEC, HHV_STOICHIOMETRY, LHV_FROM_HHV, IS_COMBUSTIBLE, RON, and MON, and complete hazard screening with LFL, UFL, T_FLASH, T_AUTOIGNITION, TWA_LIMIT, STEL, CEILING_LIMIT, and CARCINOGEN_STATUS.

When to Use It Use this category when a workflow depends on both molecular detail and operational decisions, not just one-off property lookup. A recurring pattern in industrial analytics is that teams begin with ad hoc spreadsheets for constants, then later bolt on combustion or safety checks. This category is best used earlier, when those calculations can be standardized from the start.

One common job is fuel-system design and optimization. A plant engineer evaluating a mixed-fuel boiler needs reliable component properties, stoichiometric oxygen demand, and realistic excess-air behavior in one chain. They can identify uncertain feed components with CAS_FROM_ANY, confirm metadata via SEARCH_CHEMICAL, validate pure-component thermodynamics with TC, PC, and OMEGA, then compute combustion chemistry through COMBUSTION_STOICH and FUEL_AIR_SPEC. If fuel quality changes seasonally, AIR_FUEL_RATIO provides a fast rebalancing mechanism in mass, mole, or volume terms.

Another high-value use case is energy accounting and decarbonization planning. Analysts comparing fuels for thermal duty must distinguish higher and lower heating values and connect them to realistic burn conditions. HHV_STOICHIOMETRY calculates ideal combustion energy from formation enthalpies and stoichiometry, while LHV_FROM_HHV adjusts for latent heat associated with water vapor. Teams then use RON and MON where spark-ignition behavior matters. This supports cleaner techno-economic comparisons than using static handbook values disconnected from composition assumptions.

A third scenario is process hazard review and compliance screening. During process hazard analysis, teams must quickly answer: Is the material combustible? What is the flash point? At what vapor concentrations does ignition become possible? What are worker exposure thresholds? IS_COMBUSTIBLE, T_FLASH, T_AUTOIGNITION, LFL, and UFL address ignition/explosion boundaries, while TWA_LIMIT, STEL, CEILING_LIMIT, and CARCINOGEN_STATUS support occupational and toxicological checks. This integrated path is especially valuable for stage-gate approvals, MOC reviews, and audit preparation.

The category also helps data teams that build digital twins, optimization routines, or automated report pipelines. Instead of manually curating dozens of constants, they can programmatically resolve chemical identity, fetch reproducible properties, and generate safety envelopes from one tool family. The result is lower model drift and faster handoff between engineering, EHS, and operations.

How It Works The category combines four computational primitives: identifier normalization, property retrieval, stoichiometric balancing, and threshold evaluation.

  1. Identifier normalization and property retrieval

Many downstream functions require CAS numbers as stable keys. CAS_FROM_ANY maps names, InChI, SMILES, and aliases to canonical CAS format; SEARCH_CHEMICAL returns metadata summaries for validation. Once identity is fixed, property functions such as CHEMICAL_PROPS, TB, TM, TC, PC, VC, OMEGA, and DIPOLE retrieve scalar values from curated methods in chemicals and thermo.

For equation-of-state and corresponding-states workflows, reduced variables are central:

T_r = \frac{T}{T_c}, \qquad P_r = \frac{P}{P_c}

and the acentric factor can be interpreted as

\omega = -\log_{10}\left(P_r^{sat}(T_r=0.7)\right) - 1

where \omega from OMEGA helps quantify non-ideality beyond simple spherical-fluid behavior.

  1. Combustion stoichiometry and air demand

Combustion tools apply elemental conservation to determine required oxidizer and resulting products. COMBUSTION_STOICH computes stoichiometric coefficients from an atom dictionary. For a generic hydrocarbon C_xH_y under complete combustion:

C_xH_y + \left(x + \frac{y}{4}\right)O_2 \rightarrow xCO_2 + \frac{y}{2}H_2O

In real systems, air replaces pure oxygen, inert nitrogen appears in products, and excess oxygen is often intentional. FUEL_AIR_SPEC solves coupled equations for inlet/outlet compositions, oxygen excess, and dry/wet basis oxygen fractions. AIR_FUEL_RATIO is a targeted solver for converting among mass, mole, and volume ratio definitions:

\left(\frac{A}{F}\right)_{mass} = \frac{\dot m_{air}}{\dot m_{fuel}},\quad \left(\frac{A}{F}\right)_{mole} = \frac{\dot n_{air}}{\dot n_{fuel}},\quad \left(\frac{A}{F}\right)_{vol} = \frac{\dot V_{air}}{\dot V_{fuel}}

  1. Heating value calculations

HHV_STOICHIOMETRY uses heats of formation and stoichiometric products to compute higher heating value via reaction enthalpy accounting. Conceptually:

\Delta H_{rxn} = \sum_i \nu_i \Delta H_{f,i}^{\circ}(products) - \sum_j \nu_j \Delta H_{f,j}^{\circ}(reactants)

with sign conventions handled by the implementation. LHV_FROM_HHV then removes latent heat tied to water condensation assumptions, yielding lower heating value for equipment that exhausts water as vapor.

  1. Safety and exposure thresholds

Safety functions combine tabulated references and estimators in chemicals.safety. LFL and UFL provide lower/upper flammability bounds as mole fractions in air, defining the combustible envelope. T_FLASH and T_AUTOIGNITION provide ignition temperature thresholds under different mechanisms. Exposure tools return concentration limits with units: TWA_LIMIT, STEL, and CEILING_LIMIT. CARCINOGEN_STATUS adds qualitative hazard classification from major sources.

In practice, engineering quality depends on assumptions: purity, complete combustion, basis (dry/wet), method source, and unit consistency. These tools make those assumptions explicit through parameters and method arguments, reducing hidden spreadsheet logic.

Practical Example Consider a manufacturing site evaluating a switch from a legacy fuel blend to a cleaner mixed gaseous fuel. The process engineer needs to estimate burner settings and energy impact, while the EHS team needs fast hazard screening before pilot operation.

Step 1: Standardize identities and metadata. The incoming supplier sheet includes names and alternate IDs. The analyst resolves each identifier through CAS_FROM_ANY, then checks summary metadata using SEARCH_CHEMICAL. This avoids accidental mismatches between isomers or naming conventions.

Step 2: Pull core thermophysical constants. For each major species, the engineer retrieves T_c, P_c, T_b, and \omega using TC, PC, TB, and OMEGA. If a compact pull is preferred, CHEMICAL_PROPS retrieves targeted values by attribute name. TM, VC, and DIPOLE are added for handling/storage checks and correlation support.

Step 3: Build combustion chemistry. The team defines elemental compositions and computes ideal reaction coefficients with COMBUSTION_STOICH. They verify each component’s burnability with IS_COMBUSTIBLE, then solve full inlet/outlet behavior with FUEL_AIR_SPEC, specifying target oxygen excess and available stream information.

Step 4: Tune operating ratio targets. Operations wants a practical air setting in mass terms, while controls models run in mole terms. AIR_FUEL_RATIO provides consistent conversions and back-calculations for whichever variable is known (air flow, fuel flow, or ratio basis).

Step 5: Quantify energy metrics. The energy analyst computes ideal HHV from stoichiometry and formation data with HHV_STOICHIOMETRY, then derives LHV with LHV_FROM_HHV. If the application includes spark-ignition quality concerns, RON and MON are checked for blend behavior and knock sensitivity screening.

Step 6: Complete safety gate checks. Before pilot run, EHS evaluates flammability envelope via LFL and UFL, ignition temperatures via T_FLASH and T_AUTOIGNITION, occupational limits via TWA_LIMIT, STEL, and CEILING_LIMIT, and carcinogenic classifications with CARCINOGEN_STATUS.

This end-to-end sequence is more robust than traditional spreadsheet modeling because it keeps identifier resolution, property retrieval, combustion calculations, and safety limits in one reproducible chain. It also gives clearer auditability: each number can be traced to a function, method, and input basis.

How to Choose Use the following decision flow to pick the right calculator quickly.

graph TD
    A[Start with chemical question] --> B{Need to identify substance?}
    B -- Yes --> C[Use CAS_FROM_ANY or SEARCH_CHEMICAL]
    B -- No --> D{Need physical or thermodynamic constants?}
    D -- Yes --> E[Use CHEMICAL_PROPS / TB / TM / TC / PC / VC / OMEGA / DIPOLE]
    D -- No --> F{Need combustion or fuel calculations?}
    F -- Yes --> G[Use COMBUSTION_STOICH then AIR_FUEL_RATIO or FUEL_AIR_SPEC]
    G --> H[Use HHV_STOICHIOMETRY and LHV_FROM_HHV; optionally RON/MON]
    F -- No --> I{Need process safety limits?}
    I -- Yes --> J[Use LFL/UFL, T_FLASH/T_AUTOIGNITION, then TWA/STEL/CEILING/CARCINOGEN]
    I -- No --> K[Recheck scope or inputs]

For precise tool selection, use this comparison table.

Function Best used for Typical inputs Output type Notes
CAS_FROM_ANY Normalize unknown identifiers to CAS Name/InChI/SMILES CAS string First step for most workflows
SEARCH_CHEMICAL Quick metadata confirmation Identifier Metadata text Good validation companion to CAS mapping
CHEMICAL_PROPS One-at-a-time property retrieval Chemical + property key Scalar Flexible accessor for common constants
TB, TM, TC, PC, VC Specific pure-component constants CASRN Scalar Use when you need explicit, typed endpoints
OMEGA EOS/corresponding-states non-ideality input CASRN Scalar Critical for cubic EOS parameterization
DIPOLE Polarity-sensitive correlation support CASRN Scalar Useful in transport/interaction contexts
COMBUSTION_STOICH Build balanced combustion reaction Atom dictionary Coefficient map Foundation for downstream fuel calculations
IS_COMBUSTIBLE Fast combustible/non-combustible screening CAS + atoms Boolean Quick pre-check before deeper modeling
AIR_FUEL_RATIO Convert/solve air-fuel relationships Ratio, flows, basis JSON summary Supports mass, mole, volume bases
FUEL_AIR_SPEC Full mixed-stream combustion solve Stream comps + constraints JSON dictionary Most comprehensive combustion solver here
HHV_STOICHIOMETRY Calculate HHV from reaction chemistry Stoichiometry + \Delta H_f Scalar Use for theoretically consistent HHV
LHV_FROM_HHV Convert HHV to LHV HHV + water stoich Scalar Important for appliance/furnace comparisons
RON, MON Spark-ignition fuel quality screening CASRN Scalar Use together; sensitivity is RON-MON
LFL, UFL Flammability envelope bounds CASRN or estimated inputs Scalar Core explosion screening metrics
T_FLASH, T_AUTOIGNITION Ignition temperature thresholds CASRN Scalar Flash point vs spontaneous ignition mechanisms
TWA_LIMIT, STEL, CEILING_LIMIT Occupational exposure limits CASRN JSON value+units Match averaging window to use case
CARCINOGEN_STATUS Regulatory hazard classification context CASRN JSON/text Use for qualitative risk and reporting flags

A practical rule set helps avoid misapplication:

This category is most effective when used as a pipeline instead of isolated lookups. Teams that apply it that way typically gain better traceability, fewer unit errors, and faster cross-functional review.

Chemical Properties

Tool Description
CAS_FROM_ANY Resolve a chemical identifier to its standardized CAS number.
CHEMICAL_PROPS Retrieve physical and thermodynamic properties for a chemical specimen.
DIPOLE Retrieve the dipole moment of a chemical by CAS number.
OMEGA Retrieve the acentric factor of a chemical by CAS number.
PC Retrieve the critical pressure of a chemical by CAS number.
SEARCH_CHEMICAL Resolve a chemical identifier and return a compact metadata summary.
TB Retrieve the normal boiling temperature of a chemical by CAS number.
TC Retrieve the critical temperature of a chemical by CAS number.
TM Retrieve the melting temperature of a chemical by CAS number.
VC Retrieve the critical molar volume of a chemical by CAS number.

Combustion Fuels

Tool Description
AIR_FUEL_RATIO Calculates molar flow rate of air or fuel from the other, using a specified air-fuel ratio.
COMBUSTION_STOICH Returns a dictionary of stoichiometric coefficients of chemical combustion from an atoms dictionary.
FUEL_AIR_SPEC Solves the system of equations describing a flow of air mixing with a flow of combustibles and burning completely.
HHV_STOICHIOMETRY Returns the higher heating value based on theoretical combustion stoichiometry and heat of formation.
IS_COMBUSTIBLE Checks if a chemical is combustible based on its CAS and atoms.
LHV_FROM_HHV Returns the lower heating value (LHV) of a chemical given the higher heating value (HHV) and number of water molecules formed.
MON This function handles the retrieval of a chemical’s motor octane number (MON), using CASRN.
RON This function handles the retrieval of a chemical’s research octane number (RON), using CASRN.

Process Safety

Tool Description
CARCINOGEN_STATUS Looks up if a chemical is listed as a carcinogen according to specific methods.
CEILING_LIMIT Handles the retrieval of ceiling limits on worker exposure to dangerous chemicals.
LFL Handles the retrieval or calculation of a chemical’s Lower Flammability Limit.
STEL Handles the retrieval of Short-term Exposure Limit (STEL) for worker exposure.
T_AUTOIGNITION Handles the retrieval or calculation of a chemical’s autoignition temperature.
T_FLASH Handles the retrieval or calculation of a chemical’s flash point.
TWA_LIMIT Return the Time-Weighted Average exposure limits (TWA) for the desired chemical.
UFL Handles the retrieval or calculation of a chemical’s Upper Flammability Limit.