WOLFRAM

Wolfram Language & System Documentation Center

"Jupyter" (External Evaluation System)

Details

  • Jupyter is a platform to do interactive computing across many programming languages.
  • Jupyter Notebook Version 5 and later is supported.

ExternalEvaluate Usage

  • ExternalEvaluate[<|"System""Jupyter","Kernel""kernelspec"|>,code] executes the code string in a Jupyter kernel and returns the results as a Wolfram Language string.

Data Types

  • The set of data types that are supported is dependent on which programming language you are using in Jupyter.
  • Results are generally returned as Wolfram Language strings.

Usage Notes

  • The kernelspec that you provide is the name of the Jupyter kernel as displayed in a Jupyter Notebook session, such as "python3" or "julia-1.0".
  • A Jupyter kernel that is installed and working properly in the Jupyter platform should also work with ExternalEvaluate.
  • Jupyter kernels for a large number of programming languages can be obtained from https://github.com/jupyter/jupyter/wiki/Jupyter-kernels.

Examples

open all close all

Basic Examples  (2)

Start a session using a Jupyter python3 kernel:

Wolfram Language code: py3 = StartExternalSession[<|"System" -> "Jupyter", "Kernel" -> "python3"|>]

Evaluate a numerical computation:

Wolfram Language code: ExternalEvaluate[py3, "2**8"]

The result is a string:

Wolfram Language code: InputForm[%]

Close the external session:

Wolfram Language code: DeleteObject[py3]

Start a session using a Jupyter JavaScript kernel:

Wolfram Language code: js = StartExternalSession[<|"System" -> "Jupyter", "Kernel" -> "javascript"|>]

Perform a simple evaluation:

Wolfram Language code: ExternalEvaluate[js, "parseFloat(\"2.99\")"]

The result is a string:

Wolfram Language code: InputForm[%]

Close the external session:

Wolfram Language code: DeleteObject[js]

Properties & Relations  (1)

FindExternalEvaluators will show you the names of all the Jupyter kernels that can be found on your system:

Wolfram Language code: FindExternalEvaluators["Jupyter"]