afs {IMak}

Analogy from stimuli.

Description

Creates an analogy item from pre-made stimuli, the latter being either figural or verbal. To create figural analogies from stimuli generated by IMak, the build_fa and plot_fa functions should be used.

Usage

afs(
  path,
  type = "F",
  sa,
  sb,
  sc,
  s1 = "No content",
  s2 = "No content",
  s3 = "No content",
  s4 = "No content",
  s5 = "No content",
  s6 = "No content",
  s7 = "No content",
  s8 = "No content",
  s9 = "No content",
  s10 = "No content",
  relations = "A",
  question = T,
  labels = "L",
  ai.idn = F,
  size.arrow = 34,
  size.arrowhead = 3,
  size.colon = 55,
  size.relword = 32,
  size.q = 85,
  size.word = 32,
  size.label = 25,
  language = "E",
  out = "item"
)

Arguments

path

Directory where files are saved and/or collected. For example: "C:/Desktop/Folder". For a figural item, figural stimuli should be placed inside the correspondent folder.

type

Should the afs function create a figural ("F") or a verbal ("V") item?

sa

String with stimulus name A of an A:B::C:D analogy, including ".png" extension when type = "F".

sb

String with stimulus name B of an A:B::C:D analogy, including ".png" extension when type = "F".

sc

String with stimulus name C of an A:B::C:D analogy, including ".png" extension when type = "F".

s1

String with response option name 1, including ".png" extension when type = "F".

s2

String with response option name 2, including ".png" extension when type = "F".

s3

String with response option name 3, including ".png" extension when type = "F".

s4

String with response option name 4, including ".png" extension when type = "F".

s5

String with response option name 5, including ".png" extension when type = "F".

s6

String with response option name 6, including ".png" extension when type = "F".

s7

String with response option name 7, including ".png" extension when type = "F".

s8

String with response option name 8, including ".png" extension when type = "F".

s9

String with response option name 9, including ".png" extension when type = "F".

s10

String with response option name 10, including ".png" extension when type = "F".

relations

Should analogical relations be indicated by arrows and a colon ("A"), just colons ("C") or words ("W")?

question

Should there be a question mark?

labels

Should options be labeled by letters ("L"), numbers ("N") or no labels (F)?

ai.idn

Should there be "All incorrect" and "I don't know" options?

size.arrow

Thickness of the arrow.

size.arrowhead

Size of the arrowhead.

size.colon

Size of the colon.

size.relword

Size of words that relate the stimuli of the A:B::C:D stem to each other.

size.q

Size of the question mark.

size.word

Size of verbal stimuli excluding labels and words of the stem (for these two, use size.label and size.relword respectively).

size.label

Size of labels.

language

Language of verbal stimuli including words of the stem.

out

Output file name.

Details

Create an analogy item by using pre-made stimuli. Such stimuli can be either figural or verbal, and it should be sufficient to complete the A, B and C terms of an A:B::C:D analogy stem plus at least two answer options. Use a source/target folder to save the item by providing an argument to path. For a figural item, save the pre-made figures as PNG files inside that folder (the ideal would be to supply perfect-square high-resolution images). Give arguments to sa, sb and sc, thus indicating the names of stimuli A, B and C. Give arguments to s1 and s2 to indicate the names of two answer options. Provide further arguments to parameters s3 to s10 if you would like to add up to 10 options in total. All of these names are the image file names plus their ".png" extensions when you want to create a figural item. Include "All incorrect" and "I don't know" options by setting ai.idn to TRUE. Other variables that can be altered are: the way of indicating the A:B::C:D relations, the question mark, the option labels, the sizes and the language of verbal stimuli.

Value

A PNG file containing the item.

Author(s)

Diego Blum [e-mail]