Как вы делитесь своим анализом R с другими? R Markdown – один из хороших способов, потому что в нем легко смешивать текстовое повествование, результаты вычислений и графику. Но как вы поделитесь своим Документы R Markdown с коллегами?

Вы можете опубликовать их где-нибудь, отправить по электронной почте как вложения или использовать RStudio Connect (коммерческий продукт), чтобы поделиться ими. Или вы можете превратить документ R Markdown в сообщение электронной почты и отправить его в теле письма прямо из включенных графиков R – ggplot. Это благодаря пакет blastula от RStudio.

Вот как это работает.

Во-первых, что неудивительно, установите и загрузите пакет с помощью install.packages("blastula") или же remotes::install_github("rstudio/blastula").

Создайте сообщение электронной почты с помощью blastula

Есть два способа создать электронное письмо с помощью blastula. Я предпочитаю начинать с документа R Markdown. Использовать blastula :: blastula_email в качестве выходного формата не забудьте включить заголовок, и все готово. Другой способ – использовать бластулу. compose_email() функция, которая требует большего количества ручного кодирования для большего, чем простое текстовое электронное письмо. Для этой демонстрации я буду использовать R Markdown.

Я предлагаю создать пустой документ в RStudio, перейдя в Файл> Новый файл> R Markdown и нажав кнопку «Создать пустой документ».

Для YAML вверху требуются заголовок документа и формат вывода электронной почты, например:

---
title: My Email Title
output: blastula::blastula_email
---

Затем создайте документ R Markdown как обычно. Обратите внимание, что виджеты HTML не будут работать – электронные письма не будут запускать JavaScript. Однако ggplot работает нормально, как в этом образце документа:

---
title: Useful graph!
output: blastula::blastula_email
--- Greetings all! I wanted to show you this graph. If I had more to say, I could use formatting like _italics_ and **bold**. HTML css works, too, such as <span style="color:red;">changing font color</span>. ```{r echo = FALSE}
library(ggplot2)
ggplot(mtcars, aes(x = wt, y = mpg)) +
geom_point() +
ggtitle("MPG by Weight")
```

Вы можете предварительно просмотреть, как это выглядит обычным способом, нажав кнопку вязания в RStudio.

Затем сохраните ваш .Rmd-документ в объекте электронной почты blastula с render_email() функция, например

library(blastula)
my_email_object <- render_email('blastula_test.Rmd')

Вы можете предварительно просмотреть объект электронной почты с помощью print(my_email_object). Если вы проверите класс объекта с помощью class(my_email_object), Тебе следует увидеть

"blastula_message" "email_message" 

Отправьте сообщение электронной почты из R

Пришло время Отправить электронная почта.

Для этого вам понадобится доступ к SMTP-серверу. Outlook, Gmail и многие другие почтовые службы используют SMTP. Но чтобы пользоваться бластулой, нужен доступ для отправки почты. программно через этот сервер. В зависимости от настроек безопасности у вас может не быть такого доступа, особенно на работе.

Если вы хотите использовать личную учетную запись Gmail, вы должны настроить свою учетную запись, чтобы разрешить доступ тем, которые Google считает «менее безопасными» приложениями. Я не рекомендую делать это для основной учетной записи Google, содержащей конфиденциальную информацию.

Для вторичной или несущественной учетной записи перейдите по ссылке Управление учетной записью Google> Безопасность и прокрутите вниз до надписи «Доступ к приложениям менее безопасен». Вас предупредят, чтобы этого не делали. (И не зря. Я снова отключил эту настройку после написания этой статьи.)

Вы можете сохранить свое имя пользователя Gmail и настройки сервера с помощью blastula’s create_smtp_creds_key() функция. Это сохранит ваше имя пользователя и настройки сервера провайдера, и вам будет предложено ввести пароль.

Вот формат для smtp_send() функция, включающая эти сохраненные учетные данные:

  smtp_send(my_email_object,
from = "username@gmail.com",
to = "username@domain.com",
subject = "Your email subject",
credentials = creds_key("gmail")
)

И вот он – простой способ поделиться своим анализом R с другими. Вы можете увидеть все это в действии на видео, встроенном в верхнюю часть этой страницы.

Чтобы узнать больше советов и руководств по R, перейдите в мою Делайте больше со страницей R.

Авторские права © 2021 IDG Communications, Inc.


#Gmail #отправка #электронной #почты #помощью #blastula

Source link