# --------------------------------------------
# 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.97
doi: 10.5281/zenodo.19930112
abstract: Implements deterministic classification keys for the World Reference Base
  for Soil Resources ('WRB') 2022, 4th edition (IUSS Working Group WRB, 2022, ISBN:979-8-9862451-1-9),
  the Brazilian System of Soil Classification ('SiBCS') 5th edition (Santos et al.,
  2018, ISBN:978-85-7035-800-4) and the United States Department of Agriculture ('USDA')
  Soil Taxonomy 13th edition (Soil Survey Staff, 2022, <https://www.nrcs.usda.gov/resources/guides-and-instructions/keys-to-soil-taxonomy>).
  Provides a unified profile representation with explicit per-attribute provenance,
  multimodal extraction from field reports and photos via vision-language models (VLM),
  spatial priors from 'SoilGrids' (Poggio et al., 2021, <https://doi.org/10.5194/soil-7-217-2021>)
  and national soil maps, and gap-filling of soil attributes from visible-near-infrared
  (Vis-NIR) or mid-infrared (MIR) spectra via the Open Soil Spectral Library ('OSSL';
  Safanelli et al., 2025, <https://doi.org/10.7717/peerj.18908>). The taxonomic key
  itself is never delegated to a large language model (LLM); 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.97
  doi: 10.5281/zenodo.19930112
  url: https://github.com/HugoMachadoRodrigues/soilKey
repository: https://cran.r-universe.dev
repository-code: https://github.com/HugoMachadoRodrigues/soilKey
commit: 52ec21dd0b9b877640546d1c1d6b9d75ea204c93
url: https://hugomachadorodrigues.github.io/soilKey/
date-released: '2026-05-13'
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'