Installing WellSim

Tutorial: Geometry configurations (for a vertical well)

A Geometry configuration describes the lengths and angles of the different casing, liner or open-hole sections of a well, with their diameters and roughness.

This tutorial show you how to enter a geometry configuration for a vertical well:

Well sections to use

You will enter data for this well:

Section From [m] Down to [m] Casing or liner
1 0 900 Casing 9 5/8" 47 lb/ft
2 900 2500 Slotted Liner 7 5/8" 29.7 lb/ft


Creating a new geometry configuration

Create a new, empty configuration

  1. Open the sample database if it is not already open.

  2. Click to select this well for the tutorial.

  3. If necessary, click the in front of to display the WellSim data types.

  4. Under , click Geometry configurations.

  5. Right-click in a row under Description to pop up a menu:

  6. Click New in the menu. WellSim creates a new, empty geometry configuration. Click the tab (top left). The window should look like:

Enter the first section of the well:

Before you enter data, read these tips for entering data.

Enter this data into the empty row at the top, right of the window:

Data Enter Note
Measured depth 900 [m] The depth of the bottom of the first section (below ground level at the wellhead)
Casing description Casing 9 5/8 N47.0 Choose from the drop-down list. Click in the Casing description field, then click to display the drop-down list, scroll up or down the list, then click the Casing description to use. After you choose a casing, WellSim fills in the diameters and roughness.

Create a new empty well section

Enter the second section

Enter this data in the new empty row:

Data Enter Note
Measured depth 2500 [m] The depth of the bottom of this section (below ground level at the wellhead)
Casing description Liner 7 5/8" N29.7 Choose from the drop-down list

Your window should now look like:

Check and fix the data you just entered

Note: The above data is incomplete, because you have not yet entered a description or specified that the well is vertical.

  1. Click .

  2. WellSim displays a message that the data you have entered has errors. Click OK.

Now, find and fix the errors:

  1. Click at the bottom of the window. In the Header messages tab at the bottom of the screen, WellSim displays an information message (starts with an I) that you have not entered a description for the new geometry configuration.

  2. Click Description (in the tab, left side of window) and type Actual geometry.

  3. Click at the bottom of the window. In the Dataset messages tab at the bottom of the screen, WellSim displays error messages (start with E), that vertical depth and angle are both empty (one of these needs to be entered). WellSim also displays information messages (start with I) that it can calculate vertical depth from angle or angle from vertical depth.

  4. Click Angle in the first section and type 0.

  5. Click Angle in the second section and type 0.

  6. Click again. Now there should be no error messages.

Calculate the data (Apply)

WellSim will calculate any data it can that you have not entered.

In this case, WellSim calculates the vertical depths of the bottoms of the well sections, and the window should look like:


Saving your new geometry configuration



  1. A Check and Apply. If there is a problem with the data it will display Dataset or Header messages at the bottom of the window and not save the data until you have corrected the data.
  2. Saves the geometry configuration you have just entered to the database
  3. Exits the editing window and returns to WellSim's home window.

When you have entered or edited any dataset, normally just click , rather than clicking and first.


To ignore the data you have just entered and exit, click .

Save As

Save As is the same as Save, except that WellSim creates a new geometry configuration for the well with the same data as this geometry configuration and a new description.

For example, you might have already created a geometry configuration with the actual well geometry and saved it. To create a new geometry configuration with different casing and liner sizes:

  1. Edit the actual geometry configuration to change the casing and liner sizes.

  2. Click .

  3. Type a new description for the new geometry configuration and click OK.

Notes on casings and liners


Slotted/solid liner

WellSim assumes that liners are slotted along their entire lengths. If your liner is solid, enter it as a casing with the same size. If your liner has solid and slotted sections, enter it as several sections:

Using custom values for Inner Diameter, Outer Diameter or Roughness

If you want to base your custom values on an existing casing or liner:

  1. In the Casing description dropdown list, select the casing or liner to base your values on.

  2. This sets Outer Diameter, Inner Diameter and Roughness in the line for that section. Note these values.

Set your custom values:

  1. In the Casing description dropdown list, select Non-standard casing.

  2. Enter the required Outer Diameter, Inner Diameter and Roughness.