osdu-python-models 0.5.0__py3-none-any.whl

osdu_models/workproductcomponent/stimulation_stage/v1_0_0.py

@@ -0,0 +1,1768 @@
+# generated by datamodel-codegen:
+#   filename:  workproductcomponent/stimulation_stage/v1_0_0.json
+
+from __future__ import annotations
+from pydantic import BaseModel, ConfigDict, Field, constr
+from ...abstract.abstract_stim_material_quantity import v1_0_0
+from typing import Any
+from ...abstract.abstract_common_resources.v1_0_0 import OsduCommonResources
+from ...abstract.abstract_wpcgroup_type.v1_2_0 import AbstractWPCGroupType
+from ...abstract.abstract_work_product_component.v1_1_0 import (
+    AbstractWorkProductComponent,
+)
+
+
+class JobEventItem(BaseModel):
+    """
+    Timed comments for this job stage of the stim job.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    Number: int | None = Field(None, examples=[1], title='Number')
+    """
+    Event number.
+    """
+    DateTime: str | None = Field(
+        None, examples=['2020-05-01T018:30:00+0000'], title='Date Time'
+    )
+    """
+    Date and time of this event.
+    """
+    NumberStep: int | None = Field(None, examples=[2], title='Number Step')
+    """
+    Step number. Use it to reference an existing job step entry.
+    """
+    Comment: str | None = Field(
+        None,
+        examples=[
+            'Max acheivable rate 350 L/minute at 61.75 MPa. FLBK 50 m3 at 0.9 m3/min average.'
+        ],
+        title='Comment',
+    )
+    """
+    A short description of the event.
+    """
+
+
+class Diversion(BaseModel):
+    """
+    Diversion details for the stimulated interval.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    ContractorName: str | None = Field(None, title='Contractor Name')
+    """
+    Name of the diversion contractor.
+    """
+    ElementSpacing: float | None = Field(None, title='Element Spacing')
+    """
+    Length between packer elements.
+    """
+    DiversionMethodID: (
+        constr(
+            pattern=r'^[\w\-\.]+:reference-data\-\-StimJobDiversionMethod:[\w\-\.\:\%]+:[0-9]*$'
+        )
+        | None
+    ) = Field(None, title='Diversion Method ID')
+    """
+    The diversion method used for this job stage.
+    """
+    ToolDescription: str | None = Field(None, title='Tool Description')
+    """
+    A supplier description of the diversion tool, such as its commercial name.
+    """
+    Remarks: str | None = Field(None, title='Remarks')
+    """
+    Remarks on the diversion method.
+    """
+
+
+class FlowPath(BaseModel):
+    """
+    Details about the downhole equipment design for this stimulation interval.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    BreakDownPressure: float | None = Field(None, title='Break Down Pressure')
+    """
+    The downhole pressure at which the formation broke.
+    """
+    BridgePlugMeasuredDepth: float | None = Field(
+        None, title='Bridge Plug Measured Depth'
+    )
+    """
+    The measured depth of a bridge plug.
+    """
+    BridgePlugRemovalDate: str | None = Field(None, title='Bridge Plug Removal Date')
+    """
+    Date that the bridge plug for this stage was removed.
+    """
+    TubingBottomMeasuredDepth: float | None = Field(
+        None, title='Tubing Bottom Measured Depth'
+    )
+    """
+    The maximum measured depth of the tubing used for treatment of a stage.
+    """
+    FractureGradient: float | None = Field(None, title='Fracture Gradient')
+    """
+    The formation fracture gradient for this treatment flow path.
+    """
+    FlowPathTypeID: (
+        constr(
+            pattern=r'^[\w\-\.]+:reference-data\-\-StimFlowPathType:[\w\-\.\:\%]+:[0-9]*$'
+        )
+        | None
+    ) = Field(None, title='Flow Path Type ID')
+    """
+    The type of stim flow path.
+    """
+    OpenHoleFrictionFactor: float | None = Field(
+        None, title='Open Hole Friction Factor'
+    )
+    """
+    The friction factor used to compute openhole pressure loss.
+    """
+    PackerMeasuredDepth: float | None = Field(None, title='Packer Measured Depth')
+    """
+    The measured depth of a packer.
+    """
+    PipeFrictionFactor: float | None = Field(None, title='PipeFriction Factor')
+    """
+    The friction factor for the pipe, tubing, and/or casing.
+    """
+    PmaxPacPressureAvg: float | None = Field(None, title='Pmax Packer Pressure Average')
+    """
+    PMax prediction allows the tool assembly to be designed with expected pressures. It determines maximum allowable surface pressure and is typically calculated as a single number by which the pressure relief valves are set. This variable is the average of all the pmax pressures calculated for this flow path.
+    """
+    PmaxPacPressureMax: float | None = Field(None, title='Pmax Packer Pressure Max')
+    """
+    PMax prediction allows the tool assembly to be designed with expected pressures. It determines maximum allowable surface pressure and is typically calculated as a single number by which the pressure relief valves are set. This variable is the maximum of all the pmax pressures calculated for this flow path.
+    """
+    PmaxWeaklinkPressureAvg: float | None = Field(
+        None, title='Pmax Weaklink Pressure Average'
+    )
+    """
+    Average allowable pressure for the zone of interest with respect to the bottomhole assembly during the stimulation services.
+    """
+    PmaxWeaklinkPressureMax: float | None = Field(
+        None, title='Pmax Weaklink Pressure Max'
+    )
+    """
+    Maximum allowable pressure for the zone of interest with respect to the bottomhole assembly during the stimulation services.
+    """
+    Remarks: str | None = Field(None, title='Remarks')
+    """
+    General remarks about the flow path for this job stage.
+    """
+
+
+class FlowBackTestStepItem(BaseModel):
+    """
+    Details about this flowback test step.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    StepNumber: int | None = Field(None, title='Step Number')
+    """
+    The number of the step. Identifies the step within the step down test.
+    """
+    DateTime: str | None = Field(None, title='Date Time')
+    """
+    Time stamp of the pressure measurement.
+    """
+    BHFlowRate: float | None = Field(None, title='Bottomhole Flow Rate')
+    """
+    Bottomhole flow rate for the specific step.
+    """
+    EntryFriction: float | None = Field(None, title='Entry Friction')
+    """
+    Calculated entry friction loss accounting for perforation and near wellbore restrictions for the specific step.
+    """
+    FlowbackVolume: float | None = Field(None, title='Flowback Volume')
+    """
+    Cumulative volume of flowback since the start of the test.
+    """
+    FlowbackRate: float | None = Field(None, title='Flowback Rate')
+    """
+    Flowback rate.
+    """
+    NearWellboreFriction: float | None = Field(None, title='Near Wellbore Friction')
+    """
+    Calculated near-wellbore friction loss for the specific step.
+    """
+    PerfFrictionLoss: float | None = Field(None, title='Perf Friction Loss')
+    """
+    Calculated perforation friction loss for the specific step.
+    """
+    PipeFrictionLoss: float | None = Field(None, title='Pipe FrictionLoss')
+    """
+    Calculated pipe friction loss for the specific step.
+    """
+    SurfacePressure: float | None = Field(None, title='SurfacePressure')
+    """
+    Surface pressure measured for the specific step.
+    """
+    SurfaceFlowRate: float | None = Field(None, title='Surface Flow Rate')
+    """
+    Surface flow rate entering the well for the specific step.
+    """
+
+
+class StepDownTestItem(BaseModel):
+    """
+    An injection test involving multiple steps of injection rate and pressure, where a curve deflection and change of slope indicates the fracture breakdown pressure.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    FlowBackTestStep: list[FlowBackTestStepItem] | None = Field(
+        None, title='Flow Back Test Step'
+    )
+    """
+    The data related to a particular step in the step-down test.
+    """
+    BHFluidDensity: float | None = Field(None, title='BH Fluid Density')
+    """
+    The density of the fluid at the bottom of the hole adjusting for bottomhole temperature and pressure during the step-down test.
+    """
+    DischargeCoefficient: float | None = Field(None, title='Discharge Coefficient')
+    """
+    A coefficient used in the equation for calculation of the pressure drop across a perforation set.
+    """
+    EntryHoleDiameter: float | None = Field(None, title='Entry Hole Diameter')
+    """
+    Diameter of the injection point or perforation.
+    """
+    InitialShutinPressure: float | None = Field(None, title='Initial Shutin Pressure')
+    """
+    The initial shut in pressure.
+    """
+    PerforationsEffective: int | None = Field(None, title='Perforations Effective')
+    """
+    The number of perforations in the interval being tested that are calculated to be open to injection, which is determined during the step-down test.
+    """
+    PerforationsTotal: int | None = Field(None, title='Perforations Total')
+    """
+    The total number of perforations in the interval being tested.
+    """
+    Remarks: str | None = Field(None, title='Remarks')
+    """
+    General remarks about this Stim Step Down Test.
+    """
+
+
+class PressureMeasurementItem(BaseModel):
+    """
+    An array of bottom hole flow rates and pressures for this stim step test.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    BHFlowRate: float | None = Field(None, title='BH Flow Rate')
+    """
+    The bottomhole flow rate of the fluid.
+    """
+    Pressure: float | None = Field(None, title='Pressure')
+    """
+    The pressure of the step test.
+    """
+
+
+class StepRateTestItem(BaseModel):
+    """
+    An injection test, plotted pressure against injection rate, where a curve deflection and change of slope indicates the fracture breakdown pressure.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    FractureExtensionPressure: float | None = Field(
+        None, title='Fracture Extension Pressure'
+    )
+    """
+    The pressure necessary to extend the fracture once initiated. The fracture extension pressure may rise slightly with increasing fracture length andor height because of friction pressure drop down the length of the fracture.
+    """
+    PressureMeasurement: list[PressureMeasurementItem] | None = Field(
+        None, title='Pressure Measurement'
+    )
+    """
+    A pressure and fluid flow rate data set.
+    """
+
+
+class FluidEfficiencyTestItem(BaseModel):
+    """
+    Fluid Efficiency Test for this pumping diagnostic session.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    StartDateTime: str | None = Field(None, title='Start Date Time')
+    """
+    Start time for the FET.
+    """
+    EndDateTime: str | None = Field(None, title='End Date Time')
+    """
+    End time for the FET.
+    """
+    AnalysisMethodID: (
+        constr(
+            pattern=r'^[\w\-\.]+:reference-data\-\-StimFETestAnalysisMethod:[\w\-\.\:\%]+:[0-9]*$'
+        )
+        | None
+    ) = Field(None, title='Analysis Method ID')
+    """
+    An analysis method used for this FET.
+    """
+    FluidEfficiency: float | None = Field(None, title='Fluid Efficiency')
+    """
+    A measurement, derived from a data frac, of the efficiency of a particular fluid in creating fracture area on a particular formation at a set of conditions.
+    """
+    FractureCloseDuration: float | None = Field(None, title='Fracture Close Duration')
+    """
+    The time required for the fracture to effectively close without proppant in place.
+    """
+    FractureClosePressure: float | None = Field(None, title='Fracture Close Pressure')
+    """
+    The pressure at which the fracture effectively closes without proppant in place.
+    """
+    FractureExtensionPressure: float | None = Field(
+        None, title='Fracture Extension Pressure'
+    )
+    """
+    The fracture pressure limit for an unfractured formation is the fracture initiation pressure. This is typically considered the upper bound for the minimum horizontal stress or closure pressure. A step-rate test is used to determine the fracture extension pressure.
+    """
+    FractureGradient: float | None = Field(None, title='Fracture Gradient')
+    """
+    The fracture gradient of the formation.
+    """
+    FractureLength: float | None = Field(None, title='Fracture Length')
+    """
+    The length of the fracture tip to tip; fracture half length is the length of one wing of a fracture from the wellbore to the tip.
+    """
+    FractureWidth: float | None = Field(None, title='Fracture Width')
+    """
+    The width of a fracture at the wellbore. Hydraulic frac width is generated by frac fluid viscosity andor pump rate (i.e., horsepower).
+    """
+    NetPressure: float | None = Field(None, title='Net Pressure')
+    """
+    The difference between the fracture extension pressure and the pressure that exists in the fracture.
+    """
+    PdlCoefficient: float | None = Field(None, title='Pdl Coefficient')
+    """
+    The pressure dependent leak-off coefficient.
+    """
+    PdlEndDuration: float | None = Field(None, title='Pdl End Duration')
+    """
+    The end of the pressure-dependent leak-off portion of the FET.
+    """
+    PorePressure: float | None = Field(None, title='Pore Pressure')
+    """
+    The pressure of the liquids in the formation pore space.
+    """
+    PseudoRadialPressure: float | None = Field(None, title='Pseudo Radial Pressure')
+    """
+    The Horner plot is used to determine if pseudo-radial flow developed during pressure decline. If a semi-log straight line is observed and the line can be extrapolated to a reasonable value of reservoir pressure, then radial or pseudo-radial flow may be affecting the decline behavior. This suggests that the fracture is already closed and that data beyond the point of influence need not be considered in the evaluation of closure.
+    """
+    ResidualPermeability: float | None = Field(None, title='Residual Permeability')
+    """
+    That permeability which remains after a fractured formation has closed, allowing the the formation fracture face to be pressurized before the fracture is mechanically reopened.
+    """
+
+
+class StepItem(BaseModel):
+    """
+    Details about this flowback test step.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    StepNumber: int | None = Field(None, title='Step Number')
+    """
+    The number of the step. Identifies the step within the step down test.
+    """
+    DateTime: str | None = Field(None, title='Date Time')
+    """
+    Time stamp of the pressure measurement.
+    """
+    BHFlowRate: float | None = Field(None, title='Bottomhole Flow Rate')
+    """
+    Bottomhole flow rate for the specific step.
+    """
+    EntryFriction: float | None = Field(None, title='Entry Friction')
+    """
+    Calculated entry friction loss accounting for perforation and near wellbore restrictions for the specific step.
+    """
+    FlowbackVolume: float | None = Field(None, title='Flowback Volume')
+    """
+    Cumulative volume of flowback since the start of the test.
+    """
+    FlowbackRate: float | None = Field(None, title='Flowback Rate')
+    """
+    Flowback rate.
+    """
+    NearWellboreFriction: float | None = Field(None, title='Near Wellbore Friction')
+    """
+    Calculated near-wellbore friction loss for the specific step.
+    """
+    PerfFrictionLoss: float | None = Field(None, title='Perf Friction Loss')
+    """
+    Calculated perforation friction loss for the specific step.
+    """
+    PipeFrictionLoss: float | None = Field(None, title='Pipe FrictionLoss')
+    """
+    Calculated pipe friction loss for the specific step.
+    """
+    SurfacePressure: float | None = Field(None, title='SurfacePressure')
+    """
+    Surface pressure measured for the specific step.
+    """
+    SurfaceFlowRate: float | None = Field(None, title='Surface Flow Rate')
+    """
+    Surface flow rate entering the well for the specific step.
+    """
+
+
+class PumpFlowBackTestItem(BaseModel):
+    """
+    Pump flow back test for this stim job diagnostic session.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    FlowBackStartDateTime: str | None = Field(None, title='Flow Back Start Date Time')
+    """
+    Start time for the test.
+    """
+    FlowBackEndDateTime: str | None = Field(None, title='Flow Back End Date Time')
+    """
+    End time for the test.
+    """
+    Step: list[StepItem] | None = Field(None, title='Step')
+    """
+    Step
+    """
+    CasingPressure: float | None = Field(None, title='Casing Pressure')
+    """
+    Casing pressure.
+    """
+    FlowBackVolume: float | None = Field(None, title='Flow Back Volume')
+    """
+    Total fluid volume recovered during a flow back test.
+    """
+    FractureCloseDuration: float | None = Field(None, title='Fracture Close Duration')
+    """
+    The time required for the fracture width to become zero.
+    """
+    FractureClosePressure: float | None = Field(None, title='Fracture Close Pressure')
+    """
+    The pressure when the fracture width becomes zero.
+    """
+    TubingPressure: float | None = Field(None, title='Tubing Pressure')
+    """
+    Tubing pressure.
+    """
+    Remarks: str | None = Field(None, title='Remarks')
+    """
+    General remarks for this stim pump flow back test.
+    """
+
+
+class PumpDiagnosticSessionItem(BaseModel):
+    """
+    A pumping diagnostics session for this job stage.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    StageNumber: int | None = Field(None, title='Stage Number')
+    """
+    The number of the stage associated with this diagnostics session.
+    """
+    Number: int | None = Field(None, title='Number')
+    """
+    The number of this pumping diagnostics session.
+    """
+    Name: str | None = Field(None, title='Name')
+    """
+    The name of this pumping diagnostic session.
+    """
+    Description: str | None = Field(None, title='Description')
+    """
+    A description of this pumping diagnostic session.
+    """
+    StepDownTest: list[StepDownTestItem] | None = Field(None, title='Step Down Test')
+    """
+    An injection test involving multiple steps of injection rate and pressure, where a curve deflection and change of slope indicates the fracture breakdown pressure. An injection test involving multiple steps of injection rate and pressure, where a curve deflection and change of slope indicates the fracture breakdown pressure.
+    """
+    StepRateTest: list[StepRateTestItem] | None = Field(None, title='Step Rate Test')
+    """
+    An injection test, plotted pressure against injection rate, where a curve deflection and change of slope indicates the fracture breakdown pressure.
+    """
+    BaseFluidVol: float | None = Field(None, title='Base Fluid Volume')
+    """
+    Base fluid volume entering the pumping equipment.
+    """
+    BHHydrostaticPressure: float | None = Field(None, title='BH Hydrostatic Pressure')
+    """
+    Bottomhole hydrostatic pressure.
+    """
+    BHMeasuredDepth: float | None = Field(None, title='BH Measured Depth')
+    """
+    The measured depth of the bottom of the hole.
+    """
+    StaticBHTemperature: float | None = Field(None, title='Static BH Temperature')
+    """
+    Static bottomhole temperature.
+    """
+    BubblePointPressure: float | None = Field(None, title='Bubble Point Pressure')
+    """
+    The pressure at which gas begins to break out of an under saturated oil and form a free gas phase in the matrix or a gas cap.
+    """
+    ChokeSize: float | None = Field(None, title='Choke Size')
+    """
+    The size of the choke used during a flow back test.
+    """
+    FluidCompressibility: float | None = Field(None, title='Fluid Compressibility')
+    """
+    The volume change of a fluid when pressure is applied.
+    """
+    FluidDensity: float | None = Field(None, title='Fluid Density')
+    """
+    The density of the fluid during this pumping diagnostic session.
+    """
+    FluidEfficiency: float | None = Field(None, title='Fluid Efficiency')
+    """
+    A measurement, derived from a data frac, of the efficiency of a particular fluid in creating fracture area on a particular formation at a set of conditions.
+    """
+    FluidEfficiencyTest: list[FluidEfficiencyTestItem] | None = Field(
+        None, title='Fluid Efficiency Test'
+    )
+    """
+    A diagnostic test determining fluid efficiency.
+    """
+    FluidKprimeFactor: float | None = Field(None, title='Fluid Kprime Factor')
+    """
+    The consistency index K is the shear stress or viscosity of the fluid at one sec-1 shear rate. An increasing K raises the effective viscosity.
+    """
+    FluidNprimeFactor: float | None = Field(None, title='Fluid Nprime Factor')
+    """
+    Power law component. As 'n' decreases from 1, the fluid becomes more shear thinning. Reducing 'n' produces more non-Newtonian behavior.
+    """
+    FluidSpecificHeat: float | None = Field(None, title='Fluid Specific Heat')
+    """
+    The heat required to raise one unit mass of a substance by one degree.
+    """
+    FluidThermalConductivity: float | None = Field(
+        None, title='Fluid Thermal Conductivity'
+    )
+    """
+    In physics, thermal conductivity is the property of a material describing its ability to conduct heat. It appears primarily in Fourier's Law for heat conduction. Thermal conductivity is measured in watts per kelvin-meter. Multiplied by a temperature difference (in kelvins) and an area (in square meters), and divided by a thickness (in meters), the thermal conductivity predicts the rate of energy loss (in watts) through a piece of material.
+    """
+    FluidThermalExpansionCoefficient: float | None = Field(
+        None, title='Fluid Thermal Expansion Coefficient'
+    )
+    """
+    Dimensional response to temperature change is expressed by its coefficient of thermal expansion. When the temperature of a substance changes, the energy that is stored in the intermolecular bonds between atoms also changes. When the stored energy increases, so does the length of the molecular bonds. As a result, solids typically expand in response to heating and contract on cooling. The degree of expansion divided by the change in temperature is called the material's coefficient of thermal expansion and generally varies with temperature.
+    """
+    FoamQuality: float | None = Field(None, title='Foam Quality')
+    """
+    Foam quality percentage of foam for the pumping diagnostic session during the stimulation services.
+    """
+    FractureCloseDateTime: str | None = Field(None, title='Fracture Close Date Time')
+    """
+    The date and time when the fluid in the fracture is completely leaked off into the formation and the fracture closes on its faces.
+    """
+    FractureClosePressure: float | None = Field(None, title='Fracture Close Pressure')
+    """
+    The pressure when the fracture width becomes zero.
+    """
+    FrictionPressure: float | None = Field(None, title='Friction Pressure')
+    """
+    The pressure loss due to fluid friction with the pipe while a fluid is being pumped.
+    """
+    IsTemperatureCorrectionApplied: bool | None = Field(
+        None, title='Is Temperature Correction Applied'
+    )
+    """
+    Are the calculations corrected for temperature? A value of true (or 1) indicates that the calculations were corrected for temperature. A value of false (or 0) or not given indicates otherwise.
+    """
+    MidPerforationMeasuredDepth: float | None = Field(
+        None, title='Mid Perforation Measured Depth'
+    )
+    """
+    The measured depth of the middle perforation (MPP).
+    """
+    MidPerforationTrueVerticalDepth: float | None = Field(
+        None, title='Mid Perforation True Vertical Depth'
+    )
+    """
+    The true vertical depth of the middle perforation.
+    """
+    PadPercent: float | None = Field(None, title='Pad Percent')
+    """
+    The volume of the pad divided by the (volume of the pad + the volume of the proppant laden fluid).
+    """
+    PorePressure: float | None = Field(None, title='Pore Pressure')
+    """
+    The pressure of the liquids in the formation pore space.
+    """
+    PumpDuration: float | None = Field(None, title='Pump Duration')
+    """
+    The time between the shutin time and the pump on time.
+    """
+    PumpFlowBackTest: list[PumpFlowBackTestItem] | None = Field(
+        None, title='Pump Flow Back Test'
+    )
+    """
+    A diagnostic test involving flowing a well back after treatment.
+    """
+    PumpOffDateTime: str | None = Field(None, title='Pump Off Date Time')
+    """
+    The date and time pumping ended.
+    """
+    PumpOnDateTime: str | None = Field(None, title='Pump On Date Time')
+    """
+    The date and time pumping began.
+    """
+    ReservoirTotalCompressibility: float | None = Field(
+        None, title='Reservoir Total Compressibility'
+    )
+    """
+    The volume change of a reservoir material when pressure is applied.
+    """
+    ShutInInitialPressure: float | None = Field(None, title='Shutin Initial Pressure')
+    """
+    Initial shutin pressure.
+    """
+    SurfaceFluidTemperature: float | None = Field(
+        None, title='Surface Fluid Temperature'
+    )
+    """
+    Temperature of the fluid at the surface.
+    """
+    InjectionPointMeasuredDepth: float | None = Field(
+        None, title='Injection Point Measured Depth'
+    )
+    """
+    The measured depth of the wellbore to its injection point.
+    """
+    SurfaceTemperature: float | None = Field(None, title='Surface Temperature')
+    """
+    The temperature at surface during this pumping diagnostic session.
+    """
+    BHTreatmentPressureAvg: float | None = Field(
+        None, title='BH Treatment Pressure Average'
+    )
+    """
+    Average bottomhole treatment pressure.
+    """
+    BHTreatmentRateAvg: float | None = Field(None, title='BH Treatment Rate Average')
+    """
+    Average bottomhole treatment flow rate.
+    """
+    WellboreVolume: float | None = Field(None, title='Wellbore Volume')
+    """
+    The volume of fluid in the wellbore for this pumping diagnostic session.
+    """
+    WellShutinDateTime: str | None = Field(None, title='Well Shutin Date Time')
+    """
+    The date and time at which a well ceases flowing and the valves are closed.
+    """
+    Remarks: str | None = Field(None, title='Remarks')
+    """
+    Remarks
+    """
+
+
+class ShutInPressureItem(BaseModel):
+    """
+    Shut in pressure data for this job stage.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    Pressure: float | None = Field(None, title='Pressure')
+    """
+    The shut-in pressure.
+    """
+    TimeAfterShutin: float | None = Field(None, title='Time After Shutin')
+    """
+    The cumulative time span after shut-in at which the pressure was measured.
+    """
+
+
+class Fluid(BaseModel):
+    """
+    Fluid used for this job step of the stimulated interval.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    Name: str | None = Field(None, examples=['Slickwater'], title='Name')
+    """
+    The name of the fluid.
+    """
+    FluidTypeID: (
+        constr(
+            pattern=r'^[\w\-\.]+:reference-data\-\-StimJobFluidType:[\w\-\.\:\%]+:[0-9]*$'
+        )
+        | None
+    ) = Field(
+        None,
+        examples=['namespace:reference-data--StimJobFluidType:Water.Slick:'],
+        title='Fluid Type ID',
+    )
+    """
+    The fluid type.
+    """
+    Description: str | None = Field(
+        None, examples=['FR-70 Slickwater'], title='Description'
+    )
+    """
+    The description of the fluid.
+    """
+    AdditiveConcentration: list[v1_0_0.AbstractStimMaterialQuantity] | None = Field(
+        None, title='Additive Concentration'
+    )
+    """
+    Concentrations of additives in the fluid for this job step.
+    """
+    Density: float | None = Field(None, examples=['8.76 lbm/gal[US]'], title='Density')
+    """
+    The density of the fluid.
+    """
+    FilterSize: float | None = Field(None, title='Filter Size')
+    """
+    The filter size that the fluid for this job step passes through.
+    """
+    FilterType: str | None = Field(None, title='Filter Type')
+    """
+    The type of fluid filter used for this job step.
+    """
+    FilterCake: float | None = Field(None, title='Filter Cake')
+    """
+    Filter Cake
+    """
+    FluidSurfaceTemperature: float | None = Field(
+        None, title='Fluid Surface Temperature'
+    )
+    """
+    The temperature of the fluid at surface.
+    """
+    FluidTestPressure: float | None = Field(None, title='FluidTestPressure')
+    """
+    Test pressure of the fluid during this job step.
+    """
+    FluidTestTemperature: float | None = Field(None, title='FluidTestTemperature')
+    """
+    Test temperature of the fluid for this job step.
+    """
+    GelStrength10Sec: float | None = Field(None, title='Gel Strength10 Sec')
+    """
+    The shear stress measured at low shear rate after a mud has set quiescently for 10 seconds.
+    """
+    GelStrength10Min: float | None = Field(None, title='Gel Strength10 Min')
+    """
+    The shear stress measured at low shear rate after a mud has set quiescently for 10 minutes.
+    """
+    IsKillFluid: bool | None = Field(None, examples=[False], title='Is Kill Fluid')
+    """
+    Is the fluid a kill fluid?
+    """
+    pH: float | None = Field(None, examples=[6], title='pH')
+    """
+    The pH of the fluid.
+    """
+    Purpose: str | None = Field(None, examples=['Main Body'], title='Purpose')
+    """
+    The purpose of the fluid.
+    """
+    SpecificGravity: float | None = Field(
+        None, examples=['0.6 sg'], title='Specific Gravity'
+    )
+    """
+    The specific gravity of the fluid at surface.
+    """
+    Supplier: str | None = Field(None, examples=['Schlumberger'], title='Supplier')
+    """
+    The name of the fluid supplier for this job step.
+    """
+    SupplierID: (
+        constr(pattern=r'^[\w\-\.]+:master-data\-\-Organisation:[\w\-\.\:\%]+:[0-9]*$')
+        | None
+    ) = Field(
+        None, examples=['namespace:master-data--Organisation:SLB:'], title='Supplier ID'
+    )
+    """
+    The supplier of the fluid.
+    """
+    Viscosity: float | None = Field(None, title='Viscosity')
+    """
+    Viscosity of the stimulation fluid for this job step.
+    """
+    Remarks: str | None = Field(None, title='Remarks')
+    """
+    Remarks
+    """
+
+
+class JobStepItem(BaseModel):
+    """
+    Summary of the pumping schedule, also known as 'pumping stages', sub-stages or event level details.
+    This is where you define pressures, rates, volumes, amount of proppant for the Displacement, Flush, Pad, Ramp, etc steps in the pumping operation for this job stage.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    StepNumber: int | None = Field(None, examples=[2], title='Step Number')
+    """
+    Step number.
+    """
+    StepName: str | None = Field(None, examples=['Pump Main Body'], title='Step Name')
+    """
+    A human readable name for this job step.
+    """
+    JobStepTypeID: (
+        constr(
+            pattern=r'^[\w\-\.]+:reference-data\-\-StimJobStepType:[\w\-\.\:\%]+:[0-9]*$'
+        )
+        | None
+    ) = Field(
+        None,
+        examples=['namespace:reference-data--StimJobStepType:PumpMainBody:'],
+        title='Job Step Type ID',
+    )
+    """
+    The type of  job step.
+    """
+    Description: str | None = Field(
+        None, examples=['Pump Main Body w/ 40/70 Ottawa Sand'], title='Description'
+    )
+    """
+    A short description of the job step.
+    """
+    StepStartDateTime: str | None = Field(
+        None, examples=['2020-05-01T016:35:00+0000'], title='Step Start Date Time'
+    )
+    """
+    Date and time the step started.
+    """
+    StepEndDateTime: str | None = Field(
+        None, examples=['2020-05-01T016:52:00+0000'], title='Step End Date Time'
+    )
+    """
+    Date and time the step ended.
+    """
+    Fluid_1: Fluid | None = Field(None, alias='Fluid', title='Fluid')
+    """
+    Fluid used for this job step of the stimulated interval.
+    """
+    FluidReportID: (
+        constr(
+            pattern=r'^[\w\-\.]+:work-product-component\-\-WellFluidsReport:[\w\-\.\:\%]+:[0-9]*$'
+        )
+        | None
+    ) = Field(None, title='Fluid Report Identifier')
+    """
+    Fluid Report Identifier of the fluid used for this Job Step
+    """
+    BallsUsed: int | None = Field(None, examples=[16], title='Balls Used')
+    """
+    Balls used during execution of the step.
+    """
+    BallsRecovered: int | None = Field(None, examples=[16], title='Balls Recovered')
+    """
+    Balls recovered during execution of the step.
+    """
+    BaseFluidBypassVolume: float | None = Field(None, title='Base Fluid Bypass Volume')
+    """
+    Base fluid volume recorded after equipment set to bypass.
+    """
+    BaseFluidQualityAvg: float | None = Field(None, title='Base Fluid Quality Average')
+    """
+    Base quality percentage of foam.
+    """
+    BaseFluidVolumeEquip: float | None = Field(
+        None, examples=['72311 gal'], title='Base Fluid Volume Equipment'
+    )
+    """
+    Base fluid volume entering the equipment.
+    """
+    BHPressureStart: float | None = Field(None, title='BH Pressure Start')
+    """
+    Starting bottomhole pressure.
+    """
+    BHPressureEnd: float | None = Field(None, title='BH Pressure End')
+    """
+    Final bottomhole pressure.
+    """
+    BHPressureAvg: float | None = Field(None, title='BH Pressure Average')
+    """
+    Average bottomhole pressure.
+    """
+    CO2BaseFluidQualityAvg: float | None = Field(
+        None, title='CO2 Base Fluid Quality Average'
+    )
+    """
+    Base quality carbon dioxide percent of foam.
+    """
+    CO2SurfaceRateEnd: float | None = Field(None, title='CO2 Surface Rate End')
+    """
+    Final CO2 pump rate in volume per time at the surface.
+    """
+    DirtyMaterialRateStart: float | None = Field(
+        None, title='Dirty Material Rate Start'
+    )
+    """
+    Starting dirty fluid flow rate.
+    """
+    DirtyMaterialRateEnd: float | None = Field(None, title='Dirty Material Rate End')
+    """
+    Ending dirty fluid flow rate.
+    """
+    FluidBaseVolume: float | None = Field(
+        None, examples=['72311.8 gal'], title='Fluid Base Volume'
+    )
+    """
+    The step volume of the base fluid.
+    """
+    FluidCirculatedVolume: float | None = Field(
+        None, examples=['72311.8 gal'], title='Fluid Circulated Volume'
+    )
+    """
+    Fluid volume circulated.
+    """
+    FluidPumpedVolume: float | None = Field(
+        None, examples=['72311.8 gal'], title='Fluid Pumped Volume'
+    )
+    """
+    Fluid volume pumped.
+    """
+    FluidReturnedVolume: float | None = Field(
+        None, examples=['71000 gal'], title='Fluid Returned Volume'
+    )
+    """
+    Fluid volume returned.
+    """
+    FluidSqueezedVolume: float | None = Field(
+        None, examples=['1311 gal'], title='Fluid Squeezed Volume'
+    )
+    """
+    Fluid volume squeezed.
+    """
+    FluidTemperatureAvg: float | None = Field(
+        None, examples=['45 degF'], title='Fluid Temperature Average'
+    )
+    """
+    Average fluid temperature.
+    """
+    FluidWashedVolume: float | None = Field(
+        None, examples=['1430 gal'], title='Fluid Washed Volume'
+    )
+    """
+    Fluid volume washed.
+    """
+    FractureGradientInitial: float | None = Field(
+        None, examples=['1.079 psi/ft'], title='Fracture Gradient Initial'
+    )
+    """
+    The fracture gradient before starting the step.
+    """
+    FractureGradientFinal: float | None = Field(
+        None, examples=['1.030 psi/ft'], title='Fracture Gradient Final'
+    )
+    """
+    The fracture gradient when the step ends.
+    """
+    FrictionFactor: float | None = Field(None, title='Friction Factor')
+    """
+    Numeric value used to scale a calculated rheological friction.
+    """
+    HhpAvg: float | None = Field(None, examples=['7400 hp'], title='Hhp Average')
+    """
+    Average hydraulic horsepower used during the step.
+    """
+    HhpMax: float | None = Field(None, examples=['7600 hp'], title='Hhp Maximum')
+    """
+    Maximum hydraulic horsepower used during the step.
+    """
+    InternalPhaseFractionAvg: float | None = Field(
+        None, title='Internal Phase Fraction Average'
+    )
+    """
+    Internal gas phase percentage of the foam.
+    """
+    MaterialUsed: list[v1_0_0.AbstractStimMaterialQuantity] | None = Field(
+        None, title='Material Used'
+    )
+    """
+    Material used during the step
+    """
+    MaterialUsedRateStart: list[v1_0_0.AbstractStimMaterialQuantity] | None = Field(
+        None, title='Material Used Rate Start'
+    )
+    """
+    Starting quantity of material used per minute entering the flow stream.
+    """
+    MaterialUsedRateEnd: list[v1_0_0.AbstractStimMaterialQuantity] | None = Field(
+        None, title='Material Used Rate End'
+    )
+    """
+    Ending quantity of material used per minute entering the flow stream.
+    """
+    MaterialUsedRateMax: list[v1_0_0.AbstractStimMaterialQuantity] | None = Field(
+        None, title='Material Used Rate Max'
+    )
+    """
+    Maximum rate of material used per minute entering the flow stream.
+    """
+    MaterialUsedRateAvg: list[v1_0_0.AbstractStimMaterialQuantity] | None = Field(
+        None, title='Material Used Rate Average'
+    )
+    """
+    Average material used per minute entering the flow stream.
+    """
+    BHMaterialUsedRateStart: list[v1_0_0.AbstractStimMaterialQuantity] | None = Field(
+        None, title='BH Material Used Rate Start'
+    )
+    """
+    Bottomhole material usage rate start.
+    """
+    BHMaterialUsedRateEnd: list[v1_0_0.AbstractStimMaterialQuantity] | None = Field(
+        None, title='BH Material Used Rate End'
+    )
+    """
+    Bottomhole material usage rate end.
+    """
+    BHMaterialUsedRateAvg: list[v1_0_0.AbstractStimMaterialQuantity] | None = Field(
+        None, title='BH Material Used Rate Average'
+    )
+    """
+    Bottomhole material usage rate average.
+    """
+    N2BaseFluidQualityAvg: float | None = Field(
+        None, title='N2 Base Fluid Quality Average'
+    )
+    """
+    Nitrogen base quality percentage of foam.
+    """
+    N2SurfaceRateEnd: float | None = Field(None, title='N2 Surface Rate End')
+    """
+    Final nitrogen pump rate at the surface.
+    """
+    PipeFrictionPressureLoss: float | None = Field(
+        None, title='Pipe Friction Pressure Loss'
+    )
+    """
+    The friction pressure loss contribution from pipe.
+    """
+    ProppantConcAvg: float | None = Field(None, title='Proppant Conc Average')
+    """
+    Average proppant concentration at the wellhead.
+    """
+    ProppantConcBHStart: float | None = Field(
+        None, examples=['0.51 lbm/gal[US]'], title='Proppant Conc BH Start'
+    )
+    """
+    The initial proppant concentration at bottomhole.
+    """
+    ProppantConcBHEnd: float | None = Field(
+        None, examples=['0.45 lbm/gal[US]'], title='Proppant Conc BH End'
+    )
+    """
+    The final proppant concentration at bottomhole.
+    """
+    ProppantConcBHMax: float | None = Field(
+        None, examples=['0.60 lbm/gal[US]'], title='Proppant Conc BH Max'
+    )
+    """
+    Maximum proppant concentration at bottomhole during the stimulation step.
+    """
+    ProppantConcBHAvg: float | None = Field(
+        None, examples=['0.51 lbm/gal[US]'], title='Proppant Conc BH Average'
+    )
+    """
+    The average proppant concentration at bottomhole.
+    """
+    ProppantConcSurfaceStart: float | None = Field(
+        None, examples=['0.50 lbm/gal[US]'], title='Proppant Conc Surface Start'
+    )
+    """
+    The initial proppant concentration at the surface.
+    """
+    ProppantConcSurfaceEnd: float | None = Field(
+        None, examples=['0.50 lbm/gal[US]'], title='Proppant Conc Surface End'
+    )
+    """
+    The final proppant concentration at the surface.
+    """
+    ProppantConcSurfaceMax: float | None = Field(
+        None, examples=['0.50 lbm/gal[US]'], title='Proppant Conc Surface Max'
+    )
+    """
+    Maximum proppant concentration at the wellhead.
+    """
+    ProppantConcSurfaceAvg: float | None = Field(
+        None, examples=['0.50 lbm/gal[US]'], title='Proppant Conc Surface Average'
+    )
+    """
+    The average proppant concentration at the surface.
+    """
+    ProppantSlurryConcAvg: float | None = Field(
+        None, examples=['0.50 lbm/gal[US]'], title='Proppant Slurry Conc Average'
+    )
+    """
+    Average proppant concentration exiting the equipment.
+    """
+    ProppantSlurryConcMax: float | None = Field(
+        None, examples=['0.50 lbm/gal[US]'], title='Proppant Slurry Conc Max'
+    )
+    """
+    Maximum proppant concentration exiting the equipment.
+    """
+    PumpTime: float | None = Field(None, examples=['21 min'], title='Pump Time')
+    """
+    Total pumping time for the step.
+    """
+    SlurryFluidVolume: float | None = Field(
+        None, examples=['72000 gal'], title='Slurry Fluid Volume'
+    )
+    """
+    The volume of the slurry (dirty) for this job step.
+    """
+    SlurryReturnRateAvg: float | None = Field(
+        None, examples=['36 bbl/min'], title='Slurry Return Rate Average'
+    )
+    """
+    Average slurry return rate.
+    """
+    SurfacePressureStart: float | None = Field(None, title='Surface Pressure Start')
+    """
+    Starting surface pressure.
+    """
+    SurfacePressureEnd: float | None = Field(None, title='Surface Pressure End')
+    """
+    Final surface pressure.
+    """
+    SurfacePressureMax: float | None = Field(None, title='Surface Pressure Max')
+    """
+    Maximum pumping pressure on surface.
+    """
+    SurfacePressureAvg: float | None = Field(None, title='Surface Pressure Average')
+    """
+    Average surface pressure.
+    """
+    WellheadSlurryVolume: float | None = Field(None, title='Wellhead Slurry Volume')
+    """
+    Slurry volume entering the well.
+    """
+    WellheadFlowRateAvg: float | None = Field(None, title='Wellhead Flow Rate Avg')
+    """
+    Average flow rate at the wellhead.
+    """
+    WellheadFlowRateMax: float | None = Field(None, title='Wellhead Flow Rate Max')
+    """
+    Maximum flow rate at the wellhead.
+    """
+    Remarks: str | None = Field(None, examples=['Treatment #2'], title='Remarks')
+    """
+    General remarks about this job step.
+    """
+
+
+class Data(OsduCommonResources, AbstractWPCGroupType, AbstractWorkProductComponent):
+    """
+    `data` payload for StimulationStage 1.0.0.
+    """
+
+    model_config = ConfigDict(
+        extra='allow',
+    )
+    WellboreID: constr(
+        pattern=r'^[\w\-\.]+:master-data\-\-Wellbore:[\w\-\.\:\%]+:[0-9]*$'
+    ) = Field(
+        ...,
+        examples=['namespace:master-data--Wellbore:11000091175501:'],
+        title='Wellbore ID',
+    )
+    """
+    A link to the Wellbore in which the stimulation took place.
+    """
+    WellActivityID: (
+        constr(pattern=r'^[\w\-\.]+:master-data\-\-WellActivity:[\w\-\.\:\%]+:[0-9]*$')
+        | None
+    ) = Field(
+        None,
+        examples=['namespace:master-data--WellActivity:110000911755.COM:'],
+        title='Well Activity ID',
+    )
+    """
+    A link to the Well Activity to which this stimulation job was performed.
+    """
+    StimulationJobID: (
+        constr(
+            pattern=r'^[\w\-\.]+:work-product-component\-\-StimulationJob:[\w\-\.\:\%]+:[0-9]*$'
+        )
+        | None
+    ) = Field(
+        None,
+        examples=['namespace:work-product-component--StimulationJob:110000911755.COM:'],
+        title='Stimulation Job ID',
+    )
+    """
+    The SRN of the parent Stimulation Job in which the Stage was performed.
+    """
+    StageNumber: int | None = Field(None, examples=[2], title='StageNumber')
+    """
+    The number associated with the stage.
+    """
+    StageStartDateTime: str | None = Field(
+        None, examples=['2020-05-01T016:00:00+0000'], title='Stage Start Date Time'
+    )
+    """
+    Starting date and time for the stage treatment.
+    """
+    StageEndDateTime: str | None = Field(
+        None, examples=['2020-05-01T018:30:00+0000'], title='Stage End Date Time'
+    )
+    """
+    Ending date and time for the stage treatment.
+    """
+    IntervalTopMeasuredDepth: float | None = Field(
+        None, examples=['14386 ft'], title='Interval Top Measured Depth'
+    )
+    """
+    Measured depth at the top of the stimulated interval.
+    """
+    IntervalBaseMeasuredDepth: float | None = Field(
+        None, examples=['14613 ft'], title='Interval Base Measured Depth'
+    )
+    """
+    Measured depth at base of the stimulated interval.
+    """
+    IntervalTopTrueVerticalDepth: float | None = Field(
+        None, examples=['7029 ft'], title='Interval Top True Vertical Depth'
+    )
+    """
+    True Vertical depth at top of interval.
+    """
+    IntervalBaseTrueVerticalDepth: float | None = Field(
+        None, examples=['7025 ft'], title='Interval Base True Vertical Depth'
+    )
+    """
+    True Vertical depth at base of interval.
+    """
+    StageIntervalLength: float | None = Field(
+        None, examples=['227 ft'], title='Stage Interval Length'
+    )
+    """
+    Length (along hole measured depth) of the stimulated interval.
+    """
+    HoleSectionID: (
+        constr(pattern=r'^[\w\-\.]+:master-data\-\-HoleSection:[\w\-\.\:\%]+:[0-9]*$')
+        | None
+    ) = Field(
+        None,
+        examples=['namespace:master-data--HoleSection:11000091175501.6inHoleSect:'],
+        title='Hole Section Identifier',
+    )
+    """
+    The Hole Section stimulated during this job Stage.
+    """
+    JobEvent: list[JobEventItem] | None = Field(None, title='Job Event')
+    """
+    Timed comments for this job stage of the stim job.
+    """
+    JobStep: list[JobStepItem] | None = Field(None, title='Job Step')
+    """
+    Job Step array
+    """
+    Diversion_1: Diversion | None = Field(None, alias='Diversion', title='Diversion')
+    """
+    Diversion details for the stimulated interval.
+    """
+    FlowPath_1: FlowPath | None = Field(None, alias='FlowPath', title='Flow Path')
+    """
+    Details about the downhole equipment design for this stimulation interval.
+    """
+    FluidPumpRateAvg: float | None = Field(
+        None, examples=['36.54 bbl/min'], title='Fluid Pump Rate Avg'
+    )
+    """
+    Average fluid pumping rate for all job Steps while treating the Stage.
+    """
+    FluidPumpRateMax: float | None = Field(
+        None, examples=['46.23 bbl/min'], title='Fluid Pump Rate Max'
+    )
+    """
+    Maximum fluid pumping rate of any Step while treating the Stage.
+    """
+    AnnulusPressureAvg: float | None = Field(
+        None, examples=['8303 psi'], title='Annulus Pressure Average'
+    )
+    """
+    The average annulus pressure for all job steps for the stage treatment.
+    """
+    AnnulusPressureMax: float | None = Field(
+        None, examples=['8755 psi'], title='Annulus Pressure Max'
+    )
+    """
+    The highest annulus pressure for all job steps while treating the stage.
+    """
+    BaseFluidReturnRateAvg: float | None = Field(
+        None, title='Base Fluid Return Rate Average'
+    )
+    """
+    Average base fluid return flow rate of all Steps for this Stage.
+    """
+    BHPumpRateAvg: float | None = Field(
+        None, examples=['36.54 bbl/min'], title='Bottomhole Pump Rate Average'
+    )
+    """
+    Average bottomhole flow rate for this Stage.
+    """
+    DHStaticTemperatureAvg: float | None = Field(
+        None, examples=['155 degF'], title='Downhole Static Temperature Average'
+    )
+    """
+    The average static temperature of the wellbore injection point(s) or formation at equilibrium (steady state) with no fluid or tool movement, allowing for equilibrium conditions at the wellbore injection point; (DHST: down hole static temperature.
+    """
+    BodyVolume: float | None = Field(
+        None, examples=['156435 gal[US]'], title='Body Volume'
+    )
+    """
+    The volume pumped for the body portion of the stage treatment.
+    """
+    BreakDownPressure: float | None = Field(
+        None, examples=['8358 psi'], title='Break Down Pressure'
+    )
+    """
+    The pressure at which the formation fractures and accepts injected fluid.
+    """
+    CasingPumpRateMax: float | None = Field(
+        None, examples=['46 bbl/min'], title='Casing Pump Rate Max'
+    )
+    """
+    Maximum casing fluid pumping rate of any step while treating the stage.
+    """
+    CasingPressureAvg: float | None = Field(None, title='Casing Pressure Average')
+    """
+    The average casing pressure of any step for the stage treatment.
+    """
+    CasingPressureMax: float | None = Field(None, title='Casing Pressure Max')
+    """
+    The highest casing pressure of any step while treating the stage.
+    """
+    ClosureDuration: float | None = Field(
+        None, examples=['1 min'], title='Closure Duration'
+    )
+    """
+    Delta time recorded for the closure of the fracture to occur during the stage treatment.
+    """
+    ClosurePressure: float | None = Field(None, title='Closure Pressure')
+    """
+    An analysis parameter used in hydraulic fracture design to indicate the pressure at which the fracture effectively closes without proppant in place.
+    """
+    ConductivityAvg: float | None = Field(None, title='Conductivity Average')
+    """
+    Average conductivity of a fracture created during the treatment supported by proppant during the stimulation services. Hydraulic conductivity, symbolically represented as K, is a property of vascular plants, soil or rock, that describes the ease with which water can move through pore spaces or fractures. It depends on the intrinsic permeability of the material and on the degree of saturation. Saturated hydraulic conductivity, Ksat, describes water movement through saturated media.
+    """
+    FlushVolume: float | None = Field(None, examples=['5 bbl'], title='Flush Volume')
+    """
+    Volume pumped during flush portion of stage treatment.
+    """
+    FormationBreakLengthPerDay: float | None = Field(
+        None, examples=['1000 ft/d'], title='Formation Break Length Per Day'
+    )
+    """
+    The length of formation broken (fracced) per day.
+    """
+    FormationName: str | None = Field(None, examples=['Willow'], title='Formation Name')
+    """
+    The name of the formation being stimulated in this job stage.
+    """
+    LithostratigraphicID: (
+        constr(
+            pattern=r'^[\w\-\.]+:reference-data\-\-LithoStratigraphy:[\w\-\.\:\%]+:[0-9]*$'
+        )
+        | None
+    ) = Field(None, title='Lithostratigraphic ID')
+    """
+    Lithostratigraphic (Formation Top name) Identifier
+    """
+    WellboreMarketSetID: (
+        constr(
+            pattern=r'^[\w\-\.]+:work-product-component\-\-WellboreMarkerSet:[\w\-\.\:\%]+:[0-9]*$'
+        )
+        | None
+    ) = Field(None, title='Wellbore Marker Set ID')
+    """
+    ID to the Wellbore Marker Set containing the Marker (Formation Top) that is stimulated in the Job Stage
+    """
+    WellboreMarkerID: str | None = Field(None, title='Wellbore Marker ID')
+    """
+    ID to the Wellbore Marker within the Wellbore Marker Set that is stimulated in the Job Stage
+    """
+    ReservoirID: (
+        constr(pattern=r'^[\w\-\.]+:master-data\-\-Reservoir:[\w\-\.\:\%]+:[0-9]*$')
+        | None
+    ) = Field(
+        None,
+        examples=['namespace:master-data--Reservoir:Willow:'],
+        title='Reservoir ID',
+    )
+    """
+    Identifier to the Reservoir stimulated in the Job Stage
+    """
+    ReservoirSegmentID: (
+        constr(
+            pattern=r'^[\w\-\.]+:master-data\-\-ReservoirSegment:[\w\-\.\:\%]+:[0-9]*$'
+        )
+        | None
+    ) = Field(None, title='Reservoir Segment ID')
+    """
+    Identifier to the Reservoir Segment stimulated in the Job Stage
+    """
+    FormationTopMeasuredDepth: float | None = Field(
+        None, examples=['7300 ft'], title='Formation Top Measured Depth'
+    )
+    """
+    Measured depth of the top of the formation.
+    """
+    FormationTopTrueVerticalDepth: float | None = Field(
+        None, examples=['7036 ft'], title='Formation Top True Vertical Depth'
+    )
+    """
+    True vertical depth of the top of the formation.
+    """
+    FormationBottomMeasuredDepth: float | None = Field(
+        None, title='Formation Bottom Measured Depth'
+    )
+    """
+    Measured depth of the bottom of the formation.
+    """
+    FormationBottomTrueVerticalDepth: float | None = Field(
+        None, title='Formation Bottom True Vertical Depth'
+    )
+    """
+    True vertical depth of the bottom of the formation.
+    """
+    FractureGradientInitial: float | None = Field(
+        None, examples=['1.079 psi/ft'], title='Fracture Gradient Initial'
+    )
+    """
+    The formation fracture gradient for stage before treatment.
+    """
+    FractureGradientFinal: float | None = Field(
+        None, examples=['1.079 psi/ft'], title='Fracture Gradient Final'
+    )
+    """
+    The formation fracture gradient for the stage after treatment.
+    """
+    FractureHeight: float | None = Field(
+        None, examples=['0.25 in'], title='Fracture Height'
+    )
+    """
+    The height of the fracture  created after treating the stage.
+    """
+    FractureLength: float | None = Field(
+        None, examples=['12 ft'], title='Fracture Length'
+    )
+    """
+    The length of the fracture created after treating the stage.
+    """
+    FractureWidthAvg: float | None = Field(
+        None, examples=['0.15 in'], title='Fracture Width Average'
+    )
+    """
+    Average fracture width created during the treatment of the stage.
+    """
+    FrictionPressure: float | None = Field(None, title='Friction Pressure')
+    """
+    Friction pressure loss encountered by fluid transported to stage interval.
+    """
+    HHPAvg: float | None = Field(None, examples=['7431 hp'], title='HHP Average')
+    """
+    Average hydraulic horse power used for the stage.
+    """
+    HHPMax: float | None = Field(None, examples=['7800 hp'], title='HHP Max')
+    """
+    Maximum hydraulic horse power used for the stage.
+    """
+    HHPOrderedCO2: float | None = Field(
+        None, examples=['8000 hp'], title='HHP Ordered CO2'
+    )
+    """
+    Carbon dioxide hydraulic horsepower ordered for the stage.
+    """
+    HHPOrderedFluid: float | None = Field(None, title='HHP Ordered Fluid')
+    """
+    Fluid hydraulic horsepower ordered for the stage.
+    """
+    HHPUsedCO2: float | None = Field(None, title='HHP Used CO2')
+    """
+    Carbon dioxide hydraulic horsepower actually used for the stage.
+    """
+    HHPUsedFluid: float | None = Field(None, title='HHP Used Fluid')
+    """
+    Fluid hydraulic horsepower actually used for the stage.
+    """
+    IsScreenedOut: bool | None = Field(None, examples=[False], title='Is Screened Out')
+    """
+    Did screen out occur? True (true or 1) indicates that screen out occurred. False (false or 0) or not given indicates otherwise.
+    """
+    MaterialUsageRateMax: list[v1_0_0.AbstractStimMaterialQuantity] | None = Field(
+        None, title='Material Usage Rate Max'
+    )
+    """
+    Usage and maximum mass or volume flow rates for a material for this job stage.
+    """
+    MaterialUsage: list[v1_0_0.AbstractStimMaterialQuantity] | None = Field(
+        None, title='Material Used'
+    )
+    """
+    Material used during this job stage. For example, proppant or gel (additive).
+    """
+    NetPressure: float | None = Field(None, title='Net Pressure')
+    """
+    The difference between the pressure which holds a fracture closed (minimal principal stress) and that pressure which is necessary to open the fracture.
+    """
+    OpenHoleDiameter: float | None = Field(
+        None, examples=['6 in'], title='Open Hole Diameter'
+    )
+    """
+    The diameter of the open hole.
+    """
+    OpenHoleName: str | None = Field(
+        None, examples=['6" Hole Section'], title='Open Hole Name'
+    )
+    """
+    A name for the open hole. To be used for open hole completions.
+    """
+    PadPercent: float | None = Field(None, examples=['100 %'], title='Pad Percent')
+    """
+    The percentage of volume pumped used for the pad.
+    """
+    PadVolume: float | None = Field(None, examples=['8194 gal[US]'], title='Pad Volume')
+    """
+    Volume pumped for pad portion of stage treatment.
+    """
+    PumpDiagnosticSession: list[PumpDiagnosticSessionItem] | None = Field(
+        None, title='Pump Diagnostic Session'
+    )
+    """
+    A pumping diagnostics session for this job stage.
+    """
+    PerfBallCount: int | None = Field(None, title='Perf Ball Count')
+    """
+    Total number of perforation balls used while treating the stage.
+    """
+    PerfBallSize: float | None = Field(None, title='Perf Ball Size')
+    """
+    The size (diameter) of the perforation balls used while treating the Stage
+    """
+    ProppantBHConcAvg: float | None = Field(
+        None,
+        examples=['0.51 lbm/gal[US]'],
+        title='Proppant Bottomhole Concentration Average',
+    )
+    """
+    The average proppant concentration at the bottom of the interval.
+    """
+    ProppantBHConcMax: float | None = Field(
+        None,
+        examples=['0.61 lbm/gal[US]'],
+        title='Proppant Bottomhole Concentration Max',
+    )
+    """
+    The maximum proppant concentration at the bottom of the stage interval for all job steps.
+    """
+    ProppantDesignMass: float | None = Field(
+        None, examples=['0.55 lbm'], title='Proppant Design Mass'
+    )
+    """
+    The planned, total proppant mass for this job stage.
+    """
+    ProppantInFormationMass: float | None = Field(
+        None, examples=['44100 lbm'], title='Proppant In Formation Mass'
+    )
+    """
+    The weight of proppant placed in the formation.
+    """
+    ProppantHeight: float | None = Field(
+        None, examples=['0.25 in'], title='Proppant Height'
+    )
+    """
+    The proppant height.
+    """
+    ProppantInFormationTotal: float | None = Field(
+        None, examples=['44100 lbm'], title='Proppant In Formation Total'
+    )
+    """
+    The cumulative total amount of proppant in the formation including the current stage.
+    """
+    ProppantPerforationConc: float | None = Field(
+        None, examples=['0.51 lbm/gal[US]'], title='Proppant Perforation Concentration'
+    )
+    """
+    The proppant concentration at the perforations.
+    """
+    ProppantPumpedPercent: float | None = Field(
+        None, examples=['100 %'], title='Proppant Pumped Percent'
+    )
+    """
+    Total proppant mass used as a percent of the design mass.
+    """
+    ProppantSurfaceConcAvg: float | None = Field(
+        None, examples=['0.51 lbm/gal[US]'], title='Proppant Surface Conc Average'
+    )
+    """
+    The average proppant concentration on the surface.
+    """
+    ProppantSurfaceConcMax: float | None = Field(
+        None, examples=['0.51 lbm/gal[US]'], title='Proppant Surface Conc Max'
+    )
+    """
+    The maximum proppant concentration on the surface.
+    """
+    ProppantWellboreMass: float | None = Field(
+        None, examples=['44100 lbm'], title='Proppant Wellbore Mass'
+    )
+    """
+    The weight of proppant left in the wellbore after pumping has stopped.
+    """
+    PumpTimeTotal: float | None = Field(
+        None, examples=['45 min'], title='Pump Time Total'
+    )
+    """
+    The total pumping time for the treatment of the stage.
+    """
+    ScreenOutPressure: float | None = Field(None, title='Screen Out Pressure')
+    """
+    The screen out pressure.
+    """
+    ShutInPressure: list[ShutInPressureItem] | None = Field(
+        None, title='Shut In Pressure'
+    )
+    """
+    Shut in pressure data for this job stage.
+    """
+    ShutinPressureInitial: float | None = Field(
+        None, examples=['3964 psi'], title='Shut In Pressure Initial'
+    )
+    """
+    The initial shut-in pressure.
+    """
+    SlurryReturnRateAvg: float | None = Field(None, title='Slurry Return Rate Average')
+    """
+    The average slurry return rate of all steps for the stage treatment.
+    """
+    SurfacePressureAvg: float | None = Field(None, title='Surface Pressure Average')
+    """
+    The average pressure for treating the stage across all steps.
+    """
+    SurfacePressureMax: float | None = Field(None, title='Surface Pressure Max')
+    """
+    Maximum surface pressure during treatment of the stage.
+    """
+    TechnologyDescription: str | None = Field(None, title='Technology Description')
+    """
+    Text describing the technology used while pumping the stage.
+    """
+    BHTreatingTemperatureAvg: float | None = Field(
+        None, title='Bottomhole Treating Temperature Average'
+    )
+    """
+    The average measured or calculated bottom hole temperature whilst pumping with well fluid injection or circulation of the wellbore at the point of interest. Point of interest is generally the injection point or region of interest for the test or treatment.
+    """
+    TubingFluidRateMax: float | None = Field(None, title='Tubing Fluid Rate Max')
+    """
+    Maximum tubing fluid pumping rate of any step while treating the stage.
+    """
+    TubingPressureAvg: float | None = Field(None, title='Tubing Pressure Average')
+    """
+    The average tubing pressure for the stage treatment.
+    """
+    TubingPressureMax: float | None = Field(None, title='Tubing Pressure Max')
+    """
+    The highest tubing pressure of any step while treating the stage.
+    """
+    SlurryVolumeTotal: float | None = Field(None, title='Slurry VolumeTotal')
+    """
+    The total slurry volume pumped for all steps while treating the stage.
+    """
+    WaterSource: str | None = Field(
+        None, examples=['Willow Municipal'], title='Water Source'
+    )
+    """
+    Water source description for fluid pumped during stage.
+    """
+    PerforationSet: (
+        list[
+            constr(
+                pattern=r'^[\w\-\.]+:master-data\-\-PerforationInterval:[\w\-\.\:\%]+:[0-9]*$'
+            )
+        ]
+        | None
+    ) = Field(None, title='Perforation Set')
+    """
+    Set of Perforation Intervals stimulated in this stage.
+    """
+    PerforationSetFrictionFactor: float | None = Field(
+        None, title='Perforation Set Friction Factor'
+    )
+    """
+    Perforation Set Friction Factor
+    """
+    PerforationSetFrictionPressure: float | None = Field(
+        None, title='Perforation Set Friction Pressure'
+    )
+    """
+    Perforation Set Friction Pressure
+    """
+    PerforationSetDischargeCoefficient: float | None = Field(
+        None, title='Perforation Set Discharge Coefficient'
+    )
+    """
+    Perforation Set Discharge Coefficient
+    """
+    WellLog: (
+        list[
+            constr(
+                pattern=r'^[\w\-\.]+:work-product-component\-\-WellLog:[\w\-\.\:\%]+:[0-9]*$'
+            )
+        ]
+        | None
+    ) = Field(None, title='Well Logs')
+    """
+    Log(s) associated to the Stimulation Stage
+    """
+    Remarks: str | None = Field(
+        None,
+        examples=[
+            'Screened out observing 1.5T in formation, 1.5T in wellbore, max acheivable rate 350 L/minute at 61.75 MPa. FLBK 50 m3 at 0.9 m3/min average. Attempted to Flush Wellbore observing 24 m3 to seat ball. Established feed rate 0.5 m3/min at 60 MPa. Displaced 1 m3 HCR to perfs and let soak 5 min. Re-initiated frac as per.'
+        ],
+        title='Remarks',
+    )
+    """
+    General remarks about this Stage of the Stim Job.
+    """
+    ExtensionProperties: dict[str, Any] | None = None