Description

This module reads one or more marine or land navigation files in the OGP/IOGP P1/11 exchange format and loads the source and receiver positions they contain into the project's geometry database. It parses the file's header records and its per-shot source, receiver and position records, as well as bin and CMP grid-point records, and reconstructs a spread table showing which receiver channels were live for each shot. Use this module at the start of a geometry-loading workflow to bring contractor-supplied survey positioning, elevations and water depths into the project so they can later be merged with trace headers.

Input data

Input navigation file

A single P1/11 navigation file to load, used when Input type is set to 'Single file'.

Input files

A list of P1/11 navigation files to load and merge in a single run, used when Input type is set to 'File list'.

Parameters

Input type

Chooses whether the module loads a single navigation file or a list of files that are merged together. Use 'File list' when the survey's navigation is delivered as several P1/11 files (for example, one per sail line) that should be combined into one geometry load.

Default: Single file.

DataType

Determines how the vertical (Z) value of each source/receiver/position record is interpreted. In 'Land' mode it is treated as ground elevation; in 'Marine' mode it is treated as hole or streamer depth, with a separate water-depth field also read. Set this to match the actual survey type of the file being loaded, since choosing the wrong option misinterprets depth-below-datum values as elevation-above-datum or vice versa.

Default: Land.

LineName

A survey line name, automatically populated from the line-name field found in the loaded file(s), used to browse and preview that line's raw records in the manual table view. Selecting a line here filters what is shown for QC purposes rather than what is actually loaded into the output geometry.

Default: [None] (populated after a file is loaded).

Coordinate scalar

A multiplier applied to every parsed Easting (X) and Northing (Y) coordinate for sources, receivers, bins and CMPs. Use it to correct a unit or scale mismatch between the P1/11 file's coordinates and the project's working units. Leave at 1.0 for files that are already in the correct units.

Default: 1.0.

Depth scalar

A multiplier applied to the vertical values: elevation or hole depth (depending on DataType) plus water depth for both sources and receivers. Use it the same way as Coordinate scalar but for vertical values, for example to convert feet to meters or to flip a sign convention that does not match the project. Leave at 1.0 for files already in the correct units and sign convention.

Default: 1.0.

Use EPSG coordinate transformation

Intended to reproject coordinates using the coordinate-reference-system information found in the file's header records. This option is reserved for a future release and does not currently change the loaded coordinates; do not rely on it to reproject survey positions.

Default: disabled (off).

Performance

These settings control only which on-screen preview tables and maps are rebuilt after loading; they do not change what is written to the output geometry.

Update GUI table S

Rebuilds the 'Sources geometry file table' preview after the file is loaded. Leave off for large files to speed up the run; turn on when you want to visually inspect the parsed source list.

Default: disabled (off).

Update GUI table R

Rebuilds the 'Receivers geometry file table' preview after the file is loaded. Kept off by default because receiver counts (often thousands of channels) make table population noticeably slower; turn on to inspect the parsed receiver list.

Default: disabled (off).

Update GUI table X

Rebuilds the 'Spread table' showing which receiver channels were live for each shot. Turn on when you specifically need to visually QC the shot-to-channel relationships; leave off to speed up loading of large files.

Default: disabled (off).

Update GUI location map S

Refreshes the source position, elevation and water-depth map and line plots. On by default since source counts are usually small; disable only if refreshing the source map is noticeably slow for a very large survey.

Default: enabled.

Update GUI location map R

Refreshes the receiver position, elevation and water-depth map and line plots. On by default; consider turning it off for very large receiver spreads, since receiver maps are typically the most expensive of the preview views to redraw.

Default: enabled.

Output data

Sources and receivers collection

The core geometry output: source and receiver positions with coordinates, elevation or hole depth, water depth, line name and source/receiver ID, ready to be merged with trace headers or used by downstream geometry-QC modules.

Spread

A per-shot relational table listing the receiver range and channel numbers associated with each shot, reconstructed from the order of source and receiver records in the file.

Bins collection "Q" header

Processing-bin grid positions parsed from the file's bin (Q1) records.

CMPs collection "C" header

CMP/midpoint grid positions parsed from the file's CMP (C1) records.

Sources geometry file table

An on-screen spreadsheet view of the parsed source records (shot number, coordinates, elevation/depth, water depth, source ID), populated only when Update GUI table S is enabled.

Receivers geometry file table

An on-screen spreadsheet view of the parsed receiver records, with the same columns as the sources table, populated only when Update GUI table R is enabled.

Spread table

An on-screen spreadsheet view of the reconstructed spread relationships (shot number, receiver range, first/last channel), populated only when Update GUI table X is enabled; rows can be clicked to inspect a specific shot.

References

OGP, 2012, P1/11 - Geophysical position data exchange format: International Association of Oil & Gas Producers.