Програмно створення таблиць Markdown в R за допомогою KnitR

Я тільки починаю дізнаватися про KnitR та використання Markdown при створенні R документів та звітів. Це здається ідеальним для багатьох щоденних повідомлень про те, що я маю справу зі своєю роботою. Однак одне, чого я не бачу, - це простий спосіб друкувати фрейми та таблиці даних за допомогою форматування Markdown (на кшталт xtable, але за допомогою Markdown замість LaTeX або HTML). Я знаю, що я можу просто вставити вихід HTML з xtable, але мені було цікаво, чи існують рішення на основі Markdown?

Тепер knitr(з версії 1.3) пакет включає kableфункцію для таблиць створення:

> library(knitr)
> kable(head(iris[,1:3]), format = "markdown")
|  Sepal.Length|  Sepal.Width|  Petal.Length|
|-------------:|------------:|-------------:|
|           5,1|          3,5|           1,4|
|           4,9|          3,0|           1,4|
|           4,7|          3,2|           1,3|
|           4,6|          3,1|           1,5|
|           5,0|          3,6|           1,4|
|           5,4|          3,9|           1,7|

ОНОВЛЕНО : якщо ви отримаєте необмежену розмітку в документі, спробуйте встановити results = "asis"параметр налаштування .

Два пакети, які зроблять це, - це Pander

library(devtools)
install_github('pander', 'Rapporter')

Або ascii

pander дещо інший підхід до повідомлення про будівництво, (але може бути корисним для цієї функції).

asciiдозволить вам printз type = 'pandoc(або різні інші уцінки аромати)

library(ascii)
print(ascii(head(iris[,1:3])), type = 'pandoc')



    **Sepal.Length**   **Sepal.Width**   **Petal.Length**  
--- ------------------ ----------------- ------------------
1   5.10               3.50              1.40              
2   4.90               3.00              1.40              
3   4.70               3.20              1.30              
4   4.60               3.10              1.50              
5   5.00               3.60              1.40              
6   5.40               3.90              1.70              
--- ------------------ ----------------- ------------------

Зауважте, що в обох цих випадках він спрямований на використання pandocдля перетворення відмітки до потрібного типу документа, однак за допомогою style='rmarkdown'створюються таблиці, сумісні з цим markdownпакетом, і вбудована конверсія в rstudio.

Просто хотів оновити це тим, що я вирішив зробити. hwriterЗараз я використовую пакет для друку таблиць, а також використовую row.*іcol.* функцій розміщую класи CSS на різних елементах. Потім я написав користувальницький CSS, щоб зробити свій показ так, як я цього хотів. Отже, ось приклад у випадку, якщо хтось інший має справу з чимось подібним.

Спочатку створіть файл, який буде виконувати knittingта змінити розмітку на HTML:

FILE: file_knit.r
#!/usr/bin/env Rscript

library(knitr)
library(markdown)

knit("file.Rmd")
markdownToHTML("file.md","file.html",stylesheet="~/custom.css")

Далі створіть власне файл Markdown:

FILE: file.Rmd
Report of Fruit vs. Animal Choices
==================================

This is a report of fruit vs. animal choices.

```{r echo=FALSE,results='asis'}
library(hwriter)
set.seed(9850104)
my.df <- data.frame(Var1=sample(x=c("Apple","Orange","Banana"),size=40,replace=TRUE),
                    Var2=sample(x=c("Dog","Cat","Bunny"),size=40,replace=TRUE))

tbl1 <- table(my.df$Var1,my.df$Var2)

tbl1 <- cbind(tbl1,rowSums(tbl1))
tbl1 <- rbind(tbl1,colSums(tbl1))

colnames(tbl1)[4] <- "TOTAL"
rownames(tbl1)[4] <- "TOTAL"

# Because I used results='asis' for this chunk, I can just use cat() and hwrite() to 
# write out the table in HTML. Using hwrite()'s row.* function, I can assign classes
# to the various table elements.
cat(hwrite(tbl1,
           border=NA,
           table.class="t1",
           row.class=list(c("header col_first","header col","header col","header col", "header col_last"),
                          c("col_first","col","col","col","col_last"),
                          c("col_first","col","col","col","col_last"),
                          c("col_first","col","col","col","col_last"),
                          c("footer col_first","footer col","footer col","footer col","footer col_last"))))
```

Нарешті, просто створіть спеціальний файл CSS.

FILE: custom.css
body {
  font-family: sans-serif;
  background-color: white;
  font-size: 12px;
  margin: 20px;
}

h1 {font-size:1.5em;}

table {
  border: solid;
  border-color: black;
  border-width: 2px;
  border-collapse: collapse;
  margin-bottom: 20px;
  text-align: center;
  padding: 0px;
}

.t1 .header {
  color: white;
  background-color: black;
  border-bottom: solid;
  border-color: black;
  border-width: 2px;
  font-weight: bold;
}

.t1 .footer {
  border-top: solid;
  border-color: black;
  border-width: 2px;
}

.t1 .col_first {
  border-right: solid;
  border-color: black;
  border-width: 2px;
  text-align: left;
  font-weight: bold;
  width: 75px;
}

.t1 .col {
  width: 50px;
}

.t1 .col_last {
  width: 50px;
  border-left: solid;
  border-color: black;
  border-width: 2px;
}

Виконання ./file_knit.rдає мені файл.html, який виглядає приблизно так:

Отож, сподіваємось, це може бути корисним для інших, хто хоче трохи більше форматування у висновку Markdown!

У panderпакеті є функції :

> library(pander)
> pandoc.table(head(iris)[, 1:3])

-------------------------------------------
 Sepal.Length   Sepal.Width   Petal.Length 
-------------- ------------- --------------
     5.1            3.5           1.4      

     4.9             3            1.4      

     4.7            3.2           1.3      

     4.6            3.1           1.5      

      5             3.6           1.4      

     5.4            3.9           1.7      
-------------------------------------------

Зробити власну індивідуальну функцію не дуже важко. Ось дуже простий доказ концепції створення таблиці обмеження data.frame:

   rmarkdownTable <- function(df){
      cat(paste(names(df), collapse = "|"))
      cat("\n")
      cat(paste(rep("-", ncol(df)), collapse = "|"))
      cat("\n")

      for(i in 1:nrow(df)){
        cat(paste(df[i,], collapse = "|"))
        cat("\n")
        }
    invisible(NULL)
    }

У документі .Rmd ви б використали функцію з results = 'asis':

```{r, results = 'asis'}
rmarkdownTable <- function(df){
  cat(paste(names(df), collapse = "|"))
  cat("\n")
  cat(paste(rep("-", ncol(df)), collapse = "|"))
  cat("\n")

  for(i in 1:nrow(df)){
    cat(paste(df[i,], collapse = "|"))
    cat("\n")
    }
invisible(NULL)
}

rmarkdownTable(head(iris))
```

Код, наведений вище, дасть вам наступну цифру (у прикладі це вихід у форматі PDF, але оскільки таблиця знаходиться у markdwon, ви також можете в'язати у html чи слово).

Звідси - і читаючи код інших людей - ви можете зрозуміти, як керувати текстом, щоб створити потрібну таблицю та створити більш персоналізовані функції.

використовуйте комбінацію в'язання :: kable та xtable у своєму розмітковому документі.

library("knitr","xtable")

для простого data.frame -

kable(head(mtcars[,1:4]),format="markdown")
kable(head(mtcars[,1:4]),format="pandoc",caption="Title of the table")

format="pandoc" дозволяє більше варіантів, таких як підписи.

Тепер комбінація для зведення моделі .

data(tli)
fm1 <- aov(tlimth ~ sex + ethnicty + grade + disadvg, data=tli)
kable(xtable(fm1), caption = "Annova table")

ще більше варіантів дивіться на stargazerпакет замість xtable.

приклад для особистого використання

Для запису / створення таблиць Markdown в R ви також можете використовувати MarkdownReports ' MarkDown_Table_writer_DF_RowColNames() або MarkDown_Table_writer_NamedVector()функції. Ви просто передаєте кадр / матрицю даних з іменами розмірів або вектор з іменами, і він аналізує та записує таблицю у форматі Markdown.

Моя функція для Gitlab:

to_markdown<-function(df) {
    wrap<-function(x,sep=" ") paste0("|", sep, paste(x, collapse=paste0(sep,"|",sep)), sep, "|", sep=sep)
    paste0(wrap(colnames(df)),
    "\n",
    wrap(rep("------", ncol(df)),sep=""),
    "\n",
    paste(apply(df, 1, wrap), collapse="\n"))
}

cat(to_markdown(head(iris[,1:3])))

| Sepal.Length | Sepal.Width | Petal.Length | 
|------|------|------|
| 5.1 | 3.5 | 1.4 | 
| 4.9 | 3 | 1.4 | 
| 4.7 | 3.2 | 1.3 | 
| 4.6 | 3.1 | 1.5 | 
| 5 | 3.6 | 1.4 | 
| 5.4 | 3.9 | 1.7 |