Dyad Studio

Dyad Studio is a VSCode extension for the Dyad language.

Dyad is our next-generation platform for model-based design. Using modern scientific machine learning (SciML) techniques and equation-based digital twin modeling and simulation, Dyad encompasses block diagrams, acausal modeling, and a differentiable programming language all within a single environment. Dyad also gives you access to the Julia language and its large scientific and numerical ecosystem while leveraging the power of our native Julia linear, non-linear and differential equation solvers as well as symbolic manipulation capabilities all optimized and compiled for the users target hardware.

The Dyad Studio extension allows users to create and develop Dyad libraries and then compile them to Julia code. To run the Julia code, you will need the Julia programming language installed on your computer, and you will need to authenticate with a JuliaHub account to download the proprietary Dyad software.

Requirements

You will need to perform some local setup before you can use Dyad Studio locally:

• Create a JuliaHub account (sign up here)
• Install the Julia programming language (see instructions here)
• Install the Dyad Studio extension in VSCode. This will also install the JuliaHub and Julia language extensions automatically, which Dyad Studio requires.

Quick start

• To create a new Dyad project, start VSCode and open the command palette using Shift+^+P (Shift+⌘+P on Mac, Ctrl-Shift-P on Windows)
• Type in “Dyad” and select Dyad: Create Component Library
• You will be prompted for the name of the library. This must be all letters, no spaces.
• Select the directory where the Dyad library's source should be stored. This will create a new directory with the same name as the library.
• This process will create a full, working Dyad library in the selected directory, including a working Hello component. and a World analysis.
• Whenever you save a .dyad file, Dyad will automatically regenerate the Julia code backing it. You can force this regeneration by running the Dyad: Compile command.
• Open the JuliaHub extension, which will ask you to open a link to authenticate yourself with JuliaHub. Once you have authenticated with JuliaHub, that authentication will persist in all REPL sessions that are launched from the Julia: Start REPL command in VSCode.

To load and run your component library in Julia, simply open a REPL via the Julia extension's "Start REPL" command. Then, your component library's environment will be automatically activated. You may need to download packages by typing ]instantiate in the REPL, and from there you can simply load the component library via using MyComponents (or whichever name you assigned the library). On loading the library, all pre-defined analyses (like World() from the World analysis) should be available to you.

Features

Seamless Integration with Julia

All Dyad code in .dyad files is compiled to readable Julia code, which is accessible in the Julia package that is created by your Dyad project. This means that you can use the full Julia ecosystem to analyze, modify and improve your models, directly from the Julia REPL in VSCode.