MFEM - Finite Element Discretization Library

Getting Started

15 minutes basic

Lesson Objectives

Setup a browser-based MFEM development environment.
Run a simple MFEM code to test the environment.

Note

You need an IP address to follow the steps described below.

If you are part of the HPC software tutorial series, you should have received an email with the AWS instance IP address allocated to you. Use that in place of IP in the instructions below.

If you are running a Docker container locally, as described in the Local Docker Container page, use localhost in place of IP in the instructions below.

If you setup your own cloud instance with the Docker container, you should use the cloud instance IP address.

Warning

If you use VPN, make sure to turn it off before following the instructions below.

Set up VS Code

Open a new browser window and load http://IP:3000.
You should see the Visual Studio Code (VS Code) interface.
Click on Mark Done to continue.

Click on open a folder (under Recent), then select mfem, then click OK.
In the left pane, open examples and select ex1.cpp.
Open a new terminal by clicking on in the upper left corner, then Terminal, and then New Terminal.
Alternatively you can open a new terminal by pressing Ctrl + Shift + `.
You should now see the MFEM source tree and a terminal in the ~/mfem directory.

Note

The browser window contains a fully functioning copy of Visual Studio Code. You can customize it further, and adjust it similarly to the desktop version.

Set up GLVis

In this tutorial we use GLVis for finite element visualization based on MFEM.

Open a new browser window and load http://IP:8000/live.
When you move the mouse to the top of the window you should see the GLVis interface:

Click on the Connect to socket icon in the upper left corner, then click CONNECT.

Note

The Host field in the Connect to socket dialog should match your IP.

When the button switches to DISCONNECT, click outside of the Connect to socket dialog to close it.
Your environment should now look like:

Simple test

To test your environment, run ex1, which together with the MFEM library itself, comes pre-build in the AWS image.
In the VS Code terminal, type
```
cd examples
./ex1
```
You should see 111 iterations printed in the terminal and the image in the GLVis window should change:

To test the visualization, click in the GLVis window, and make sure you can rotate the plot with the Left mouse button and zoom in/out with the Right mouse button.

Questions?

Ask for help in the tutorial Slack channel.

Next Steps

Go to the Finite Element Basics page.

Back to the MFEM tutorial page