| name | neqsim-standards-lookup |
| description | Industry standards lookup and compliance tracking for NeqSim engineering tasks. USE WHEN: any engineering task requires standards compliance (API, ISO, NORSOK, DNV, ASME, EN, ASTM), risk assessment, or safety analysis. Provides equipment-to-standards mapping, database query patterns, results.json schema for standards_applied, and risk standards quick-reference. |
| last_verified | 2026-08-02 |
NeqSim Standards Lookup
Reference for identifying, applying, and documenting industry standards compliance
in every engineering task. All tasks — Quick, Standard, or Comprehensive — must
identify applicable standards proportional to task depth.
Standards Identification (MANDATORY First Step)
Before any simulation or analysis, identify applicable standards:
| Task Scale | Standards Requirement |
|---|
| Quick | 1-line note: "Per [STANDARD]" or "N/A — property lookup" |
| Standard | Table of applicable standards with scope and status |
| Comprehensive | Full table with clause numbers, design values, and compliance evidence |
Equipment → Standards Mapping
NeqSim's standards database is in src/main/resources/designdata/standards/.
The index file standards_index.csv maps equipment types to applicable standards:
| Equipment Type | Primary Standards | NeqSim CSV File |
|---|
| Separator, ThreePhaseSeparator, GasScrubber | NORSOK P-001, API 12J, ASME VIII | norsok_standards.csv, api_standards.csv, asme_standards.csv |
| Compressor | API 617, NORSOK P-002 | api_standards.csv, norsok_standards.csv |
| Pump | API 610 | api_standards.csv |
| Pipeline, AdiabaticPipe, MultiphasePipe | NORSOK L-001, ASME B31.3/B31.4/B31.8, DNV-ST-F101 | norsok_standards.csv, asme_standards.csv, dnv_iso_en_standards.csv |
| Pipeline, FlexiblePipe, Cable, Umbilical on seabed | DNV-RP-F109 | Typed kernel DnvRpF109OnBottomStabilityKernel; project values remain explicit inputs |
| HeatExchanger, Heater, Cooler | API 660/661, TEMA | api_standards.csv |
| Tank | API 650/620, API 2000 | Use Api2000TankVentingScreeningKernel for current 7th-edition caller-controlled normal/emergency demand and rated-capacity screening; api_standards.csv covers catalog data |
| Valve | ASME B31.3 | asme_standards.csv |
| Subsea equipment | NORSOK U-001, DNV-ST-F101 | norsok_standards.csv, subsea_standards.csv |
| Well casing/tubing | API 5CT, API TR 5C3, NORSOK D-010 | api_standards.csv, norsok_standards.csv |
| Flange | ASME B16.5 | asme_standards.csv |
| Orifice plate / differential-pressure metering | ISO 5167-1/-2, AGA 3 / API MPMS 14.3 | Use Iso5167OrificeMeteringKernel for strict ISO 5167-2:2022 screening; keep Standard_AGA3 for an AGA/API basis and Orifice for process simulation |
| CO2 corrosion / materials selection | NORSOK M-506, ISO 15156 / NACE MR0175, NORSOK M-001 | Use NorsokM506CorrosionDesignKernel for strict M-506 screening; use NorsokM506ElectrolyteBridge for a rigorous brine pH/FeCO3 basis and keep for legacy sweeps |
DNV-RP-F109 implementation status
EquipmentDesignKernelRegistry.lookup(StandardType.DNV_RP_F109) exposes a
SCREENING kernel for the exact catalogued edition 2021-05+AMD 2025-09.
It calculates vertical equilibrium and a transparent absolute-static lateral
screen, or checks displacement supplied by an externally validated generalized or
dynamic response model. It intentionally excludes licensed generalized-design
tables, response generation, environmental-statistics derivation, soil-model
qualification, and conformity assessment. Do not report a passing kernel result as
DNV certification or clause-complete compliance; report the implemented check scope
and retain engineeringApprovalRequired=true.
DNV-ST-F101 pipeline screening
For current DNV-ST-F101 requests, use
neqsim.process.engineering.calculation.DnvStF101PipelineDesignKernel with a complete
DnvStF101PipelineDesignInput. It preserves operating, incidental, and test pressure; collapse;
propagation buckling; local-buckling load interaction; fatigue; temperature/material de-rating;
safety class; ovality; fabrication route; and installation strain as distinct checks.
Do not route DNV-ST-F101 to PipeMechanicalDesignCalculator.DNV_OS_F101. That constant is the
legacy DNV-OS-F101 screen. Missing structural inputs or unsupported editions must remain blocked,
and a calculated result must retain CALCULATED_REVIEW_REQUIRED. Never describe a passing screen
as certification or code compliance; require a licensed project copy and independent review.
See docs/process/dnv_st_f101_pipeline_screening.md and the neqsim-capability-map skill.
TR/NORSOK Integration Classes
NORSOK M-506 execution rule
For an explicit NORSOK M-506 calculation, prefer
neqsim.process.engineering.calculation.NorsokM506CorrosionDesignKernel. It implements only the
unamended 2017 edition, checks Pipeline / AdiabaticPipe / Pipe applicability, retains raw
unit-explicit input values, and blocks unsupported or out-of-range cases before the mutable legacy
calculator runs. Treat NorsokM506CorrosionAssessment.getProjectedUniformWallLossMm() as rate
multiplied by exposure time, not as a specified corrosion allowance or acceptance decision.
The kernel is SCREENING: verify the purchased standard, wetting and water-chemistry basis,
localized corrosion, sour service, inhibitor availability, materials selection, and project
criteria independently. When feCO3SaturationRatio is enabled, report it as a NeqSim film-factor
extension and retain the source chemistry evidence. Standards Norway's May 2026 systematic-review
notice is the lifecycle source for the catalogued 2017 edition; do not silently apply this kernel to
a later revision.
ISO 5167 execution rule
For an explicit ISO orifice-metering calculation, use
neqsim.process.engineering.calculation.Iso5167OrificeMeteringKernel. The registered method supports
only unamended ISO 5167-2:2022, paired with ISO 5167-1:2022. It requires an Orifice equipment
basis, explicit liquid or gas/vapour service, a supported tapping arrangement, and affirmative
single-phase/full-pipe/subsonic/non-pulsating and installation evidence before calculation.
Do not treat geometryAndInstallationVerified(true) as evidence created by NeqSim; retain the
inspection and installation record. Keep uncertainty, calibration, straight lengths, plate
condition, custody-transfer acceptance, and project metering procedure outside the kernel. Use
Standard_AGA3 under an AGA 3/API MPMS 14.3 basis and do not relabel that result as ISO 5167.
DNV-RP-C203 execution rule
For an explicit DNV-RP-C203 basis, use
neqsim.process.engineering.calculation.DnvRpC203FatigueDesignKernel. It supports the catalogued
2024-10 edition including amendment 2025-10, rejects additional project amendments, and is a
SCREENING S-N/Palmgren-Miner calculation.
The caller must supply and verify a controlled single-slope or continuous bi-linear curve, stress
spectrum, SCF, thickness factor, other stress-range factor, design fatigue factor, damage limit, and
exposure.
Do not copy licensed curve tables into NeqSim and do not infer that a verification Boolean is the
evidence itself. Retain curve/detail selection, environment, fabrication, thickness, weld and SCF
basis, structural stress derivation, load combinations, rainflow counting, inspection plan, and
accountable approval externally. The older pipeline/riser fatigue methods have inconsistent embedded
intercepts and remain legacy estimates, not exact-edition C203 calculations.
DNV-RP-F105 execution rule
For an explicit DNV-RP-F105 basis, use
neqsim.process.engineering.calculation.DnvRpF105FreeSpanScreeningKernel. It supports only the
catalogued unamended 2025-12 edition for Pipeline and AdiabaticPipe. The kernel evaluates a
simply supported Euler-Bernoulli first mode with caller-supplied effective modal mass and axial
force, then reports current/wave frequency ratios, reduced velocities, and Keulegan-Carpenter
number. Steel outside diameter and hydrodynamic diameter are separate inputs.
Treat the geometry, structural-model, environmental, and project-trigger verification Booleans as
attestations whose evidence must be retained externally. Strouhal number, frequency-ratio band, and
reduced-velocity limits are caller-controlled escalation triggers, not embedded DNV requirements or
acceptance decisions. Keep soil/shoulder stiffness, interacting spans, detailed in-line/cross-flow
VIV and direct-wave response, ULS/FLS, fatigue, monitoring, intervention, and conformity open.
PipeMechanicalDesignCalculator.calculateAllowableSpanLength(...) is a legacy fixed-assumption
estimate with fallback and cap behavior. Never report that output as current-edition F105 evidence.
DNV-RP-F101 execution rule
For an explicit DNV-RP-F101 basis, use
neqsim.process.engineering.calculation.DnvRpF101CorrodedPipelineScreeningKernel. It supports the
catalogued 2019-09+AMD:2025-09 edition and only calculates the deterministic isolated
longitudinal metal-loss equation under internal pressure. Require externally verified assessment
wall thickness, measured defect depth and length, caller-controlled depth allowance,
characteristic ultimate tensile strength, internal/external pressures, caller-controlled pressure
factor, and isolated-defect applicability.
Treat every verification Boolean as an attestation, not the evidence itself. Keep inspection
accuracy and growth derivation, factor selection, interacting/complex defects, combined
longitudinal compression, probabilistic methods, crack/dent/gouge/blister or weld damage, repair,
fitness-for-service acceptance, and accountable approval external. Do not turn
NorsokM506CorrosionAssessment.getProjectedUniformWallLossMm() into RP-F101 defect dimensions.
RP-F101 remaining-strength screening is not DNV-ST-F101 original design. It does not replace
pressure containment, collapse, propagation buckling, local buckling, load interaction, fatigue,
incidental/test pressure, de-rating, safety class, ovality, fabrication route, or installation
strain checks.
DNV-RP-F104 execution rule
For an explicit current DNV-RP-F104 2021-02+AMD:2021-09 basis, use
DnvRpF104Co2PipelineEnvelopeScreeningKernel. Require verified project CO2/water limits,
other-impurity status, composition/EOS basis, the minimum-pressure interpretation and uncertainty of
each supplied single-phase boundary, an ordered operating profile, MAOP, design temperatures, and
external integrity/lifecycle review evidence. Negative margins remain calculated findings; missing
evidence blocks execution.
Use StandardRegistry.requireRequirementPack(StandardSelection.strictRequirements( StandardType.DNV_RP_F104)) to discover related thermodynamic, hydraulic, corrosion, mechanical,
monitoring, and consequence capabilities. The pack does not prove clause coverage. Do not substitute
the pure-CO2 critical point, CO2FlowCorrections.isDensePhase(...), or embedded
DensePhaseCO2Corrosion values for the project basis. F104 does not replace DNV-ST-F101 structural
design or the external fracture, materials, corrosion, construction, safety, operation, and
requalification assessments.
DNV-RP-F114 execution rule
For an explicit current DNV-RP-F114 2021-05 basis, use
DnvRpF114PipeSoilInteractionScreeningKernel. Supply positive pipe diameter and submerged weight,
then named route/design-situation cases with externally established non-negative vertical, axial,
and lateral demand magnitudes and positive resistance magnitudes on a consistent N/m basis.
Require external evidence for applicability, site investigation, soil interpretation,
pipe/interface configuration, installation history, cyclic/drainage/rate/consolidation effects,
load-displacement and resistance models, uncertainty/spatial variability, design actions and
acceptance criteria, and lifecycle interfaces. A negative margin remains a calculated finding.
Never derive F114 resistance from NeqSim soil thermal conductivity, burial heat-transfer inputs, a
generic friction coefficient, or submerged weight alone. Keep F109 on-bottom stability, F110 global
buckling, F105 free spans, ST-F101 structural design, and conformity external.
DNV-RP-F110 execution rule
For an explicit current DNV-RP-F110 2019-09+AMD:2021-09 basis, use
DnvRpF110GlobalBucklingResponseScreeningKernel. Supply positive pipe diameter and structural wall
thickness, then named route/design-situation cases containing externally analysed effective force,
peak longitudinal strain, peak global displacement, and required feed-in length together with
caller-controlled allowable or available values.
Require external evidence for applicability, operating envelope/effective force, pipe properties
and as-laid geometry, pipe-soil interaction, imperfections/triggers/design strategy, global
structural model, design situations/load combinations, local capacity/strain criteria,
uncertainty/sensitivity/buckle sharing, and lifecycle actions. A negative margin remains calculated.
Never interpret the force limit as a NeqSim-derived critical-buckling or initiation criterion. Keep
F109/F114/F105, every DNV-ST-F101 check, conformity, and accountable approval external.
API 2000 execution rule
For an explicit API 2000 basis, use
neqsim.process.engineering.calculation.Api2000TankVentingScreeningKernel. It supports only the
catalogued unamended 7th Ed for caller-verified non-refrigerated fixed-roof Tank or
SimpleTankFiller service. Supply maximum filling/withdrawal rates, caller-controlled movement
ratios, externally established thermal/other normal demands, total emergency demand, rated
normal/emergency capacities, their rated pressure/vacuum conditions, tank limits, and one common
gas-volume reference state.
Treat the evidence Booleans as attestations, not proof. Keep API demand tables/equations, scenario
derivation, vent area and device selection, manufacturer curves, pressure losses, flame arresters,
blanketing, external floating roofs, refrigerated storage, installation/testing, and conformity
external. An adequate caller-controlled constraint result is not API compliance.
Use these Java classes when a task references Equinor technical requirements,
STS0131, TR1965, TR2237, or NORSOK P-002:
| Scope | Class | Use |
|---|
| Gas scrubber conformance | neqsim.process.mechanicaldesign.separator.conformity.ConformityRuleSet.create("TR1965") | Checks TR1965 K-factor, gas/liquid margins, entrainment, and scrubber layout metadata configured on GasScrubberMechanicalDesign. |
| Blowdown fire acceptance | neqsim.process.safety.depressurization.STS0131AcceptanceCriteria | Evaluates DepressurizationResult against time-to-escape/time-to-rupture pressure, inventory, and escalated fire-rate limits. |
| Piping/line sizing | neqsim.process.mechanicaldesign.pipeline.NorsokP002LineSizingValidator | Screens PipeLineInterface velocity, pressure gradient, and erosional velocity using NORSOK P-002 style limits. |
| Leak detection sensitivity | neqsim.process.safety.leakdetection.MassBalanceLeakDetector | Estimates minimum detectable leak rate from flow, pressure, temperature, and linepack uncertainty. |
| Performance standards | neqsim.process.safety.barrier.TR2237Templates | Creates starter barrier registers with TR2237-style performance standards and NORSOK S-001 topic mappings. |
| Standards review | neqsim.process.safety.compliance.StandardsDesignReview | Converts supported calculated checks from a ProcessSystem into StandardsComplianceReport. |
| Overpressure LOPA targets | LOPAResult.getSTS0131OverpressureTargetFrequency(...) | Selects target event frequency from STS0131 pressure severity bands. |
| LEL endpoint policy | GasDispersionAnalyzer.builder().sts0131IntegralEndpoint() | Uses 20% LFL for integral dispersion tools; sts0131CfdEndpoint() uses 50% LFL. |
TR1965 Gas Scrubber Pattern
GasScrubber scrubber = new GasScrubber("inlet scrubber", feed);
scrubber.run();
scrubber.initMechanicalDesign();
GasScrubberMechanicalDesign design = scrubber.getMechanicalDesign();
design.setInnerDiameter(2.0);
design.setMeshPad(3.0, 100.0);
design.setLaHHElevationM(0.5);
design.setInletDeviceElevationM(1.2);
design.setMeshPadElevationM(2.3);
design.setLiquidEntrainmentLitresPerMSm3(5.0);
design.setLiquidDesignMarginFraction(0.25);
design.setConformityRules("TR1965");
ConformityReport report = design.checkConformity();
STS0131 Blowdown Acceptance Pattern
DepressurizationResult blowdown = simulator.run();
STS0131AcceptanceCriteria criteria = new STS0131AcceptanceCriteria()
.setTimeToEscapeS(120.0)
.setEstimatedTimeToRuptureS(300.0)
.setMaximumPressureAtRuptureBara(15.0)
.setMaximumRemainingMassKg(500.0)
.setMaximumEscalatedFireRateKgPerS(2.0);
STS0131AcceptanceResult acceptance = blowdown.evaluateSTS0131(criteria);
Database Query Pattern (Java)
import neqsim.util.database.NeqSimProcessDesignDataBase;
import java.sql.*;
try (Connection conn = NeqSimProcessDesignDataBase.createConnection()) {
String sql = "SELECT * FROM api_standards "
+ "WHERE EQUIPMENTTYPE = ? AND STANDARD_CODE = ?";
PreparedStatement stmt = conn.prepareStatement(sql);
stmt.setString(1, "Separator");
stmt.setString(2, "API-12J");
ResultSet rs = stmt.executeQuery();
while (rs.next()) {
String spec = rs.getString("SPECIFICATION");
double minVal = rs.getDouble("MINVALUE");
double maxVal = rs.getDouble("MAXVALUE");
String unit = rs.getString("UNIT");
}
}
Database Query Pattern (Python / Jupyter)
separator.initMechanicalDesign()
design = separator.getMechanicalDesign()
design.setDesignStandardCode("NORSOK-P-001")
design.setCompanySpecificDesignStandards("OperatorA")
design.readDesignSpecifications()
design.calcDesign()
print(design.toJson())
CSV Column Reference
All standards CSV files share this schema:
| Column | Type | Description |
|---|
STANDARD_CODE | String | Standard identifier (e.g., "API-12J", "NORSOK-P-001") |
VERSION | String | Edition/revision (e.g., "8th Ed", "Rev 5") |
EQUIPMENTTYPE | String | NeqSim class name (e.g., "Separator", "Compressor") |
SPECIFICATION | String | Parameter name (e.g., "GasLoadFactor", "SurgeMargin") |
MINVALUE | Double | Minimum allowed or typical low value |
MAXVALUE | Double | Maximum allowed or typical high value |
UNIT | String | Physical unit (e.g., "m/s", "%", "mm") |
DESCRIPTION | String | Human-readable description |
results.json — standards_applied Schema
Every task's results.json should include a standards_applied array:
"standards_applied": [
{
"code": "NORSOK P-001 Rev 5",
"scope": "Separator sizing — K-factor and retention time",
"status": "PASS",
"design_value": 0.13,
"limit": "0.12–0.15 m/s",
"unit": "m/s",
"clause": "Table A-1"
},
{
"code": "API 617 8th Ed",
"scope": "Compressor surge margin",
"status": "PASS",
"design_value": 12.5,
"limit": ">10%",
"unit": "%"
Required Fields
| Field | Type | Required | Description |
|---|
code | String | Yes | Standard code with version (e.g., "API 520 Part I 10th Ed") |
scope | String | Yes | What aspect was checked (e.g., "Relief valve sizing") |
status | String | Yes | PASS / FAIL / INFO / N/A |
design_value | Number | No | Calculated value from simulation |
limit | String | No | Standard's requirement or range |
unit | String | No | Unit for design_value and limit |
clause | String | No | Specific clause or table reference |
Status Values
| Status | Meaning |
|---|
PASS | Design value meets the standard's requirement |
FAIL | Design value violates the standard — action required |
INFO | Standard identified and noted, no pass/fail applicable |
N/A | Standard exists but does not apply to this specific case |
Risk & Safety Standards Quick-Reference
Risk Assessment (ISO 31000 / NORSOK Z-013)
NeqSim classes in neqsim.process.equipment.failure:
| Class | Standard | Purpose |
|---|
RiskMatrix | ISO 31000, NORSOK Z-013 | 5×5 risk matrix with likelihood × consequence |
RiskEvent | ISO 31000 | Individual risk event with probability and consequence |
RiskModel | ISO 31000, QRA | Monte Carlo simulation for risk quantification |
AutomaticScenarioGenerator | IEC 61882 (HAZOP) | HAZOP deviation generation (NO_FLOW, HIGH_PRESSURE, etc.) |
Safety Instrumented Systems (IEC 61508 / IEC 61511)
| Class | Standard | Purpose |
|---|
SafetyInstrumentedFunction | IEC 61508, IEC 61511 | SIF with SIL rating (1–4) and PFD calculation |
SISIntegratedRiskModel | IEC 61511, LOPA | Layer of Protection Analysis with IPL credit |
Fire & Depressuring (API 521)
| Class | Standard | Purpose |
|---|
FireProtectionDesign | API 521 | Fire case heat input, pool/jet fire modeling |
AlarmTripScheduleGenerator | IEC 61511, NORSOK I-001 | Alarm and trip schedule generation |
NoiseAssessment | ISO 9613, NORSOK S-002 | Equipment noise prediction |
Risk Proportionality by Task Scale
| Scale | Risk Requirement |
|---|
| Quick | Not required (unless safety-critical) |
| Standard | 3–5 line risk table with top risks and mitigation |
| Comprehensive | Full ISO 31000 risk register with 5×5 matrix, mitigation, ALARP |
Gas Quality Standards
NeqSim has extensive gas quality standard implementations in neqsim.standards.gasquality:
| Standard | Class | Purpose |
|---|
| ISO 6976 | Standard_ISO6976 | Calorific value, Wobbe index, relative density |
| ISO 12213 | Standard_ISO12213 | Compression factor (AGA 8) |
| ISO 13443 | Standard_ISO13443 | Natural gas — standard reference conditions |
| ISO 14687 | — | Hydrogen fuel quality |
| ISO 15403 | — | Natural gas for vehicles (CNG) |
| AGA 3 (API 14.3) | UKofficialOFGEM_ISO6976 | Orifice flow measurement |
| AGA 7 | — | Turbine flow measurement |
| GPA 2145 | Standard_ISO6976 (via) | Physical constants for hydrocarbons |
| EN 16723 | — | Biomethane injection quality |
| EN 16726 | — | Gas quality — H-gas specification |
Oil Quality Standards
In neqsim.standards.oilquality:
| Standard | Class | Purpose |
|---|
| ASTM D86 | Standard_ASTM_D86 | Distillation of petroleum products |
| ASTM D1160 | Standard_ASTM_D1160 | Vacuum distillation |
| ASTM D2887 | Standard_ASTM_D2887 | Simulated distillation (GC) |
| ASTM D6377 | Standard_ASTM_D6377 | Reid vapor pressure (VPCR4) |
Typical Standards by Task Type
Type A — Property Calculation
- ISO 6976 (gas properties), GERG-2008 (compressibility)
Type B — Process Simulation
- NORSOK P-001 (process design), API 12J (separators), API 617 (compressors), TEMA (heat exchangers)
Type C — PVT Study
- ISO 6976, GPA 2145, ASTM D86/D2887 (oil characterization)
Type D — Standards Compliance
- Direct application of the requested standard
Type E — Feature Implementation
- Standards that the new feature must implement
Type F — Mechanical Design
- ASME VIII (vessels), DNV-ST-F101 (subsea pipe), NORSOK L-001 (piping), API 5CT (casing)
Type G — Workflow / Field Development
- NORSOK Z-013 (risk), ISO 31000 (risk management), NORSOK P-001 (process), company TRs
Post-Simulation Standards Check Pattern
After running a process simulation, check key results against standards:
k_factor = separator.getInternalDiameter()
if k_factor < 0.12 or k_factor > 0.15:
print("WARNING: K-factor outside NORSOK P-001 range (0.12-0.15 m/s)")
standards_status = "FAIL"
else:
standards_status = "PASS"
Workflow Integration
- Phase 0 (Setup): Identify task type → look up applicable standards from mapping table above
- Phase 1 (Scope): List standards in
task_spec.md under "Applicable standards"
- Phase 2 (Analysis): Use standards values as design inputs and validation limits
- Phase 2 (Results): Populate
standards_applied array in results.json
- Phase 3 (Report): Standards compliance table auto-rendered in Word/HTML report
