StartPLMScoRe: Runs PLMScoRe PLMScoRe function

Description Usage Arguments Details Value Examples

View source: R/R-PLMSCORE.R

Description

Will read in a REMLogic event txt file and return descriptors of leg movements

Usage

1
StartPLMScoRe(RLs = NULL, fn = NA, silent = 0, ...)

Arguments

RLs

REMLogic specifications

fn

Filename and path of REMLogic txt file

silent

option to run the function interactively (default) or automatic

...

Additional arguments (currently not specified)

Details

If you are using StartPLMScore for the first time you will want to run it in the interactive mode with no input arguments (resultXY<-StartPLMScore()). During the interactive phase you will be asked to define the input to the actual scoring function. All this information will be saved in an RLs object (short for REMLogic specifications). At the end you will have the chance to save this RLs object, so that next time you will be able to load these specifications without going through the interactive phase again. In fact, after you have selected a REMLogic event txt file you will be asked whether you want to load an existing specification file. Even if you do load an existing file, you will still have the opportunity to change the input (unless you set silent=1). If you want to use this function for batch processing of a number of event files that all have the same specifications, you can run it in silent mode with all inputs provided (see example below).

Value

a PLMScoRe object

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
#Will run the function interactively

## Not run: plmresultsXY<-StartPLMScoRe()

#Will run the function automatically without further user input

## Not run: plmresultsxy<-StartPLMScore(RLs=RLs, fn="D:\\Test\\XY-Events.txt", silent=1)

#Example of batch processing

#You want to make sure that you select only txt files
#This will generate a list of all txt files in that directory

## Not run: fnlist<-list.files("D:\\Test\\Scorings\\", pattern=".txt", full.names=TRUE)

#You also need to load the RLs object
#Let's say you called it RLsStudyXY you can load it with:

## Not run: load("D:\\Test\\RLsStudyXY.RData")

#or you use the file menu to select and load it
#In RStudio you can verify in the "Environment" tab that you actually loaded it
#In R type ls() and inspect the outcome

## Not run: for(i in 1:length(fnlist)) StartPLMScore(RLs=RLs, fn=fnlist[i], silent=1)

Steph-Fulda/PLMScoRe documentation built on June 24, 2020, 4:09 p.m.