This release of the Maud program is available only as a downloadable standalone application. The Web Start application has been removed at the present. Maud need a Java Virtual Machine version 1.4 or higher.
step 1: get a Java Runtime Environment (Only for Windows users)
If no Java Runtime Environment has been installed so far in your computer, you can install one in a single step. The latest version of the JRE can be found on the website of Oracle at:
It is adviced to install a JVM 1.6 or higher. At the Javasoft Web site you will be asked to choose between a JRE or SDK version. The principal difference between the JRE and the JDK is that the first is only to run the Java programs (smaller) and the second contains also the tools to develop and compile Java code (bigger; not necessary for Maud).
For OSX: the new jdk 1.7 from Oracle has some glitches (loosing the window on focus or the main Menubar on top of the screen etc. To recuperate the main menubar click on another program or the desktop, then click back on the Maud main window). If you want to avoid this annoying bugs, avoid to install the 1.7 jdk (note: installing the jre 1.7 for the browser applet is fine, it concern only who install the Java jdk from Oracle). The "old 1.6" from Apple run just perfectly.
For Windows (all versions): sometimes java is installed but Maud does not run (using the Maud.bat). Try to run Maud.bat using the command prompt (cmd.exe, search internet on how to execute the cmd.exe on your windows version) and check the response. If the message is that java is not recognized, but you installed it, you have to add it to the path variable. Follow the instructions here. Otherwise if Maud starts but you have an error about memory resources, edit the Maud.bat and reduce the amount of memory assigned to the java process, the -mx switch. Attetntion that on Windows 8, if you installed java dowloading it from Internet Explorer in the desktop (not the one in the tiles) you will get 32bit version of java even if your system is 64bit. So you cannot run Maud allocating more than about 1700Mb of memory. Reinstall java downloading using the browser in the tiles screen (it is not the same under 64bit systems).
For Ubuntu: the default java virtual machine in Ubuntu is not sufficiently good (compliance) to run Maud.
You have to install the official one of Oracle:
- in the synaptic package manager enable software restricted by copyright or legal issues (multiverse) for ubuntu software and Canonical Partners under other software
- in the packages install the sun-java6-xxx, in principle you just need the sun-java6-jre
- *IMPORTANT* you need to specify that the sun-java6 is the default java, otherwise the openjdk of ubuntu will still be used for java. To do it, you can either remove the openjdk-6-jre and related packages (some people do this), or you can just specify to use the sun-java by typing in the terminal:
sudo update-alternatives --config java
then type your administrator password and the choose java-6-sun as the default java VM.
step 2: Download
If a suitable Java Runtime Environment is installed you can download one of the different packages of Maud (if your computer is not listed try the generic unix and edit in case the Maud.sh shell to match your computer java specifications):
step 3: Installation
To install the program for Windows and unix/Linux, you have to uncompress the file into your disk, it will create a Maud directory with inside all the files needed by Maud. Move the maud directory to the location you prefer to keep it. Then you can run the application using the supplied start scripts or batch file (Maud.sh or Maud.bat). We assume, that the Java Runtime Environment is detecting from the
JAVA_HOME environment variable. The start scripts use this environment variable to start Java. On all modern systems, except Windows, a JRE is already installed. On Windows to check if a JRE is available type "java -version" on a DOS window. If it return something with a version equals or higher than 1.5, than everything is ok and you can use directly the program. Otherwise see the step before.
For MacOSX uncompressing the downloaded file will mount an image with the application in it. Copy the Maud.app where you want to store the program. Then drag the application to the Dock for easy running.
step 4: Run & Help
Double click the Maud application to start it. On a unix system you have to go in the Maud directory and from the terminal type Maud.sh to start it (for first run check also the next section on further information). Note that in some cases you may need to type "./Maud.sh" if the "." path is not in the standard path. After Maud has started you can load some examples of analyses. Choose "open analysis" from the Maud menu and locate some of the analysis or parameter files (ending in .par) in the directory you have choosed to save the extracted files.
To find further information you can check the tutorial and video tutorials at the website Maud Tutorial. Also remember to check the online help from the menu in Maud and some of the windows have an help button that in some cases it works. A real manual is under preparation.
ATTENTION: when you start Maud for the first time, the first thing the program will do is to ask you where to save some files. These files are starting databases, configuration files, some examples and the same directory will be used also to store the preferences files. If accidentally the program is removed, but you keep this directory, you may start Maud again with a new fresh version from the Web. When it will ask for the directory where to save the files, you can still specify it the old one, or where you moved this configuration files directory and it will not overwrite the files already there keeping your old preferences. The gl4Java OpenGl native library is no more used, but Jogl instead. Jogl is already packed with the program (except for generic Unix and Solaris); in this last case you can download Jogl from the net and install it. The library is not fundamental for the program, but it will accelerate certain 3D outputs. If you decide to install it, you can find the latest version at Jogl, the jogl.jar library is already in the lib directory of Maud. so you need to install only the native library part.
Old users: You can keep all the preferences, files etc. by the following procedure: delete the old program (manually, if you have one of the latest versions where the installation was just unzipping a file) and in particular all the files except what there is inside the files directory (preferences.Maud, default.par etc.). When on the first run the program asks where to extract and save the files, choose this files directory (you can also change before its name and location if you wish). It will extract the new files but will not overwrite your old ones keeping everything as you had before.
Problems and errors
If you find something on the download/installation/running procedure wrong, a problem running Maud, a bug inside the program itself or you want to suggest a new feature you can check first the Forum and/or report the problem as a bug in the appropriate section to the Maud Bug Reporter. This will help to improve the program and enhance its features. If accessing that sections is not practical or you wish to deal directly with the author use the contact e-mail on the left column.