neqsim-standards-lookup git:20260802.7e08a95A

Immutable. This exact content is served forever at /api/v1/blob/62c17fbd07411f9f.

---
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_standards.csv` |
| 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` |
| CO2 corrosion / materials selection | NORSOK M-506, ISO 15156 / NACE MR0175, NORSOK M-001 | `norsok_standards.csv` — see `NorsokM506CorrosionRate` / `NorsokM506ElectrolyteBridge` (`process.corrosion`) |
| Mineral scale / produced water | (industry practice; Davies + Ksp(T)) | `ElectrolyteScaleCalculator` / `ScaleKinetics` / `BrineMixingScaleEvaluator` (`process.chemistry.scale`) |

### 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

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

```java
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

```java
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)

```java
// Query standards values for a specific equipment type
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)

```python
# Query via mechanical design classes
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:

```json
"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": "%",
    "clause": "Section 2.6"
  },
  {
    "code": "DNV-ST-F101",
    "scope": "Pipeline wall thickness",
    "status": "INFO",
    "design_value": null,
    "limit": null,
    "unit": null,
    "clause": "Not applied — onshore pipeline"
  }
]
```

### 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:

```python
# Example: Check separator K-factor against NORSOK P-001
k_factor = separator.getInternalDiameter()  # Get from results
# Look up limit from standards database
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

1. **Phase 0 (Setup)**: Identify task type → look up applicable standards from mapping table above
2. **Phase 1 (Scope)**: List standards in `task_spec.md` under "Applicable standards"
3. **Phase 2 (Analysis)**: Use standards values as design inputs and validation limits
4. **Phase 2 (Results)**: Populate `standards_applied` array in `results.json`
5. **Phase 3 (Report)**: Standards compliance table auto-rendered in Word/HTML report