shotGroups (version 0.7.1)

readDataOT2: Read data files exported by OnTarget PC v2.* or OnTarget TDS v3.*

Description

Reads in data from files exported by OnTarget PC v2.* or OnTarget TDS v3.*. Several files can be read with one call.

Usage

readDataOT2(fPath = ".", fNames, fPat, combine = TRUE)

Arguments

fPath

a character string containing the path to the folder with the OnTarget PC/TDS output files, e.g. 'c:/folder/otFiles'.

fNames

a character vector containing the file names of the files that should be read in.

fPat

a character string containing the regular-expression that describes all names of files that should be read in. E.g., '^points[[:digit:]]{2}\\.txt$' for filenames 'points**.txt', where ** are 2 digits. See regex, glob2rx.

combine

logical: combine the data into one big data frame with combineData?

Value

With combine=FALSE: a list of data frames, each from one file that was read in. This list can then be combined into one big data frame by combineData.

file1

data frame containing data from the first file

file2

data frame containing data from the second file

...

more data frames

With combine=TRUE: a combined data frame from combineData.

Details

If fNames is provided, fPat is ignored. If neither fNames nor fPat is provided, and we are in interactive mode under Windows, files can be chosen interactively. This function is basically a wrapper for read.csv. Output files need to be comma-separated files from OnTarget PC v2.* or OnTarget TDS v3.*: 'Tools -> Export Point Data'. Files need to contain exactly the following variable names in this order: Project Title, Group, Ammunition, Distance, Aim X, Aim Y, Center X, Center Y, Point X, Point Y, and optionally Velocity. Tested with OnTarget PC v2.10, OnTarget TDS v3.71, and OnTarget TDS v3.81. For reading in files exported from OnTarget PC v1.*, see readDataOT1. For reading in other text files, see readDataMisc.

See Also

read.csv, regex, glob2rx, combineData, readDataOT1, readDataMisc

Examples

## Not run: 
# # folder with OnTarget PC v2.* or OnTarget TDS v3.* output files
# fPath   <- 'c:/folder/otFiles'
# fileNam <- c('pts01.csv', 'pts02.csv')   # desired files in that folder
# DFgroup <- readDataOT2(fPath, fNames=fileNam, combine=TRUE)
# 
# ## alternatively, specify filename pattern for all files to be read in
# fPath   <- 'c:/folder/otFiles'            # folder with data files
# fPat    <- '^pts[[:digit:]]{2}\\.txt$'  # filename pattern
# DFgroup <- readDataOT2(fPath, fPat=pattern, combine=TRUE)
# ## End(Not run)

## result should look like this
data(DFcm)
head(DFcm)