spatial2d: Spatial 2D Reasoning Items
In Aidenloe/AIG: Automatic Item Generator

Description Usage Arguments Details Value Author(s) See Also Examples

This function generates a 2 or 3 dimensional display figure with 4 2D distractors and 1 2D answer.

1 2	spatial2d(items, wd = NULL, view = "2D", seed = NULL, degree = 360, ansDegree = 180, test = 1)

`items`	The number of items to generate.
`wd`	This is the working directory to save the figures in. If not provided, the file will be saved in the current working directory.
`view`	There are three options ("2D", "top", "bottom") to view the display figure from different prespectives.
`seed`	To generate the same set of item(s) on the local computer.
`degree`	This allows users to change the rotation of the display figure by increasing or decreasing the value.
`ansDegree`	This will allow users to change the degree of rotation for the correct figure.
`test`	This will generate the specific value in the name of the saved images.

To see the 3D display figure, change the view argument to either 'top' or 'bottom'. For 3D figures, some of the cubes may be hidden in sight. Hence, the 2D answer may not seem correct. So one would need to rotate the display figure several times to ensure that none of the cubes are hidden. The rotation can be done by changing the degree value in the function. To ensure that the same image is generated again, please provide a seed value. Currently angle of the view from the top and the bottom is fixed. It may be better to generate one item at a time for the 3D displayed figures. This is not a problem for 2D items.

By default the actual answer is always at half of the display polar coordinates. The display figure polar coordinates by default is 360. Increasing the degrees will make the figure rotate clock-wise and decreasing the degrees will make the figure rotate anti-clockwise.

4 distractors are generated. 2 of the generated distractors are a mirror image of the displayed figure. The difference in the polar coordinates between the two distractors are fixed at 120. The third distractor is a figure wihout the first square that is generated by the display item. The fourth distractor is a figure with an additional square added to the distractor. Currently, the polar coordinates are fixed for the third and fourth distractor as well.

There are occassions where a mirror distractor will not work. In such an instance, the item together with the distractors will not be useful for the test. Hence, it will be a good item to remove the item from the test. It is also a good idea to keep track on your local computer which seed it is so you can avoid having to regenerate the item. That is where the seed will come in handy. The seed correspond to the number position of which the item is created. For example, if you want to recreate item/figure number 19, then all you need do so is to keep the argument item = 1, but change the argument seed = 19. This will re-generate the number 19th item. Bear in mind that the created figures will use item 19 as the file name. So if you try to re-generate the 19th item 10 times, then all it does is to rewrite on the same image for 10 times. Hence, you will not get replicates.

Finally, to automatically generate more than 1 item, just make sure that the argument seed = NULL, and put in how many values you want in the argument item. See the examples for help.

ans: Return the matrix that generates the display figure and answer.
mirror: Return the matrix that generates a mirror figure.
dist3: Return the matrix that generates the distractor without the first square.
dist4: Return the matrix that generates the distractor that adds an extra square.

Aiden Loe and Francis Smart

lisy, arith, spatial3d

#2D display figure (Generate the 19th item given the seed value)
spatial2d(items=1, wd=NULL,view="2D", seed=19, degree=360, ansDegree= 180, test = 2)

#2D display figure (Generate 10 items)
#seed must be NULL
#spatial2d(items=10, wd=NULL,view="2D", seed=NULL, degree=360, ansDegree= 180, test = 2)

#wd<- "~/desktop"
#3D display figure (top view)
#spatial2d(items=1, wd=wd,view="top", seed=1, degree=320, ansDegree=160, test = 2)

#3D display figure (bottom view)
#spatial2d(items=1, wd=wd,view="bottom", seed=1, degree=320, ansDegree=100, test = 2)