New desktop tool

Ology Model Trainer.

Train archaeological site-sensitivity models from approved records and a LiDAR DEM on your desktop, then use the model offline in the Ology field app. Spatial validation and professional review help determine where the model is useful.

  • Your LiDAR, your sites
  • Frequency Ratio + GBT
  • Spatial held-out validation
  • Offline .json model export
  • macOS + Windows

How the model works

From terrain factors to a survey-priority surface.

The trainer compares known-site landscape settings with the wider terrain, tests the model on held-out data, and exports a model for offline use in the app. The diagram is illustrative and contains no project data.

Illustrative diagram of terrain factors entering a model and producing a survey-priority surface; dots are schematic and do not represent real sites
Conceptual workflow only. The illustration contains no project data or site locations.

What it does

Landscape position, not object detection.

The trainer builds a predictive site-sensitivity model. It learns, from the places where sites are already known, what the terrain tends to look like where people lived — then it scores every patch of a new area for how much that ground resembles known-site terrain. The output is a heat surface: brighter means more likely to reward survey.

The model never tries to “see” a house pit or a scatter in the imagery. It asks: is this spot the kind of place — near reachable water, on a flood-safe bench, gently sloped, sheltered — that people historically chose? That is a question terrain can answer, which is why it works even for sites that leave no visible trace on the surface.

A prioritisation aid, not a site locator: a high score means “worth looking here first,” not “a site is here.” Ground-truth everything.

Terrain predictors it learns from

  • Slope steepness and human-scale flatness
  • Distance, cost-distance, and height above water
  • Distance to stream confluences
  • Landform position (MSTP) and local prominence
  • Terrain ruggedness and shelteredness
  • Solar aspect (south-facing winter sun)
  • Optional: CALVEG vegetation and SSURGO soils

Every terrain predictor comes straight from your DEM — nothing to download.

Two model types

Compare an explainable baseline with a flexible model.

FR

Frequency Ratio — the explainable baseline

Transparent arithmetic. Every number is auditable — you can say exactly why a spot scored high, like “sites are 3.4× more likely on flood-safe terraces.” Fast, and the right first model.

GBT

Gradient-Boosted Trees — the default

Learns interactions FR cannot: “south-facing matters, but only on gentle slopes near water.” On tabular terrain data, gradient boosting is the current state of the art — it consistently matches or beats neural networks in independent benchmarks — and the trainer still reports each factor’s importance.

Auto-tune

Searches model configurations and keeps the one that best predicts ground the model didn’t train on — not the one that best memorises.

Ensemble

Trains several models and averages them for a steadier surface. Exports to the same file format, so the app runs it with no changes.

Uncertainty

Ensemble disagreement becomes a genuine confidence measure: “high sensitivity and the models agree” is a stronger survey target.

Spatial validation

The held-out validation map.

Tick “Held-out validation map” and the trainer runs an honest experiment: it splits your area into a training region and a spatially separate held-out region, trains only on the training region, then checks whether the real sites in the unseen region land in the model’s high-scoring zones.

The held-out map and capture rate show how the model performed on a separate part of the training landscape. Compare that result with a chance baseline, examine where the model misses, and test transfer to new terrain before relying on it for survey planning.

How to use it

Four cards, one button.

1
Site dataChoose the layer with your known sites — CSV, KML, KMZ, SHP, GPKG, or GeoJSON.
2
LiDAR DEMPoint at your elevation data: a folder of GeoTIFF tiles, one GeoTIFF, or a VRT. Tiles straight from USGS are fine.
3
Training dataNHD water is always on. Optionally add CALVEG vegetation, SSURGO soils, and the held-out validation map.
4
ModelName it, pick FR or GBT, choose spatial validation (the honest test), and start at 3 m before the full 1 m run.

Then press Run Training. AirDrop the finished .json to your iPhone → Ology → Terrain → Archaeological Site Sensitivity → Use model → import.

Documentation

The full user guide, written for archaeologists.

The guide assumes no machine-learning background. It explains in plain language what the trainer is doing under the hood, why the method is sound, how to run it, and how to read the results — including the held-out validation map, the ethics and honest caveats, and troubleshooting for macOS and Windows.

What the outputs include

  • <name>.json — the model. Import into Ology for offline predictions in an appropriate landscape.
  • <name>_training_report.txt — the receipt: inputs, settings, timings, predictors, top findings in plain English, and the accuracy read-out.
  • <name>_validation.html / _validation_map.png — the held-out validation report and map, self-contained for any browser.

Get the trainer

Request early access to the desktop trainer.

The Ology Model Trainer runs on macOS and Windows (Python 3.12/3.13). It is currently distributed directly to interested archaeologists and cultural-resource professionals while it is refined. Request access with your contact details and general area of interest.

Site locations are protected under NHPA/ARPA and state law. Your training data never leaves your machine — the trainer runs entirely locally, and models derived from confidential sites should be handled with the same care.

Request the training kit

Please do not send project names, site records, locations, or confidential data through this website. Requests go to Ology Mapping.

Downloads

Trainer kit and trained models.

Public downloads will appear here as they are released. For now, the user guide is available to everyone and the trainer kit is available by request above.

Ology Model Trainer — User Guide PDF · how the model works, how to run the trainer, and how to read the results
Download PDF
Ology Model Trainer — desktop app (macOS + Windows) Available by request during early access — use the form above
By request
Trained sensitivity models Portable .json models for the Ology app — released here when ready
Coming soon

No trained model is included on this website. Any future public model needs a confidentiality and disclosure review before release.

Desktop to field

Train on the desktop. Predict in your pocket.

The trainer and the app are two halves of one workflow: heavy LiDAR processing and honest validation on your computer, then a single portable model file that predicts offline anywhere the app can open a map. Both are aids to professional judgement, not replacements for it.