Skip to contents

Import data from ADSO/BIN binary file. It requires an active Python installation with the arinfopy library.

Usage

importADSOBIN(
  file = file.choose(),
  variable = NULL,
  slice = 1,
  deadline = 1,
  k = 1,
  kz = 1,
  dx = 0,
  dy = 0,
  destaggering = FALSE,
  raster.object = FALSE,
  verbose = FALSE
)

Arguments

file

The ADSO/BIN file to be imported.

variable

A string with the name of the variable to be imported.

slice

An integer corresponding to the horizontal slice (vertical level) of 3D variables (default = 1). In the case of a 2D variable, it is ignored.

deadline

An integer representing the temporal deadline (default = 1). It can optionally be a string with date time (see examples).

k

A numeric factor to be applied to x and y coordinates (default = 1).

kz

A numeric factor to be applied to z values to rescale them (default = 1).

dx

A number to shift x coordinates by dx (default = 0).

dy

A number to shift y coordinates by dy (default = 0).

destaggering

Use TRUE to apply destaggering to X and Y coordinates (default = FALSE).

raster.object

Use TRUE to return a raster object instead of a dataframe with (X, Y, Z) columns (default = FALSE).

verbose

Use TRUE to print out basic statistics (default = FALSE).

Value

In standard use, importADSOBIN() return a data frame with (X, Y, Z) columns. Column Z contains the values of the requested variable. If the raster.object option is set, it returns a RasterLayer object.

Details

The importADSIOBIN() function was developed to import data from an ADSO/BIN binary file. It relies on the `arinfopy' (version >= 2.2.0) python library. For more information on the library see the GitHub repository.

For more information on the active python installation, check the documentation of reticulate.

Examples


if (FALSE) {
# Read ground level (slice = 1) value of variable M001S001.
pm10 <- importADSOBIN(file = "average_2018.bin",
                      variable = "M001S001",
                      slice = 1)

# Read deadline 12 of the second vertical level of temperature:
temperature <- importADSOBIN(file = "swift_surfpro_01-10_01_2018",
                             variable = "TEMPK",
                             slice = 2,
                             deadline = 12)

# Read varibale M001S001 at ground level, at given date and time,
# and print basic information:
nox <- importADSOBIN(file = "conc_01-10_07_2018",
                     variable = "M001S001",
                     slice = 1,
                     deadline = "2018/07/02 12:00",
                     verbose = TRUE)
}