Documentation

Currently the website only supports one payment gateway: PayPal. Anyone can create a PayPal account and it's one of the most commonly used payment gateways on the internet. In many countries, you can even pay without creating an account - directly with your credit card.

 


 

 

After the purchase goes through PayPal, you are returned to the Checkout page, where you will receive links to download the software, and your license key to activate the software. Before being redirected to PayPal, you were asked to create an account on Addocera.com. This is so you can return to the site at any later time, and see your product download links and license key. The same information is also sent to your email account after the purchase is completed.

In your download links, you will see more than one setup file - and you will only need to download one of them depending on your Windows version (Vista, 7, 8 or 8.1) and installation (32-bit or 64-Bit).

 

Windows Vista or 7 (64 Bit)         ->           WelltestSimulatorDX9Win64

Windows Vista or 7 (32 Bit)         ->           WelltestSimulatorDX9Win32

Windows 8 or 8.1 (64 Bit)             ->           WelltestSimulatorDX11Win64

Windows 8 or 8.1 (32 Bit)             ->           WelltestSimulatorDX11Win32

If you are unsure, WelltestSimulatorDX9Win64 is your best bet.

 

Pick the correct file, and click on it to start the download. Currently the files are about 600MB each - so you might have to be patient while downloading (and don't close your browser, or the download will be interrupted). When the file is fully downloaded you are ready for installation.

 

Run the setup version that you just downloaded. If you are warned that the setup is not digitally signed, you can safely ignore that message (from Windows UAC)

installation - UAC Warning on Windows

Once the installation starts - please follow each step.

Setup 1

 

Please read the EULA (End-User License Agreement) carefully, and check the box - the "Next" button will then be available

Setup 2

Next you will be asked to enter an installation path. In most cases, you can just press "next" and keep all the original settings.You will need about 1 Gigabyte of free space on the drive you are installing on.

Setup 4

The setup will add a menu shortcut, and another on the Desktop by default. You can choose if you want to add these shortcuts.

Setup 5

Once the setup program has all the information it needs, the program will present a summary and start the installation - which should take between 30 seconds and 3 minutes.

Setup 6

the Installation will proceed...

Setup 7

 

 

hen the installation is complete, you can choose to run the simulator immediately.

 

 

Setup 8You are all set to activate the program.

Before the simulator starts up, you will get a chance to pick the proper resolution to run the software, and the graphical fidelity you want to run it at. You can also choose if you want to run it in full-screen or windowed mode. First pick the resolution. If you are using an LCD monitor or laptop, it is recommended that you use its native resolution.

Run 2

You can also choose your graphics quality. If you have a high-performance graphics card, or a fast laptop, you can pick from the better options. This will not affect the workings of the simulator, but will simplify the graphics to keep the frame rate at a reasonable rate.

Run 3

If you have more than one monitor, the simulator allows you to pick the monitor you want to run on. More than one monitor is not supported, but certain programs can be used to "fake" a single monitor setup on a multi-monitor setup.

Run 4

 

Press Play...

Run 5

Run 6

The first time you run the program, you will be asked to activate your license. In order to do so, your computer will need to be connected to the internet, and if you have a firewall, it should allow normal HTML port 80 connections.

You will need to enter the email that you used to purchase the software, and the license key that you were offered after the payment. Of course you can always go back to your addocera.com account and retrieve the license key, or check your purchase invoice in your email. Once you enter the information and press "activate" the license will be checked, and your software will be activated - you will never be bothered again with the activation screen - and will be taken directly to the main menu.

Please note that if you change hardware components, or try to use the software on another computer, you will need to activate the software again.

If the software does not activate using the correct key, and the exact email that you used to purchase the software, please contact support - at - addocera.com

Activation 1

If you enter the wrong information, you will be given a warning...

Activation 3

If for some reason (e.g. no available internet) you don't have your license, you can still run in demo mode, albeit with some limitations in the simulation. We suggest you only use activated versions of the simulator. If the activation went well, you will be taken to the main menu:

Run Activatedd 1Congratulations, you are ready to run the simulator!

 

 

 

 

Here are some pointers in navigation and operating the various controls:

  1. Use the WASD keys to walk forward, left, right and backward. Holding down SHIFT while moving, will increase your movement speed (and sap your energy level faster). This movement style is very common on shooters and video games played on the PC.
  2. Use the mouse to look around you. If you want to stop moving the camera, and move the mouse cursor to manipulate controls instead, just press and hold the ALT key. I suggest keeping your left thumb on the ALT key for ease of control.
  3. Left clicking will turn controls anti-clockwise (Open them) and right-clicking on them will turn them clockwise (Close them).
  4. Use the numbers 1, 2, 3 and 4 to teleport quickly between the rig, separator, left burner and right burner locations without having to walk or run between them.
  5. Clicking on some objects will bring up a description of them (e.g. the top-drive on the rig, etc.)
  6. Pressing space will allow you to jump. It might be useful if you get stuck due to faulty physics, but is not essential to movement.
  7. Pressing “c” on your keyboard will allow you to crouch. This is useful when viewing the sight-glasses or some valves under the separator or gauges to reduce the parallax effect or get a better viewing angle. You will remain crouched until you let go of the “c” key.
  8. Pressing F9 will remove the menu bars temporarily if you want to take screenshots in the simulation. Pressing it again will make the menus reappear.
  9. Generally clicking on a gauge or control box (e.g. PCV control boxes, or the Barton chart recorder) will zoom in or activate details and options for that display, and right-clicking (or ESC) will zoom out or exit the interface.

WTSSrnShotA_keyboard help page

The in-game menus are generally easy to understand. Some will open plot windows and dialogs for data entry, while others will simply change the way a mouse-click affects a valve e.g. The easiest way to understand what they do it to click on them and see what happens.

in-game Menus

The Flow-rate and pressure values that you see displayed on the gauges and charts in the simulator are based on an approximation of the network model used for the pipe layout, valves, choke, etc. Even though the estimate is not good enough for an in-depth analysis, the values reflect the user's interactions with the network (including transients and delays, and the calculations are very fast - allowing the solution to update many time per second.

WTSSrnShotA_gui dataheader tempgauge

Effluents coming out of a well are usually much warmer than the surface temperature. Fluids changing phase, or going through rapid pressure changes also affects their temperature (P.V = nRT). Temperature is simulated for pressure changes after the fluid exits the well, for the choke, and also due to dissipation from the piping/separator/tank systems. Since there is no need for temperature measurements after the gauge tank, temperatures are not calculated beyond that point.

 

The Simulator takes into account H2S escaping during the test, its dispersion pattern, the effect of wind, and the location of the player.

Wind:

Wind is simulated in an unrealistic way, i.e. every 5-15 minutes the direction of the wind will change by a value between 2 and 90 degrees. This encourages the player to keep an eye on the wind socks, and switch burners when needed. The speed and direction of the wind are displayed in the left hand panel.

WTSSrnShotA_nogui windsock

Wind direction and speed affect

  • the direction of the flames on the burners,
  • the steam rising on the burners,
  • the flame on the rig flare
  • the wind socks
  • the anemometers installed under wind socks
  • the dispersion pattern of H2S when there is a leak

H2S Dispersion:

When there is a leak (e.g. because the player opened one of the sampling points under pressure) H2S will leak. The amount depends on the pressure at the point, which in turn affect how much effluent is released. This amount of H2S will spread based on the field generated by the wind speed and direction. It will also spread hugging the ground surface (H2S is a bit heavier than air).

WTSSrnShotA_nogui mask leak

The amount of H2S at the point where the player is standing is displayed in the right hand panel. This number affect the player's health, when it goes beyond a certain limit, unless the player is using a gas mask (accessible from the top menu). Once the leak is corrected, the H2S levels will drop (based on the wind speed).

 

WTSSrnShotA_gui burner oilandgas

The amount of heat generated by burning effluent and gases in a well-test can be considerable, and are a major safety concern in offshore jobs, or jobs in tight quarters. The Well Test Simulator takes into account the amount of effluent burned and the amount of gases flared on each burner boom, and uses a simple inverse-square formula to calculate the amount of heat radiation impinging on the player. The amount of heat, when above a certain point, will affect the player's "Health" (as show on the Right hand panel), and the local temperature will be displayed in the left hand panel. Effects of shielding (e.g. hiding behind a compressor or any opaque object, and the amount of water pumped into the flames) are not considered for the time being.

 

The Simulator follows a basic Surface Well Test (SWT) equipment layout. There are minor differences though, e.g.

a) It is doubtful if a Gauge Tank and surge tank would be used in a test at the same time, but we included both in the simulator (and provided a bypass manifold) so that trainees can get some experience with both.

b) Controls for the burners have been omitted, mainly because they are quiet different between different burners, but also because they are not directly related to flowing and gathering data in a test. In the future, and once more important equipment (Sand Traps, Heater, Steam Exchanger, Chemical Injection Pump, etc.) have been added, we will also add additional burner types and controls to light them.

c) In most well test environments space comes at a premium and equipment is packed a bit closer together than the simulator lets you believe - especially in offshore jobs. We are working on adding an alternate offshore environment.

d)  A lot of equipment that you might see on a real drilling rig that has nothing to do with the test has been omitted, although we tried to include the most important equipment used in every rig, so trainees learn more about the environment they will be working in.

Below is a list of the equipment that can be operated:

Well Test Simulator - Complete SWT Well Test Layout

 

  1. Flowhead
  2. Surface Safety Valve and Emergency Shut-down Panel
  3. Data Header (Gauge Header)
  4. Choke Manifold
  5. Separator
  6. Pressurized Tank (Surge Tank)
  7. Atmospheric Tank (Gauge Tank) + Bypass Manifold
  8. Transfer Pump
  9. Oil Manifold
  10. Gas Manifold

The two white arrows show the piping that goes to the left and right burners.

The flowhead suspends the weight of the drill/test string during testing, allows swiveling, and provides multiple valves to control the testing operations. These include the manual master valve, used to open the well, the kill valve (not simulated yet) that features a one-way valve to pump pressure downhole (e.g. to control DST tools), a hydraulic wing valve, to produce fluid (normally controlled from the ESD panel) and a swab valve (used for tool insertion). There are also multiple point where needle valves can be installed for gauges and sampling of effluents.

Well Test Simulator - Flowhead - Parts

1. Master Valve: a 10-turn gate valve rated to hold the maximum well pressure

2. Wing Valve (hydraulic): controlled from the ESD panel. The wing valve is normally closed and will shut if the hydraulic pressure to the actuator is released (e.g. due to a cut in the hydraulic lines)

3. Swab valve: currently needs to be open to be able to read the Well-Head Pressure gauge on top of the swab valve, and has no other function. In a real well, the swab valve give direct access to tools that you might want to send downhole.

4. Kill Valve: In a well test the kill valve is normally used to cycle down-hole testing tools.

5. There is a pressure gauge on top of the flowhead that shows WHP.

The flowhead is connected to a flexible high-pressure pipe that directs the effluents off the rig (if it is a land rig e.g.) to the test area. Sometimes it might be replaced by articulated or fixed piping. The white arrow shows the direction of the effluent flow out from the flowhead.

 

 

Well Test Simulator - Flowhead - Gauge

1. The gauge on top of the flowhead allows you to read the Well-Head Pressure during the test.

2 & 3. These needle valves need to be opened at least a couple of turns, for the gauge to work.

 

HINT: clicking on the face of the gauge zooms in. When you are done checking the gauge, pressing the ESC button will zoom back out.

 

HINT: to open a needle valve, you have to position the mouse over the orange handle, and LEFT-CLICK.

The amount by which the valve opens is determined by your setting (see the top menu)

Well Test Simulator - Flowhead - Opening Master Valve

1. To open the master valve, or any other orange marked manual valves in the simulation, you need to position your mouse on it and LEFT-Click.

2. The number of turns you want to turn with each click is determined by your TURN SETTINGS in the menu on top.

The white arrows show the direction of the flow.

 

HINT: If there is a pressure difference between the two sides of a valve, you will hear a "hissss" as you open the valve.

The Surface Safety Valve is a hydraulic gate valve used as an extra layer of safety. It is held open by hydraulic pressure, and will shut the flow the hydraulic pressure drops below its "hold-open" pressure.

The SSV is fully capable of holding the full estimated well pressure, and is opened/closed from the ESD panel. Normally, the ESD is used to pump up the valve to its working pressure, and left open during the entire test. IF there is an emergency, and the well is shut down from the ESD or any of the hi/lo pilots (there are no pilots in the Simulator) or one of many Emergency Shut-Down Stations (there are a number of those placed on the rig floor, next to the choke manifold and next to the separator)

Well Test Simulator - Surface Safety Valve- Parts

1. The body of the valve. The white arrows show the direction of normal flow through the valve.

2. The Stem of the valve sticking out denotes that the valve is closed (shut). SSV's are always Normally Closed Valves (i.e. they are held closed by the pressure of a powerful spring if no hydraulic pressure is applied in the opposite direction) . If you want to open the SSV, you need to pump it up with the ESD panel.

3. Clicking on the Valve body (if you are within a few meters range) will open an Information Page, explaining some common features of SSVs.

 

Well Test Simulator - Surface Safety Valve- Opening with ESD

1. ESD Panel opening the SSV (and the flowhead hydraulic wing valve). You can see that the hydraulic pressure has been pumped up to the working (open) pressure of the hydraulic valves.

2. An open hydraulic valve that is designed to be normally-closed, will have it's stem sticking in (rather than out) when it is opened (flowing).

The Data Header (or Gauge Header) is a piece of pipe that provides multiple entry points for attaching different types of gauges. It is located upstream of the Choke, and can hold Pressure, Temperature, Sand, and Vibration or Acoustic Gauges  in addition to Hi/Lo Pilots for ESD Systems. Double Barrier Needle valves are mounted before mounting the gauges, to allow replacement of gauges during testing and provide maximum safety. The data header, and all attachments need to be rated to hold the full well pressure during the test.

Currently, only Temperature and Pressure sensors are mounted on the data header in the simulation. Additionally there is a sampling valve that will leak effluent (and release)  if opened under pressure. (note: this is not normal operating procedure - generally sampling points have special attachments to simplify loading sampling bottles and double barriers.)

Well Test Simulator - Data Header - Gauge Header- Parts

1 & 2. Pressure Gauges mounted on data header. If you have enough space, redundant pressure gauges might provide a good way to check if one goes out of calibration or does not operate correctly during a test

3 & 4. Redundant Temperature Gauges.

 

Note: You need to open both needle valves to each gauge, before they work. If needle valves stay closed (easy to overlook) you WILL NOT get proper data in your charts, or on the gauges.

 

5. In a real test, and for sand-producing wells, you may want to place a sand prove here. In our simulation this entry is plugged.

6. This is a (badly installed) sampling point to check if the user is aware of safety issues. If you leave this valve open or open it under pressure, effluent (and H2S) will leak.

The white arrows show the direction of normal flow in the Data Header.

 

Reminder: You open valves by LEFT-Clicking on them. The number of turns opened with each click depend on your settings (top menu).

You close valves by RIGHT-CLICKING in a similar fashion.

Holding ALT on your keyboard allows for a precise mouse positioning without moving the camera.

Placing your cursor on a valve makes it glow white. When you open the valve it glows green. when you close it, it glows red.

The Choke Manifold allows testers to maintain critical flow using a fixed or adjustable choke, and modify chokes to test well productivity using different drawdown rates. Most choke manifolds feature both an adjustable choke (that can be adjusted arbitrarily from 0 to 2 or 3 inches) and a fixed choke (that uses a choke bean, and can be swapped out).

1. The adjustable choke allows for step-less adjustments, but is not as precise as a fixed choke. Also, it gets worn down faster due to sand wear. To change the choke setting of the adjustable choke, you only need to place the mouse over the handle, and turn right or left for step-less adjustment. The current setting is shown with a vernier at the bottom of the screen.

Well Test Simulator - Choke Manifold - Adjustable Choke

2. The fixed choke beans don't allow for continuous adjustments, and require changing out every time, but they are more rugged, and precise. The simulator simplifies the setting of a fixed choke. Unlike in real life, you will only need to move your mouse cursor over the body of the fixed choke and set the choke size step wise using the left and right buttons. The current setting is shown with a vernier at the bottom of the screen.

Well Test Simulator - Choke Manifold - Fixed Choke

3.  The choke manifold also has four gate valves, each capable of holding the full pressure of the well. These valves allow the operator to redirect the flow from the adjustable choke to the fixed one or back. At any time, ideally, only one of those paths should be open, and in order to get good test data, during the switchover, which should be as fast as possible) the choke sizes on both chokes should be set to the equal value.

In the image below, yellow arrow show the path of the effluent through the fixed choke, and blue arrows show the path trough the adjustable choke. Gates 3 & 4 need to be fully opened for flow through the fixed choke, and gates 5 & 6 need to be fully open during flow through the adjustable choke.

Well Test Simulator - Choke Manifold - Flows

4. The choke manifold also provides a great opportunity to measure pressures/temperatures directly at the choke point, and normally measurements are taken at least for the temperature and pressure at those points. As usual, the needle valves need to be open in the simulation to get proper gauge readings, and data for the charts.

Well Test Simulator - Choke Manifold - Gauges

 

Coming Soon....

Coming Soon....

Coming Soon....

Coming Soon....

Coming Soon....

Please note that the simulator currently only runs on Microsoft Windows Systems. Max and Linux are not supported.

If you run the program, and it crashes, or the performance is lacking, please consider following steps to rectify the situation:

  1. Make sure you are running the software on a laptop or desktop computer with a dedicated graphics card from NVidia or ATI. We recommend an Intel i5 or i7 based system with 8 GB of RAM and an NVidia GeForce 560 TI or ATI Radeon HD 7970 or similar graphics card for optimal performance.
  2. Update your graphic card drivers. For NVidia cards go to:

http://www.nvidia.com/Download/index.aspx?lang=en-us

if you own an ATI card visit:

http://support.amd.com/us/gpudownload/Pages/index.aspx

  1. Make sure you have a later version of DirectX installed. If you are using windows 7 Service pack 1, or Windows 8 or higher, you don’t need to worry about this step. If you have not updated your Windows system in the past year, please visit:

http://www.microsoft.com/en-us/download/details.aspx?id=8109

and follow the download and installation guide for DirectX.

  1. The simulator will see an improvement is performance if you disable dual monitor support (if you are using a dual or triple monitor setup)
  2. We also recommend that you close all other non-essential software and disable real-time virus protection while running the program or enabling “Game Mode” in your anti-virus software for best performance.

 

If the setup program does not run, please consider running it "As Administrator". Some installations of Windows have heightened UAC security settings that may not allow installers to work properly. Don't forget that if you attempt to activate the simulator, you will need an internet connection, and you should not block the software contacting the license server with a firewall. Some anti-viruses have firewalls too, so you may consider allowing the software contact in the anti-virus firewall.


The Wireline Simulator will be released during 2016. Following features are currently planned. If you have any new ideas please visit the forums and share them.

   Prepare tools in the shop. Take various wireline tools apart and put them together correctly from parts

   Select the correct tools and string configuration for various jobs

   Drive your truck down the road to the location

   Setup the lubricator, and run the tools

   Get data back as you run the string - with full control and panel feedback while sitting in your truck

   Troubleshoot events (stuck string, etc.)


As with the Surface Testing Simulator, all user actions will be logged, and the environments will be realistically recreated in 3D.
This location will hold features and documentation for the Wireline Simulator as the project takes shape.

Screenshots of the 3D model for the wireline truck taking shape. Textures, materials and details have not been added yet.

 

Wireline Truck Model Back Reduced Render

Wireline Truck Model Detail1 Render Reduced

Wireline Truck Model Detail2 Render Reduced