Editing Windows (section)

==Cygwin==

[[Image:cygwin-icon.gif|left|]] <tt>Madagascar</tt> can run under [http://cygwin.com Cygwin], which provides a Unix environment under Windows.

To obtain Cygwin, go to its web page, download and run the installer. This should create a Cygwin program, which when run, creates a POSIX shell window similar-looking to the Windows command window but which behaves in a more Unix-like way.

'''NOTE''': If you are unfamiliar with Unix-like systems, a good place to start is Greg Wilson's [http://www.osl.iu.edu/~lums/swc/www/shell.html Software Carpentry] course. 

You will need to install several additional Cygwin components before Madagascar can run. To get these, rerun the installer program (called '''Setup''' and represented by an icon with a black "C" shape enclosing a green arrow). 

# Start '''Setup''' program. 
# Keep clicking (defaults should work, but you can choose a mirror on your own continent) until you see a collapsed list (boxed "+" signs) in a selection box. 
# Choose the following before downloading.
## Open the '''Devel''' section and select
##* gcc-core
##* gcc-g++
##* gcc-gfortran
##* make
## If you want to use the development version of <tt>Madagascar</tt>, also choose one of the following:
##* subversion
##* git
## Open the '''Libs''' section and select
##* libtirpc-devel
##* libXaw-devel
##* libX11-devel
## If you have a favorite unix editor, choose it under '''Editors''' (novices may wish to work with Notepad for a while). Both <tt>vim</tt> and <tt>emacs</tt> are available.
## Open '''Interpreters''' and select
##* python
## For X-window  display with <tt>oglpen</tt>, open '''X11''' and select
##* libglut-devel
##* libGLU-devel
## If you intend to use LaTeX, open '''Publishing''' and select
##* texlive
##* texlive-collection-latexextra
##* texlive-collection-fontutils
## If you intend to use <tt>ppmpen</tt>, open '''Graphics''' and select
##* libnetpbm-devel
## If you intend to use <tt>tiffpen</tt>, open '''Libs''' and select
##* libtiff-devel
## If you intend to use <tt>gdpen</tt>, open '''Libs''' and select
##* libgd-devel
## For Xwin server installation, open '''X11''' and select
##* xinit
# Next, click '''Next>'''
#: Your download will proceed.
# When done, click '''Finish'''.

After performing this steps, proceed to a normal Madagascar [[Installation]].

For running X applications such as '''xtpen''', make sure to run '''startx''' first to open an X terminal window.

===Troubleshooting===

If you get errors "unable to remap...", note the following:

A proper work of a Cygwin installation may require running '''rebaseall''', a program that fixes library dependencies. You only need to run it once.
# Quit all Cygwin processes
# Start '''ash''' (<tt><cygroot>\bin\ash.exe</tt>)
# Execute <tt>/usr/bin/rebaseall</tt>

===Screenshots===

* Running Cygwin's '''setup''' program

[[Image:setup.png|600px]]

* Selecting packages

[[Image:select.png|600px]]

* Running Cygwin's '''bash''' program

[[Image:bash.png|600px]]

* Testing <tt>Madagascar</tt> installation

[[Image:test.png|600px]]

[[Image:welcome.png|600px]]
===Matlab API===
To use the Matlab API with Madagascar under Cygwin, make sure you have Mex installed, and create a symbolic link, i.e.:
<bash>
ln -s /location/of/mex.bat /usr/bin/mex 
</bash>