MCTDH on Cygwin

Since the MCTDH program and utilities rely heavily on UNIX semantics, it is currently not possible to install MCTDH natively on the family of MS Windows operating systems. The only supported method for running MCTDH on Windows is using Cygwin which provides a complete GNU/Linux-like environment on top of Windows. Cygwin is free and open source.

Installing Cygwin

To install Cygwin, download and run the setup.exe from the Cygwin homepage. The setup will offer you a selection of packages which can be downloaded and installed. The initial selection contains only the most basic packages. For MCTDH, you will need to select some additional packages for installation. See below. (Selecting a package automatically selects all its dependencies too.)

Installation options

The setup will first ask for some general installation options, where you should take note of the following issues:

• When asked for the "Default Text File Type", choose "UNIX/binary" (this is also the default).
• Cygwin does not need administrator rights for installation. However, for non-administrators it is quite likely that the only choice for the installation path will reside in the "My Documents" folder. In this case Cygwin will warn you that the pathname contains spaces. It is safe to proceed anyway; in our tests the installed MCTDH worked correctly despite the spaces in the installation path.

Package Selection

The additional packages for MCTDH are:

• From section "Devel": gcc-g77 and make.
  These are required for compiling MCTDH!
• From section "Editors": One of vim, emacs, nano, joe, ...
  It is highly recommended to have at least one text editor.
• From section "Graphics": gnuplot.
  This is not strictly required, but highly recommended because most analyse routines use gnuplot. (Selecting this package automatically pulls in the X11 server and libraries, so this increases the download size considerably.)
• From section "Graphics": gv, and from section "Text": tetex-base, tetex-extra.
  These are optional and are only necessary to compile and view the part of the documentation that comes in PostScript format.

These packages together amount to a total download size of ~120MB (of which ~50MB are for gnuplot+X11 and ~40MB for tetex) and to an installed size of ~370MB.

Running Cygwin

Simply click on the Cygwin icon which the install process created on your desktop. This will provide you with a bash shell where you can work just like in any Unix-like environment.

If you also want to start X applications (which is e.g. necessary to run gnuplot from the analyse routines), you should issue the command "startx" from the Cygwin shell. This will start the X server and one xterm. Proceed by continuing your work inside the xterm window.

Installing MCTDH

Once you have the Cygwin environment running, unpack the MCTDH source code in (e.g.) your home directory and continue with the regular MCTDH installation process.

If you chose not to install the tetex packages, then during the installation process you must answer "no" to the question on whether the documentation should be compiled. Otherwise you will get error messages.