readDataOT2 | R Documentation |
Reads in data from files exported by OnTarget PC v2.* or OnTarget TDS v3.*. Several files can be read with one call.
readDataOT2(fPath = ".", fNames, fPat, combine = TRUE,
dstTarget, conversion)
fPath |
a character string containing the path to the folder with the OnTarget PC/TDS output files, e.g. |
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., |
combine |
logical: combine the data into one big data frame with |
dstTarget |
a numerical value/vector giving the distance to the target - used in MOA calculation. Acts as override if variable |
conversion |
how to convert the measurement unit for distance to target to that of the (x,y)-coordinates in MOA calculation. Example |
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 (file type .csv
) 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 and v2.28 as well as OnTarget TDS v3.71, v3.89, v6.09.
For reading in files exported from OnTarget PC v1.*, see readDataOT1
.
For reading in other text files, see readDataMisc
.
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
.
read.csv
,
regex
,
glob2rx
,
combineData
,
readDataOT1
,
readDataSMT
,
readDataShotMarker
,
readDataMisc
## 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)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.