neqsim-reference-fluid-synthetic-generation

Generate representative reservoir fluid cases by calibrating split factors and blending compositions.

4|2|Updated May 31, 2026
One-click install
npx skills add https://github.com/equinor/neqsim-community-skills --skill neqsim-reference-fluid-synthetic-generation-equinor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neqsim-reference-fluid-synthetic-generation
Source: https://github.com/equinor/neqsim-community-skills/tree/main/skills/pvt/reference-fluid-synthetic-generation
Command: npx skills add https://github.com/equinor/neqsim-community-skills --skill neqsim-reference-fluid-synthetic-generation-equinor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reservoir and process engineers often need a fluid model before any laboratory PVT study exists, or need to adapt one common reference fluid to many wells and fields. This Skill provides dependency-free Python helpers to calibrate a heavy-end split factor against measured data, generate representative fluid cases, blend well streams into a field composition, and build a documented best-guess fluid basis from analogues when no PVT report exists. ## Core Features & Use Cases - Split-factor calibration: match_split_factor runs a golden-section search over a caller-injected forward model to match measured saturation pressure, GOR, or stock-tank density. - Case generation and blending: generate_fluid_cases builds low/base/high fluids from a reference, and blend_compositions combines well streams by molar-rate allocation into one field composition. - No-PVT fluid basis: build_analogue_fluid_basis derives reservoir temperature from geothermal gradients, classifies fluid type from GOR/API bands, interpolates analogue depth trends, and produces an assumption register with provenance and confidence grading. - Use Case: For a North Sea discovery at 3590 m TVDSS with no samples, build a declared best-guess fluid basis with low/base/high GOR and gravity cases, then tune a NeqSim EOS characterization to the base case. ## Quick Start Ask the agent to build an analogue fluid basis for a discovery at a given depth and province, then calibrate a split factor against a measured saturation pressure using the reference_fluid helpers.

Frequently Asked Questions about neqsim-reference-fluid-synthetic-generation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I calibrate a fluid split factor against measured PVT data?▼

Use match_split_factor with an objective function wrapping your forward model, such as squared relative residuals on saturation pressure. It runs a golden-section search over a bounded interval and returns the best factor, objective value, and convergence flag.

How to build a reservoir fluid when there is no PVT report?▼

Call build_analogue_fluid_basis with depth, sea area, and any measured values. It derives temperature from a geothermal gradient, classifies fluid type from GOR/API bands, interpolates analogue depth trends, and returns low/base/high cases with an assumption register.

How do I combine multiple well compositions into one field fluid?▼

Use blend_compositions with (molar_rate, composition) pairs for each well. It converts mole fractions to moles using each stream's rate, sums per component, and renormalizes, returning the field composition and allocation weights.

Does this skill depend on NeqSim or a specific equation of state?▼

No, the helpers are dependency-free and plant-agnostic; the forward model and fluid builder are injected by the caller. In practice they wrap NeqSim characterization classes like PlusFractionModel or a gamma split, but nothing is imported by default.

Why does a quoted GOR value cause matching errors?▼

GOR definitions differ by up to 20% on the same fluid: single-stage flash, black-oil Rs at bubble point, and separator-train values are not interchangeable. Use reconcile_gor_definitions to report the spread and identify which definition a quoted value matches.

What are the limitations of analogue-based fluid generation?▼

It is screening-level only: derived pressures from hydrostatic gradients can be wrong by hundreds of bar in overpressured sections, and results require qualified PVT review. The confidence grading flags any basis built on placeholder parameters as conditional.