neqsim-fluid-quality-check

Pass the composition as a dictionary of component names to mole fractions into FluidQualityChecker and call check(). The result reports the total fraction, negative components, missing required components, and an is_usable flag indicating whether the composition is safe to simulate.

FluidQualityChecker sums all fractions and compares the total against 1.0 within a configurable tolerance, defaulting to 1e-6. If the sum falls outside the tolerance, a warning is emitted and is_usable becomes false.

No, the checker runs with no external dependencies and works without neqsim installed. If the neqsim package is available, the result records that fact via neqsim_available so an agent can proceed to NeqSim-specific setup.

Percent values were used as mole fractions instead of fractional values. Divide each component value by 100 before running the check so the total sums to 1.0.

The checker performs data-quality screening only and does not select equations of state, characterize plus fractions, regress binary interaction parameters, or validate laboratory procedures. Water, CO2, and H2S flags are informational and are not compliance checks or replacements for validated PVT analysis.