Running an Idealised Workflow#

Once your suite has been set up, you can run it using Cylc:

cylc vip

See also

For help choosing the correct Monsoon3 service and finding the official setup guidance, see Using Monsoon3.

cylc vip

Warning

“Other” means your own machine, or a system run by another institution (see Choosing your platform). This step cannot be completed there without local equivalents of the Met Office services it depends on: a supported LFRic build environment, repository access, shared ancillary data, and an HPC batch queue. The commands below are given so you can follow along and adapt them to your site, not because they will work unchanged.

cylc vip

cylc vip is short for cylc validate-install-play, and performs three actions:

  • Validate: Checks the suite configuration for errors

  • Install: Sets up the runtime environment

  • Play: Starts executing the workflow

Note

Unlike the global and regional suites, the idealised suite selects its platform from the EX_HOST template variable you set in the Rose GUI, so no --opt-conf-key is needed here.

Monitor the workflow#

Once the suite is running, you can monitor its progress using either of the following commands:

Running graphical applications over SSH

If you are connected to a remote system over SSH, graphical applications need X11 forwarding to display on your computer. Start an X server on your computer first (for example, XQuartz on macOS), then connect from a terminal using generic host details supplied by your service:

ssh -AY <remote-host>

Repeat the options for every additional SSH hop. The -Y option enables trusted X11 forwarding. The -A option forwards your SSH authentication agent and should only be used with systems you trust. A terminal integrated into an editor such as VS Code works in the same way as any other terminal.

On the system where you will start the graphical application, run echo "$DISPLAY". It should return a value. If it is blank, disconnect and reconnect with X11 forwarding enabled at every hop before continuing.

cylc gui
# or, if you prefer the terminal interface
cylc tui

See also

For help choosing the correct Monsoon3 service and finding the official setup guidance, see Using Monsoon3.

cylc tui

Note

Use cylc tui on Monsoon3. cylc gui needs a browser or an X11 connection that is not available from every Monsoon3 service.

Note

“Other” means your own machine, or a system run by another institution. You provide the environment yourself. See Choosing your platform.

cylc gui
# or, if a graphical interface is not available
cylc tui

Both interfaces show nearly identical information, so the choice is largely personal preference:

  • cylc gui — easier to interact with, but needs a browser or an X11 connection.

  • cylc tui — lightweight and works in any terminal without X11.

These tools allow you to view task status, progress, and any failures.

For more details on Cylc commands, see Running a Cylc Workflow under Exercises in Global Configurations.

After the workflow has completed successfully, navigate to the output directory and try plotting the data.