Skip to content

Jupyter display machinery for R

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE
MIT
LICENSE.md
Notifications You must be signed in to change notification settings

IRkernel/IRdisplay

Repository files navigation

IRdisplay b-CI b-CRAN

IRdisplay is a front-end package for Jupyter. It’s automatically integrated into IRkernel when you open a Jupyter notebook using that kernel.

The primary, high level functions are:

display(obj, ..., mimetypes=<from option>, error_handler=stop)

display_png(data = NULL, file = NULL, width = NULL, height = NULL)
# display_jpeg(…); display_pdf(…); display_svg(…)

display_html(data = NULL, file = NULL)
# display_javascript(…), display_json(…), display_markdown(…), display_latex(…)

Use display to display an object in all configured mime types (see Configuration), and the display_* functions to display raw data you have in form of a file or a variable.

Manual use is possible via the *_mimebundle functions:

prepare_mimebundle(obj, mimetypes=<from option>, metadata=NULL, error_handler=stop)
publish_mimebundle(data, metadata = NULL)

Where prepare_mimebundle uses repr to create a mimebundle containing representations of objects, and publish_mimebundle sends such mimebundles to Jupyter.

Configuration

You can add your own mime types that should be displayed via:

options(jupyter.display_mimetypes = union(getOption('jupyter.display_mimetypes'), ...))

If you want to create your own kernel reacting to display / publish_mimebundle calls, you can use:

options(jupyter.base_display_func = function(data, metadata = NULL) ...)