modisfast (version 2.0.0)

mf_list_collections_cloud: Check LP DAAC MODIS and VIIRS collections on Earthdata Cloud OPeNDAP

Description

CMR is paginated to discover every LPCLOUD collection supported by modisfast. For each collection, the function tests up to `n_granules` granules (newest first), including a single pixel data request. A successful sample does not imply that every granule or date is available.

Usage

mf_list_collections_cloud(
  collections = NULL,
  time_range = NULL,
  n_granules = 2L,
  verbose = "inform"
)

Value

A data.frame with collection, collection_id, status, tested, succeeded, checked_at, and detail. Status is `operational` when all sampled granules served one pixel, `partial` when only some did, `unavailable` when none did, and `no_granules` when CMR found none for the chosen dates. `unverified` means no suitable two-dimensional variable was found. These statuses apply only to the granules sampled at `checked_at`.

Arguments

collections

Optional character vector of collection names, for example `c("MOD11A1.061", "VNP43MA4.002")`. By default check LP DAAC MODIS collections from the modisfast catalogue and tiled VIIRS `.002` collections published by LPCLOUD in CMR.

time_range

Optional one or two Dates restricting sampled granules.

n_granules

Number of granules to check per collection (default 2).

verbose

Character string: `"quiet"`, `"inform"` (default), or `"debug"`. Controls progress messages.

Examples

if (FALSE) {
Sys.setenv(EARTHDATA_TOKEN = "your Earthdata bearer token")
status <- mf_list_collections_cloud("VJ121A2.002")
subset(status, status == "operational")
mf_list_collections_cloud("VJ121A2.002",
  time_range = as.Date(c("2026-01-01", "2026-01-30")))
}