neqsim-process-extraction

NeqSim Process Extraction Skill

Convert unstructured engineering information into the canonical NeqSim JSON format accepted by ProcessSystem.fromJson() and ProcessSystem.fromJsonAndRun().

Core Principle

Extract structured data into a constrained JSON schema. Do NOT write NeqSim Java/Python code.

The JSON schema is finite and well-defined. ProcessSystem.fromJson() handles all NeqSim API calls deterministically. Errors come back as structured, actionable messages.

P&ID operational workflow: When the source is a P&ID and the user asks about a valve action, active train, isolation boundary, bypass, drain, vent, or control-loop behavior, load neqsim-pid-process-operations. Extract both the steady-state topology and the model delta needed to simulate the action.

Exception for route hydraulics: When the source is a STID/E3D/P&ID/stress-isometric line-list table with serial pipe segments, use neqsim.process.equipment.pipeline.routing.PipingRouteBuilder rather than the generic JSON process builder. The route builder preserves line-list segment metadata, K-value minor losses, elevations, and explicit connection topology.

Architecture decision (MANDATORY): Before assembling JSON, classify the process complexity. Small/medium processes (≤ ~15 units, single recycle loop) use a single ProcessSystem. Large processes (multiple plant areas, cross-area recycles, different fluids) must be split into multiple ProcessSystem objects composed inside a ProcessModule, or use pre-built ProcessModuleBaseClass implementations. See Section 16 for the decision guide.

---

1. Target JSON Schema

Every extraction must produce JSON matching this format:

{
  "fluid": {
    "model": "SRK",
    "temperature": 323.15,
    "pressure": 65.0,
    "mixingRule": "classic",
    "multiPhaseCheck": false,
    "components": {
      "methane": 0.80,
      "ethane": 0.08,
      "propane": 0.05,
      "CO2": 0.03,
      "n-butane": 0.02,
      "nitrogen": 0.01,
      "n-pentane": 0.005,
      "n-hexane": 0.005
    }
  },
  "process": [
    {"type": "Stream", "name": "well stream", "properties": {"flowRate": [75000.0, "kg/hr"]}},
    {"type": "ThreePhaseSeparator", "name": "inlet separator", "inlet": "well stream"},
    {"type": "Compressor", "name": "export compressor", "inlet": "inlet separator.gasOut",
     "properties": {"outletPressure": 120.0, "isentropicEfficiency": 0.78}},
    {"type": "ThrottlingValve", "name": "letdown valve", "inlet": "inlet separator.oilOut",
     "properties": {"outletPressure": 15.0}}
  ],
  "autoRun": true
}