readFile {RSurvey} | R Documentation |
Reads a file in table format.
readFile(file, fields = TRUE, units = TRUE)
file |
either a character string naming a file or a connection. |
fields |
a logical value indicating whether the file contains the names of the variables as its first line. |
units |
a logical value indicating whether the file contains the units of the variables as its second line. |
A tab delineated file, ‘*.txt’, containing the following variables:
[,1] | character | date/time (optional) |
[,2] | numeric | x values |
[,3] | numeric | y values |
[,4:] | numeric | z values, state variable(s) |
The first [1,]
and second [2,]
rows are reserved for column descriptors and units, respectively.
Units associated with date/time values are based on format character strings described in strptime
,
for example "%d/%m/%Y %H:%M:%OS"
. You can embed comments in the data file by using the
“#
” character. Anything after a “#
” on a line will be ignored.
A list with the following components: cols
, a character array of column names.
vars
, a character array of column names associated with the
date/time [1]
, x [2]
, y [3]
, and z [4]
variables.
data.raw
, a data frame of raw survey data.
Fisher, J. C.
## A sample file including a header and two rows of data. ## Date / Time Easting Northing Depth ## %d/%m/%Y %H:%M:%OS m m m ## 06/01/2001 01:01:59.000 727972.52 4138308.65 3.12 ## 06/01/2001 01:01:59.200 727972.51 4138308.68 3.12 f <- system.file("RSurvey-ex/lake.txt", package = "RSurvey") con <- file(f, open = "r", encoding = "latin1") d <- readFile(con) srvy.dat("cols", d$cols) srvy.dat("vars", d$vars) srvy.dat("data.raw", d$dat)