TheTechIdea.OilGas.Drilling
20 public types. Summaries come from the XML documentation of the compiled assembly.
TheTechIdea.OilGas.Drilling
| Type | Summary |
|---|---|
CodeTimeclass | Time per operation code. |
DrillingPerformancestatic 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. |
DrillingSettingsclass | Settings of the drilling engineering toolbox (environment section toolboxes.drilling). |
DrillingToolboxstatic class | Drilling engineering toolbox: well planning, torque and drag, hydraulics, drilling performance. |
FlowSectionclass | A flow path section: inside pipe (Inner = 0) or an annulus (Outer = hole / casing ID, Inner = pipe OD). |
Hydraulicsstatic class | Drilling 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. |
HydraulicsResultclass | Result of a circulating-system calculation (psi, ppg, hp, lbf). |
MudRheologyclass | Mud rheology from rotational viscometer (Fann) readings at 600 and 300 rpm. |
PerformanceResultclass | Drilling performance of a well (depths in the report's unit). |
PlanStationclass | A point of a plan: measured depth, direction and position (north / east / TVD from the tie-on reference, plan unit). |
ReportActivityclass | One line of a daily drilling report. |
SectionLossclass | Pressure loss of one section (field units). |
StringOperationenum | Drill-string operation. |
StringSectionclass | One section of the drill string, listed from the bit up. |
TimeDepthViewclass | Time-depth curve: days against depth (increasing downward), the plan dashed, non-productive periods shaded. |
TorqueDragstatic class | Soft-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. |
TorqueDragCaseclass | Inputs of a torque-and-drag run. |
TorqueDragPointclass | Force and torque at one point of the string (SI: m, N, N.m; tension positive). |
TorqueDragResultclass | Result of a torque-and-drag run (SI). |
WellPlanclass | A 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.
| Member | Summary |
|---|---|
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.
| Member | Summary |
|---|---|
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).
| Member | Summary |
|---|---|
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.
| Member | Summary |
|---|---|
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).
| Member | Summary |
|---|---|
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 & 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.
| Member | Summary |
|---|---|
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).
| Member | Summary |
|---|---|
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.
| Member | Summary |
|---|---|
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).
| Member | Summary |
|---|---|
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).
| Member | Summary |
|---|---|
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.
| Member | Summary |
|---|---|
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).
| Member | Summary |
|---|---|
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.
| Member | Summary |
|---|---|
TripOut | Pulling out of hole / picking up (friction adds to the hook load). |
TripIn | Running in hole / slacking off (friction reduces the hook load). |
RotatingOffBottom | Rotating off bottom (friction acts on torque, not axially). |
Drilling | Drilling: rotating on bottom with weight and torque on bit. |
StringSection class
One section of the drill string, listed from the bit up.
| Member | Summary |
|---|---|
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
| Member | Summary |
|---|---|
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 & 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.
| Member | Summary |
|---|---|
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.
| Member | Summary |
|---|---|
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).
| Member | Summary |
|---|---|
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).
| Member | Summary |
|---|---|
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 & 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.
| Member | Summary |
|---|---|
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). |