Baselode

Appearance

BaselodeOpen-source mining and exploration toolkit

Free, multi-language tooling for the mineral exploration and mining industries — built for developers and data scientists, geologists and mining engineers, and anyone else looking for reusable domain-specific tooling.

Get Started
View on GitHub
Baselode logo
📥

Data Loading

Import and normalise drillhole collars, surveys, assays, structural measurements, and geotechnical intervals from CSV, Parquet, or SQL sources. A smart column-mapping layer handles common naming variations automatically.

🧮

Desurveying

Convert depth-based survey tables into 3D space. Supports industry-standard Minimum Curvature, as well as Tangential, Balanced Tangential, and Vulcan-style Midpoint Tangential methods.

🗺️

Map Visualisation

Plot collar locations on an interactive map. The Python library uses Folium/Plotly; the JavaScript library uses MapLibre GL JS.

📊

2D Strip Logs

Multi-track Plotly strip logs for numeric, categorical, structural (tadpole), and free-text comment columns. Depth increases downward, matching industry convention.

🧊

3D Scene

Three.js-powered 3D viewer for desurveyed hole traces, structural discs, block models, IDW grade volumes, terrain surfaces and raster overlays, with section and slab clipping. Embed it as a React component or a standalone HTML page.

🧱

Block Models & Compositing

Validate, slice and report block models, including sub-blocks and grade-tonnage curves. Composite assay intervals by length, domain boundary or true thickness, and QC the source tables first.

🧲

Geophysics Grids

Load ER Mapper and GeoTIFF grids. Apply low-, high- and band-pass filters, derivatives, tilt, analytic signal, upward continuation and reduction to the pole, then render with perceptual colour scales and hillshade. Results match between Python and JavaScript.

🐍🟨

Python & JavaScript

Feature-parity across both languages. Use Python in Jupyter notebooks, Dash apps, or analytics pipelines. Use JavaScript/React in web dashboards or Node.js workflows.

Why Baselode? ​

The exploration and mining industry relies on a small set of core data structures — drillhole collars, surveys, and assays — yet each project reinvents the wheel for loading, cleaning, and visualising them.

Baselode provides a consistent, open data model and a growing library of algorithms and visualisations so you can focus on geology and analysis, not data plumbing.

python
import baselode.drill.data as drill

collars  = drill.load_collars("collars.csv")
surveys  = drill.load_surveys("surveys.csv")
assays   = drill.load_assays("assays.csv")
dataset  = drill.assemble_dataset(collars=collars, surveys=surveys, assays=assays)

Quick install

bash
pip install baselode      # Python
npm install baselode      # JavaScript

Screenshots ​

Screenshots from demo-viewer-react v0.1.68. Gravity grid: Peak Hill–Collier Bouguer anomaly, Geological Survey of Western Australia (CC BY 4.0).

Collar map with nickel strip-log popup2D multi-track strip logs3D drillhole viewer with assay colouring3D block model viewerGeophysics grid viewer with hillshade (GSWA Peak Hill–Collier Bouguer gravity)3D IDW interpolation volume

These docs are primarily written with AI. Please notify the maintainer if inaccuracies exist.