read_fmi2mspct: Read multiple solar spectra from a data file.
In photobiologyInOut: Read Spectral and Logged Data from Foreign Files

read_fmi2mspct

R Documentation

Read multiple solar spectra from a data file.

Description

Read spectral irradiance file as output by Anders Lindors' model based on libRadTrans for hourly simulation, or measured data from FMI's Brewer spectrometer.

Usage

read_fmi2mspct(
  file,
  scale.factor = 0.001,
  geocode = NULL,
  what.measured = NULL,
  how.measured = NULL,
  date.field = 2L,
  time.field = 3L,
  date.format = "ymd",
  time.format = "hms",
  tz = NULL,
  time.shift.min = 0,
  locale = readr::default_locale(),
  .skip = 0,
  .n_max = -1
)

Arguments

`file`	Either a path to a file, a connection, or literal data (either a single string or a raw vector).
`scale.factor`	numeric A multiplier to be applied to the spectral irradiance values.
`geocode`	A data frame with columns `lon` and `lat` used to set attribute `"where.measured"`.
`what.measured`	character string, but if `NULL` the value of `file` is used, and if `NA` the "what.measured" attribute is not set.
`how.measured`	character string, but if `NULL` or `NA` the "how.measured" attribute is not set.
`date.field`, `time.field`	integer. Word positions in the header line.
`date.format`	character string. One of "ymd", "ydm", "dmy", or "mdy".
`time.format`	character string. One of "hms", "hm".
`tz`	character Time zone used for interpreting times saved in the file header.
`time.shift.min`	numeric. Time shift with respect to TZ in minutes.
`locale`	The locale controls defaults that vary from place to place. The default locale is US-centric (like R), but you can use `locale` to create your own locale that controls things like the default time zone, encoding, decimal mark, big mark, and day/month names.
`.skip`	Number of lines to skip before reading data.
`.n_max`	Maximum number of records to read.

Value

read_fmi2mspct() returns a source_mspct object containing source_spct objects as members, time.unit attribute set to "second" and when.measured attribute set to the date-time values extracted from the file body.

Note

See read_table for details of acceptable values for file. Individual spectra are names based on time and date in ISO format, at the time zone given by tz but the time shift subtracted. Say for times expressed in headers at UTC + 120 min, we use tz = UTC and time.shift.min = 120 to convert times to UTC. This is different from using tz = EET, which is not invariant through the course of the year because of daylight saving time. Local time zones is not necessarily consistent across years because of changes in legislation. In contrast UTC is more consistent, making it preferable for time series.