Technical Workflow Objects
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
Select the KW 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.
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:

If you click on the PVT object, you will see general information and PVT details, including Fluid type, PVT type, Parameters, and Fluid properties.
![]() |
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.
Estimated delta P: optional field.
Injected pressure: optional field.
Injected temperature: optional field.
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).
Procedure to create a Wellbore object
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.