Use argo_read_meta_*()
functions to extract meta information from a
previously-downloaded Argo NetCDF file.
Use argo_read_tech_tech_param()
to extract technical specifications from a
previously-downloaded Argo NetCDF file.
argo_read_meta_config_param(file, vars = NULL, quiet = FALSE)
argo_read_meta_missions(file, vars = NULL, quiet = FALSE)
argo_read_meta_trans_system(file, vars = NULL, quiet = FALSE)
argo_read_meta_positioning_system(file, vars = NULL, quiet = FALSE)
argo_read_meta_launch_config_param(file, vars = NULL, quiet = TRUE)
argo_read_meta_sensor(file, vars = NULL, quiet = quiet)
argo_read_meta_param(file, vars = NULL, quiet = quiet)
argo_read_tech_tech_param(file, vars = NULL, quiet = FALSE)
A previously downloaded Argo NetCDF file
(e.g., using argo_download()
).
A vector of variable names to include. Explicitly specifying
vars
can lead to much faster read times when reading many files.
Use FALSE
to stop for malformed files, NA
to
silently warn for malformed files, or TRUE
to silently ignore
read errors when possible.
A tibble::tibble()
with
argo_meta_config_param()
: one row per configuration parameter and
columns n_config_param
, N_MISSIONS
, CONFIG_PARAMETER_VALUE
,
and CONFIG_PARAMETER_NAME
.
argo_meta_missions()
: one row per mission and columns
N_MISSIONS
, CONFIG_MISSION_NUMBER
, and CONFIG_MISSION_COMMENT
.
argo_meta_trans_system()
: one row per transmission system
and columns N_TRANS_SYSTEM
, TRANS_SYSTEM
, TRANS_SYSTEM_ID
,
and TRANS_FREQUENCY
.
argo_meta_positioning_system()
: one row per positioning
system and columns N_POSITIONING_SYSTEM
, and
POSITIONING_SYSTEM
.
argo_meta_launch_config_param()
: one row per launch
configuration parameter and columns N_LAUNCH_CONFIG_PARAM
,
LAUNCH_CONFIG_PARAMETER_NAME
, and LAUNCH_CONFIG_PARAMETER_VALUE
.
argo_meta_sensor()
: one row per sensor and columns
N_SENSOR
, SENSOR
, SENSOR_MAKER
, SENSOR_MODEL
,
and sensor_serial_no
.
argo_meta_param()
: one row per parameter and columns
N_PARAM
, PARAMETER
PARAMETER_SENSOR
, PARAMETER_UNITS
,
PARAMETER_RESOLUTION
, PREDEPLOYMENT_CALIB_EQUATION
,
PREDEPLOYMENT_CALIB_COEFFICIENT
, and PREDEPLOYMENT_CALIB_COMMENT
.
A tibble::tibble()
with one row per technical parameter
and columns N_TECH_PARAM
, TECHNICAL_PARAMETER_NAME
,
TECHNICAL_PARAMETER_VALUE
, and CYCLE_NUMBER
.
meta_file <- system.file(
"cache-test/dac/csio/2900313/2900313_meta.nc",
package = "argodata"
)
argo_read_meta_config_param(meta_file)
#> # A tibble: 7 × 4
#> N_CONFIG_PARAM N_MISSIONS CONFIG_PARAMETER_VALUE CONFIG_PARAMETER_NAME
#> <int> <int> <dbl> <chr>
#> 1 1 1 1500 "CONFIG_ParkPressure_dbar …
#> 2 2 1 2000 "CONFIG_ProfilePressure_dbar…
#> 3 3 1 NA "CONFIG_UpTime_hours …
#> 4 4 1 NA "CONFIG_DownTime_hours …
#> 5 5 1 240 "CONFIG_CycleTime_hours …
#> 6 6 1 1 "CONFIG_Direction_NUMBER …
#> 7 7 1 1 "CONFIG_MeasureBattery_LOGIC…
argo_read_meta_missions(meta_file)
#> # A tibble: 1 × 3
#> N_MISSIONS CONFIG_MISSION_NUMBER CONFIG_MISSION_COMMENT
#> * <int> <dbl> <chr>
#> 1 1 1 " …
argo_read_meta_trans_system(meta_file)
#> # A tibble: 1 × 4
#> N_TRANS_SYSTEM TRANS_SYSTEM TRANS_SYSTEM_ID TRANS_FREQUENCY
#> * <int> <chr> <chr> <chr>
#> 1 1 "ARGOS " "02528 … "1/45 …
argo_read_meta_positioning_system(meta_file)
#> # A tibble: 1 × 2
#> N_POSITIONING_SYSTEM POSITIONING_SYSTEM
#> * <int> <chr>
#> 1 1 "ARGOS "
argo_read_meta_launch_config_param(meta_file)
#> # A tibble: 7 × 3
#> N_LAUNCH_CONFIG_PARAM LAUNCH_CONFIG_PARAMETER_NAME LAUNCH_CONFIG_PARA…
#> * <int> <chr> <dbl>
#> 1 1 "CONFIG_ParkPressure_dbar … 1500
#> 2 2 "CONFIG_ProfilePressure_dbar … 2000
#> 3 3 "CONFIG_UpTime_hours … NA
#> 4 4 "CONFIG_DownTime_hours … NA
#> 5 5 "CONFIG_CycleTime_hours … 240
#> 6 6 "CONFIG_Direction_NUMBER … 1
#> 7 7 "CONFIG_MeasureBattery_LOGICAL … 1
argo_read_meta_sensor(meta_file)
#> # A tibble: 3 × 5
#> N_SENSOR SENSOR SENSOR_MAKER SENSOR_MODEL SENSOR_SERIAL_NO
#> * <int> <chr> <chr> <chr> <chr>
#> 1 1 "CTD_CNDC… "SBE … "SBE41 … "0327 …
#> 2 2 "CTD_TEMP… "SBE … "SBE41 … "0327 …
#> 3 3 "CTD_PRES… "SBE … "SBE41 … "0327 …
argo_read_meta_param(meta_file)
#> # A tibble: 3 × 9
#> N_PARAM PARAMETER PARAMETER_SENSOR PARAMETER_UNITS PARAMETER_ACCURA…
#> * <int> <chr> <chr> <chr> <chr>
#> 1 1 "PSAL … "CTD_CNDC … "psu … "0.005 psu …
#> 2 2 "TEMP … "CTD_TEMP … "degC (ITS-90) … "0.002 degC …
#> 3 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>
tech_file <- system.file(
"cache-test/dac/csio/2900313/2900313_tech.nc",
package = "argodata"
)
argo_read_tech_tech_param(tech_file)
#> # A tibble: 96 × 4
#> N_TECH_PARAM TECHNICAL_PARAMETER_NAME TECHNICAL_PARAMETER_VALUE CYCLE_NUMBER
#> * <int> <chr> <chr> <dbl>
#> 1 1 "NUMBER_ValveActionsAtSu… "150 … 0
#> 2 2 "CLOCK_InitialStabilizat… " 0.2 … 0
#> 3 3 "NUMBER_PumpActionsDurin… "0 … 0
#> 4 4 "NUMBER_RepositionsDurin… "0 … 0
#> 5 5 "NUMBER_PumpActionsDurin… "14 … 0
#> 6 6 "NUMBER_PumpActionsAtSur… "2 … 0
#> 7 7 "PRES_SurfaceOffsetCorre… "1.025 … 0
#> 8 8 "PRESSURE_InternalVacuum… "740.0 … 0
#> 9 9 "NUMBER_AscentArgosMessa… "14 … 0
#> 10 10 "NUMBER_AscentSamples_CO… "71 … 0
#> # … with 86 more rows