DYNA25: Spring Edition is taking place on 7 April in New York City. More info

Quick Start Guide

The Basics

The following instructions should get you up and running with a basic workflow in the Dyalog development environment.

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 Session (REPL)

Videos: Overview of the Windows IDE or Overview of Ride.

When you start Dyalog, you are met with a blank area with a text cursor. This is the Session window. From here you can interact with the interpreter. Type APL expressions (usually indented by 6 spaces) and press Enter to see their results:

      2 + 3
5

Create, trace, edit and continue

Video: Editing and Debugging Dyalog APL

Type the name of your function and press Shift+Enter.

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.

Video: Useful (Keyboard) Shortcuts

Save your work

Choose a folder to save your work:

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

From now on, 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.

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. Use ]LINK.Create # /tmp/MyProject again (you can click on the line from before and press Enter) to resume working on the code you saved earlier.
Get Support

Technical advice and assistance on all aspects of Dyalog usage is available by e-mail (support@dyalog.com) and/or telephone (+44 1256 830030 – limited to U.K. office hours). Limited advice on design and coding is available, but is not intended to replace the use of the printed and on-line documentation. Except when reporting an issue with the software, users are encouraged to seek advice from the user community via the Dyalog Forum (reading the content of the forums does not require membership).

Search our website...