Peatland LLM Explainability Materials

Repository accompanying the paper:

Making Environmental Models Understandable for Non-Experts: LLM-Based Explanations with a Peatland Case Study

This repository contains supplementary materials supporting the paper and is intended to improve transparency and reproducibility.

Repository Structure

.
├── prompts/
│   └── raw_prompt_template.md
├── personas/
│   └── persona_evaluation_readme.md
├── expert_evaluation/
│   └── Peatland_Expert_Evaluation_Example.pdf
├── rag/
│   └── (grounding documents)
├── figures/
└── README.md

Contents

• Raw explanation-generation prompt template
• Persona-based evaluation framework
• Expert evaluation form and example
• Documentation describing the evaluation workflow

Overview

The proposed framework combines:

1. Machine-learning prediction
2. Retrieval-Augmented Generation (RAG)
3. LLM-based explanation generation
4. Multi-persona evaluation
5. Iterative refinement
6. Optional human expert feedback

The objective is to generate scientifically grounded, understandable explanations of peatland water-table predictions for non-expert stakeholders.

Included Materials

Raw Prompt

The raw prompt template used for explanation generation.

Persona Evaluation

The complete persona-based evaluation procedure together with scoring criteria and example feedback.

Expert Evaluation

An example evaluation document used by peatland experts.

Reproducibility

The repository is provided to facilitate peer review and reproducibility.

To protect project assets, the following are not included:

• proprietary datasets
• trained ML models
• confidential project material

Citation

If you use these materials, please cite:

@misc{davoodi2026peatland,
  title={Making Environmental Models Understandable for Non-Experts: LLM-Based Explanations with a Peatland Case Study},
  author={Laleh Davoodi},
  year={2026},
  note={Supplementary materials repository}
}

Contact

Laleh Davoodi

University of Turku

Email: ladavo@utu.fi

---

© 2026 Laleh Davoodi, University of Turku.