Chapter 60 Likert package

Lingrui Luo and Zijing Wang

工具包 ‘likert’
中文翻译版本 Chinese Version

类型工具包
标题分析与可视化李克特(likert)选项
版本 1.3.5
日期 2016-12-26
作者 Jason Bryer <jason@bryer.org>,Kimberly Speerschneider <kimspeer@gmail.com>
维护者 Jason Bryer <jason@bryer.org>
网址 http://jason.bryer.org/likert, http://github.com/jbryer/likert
错误报告 https://github.com/jbryer/likert/issues
描述说明 一种着重与可视化的分析李克特(likert)选项的方法。堆栈条形图(stacked bar plot)是展现李克特数据结果的优先选择。表格数据结果也可以与密度图相结合，帮助研究者决定李克特选项的回答是否可以进行定量使用而不是定性使用。以下函数可以作为一个好的开篇：likert(), summary.likert(), plot.likert().
许可证 GPL
延迟加载 是
插图生成器 utils
工具 R (>=3.0), ggplot2, xtable
导入工具包 psych, reshape2, gridExtra, grid, plyr
建议工具包 devtools, shiny
RoxygenNote 5.0.1
需要汇编 不需要
知识库 CRAN
日期/发布日期 2016-12-31 01:37:00

索引

likert-package 李克特分析与可视化

描述李克特分析与可视化
作者 <jason@bryer.org>

abs_formatter 连续性数值的绝对值格式

描述打印出坐标标签的绝对值。对于堆栈条形图中以负数表示负分组的非负百分比十分有用。
使用方式 abs_formatter(x)
参数
- x 需要被改变格式的值
数值 x的绝对值

align.plots

改编于ggExtra工具包(该工具包已不可以用)。

与实验性mlpsa图有关，mlpsa图将两个单独分布结合在环形图(circular plot)中

描述改编于ggExtra工具包(该工具包已不可以用)。与实验性mlpsa图有关，mlpsa图将两个单独分布结合在环形图(circular plot)中
使用方式 align(g1,...)
参数
- g1 grid.layout
- ... 需要添加的其他画图元素
参考 http://groups.google.com/group/ggplot2/browse_thread/thread/1b859d6b4b441c90

gap 虚构数据集，数据机包括五个不同的办公室的重要程度与满意度结果。

描述此数据集用于GapAnalysis样本中，用于展示likert工具包如何处理差距分析
格式 68行观察结果、11个变量的数据框结构

label_wrap_mod 包装标签文本

描述包装标签文本
使用方式 label_wrap_mod(value,width=25)
参数
- value 需要被包装的向量(用as.character转换成char类型)
- width 每一行字母的最大宽度，改编于https://github.com/hadley/ggplot2/wiki/labeller

likert 分析李克特类型选项

描述此函数提供多种关于李克特类的统计数据。
使用方式

likert(items, summary, grouping = NULL, factors = NULL, importance,
       nlevels = length(levels(item[,1])))

参数
- items 存储李克特类选项的数据框。数据框中的变量类型应为“因子”数据类型
- summary 预总结的数据框。第一列必须是李克特选项，剩下的列是李克特选项的量表(例如：强烈反对，反对等等)
- grouping (可选的)结果应总结为所给的分组变量。
- factors 定义每一列所属因子length(factors)==ncol(items)的向量。值对应因子标签
- importance 与李克特选项有相同维度的数据框，包含对应选项的重要程度。
- nlevels 可能的量表量化选项的数量。只在存在缺失值的时候有必要标明。
细节
- results 此数据框会包含一列Item,Group(如果明确了一个分组变量，并且每列对应每一个量化选项(例如:同意，不同意等。)。每一个单元格的值对应每一个李克特回答的百分比)
- items 原李克特选项的复制数据框
- grouping 原分组向量的复制
- nlevels 用于计算的量化选项的数量
值包括以下元素的李克特类别：结果，选项，分组，量化选项数量，总结。
可查阅
- plot.likert
- summary.likert
例子

data(pisaitems)
items29 <- pisaitems[, substr(names(pisaitems), 1, 5) == 'ST25Q']
names(items29) <- c("Magazines", "Comic books", "Fiction",
                   "Non-fiction books", "Newspapers")
l29 <- likert(items29)
summary(l29)
plot(l29)

liker.bar.plot 李克特选项的条形图

描述李克特结果的条形图
使用方式 likert.bar.plot(l, group.order, center = (l$nlevels-1)/2 + 1, ...)
参数
- l 李克特选项的结果
- group.order 组别(分组选项)或者选项(非分组选项)的顺序
- center 指定作为中心的量化等级。例如，center=3表示用第三等级作为中心，center=3.5表示明确中心点，但是小于等于3为低等级，大于等于4为高等级(i.e. 用于强制选择的选项或者没有中立选择的选项)。这也会影响从低到高等级的颜色分割位置。
- ... 传到likert.options的参数
- likert 李克特类型对象
可查阅
- plot.likert
- likert.heat.plot
- likert.bar.plot
- likert.density.plot

likert.density.plot 创建一个李克特选项密度图

描述此函数创建一个将李克特选项当作连续性变量处理的可视化
使用方式

likert.density.plot(likert, facet = TRUE, bw = 0.5, legend, ...)

参数
- likert 李克特类型对象
- facet 对于非分组的选项，每一个密度分布应该画在不同的平面内
- bw 平滑宽度。经常设置成标准偏差，但对于李克特类型选项来说经常是不足够的。由于两个相邻等级是不同的，所以使用0.5作为bw的值。
- legend 图标的标题
- ... 传给density的参数
可查阅
- plot.likert

likert.heat.plot 内部方法

描述内部方法
使用方式

likert.heat.plot(likert, low.color = "white", high.color = "blue",
                 text.color = "black", text.size = 4, wrap = 50, ...)

参数
- likert 李克特类型对象
- low.color 用于表示低数值的颜色
- high.color 用于表示高数值的颜色
- text.color 文本属性的字体颜色
- text.size 文本属性的字体大小
- wrap 用于非分组李克特对象的包装标签文本的宽度
- ... 目前尚未使用
可查阅
- plot.likert
- likert.bar.plot

likert.histogram.plot 李克特回答数量的直方图

描述绘画一个包括每一个选项和分组(如果存在指定分组)对应的回答数量的直方图。负数值(默认用红棕色)表明选项和分组的缺失值数量。
使用方式

likert.histogram.plot(l, xlab = "n", plot.missing = TRUE,
                      bar.color = "grey70", missing.bar.color = "maroon",
                      label.completed = "Completed", label.missing = "Missing",
                      legend.position = "bottom", wrap = ifelse(is.null(l$grouping), 50, 100),
                      order, group.order, panel.arrange = "v", panel.strip.color = "#F0F0F0",
                      text.size = 2.5, ...)

参数
- l 李克特的结果
- xlab 用于x轴的标签
- plot.missing 如果是TRUE，缺失值会被画在x轴的左边
- bar.color 柱形条的颜色
- missing.bar.color 缺失值的柱形条的颜色
- label.completed 在图标中表示完整值总量的标签
- label.missing 在图标中表示缺失值总量的标签
- legend.position 图标位置
- wrap 包装文本到面板条之前的字母数量 - order 李克特选项的顺序
- group.order 组别(分组选项)或者选项(非分组选项)的顺序
- panel.arrange v表示垂直位置，h表示水平位置
- panel.strip.color 面板颜色
- text.size 文本字体大小
- ... 其他ggplot2参数

likert.matrix.plot 矩阵图(实验的)

描述矩阵图(实验的)
使用方法

likert.matrix.plot(likert, nSample = nrow(likert$items), ...)

参数
- likert 李克特选项的结果
- nSample 全部行的随机样本。此函数对于大数据集的运行时间会长一些(包括pisaitems数据)。可以绘画一个随机副样本以便于快速开发。
- ... 传给pairs.ordered.categorical的参数

likert.options 建立一个用于绘画李克特结果的有可选项的对象

描述建立一个用于绘画李克特结果的有可选项的对象
使用方法

likert.options(low.color = "#D8B365", high.color = "#5AB4AC",
               neutral.color = "grey90", neutral.color.ramp = "white", colors = NULL,
               plot.percent.low = TRUE, plot.percent.high = TRUE,
               plot.percent.neutral = TRUE, plot.percents = FALSE, text.size = 3,
               text.color = "black", centered = TRUE, include.center = TRUE,
               ordered = TRUE, wrap = 50, wrap.grouping = 50, legend = "Response",
               legend.position = "bottom", panel.arrange = "v",
               panel.strip.color = "#F0F0F0", ...)

参数
- low.color 用于表示低数值的颜色
- high.color 用于表示高数值的颜色
- neutral.color 用于表示中间数值的颜色(如果等级数为奇数)
- neutral.color.ramp 当访问colorRamp用于low.color和high.color定义调色板时使用的第二种颜色
- colors 指定使用颜色的向量。向量长度或元素数量一定等于李克特等级的数量
- plot.percent.low 是否绘画低百分比
- plot.percent.high 是否绘画高百分比
- plot.percent.neutral 是否绘画中立百分比
- plot.percents 是否标记每一个种类/柱形条
- text.size 文本属性的文字大小
- text.color 文本属性的文字颜色
- centered 如果值为TRUE，条形图将被放在0的中心位置以便于低等级被放置与负值区域。
- include.center 如果值为TRUE，将中心等级包括在图中(不然中心等级会被忽视/排除)
- ordered 将选项从高到低重新排序
- wrap 用于李克特选项标签的包装标签文本的宽度
- wrap.grouping 用于分组李克特选项标签的包装标签文本的宽度
- legend 图标的标题
- legend.position 图标的位置(“left”, “right”, “bottom”, “top”, 或者两个元素的数字向量)
- panel.arrange 用于分组李克特选项的面板安排。可能的值为v(垂直位置,默认值), h(水平位置), 和NULL(自动选择水平和垂直)
- panel.strip.color 面板标签的背景颜色
- ... 用于未来的扩展

mass 来自一个管理部门的Math Anxiety比例问卷调查的结果

描述在一门统计学课程中对20名学生进行Math Anxiety比例问卷调查结果的数据框。此数据框包括了原始数据，可以用于核实预先总结的步骤。
格式 14行和6列的数据框
参考文献
Bai, H., Wang, L., Pan, W., & Frey, M. (2009). Measuring mathematics anxiety: Psychometric analysis of a bidimensional affective scale. Journal of Instructional Psychology, 36 (3), 185- 193.

MathAnxiety

管理部门提供的 Math Anxiety比例问卷调查的预先总结的结果

描述在一门统计学课程中，对20名学生进行了MathAnxiety比例问卷调查的预先总结结果的数据框。
格式 14行6列的数据框架。
参考文献
Bai, H., Wang, L., Pan, W., & Frey, M. (2009). Measuring mathematics anxiety: Psychometric analysis of a bidimensional affective scale. Journal of Instructional Psychology, 36 (3), 185- 193.

MathAnxietyGender

按照性别区分的, 管理部门提供的 Math Anxiety比例问卷调查的预先总结结果

描述
在一门统计学课程中，按照性别对20名学生进行了MathAnxiety比例问卷调查的预先总结结果的数据框。
格式 28行7列的数据框架。
参考文献
Bai, H., Wang, L., Pan, W., & Frey, M. (2009). Measuring mathematics anxiety: Psychometric analysis of a bidimensional affective scale. Journal of Instructional Psychology, 36 (3), 185- 193.

pisaitems 国际学生评估计划

描述
北美(即加拿大、墨西哥和美国)根据经济合作与发展组织(OECD)提供的2009年国际学生评估项目(PISA)的结果。更多信息请参见http://www.pisa.oecd.org/，包括代码手册。
格式包含来自北美的81个变量的66690个观测值的数据框。
来源经济合作与发展组织。

plot.likert 绘制一组李克特项

描述
这是S3 plot通用函数的一个实现。这个函数将根据类型参数调用likert.bar.plot, likert.heat.plot 或者 likert.density.plot。有关这些函数的自定义图形外观的所有可用参数，请参阅帮助页面。虽然这些函数可以直接绘制，但我们建议调用通用plot函数。
使用方式

#S3 method for class 'likert'
plot(x, type = c("bar", "heat", "density"),
include.histogram = FALSE, panel.widths = c(3, 1), panel.arrange = "v",
panel.strip.color = "#F0F0F0", legend.position = "bottom", group.order,
panel.background = element_rect(size = 1, color = "grey70", fill = NA), ...)

参数
- x 要绘制的李克特项。
- type 要创建的图形类型，当前值为bar和heat。
- include.histogram 如果为TRUE，回答数量的直方图也会被绘制。
- panel.widths
如果include.histogram为 TRUE, 这个长度为2的向量指定了左右面板的比例。
- panel.arrange
如何为按组分的李克特项安排面板。可能的值是v(垂直，默认值)、h(水平)和NULL(自动填充水平和垂直)。
- panel.strip.color 面板标签的背景色。
- legend.position 图例的位置(“左”、“右”、“下”、“上”或两元数字向量)。
- group.order 分组(分组项)或项(非分组项)的绘制顺序。
- panel.background 定义图的背景。见theme。
- 其他参数传递给 likert.bar.plot or likert.heat.plot。
可查阅
- likert.bar.plot
- likert.heat.plot
- likert.density.plot
- likert.histogram.plot

plot.likert.gap 绘制一组李克特项

描述这是S3 plot通用函数的一个实现。这个函数将根据类型参数调用likert.bar.plot, likert.heat.plot 或者 likert.density.plot。有关这些函数的自定义图形外观的所有可用参数，请参阅帮助页面。虽然这些函数可以直接绘制，但我们建议调用通用plot函数。
使用方式

## S3 method for class 'likert.gap'
plot(x, type = c("bar", "density"),
include.histogram = FALSE, panel.widths = c(3, 1), panel.arrange = "v",
panel.strip.color = "#F0F0F0", legend.position = "bottom",
panel.background = element_rect(size = 1, color = "grey70", fill = NA),
satisfaction.label = "Satisfaction", importance.label = "Importance",
legend, ...)

参数
- x 要绘制的李克特项。
- type 要创建的图形类型，当前值为bar和heat。
- include.histogram 如果为TRUE，回答数量的直方图也会被绘制。 - panel.widths
如果include.histogram为 TRUE, 这个长度为2的向量指定了左右面板的比例。
- panel.arrange
如何为按组分的李克特项安排面板。可能的值是v(垂直，默认值)、h(水平)和NULL(自动填充水平和垂直)。
- panel.strip.color 面板标签的背景色。
- legend.position 图例的位置(“左”、“右”、“下”、“上”或两元数字向量)。
- group.order 分组(分组项)或项(非分组项)的绘制顺序。
- panel.background 定义图的背景。见theme。
- satisfaction.label 满意度项的标签。
- importance.label 重要性项的标签。
- legend 说明框的标题。
- 其他参数传递给 likert.bar.plot or likert.heat.plot。
可查阅
- likert.bar.plot
- likert.heat.plot
- likert.density.plot
- likert.histogram.plot

print.likert 输出结果表

描述输出结果表
使用方式

## S3 method for class 'likert'
print(x, ...)

参数
- x 要打印的李克特类。
- 传递给print.data.frame的参数。

print.likert.bar.plot

likert.bar.plot的输出方法。

主要目的是抑制ggplot2打印的“当 ymin != 0时堆叠没有很好定义”警告

该警告针对的是具有负条形(即居中图)的条形图。

描述 likert.bar.plot的输出方法。主要目的是抑制ggplot2对具有负条形(即中间的条形图)的条形图打印的“ymin != 0时堆叠没有很好定义”警告。
使用方式

## S3 method for class 'likert.bar.plot'
print(x, ...)

参数
- x likert.bar.plot生成的图。
- 传递给ggplot2的参数。

print.likert.gap 打印结果表

描述打印结果表
使用方式

## S3 method for class 'likert.gap'
print(x, ...)

参数
- x 要打印的李克特类。
- 传递给print.data.frame的参数。

print.likert.heat.plot likert.heat.plot的打印方法

描述 likert.heat.plot的打印方法
使用方式

## S3 method for class 'likert.heat.plot'
print(p, ...)

参数
- p likert.heat.plot的图。
- 传递给ggplot2的参数。

print.xlikert 打印xtable.likert的结果

描述打印xtable.likert的结果
使用方式

## S3 method for class 'xlikert'
print(x, tabular.environment = "longtable", floating = FALSE, ...)

参数
- x xlikert的结果。
- tabular.environment 见 print.xtable。
- floating 见 print.xtable。
- 传递给print.xtable的参数。

recode 重新编码向量

描述这个实用函数将重新编码带着新值的原始字符或因子向量的值。
使用方式

recode(x, from, to, to.class = NULL)

参数
- x 将被重新编码的向量。
- from x中将被重新编码的旧值。
- to 新的值。
- to.class 一个“as.”函数代表所需的向量类型(例如as.character, as.numeric,as.logical, as.numeric)
值一个长度与x一样的包含重新编码值的向量。
例子

test <- letters[sample(5, 10, replace=TRUE)]
recode(test, from=letters[1:5], to=paste('Letter', letters[1:5]))

reverse.levels 反转一个因子的级别分类

描述反转一个因子的级别分类。
使用方式

reverse.levels(x)

参数
- x 一个级别分类将被反转的一个因子或者数据框。
例子

mylevels <- c('Strongly Disagree', 'Disagree', 'Neither', 'Agree', 'Strongly Agree')
test <- factor(sample(mylevels[1:5], 10, replace=TRUE))
cbind(test, as.integer(test), as.integer(reverse.levels(test)))

sasr 学术自律调查(SASR)的结果。

描述
学术自我调节(SASR)调查由六个因素组成:自我调节、内在动机、外在动机、自我效能感、元认知和个人关联与控制。
格式包含63个变量，860个观察值的数据框架。
参考文献
Dugan, R., & Andrade, H. (2011). Exploring the construct validity of academic self-regulation using a new self-report questionnaire. The International Journal of Educational and Psychological Assessment, 7(1).

shinyLikert 李克特包的Shiny应用。

描述这将启动一个包含显示的许多功能李克特包的Shiny应用程序包。
使用方式

shinyLikert()

参考文献 http://rstudio.com/shiny

summary.likert 打印李克特分析的汇总表。

描述

summary函数返回一个提供附加信息的数据框架。它包含类似结果数据框的“Item”和“Group”列,以及一列“low”对应总和水平低于中性的分类,一列“high”对应的总和高于中性的分类,和列“mean”和“sd”对应的平均值和标准偏差分别的结果。数值化结果取决于as.numeric后的因数的值。
- 使用方式

## S3 method for class 'likert'
summary(object, center = (object$nlevels - 1)/2 + 1,ordered = TRUE, ...)

参数
- object 要总结的李克特类。
- center
指定应该将哪个级别作为中心。例如，center = 3将使用第三个级别作为中心，而center = 3.5将表示没有特定的级别为中心，但<= 3是低级别，>= 4是高级别(即用于强制选择项或没有中立选项的项)。
- ordered 是否应该对结果排序。目前不支持分组分析。

summary.likert.gap 打印李克特分析的汇总表。

描述 summary函数返回一个提供附加信息的数据框架。它包含类似结果数据框的“Item”和“Group”列,以及一列“low”对应总和水平低于中性的分类,一列“high”对应的总和高于中性的分类,和列“mean”和“sd”对应的平均值和标准偏差分别的结果。数值化结果取决于as.numeric后的因数的值。
使用方式

## S3 method for class 'likert.gap'
summary(object, ...)

参数
- object 要总结的李克特类。
- 参数传递给summary.likert。
值

包含两个数据框架的列表，其中分别汇总了满意度和重要性数据的结果。

xtable.likert 打印一个LaTex表的李克特项目。

描述建立LaTeX或HTML表的likert结果。
使用方式

## S3 method for class 'likert'
xtable(x, caption = NULL, label = NULL, align = NULL,
digits = NULL, display = NULL, auto = FALSE, include.n = TRUE,
include.mean = TRUE, include.sd = TRUE, include.low = TRUE,
include.neutral = (x$nlevels%%2 != 0), include.high = TRUE,
include.levels = TRUE, include.missing = TRUE, center = (x$nlevels - 1)/2 + 1, ordered = TRUE, ...)

参数
- x 李克特类的对象。
- caption 表格的标题。
- label 表格的标签。
- align 列的序列方向。
- digits 数字类列的小数位的数量。
- display 列的格式。
- auto 逻辑，指示在没有向align、digit或display传递值时是否应用自动格式(有关更多信息，请参阅xtable)。
- include.n 包含n的选项。
- include.mean o 包含平均数的选项。
- include.sd 包含sd的选项。
- include.low 包含low的选项。
- include.neutral 包含neutral的选项。
- include.high 包含high的选项。
- include.levels 包含级别的选项。
- include.missing 包含缺失值的选项。
- center
指定应该将哪个级别作为中心。例如，center = 3将使用第三个级别作为中心，而center = 3.5将表示没有特定的级别为中心，但<= 3是低级别，>= 4是高级别(即用于强制选择项或没有中立选项的项)。这也影响哪些层被总结在低和高组。
- ordered 是否应该对结果排序。见summary.likert。
- ... 参数传递给xtable。
可查阅
- xtable
- print.xtable