Home >> Madeline 2.0 under Cygwin for Windows 32-bit OSes

Introduction

This page is now OUT OF DATE! Please see the new Download & Install page (2009.03.31) to check out the latest version from the code repository. Even though this page is out of date, you can still use it to experiment with Madeline 2.0 PDE. However the version of Madeline 2.0 PDE that you download here is not the latest version and may lack features present in more recent versions.

On this page you can download an experimental build of Madeline 2.0 PDE for Windows 32-bit operating systems like Windows XP.

The Cygwin environment is required. Cygwin is a Linux-like operating environment for Windows. To use Madeline 2.0 PDE on Windows, you need to first install Cygwin as described below.

To date (2008.10.11), we have tested this build of Madeline only on Windows XP, but it should also work on any 32-bit Windows platform supported by Cygwin.

Please note that this build is not for commercial use.

Step-by-step Instructions

1. Install Cygwin

Cygwin is a Linux-like environment for Windows. It consists of two parts: A DLL, cygwin1.dll, which acts as a Linux API emulation layer providing substantial Linux API functionality, and a collection of tools which provide a Linux look and feel.

Download the Cygwin installer from http://sources.redhat.com/cygwin/. The installer will guide you through a set of options. For the most part, just keep the default options presented by the installer.

When prompted to select software packages, under the Base tab be sure that the following package is selected for installation:

Under the Libs tab be sure that the following packages are selected for installation. Madeline will not run without these:

Under the Utils tab, be sure the following is selected for installation:

Default selections may be used for the rest of the Cygwin installation.

2. Download and Unpack the Madeline 2.0 PDE Package for Windows

Download and unpack the Madeline 2.0 PDE tar package from http://eyegene.ophthy.med.umich.edu/madeline/downloads/Madeline2_for_Cygwin_Win32.tar.gz or the zip package, http://eyegene.ophthy.med.umich.edu/madeline/downloads/Madeline2_for_Cygwin_Win32.zip.

Download TAR.GZ Package Now

Download ZIP Package Now

The easiest way to do this is to open a Cygwin terminal and enter the following commands:

$ wget http://eyegene.ophthy.med.umich.edu/madeline/downloads/Madeline2_for_Cygwin_Win32.tar.gz
$ tar xzvf Madeline2_for_Cygwin_Win32.tar.gz

3. Install Madeline

To make Madeline available within the default search $PATH, from within Cygwin move the executable to /usr/local/bin using the following command:

$ cd Madeline2_for_Cygwin_Win32
$ ls -l
$ mv madeline2.exe /usr/local/bin

4. Testing Madeline

You can now test Madeline by having the program retrieve a data file from the internet and draw a pedigree:

$ cd ~
$ madeline http://eyegene.ophthy.med.umich.edu/madeline/testdata/input/cs_001.data
...
Parser::readNetworkFile(): Opening network file http://eyegene.ophthy.med.umich.edu/madeline/testdata/input/cs_001.data ...
Parser::readFile(): Opening a(n) UTF-8 file ...
...
Pedigree output file is "cs_001ped.xml"
End of draw
$

You can view the resulting pedigree cs_001ped.xml in a web browser like Firefox or an SVG editor like Inkscape or Adobe Illustrator.

5. Troubleshooting Tips

If you encounter problems, run cygcheck to see which dynamic link libraries Madeline is using. The output should look something like this:

$ cygcheck ./madeline2.exe
.\madeline2.exe
  C:\cygwin\bin\cygwin1.dll
   C:\WINDOWS\system32\ADVAPI32.DLL
    C:\WINDOWS\system32\KERNEL32.dll
   C:\WINDOWS\system32\ntdll.dll
    C:\WINDOWS\system32\RPCRT4.dll
    C:\WINDOWS\system32\Secur32.dll
  C:\cygwin\bin\cygintl-8.dll
    C:\cygwin\bin\cygiconv-2.dll
  C:\cygwin\bin\cygcurl-4.dll
    C:\cygwin\bin\cygcrypto-0.9.8.dll
    C:\cygwin\bin\cygssh2-1.dll
    C:\cygwin\bin\cygz.dll
    C:\cygwin\bin\cygssl-0.9.8.dll
  C:\cygwin\bin\cygxml2-2.dll

If any dynamic link libraries (DLL's) are missing, you can try copying one or more DLL's from the dlls_used_by_madeline2 directory supplied with the package.

Problems with library version numbers are also possible. Try upgrading Cygwin to the latest version and installing the most recent versions of the required Libs.