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 Windows environment; for the Linux version, refer to this page.

  1. Dymore is developed under code::blocks, an open source, cross platform, free C/C++ Integrated Development Environment (IDE). Please download installer “codeblocks-20.03mingw-setup.exe” and install code::blocks. Associate extension “.cbp” with execution of code::blocks. Add the following environment variable in your “PATH”: “C:\Program Files\CodeBlocks\MinGW\bin;”.
  2. Results from Dymore are archived in the HDF5 format, a standard binary data format. Please download and install this library to compile and run Dymore. For windows users, the required HDF5 files are provided with the source code of Dymore for convenience.
  3. Dymore parallel capabilities use OPEN-MP and MPI. OPEN-MP is pre-installed on most platforms. To use MPI, please download and install the library. For windows users, an outdated version of MPICH library is provided with the source code of Dymore for convenience.
  4. Dymore is interfaced with MUMPS. If you want to use that capability, please download and install the library. For windows users, a outdated but working set of libraries are provided with the source code of Dymore for convenience. Notice that MUMPS is necessary for the modal reduction code, Herting.
  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). This is the only tricky step.
    • Please download WxWidgets.
    • Detailed information on how to compile this package is provided here. This is long: each compilation take about 20 minutes on my Intel i5 computer using a single thread, but is uneventful.
      1. Let c:\wxWidgets-3.1.3 be the directory where wxWidgets 3.1.3 was installed.
      2. Rename this directory as c:\wxWidgets.
      3. Open a window command tool and enter “cd c:\wxWidgets\build\msw”.
      4. Clean the release source. Enter “mingw32-make -f makefile.gcc SHARED=1 UNICODE=1 BUILD=release clean”.
      5. Compile the release library. Enter “mingw32-make -f makefile.gcc SHARED=1 UNICODE=1 BUILD=release”
      6. Clean the debug source. Enter “mingw32-make -f makefile.gcc SHARED=1 UNICODE=1 BUILD=debug clean”.
      7. Compile the debug library. Enter “mingw32-make -f makefile.gcc SHARED=1 UNICODE=1 BUILD=debug”
    • Add the following environment variable in your “PATH”: “C:\wxWidgets\lib\gcc_dll;”.
  7. Two- and three-dimensional graphics capabilities use FREEGLUT, an open source alternative to OpenGL. This software is provided with the source code of Dymore for convenience.
  8. Dymore input files are written in an hyper-marked type language. The syntax of the input can be highlighted automatically by using Notepad++, a free source code editor and Notepad replacement that supports several languages. This software is convenient to use, but is not required. Running in the MS Windows environment, its use is governed by GPL License.
    • Download Notepad++ (Current version: 7.8.6).
    • Put the attachment, userDefineLang_Dymore.xml, in directory C:\Users\%UserName%\AppData\Roaming\Notepad++\
    • To edit a Dymore input file, file.dym, right click on the file and choose “Edit with Notepad++”.
    • Dymore input file syntax should be highlighted beautifully. If not, open “language” in the menu bar and choose “Dymore” in the bottom of pull-down menu.

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.