Quick Start Guide

The Basics

The following instructions should get you up and running with a basic workflow in the Dyalog development environment. Increase your knowledge with more introductory materials.

Installation

The links below go to summaries of installation instructions for Dyalog installers that can be downloaded from our website.

Licences

There is now a single licence agreement for Dyalog APL, covering both commercial and non-commercial usage. Unregistered installations (those which do not have a valid serial number) are covered by the Basic licence.

Using or entering a serial number other than the one issued to you is not permitted. Transferring the serial number to anyone else is not permitted. See full licence terms and conditions.

Get the APL Font and Keyboard

APL can be entered using a software layer on top of your normal keyboard input.

Learn about Typing APL

Using Dyalog

The notes below describe the basics of writing code and saving your work. For a more detailed walkthrough of installing Dyalog and beginning to use the development environments, see Chapter 2 of Mastering Dyalog APL.

Interactive REPL

Video: Editing and Debugging Dyalog APL When you start Dyalog, you are met with a blank area with a text cursor. This is the session window. You can input APL expressions (usually indented by 6 spaces) and press Enter to see their results:
      2 + 3
5

Save your work

Create a link between the active workspace and a folder on the file system:

      ]LINK.Create # /tmp/MyProject
Linked: # ←→ C:\tmp\MyProject [directory was created]

Now, when you make a change using the editor (after closing it with Esc), a file in that folder will be created or updated.

Note

Variables and dfns defined using the assignment arrow in the session are not saved to a linked folder by default. Use ]LINK.Add mything to save the source for mything with your code.

Tacit functions cannot be saved as text source, they must be wrapped in a tradfn or dfn.

Create, trace, edit and continue

To create a function, press Shift+Enter with the cursor on a name.

You can now write the function’s definition. See APL Course: User-defined Functions for details.

Pressing Esc will close the editor and save your changes in the currently active workspace.

Use Ctrl+Enter to trace through the function line-by-line.

Use Shift+Enter to edit code while tracing and press Esc to save those changes and continue execution.

Quit Dyalog

Use )OFF to exit Dyalog.

Resume your work

When you next start Dyalog, your can scroll up in the session log to see your previous input and output.

This session log is saved in the location specified by the LOG_FILE configuration parameter.

Use ]LINK.Create again to resume working on the code you saved earlier.