# Survey Tool BGS integration

### Description

Well Seeker Pro version 2.2.0.0 includes an integration with the British Geological Survey’s Global Geomagnetic Model (BGGM). This integration allows for real time updates to some of the values in the selected magnetic survey tools Instrument Performance Models (IPM’s). This in turn results in greater accuracy when calculating the ellipse of uncertainty for wellbores and plans. This technical note details how this integration works.

### Activation

To activate the BGGM integration, open the **Tools** menu and select **Survey Tool Editor.** Within the Survey Tool Editor window, toggle on the option **Use BGGM error estimates**.

**Note that the integration requires an internet connection to function.**

![](https://100379801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McEwHTOM_v4MexTVGSe%2Fuploads%2FNVibZnqrc6D4xyM5C1Ee%2F0.png?alt=media)

### Function

The BBGM integration affects the following magnetic error terms:

* **DECG:** MWD – Declination – Global (degrees)
* **DECR:** MWD – Declination - Random (degrees)
* **DBHG:** MWD – BH-Dependent Declination – Global
* **DBHR:** MWD – BH-Dependent Declination – Random
* **MDIG:** MWD – Magnetic Dip with Z-Axis Correction – Global (degrees)
* **MDIR:** MWD – Magnetic Dip with Z-Axis Correction – Random (degrees)
* **MFIG:** MWD – Total Magnetic Field with Z-Axis Correction – Global (nT)
* **MFIR:** MWD – Total Magnetic Field with Z-Axis Correction – Random (nT)

Note: If the selected IPM does not contain any of the above error terms, then this feature will not have any effect on the calculations.

When the BGGM integration is turned **OFF**, the values for these terms are fixed based on the selected survey tool:

![](https://100379801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-McEwHTOM_v4MexTVGSe%2Fuploads%2F3Z3H2owb1nQQ79jpwgoc%2F1.png?alt=media)

When the BGGM integration is turned **ON**, any time Well Seeker generates an error ellipse or performs an anti-collision scan, Well Seeker will retrieve the time and location specific values for these terms from the BGS [**BGGM High Definition (degree 1440) model with associated ISCWSA Rev 4 model-specific uncertainties**](https://geomag.bgs.ac.uk/data_service/directionaldrilling/bggm.html). These values are then used in place of the fixed values that are defined in the selected IPM.

Note that the values in the IPM will never physically be changed when this integration is switched on. The BGGM values are used behind the scenes and the user will not see these.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.innova-drilling.com/introduction/technical-notes/low-priority/survey-tool-bgs-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.