These data frames contain information about codes, subunits and units for the
datasets in inputDat
and are necessary inputs for e.g.
automateDataPreparation
, checkData
,
recodeData
, aggregateData
and scoreData
.
Usage
data(inputList)
Format
A list with three data frames:
units: Unit information, contains the following columns:
- unit
Unit name.
- unitType
Subunit types:
ID
= ID variable;TI
= test item;CV
= context variable.- unitLabel
Unit label, to be used by
writeSpss
.- unitDescription
Unit description.
- unitAggregateRule
Aggregate rule for unit:
SUM
;MEAN
.- unitScoreRule
not currently in use
subunits: Subunit information, contains the following columns:
- unit
Unit name, for which subunits are given.
- subunit
Subunit name.
- subunitType
Subunit types:
C1
= multiple choice;C2
= short answer;C3
= constructed response;T
= transcript.- subunitLabel
Subunit label, to be used by
writeSpss
.- subunitDescription
Subunit descriptions.
- subunitPosition
Subunit position in test booklet (e.g., line 1).
- subunitTransniveau
Subunit transformation level.
- subunitRecoded
Name of recoded subunit.
- subunitLabelRecoded
Label for recoded subunit, to be used when
writeSpss
is applied to a dataset produced byrecodeData
.
values: Value information, contains the following columns:
- subunit
Subunit name, for which values are given.
- value
Valid values for the respective subunit.
- valueRecode
Recode values for the respective value.
- valueType
Value types:
vc
= valid code;mbd
= missing – by design;mvi
= missing – volume insufficient;mnr
= missing – not reached;mci
= missing – coding impossible;mbi
= missing – by intention.- valueLabel
Value labels, to be used by
writeSpss
.- valueDescription
Value descriptions.
- valueLabelRecoded
Labels for recoded values, to be used when
writeSpss
is applied to a dataset produced byrecodeData
.- valueDescriptionRecoded
Descriptions for recoded values.
unitRecodings: Unit recoding information, contains the following columns:
- unit
Unit name
- value
Valid values for the respective unit.
- valueRecode
Recode values for the respective value.
- valueType
Value types:
vc
= valid code;mbd
= missing – by design;mvi
= missing – volume insufficient;mnr
= missing – not reached;mci
= missing – coding impossible;mbi
= missing – by intention.- valueLabel
Value labels, to be used by
writeSpss
.- valueDescription
Value descriptions.
- valueLabelRecoded
Labels for recoded values, to be used when
writeSpss
is applied to a dataset produced byrecodeData
.
savFiles: information for
readSpss
, contains the following columns:- filename
SPSS filenames
- case.id
ID variable in the respective dataset, used by
mergeData
newID: information for
mergeData
, contains the following columns:- key
one of the entries should be
master-id
- value
the corresponding value; how the ID variable in the final dataset shall be named
aggrMiss: missing aggregation pattern for
aggregateData
blocks: missing aggregation pattern for
aggregateData
- subunit
Subunit name.
- block
Block name.
- subunitBlockPosition
The subunit's position in the corresponding block.
booklets: Design
- booklet
Booklet name.
- block1 ... blockX
Block names in booklet.
rotation: Assignment of IDs to booklets
- ID
Case identifier.
- booklet
Booklet name.
Examples
data(inputList)
str(inputList)
#> List of 10
#> $ units :'data.frame': 29 obs. of 6 variables:
#> ..$ unit : chr [1:29] "I01" "I02" "I03" "I04" ...
#> ..$ unitLabel : chr [1:29] "Animals: Weight of a duck" "Animals: Weight of a horse" "Animals: Weight of a mouse" "Animals: Weight of a cat" ...
#> ..$ unitDescription : chr [1:29] "" "" "" "" ...
#> ..$ unitType : chr [1:29] "TI" "TI" "TI" "TI" ...
#> ..$ unitAggregateRule: chr [1:29] "" "" "" "" ...
#> ..$ unitScoreRule : chr [1:29] "" "" "" "" ...
#> $ subunits :'data.frame': 30 obs. of 9 variables:
#> ..$ unit : chr [1:30] "I01" "I02" "I03" "I04" ...
#> ..$ subunit : chr [1:30] "I01" "I02" "I03" "I04" ...
#> ..$ subunitType : chr [1:30] "1" "1" "1" "1" ...
#> ..$ subunitLabel : chr [1:30] "Animals: Weight of a duck" "Animals: Weight of a horse" "Animals: Weight of a mouse" "Animals: Weight of a cat" ...
#> ..$ subunitDescription : chr [1:30] "" "" "" "" ...
#> ..$ subunitPosition : chr [1:30] "a)" "b)" "c)" "d)" ...
#> ..$ subunitTransniveau : chr [1:30] "" "" "" "" ...
#> ..$ subunitRecoded : chr [1:30] "I01R" "I02R" "I03R" "I04R" ...
#> ..$ subunitLabelRecoded: chr [1:30] "Recoded Animals: Weight of a duck" "Recoded Animals: Weight of a horse" "Recoded Animals: Weight of a mouse" "Recoded Animals: Weight of a cat" ...
#> $ values :'data.frame': 220 obs. of 8 variables:
#> ..$ subunit : chr [1:220] "I01" "I01" "I01" "I01" ...
#> ..$ value : chr [1:220] "1" "2" "3" "6" ...
#> ..$ valueRecode : chr [1:220] "0" "0" "1" "mnr" ...
#> ..$ valueType : chr [1:220] "vc" "vc" "vc" "mnr" ...
#> ..$ valueLabel : chr [1:220] "Response option 1 marked" "Response option 2 marked" "Response option 3 marked" "missing not reached" ...
#> ..$ valueDescription : chr [1:220] "Response option 1 marked" "Response option 2 marked" "Response option 3 marked" "missing not reached" ...
#> ..$ valueLabelRecoded : chr [1:220] "0" "0" "1" "mnr" ...
#> ..$ valueDescriptionRecoded: chr [1:220] "" "" "" "" ...
#> $ unitRecodings:'data.frame': 7 obs. of 7 variables:
#> ..$ unit : chr [1:7] "I12" "I12" "I12" "I12" ...
#> ..$ value : chr [1:7] "0" "1" "2" "3" ...
#> ..$ valueRecode : chr [1:7] "0" "0" "0" "1" ...
#> ..$ valueType : chr [1:7] "vc" "vc" "vc" "vc" ...
#> ..$ valueLabel : chr [1:7] "" "" "" "" ...
#> ..$ valueDescription : chr [1:7] "" "" "" "" ...
#> ..$ valueLabelRecoded: chr [1:7] "" "" "" "" ...
#> $ savFiles :'data.frame': 3 obs. of 3 variables:
#> ..$ filename: chr [1:3] "booklet1.sav" "booklet2.sav" "booklet3.sav"
#> ..$ case.id : chr [1:3] "ID" "ID" "ID"
#> ..$ fullname: chr [1:3] "" "" ""
#> $ newID :'data.frame': 1 obs. of 2 variables:
#> ..$ key : chr "master-id"
#> ..$ value: chr "ID"
#> $ aggrMiss :'data.frame': 7 obs. of 8 variables:
#> ..$ c..vc....mvi....mnr....mci....mbd....mir....mbi..: chr [1:7] "vc" "mvi" "mnr" "mci" ...
#> ..$ vc : chr [1:7] "vc" "mvi" "vc" "mci" ...
#> ..$ mbd : chr [1:7] "err" "err" "err" "err" ...
#> ..$ mvi : chr [1:7] "mvi" "mvi" "err" "mci" ...
#> ..$ mnr : chr [1:7] "vc" "err" "mnr" "mci" ...
#> ..$ mci : chr [1:7] "mci" "mci" "mci" "mci" ...
#> ..$ mir : chr [1:7] "vc" "err" "mir" "mci" ...
#> ..$ mbi : chr [1:7] "vc" "err" "mnr" "mci" ...
#> $ blocks :'data.frame': 30 obs. of 3 variables:
#> ..$ subunit : chr [1:30] "I01" "I02" "I03" "I04" ...
#> ..$ block : chr [1:30] "bl1" "bl1" "bl1" "bl1" ...
#> ..$ subunitBlockPosition: num [1:30] 1 2 3 4 5 6 7 1 2 3 ...
#> $ booklets :'data.frame': 3 obs. of 4 variables:
#> ..$ booklet: chr [1:3] "booklet1" "booklet2" "booklet3"
#> ..$ block1 : chr [1:3] "bl1" "bl4" "bl3"
#> ..$ block2 : chr [1:3] "bl2" "bl3" "bl1"
#> ..$ block3 : chr [1:3] "bl3" "bl2" "bl4"
#> $ rotation :'data.frame': 300 obs. of 2 variables:
#> ..$ ID : chr [1:300] "person100" "person101" "person102" "person103" ...
#> ..$ booklet: chr [1:300] "booklet1" "booklet1" "booklet1" "booklet1" ...