Agent skill

Neqsim Consequence Analysis

by equinor in equinor/neqsim

Quantitative consequence analysis - jet/pool fire, VCE, BLEVE, Gaussian and heavy-gas dispersion, probit fatality, individual and societal risk.

Apache-2.0Auto-check passed

Install Neqsim Consequence Analysis

skills CLI
$ npx skills add equinor/neqsim --skill neqsim-consequence-analysis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install equinor/neqsim neqsim-consequence-analysis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/equinor/neqsim.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/neqsim-consequence-analysis .claude/skills/neqsim-consequence-analysis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
neqsim-consequence-analysis
GitHub stars
156
Token cost
~2.8k tokens
SKILL.md length
663 words
Files
1
Skills in repo
66
Repo updated
First seen
Licence
Apache-2.0

At a glance

Quantitative consequence analysis - jet/pool fire, VCE, BLEVE, Gaussian and heavy-gas dispersion, probit fatality, individual and societal risk.

  • : a task requires fire-radiation contours
  • SKILL.md covers When to Use, Standards, Method 1 — Jet Fire (API 521 +… and Method 2 — Pool Fire, plus 13 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Dispersion to LFL/IDLH/ERPG

What it does

Neqsim Consequence Analysis is an agent skill from equinor/neqsim. Quantitative consequence analysis - jet/pool fire, VCE, BLEVE, Gaussian and heavy-gas dispersion, probit fatality, individual and societal risk. USE WHEN: a task requires fire-radiation contours, dispersion to LFL/IDLH/ERPG, BLEVE thermal/missile assessment, or QRA-style integration of release outcomes. Anchors on neqsim.process.safety.fire, .dispersion and .qra.

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: NeqSim is a library for calculation of fluid behavior, phase equilibrium and process simulation. The licence is Apache-2.0.

When your agent uses it

  • : a task requires fire-radiation contours
  • Dispersion to LFL/IDLH/ERPG
  • BLEVE thermal/missile assessment
  • QRA-style integration of release outcomes

Example prompts

  • “/neqsim-consequence-analysis”

What it can do on your machine

Read from SKILL.md and the folder at commit 92261e0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are java and bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Neqsim Consequence Analysis loads about 2.8k tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 663 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~98
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from equinor/neqsim at commit 92261e0, republished under its Apache-2.0 licence (© equinor). 663 words, ~2,816 tokens.

Download SKILL.mdSave it as .claude/skills/neqsim-consequence-analysis/SKILL.md (or your agent's skills folder).
name
neqsim-consequence-analysis
description
Quantitative consequence analysis - jet/pool fire, VCE, BLEVE, Gaussian and heavy-gas dispersion, probit fatality, individual and societal risk. USE WHEN: a task requires fire-radiation contours, dispersion to LFL/IDLH/ERPG, BLEVE thermal/missile assessment, or QRA-style integration of release outcomes. Anchors on neqsim.process.safety.fire, .dispersion and .qra.
version
1.0.0
last_verified
2026-04-26
requires.java_packages
neqsim.process.safety.fire, neqsim.process.safety.dispersion, neqsim.process.safety.qra

NeqSim Consequence Analysis Skill

Quantitative consequence modelling that converts a release scenario (mass flow, inventory, ignition probability) into thermal radiation contours, overpressure contours, dispersion footprints, and finally individual / societal fatality risk per ISO 17776, NORSOK Z-013, API 752 and the CCPS Guidelines for Chemical Process Quantitative Risk Analysis.

When to Use

  • Jet-fire, pool-fire, VCE or BLEVE source-term modelling
  • Toxic / flammable dispersion to LFL, IDLH, ERPG-2/3 or 1 % fatality contours
  • Probit-based fatality probability for thermal radiation, overpressure or toxic dose
  • QRA roll-up: combine release frequency × ignition probability × fatality probability
  • Source-term generation as input to PHAST / FLACS / KFX

Distinct from neqsim-process-safety (HAZOP / LOPA / SIL — frequency side) and neqsim-relief-flare-network (PSV sizing / flare radiation — design side). This skill is the consequence side of QRA.

Standards

  • API 521 §6 — flare and vent radiation, fire heat input
  • API 752 / 753 / 756 — facility siting, occupied buildings
  • NORSOK Z-013 / S-001 — risk acceptance, fire & explosion loads
  • CCPS QRA Guidelines — probit constants, ignition probabilities
  • TNO Yellow Book — multi-energy / Baker-Strehlow VCE
  • EI 15 — hazardous area classification

Method 1 — Jet Fire (API 521 + CCPS solid-flame)

java
import neqsim.process.safety.fire.JetFireModel;
import neqsim.process.safety.dispersion.ProbitModel;

// 30 kg/s gas leak, 50 MJ/kg HoC, 25 % radiative fraction
JetFireModel jet = new JetFireModel(30.0, 50.0e6, 0.25);
double flux50m = jet.radiationFluxAt(50.0);   // W/m²
double dist125 = jet.distanceForFlux(12500.0); // m where flux = 12.5 kW/m²

Typical thermal radiation criteria (API 521 / NORSOK S-001):

Flux (kW/m²)EffectUse
1.6No discomfort for long exposurePublic area limit
4.7Sufficient for evacuation in 30 sEscape route
12.5Wood ignites, equipment failure (5 min)Process equipment limit
37.5Structural failure of process equipmentDamage to steel structure

Method 2 — Pool Fire

java
import neqsim.process.safety.fire.PoolFireModel;

// 500 kg liquid, burning rate 0.05 kg/m²·s, dike diameter 8 m, η = 0.30
PoolFireModel pool = new PoolFireModel(0.05, 8.0, 50.0e6, 0.30);
double flux = pool.radiationFluxAt(25.0); // W/m² at 25 m

Method 3 — Vapour Cloud Explosion (TNO Multi-Energy)

java
import neqsim.process.safety.fire.VCEModel;

// 200 kg flammable in cloud, congestion class 7 (heavy)
VCEModel vce = new VCEModel(200.0, 50.0e6, 7);
double overpressure = vce.overpressureAt(60.0); // Pa at 60 m
double safeDist = vce.distanceForOverpressure(20684.0); // m for 3 psi

Method 4 — BLEVE

java
import neqsim.process.safety.fire.BLEVECalculator;

// 50 t propane vessel
BLEVECalculator bleve = new BLEVECalculator(50000.0, 50.0e6, 0.40);
double fireballDiameter = bleve.fireballDiameter();   // m
double fireballDuration = bleve.fireballDuration();   // s
double thermalDose = bleve.thermalDoseAt(150.0);      // (W/m²)^(4/3)·s

Method 5 — Gaussian Plume Dispersion (Briggs σ)

java
import neqsim.process.safety.dispersion.GaussianPlume;

// 10 kg/s leak, ground-level source, 4 m/s wind, neutral stability D
GaussianPlume plume = new GaussianPlume(10.0, 0.0, 4.0,
    GaussianPlume.Stability.D, GaussianPlume.Terrain.RURAL);
double conc = plume.centerlineGroundConcentration(200.0); // kg/m³
double distLFL = plume.distanceToConcentration(0.044);    // m to methane LFL

Stability classes: A (very unstable) … F (stable). RURAL vs URBAN selects Briggs σ coefficients per Pasquill-Gifford. Use Stability.F for worst-case dispersion analysis (calm night, low wind).

Method 6 — Heavy-Gas Dispersion

For dense releases (CO₂, propane, butane) the Gaussian model under-predicts near-field concentrations. Use HeavyGasDispersion (Britter-McQuaid screening):

java
import neqsim.process.safety.dispersion.HeavyGasDispersion;

HeavyGasDispersion hgs = new HeavyGasDispersion(
    50.0,    // continuous release rate [kg/s]
    1.98,    // gas density at release [kg/m³]
    1.20,    // ambient density [kg/m³]
    4.0);    // wind speed [m/s]
double distLFL = hgs.distanceToConcentration(0.05); // m

Method 7 — Probit Fatality Probability

java
import neqsim.process.safety.dispersion.ProbitModel;

// Thermal: Y = a + b·ln(t·F^(4/3)), 60 s exposure at 12.5 kW/m²
double pFatality = ProbitModel.thermalFatality()
    .fatalityProbability(60.0, 12500.0);

// Toxic H2S: Y = -31.42 + 3.008·ln(C^1.43·t)
ProbitModel h2s = ProbitModel.h2sFatality();
double pH2S = h2s.fatalityProbability(600.0, 5.0e-4); // 10 min, 500 ppm

// Overpressure (lung haemorrhage): Y = -77.1 + 6.91·ln(P)
ProbitModel ovp = ProbitModel.overpressureFatality();

Built-in factories: thermalFatality(), overpressureFatality(), h2sFatality(), cl2Fatality(), nh3Fatality(), coFatality(). The ToxicLibrary class centralises probit constants for common toxic gases.

Method 8 — QRA Roll-up

java
import neqsim.process.safety.qra.ConsequenceAnalysisEngine;

ConsequenceAnalysisEngine e = new ConsequenceAnalysisEngine(
    "10 mm gas leak", 1.0e-4); // release frequency [/yr]
e.addJetFire(0.05, jet, ProbitModel.thermalFatality(), 60.0);
e.addJetFire(0.02, pool, ProbitModel.thermalFatality(), 60.0);
e.addToxicCloud(0.01, plume, ProbitModel.h2sFatality(), 600.0);

double IRPA = e.individualFatalityRiskPerYear(50.0); // at 50 m
String text = e.report(50.0);

The engine sums:

IRPA(d) = Σ_outcome f_release · f_branch · P_fatality(d, outcome)

Compare against acceptance criteria:

CriterionLimitSource
Worker IRPA1·10⁻³ /yr (intolerable)UK HSE R2P2
Worker IRPA1·10⁻⁶ /yr (broadly acceptable)UK HSE R2P2
NORSOK FAR10 fatalities / 10⁸ hNORSOK S-001
Public 1 % fatal35 m typical for 12.5 kW/m²API 752

Method 9 — Flare Flame Radiation & Noise (API 537)

java
import neqsim.process.safety.fire.Api537FlareFlameModel;

Api537FlareFlameModel flame = new Api537FlareFlameModel(
        50.0, 50.0e6, 0.20, 200.0)   // mDot[kg/s], HoC[J/kg], radiantFrac, vExit[m/s]
    .setStackHeightM(40.0)
    .setWindSpeedMPerS(10.0);

double r473 = flame.sterileZoneRadiusM(Api537FlareFlameModel.FLUX_4_73_KW); // property line
double q75  = flame.heatFluxAtGroundDistance(75.0);  // W/m²
double spl  = flame.soundPressureLevelDb(100.0);     // dB at 100 m

Use this instead of the point-source jet-fire form when the source is an elevated flare tip (it accounts for stack height, wind tilt, and flame geometry).

Show full SKILL.md (260 more words)Show less

Method 10 — Hazardous-Area Zone Classification (IEC 60079-10-1)

java
import neqsim.process.safety.dispersion.HazardousAreaCalculator;
import neqsim.process.safety.dispersion.HazardousAreaCalculator.ReleaseGrade;

HazardousAreaCalculator calc = new HazardousAreaCalculator(
        0.1,      // release mass flow [kg/s]
        6.0,      // process pressure [bara]
        340.0,    // temperature [K]
        0.044,    // LFL [volume fraction]
        0.01604)  // molar mass [kg/mol]
    .setReleaseGrade(ReleaseGrade.SECONDARY)  // CONTINUOUS / PRIMARY / SECONDARY
    .setSafetyFactor(0.5);

double dHaz = calc.hazardousDistanceM();
String zone = calc.zoneClassification();   // "Zone 0" / "Zone 1" / "Zone 2"

Maps the dispersion result to an Ex zone for electrical-equipment selection. CONTINUOUS → Zone 0, PRIMARY → Zone 1, SECONDARY → Zone 2.

Method 11 — Passive Fire Protection (PFP) Demand (API 521 / NORSOK S-001)

java
import neqsim.process.safety.fire.PfpDemandCalculator;
import neqsim.process.safety.fire.PfpDemandCalculator.FireType;
import neqsim.process.safety.fire.PfpDemandCalculator.PfpDemandResult;

PfpDemandResult pfp = new PfpDemandCalculator(
        100.0e3,   // fire heat flux [W/m²] (pool ~100 kW/m², jet ~250+ kW/m²)
        0.012)     // wall thickness [m]
    .setFireType(FireType.POOL)               // POOL / JET
    .evaluate(3600.0);                        // required survival time [s]

boolean need = pfp.isPfpRequired();
double thkMm = pfp.getRequiredPfpThicknessMm();
PfpDemandResult.PfpRating rating = pfp.getRating(); // NONE / H60 / J120 ...

Determines whether unprotected steel reaches its critical temperature before the required survival time, and if so the intumescent thickness and H/J rating.

Source Term for External CFD

ConsequenceAnalysisEngine.exportSourceTerm() writes a JSON block usable by PHAST, FLACS, KFX or DNV Safeti containing release rate, momentum, density, duration and chemistry — the standard handoff format described in neqsim-agent-handoff.

Common Pitfalls

  • Stability class — using class D ("typical") instead of F for hazard contours under-predicts safe distance by 2–3×. Always run F at low wind for siting.
  • Heavy gas — applying Gaussian to CO₂ / LPG releases under-predicts near-field concentration. Switch to HeavyGasDispersion when density ratio > 1.2.
  • Probit constants — different sources give different (a, b, n). Always cite the source; the factories in ProbitModel use CCPS values.
  • Ignition probability — small leaks (< 1 kg/s) often use 1–5 %, large leaks (> 50 kg/s) up to 30 % delayed. Use scenario-specific values, not 100 %.
  • Flame view-factor — the simple 1/(4πr²) point-source form is conservative near the flame; use API 521 solid-flame for distances < 2 × flame length.

Verification Tests

src/test/java/neqsim/process/safety/{fire,dispersion,qra}/ contain JUnit 5 tests for every model. Run:

bash
./mvnw test -Dtest=FireModelsTest,GaussianPlumeTest,ProbitModelTest,ConsequenceAnalysisEngineTest,Api537FlareFlameModelTest,HazardousAreaCalculatorTest,PfpDemandCalculatorTest

See Also

  • neqsim-process-safety — frequency side (HAZOP / LOPA / SIL)
  • neqsim-firewater-deluge-design — the mitigation side: how much fire water the area needs, and whether water is the right barrier for the fire type you just characterised
  • neqsim-relief-flare-network — PSV sizing and flare radiation
  • neqsim-depressurization-mdmt — emergency depressurization source terms
  • neqsim-agent-handoff — source-term JSON schema

© equinor, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .github/skills/neqsim-consequence-analysis of equinor/neqsim.

Open the folder on GitHubat commit 92261e0

Compare with similar skills

Neqsim Consequence Analysis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Neqsim Consequence Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Neqsim Consequence Analysis this skillequinor/neqsim156—~2.8kAutomated safety check: PassApache-2.0
Candidate Talent Poolsickn33/agentic-awesome-skills47k1 repos~4.2kAutomated safety check: PassMIT
Soroban Liquidity Poolsickn33/agentic-awesome-skills47k1 repos~1.3kAutomated safety check: PassMIT
Web3 Transaction Relayer Poolsickn33/agentic-awesome-skills47k1 repos~1.3kAutomated safety check: PassMIT
Meteora Dlmm Pool Screeningsickn33/agentic-awesome-skills47k1 repos~1.7kAutomated safety check: NotesMIT
Account Poolget-bb/bb4.2k—~201Automated safety check: PassMIT

Similar skills

  • Candidate Talent Pool

    sickn33/agentic-awesome-skills

    Candidate and prospect pool: contact details, experience, skills, consent status and date, referral source and last contact.

    47k GitHub starsUsed in 1 repo~4.2k tokens
    Documents & OfficeAuto-check passed
  • Soroban Liquidity Pool

    sickn33/agentic-awesome-skills

    Automated market maker liquidity pool register: constant-product invariant curves, swap fee tiers, and LP token shares for Soroban DeFi.

    47k GitHub starsUsed in 1 repo~1.3k tokens
    SecurityAuto-check passed
  • Web3 Transaction Relayer Pool

    sickn33/agentic-awesome-skills

    Gasless transaction relayer node pool register: fee sponsorship limits, nonce synchronization, and balance replenishment alerts.

    47k GitHub starsUsed in 1 repo~1.3k tokens
    Business, Finance & HRAuto-check passed
  • Meteora Dlmm Pool Screening

    sickn33/agentic-awesome-skills

    Screen and rank Meteora DLMM pools for LP quality using public Meteora APIs (fee/TVL, bin step, organic score).

    47k GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check: notes
  • Account Pool

    get-bb/bb

    Configure or diagnose Account Pooler accounts, authentication, quota routing, and failover through bb pool.

    4.2k GitHub stars~201 tokensUpdated today
    Backend & APIsAuto-check passed
  • Fire Skills

    LeoYeAI/openclaw-master-skills

    Practical fire building, management, and safety skills. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~5.1k tokensUpdated 2 mo ago
    Auto-check passed

More from equinor/neqsim

All 66 skills in this repo
  • Guides NeqSim agents through acid-gas and contaminant removal with SimpleAmineAbsorber, SimpleAmineRegenerator, SystemKentEisenberg, SystemDesmukhMather, RateBasedAbsorber, MembraneSeparator, and…

    156 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Guides agents through ProcessLinkedMPC, ProcessLinearizer, ModelPredictiveController, VirtualFlowMeter, SoftSensor, and DataReconciliationEngine.

    156 GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Neqsim Agent Handoff

    equinor/neqsim

    Agent-to-agent communication schema for NeqSim. An agent skill from equinor/neqsim.

    156 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Autonomous observe-hypothesize-predict-test-discriminate loop for operational anomalies.

    156 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Equipment capacity constraints, bottlenecks, utilization snapshots, KPI/response DTOs, validated automation writes and GOR/MPFM rate fitting (CapacityConstraint, BottleneckTracker…

    156 GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Neqsim Ccs Hydrogen

    equinor/neqsim

    CO2 capture, transport, storage (CCS) and hydrogen systems patterns for NeqSim.

    156 GitHub stars~3.8k tokensUpdated today
    Auto-check passed

Questions about Neqsim Consequence Analysis

What does Neqsim Consequence Analysis do?

Quantitative consequence analysis - jet/pool fire, VCE, BLEVE, Gaussian and heavy-gas dispersion, probit fatality, individual and societal risk. Neqsim Consequence Analysis is an agent skill from equinor/neqsim. Quantitative consequence analysis - jet/pool fire, VCE, BLEVE, Gaussian and heavy-gas dispersion, probit fatality, individual and societal risk.

When should I use Neqsim Consequence Analysis?

Neqsim Consequence Analysis fits situations like: : a task requires fire-radiation contours; dispersion to LFL/IDLH/ERPG; BLEVE thermal/missile assessment; QRA-style integration of release outcomes.

How do I install Neqsim Consequence Analysis in Claude Code?

Run `npx skills add equinor/neqsim --skill neqsim-consequence-analysis -a claude-code`. Or copy the skill folder (.github/skills/neqsim-consequence-analysis in equinor/neqsim) into .claude/skills/neqsim-consequence-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Neqsim Consequence Analysis in Codex?

Run `npx skills add equinor/neqsim --skill neqsim-consequence-analysis -a codex`. Or copy the skill folder (.github/skills/neqsim-consequence-analysis in equinor/neqsim) into .agents/skills/neqsim-consequence-analysis in your project. Codex loads it when a task matches its description.

Can I use Neqsim Consequence Analysis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add equinor/neqsim --skill neqsim-consequence-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/neqsim-consequence-analysis, .gemini/skills/neqsim-consequence-analysis, .github/skills/neqsim-consequence-analysis and .opencode/skills/neqsim-consequence-analysis in your project.

What does Neqsim Consequence Analysis need to run?

SKILL.md names no scripts, command-line tools or credentials: Neqsim Consequence Analysis is instructions for the agent only.

Does Neqsim Consequence Analysis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Neqsim Consequence Analysis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Neqsim Consequence Analysis use?

Neqsim Consequence Analysis is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Neqsim Consequence Analysis use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Neqsim Consequence Analysis?

Skills that share tags, products or a category with Neqsim Consequence Analysis: Candidate Talent Pool (sickn33/agentic-awesome-skills, 47k stars), Soroban Liquidity Pool (sickn33/agentic-awesome-skills, 47k stars), Web3 Transaction Relayer Pool (sickn33/agentic-awesome-skills, 47k stars) and Meteora Dlmm Pool Screening (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Neqsim Consequence Analysis?

equinor (a GitHub organization) maintains it in equinor/neqsim, which has 156 GitHub stars. The repository holds 66 skills in this directory. The repository was last updated on October 7, 2026.

Source: equinor/neqsim on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.