Required software

Dymore uses freely available, cross-platform, compilers, graphical user interface, and graphical packages only. The following tools are necessary to help install and execute the code. This page focuses on their installation in a Linux environment; for the Windows version, refer to this page.

In this page the lines starting with “$” refer to commands to be run in the Linux terminal.

  1. Dymore is developed under code::blocks, an open source, cross platform, free C/C++ Integrated Development Environment (IDE). Please download “codeblocks_20.03_amd64_stable.tar.xz”, extract the archive and install code::blocks (using “codeblocks_20.03_amd64.deb” if on Debian-based system).
  2. Results from Dymore are archived in the HDF5 format, a standard binary data format. To download and install this library, you can refer to the following procedure:
    1. Download “hdf5-1.12.0-linux-centos7-x86_64-shared-production.tar.gz”
    2. Extract downloaded files (assumed in ~/Downloads)
    3. Move libraries to /usr/local/ (from terminal):
      • $ cd ~/Downloads/hdf5-1.12.0-linux-centos7-x86_64-shared-production/hdf5-1.12.0-linux-centos7-x86_64-shared
      • $ sudo cp -avr lib/. /usr/local/lib
      • $ sudo mkdir /usr/local/include/hdf5
      • $ sudo cp -avr include/. /usr/local/include/hdf5
      • $ sudo ldconfig
  3. Dymore parallel capabilities use OPEN-MP and MPI.
    • OPEN-MP is pre-installed on most platforms. In Linux its installation can be checked via terminal with: “$ echo |cpp -fopenmp -dM |grep -i open”. If necessary it can be installed using: “$ sudo apt install libomp-dev”.
    • MPI can be installed on Linux system via terminal with: “$ sudo apt-get install libcr-dev mpich2 mpich2-doc”.
  4. Dymore is interfaced with MUMPS. If you want to use that capability, please download and install the library. Notice that MUMPS is mandatory only for the modal reduction code. The procedure for installing MUMPS in Linux is the following:
    1. Install dependencies (from terminal):
      • $ sudo apt install libscalapack-openmpi-dev
      • $ sudo apt install libscalapack-mpich-dev
      • $ sudo apt install libscalapack-mpi-dev
    2. Download MUMPS 5.1.2
    3. Extract downloaded files (assumed in ~/Downloads)
    4. Compile libraries (from terminal):
      • $ cd ~/Downloads/MUMPS_5.1.2
      • $ cp Make.inc/Makefile.debian.PAR ./Makefile.inc
      • $ sudo make d
      • $ sudo make z
      • $ cp Make.inc/Makefile.debian.SEQ ./Makefile.inc
      • $ sudo make all
      • $ sudo ldconfig
    5. Move files to /usr/local/ (from terminal):
      • $ sudo cp -avr include/. /usr/local/include/MUMPS
      • $ sudo cp -avr lib/. /usr/local/lib
      • $ sudo cp -avr libseq/. /usr/local/lib
  5. Dymore plotting capabilities use gnuplot (current version: 5.2.8), a portable command-line driven graphing utility for Linux, OS/2, MS Windows, OSX, VMS, and many other platforms. Please download and install gnuplot, and associate extension “.plt” with execution of gnuplot.
  6. Dymore graphical post-processor, called DymViz, uses the Graphical User Interface provided by WxWidgets (current version: 3.1.3). On Linux, pre-compiled libraries can be installed using the following procedure. This steps were tested on Ubuntu 20.04 “Focal Fossa”. For other versions of Linux it may be necessary to change the repository used.
    • $ sudo apt-key adv --fetch-keys https://repos.codelite.org/CodeLite.asc
    • $ sudo apt-add-repository 'deb https://repos.codelite.org/wx3.1.3/ubuntu/ focal universe'
    • $ sudo apt-get update
    • $ sudo apt-get install libwxbase3.1-0-unofficial libwxbase3.1-dev libwxgtk3.1-0-unofficial libwxgtk3.1-dev
    • $ sudo apt-get install wx3.1-headers wx-common wx3.1-i18n wx3.1-examples
    • $ sudo apt-get install libwxgtk-webview3.1-0-unofficial libwxgtk-webview3.1-dev
    • $ sudo apt-get install libwxgtk-media3.1-0-unofficial libwxgtk-media3.1-dev
    • $ sudo apt-get install libwxbase3.1-0-unofficial-dbg libwxgtk3.1-0-unofficial-dbg
    • $ sudo apt-get install libwxgtk-webview3.1-0-unofficial-dbg libwxgtk-media3.1-0-unofficial-dbg
  7. Two- and three-dimensional graphics capabilities use FREEGLUT, an open source alternative to OpenGL. On Linux systems, they can be installed from terminal using “$ sudo apt-get install freeglut3”, if not installed already.

Directory structure

A typical installation of the code features several sub-directories.

The following file types are used for input files.

The following file types are used as output files.