CommoVision

See the future in real time

← All tables

gold_well_formation_surfaces

Gridded formation-top surfaces: one row per (basin, formation, grid point) with the interpolated subsea top depth, its uncertainty, and formation thickness (isopach). Built from our formation-top picks; combine with directional surveys to determine where a wellbore landed.

Access tier: portal Portal. These rows are well-level or producing-unit-level data, or our modelled output at cohort or grid grain. They open with a Portal, Pro or Enterprise plan. The website shows aggregates built from them, never the rows.
Primary key: basin, formation, grid_lat, grid_lon
Region codes: ab, mt, nd, oh, tx, ut, wv, wy

Columns

ColumnTypeNullableDescription
basin string no Basin the grid is built for: the same basin vocabulary as the well register's basin column.
formation string no Formation name for this surface, as the region's builder normalizes it (case conventions differ by region today). Name variants that resolve to one registry unit are pooled into a single surface under the most common name.
formation_id string yes Canonical stratigraphic-unit identifier: the join key to the formations register. NULL for surfaces built from names not in the registry (age-level names like "Mississippian", local names not yet curated).
grid_lat float64 no Grid point latitude (WGS84). Regular spacing per basin (0.01 degrees, about 1.1 km).
grid_lon float64 no Grid point longitude (WGS84). Regular spacing per basin.
predicted_tvdss int32 no Formation-top depth at this grid point, subsea, in feet. Negative = below sea level. Interpolated from our formation-top picks (the formation-tops register); no grid point is extrapolated beyond the data's extent.
predicted_tvdss_stddev int32 no Uncertainty of predicted_tvdss, in feet (one standard error), calibrated on held-out wells so that plus or minus 2 standard errors has honest coverage. Use it to mask or down-weight low-confidence areas.
isopach_ft int32 yes Formation thickness at this grid point, in feet: the distance down to the next formation surface below. NULL for the deepest surface at the point. Computed by actual local depth ordering, so values are never negative.
n_nearby int16 yes Number of formation-top observations within 5 miles of this grid point: a data-density indicator, complementary to predicted_tvdss_stddev (how close the control points are vs how confident the model is). Capped at 10,000.

How these numbers are built is on methodology; the machine twin of this page is data-dictionary.json.