R: Generic Plot Function for Class 'ata'

plot.ata {ata}

R Documentation

Generic Plot Function for Class `ata`

Description

Default plotting function for output objects of class ata. The function detects the object's method and renders the appropriate visualizations.

Usage

\method{plot}{ata}(x,
      conditem=NA,
      useconst=TRUE,
      itemorder=NA,
      itemlab=NA,
      useitemlab=FALSE,
      together=FALSE,
      ...)

Arguments

`x`	An output object of class ata generated by either `wdm()` or `atalp()` from the `ata` package.
`conditem`	Provides a conditional or secondary item classification (i.e. content label). If provided, it must be given in the order of `final_ids` in the ata output object.
`useconst`	Indicator whether all constraints from the test assembly process should be visualized or whether only a selection is desired. If a selection is desired, the name of the constraint as given by the `constobj` should be provided. Default is `TRUE`.
`itemorder`	Identifies the item order with which to visualize constraints. If `NA` the observed order in the ata object will be used. If provided, the new order for the order of `final_ids` in the ata output object must be given.
`itemlab`	Identifies item labels. Default is `NA`. If `NA`, then the item ids in the `final_ids` vector of the ata output object will be used. If provided, ids must be given in the order of `final_ids` in the ata output object.
`useitemlab`	Identifies if items should be labeled. Default is `FALSE`. If `FALSE` then the item order in the `final_ids` vector of the ata output object will be used as labels. If `TRUE`, but itemlab is not provided, then the ids from the `final_ids` vector will be used.
`together`	Should progress plots be stacked together in one plot? Default is `FALSE`. Not advisable for situations with more than 5 constraints.
`...`	Arguments to be passed to methods.

Value

The function returns plots of the test form constraints and a cumulative additive constraint list for each constraint if assigned to an object.

`plots`	For each constraint in the test form two visualizations are considered: 1) A cumulative additive progressive plot showing the change in the constraint total value per selected item, and 2) a plot of the constraint item specific value for each selected item.
`cumulative`	If `plot.ata` is assigned to an object, the object will inherit a list of length equal to the number of constraints each element containing the cumulative constraint value after each selected item.

Author(s)

Michael Chajewski (mchajewski@hotmail.com)