Awesome

httpgd <img src="man/figures/httpgd_logo.svg" align="right" width="25%"/>

A graphics device for R that is accessible via network protocols. This package was created to make it easier to embed live R graphics in integrated development environments and other applications. The included HTML/JavaScript client (plot viewer) aims to provide a better overall user experience when dealing with R graphics. The device asynchronously serves graphics via HTTP and WebSockets.

Features

• Fast plotting
• Interactive plot viewer (client)
• Supports multiple clients concurrently
• Plot resizing and history
• Export various image formats (SVG, PNG, PDF, EPS, ...)
• Powered by unigd
• For developers:
  • Stateless asynchronous HTTP/WebSocket API
  • HTML/JavaScript client (TypeScript module)

Demo

Installation

Install httpgd from CRAN:

install.packages("httpgd")

Or get the latest development version from GitHub:

remotes::install_github("nx10/httpgd")

See system requirements for troubleshooting.

Documentation

• For users:
  • How to get started
  • Plotting in unigd
  • Function reference
  <!-- - [Benchmarks](https://nx10.github.io/httpgd/articles/c02_benchmarks.html) -->
  • IDEs & evironments:
    • VS Code
    • RStudio
    • Docker
• For package developers:
  • httpgd API
  <!-- - [Technical documentation](https://nx10.github.io/httpgd/articles/c03_technical-docs.html) -->

Contributions welcome!

The various components of httpgd are written in C++, R and TypeScript. We welcome contributions of any kind.

Other areas in need of improvement are testing and documentation.

Links & Articles

• Using httpgd in VSCode: A web-based SVG graphics device

About & License

Depends on cpp11.

Webserver based on CrowCpp/Crow.

This project is licensed GPL v2.0.

The HTML client includes Material Design icons by Google which are licensed under the Apache License Version 2.0.

Full copies of the license agreements used by these components are included in ./inst/licenses.