Read one or more TOXSWA exposure series from TOXSWA's .out files. By default, the
concentration dissolved in water (ConLiqWatLay) at the end of the simulated waterbody
(i.e. at the maximum of the x dimension) is returned. The unit of the time
scale as well as of the imported model output variable can be scaled as needed.
import_toxswa(
files,
alias = NA,
output_var = "ConLiqWatLay",
output_unit = "ug/L",
time_unit = "days",
substance = NULL,
split = TRUE
)list of data.frame objects with exposure series. Each data.frame has at least three columns:
time: numerical time scale, always starts at zero
timestamp: time as datetime objects such as POSIXct
one or more additional columns for each imported substance
vector of strings with absolute or relative paths to files
optional vector with strings, will be used as an alias to identify a TOXSWA series instead of its filename
character, single output variable from TOXSWA that is imported, defaults to ConLiqWatLay
character, target unit of the imported output variable,
defaults to ug/L, syntax must be compatible with units::units()
character, target unit of the imported time scale,
defaults to days, syntax must be compatible with units::units()
optional vector of characters, if set, only the substance codes defined in this vector are imported
logical, if TRUE then one series will be returned for each
substance found in the TOXSWA files, else all substances per file will
be in one data.frame. Defaults to TRUE
The numerical time scale is shifted to always start at time zero (0.0).
Numerical columns of the returned data.frame objects will be of type
units::units. Please be aware that the use of units objects may not be
supported by all functions in this package. However, set_times() and
set_exposure() can handle units objects safely.
Incomplete list of alternative TOXSWA v5.5.3 output variables:
ConLiqWatLay: Concentration dissolved in water (g/m3)
ConLiqSed: Concentration in pore water sediment (g/m3)
ConSysWatLay: Total concentration in water (g/m3)
CntSorSusSol: Content sorbed to suspended solids (g/kg)
CntSorSed: Content sorbed to sediment (g/kg)