Description

Matrix editor is an interactive tool for viewing and hand-editing a 2D grid (map) of values, such as a velocity map, a static correction grid, or any other attribute defined on a regular X/Y map grid. The matrix is displayed in an interactive map view where you can draw one or more polygons to outline problem areas, then apply editing operations - setting a constant value, clipping outliers, smoothing, or median filtering - either inside/outside a selected polygon or across the entire map.

Use this module whenever an automatically computed or interpolated map contains bad values, holes, spikes, or noisy patches that need manual correction before the grid is used further downstream - for example cleaning a velocity model, repairing a statics surface, or smoothing a coverage/attribute map. All edits are non-destructive to the original: the module works on a copy of the input matrix and keeps an undo history (Ctrl+Z) so mistakes can be reversed.

Input data

Input matrix

The 2D grid of values to load into the editor. This can be any matrix-type map produced elsewhere in the flow, such as a velocity map, a static corrections grid, or another spatially-gridded attribute defined on a regular X/Y grid. The module loads this matrix and displays it in the interactive map view for editing; the original input matrix itself is never modified.

Input polygons

A set of one or more 2D polygons, given in the same map coordinates as the matrix, that outline regions of interest on the map. Polygons are typically drawn interactively in the map view. Once a polygon exists, the editing actions (Set values, Crop values, Smooth) can be restricted to run only inside or only outside that polygon instead of affecting the whole map.

Parameters

Current polygon

Selects which polygon from the Input polygons set is currently active for editing. The list is populated automatically from the names of the polygons available on the map; picking a polygon here (or clicking it in the map view) is what makes the "Inside polygon" / "Outside polygon" editing options available in the right-click menu. If no polygons have been drawn yet, the list is empty and editing operations apply to the full map only.

Taper width

Width of the blend zone around a polygon boundary. Within this distance from the boundary, edited values are smoothly blended (weighted average) with the original values instead of being cut off abruptly, so the edited region merges gradually into the rest of the map. This applies to the Set values, Crop values, and Smooth actions whenever they are run with a selected polygon.

Default: 100.0 m (minimum 0.0). Set it to 0 for a hard, unblended edge exactly at the polygon boundary. Increase it when you want a gradual, seamless transition between the edited area and the surrounding map, for example to avoid a visible seam in a velocity or statics grid; decrease it when the polygon tightly bounds a genuine bad-value zone that should be replaced cleanly.

"Set values" parameters

Value

The constant value that is written into the matrix when the "Set values" editing action is used. It replaces every cell inside (or outside) the selected polygon with this number, blended near the polygon boundary according to Taper width; if no polygon is selected, the whole map is overwritten with this value. The units match whatever quantity the matrix represents (for example m/s for a velocity map, or ms for a statics/time map).

Default: 0.0. Use this to blank out a bad region or overwrite it with a known, geologically or physically reasonable value before running the Set values action from the map's right-click menu.

"Crop values" parameters

Min value

Lower clip bound used by the "Crop values" editing action. Any cell value below this threshold is raised to this level, in the affected area (full map, or inside/outside the selected polygon). Use it together with Max value to remove unrealistically low outliers from the map, in the same units as the matrix quantity.

Default: -1.0. Set this to a realistic lower bound for the mapped attribute, for example a minimum acceptable velocity, before running Crop values to suppress spurious low spikes.

Max value

Upper clip bound used by the "Crop values" editing action. Any cell value above this threshold is lowered to this level, in the affected area (full map, or inside/outside the selected polygon). Use it together with Min value to remove unrealistically high outliers from the map, in the same units as the matrix quantity.

Default: 1.0. Set this to a realistic upper bound for the mapped attribute before running Crop values to suppress spurious high spikes.

"Smooth" parameters

Window X

Size of the smoothing window along the map's X axis, used by the "Smooth" editing action to spatially average out short-wavelength noise. Larger values average over a wider area, producing a smoother but less detailed map; smaller values preserve more local detail but remove less noise.

Default: 100.0 m (minimum 0.0). Increase this if the map still looks noisy after smoothing along X; decrease it if genuine structural trends along X are being smeared out.

Window Y

Size of the smoothing window along the map's Y axis, used by the "Smooth" editing action. Works the same way as Window X but controls the averaging distance in the perpendicular map direction; the two can be set independently to smooth more aggressively along one axis than the other.

Default: 100.0 m (minimum 0.0). Adjust independently from Window X if the map has different noise characteristics or line/trace spacing along the two axes.

"Median filtering" parameters

Window X

Half-width, along the map's X axis, of the window used by the "Median filtering" editing action. Each cell is replaced by the median value of all cells within this window, which removes isolated spikes and outliers while preserving sharp edges and trends better than the Smooth action. Median filtering always runs on the entire map, regardless of any selected polygon.

Default: 100.0 m (minimum 0.0). Increase this to remove larger clusters of spurious values; keep it small if you only need to remove single-cell spikes without disturbing the surrounding trend.

Window Y

Half-width, along the map's Y axis, of the window used by the "Median filtering" editing action. Works the same way as Window X but controls the median window size in the perpendicular map direction.

Default: 100.0 m (minimum 0.0). Adjust independently from Window X if spikes in the map are elongated or the map's spatial sampling differs between the two axes.

Editing tools

These operations are triggered from the right-click menu in the interactive map view, not from the parameter panel. When a polygon is selected, each action (except Median filtering) offers a submenu to run it on the "Full map", only "Inside polygon", or only "Outside polygon"; without a selected polygon the action runs on the whole map directly.

Set values

Overwrites the selected area of the map with the constant Value from the "Set values" parameters. Only available as a polygon-restricted action ("Inside polygon" / "Outside polygon"); select a polygon first to use it.

Crop values

Clips the values in the selected area to the [Min value, Max value] range from the "Crop values" parameters, removing outliers while leaving values already inside the range untouched. Available both as "Crop values in map" (no polygon needed) and, when a polygon is selected, restricted to "Full map", "Inside polygon" or "Outside polygon".

Smooth

Applies spatial smoothing over the window defined by the "Smooth" parameters (Window X, Window Y) to the selected area, reducing short-wavelength noise. Available directly on the whole map, or restricted to "Full map", "Inside polygon" or "Outside polygon" when a polygon is selected.

Median filtering

Applies a median filter over the window defined by the "Median filtering" parameters (Window X, Window Y) to remove isolated spikes while preserving sharper trends than smoothing. This action always processes the entire map; it does not offer inside/outside polygon options.

Undo (Ctrl+Z)

Reverts the last editing action (Set values, Crop values, Smooth, or Median filtering) in the map view. The module keeps a history of up to 5 previous states, so pressing Ctrl+Z repeatedly steps back through the last few edits.

Output data

Output matrix

The edited copy of the input matrix, reflecting all Set values, Crop values, Smooth, and Median filtering actions applied in the map view. This is the map that downstream modules in the processing flow should use; the original Input matrix is left unchanged.