Use argo_meta_*()
functions to extract information from Argo meta
NetCDF files. Use argo_read_meta_*()
to extract information from a single previously-downloaded NetCDF file.
Using argo_info()
on meta files is also useful for extracting general
float information.
argo_meta_config_param(path, download = NULL, quiet = NA)
argo_meta_missions(path, download = NULL, quiet = NA)
argo_meta_trans_system(path, download = NULL, quiet = NA)
argo_meta_positioning_system(path, download = NULL, quiet = NA)
argo_meta_launch_config_param(path, download = NULL, quiet = NA)
argo_meta_sensor(path, download = NULL, quiet = NA)
argo_meta_param(path, download = NULL, quiet = NA)
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).
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.
Use FALSE
to show which files are downloaded and for more
verbose error messages.
A tibble::tibble()
with
argo_meta_config_param()
: one row per file per configuration parameter and
columns file
, n_config_param
, n_missions
, config_parameter_value
,
and config_parameter_name
.
argo_meta_missions()
: one row per file per mission and columns file
,
n_missions
, config_mission_number
, and config_mission_comment
.
argo_meta_trans_system()
: one row per file per transmission system
and columns file
, n_trans_system
, trans_system
, trans_system_id
,
and trans_frequency
.
argo_meta_positioning_system()
: one row per file per positioning
system and columns file
, n_positioning_system
, and
positioning_system
.
argo_meta_launch_config_param()
: one row per file per launch
configuration parameter and columns file
, n_launch_config_param
,
launch_config_parameter_name
, and launch_config_parameter_value
.
argo_meta_sensor()
: one row per file per sensor and columns
file
, n_sensor
, sensor
, sensor_maker
, sensor_model
,
and sensor_serial_no
.
argo_meta_param()
: one row per file per parameter and columns file
,
n_param
, parameter
parameter_sensor
, parameter_units
,
parameter_resolution
, predeployment_calib_equation
,
predeployment_calib_coefficient
, and predeployment_calib_comment
.
with_argo_example_cache({
argo_meta_config_param("dac/csio/2900313/2900313_meta.nc")
})
#> Extracting from 1 file
#> # A tibble: 7 × 5
#> file n_config_param n_missions config_parameter… config_parameter_na…
#> <chr> <int> <int> <dbl> <chr>
#> 1 csio/2900313… 1 1 1500 CONFIG_ParkPressure…
#> 2 csio/2900313… 2 1 2000 CONFIG_ProfilePress…
#> 3 csio/2900313… 3 1 NA CONFIG_UpTime_hours
#> 4 csio/2900313… 4 1 NA CONFIG_DownTime_hou…
#> 5 csio/2900313… 5 1 240 CONFIG_CycleTime_ho…
#> 6 csio/2900313… 6 1 1 CONFIG_Direction_NU…
#> 7 csio/2900313… 7 1 1 CONFIG_MeasureBatte…
with_argo_example_cache({
argo_meta_missions("dac/csio/2900313/2900313_meta.nc")
})
#> Extracting from 1 file
#> # A tibble: 1 × 4
#> file n_missions config_mission_number config_mission_…
#> <chr> <int> <dbl> <chr>
#> 1 csio/2900313/2900313_meta.nc 1 1 ""
with_argo_example_cache({
argo_meta_trans_system("dac/csio/2900313/2900313_meta.nc")
})
#> Extracting from 1 file
#> # A tibble: 1 × 5
#> file n_trans_system trans_system trans_system_id trans_frequency
#> <chr> <int> <chr> <chr> <chr>
#> 1 csio/2900313/2900… 1 ARGOS 02528 1/45
with_argo_example_cache({
argo_meta_positioning_system("dac/csio/2900313/2900313_meta.nc")
})
#> Extracting from 1 file
#> # A tibble: 1 × 3
#> file n_positioning_system positioning_system
#> <chr> <int> <chr>
#> 1 csio/2900313/2900313_meta.nc 1 ARGOS
with_argo_example_cache({
argo_meta_launch_config_param("dac/csio/2900313/2900313_meta.nc")
})
#> Extracting from 1 file
#> # A tibble: 7 × 4
#> file n_launch_config_p… launch_config_parame… launch_config_parame…
#> <chr> <int> <chr> <dbl>
#> 1 csio/2900313/2… 1 CONFIG_ParkPressure_… 1500
#> 2 csio/2900313/2… 2 CONFIG_ProfilePressu… 2000
#> 3 csio/2900313/2… 3 CONFIG_UpTime_hours NA
#> 4 csio/2900313/2… 4 CONFIG_DownTime_hours NA
#> 5 csio/2900313/2… 5 CONFIG_CycleTime_hou… 240
#> 6 csio/2900313/2… 6 CONFIG_Direction_NUM… 1
#> 7 csio/2900313/2… 7 CONFIG_MeasureBatter… 1
with_argo_example_cache({
argo_meta_sensor("dac/csio/2900313/2900313_meta.nc")
})
#> Extracting from 1 file
#> # A tibble: 3 × 6
#> file n_sensor sensor sensor_maker sensor_model sensor_serial_no
#> <chr> <int> <chr> <chr> <chr> <chr>
#> 1 csio/2900313/2900… 1 CTD_CN… SBE SBE41 0327
#> 2 csio/2900313/2900… 2 CTD_TE… SBE SBE41 0327
#> 3 csio/2900313/2900… 3 CTD_PR… SBE SBE41 0327
with_argo_example_cache({
argo_meta_param("dac/csio/2900313/2900313_meta.nc")
})
#> Extracting from 1 file
#> # A tibble: 3 × 10
#> file n_param parameter parameter_sensor parameter_units parameter_accur…
#> <chr> <int> <chr> <chr> <chr> <chr>
#> 1 csio/2900… 1 PSAL CTD_CNDC psu 0.005 psu
#> 2 csio/2900… 2 TEMP CTD_TEMP degC (ITS-90) 0.002 degC
#> 3 csio/2900… 3 PRES CTD_PRES dbar 1.5%
#> # … with 4 more variables: parameter_resolution <chr>,
#> # predeployment_calib_equation <chr>, predeployment_calib_coefficient <chr>,
#> # predeployment_calib_comment <chr>