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 araster
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 imports 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)
}