Flood fill cube

<< Click to Display Table of Contents >>

Navigation:  Geometry >

Flood fill cube

 

Description

Flood fill cube creates a fully regular 3D seismic cube by filling empty bin positions within a defined inline/crossline grid. Each position in the output grid is examined using the fold map from the input bin grid: bins that already contain a trace have their data copied to the output, while empty bins are either filled by propagating amplitude values from neighboring populated bins (Variable mode) or replaced with a user-defined constant value (Constant value mode). The result is a gap-free cube suitable for post-stack interpretation, visualization, or further processing steps that require a regular trace layout.

The module supports three working modes. In By gather mode, the input data arrives as a pre-loaded in-memory gather — the fastest option for moderately sized datasets. In By trace vector mode, traces are read on demand from a SEG-Y file using a trace header index, and the completed cube is written directly to a .gsd output file — suitable for large surveys that do not fit in RAM. In Create trace vector only mode, the module builds a complete regular trace geometry (header positions for every inline/crossline position) without writing any amplitude data, which is useful for preparing geometry templates for other processing steps.

The inline and crossline range parameters are automatically populated when a bin grid is connected, so in most cases you only need to connect the required inputs, select the calculation mode and flood type, and run the module.

Input data

Bin grid (BinGrid_IN)

The 3D bin grid that defines the survey geometry, produced by the Binning 3D module. The module reads the fold map and topography map from this item to determine which bin positions already contain traces and to compute the XY coordinates and surface elevation for any synthetic placeholder traces that need to be inserted in empty bins. When this item is connected, the From inline, To inline, From crossline, and To crossline parameters are automatically filled with the grid extents.

Trace headers (GTraceVectorItem_IN)

The trace header index used to locate traces by their inline and crossline numbers. This input is required in both By trace vector and Create trace vector only modes. In By gather mode, the trace positions are taken directly from the connected gather.

SEG-Y data handle (GReadWriteSegyItem_IN)

The SEG-Y file handle providing access to the input amplitude data. This input is only active in By trace vector mode, where traces are read from disk on demand rather than being held in memory. Connect this to the output of a SEG-Y read node pointing to your post-stack input volume.

Input gather (GGatherItem_IN)

The in-memory gather containing all input traces. This input is only active in By gather mode. The gather is expected to hold the post-stack data sorted by inline and crossline number. Use this mode when the full volume fits comfortably in available system memory.

Output file name

The path and file name for the output .gsd file. This field is only active in By trace vector mode, where the completed cube is written to disk incrementally rather than being kept in memory. In By gather mode, the output is passed directly through the gather output connector without writing a file.

Parameters

Calculation mode

Selects how the module reads input data and delivers the output. Three options are available:

By gather — reads all traces from an in-memory gather and outputs the filled cube through the standard gather output connector. Choose this option for moderate-sized volumes that fit in RAM. This is the default mode.

By trace vector — reads traces from a SEG-Y file using a trace header index and writes the output cube directly to a .gsd file. Choose this option for large surveys that cannot fit in memory. The Output file name field becomes active in this mode.

Create trace vector only — builds a complete regular trace header geometry for every inline/crossline position in the defined grid, but does not read or write any amplitude data. Use this mode to generate a geometry template that can be passed to downstream modules without performing a full fill operation.

Flood type

Determines how empty bin positions are filled with amplitude values. Two options are available:

Variable (default) — empty bins are filled by propagating amplitude data from adjacent populated bins. The fill spreads outward iteratively from the edges of populated areas, with each new sample computed as the average of its filled neighbors. This produces a smooth and geologically plausible interpolation across gaps, which is the recommended choice for most post-stack fill operations.

Constant value — all empty bins are replaced with the fixed amplitude value defined in the Constant flood value parameter. Use this option when you want to mark gaps with a known sentinel value (for example, zero or a flag value) rather than blending them with neighboring data.

Constant flood value

The fixed amplitude value written to every empty bin when Flood type is set to Constant value. The default is 0. This parameter has no effect when Flood type is set to Variable.

From inline

The first inline number of the output grid. When a bin grid is connected, this value is automatically set to the first inline in the grid. You may reduce this value to start the output cube at an earlier inline, but the value must be positive (greater than 0) and must not exceed the To inline value.

To inline

The last inline number of the output grid. When a bin grid is connected, this value is automatically set to the last inline in the grid. Together with From inline, this defines the number of inline slices in the output cube. The value must be positive and greater than or equal to From inline.

From crossline

The first crossline number of the output grid. When a bin grid is connected, this value is automatically set to the first crossline in the grid. The value must be positive and must not exceed To crossline. Bins outside the fold map extents will be assigned empty placeholder traces.

To crossline

The last crossline number of the output grid. When a bin grid is connected, this value is automatically set to the last crossline in the grid. Together with From crossline, this defines the number of crossline positions in each inline slice of the output cube. The value must be positive and greater than or equal to From crossline.

Output data

Output gather (GGatherItem_OUT)

The filled regular 3D cube delivered as an in-memory gather. This connector is active in By gather mode. Every bin position in the defined inline/crossline range is represented by exactly one trace. Bins that existed in the input retain their original amplitude data; previously empty bins carry either interpolated (Variable) or constant amplitude values. Connect this output to downstream display or processing modules.

Output trace vector (GTraceVectorItem_OUT)

A complete regular trace header list covering every inline/crossline position in the defined grid. This connector is active in Create trace vector only mode. No amplitude data is written; only header geometry (XY coordinates, inline, crossline, surface elevation) is generated. Use this output as a geometry template for modules that need a pre-defined regular trace layout.