Methods in the open

Scientific honesty is part of the architecture.

How phone images, measured spectra and laboratory evidence connect without overstating what they prove.

Capture and release architecture

A fail-closed path from private capture to public context.

01

Capture PWA

Phone photos, optional card, context, private GPS

02

Private ingest

RLS, quarantine, immutable grant

03

Prior enrichment

SoilGrids, SSURGO, Open-Meteo

04

Deterministic QA

Sanitize, sharpness, optional card, GPS, duplicate

05

Gated public release

Eligible structured data; photos held pending screening

Different evidence, connected by one sample

A photograph is an observation. A spectrum is a measurement.

Phone images

Ordinary phones record RGB images, not wavelength-resolved spectra. Extracted soil RGB is uncalibrated, even with the reference card. No printed card is needed. A photograph does not automatically create an extracted optical record or register a library sample. Sample registration is optional and needs your real declared depth.

Measured spectra

A separate instrument records reflectance by wavelength. Pairing it with the same physical sample requires verified identity, method, calibration and uncertainty.

Laboratory evidence

Verified assays provide separate reference labels. Biological relationships require actual assays and expert-reviewed terms; images or spectra alone do not establish soil microbial composition.

The local RGB-to-reflectance demo uses invented samples and spectra. It demonstrates the software, not field accuracy. No independently validated soil reconstruction model is provided; real models need verified field pairs and independent spatial and device evaluation.

Existing maps are priors

Context helps. It does not get the final word.

SoilGrids provides global soil context. SSURGO adds higher-resolution United States context. Open-Meteo contributes elevation and recent precipitation. These sources are stored as weak labels with uncertainty rather than treated as measured truth.

Confirmed laboratory measurements are modeled separately as gold labels. Future estimators must report a basis and confidence interval for every output.

Deterministic photo QA

Quality checks are built; photo publication stays gated.

Metadata strip

Orientation and colour profiles are applied to the pixels, then EXIF, GPS, XMP, ICC, comments, and residual segments are removed.

Image quality

Sharpness and exposure are checked on the candidate soil region. A detected physical card is masked out; without one, the candidate region is the whole frame.

Optional reference card

Missing a card alone never fails QA. Marker and patch extraction support geometry and image checks, not calibrated reflectance.

GPS plausibility

Accuracy and gross prior mismatches can trigger review.

Duplicate defense

Perceptual hashes flag repeated or near-repeated images.

Terminal outcome

Each submission settles to pass, fail, or flagged review from its two required photos.

Public by design, private by default

Every public cell holds at least three contributors.

Exact geometry remains protected operational data. Public map and dataset records carry only H3 cells: resolution 8 (about 0.74 km²) where at least three people have contributed, otherwise the coarser resolution 6 or 4 cell. Anonymous public reads are limited to aggregate cells—not per-submission coordinates.

Read the governing specification ↗
Review the acceptance plan ↗