Editing Windows

<tt>Madagascar</tt> has been run on Microsoft Windows machines under various types of environments:

==Windows Subsystem for Linux==

Windows Subsystem for Linux (WSL) is a compatibility layer (available on on Windows 10 and Windows 11) that allows Linux applications to run natively under Windows.

To install Ubuntu Linux using WSL, follow https://ubuntu.com/wsl , then [[Advanced_Installation#Ubuntu|follow instructions]] for installing Madagascar under Ubuntu.

==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>

==Interix (outdated) ==
[http://en.wikipedia.org/wiki/Interix Interix] is the name of the Unix environment for Windows provided by Microsoft through the following software packages:
* [http://en.wikipedia.org/wiki/Microsoft_Windows_Services_for_UNIX Services For Unix] (SFU), available as a [http://www.microsoft.com/downloads/details.aspx?FamilyID=896c9688-601b-44f1-81a4-02878ff11778&DisplayLang=en free download] for the Windows NT family of operating systems up to and including Windows XP Professional ([http://www.reproducibility.org/rsflog/uploads/PS0001.jpg screenshot of m8r running on SFU] from an [http://www.reproducibility.org/rsflog/index.php?/archives/68-RSFMadagascar-on-Windows-using-SFU.html April 2006 entry on the m8r blog]). SFU availability was discontinued in 2009.
* [http://technet.microsoft.com/en-us/library/cc779522.aspx Subsystem for UNIX-based Applications] (SUA), included with Windows Server 2003 R2 and Windows Vista.

==SSH + X server==
If you can count on a network connection to a full UNIX machine while you run Madagascar, you actually need to install under MS Windows just a SSH client and a X server, and just run the Madagascar installed on the UNIX machine. Cygwin provides both, but it is big and slow. Faster and more lightweight alternatives are:
* [http://mobaxterm.mobatek.net/en/ MobaXterm], an enhanced terminal with an X server and a set of Unix commands (GNU/Cygwin) packaged in a single portable exe file;
* [http://sourceforge.net/projects/xming/ Xming] as X server and [http://en.wikipedia.org/wiki/PuTTY PuTTY] as SSH client (remember to check the "Tunnel X11 connections" box when saving the session configuration).