TheTechIdea.OilGas.Integrity
22 public types. Summaries come from the XML documentation of the compiled assembly.
TheTechIdea.OilGas.Integrity
| Type | Summary |
|---|---|
CasingPressureDiagnosticstatic class | Classification of a bleed-down / build-up test per API RP 90 and BSEE NTL 2009-G01: above 100 psig a test is required; sustained casing pressure must bleed to 0 psig (1/2-inch needle valve) within 24 hours; pressure that rebuilds after bleed-down is sustained; pressure above the MAWOP is a departure. RP 90: not meeting the criteria does not by itself mean the risk is unacceptable - it calls for a risk assessment. |
CasingPressureFindingclass | Outcome of a diagnostic test (pressures in psi). |
CasingPressureSettingsclass | Annular casing pressure criteria (API RP 90; BSEE NTL 2009-G01 / 30 CFR 250 subpart E) - defaults as published, every value a setting. |
CasingPressureTestclass | A bleed-down / build-up diagnostic test of an annulus: readings, when bleeding started and when the valve was closed. |
CorrosionRowclass | One joint's row (depths in the document's unit; pressures psi; fractions 0..1). |
CorrosionTrackclass | Corroded joints beside the schematic: penetration and class, re-rated burst / collapse against nominal, design factors. |
DamageClassclass | A damage class: joints whose maximum penetration is at least PenetrationFrom (fraction of the wall). |
FieldIntegritystatic class | A field's integrity: the wells by category, worst first. |
IntegrityBoardViewclass | A field's well integrity board: wells as tiles in their guideline-117 category colours, worst first, with the counts. |
IntegrityCategoryenum | Well integrity categories of Norwegian Oil and Gas / Offshore Norge guideline 117 (most severe last). |
IntegrityInputsclass | What is known about a well beyond its barrier set. |
IntegritySettingsclass | Settings of the well integrity toolbox (environment section toolboxes.integrity). |
IntegrityStatusstatic class | Well integrity categorisation per Norwegian Oil and Gas / Offshore Norge guideline 117: Red - one barrier failure and the other degraded / not verified, or leak to surface; Orange - one barrier failure and the other intact, or a single failure may lead to leak to surface (an element common to both envelopes); Yellow - one barrier degraded, the other intact; Green - healthy. Annuli: pressure that cannot be kept below its criteria (above MAWOP) is Orange; a leak rate above its criteria (not bleeding to zero) is Orange, or Red when the pressure criteria are not met either. Impaired is the guideline's "degraded", Unverified its "not verified". |
IntegrityToolboxstatic class | Well integrity toolbox: multi-finger caliper wall loss, corroded-pipe re-rating, sustained casing pressure, integrity status. |
JointRatingclass | A corroded joint re-rated with the API 5C3 formulas at its measured wall (psi, lbf, inches). |
Mawopstatic class | Maximum allowable wellhead operating pressure of an annulus (API RP 90; BSEE NTL 2009-G01): the lesser of 50 % of the MIYP of the casing being evaluated, 80 % of the MIYP of the next outer casing (for the outermost casing 30 % of its own MIYP instead) and 75 % of the minimum collapse pressure of the inner tubular - MIYP and collapse from the API 5C3 ratings (CasingDesign). Fractions are settings. |
MawopResultclass | The MAWOP of an annulus and how it was found (psi). |
MfcAnalysisstatic class | Multi-finger caliper interpretation per KAPPA "Multifinger Caliper Interpretation and Applications" (Kotlar): readings centred on a fitted eccentric circle (optionally without the worst-fitting fingers); penetration = (2 RADMAX - ID) / (OD - ID); reduction = (ID/2 - RADMIN) / (ID/2); ovality = (IDMAX - IDMIN) / IDAVG from opposite fingers; areal metal loss = sum(Si^2 - ID^2) / (n (OD^2 - ID^2)), Si = 2 x finger radius (as stated in GOWell interpretation reports); remaining wall = (OD - 2 RADMAX) / 2 with the nominal OD (a caliper cannot see external corrosion). Nominal OD / ID: the innermost string covering each depth. |
MfcJointclass | Statistics of one joint (depths in the log's index unit; diameters / walls in inches; fractions 0..1). |
MfcResultclass | Result of a multi-finger caliper analysis. |
Reratingstatic class | Re-rating of corroded joints: the API TR 5C3 burst / collapse / tension formulas (CasingDesign) at the measured wall - the minimum wall at the deepest penetration or the average wall of the areal metal loss (integrity.wallBasis) - with the nominal OD (KAPPA, "Multifinger Caliper Interpretation and Applications", section 5: the API formulas are functions of the wall; a caliper does not see external corrosion). Loads and design factors as the casing design check. |
WellIntegrityclass | A well's integrity category with its reasons. |
CasingPressureDiagnostic static class
Classification of a bleed-down / build-up test per API RP 90 and BSEE NTL 2009-G01: above 100 psig a test is required; sustained casing pressure must bleed to 0 psig (1/2-inch needle valve) within 24 hours; pressure that rebuilds after bleed-down is sustained; pressure above the MAWOP is a departure. RP 90: not meeting the criteria does not by itself mean the risk is unacceptable - it calls for a risk assessment.
| Member | Summary |
|---|---|
static CasingPressureFinding Classify(CasingPressureTest test, double? mawopPsi = null) | Classifies a diagnostic test against the annulus's MAWOP (psi, optional). |
CasingPressureFinding class
Outcome of a diagnostic test (pressures in psi).
| Member | Summary |
|---|---|
bool AboveThreshold { get; set; } | Above the diagnostic threshold (a test is required). |
bool BledToZero { get; set; } | Bled to zero within the allowed hours. |
List<string> Departures { get; } | The findings that do not meet the criteria (each needs a departure / risk assessment under API RP 90). |
bool? ExceedsMawop { get; set; } | The pressure exceeded the MAWOP (null: no MAWOP). |
double? HoursToZero { get; set; } | Hours to bleed to zero (null: did not reach zero). |
double InitialPressure { get; set; } | Pressure when bleeding started. |
double MaximumBuildUp { get; set; } | Highest pressure in the build-up period. |
double MinimumBleedPressure { get; set; } | Lowest pressure during the bleed-down. |
string Summary { get; set; } | Summary. |
bool Sustained { get; set; } | The pressure rebuilt after bleed-down: sustained casing pressure. |
CasingPressureSettings class
Annular casing pressure criteria (API RP 90; BSEE NTL 2009-G01 / 30 CFR 250 subpart E) - defaults as published, every value a setting.
| Member | Summary |
|---|---|
double BleedHours { get; set; } | Hours within which sustained casing pressure must bleed to zero (through a 1/2-inch needle valve): 24. |
double BuildUpHours { get; set; } | Hours of build-up observed after the valve is closed: 24. |
double CasingBurstFraction { get; set; } | MAWOP: fraction of the MIYP of the casing being evaluated (0.50). |
Measure DiagnosticThreshold { get; set; } | Casing pressure above which a diagnostic (bleed-down / build-up) test is required: 100 psig (API RP 90, BSEE NTL 2009-G01). |
double InnerCollapseFraction { get; set; } | MAWOP: fraction of the minimum collapse pressure of the inner tubular (0.75). |
double OuterBurstFraction { get; set; } | MAWOP: fraction of the MIYP of the next outer casing (0.80). |
double OutermostBurstFraction { get; set; } | MAWOP of the outermost casing: fraction of its own MIYP, in place of the next-outer term (0.30). |
Measure ZeroTolerance { get; set; } | Pressure counted as bled to zero (0 psig as the regulation states it; raise for gauge resolution). |
CasingPressureTest class
A bleed-down / build-up diagnostic test of an annulus: readings, when bleeding started and when the valve was closed.
| Member | Summary |
|---|---|
string Annulus { get; set; } | Annulus name. |
DateTime BleedStart { get; set; } | Time the bleed-down started. |
List<AnnulusPressureReading> Readings { get; } | Pressure readings (any pressure unit), in time order. |
DateTime ValveClosed { get; set; } | Time the valve was closed (build-up starts). |
CorrosionRow class
One joint's row (depths in the document's unit; pressures psi; fractions 0..1).
| Member | Summary |
|---|---|
float Bottom { get; set; } | Bottom depth. |
double? Burst { get; set; } | Re-rated burst (psi). |
double? BurstFactor { get; set; } | Burst design factor. |
double? Collapse { get; set; } | Re-rated collapse (psi). |
double? CollapseFactor { get; set; } | Collapse design factor. |
string DamageClass { get; set; } | Damage class. |
int Joint { get; set; } | Joint number. |
double? NominalBurst { get; set; } | Nominal burst (psi). |
double? NominalCollapse { get; set; } | Nominal collapse (psi). |
bool? Pass { get; set; } | Pass (null: not checked). |
double? Penetration { get; set; } | Maximum penetration. |
float Top { get; set; } | Top depth. |
CorrosionTrack class
Corroded joints beside the schematic: penetration and class, re-rated burst / collapse against nominal, design factors.
Inherits / implements: WellTrack, ITrackFrame
| Member | Summary |
|---|---|
List<CorrosionRow> Rows { get; } | Rows, one per joint. |
string TypeKey { get; } | Stable key of the track type, written to documents and used to recreate the track (see WellTrackTypeAttribute). |
const string TypeKeyValue = "corrosion" | Type key. |
void ConvertDepthUnit(DepthUnit from, DepthUnit to) | Converts depth data the track stores in the document axis unit (called by DepthUnit) and Boolean)). Tracks whose data carries its own unit (e.g. schematics) need not override. |
void DrawContent(SKCanvas canvas, WellTrackContext ctx) | Draws into the plot (and, if needed, the reserve band). Clipped to the track below its header. |
static CorrosionTrack FromRatings(IEnumerable<JointRating> ratings, string fromUnit, DepthUnit unit) | The track from re-rated joints, in unit (joint depths are in fromUnit, the caliper's index unit). |
void LoadPayload(JsonObject payload) | Restores the type-specific settings written by SavePayload (null: keep the defaults). |
string ReadoutAt(WellTrackContext context, float depth) | Cursor readout at depth (axis units), e.g. "GR 65.2 API"; null = nothing to show. |
JsonObject SavePayload() | Type-specific settings for persistence. |
DamageClass class
A damage class: joints whose maximum penetration is at least PenetrationFrom (fraction of the wall).
| Member | Summary |
|---|---|
string Color { get; set; } | Colour on the views. |
string Name { get; set; } | Class name. |
double PenetrationFrom { get; set; } | Lowest maximum penetration (fraction of the nominal wall, 0..1) of the class. |
FieldIntegrity static class
A field's integrity: the wells by category, worst first.
| Member | Summary |
|---|---|
static Dictionary<IntegrityCategory, int> Counts(IEnumerable<WellIntegrity> wells) | Wells per category. |
static string ToCsv(IEnumerable<WellIntegrity> wells) | The field as CSV. |
static List<WellIntegrity> WorstFirst(IEnumerable<WellIntegrity> wells) | Wells worst first (then by name). |
IntegrityBoardView class
A field's well integrity board: wells as tiles in their guideline-117 category colours, worst first, with the counts.
Inherits / implements: ViewSurface
| Member | Summary |
|---|---|
int Columns { get; set; } | Tiles per row. |
List<WellIntegrity> Wells { get; } | The wells shown. |
IntegrityCategory enum
Well integrity categories of Norwegian Oil and Gas / Offshore Norge guideline 117 (most severe last).
| Member | Summary |
|---|---|
Green | Healthy well - no or minor integrity issue. |
Yellow | One barrier degraded, the other is intact. |
Orange | One barrier failure and the other is intact, or a single failure may lead to leak to surface. |
Red | One barrier failure and the other is degraded / not verified, or leak to surface. |
IntegrityInputs class
What is known about a well beyond its barrier set.
| Member | Summary |
|---|---|
Dictionary<string, CasingPressureFinding> Annuli { get; } | Diagnostic findings per annulus name. |
List<JointRating> Joints { get; } | Re-rated joints (a joint failing its design factors degrades the barrier elements of its string). |
bool LeakToSurface { get; set; } | A leak to surface has been observed. |
IntegritySettings class
Settings of the well integrity toolbox (environment section toolboxes.integrity).
| Member | Summary |
|---|---|
CasingPressureSettings CasingPressure { get; set; } | Annular casing pressure criteria (API RP 90). |
Dictionary<string, string> CategoryColors { get; set; } | Colours of the well integrity categories (Norwegian Oil and Gas / Offshore Norge guideline 117) on the board. |
string CclMnemonic { get; set; } | Mnemonic of the casing collar locator curve (joint boundaries). |
double? CclThreshold { get; set; } | CCL value above which a connection is detected; none = joints are not detected from the CCL (tool- and company-specific). |
bool Centralize { get; set; } | Centre the readings on a fitted eccentric circle before the statistics (KAPPA: required with an eccentric tool). |
Measure ConnectionExclusion { get; set; } | Length left out of the joint statistics on each side of a connection (the pipe the connection affects). |
List<DamageClass> DamageClasses { get; set; } | Damage classes by maximum penetration (company practice - none by default; vendors use their own scales). |
int ExcludeFingers { get; set; } | Fingers with the largest misfit left out of the centring fit (the ones in defects); 0 = all fingers. |
string FingerCurves { get; set; } | Regular expression of the multi-finger caliper's finger-radius curve mnemonics (one curve per finger, numbered in order around the tool). |
string WallBasis { get; set; } | Wall used to re-rate a corroded joint: "minimumWall" (at the deepest penetration - conservative) or "averageWall" (the uniform wall with the joint's areal metal loss - KAPPA: isolated pitting leaks rather than weakening the pipe; an interdisciplinary decision). |
IntegrityStatus static class
Well integrity categorisation per Norwegian Oil and Gas / Offshore Norge guideline 117: Red - one barrier failure and the other degraded / not verified, or leak to surface; Orange - one barrier failure and the other intact, or a single failure may lead to leak to surface (an element common to both envelopes); Yellow - one barrier degraded, the other intact; Green - healthy. Annuli: pressure that cannot be kept below its criteria (above MAWOP) is Orange; a leak rate above its criteria (not bleeding to zero) is Orange, or Red when the pressure criteria are not met either. Impaired is the guideline's "degraded", Unverified its "not verified".
| Member | Summary |
|---|---|
static WellIntegrity Assess(WellModel model, IntegrityInputs inputs = null) | Assesses a well from its latest as-built barrier set and the other inputs. |
IntegrityToolbox static class
Well integrity toolbox: multi-finger caliper wall loss, corroded-pipe re-rating, sustained casing pressure, integrity status.
| Member | Summary |
|---|---|
static IntegritySettings Settings { get; } | The toolbox's settings in the current environment. |
const string Name = "integrity" | Section name in the environment's toolboxes. |
static void Register() | Registers the toolbox with the environment (idempotent); hosts call it at start-up, the toolbox's own entry points call it too. |
JointRating class
A corroded joint re-rated with the API 5C3 formulas at its measured wall (psi, lbf, inches).
| Member | Summary |
|---|---|
double? Burst { get; set; } | Burst at the wall used (psi). |
double? BurstFactor { get; } | Burst design factor. |
double? BurstLoad { get; set; } | Burst load (psi). |
double? Collapse { get; set; } | Collapse at the wall used (psi). |
double? CollapseFactor { get; } | Collapse design factor. |
double? CollapseLoad { get; set; } | Collapse load (psi). |
string CollapseRegime { get; set; } | Collapse regime at the wall used. |
string Grade { get; set; } | Grade. |
MfcJoint Joint { get; set; } | The joint's caliper statistics. |
double? NominalBurst { get; set; } | Burst at the nominal wall (psi). |
double? NominalCollapse { get; set; } | Collapse at the nominal wall (psi). |
double? NominalTension { get; set; } | Tension at the nominal wall (lbf). |
double? NominalWall { get; set; } | Nominal wall (in). |
List<string> Notes { get; } | Why the joint could not be (fully) rated. |
bool? Pass { get; set; } | Whether every computed design factor meets casingDesign.designFactors (null: nothing checked). |
string StringName { get; set; } | String the joint belongs to. |
double? Tension { get; set; } | Tension at the wall used (lbf). |
double? TensionFactor { get; } | Tension design factor. |
double? TensionLoad { get; set; } | Tension load (lbf). |
double? Wall { get; set; } | Wall used (in) - minimum or average, per integrity.wallBasis. |
Mawop static class
Maximum allowable wellhead operating pressure of an annulus (API RP 90; BSEE NTL 2009-G01): the lesser of 50 % of the MIYP of the casing being evaluated, 80 % of the MIYP of the next outer casing (for the outermost casing 30 % of its own MIYP instead) and 75 % of the minimum collapse pressure of the inner tubular - MIYP and collapse from the API 5C3 ratings (CasingDesign). Fractions are settings.
| Member | Summary |
|---|---|
static MawopResult For(WellModel model, AnnulusInfo annulus) | The MAWOP of an annulus of the model. |
MawopResult class
The MAWOP of an annulus and how it was found (psi).
| Member | Summary |
|---|---|
string Annulus { get; set; } | Annulus name. |
string Governing { get; set; } | The term that governs. |
double? Mawop { get; set; } | MAWOP (psi); null when a rating needed is missing. |
List<string> Notes { get; } | Missing data and differences from the recorded MAWOP. |
List<(string, double)> Terms { get; } | The terms: description and value (psi). |
MfcAnalysis static class
Multi-finger caliper interpretation per KAPPA "Multifinger Caliper Interpretation and Applications" (Kotlar): readings centred on a fitted eccentric circle (optionally without the worst-fitting fingers); penetration = (2 RADMAX - ID) / (OD - ID); reduction = (ID/2 - RADMIN) / (ID/2); ovality = (IDMAX - IDMIN) / IDAVG from opposite fingers; areal metal loss = sum(Si^2 - ID^2) / (n (OD^2 - ID^2)), Si = 2 x finger radius (as stated in GOWell interpretation reports); remaining wall = (OD - 2 RADMAX) / 2 with the nominal OD (a caliper cannot see external corrosion). Nominal OD / ID: the innermost string covering each depth.
| Member | Summary |
|---|---|
static MfcResult Analyze(WellModel model, LogSet set, IReadOnlyList<(double, double)> joints = null, List<string> warnings = null) | Analyses the caliper log set of a model (nominal pipe from the model's strings; joints given, from the CCL, or by interval). |
static string JointsCsv(MfcResult r) | The joint table as CSV: invariant numbers, in the environment's units (depths in units.depthUnit, wall and ID in units.diameterUnit), each column named with its unit. |
MfcJoint class
Statistics of one joint (depths in the log's index unit; diameters / walls in inches; fractions 0..1).
| Member | Summary |
|---|---|
double Bottom { get; set; } | Bottom depth. |
string DamageClass { get; set; } | Damage class (environment's damage classes), if any. |
double? MaxMetalLoss { get; set; } | Maximum areal metal loss (fraction of the nominal wall area). |
double? MaxOvality { get; set; } | Maximum ovality. |
double? MaxPenetration { get; set; } | Maximum penetration (fraction of the nominal wall). |
double? MaxPenetrationDepth { get; set; } | Depth of the maximum penetration. |
double? MinId { get; set; } | Minimum ID (2 x minimum radius, in). |
double? MinRemainingWall { get; set; } | Minimum remaining wall at the deepest penetration (in, nominal OD assumed). |
(double, double) Nominal { get; set; } | Nominal OD / ID used (in). |
int Number { get; set; } | Joint number (top down). |
double Top { get; set; } | Top depth. |
string Unit { get; set; } | Unit of Top, Bottom and MaxPenetrationDepth (the caliper log's index unit). |
MfcResult class
Result of a multi-finger caliper analysis.
| Member | Summary |
|---|---|
LogSet Curves { get; set; } | Per-depth statistics as curves (PENE, MLOSS, REDU, OVAL, IDMAX, IDMIN, RWALL, ECC) on the caliper's index. |
List<string> Fingers { get; } | Fingers used (mnemonics, in order). |
List<MfcJoint> Joints { get; } | Per-joint statistics, top down. |
string JointSource { get; set; } | How the joints were found: "given", "ccl" or "intervals" (no joint boundaries - one segment per nominal interval). |
Rerating static class
Re-rating of corroded joints: the API TR 5C3 burst / collapse / tension formulas (CasingDesign) at the measured wall - the minimum wall at the deepest penetration or the average wall of the areal metal loss (integrity.wallBasis) - with the nominal OD (KAPPA, "Multifinger Caliper Interpretation and Applications", section 5: the API formulas are functions of the wall; a caliper does not see external corrosion). Loads and design factors as the casing design check.
| Member | Summary |
|---|---|
static List<JointRating> Rerate(WellModel model, MfcResult mfc, CasingLoadCase loads = null, List<string> warnings = null) | Re-rates the joints of a caliper analysis. |
static string ToCsv(IEnumerable<JointRating> ratings) | The re-rating as CSV: invariant numbers in the environment's units (depths in units.depthUnit, walls in units.diameterUnit, pressures in units.pressureUnit, tension in units.forceUnit), each column named with its unit. The calculation itself is in inches, psi and lbf. |
WellIntegrity class
A well's integrity category with its reasons.
| Member | Summary |
|---|---|
IntegrityCategory Category { get; set; } | Category. |
bool Compliant { get; } | Green and yellow comply with the two-barrier principle; orange and red do not (guideline 117). |
Dictionary<string, BarrierElementStatus> Envelopes { get; } | State of each envelope (role: Intact, Unverified, Impaired or Failed). |
List<string> Reasons { get; } | Why the well is in its category. |
string Well { get; set; } | Well name. |