使用 roxygen2 记录数据帧列表答案

【问题标题】：documenting a list of data frames with roxygen2使用 roxygen2 记录数据帧列表
【发布时间】：2016-10-31 22:10:56
【问题描述】：

我正在尝试记录我在我的包中附加的一些数据。

我有一个包含 3 个元素（data.frames）的列表，每个数据框都有一些列。我想知道如何在roxygen2 中记录这个层次结构（列表-> data.frame-> 列）。这些示例始终只显示一层、data.frame，然后是列名。这是一个列表中包含两个数据框的最小示例。

list(
  names=data.frame(id=1:10, a=letters[1:10]),
  values=data.frame(id=rep(1:10, each=10), values=runif(100))
)

在我的列表中，所有三个 data.frame 都与 id 列连接，因此它们有点相关，但我不想将它们放入一个数据框中，因为节省内存。

欢迎提出任何建议。

编辑

我试图在我的文档中添加片段，但这似乎不起作用

#' List with group information for the test data set
#'
#' This dataset is a list with 2 data.tables (proteins, timepoint). 
#' It has a common id column in all data.tables.
#'
#' \strong{proteins}
#' @format A data frame with 5458 rows and 3 columns
#' \describe{
#'   \item{id}{unique group id}
#'   \item{names}{individual names}
#'   \item{other names}{other names}
#' }
#'
#' \strong{timepoint}
#' @format A data frame with 80248 rows and 5 columns
#' \describe{
#'   \item{id}{unique group id}
#'   \item{timepoint}{individual timepoint}
#'   \item{imputed_mean}{mean value including imputed values}
#'   \item{measured_mean}{mean value without imputing (contains NAs)}
#'   \item{value_count}{number of measured values within the replicates}
#' }
'pg_test'

输出看起来只能处理 1 个@format 参数。

还有什么建议吗？

【问题讨论】：

标签： r roxygen2

【解决方案1】：

其实我只是想出了一个解决方案，只要没有其他人有更好的建议......

#' List with group information for the test data set
#'
#' This dataset is a list with 2 data.tables (proteins, timepoint). 
#' It has a common id column in all data.tables.
#'
#' @format 
#' \enumerate{
#' \item \strong{proteins} A data frame with 5458 rows and 3 columns
#' \describe{
#'   \item{id}{unique group id}
#'   \item{names}{individual names}
#'   \item{other names}{other names}
#' }
#'
#' \item \strong{timepoint} A data frame with 80248 rows and 5 columns
#' \describe{
#'   \item{id}{unique group id}
#'   \item{timepoint}{individual timepoint}
#'   \item{imputed_mean}{mean value including imputed values}
#'   \item{measured_mean}{mean value without imputing (contains NAs)}
#'   \item{value_count}{number of measured values within the replicates}
#' }
#' }
'pg_test'

也可以用

解决

#' \describe{
#'   \item{One}{First item}
....

我猜不是\enumerate。但这个解决方案目前有效。

【讨论】：