Mathics3 Jupyter Kernel

This provides a Jupyter Kernel for running Mathics3. In contrast to code in Mathics3-notebook-frontends, this is a full Kernel rather than an extension to be loaded on top of Python 3 ipykernel.

Using

After this Mathics3 Jupyter kernel is loaded, you can enter Mathics3 commands, and you will get the results evaluated and displayed.

There are two "magic" commands available, %pip and %python.

%pip

The %pip command allows you to run Python "pip" commands or to see information on installed Python packages.

%python or %py

The %python command allows you to run Python statements or evaluate Python expressions, rather than Mathics3 expressions or statements.

A special variable session is defined so that you have access to the underlying Python session.

Building

Install all of the prerequisites:

$ pip install -e .

Register the Mathics3 kernel for Jupyter via the JSON file mathics3-jupyter/kernel.json.

$ python3 -m mathics3_jupyter_notebook.install

This needs to be done only once.

To see that this has been installed, run:

$ jupyter kernelspec list

%load_ext mathics3_kernel.frontend.jupyter

Usage is as simple as executing the above code in a notebook cell, and then Mathics3 code can be directly run in all subsequent cells. Here is a sample notebook that can be used with a local Jupyter installation.

Running

$ jupyter lab  # or:  make lab

Debugging

Install jupyter-console and run jupyter console via make:

$ make console
jupyter console --kernel=mathics3-jupyter
Jupyter console 6.6.3

Mathics3 10.0.2dev0 Kernel (1.0)- A Mathematica-compatible engine
...