read_obs_convert: Read observations and output to sqlite OBSTABLE file(s)

In andrew-MET/harpIO: IO functions and data wrangling for harp

Read observations and output to sqlite OBSTABLE file(s)

Description

This function was deprecated as read_obs is much more flexible.

Usage

read_obs_convert(
  start_date,
  end_date,
  by = "3h",
  obs_path = ".",
  obs_format = "vobs",
  obsfile_template = "vobs",
  parameter = NULL,
  sqlite_path = NULL,
  sqlite_template = "obstable",
  return_data = FALSE,
  iterations_per_write = 24,
  sqlite_synchronous = c("off", "normal", "full", "extra"),
  sqlite_journal_mode = c("delete", "truncate", "persist", "memory", "wal", "off"),
  ...
)

Arguments

start_date	Date of the first observations to be read in. Should be in YYYYMMDDhh format. Can be numeric or charcter.
end_date	Date of the last observations to be read in. Should be in YYYYMMDDhh format. Can be numeric or charcter.
by	The time between observations. Should be a string of a number followed by a letter (the defualt is "6h"), where the letter gives the units - may be d for days, h for hours or m for minutes.
obs_path	The path for the input observation files. obs_path will, in most cases, form part of the file template.
obs_format	The format of the input observation files. Currently only "vobs".
obsfile_template	The template for the observation files. Currently only "vobs".
parameter	Not used for vobs.
sqlite_path	If not NULL, sqlite files are generated and written to the directory specified here.
sqlite_template	The template for the sqlite observations file. The default is "obstable", which is "sqlite_path/OBSTABLE_YYYY.sqlite".
return_data	Whether to return the data to the calling environment. The default is FALSE.
iterations_per_write	The number of iterations of "by" before each write to the sqlite file. The default is 24.
sqlite_synchronous	The synchronus setting for sqlite files. The defualt is "off", but could also be "normal", "full", or "extra". See https://www.sqlite.org/pragma.html#pragma_synchronous for more information.
sqlite_journal_mode	The journal mode for the sqlite files. The default is "delete", but can also be "truncate", "persist", "memory", "wal", or "off". See https://www.sqlite.org/pragma.html#pragma_journal_mode for more information.
...	Arguments to read functions. Not currently used.

Value

If return_data is TRUE - a list with four data frames - one for synop (near surface) observations, one for the units of the synop observations, one for the temp (upper air) observations, and one for the units of the temp observations.

andrew-MET/harpIO documentation built on March 7, 2024, 7:48 p.m.