Title: Native R Kernel for the 'Jupyter Notebook'
Description: The R kernel for the 'Jupyter' environment executes R code which the front-end ('Jupyter Notebook' or other front-ends) submits to the kernel via the network.
Version: 1.3.2
URL: https://irkernel.github.io
BugReports: https://github.com/IRkernel/IRkernel/issues/
Depends: R (≥ 3.2.0)
Suggests: testthat, roxygen2
SystemRequirements: jupyter, jupyter_kernel_test (Python package for testing)
License: MIT + file LICENSE
Encoding: UTF-8
Imports: repr (≥ 0.4.99), methods, evaluate (≥ 0.10), IRdisplay (≥ 0.3.0.9999), pbdZMQ (≥ 0.2-1), crayon, jsonlite (≥ 0.9.6), uuid, digest
Collate: 'class_unions.r' 'logging.r' 'comm_manager.r' 'compat.r' 'completion.r' 'environment_runtime.r' 'environment_shadow.r' 'options.r' 'execution.r' 'handlers.r' 'help.r' 'installspec.r' 'utils.r' 'kernel.r' 'main.r' 'onload.r'
RoxygenNote: 7.2.3
NeedsCompilation: no
Packaged: 2023-01-20 19:55:04 UTC; phil
Author: Thomas Kluyver [aut, cph], Philipp Angerer ORCID iD [aut, cph, cre], Jan Schulz [aut, cph], Karthik Ram [aut, cph]
Maintainer: Philipp Angerer <phil.angerer@gmail.com>
Repository: CRAN
Date/Publication: 2023-01-20 20:20:02 UTC

An R kernel for Jupyter.

Description

Jupyter speaks a JSON+ZMQ protocol to a 'kernel' which is responsible for executing code. This package is a kernel for the R language.

Usage

jupyter_option_defaults

Format

An object of class list of length 7.

Options

The following can be set/read via options(opt.name = ...) / getOption('opt.name')

jupyter.log_level

1L (errors), 2L (warnings), or 3L (debug). 1L is the default.

jupyter.pager_classes

Classes to use the pager for instead of displaying them inline. Default: help pages

jupyter.in_kernel

TRUE if this code is executed in a running kernel. Set to pretend being/not being in a kernel

jupyter.rich_display

Use more than just text display

jupyter.display_mimetypes

The formats emitted when any return value is to be displayed (default: all mimetypes listed here)

jupyter.plot_mimetypes

The plot formats emitted to the frontend when a plot is displayed. (default: image/png and application/pdf)

jupyter.plot_scale

The ratio (notebook PPI / repr.plot.res). E.g.: With the defaults repr.plot.res=120 px/in (PPI) and jupyter.plot_scale=2, a 1in\times1in image will be displayed as a 0.5in\times0.5in, 240 PPI image. (default: 2, fit for retina displays)

See Also

installspec

The Comm

Description

Has methods able to register and handle message callbacks

The CommManager

Description

Has methods able to register comms/targets and process comm messages

Get global CommManager instance

Description

Get global CommManager instance

Usage

comm_manager()

Value

CommManager instance if a kernel is running, else NULL

Install the kernelspec to tell Jupyter about IRkernel.

Description

This can be called multiple times for different R interpreter, but you have to give a different name (and displayname to see a difference in the notebook UI). If the same name is give, it will overwrite older versions of the kernel spec with that name!

Usage

installspec(
  user = NULL,
  name = "ir",
  displayname = "R",
  rprofile = NULL,
  prefix = NULL,
  sys_prefix = NULL,
  verbose = getOption("verbose")
)

Arguments

user

Install into user directory ($XDG_DATA_HOME/jupyter/kernels) or globally? (default: NULL but treated as TRUE if "prefix" is not specified)

name

The name of the kernel (default "ir")

displayname

The name which is displayed in the notebook (default: "R")

rprofile

(optional) Path to kernel-specific Rprofile (defaults to system-level settings)

prefix

(optional) Path to alternate directory to install kernelspec into (default: NULL)

sys_prefix

(optional) Install kernelspec using the --sys-prefix option of the currently detected jupyter (default: NULL)

verbose

(optional) If FALSE, silence output of install

Value

Exit code of the jupyter kernelspec install call.

Kernel logging functions

Description

A set of exported logging utilities that have the capability to be used in upstream projects. Log level and log file can be set via R package options e.g. options(jupyter.log_level = 2L) or from the environment variables JUPYTER_LOG_LEVEL and JUPYTER_LOGFILE.

Usage

log_debug(...)

log_info(...)

log_error(...)

Arguments

...

message to log

Initialise and run the kernel

Description

Initialise and run the kernel

Usage

main(connection_file = "")

Arguments

connection_file

The path to the Jupyter connection file, written by the frontend