\Sexpr[results=rd,stage=build]{tools:::Rd_package_indices("#1")}surveyeditor Index: This package was not yet installed at build time.
This package aims to serve as an editor for generating slides for surveys or experiments. The resulted slides allow the subject to respond with the use of the mouse (usual keyboard input is replaced with clicking on a virtual keyboard on the slide). Subjects' responses are saved to the user- specified location in the form of R-readable text file. To allow flexibility, each function in this package generates a particular type of slides thus general R function writing skills are required to compile these edited slides.
Main features include:
There are in general 4 functions in this package: cover : serves as the front or back cover page of the survey. For example, you may wish to have a greeting slide before the survey begins. identity : serves as gathering the id of the subject. Automatic id generation is also allowed. read.write : serves as saving the responses to a nominated file. slide : generates slides to be displayed to the subjects as well as allowing the subjects to respond to designated questions. This is the main function in this package.
The editor of the survey should write a function (a compiler) to compile different functions into a meaningful survey. A recommended format is shown below,
compiler<-function(){
cover
identity
slide
slide
...
read.write
cover}
The first cover serves as the front page then the identity of the subject is configured in identity. slide is the main part of the survey that display information and allow the subject to respond. Responses are then saved to the nominated file through the read.write function. The survey ends in the second cover informing the subject the completion.
More specifically, the below is an example,
sample.survey<-function(){
link<-"C:"
repeat {
cover(type="front")
id<-identity(link=link, ...)
Q1<-slide(id=id, ...)
Q2<-slide(id=id, ...)
...
read.write(rbind(Q1,Q2,...),link=link)
cover(type="back")
} }
The repeat is used to let the next subject take the survey and the response will be incorporated into the user-specified location.
Notes: Here is some recommendations for the best performance.