read.kupf: Read Evaporation Experiment data from ku-pf Apparatur

In SoilHyP: Soil Hydraulic Properties

Read Evaporation Experiment data from ku-pf Apparatur

Description

Reads multiple ku-pf Apparatur files from a directory and returns them as list of data.tables.

Usage

read.kupf(
  path,
  colnames.out = c("ts", "tens.up", "tens.low", "weight"),
  firstrow.char = "Date/Time\tTension top\tTension bottom\tWeight",
  format.time_stamp = "%d.%m.%Y %H:%M:%S",
  tz.time_stamp = "GMT",
  ...
)

Arguments

path	path to ku-pf files (character)
colnames.out	colnames of output (default: c('ts', 'tens.up', 'tens.low', 'weight'))
firstrow.char	character in first row of ku-pf files (default: 'Date/Time Tension top Tension bottom Weight') (see details)
format.time_stamp	POSIXct format of the time stamp column (column 1, here named 'ts') (see strptime)
tz.time_stamp	time zone of the time stamp column (column 1, here named 'ts') (default: 'GMT') (see as.POSIXct)
...	arguments to list.files

Details

input file format:

The standard file format of ku-pf files looks like:

Date/Time Tension top Tension bottom Weight
kPa kPa g
01.11.2017 14:11:16 -0.48 -0.15 969.02
01.11.2017 14:21:16 -0.47 -0.14 969.00
01.11.2017 14:31:16 -0.46 -0.13 968.98

If the first row of the ku-pf files differs to the expression used here ('Date/Time Tension top Tension bottom Weight"), it can be set with firstrow.char.

sample_info:

File names are added as attribut to the output (attr(out, 'sample_info')).

The ku-pf software gives the possibility to add sample spezific information in the first row of the file. Depending on the input the ku-pf files than look:

sample_name;project
Date/Time Tension top Tension bottom Weight
kPa kPa g
01.11.2017 14:11:16 -0.48 -0.15 969.02
01.11.2017 14:21:16 -0.47 -0.14 969.00
01.11.2017 14:31:16 -0.46 -0.13 968.98

- For this case the first line is added as attribute to the output (attr(out, 'sample_info')$info)

Value

list of the class dataSEM containing data.tables as list elements.

Author(s)

Ullrich Dettmann

SoilHyP documentation built on Feb. 16, 2023, 7:06 p.m.