# --------------------------------------------
# CITATION file created with {cffr} R package
# See also: https://docs.ropensci.org/cffr/
# --------------------------------------------
 
cff-version: 1.2.0
message: 'To cite package "soilKey" in publications use:'
type: software
license: MIT
title: 'soilKey: Automated Soil Profile Classification per WRB 2022, SiBCS 5 and USDA
  Soil Taxonomy 13'
version: 0.9.100
doi: 10.5281/zenodo.19930112
identifiers:
- type: doi
  value: 10.32614/CRAN.package.soilKey
abstract: Implements deterministic classification keys for the World Reference Base
  for Soil Resources 2022 (4th edition) and the Brazilian System of Soil Classification
  (SiBCS, 5th edition). Provides a unified profile representation with explicit per-attribute
  provenance, multimodal extraction from field reports and photos via vision-language
  models, spatial priors from SoilGrids and national soil maps, and gap-filling of
  soil attributes from Vis-NIR or MIR spectra via the Open Soil Spectral Library (OSSL).
  The taxonomic key itself is never delegated to a language model; LLMs are restricted
  to schema-validated extraction. Each classification result reports a key trace,
  a provenance-aware evidence grade, and ambiguities that further measurement would
  resolve.
authors:
- family-names: Rodrigues
  given-names: Hugo
  email: rodrigues.machado.hugo@gmail.com
  orcid: https://orcid.org/0000-0002-8070-8126
preferred-citation:
  type: manual
  title: 'soilKey: Automated soil profile classification per WRB 2022, SiBCS 5, and
    USDA Soil Taxonomy 13'
  authors:
  - family-names: Rodrigues
    given-names: Hugo
    email: rodrigues.machado.hugo@gmail.com
    orcid: https://orcid.org/0000-0002-8070-8126
  year: '2026'
  notes: R package version 0.9.100
  doi: 10.5281/zenodo.19930112
  url: https://github.com/HugoMachadoRodrigues/soilKey
repository: https://hugomachadorodrigues.r-universe.dev
repository-code: https://github.com/HugoMachadoRodrigues/soilKey
commit: ff19d46dc5e3910fb13750abc316eff177577509
url: https://hugomachadorodrigues.github.io/soilKey/
date-released: '2026-05-19'
contact:
- family-names: Rodrigues
  given-names: Hugo
  email: rodrigues.machado.hugo@gmail.com
  orcid: https://orcid.org/0000-0002-8070-8126
references:
- type: article
  title: 'SmartSolos Expert: an expert system for Brazilian soil classification'
  authors:
  - family-names: J. Vaz
    given-names: Glauber
  - family-names: Silva Neto
    given-names: L. de F. da
  - family-names: G. A. Barbedo
    given-names: Jayme
  journal: Smart Agricultural Technology
  year: '2025'
  volume: '10'
  doi: 10.1016/j.atech.2024.100735
  url: https://www.agroapi.cnptia.embrapa.br/store/apis/info?name=SmartSolosExpert&version=v1&provider=agroapi
  start: '100735'
- type: conference-paper
  title: Uma API para a classificacao de solos do Brasil
  authors:
  - family-names: J. Vaz
    given-names: Glauber
  - family-names: Silva Neto
    given-names: L. de F. da
  - family-names: Lima
    given-names: R. N.
  - family-names: Oliveira
    given-names: S. R. de M.
  collection-title: Anais do 12 Congresso Brasileiro de Agroinformatica (SBIAGRO 2019)
  collection-type: proceedings
  year: '2019'
  publisher:
    name: SBIAGRO
  start: '63'
  end: '72'
  conference:
    name: Anais do 12 Congresso Brasileiro de Agroinformatica (SBIAGRO 2019)
    address: Indaiatuba, SP, Brazil
- type: generic
  title: Brazilian soil data for taxonomic classification
  authors:
  - family-names: J. Vaz
    given-names: Glauber
  - family-names: Silva Jr
    given-names: A. F.
  - family-names: Silva Neto
    given-names: L. de F. da
  year: '2023'
  doi: 10.48432/PYKKA7
  notes: Redape (Embrapa Research Data Repository), V1
- type: report
  title: Africa Soil Profiles Database, Version 1.2
  authors:
  - family-names: Leenaars
    given-names: J. G. B.
  - family-names: Oostrum
    given-names: A. J. M.
    name-particle: van
  - family-names: Ruiperez Gonzalez
    given-names: M.
  institution:
    name: ISRIC -- World Soil Information
    address: Wageningen, NL
  issue: ISRIC Report 2014/01
  year: '2014'
  url: https://isric.org/projects/africa-soil-profiles-database-afsp
- type: report
  title: 'LUCAS 2018 SOIL Component: sampling intensity, harmonisation and procedures
    for the collection of soil samples'
  authors:
  - family-names: Fernandez-Ugalde
    given-names: O.
  - family-names: Scarpa
    given-names: S.
  - family-names: Orgiazzi
    given-names: A.
  - family-names: Panagos
    given-names: P.
  - family-names: Van Liedekerke
    given-names: M.
  - family-names: Marechal
    given-names: A.
  - family-names: Jones
    given-names: A.
  institution:
    name: European Commission, Joint Research Centre
    address: Ispra, IT
  issue: JRC Technical Report 130218
  year: '2022'
  doi: 10.2760/215013
- type: article
  title: 'LUCAS Soil, the largest expandable soil dataset for Europe: a review'
  authors:
  - family-names: Orgiazzi
    given-names: A.
  - family-names: Ballabio
    given-names: C.
  - family-names: Panagos
    given-names: P.
  - family-names: Jones
    given-names: A.
  - family-names: Fernandez-Ugalde
    given-names: O.
  journal: European Journal of Soil Science
  year: '2018'
  volume: '69'
  issue: '1'
  doi: 10.1111/ejss.12499
  start: '140'
  end: '153'