Technical Workflow Objects

PVT Object Extraction

PVT object can be extracted manually from the documents stored under a field, well group or well and saved under dedicated file folder which is created at the same level as the file and will be called PVT

To extract PVT object from a K-W document:

Select the K-W document under a field, well group, or well.
Under the Info or Plot tab, click on Extract PVT, .
The PVT type will be automatically assigned based on the file content—either EOS or Black Oil—determining how the PVT data will be extracted.
Rename it as needed.

Adding Time Dependent PVT to an Existing PVT Object:

Select the PVT object to which the new data will be added..
In info page, click on
Select the K-W document from which the PVT data will be extracted.
Define the start date for the new PVT data.
Click on Extract.

Extraction Result

When Extract PVT is first launched, it will create a new folder called Pvts in the same level as the KW Document, with the PVT object:

Selecting the PVT object displays general information and PVT details, including:

Fluid Type
PVT Type
Parameters
Fluid Properties

Black Oil PVT

For a Black Oil PVT object:

The Info tab displays general information and PVT details, including fluid type, PVT type, parameters, and fluid properties.
The Plot tab displays fluid property plots. Users can display multiple properties simultaneously by selecting the desired ones.

EOS PVT

several tabs provide detailed information and plots related to the fluid’s thermodynamic behavior.:

The Info tab displays the EOS parameters:
- EOS model
- Number of components
- Viscosity model
It also shows:
- Component fractions
- Component properties (Pc, Tc, Vc, etc.)
- Binary interaction coefficients between components
The plot tab displays the EoS consistency plots
The Phase Envelope tab displays the fluid’s phase envelope and offers several interactive options:
- Access a summary table showing key fluid points such as: Critical point, saturation point, cricondentherm and cricondenbar points by clicking on ,.
- Display isolines by clicking on Show Contours ,.
- Display labels on isolines by clicking on ,.
- Switch the phase envelope display from Pressure vs Temperature to Pr vs Tr using ,.
- View the flash table at standard conditions by clicking on ,.
- Extract the phase envelope panel into a separate window using .
- Next to the phase envelope, the flash results at standard and reference conditions are displayed. Users can also define additional flash conditions using option above the table. This feature provides a quick lookup of fluid properties at a specified pressure and temperature.

Wellbore

The Wellbore object describes the physical structure and configuration of a wellbore. It includes detailed information such as the well trajectory, casing and tubing strings, gas lift valves, and perforation zones.

In dynamic well environments, where the wellbore configuration may change due to interventions such as completions, tubing installations, or workovers, the Wellbore object supports time-dependent configurations with associated timestamps. This enables accurate tracking of historical wellbore states and modelling of well conditions over time.

The wellbore object is an essential input for calculating bottomhole pressure (BHP), and generating inflow profiles.

To define a wellbore object, the following inputs are required:

Trajectory
Defines the spatial path of the wellbore. Must be provided as directional survey data. Each survey point must include: measured depth (MD), true vertical depth (TVD) and inclination.
Geometry
Specifies the physical configuration of the wellbore along the depth. Each segment must define its structural state. Open hole, cased hole, or includes installed tubing.
For cased or completed intervals, define each string dimensions: Inner Diameter, Length, Thickness and Roughness.
Flow Path
Describes the production flow path in the wellbore. This is essential for production modelling and pressure loss calculations.
The flow path must be defined, e.g., though tubing, casing or annulus.

The Wellbore object includes definitions for gas lift valves, which are essential for modeling wells that use gas lift for production. It also allows the specification of perforation zones, which are used to generate inflow profiles.

Gas lift valve

For gas lift wells, the details of the gas lift valves can be specified:

Gas lift valve MD: This parameter specifies the installation depth of the valve and is mandatory when a Gas lift valve is defined.
Injected gas rate: This is an optional parameter in the BHP workflow, as the injected gas rate is predefined in the Gas Lift section.
PVT: This is an optional parameter in the BHP workflow.

Perforations

To define perforations, the following information must be provided for each perforation interval:

MD Start: Measured depth at the start of perforation interval.
MD End: Measured Depth at the end of perforation interval.
Is Open: Perforation status, open or closed (default is open).

User can add or edit perforations during wellbore editing. To do so:

In the Wellbore node, click the Edit Perforations button ,.
Modify existing perforations directly in the table using the status circles ( = open, = closed, = not present at this date/depth).
Select multiple perforation rows and click on to update them in bulk.
Click on to create a new time‑dependent perforation state, then enter the corresponding date.
Use the or icons to add or delete a perforation at a specific depth.
Click on option to copy an existing timestamp and its perforation configuration.

Procedure to create a Wellbore object

Wellbore objects can be created via the multi-well load process. This requires that wellbore data be stored in a database structured according to the KAPPA SQL schema.

Prerequisites

Wellbore data must be populated and available within the KAPPA SQL schema. It is strongly recommended to populate all available data fields, including non-mandatory ones. If certain fields are missing, default values will be assigned during the wellbore object creation.
Note
If casing data are missing, KA applies default settings:
- A default casing is added along the entire trajectory, with ID = 2 × TubingID.
- The flow path is set to Tubing.
- A warning message is displayed in the wellbore information page.
The mirroring data source and the multi-well load data source must be correctly configured and validated.

Procedure

Provide a Name for multi well load.
Select the Data Source.
Select the Tag (filters configured in the multi-well load setup).
Click Create.

Once the multi-well load process is completed the wellbore object is displayed under well node.

Alternative method:

Using KAPPA-Automate SDK

Wellbore object can also be created using KAPPA-Automate SDK.

Prepare the deviation survey and wellbore geometry definition. If available, also include gas lift valve and perforation data.
Supported formats include Excel files and SQL databases, both must follow the KAPPA Automate format.
Run the Python script.
Execute the script to process the input data.
Create the wellbore object.
The script will generate a Wellbore object under the Well node.

Inside KAPPA-Automate

A Wellbore object can also be created directly within KAPPA-Automate.