ReadiButtonFolder: Read Temperature Data Files from Folder

Description Usage Arguments Value Author(s) Examples

View source: R/MainFunctions.R

Description

Imports all iButton temperature data from a specified folder, and aligns them to desired specifications based on rounding and start/end dates and times.

Usage

1
2
ReadiButtonFolder(path = path, rounding = rounding, StartDate, EndDate,
  DailyStartTime, DailyEndTime, exceltime = FALSE, hdlen = 14)

Arguments

path

Desired folder

rounding

Desired Rounding (options: '1min', '10min', '15min', '30min', '1hr', '2hrs')

StartDate

First desired date (and time) of the dataset (in format 'YYYY-MM-DD' or 'YYY-MM-DD HH:MM:SS' (in 24 hour time))

EndDate

Last desired date (and time) of the dataset (in format 'YYYY-MM-DD' or 'YYY-MM-DD HH:MM:SS' (in 24 hour time))

DailyStartTime

If only a portion of the day is desired, the start daily start time (in format 'HH:MM:SS' (in 24 hour time))

DailyEndTime

If only a portion of the day is desired, the start daily end time (in format 'HH:MM:SS' (in 24 hour time))

exceltime

Indicates whether function should read the date and time stamp as formatted when an iButton file is saved in Microsoft Excel, as it changes the format. Default is FALSE.

hdlen

Specifies the length of the header, as not all iButton data files have same header length. For example, model DS1921G has a header of 14 lines (which is the default for the function), while DS1922L has a header of 19 lines. This can be determined by opening an iButton data file in a text editor and counting how many lines are before the column names for the data.

Value

zoo object.

Author(s)

Mike Treglia [email protected]

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
    packagePath <- find.package("iButtonDataOrganizer", lib.loc=NULL, quiet = TRUE)
    pathToFolder <- paste(packagePath, "/extdata/iButtonData_JulOct2014_2hr", sep="")

    # Note: Time can also be included as part of the date, in this example, only date is used;
    # Date/Time formatted as "YYYY-MM-DD HH-MM-SS", based on 24 hour time
    JulOct2014 <- ReadiButtonFolder(path=pathToFolder, rounding="2hrs",
     StartDate="2014-07-26", EndDate="2014-10-31")

    ## Users can write output to CSV file a CSV file with Date in the first column:
    # write.csv(as.data.frame(JulOct2014), "JulOct2014.csv")

mltConsEcol/iButtonDataOrganizer documentation built on May 22, 2017, 10:53 a.m.