SPS to trace collection

<< Click to Display Table of Contents >>

Navigation:  Geometry >

SPS to trace collection

 

Description

The SPS to trace collection module reads a standard SPS geometry dataset (S-file, R-file, and X-file) and builds a trace header collection that links each seismic trace to its corresponding source and receiver positions. This provides the spatial geometry required for subsequent processing steps such as binning, sorting, and migration.

Use this module when you have SPS format geometry files (commonly delivered by land acquisition crews) and need to assign source-receiver coordinates to your seismic data. The module parses all three SPS component files, validates them, then populates a trace collection with source positions, receiver positions, CMP bin locations, and derived header values. An optional input trace header collection can be provided to carry over record index information from a pre-existing dataset. After execution, the map display shows the source and receiver line positions for a quick geometry QC check.

Input data

Input trace headers — an optional existing trace header collection. When connected, the module transfers record index values from the existing collection to the newly built one, matching traces by FFID and channel number. This is useful when you need to update geometry while preserving file-position references established during a prior data import step. If no input collection is connected the module creates a fresh trace collection from the SPS files alone.

Parameters

Input S-file

Path to the SPS S-file (source point file). This file lists all shot-point positions including line number, point number, and surface coordinates. The file must use the standard SPS format and carry the .s extension. The module validates the file on execution and will report an error if the path is missing or the file cannot be parsed.

Input R-file

Path to the SPS R-file (receiver point file). This file lists all geophone or hydrophone station positions including line number, station number, and surface coordinates. The file must carry the .r extension. The module validates the file on execution and will report an error if the path is missing or the file cannot be parsed.

Input X-file

Path to the SPS X-file (relation file). This file defines which receivers recorded each shot, connecting the S-file and R-file entries through FFID and channel number ranges. It must carry the .x extension. The X-file is required; the module cannot build the trace collection without the source-receiver relation records it contains.

PointsMergingDistance

The spatial distance tolerance (in meters) used to merge source or receiver points that are nominally at the same location but have slightly different coordinates due to rounding or survey measurement noise. Two points whose horizontal separation is less than or equal to this value are treated as a single unique position. The default value is 0.1 m. Increase this value if your SPS files contain repeated point entries with small coordinate inconsistencies that cause duplicate locations in the output collection. Keep this value small (close to zero) for high-accuracy surveys where every distinct coordinate must be preserved.