TheTechIdea OilGas - Developer guide User guide →

TheTechIdea.OilGas.Drilling

20 public types. Summaries come from the XML documentation of the compiled assembly.

TheTechIdea.OilGas.Drilling

TypeSummary
CodeTimeclassTime per operation code.
DrillingPerformancestatic classDrilling performance from a daily drilling report: the time-depth curve, time per IADC operation code, non-productive time (company codes or the line's own flag) and the on-bottom rate of penetration; overlapping lines, unreported gaps and unknown codes are noted.
DrillingSettingsclassSettings of the drilling engineering toolbox (environment section toolboxes.drilling).
DrillingToolboxstatic classDrilling engineering toolbox: well planning, torque and drag, hydraulics, drilling performance.
FlowSectionclassA flow path section: inside pipe (Inner = 0) or an annulus (Outer = hole / casing ID, Inner = pipe OD).
Hydraulicsstatic classDrilling hydraulics with the textbook field-unit methods (Bourgoyne et al., Applied Drilling Engineering, ch. 4; Guo & Liu, Applied Drilling Circulation Systems): Bingham plastic laminar dp/dL = PV v / (1500 d^2) + YP / (225 d) (pipe), PV v / (1000 (d2-d1)^2) + YP / (200 (d2-d1)) (annulus); power-law laminar K v^n ((3 + 1/n) / 0.0416)^n / (144000 d^(1+n)) (pipe), K v^n ((2 + 1/n) / 0.0208)^n / (144000 (d2-d1)^(1+n)) (annulus); turbulent f rho v^2 / (25.8 d) (pipe), f rho v^2 / (21.1 (d2-d1)) (annulus), Fanning f = 0.0791 / Re^0.25; bit dp = 8.311e-5 rho q^2 / (Cd^2 A^2); ECD = rho + annular loss / (0.052 TVD). Field units: psi, ft, ft/s, in, cP, lbf/100 ft2, ppg, gpm. API RP 13D's Herschel-Bulkley method is not implemented.
HydraulicsResultclassResult of a circulating-system calculation (psi, ppg, hp, lbf).
MudRheologyclassMud rheology from rotational viscometer (Fann) readings at 600 and 300 rpm.
PerformanceResultclassDrilling performance of a well (depths in the report's unit).
PlanStationclassA point of a plan: measured depth, direction and position (north / east / TVD from the tie-on reference, plan unit).
ReportActivityclassOne line of a daily drilling report.
SectionLossclassPressure loss of one section (field units).
StringOperationenumDrill-string operation.
StringSectionclassOne section of the drill string, listed from the bit up.
TimeDepthViewclassTime-depth curve: days against depth (increasing downward), the plan dashed, non-productive periods shaded.
TorqueDragstatic classSoft-string torque and drag (Johancsik, Friesen & Dawson, SPE 11380, 1984): per element from the bit up, Fn = sqrt((Ft d-azimuth sin(inc)) ^2 + (Ft d-inclination + W sin(inc)) ^2), dFt = W cos(inc) +/- mu Fn (+ moving up, - moving down; 0 when rotating), dM = mu Fn r; W the buoyed element weight (steel density casingDesign.steelDensity), angles at the element's mean.
TorqueDragCaseclassInputs of a torque-and-drag run.
TorqueDragPointclassForce and torque at one point of the string (SI: m, N, N.m; tension positive).
TorqueDragResultclassResult of a torque-and-drag run (SI).
WellPlanclassA well plan of minimum-curvature sections (Sawaryn & Thorogood, SPE 84246, 2005): every section is a circular arc in a plane or a straight hold, so ends are exact. Sections: Hold, Curve (dogleg, toolface, length) and CurveHoldToTarget (the arc and hold that land on a target, solved in the plane of the current direction and the target). Doglegs are per the environment's dogleg course length.

CodeTime class

Time per operation code.

MemberSummary
string Code { get; set; }Code.
double Fraction { get; set; }Fraction of all reported time.
double Hours { get; set; }Hours.
string Name { get; set; }Operation name.

DrillingPerformance static class

Drilling performance from a daily drilling report: the time-depth curve, time per IADC operation code, non-productive time (company codes or the line's own flag) and the on-bottom rate of penetration; overlapping lines, unreported gaps and unknown codes are noted.

MemberSummary
static PerformanceResult Analyze(IEnumerable<ReportActivity> activities)Analyses the activities of a report.
static List<ReportActivity> FromCsv(string csv, List<string> warnings = null)Reads report lines from CSV: start,end,code,depth_from,depth_to,description,npt (ISO dates; invariant numbers; header line).

DrillingSettings class

Settings of the drilling engineering toolbox (environment section toolboxes.drilling).

MemberSummary
string DrillingCode { get; set; }The IADC code of on-bottom drilling (for the rate of penetration).
double? MaxDogleg { get; set; }Largest dogleg severity a plan may use (degrees per the survey's dogleg course length); none = no limit (company practice).
double NozzleDischargeCoefficient { get; set; }Nozzle discharge coefficient (0.95, Bourgoyne et al.).
List<string> NptCodes { get; set; }Codes counted as non-productive time (company policy - none by default); a report line's own NPT flag overrides.
Dictionary<string, string> OperationCodes { get; set; }Daily drilling report operation codes: the 23 original IADC DDR codes (IADC DDR Plus subcommittee, 27 Sep 2018); add your own or DDR Plus codes.
string RheologyModel { get; set; }Hydraulics: rheology model, "binghamPlastic" or "powerLaw" (textbook field methods; API RP 13D's Herschel-Bulkley method is not implemented).
Measure StationSpacing { get; set; }Spacing of the stations a plan is written out at. None: 30 m for a plan in metres, 100 ft for one in feet (as survey.doglegCourseLength does).
Measure TorqueDragElementLength { get; set; }Length of the elements the soft-string torque and drag model is worked in (the result converges as it shrinks, at the cost of time); used when a case does not set its own.
double TurbulentReynolds { get; set; }Reynolds number above which flow is taken as turbulent (2100).

DrillingToolbox static class

Drilling engineering toolbox: well planning, torque and drag, hydraulics, drilling performance.

MemberSummary
static DrillingSettings Settings { get; }The toolbox's settings in the current environment.
const string Name = "drilling"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.

FlowSection class

A flow path section: inside pipe (Inner = 0) or an annulus (Outer = hole / casing ID, Inner = pipe OD).

MemberSummary
Quantity Inner { get; set; }Pipe OD inside the annulus; null for flow inside pipe.
bool IsAnnulus { get; }Whether the section is an annulus.
Quantity Length { get; set; }Length.
string Name { get; set; }Name.
Quantity Outer { get; set; }Pipe ID, or the hole / casing ID of an annulus.

Hydraulics static class

Drilling hydraulics with the textbook field-unit methods (Bourgoyne et al., Applied Drilling Engineering, ch. 4; Guo &amp; Liu, Applied Drilling Circulation Systems): Bingham plastic laminar dp/dL = PV v / (1500 d^2) + YP / (225 d) (pipe), PV v / (1000 (d2-d1)^2) + YP / (200 (d2-d1)) (annulus); power-law laminar K v^n ((3 + 1/n) / 0.0416)^n / (144000 d^(1+n)) (pipe), K v^n ((2 + 1/n) / 0.0208)^n / (144000 (d2-d1)^(1+n)) (annulus); turbulent f rho v^2 / (25.8 d) (pipe), f rho v^2 / (21.1 (d2-d1)) (annulus), Fanning f = 0.0791 / Re^0.25; bit dp = 8.311e-5 rho q^2 / (Cd^2 A^2); ECD = rho + annular loss / (0.052 TVD). Field units: psi, ft, ft/s, in, cP, lbf/100 ft2, ppg, gpm. API RP 13D's Herschel-Bulkley method is not implemented.

MemberSummary
static double BitLoss(MudRheology mud, double q, IEnumerable<double> nozzles32nds)Bit pressure drop (psi) for nozzles given in 32nds of an inch.
static HydraulicsResult Circulate(MudRheology mud, Quantity flowRate, IEnumerable<FlowSection> sections, IEnumerable<double> nozzles32nds, Quantity bitTvd, Quantity surfaceLoss = null)The circulating system: string sections, bit nozzles, annular sections; ECD at the bit TVD.
static (double?, double, bool) Gradient(MudRheology mud, double q, double outer, double inner, bool annulus)Pressure-loss gradient (psi/ft) and regime of one section.
static double Velocity(double q, double outer, double inner = 0)Mean velocity (ft/s) of q gpm through a pipe or annulus (in).

HydraulicsResult class

Result of a circulating-system calculation (psi, ppg, hp, lbf).

MemberSummary
double? AnnularLoss { get; set; }Annular pressure loss (psi).
double BitHydraulicHorsepower { get; set; }Bit hydraulic horsepower = bit loss x q / 1714.
double BitLoss { get; set; }Bit pressure drop (psi).
double? Ecd { get; set; }Equivalent circulating density at the bit TVD (ppg).
double ImpactForce { get; set; }Jet impact force (lbf) = 0.01823 Cd q sqrt(rho bit loss).
List<string> Notes { get; }Notes (sections not computed ...).
List<SectionLoss> Sections { get; }Section losses, string first then annulus.
double? StandpipePressure { get; set; }Standpipe pressure = surface + string + bit + annulus (psi); null when a section was not computed.
double SurfaceLoss { get; set; }Surface equipment loss given (psi).

MudRheology class

Mud rheology from rotational viscometer (Fann) readings at 600 and 300 rpm.

MemberSummary
double DensityPpg { get; set; }Density (ppg).
double K { get; }Power-law consistency index K (eq. cP) = 510 theta300 / 511^n.
double N { get; }Power-law flow behaviour index n = 3.32 log10(theta600 / theta300).
double PlasticViscosity { get; }Plastic viscosity (cP) = theta600 - theta300.
double Theta300 { get; set; }300 rpm reading.
double Theta600 { get; set; }600 rpm reading.
double YieldPoint { get; }Yield point (lbf/100 ft2) = theta300 - PV.

PerformanceResult class

Drilling performance of a well (depths in the report's unit).

MemberSummary
List<CodeTime> ByCode { get; }Hours per code, most first.
List<string> Notes { get; }Overlaps, gaps and unknown codes.
double NptFraction { get; }NPT as a fraction of reported time.
double NptHours { get; set; }Non-productive hours.
List<(double, double, string)> NptPeriods { get; }Non-productive periods (days from, days to).
double? OnBottomRop { get; set; }On-bottom rate of penetration (depth unit per hour of drilling-code time); null without drilling footage.
List<(double, double)> TimeDepth { get; }Time-depth curve: days since the first activity and the hole depth reached.
double TotalHours { get; set; }All reported hours.

PlanStation class

A point of a plan: measured depth, direction and position (north / east / TVD from the tie-on reference, plan unit).

MemberSummary
double Azimuth { get; set; }Azimuth (deg, 0-360).
double Dls { get; set; }Dogleg severity of the section ending here (deg per the dogleg course length).
double East { get; set; }East.
double Inclination { get; set; }Inclination (deg).
double Md { get; set; }Measured depth.
double North { get; set; }North.
string Section { get; set; }Section the station ends ("tie-on", "hold", "curve").
double Tvd { get; set; }TVD.

ReportActivity class

One line of a daily drilling report.

MemberSummary
string Code { get; set; }Operation code (IADC).
double? DepthFrom { get; set; }Measured depth of the bit / hole at the start (optional).
double? DepthTo { get; set; }Measured depth at the end (optional; drilling lines carry the new hole depth).
string Description { get; set; }Description.
DateTime End { get; set; }End.
double Hours { get; }Hours.
bool? Npt { get; set; }Non-productive time as recorded (overrides drilling.nptCodes); null = by code.
DateTime Start { get; set; }Start.

SectionLoss class

Pressure loss of one section (field units).

MemberSummary
bool Annulus { get; set; }Annulus.
double? Loss { get; set; }Pressure loss (psi); null when the model does not cover the flow (turbulent power-law flow).
string Name { get; set; }The section.
double Reynolds { get; set; }Reynolds number.
bool Turbulent { get; set; }Turbulent.
double Velocity { get; set; }Mean velocity (ft/s).

StringOperation enum

Drill-string operation.

MemberSummary
TripOutPulling out of hole / picking up (friction adds to the hook load).
TripInRunning in hole / slacking off (friction reduces the hook load).
RotatingOffBottomRotating off bottom (friction acts on torque, not axially).
DrillingDrilling: rotating on bottom with weight and torque on bit.

StringSection class

One section of the drill string, listed from the bit up.

MemberSummary
Quantity Length { get; set; }Length.
string Name { get; set; }Name (bit, BHA, heavy-weight, drill pipe ...).
Quantity OuterDiameter { get; set; }Outside diameter used as the torque radius (tool joint for drill pipe).
Quantity WeightPerLength { get; set; }Weight per length in air (lbm/ft or kg/m).

TimeDepthView class

Time-depth curve: days against depth (increasing downward), the plan dashed, non-productive periods shaded.

Inherits / implements: ViewSurface

MemberSummary
string DepthUnit { get; set; }Depth unit label (the environment's depth unit unless set - the report's depths are taken to be in it).
List<(double, double)> Planned { get; }The planned curve (days, depth), optional.
PerformanceResult Result { get; set; }The performance shown.

TorqueDrag static class

Soft-string torque and drag (Johancsik, Friesen &amp; Dawson, SPE 11380, 1984): per element from the bit up, Fn = sqrt((Ft d-azimuth sin(inc)) ^2 + (Ft d-inclination + W sin(inc)) ^2), dFt = W cos(inc) +/- mu Fn (+ moving up, - moving down; 0 when rotating), dM = mu Fn r; W the buoyed element weight (steel density casingDesign.steelDensity), angles at the element's mean.

MemberSummary
static TorqueDragResult Run(Trajectory trajectory, IReadOnlyList<StringSection> stringFromBit, TorqueDragCase c)Runs the model along a trajectory (surveyed or planned) for a string listed from the bit up, the bit at the trajectory's last MD.

TorqueDragCase class

Inputs of a torque-and-drag run.

MemberSummary
double BitTension { get; set; }Axial force at the bottom of the string for the other operations (N, tension positive - e.g. an overpull on a stuck tool).
double BitTorque { get; set; }Torque at the bit (Drilling), N.m.
double CasedFriction { get; set; }Friction factor in cased hole (field-calibrated; required).
Quantity ElementLength { get; set; }Element length (the soft-string model converges as it shrinks); none: drilling.torqueDragElementLength.
Measure MudDensity { get; set; }Mud density (buoyancy), e.g. ppg or g/cm3.
double OpenHoleFriction { get; set; }Friction factor in open hole (field-calibrated; required).
StringOperation Operation { get; set; }The operation.
Quantity ShoeDepth { get; set; }Casing shoe MD: cased above, open hole below (none: all cased).
Quantity WeightOnBit { get; set; }Weight on bit (Drilling).

TorqueDragPoint class

Force and torque at one point of the string (SI: m, N, N.m; tension positive).

MemberSummary
double Md { get; set; }Measured depth (m).
double NormalForce { get; set; }Side (normal) force of the element below this point (N).
double Tension { get; set; }Axial tension (N; negative = compression).
double Torque { get; set; }Torque (N.m).

TorqueDragResult class

Result of a torque-and-drag run (SI).

MemberSummary
List<double> CompressionDepths { get; }Depths where the string is in compression (m).
double HookLoad { get; }Hook load at surface (N).
List<TorqueDragPoint> Points { get; }Points from surface down (Md ascending).
double SurfaceTorque { get; }Surface torque (N.m).

WellPlan class

A well plan of minimum-curvature sections (Sawaryn &amp; Thorogood, SPE 84246, 2005): every section is a circular arc in a plane or a straight hold, so ends are exact. Sections: Hold, Curve (dogleg, toolface, length) and CurveHoldToTarget (the arc and hold that land on a target, solved in the plane of the current direction and the target). Doglegs are per the environment's dogleg course length.

MemberSummary
string Unit { get; }Unit of depths and positions.
List<string> Warnings { get; }Problems found while planning (dogleg above the limit ...).
WellPlan Curve(double dogleg, double toolface, double length)An arc at a dogleg severity (deg per course length) in the toolface direction (deg: 0 build, 90 right, 180 drop, 270 left; vertical hole: from north) for a length.
WellPlan CurveHoldToTarget(double dogleg, double north, double east, double tvd)The arc (at a dogleg severity) and hold that land exactly on a target (north, east, TVD); throws when the target is inside the turning circle.
WellPlan Hold(double length)A straight section.
static WellPlan Start(string unit, double md = 0, double north = 0, double east = 0, double tvd = 0, double inclination = 0, double azimuth = 0)Starts a plan at a tie-on point.
List<PlanStation> Stations(double? spacing = null)The plan's stations at the given spacing (default drilling.stationSpacing), section ends included.
WellModel ToWellModel(WellHeader header = null, double? spacing = null)The plan as survey stations of a well model (for the views, uncertainty and anti-collision).