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.

  1. Dymore is developed under code::blocks, an open source, cross platform, free C/C++ Integrated Development Environment (IDE). Please download and install code::blocks (current version: 17.12), and associate extension “.cbp” with execution of code::blocks. For linux users, a make file is also available.
  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.2), 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.1). 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.1 be the directory where wxWidgets 3.1.1 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”
    • Make sure that your environment variable “PATH” contains the following information: “C:\Program Files (x86)\CodeBlocks\MinGW\bin;” (This should be done automatically when you install code::blocks) and “C:\wxWidgets\lib\gcc_dll;” (You need to do this on your own).
  7. Two- and three-dimensional graphics capabilities use OpenGL, the Industry's Foundation for High Performance Graphics. This software is pre installed on most platforms.
  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.5.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.