SoilHue User Guide

1  Introduction

SoilHue lets you capture, analyse and classify soil colours using the Munsell colour system—an international standard for describing colour. With the app you can:

  • Capture or import photos of soil samples
  • Calibrate the camera for accurate colour readings
  • Select specific areas of a sample for analysis
  • Obtain Munsell notation plus a plain‑language soil description
  • Save and export your results

2  Camera Calibration

2.1 How to Calibrate

  1. Tap Calibrate Camera on the home screen.
  2. Place the included basic calibration card or a professional ColorChecker in view.
  3. Align the card with the on‑screen guides.
  4. Hold the card parallel to the camera sensor.
  5. Ensure the sample is evenly lit—avoid harsh shadows.
  6. Tap the shutter button once the guides line up.

2.2 Basic vs Professional Calibration

Calibration card Accuracy Recommended for
Basic (included) Approximate Quick field checks
X‑Rite ColorChecker (or equivalent) Professional‑grade Research, lab work, publication

Tip: Re‑calibrate whenever lighting conditions change significantly.

3  Sample Analysis

3.1 Capturing a Sample

  1. Tap New Sample to take a photo, or choose Gallery to import one.
  2. Confirm the camera is calibrated.
  3. Capture the image or select the file.
  4. Define the analysis area:
    • Rectangle mode: drag to draw a box.
    • Polygon mode: tap to set each vertex.

3.2 Best Practices

  • Use diffuse natural light when possible.
  • Avoid direct glare and deep shadows.
  • Keep the soil surface clean, dry and level.
  • Calibrate under the same lighting you’ll use for analysis.

3.3 Reading the Results

Output Meaning
Munsell code Standard hue–value–chroma notation
Soil class Soil type identified by the app
Description Plain‑language summary of colour and texture

4  Data Management

4.1 Saving Analyses

  1. After analysis, tap Save Analysis.
  2. Add optional notes or tags.
  3. GPS location is stored automatically (toggle in settings).

4.2 Exporting Data

  1. Open Export from the main menu.
  2. Choose CSV or JSON.
  3. Share or store the file via the options shown (e‑mail, Files app, AirDrop, …).

5  Troubleshooting

Issue Solution
Calibration not detected Re‑calibrate under better lighting; ensure the card is flat and fully visible.
Inconsistent results Check lighting, clean the lens, recalibrate the camera.
Camera error Verify camera permissions in Settings → Privacy → Camera.

6  Support

© 2025 AJGB. All rights reserved.