TryAPL tutorial system

TryAPL tutorial system#

Press the Enter ↵ key or click on the next button ⇨ to progress through a notebook.

These tutorials are Jupyter notebooks using the Dyalog APL kernel. They can be downloaded from the Dyalog Jupyter notebook repository.

First we’ll cover how to use the interface; which buttons and keys to press etc.
Then we’ll cover the current features and limitations of the TryAPL Jupyter system, compared to full Jupyter notebook system with the Dyalog kernel installed.

TryAPL Jupyter Interface#

Click the Previous step button ⇦ to go back one step within a notebook.

Press the Restart notebook button ↺ to start a notebook from the beginning.

Press Stop notebook 🏠︎ to return to the LEARN menu.

When a notebook has an APL code block, that code will be copied into the session-pane on the right hand side of TryAPL and executed.

Single-line expressions can be modified and re-executed in TryAPL.

{⍸2=+⌿0=∘.|⍨⍳⍵}10
2 3 5 7

Clicking on purple code block text in the left pane will insert it into the right pane, replacing the current line.

The session is like a text editor. You can go up and edit any text in the right-hand pane, then press Enter to execute the code on that line.

Cycle back through manually entered expressions with Ctrl+Shift+Backspace

Cycle forward with Ctrl+Shift+Enter

Features and Limitations#

Dyalog APL and the Jupyter kernel#

The following features are currently available in the Dyalog Jupyter kernel but will not work on TryAPL.

  • Multiline dfns using the ]dinput user command

  • Tradfns

  • Rendering HTML with the ]html user command

  • Making quick plots using the ]plot user command

  • Classes, Namespaces and JSON Objects

Markdown#

Currently, TryAPL renders standard markdown using the marked.js library.

To embed examples, we allow inline code +/⍳10 like this.

Or whole code blocks

+/⍳10

like this.

Of course, it is best to keep code in the executable code blocks

+/⍳10   ⍝ Like this
55

TryAPL also renders LaTeX using MathJax.
So for example, we can say \(\sum_{n=1}^{N} n \) is equivalent to +/⍳N inline.

Or we can use blocks: $\(\sum_{n=1}^{N}n\)$

+/⍳N

TryAPL doesn’t currently support images with relative URLs, but does support absolute URLs.

We welcome submissions of notebooks for inclusion in Try APL, as well as reports of anomalies, suggestions, criticisms, and comments to tryapl@dyalog.com.

Contents