afs: Analogy from stimuli.
In IMak: Item Maker

afs	R Documentation

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.