mazeGen: mazeGen: A package for generating Elithorn Maze

In mazeGen: Elithorn Maze Generator

Description

The mazeGen package provides a function to generate the Perceptual Elithorn Maze as well as the methods for calculating task difficulty without incorporating reponses.

Details

The mazeHTML or the link{mazeObject} function will allow you to generate the mazes according to certain specification. Currently the maximum number of row is 18. To get a summary of the maze parameters, users can use the mazeEst.

For most functions to work, you need to first get the random distribution of the coloured nodes. Using the np function will allow you to do that. There are occasions where one might want to select the number of paths for a maximum score for a given maze with a known saturation.

Calculating the maximum score for the random coloured node distribution can be done using the maxScore function. At this stage, there is no way in generating a maze based on a pre-determined specific maximum score. The maze generation is largely depending on the rank, and the saturation of the coloured nodes.

The genPathSeed function will search for the seed that returns the specific paths for a given maximum score when using it in the np function. Alternatively, one may use the genEMLseed function to search for the seed that returns the specific paths for a maximum score, with the notion that the minimum number of steps to achieve maximum score is the same for all possible paths. Once the seed is return, one can use it in the np function. Bear in mind that the SEED is restricted to the local computer.

The difficulty of the maze can be calculated using the mazeDiff. Using this approch does not consider player's responses but just the parameters involve to create the maze. Three models are used to calculate the maze difficulty using the function.

The ability score of the participants can be calculated using the mazeAbility. There are 4 different models used to calcuate the participants' ability.

Use the mazeHTML function to generate the maze in a HTML template or the mazeObject function to generate the maze in an R object. To use it with concerto, it is better to generate the maze in the R object and push it into a HTML template. This will allow an immediate generation of the maze in test mode.

References

Davies, A. D., & Davies, M. G. (1965). The difficulty and graded scoing of Elithorn's perceptual maze test. British Journal of Psychology, 56(2-3), 295-302.

Davies, M. G., & Davies, D. M. (1965). Some analytical properties of Elithorn's perceptual maze. Journal of Mathematical Psychology, 2(2), 371-380.

mazeGen documentation built on May 2, 2019, 6:34 a.m.