https://github.com/dyalog/dyalog-jupyter-kernel

A Jupyter kernel for Dyalog APL
https://github.com/dyalog/dyalog-jupyter-kernel

apl dyalog dyalog-apl jupyter jupyter-kernel jupyter-kernels kernel notebook notebooks

Last synced: 2 days ago
JSON representation

A Jupyter kernel for Dyalog APL

• Host: GitHub
• URL: https://github.com/dyalog/dyalog-jupyter-kernel
• Owner: Dyalog
• License: mit
• Created: 2018-01-10T16:17:37.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2023-12-01T13:14:32.000Z (12 months ago)
• Last Synced: 2024-10-31T20:48:18.277Z (14 days ago)
• Topics: apl, dyalog, dyalog-apl, jupyter, jupyter-kernel, jupyter-kernels, kernel, notebook, notebooks
• Language: Python
• Homepage: https://dyalog.github.io/dyalog-jupyter-kernel/
• Size: 540 KB
• Stars: 67
• Watchers: 16
• Forks: 20
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Jupyter kernel for Dyalog APL

This is a [Jupyter](http://jupyter.org/) kernel for [Dyalog APL](https://www.dyalog.com/). The [wiki](https://github.com/Dyalog/dyalog-jupyter-kernel/wiki) has more details. 

For complete installation instructions from scratch on Windows, see [WINDOWS.md](WINDOWS.md) in this repository.

If you're a kernel developer, see [DEVELOPMENT.md](DEVELOPMENT.md) in this repository.

## Do you have any pre-made notebook documents?

A collection of ready-made notebooks is available [here](https://github.com/Dyalog/dyalog-jupyter-notebooks).

## Installation

### Pre-requisites:

- Python version 3.8 or later. Python can be installed in several ways. We recommend the standard download from https://www.python.org/downloads/. 

- Jupyter: see the [official documentation](https://jupyter.readthedocs.io/en/latest/install.html) for installation instructions.

### Installing the Dyalog kernel

This kernel is installable via Python's package installer, [pip](https://pip.pypa.io/en/stable/). It comes bundled with Python, but does occasionally need updating. 

In your terminal, run the follwing command:

```sh

pip install dyalog-jupyter-kernel[==2.0.1]

```

After successfully installing the kernel module itself, you need to register it with your Jupyter installation, using the following terminal command:

```sh

python -m 'dyalog_kernel' install

```

You should now be able to see the `dyalog_apl` kernel listed:

```sh

jupyter kernelspec list

Available kernels:

  python3       C:\Users\stefa\work\Jupyter\py312\share\jupyter\kernels\python3

  dyalog_apl    C:\Users\stefa\AppData\Roaming\jupyter\kernels\dyalog_apl

```

Start Jupyter:

```sh

jupyter lab # or jupyter notebook

```

and you should now see Dyalog APL amongst your kernels. Click on the Dyalog APL icon.