MATLAB Quick Start

Compute Resources

Docker Usage

What’s Included

  • GPU compute capability

  • noVNC for GUI display

  • GStreamer

  • FFmpeg

  • MATLAB installation not included in image. Location to be mounted at runtime due to size.

  • Current MATLAB Version: 2022a (Used to replace <version> in the commands below.)

Quick Start

If you are a member of more than one compute group, you will be prompted to specify an LSF User Group with -G group_name or by setting the LSB_SUB_USER_GROUP variable.

Interactive Command-Line Session

  • If you wish to use MATLAB in an interactive command-line session, you can do so with the following commands.

PATH=/scratch1/fs1/ris/application/matlab/<version>/bin/:$PATH \
LSF_DOCKER_VOLUMES="/scratch1/fs1/ris/application/:/scratch1/fs1/ris/application/" \
bsub -Is -q general-interactive -a 'docker(gcr.io/ris-registry-shared/matlab)' /bin/bash

Interactive GUI Session

  • If you wish to use MATLAB in an interactive GUI session, you can do so with the following commands.

Complete export PASSWORD= with that of your choosing. Do not leave this blank.

export PASSWORD=

LSF_DOCKER_PORTS='8080:8080' \
PATH=/scratch1/fs1/ris/application/matlab/<version>/bin/:$PATH \
LSF_DOCKER_VOLUMES="/scratch1/fs1/ris/application/:/scratch1/fs1/ris/application/" \
bsub -Is -q general-interactive -R 'select[port8080=1]' -a 'docker(gcr.io/ris-registry-shared/matlab)' supervisord -c /app/supervisord.conf
  • Please see our documentation for more information on selecting a port.

  • Since LSF is running interactively it will output the name of the host it’s running on in the terminal.

  • The host will be the IP address needed to access the VNC.

  • For example: <<Starting on compute1-exec-187.ris.wustl.edu>> translates to the IP being https://compute1-exec-187.compute.ris.wustl.edu:8080/vnc.html

  • The password will be what was set above with the export PASSWORD= command.

  • Once connected you can open MatLab by entering matlab into the GUI terminal.

GPU Utilization

  • To be able to utilize GPUs within Matlab, you will need to start the job using the following command.

  • Note that everything beyond the startup command will interact the same.

export PASSWORD=

LSF_DOCKER_PORTS='8080:8080' \
PATH=/scratch1/fs1/ris/application/matlab/<version>/bin/:$PATH \
LSF_DOCKER_VOLUMES="/scratch1/fs1/ris/application/:/scratch1/fs1/ris/application/" \
bsub -Is -q general-interactive -R 'select[gpuhost,port8080=1]' -gpu "num=1:gmodel=TeslaV100_SXM2_32GB:j_exclusive=yes" -a 'docker(gcr.io/ris-registry-shared/matlab)' supervisord -c /app/supervisord.conf

GUI Session Variables

  • You can change the GUI display size by clicking on the settings icon on the left of the browser and selecting ‘Local Scaling’ from the Scaling Mode dropdown. Click the settings icon again to resume session.

  • The display height and width can also be changed by passing them as variables.

export DISPLAY_WIDTH=<width> (default is 1024)
export DISPLAY_HEIGHT=<height> (default is 768)

Earlier Versions

These are previous versions of Matlab that are still available but no longer directly supported. Please refer to the latest version if you would like direct support.

  • Standalone Matlab Images:
    • 2022a: us.gcr.io/ris-appeng-shared-dev/matlab2022a

    • 2021a: us.gcr.io/ris-appeng-shared-dev/matlab2021a

    • 2020b: us.gcr.io/ris-appeng-shared-dev/matlab2020b