neqsim-wax-margin-check

Wax Margin Check

Use this skill for a quick, public check of whether a process or pipeline operating point keeps a temperature margin above a known wax appearance temperature (WAT). It is intentionally simple and should guide users toward validated NeqSim wax calculations for real work.

When to Use

• When a user asks whether an operating temperature stays clear of the wax deposition region.
• When a validated NeqSim wax appearance temperature or a public lab WAT is already available.
• When an agent should explain that validated NeqSim methods are required for real wax prediction and deposition design.

Inputs

• operating_temperature: operating temperature in C.
• wax_appearance_temperature: wax appearance temperature in C from a validated NeqSim calculation or public lab measurement.
• min_margin: configurable minimum acceptable margin in C (constructor, default 5.0).

Outputs

• wax_margin_c: operating temperature minus the wax appearance temperature in C.
• below_wax_appearance: whether the operating point is at or below the wax appearance temperature.
• margin_warning: ok, watch, or high.
• neqsim_available: whether the optional NeqSim package is importable.
• assumptions: public assumptions and required follow-up.

Engineering Method

The placeholder method computes the wax margin as operating_temperature - wax_appearance_temperature. A non-positive margin means the operating point is at or below the wax appearance temperature and is flagged high. A small positive margin below min_margin is flagged watch. A larger margin is flagged ok.

This is not a wax thermodynamic or deposition model. The wax appearance temperature must come from a validated NeqSim wax calculation or a public lab measurement with a defined fluid composition and operating envelope.

Python Usage Pattern

from wax_margin_check import WaxMarginModel

model = WaxMarginModel(min_margin=5.0)
result = model.evaluate(
    operating_temperature=33.0,
    wax_appearance_temperature=30.0,
)

print(result.wax_margin_c)
print(result.margin_warning)
print(result.assumptions)