neqsim-standards-lookup

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:

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:

TR/NORSOK Integration Classes

Use these Java classes when a task references Equinor technical requirements, STS0131, TR1965, TR2237, or NORSOK P-002:

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)

// 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)

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

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": "%",
    "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

Status Values

Risk & Safety Standards Quick-Reference

Risk Assessment (ISO 31000 / NORSOK Z-013)

NeqSim classes in neqsim.process.equipment.failure:

Safety Instrumented Systems (IEC 61508 / IEC 61511)

Fire & Depressuring (API 521)

Risk Proportionality by Task Scale

Gas Quality Standards

NeqSim has extensive gas quality standard implementations in neqsim.standards.gasquality:

Oil Quality Standards

In neqsim.standards.oilquality:

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:

# 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