Skip to contents

Reads profiles live from ISRIC's ISIS GraphQL service and returns them as PedonRecords, ready for classify_all or benchmark_isis. Nothing is written to disk. Each pedon carries the names ISRIC gives it, the licence and the citation (isis_citation); see isis_profile_to_pedon for what the translation reads.

Usage

read_isis(
  profile_codes = NULL,
  country = NULL,
  max_profiles = 100L,
  absent_unless_recorded = TRUE,
  timeout = 60,
  progress = NULL
)

Arguments

profile_codes

Profile codes, e.g. c("KE009", "ZW005").

country

ISO 3166 two-letter country code, e.g. "KE", read when profile_codes is NULL.

max_profiles

The most profiles to read (default 100).

absent_unless_recorded

Passed to isis_profile_to_pedon.

timeout

Seconds to wait for each request (default 60).

progress

Optional function(done, total).

Value

A named list of PedonRecords, one per profile read. On a failed request the profiles read until then are returned with a warning.

Examples

if (FALSE) { # \dontrun{
p <- read_isis(c("KE009", "ZW005"))
classify_all(p$KE009)
p$KE009$site$reference_wrb_full
} # }