Use argo_info() to extract scalar variables and global attributes from a vector of Argo NetCDF files. Use argo_read_info() to extract variables from a previously-downloaded Argo NetCDF file.

argo_info(path, download = NULL, quiet = NA)

Arguments

path

A path relative to the root directory of argo_mirror() or argo_cache_dir(). This value can also be a data.frame with a file column (e.g., a global index as returned by argo_global_meta() and others).

download

A logical vector indicating whether or not a file should be downloaded. Defaults to the value of argo_should_download(), which is TRUE for files that do not exist in the cache.

quiet

Use FALSE to show which files are downloaded and for more verbose error messages.

Value

A tibble::tibble() with one row per file. Columns containing global attribute information are prefixed with att_ to differentiate them from variables with zero dimensions.

Examples

with_argo_example_cache({
  argo_info("dac/csio/2900313/profiles/D2900313_000.nc")
})
#> Extracting from 1 file
#> # A tibble: 1 × 16
#>   file             data_type format_version handbook_version reference_date_time
#>   <chr>            <chr>     <chr>          <chr>            <dttm>             
#> 1 csio/2900313/pr… Argo pro… 3.1            1.2              1950-01-01 00:00:00
#> # … with 11 more variables: date_creation <dttm>, date_update <dttm>,
#> #   att_title <chr>, att_institution <chr>, att_source <chr>,
#> #   att_history <chr>, att_references <chr>, att_comment <chr>,
#> #   att_user_manual_version <chr>, att_conventions <chr>, att_featuretype <chr>