The basic package features scripts to calculate cumulative production and injection, volumes, rates and ratios, and to tag entities based on their production data.
Usage and Configuration
To perform the calculations run the workflows from this package starting with the workflow Validate Basic Package. The schedules may be adapted to use different contexts.
Follow the steps given in How do I configure packages pulled from Datagration's package repository to change the configuration of the package.
To skip package validation set the workspace value RunPackageValidation to False.
Use the workspace value DataLoadOffsetDays to configure the end of the scopes Start To Date Daily and Start To Date Monthly.
E.g. If the data in the data sources is lagging one day, set the workspace value to 1 to account for this offset.
The workspace value ProducedPhasesInWorkspace states which phases (oil, gas, water, condensate) are produced in the workspace.
The workspace value InjectedPhasesInWorkspace states which phases (gas, water) are injected in the workspace.
If there is no injection in the workspace, clear the value.
Set the workspace value IsLiquidImported to True if the total liquid volume or rate is imported from the source system. The default value (False) triggers the package to calculate the liquid data from other available phases.
The package supports auto-aggregation from perforation- to well-level. The hierarchy used for auto-aggregation can be configured using the workspace value HierarchyWellPerforationRelationships. If auto-aggregation is not needed, the value of this workspace value can be cleared.
Details
Workflow Validate Basic Package
This workflow checks for the availability of needed input data. The activities in the workflow will only be executed if the workspace value RunPackageValidation is set to True.
Workflow Cumulatives, Volumes, Rates and Ratios
Cumulatives
Cumulatives are calculated for all phases specified in the workspace values ProducedPhasesInWorkspace, InjectedPhasesInWorkspace, as well as the signals time on production and time on injection. Furthermore, the cumulative liquid production is calculated.
Volumes, Rates, Ratios
The oil-, gas-, water-, condensate- and liquid production rates as well as water- and gas injection rates are calculated from the respective volume signal and the time on production or time on injection if not available. If the time on production or time on injection is not available the code falls back to use a constant depending on the used scope. Likewise, the production and injection volumes are calculated from the rates if not available.
The calculated ratios are:
- gas liquid ratio
- gas oil ratio
- water oil ratio
- water cut
- water gas ratio
- oil gas ratio
- condensate gas ratio
Workflow Tag Based On Data
Tag Active Entities
Entities are tagged as Active if their time on production, time on injection, or any of the produced or injected volumes is bigger than 0.
Tag Function
Entities are tagged as either Produce or Inject based on the available data.
Tag Phase
Entities are tagged as producing or injecting oil, gas, water, condensate, hydrocarbon or liquid in general, based on the available data. Since an entity may produce more than one phase at a given time, this tag entries are not mutually exclusive.
Workflow Assign Primary Phase
This step determines the entity's primary phase based on the first six months of production and guidelines from W.D. McCain's Phase Behavior text book.
Data Requirements
The following data is required:
production rates or volumes
injection rates or volumes
time on injection or production