Skip to content

Commit 815ab6d

Browse files
spec: add column-stratigraphic specification (#4600)
## New Specification: `column-stratigraphic` Related to #4573 --- ### specification.md # column-stratigraphic: Stratigraphic Column with Lithology Patterns ## Description A vertical column visualization showing geological rock layers with standardized lithology patterns, formation names, ages, and thickness scales. Each layer is represented as a stacked rectangular block filled with a distinctive pattern (e.g., brick pattern for limestone, dots for sandstone, dashes for shale) following FGDC/USGS conventions. This plot is essential for communicating subsurface geology and sedimentary sequences in a compact, standardized format. ## Applications - Stratigraphy: describing borehole or outcrop sections with standardized lithology symbols for geological reports - Petroleum geology: visualizing well log lithological intervals alongside wireline log data - Environmental geology: site characterization showing subsurface material types and aquifer geometry - Geological education: teaching sedimentary sequences, unconformities, and stratigraphic principles ## Data - `top` (numeric) - depth or elevation of the top of each layer in meters - `bottom` (numeric) - depth or elevation of the bottom of each layer in meters - `lithology` (categorical) - rock type for each layer (e.g., sandstone, limestone, shale, siltstone, conglomerate) - `formation` (string) - formation or member name for each layer - `age` (string) - geological age label (e.g., "Cretaceous", "65 Ma") - Size: 5-20 layers - Example: a synthetic sedimentary section with 8-10 layers of varying thickness and lithology, spanning multiple geological periods ## Notes - Each lithology type should use a distinct fill pattern (hatching or texture) that approximates standard geological map symbols (e.g., brick pattern for limestone, stipple dots for sandstone, horizontal dashes for shale, random dashes for siltstone) - The vertical axis represents depth or thickness (increasing downward by convention in borehole logs, or upward for outcrop sections); use increasing downward for this spec - Formation names should be labeled to the right of or within each layer - Age labels or geological period names should appear on the left side or as annotations - A thickness/depth scale bar should be shown on the left axis with appropriate units (meters) - Layer boundaries should be drawn as solid horizontal lines; unconformities may use wavy lines - Use a minimum of 5 distinct lithology patterns to demonstrate variety --- **Next:** Add `approved` label to the issue to merge this PR. --- :robot: *[spec-create workflow](https://github.com/MarkusNeusinger/pyplots/actions/runs/22779522527)* Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent a2f7a41 commit 815ab6d

2 files changed

Lines changed: 61 additions & 0 deletions

File tree

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# column-stratigraphic: Stratigraphic Column with Lithology Patterns
2+
3+
## Description
4+
5+
A vertical column visualization showing geological rock layers with standardized lithology patterns, formation names, ages, and thickness scales. Each layer is represented as a stacked rectangular block filled with a distinctive pattern (e.g., brick pattern for limestone, dots for sandstone, dashes for shale) following FGDC/USGS conventions. This plot is essential for communicating subsurface geology and sedimentary sequences in a compact, standardized format.
6+
7+
## Applications
8+
9+
- Stratigraphy: describing borehole or outcrop sections with standardized lithology symbols for geological reports
10+
- Petroleum geology: visualizing well log lithological intervals alongside wireline log data
11+
- Environmental geology: site characterization showing subsurface material types and aquifer geometry
12+
- Geological education: teaching sedimentary sequences, unconformities, and stratigraphic principles
13+
14+
## Data
15+
16+
- `top` (numeric) - depth or elevation of the top of each layer in meters
17+
- `bottom` (numeric) - depth or elevation of the bottom of each layer in meters
18+
- `lithology` (categorical) - rock type for each layer (e.g., sandstone, limestone, shale, siltstone, conglomerate)
19+
- `formation` (string) - formation or member name for each layer
20+
- `age` (string) - geological age label (e.g., "Cretaceous", "65 Ma")
21+
- Size: 5-20 layers
22+
- Example: a synthetic sedimentary section with 8-10 layers of varying thickness and lithology, spanning multiple geological periods
23+
24+
## Notes
25+
26+
- Each lithology type should use a distinct fill pattern (hatching or texture) that approximates standard geological map symbols (e.g., brick pattern for limestone, stipple dots for sandstone, horizontal dashes for shale, random dashes for siltstone)
27+
- The vertical axis represents depth or thickness (increasing downward by convention in borehole logs, or upward for outcrop sections); use increasing downward for this spec
28+
- Formation names should be labeled to the right of or within each layer
29+
- Age labels or geological period names should appear on the left side or as annotations
30+
- A thickness/depth scale bar should be shown on the left axis with appropriate units (meters)
31+
- Layer boundaries should be drawn as solid horizontal lines; unconformities may use wavy lines
32+
- Use a minimum of 5 distinct lithology patterns to demonstrate variety
Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# Specification-level metadata for column-stratigraphic
2+
# Auto-synced to PostgreSQL on push to main
3+
4+
spec_id: column-stratigraphic
5+
title: Stratigraphic Column with Lithology Patterns
6+
7+
# Specification tracking
8+
created: "2026-03-06T19:53:29Z"
9+
updated: null
10+
issue: 4573
11+
suggested: MarkusNeusinger
12+
13+
# Classification tags (applies to all library implementations)
14+
# See docs/reference/tagging-system.md for detailed guidelines
15+
tags:
16+
plot_type:
17+
- bar
18+
- column
19+
data_type:
20+
- categorical
21+
- numeric
22+
- ordinal
23+
domain:
24+
- science
25+
- geology
26+
features:
27+
- stacked
28+
- annotated
29+
- patterned

0 commit comments

Comments
 (0)