UploadBot: Restored page from Google Cache, uploaded by John Pye

2010-05-13T13:46:11Z

Restored page from Google Cache, uploaded by John Pye

New page

<div class="notice metadata" id="outdated" style="border:solid 2pt orange; width:70ex; background-color:#FFEEDD;padding:4px;margin-bottom:6px">''This article is '''outdated'''. You can help out by <span class="plainlinks">[http://ascendwiki.cheme.cmu.edu/index.php?title=Running_the_Python/PyGTK_GUI_on_Windows&action=edit updating it]</span>. ''</div><div class="floatright">[[Image:Windows-with-plot.png]]</div>

The PyGTK GUI for ASCEND also runs on Windows, although you will probably find the list of prerequisites a little irritating at this stage. This page outlines the steps required to get it running, at least until we work out a better way to package all the various dependencies etc.

Text here has been moved to [[Building ASCEND]].

== SCons ==

[http://www.scons.org SCons] is the preferred build tool for ASCEND, because of its ability to support non-POSIX compilers on Windows, as well as all the usual suspects on unixy systems.

Install SCons using the downloadable installer. Be sure to use [http://sourceforge.net/project/showfiles.php?group_id=30337 SCons-0.96.92] or later.

== Getting the ASCEND source code ==

I used [http://tortoisesvn.tigris.org TortoiseSVN] to get the source code from the repository. I set the location for the data to c:\msys\1.0\home\john\ascend

See [[VersionManagement]] for the details of what URL to use to access our repository.

[[Image:mingw-4.png]]

== Building ==

The PyGTK GUI requires a wrapper DLL (<tt>_ascpy.dll</tt>) to handling interfacing ASCEND with the Python language. It also requires the 'core' ASCEND DLL (<tt>ascend.dll</tt>) containing the compiler and solver engine. This latter is shared with the Tcl/Tk interface. To build these, we recommend using SCons via the MSYS command line (doubleclick the new, big, blue 'M' icon on your desktop).

First change to the directory where you put the sources, and set up your <tt>PATH</tt>:

* <tt>cd ~/ascend</tt>
* <tt>export PATH=/mingw/bin:/bin:/c/Program\ Files/GnuWin32/bin:/c/Python24:/c/Python24/Scripts:/c/GTK/bin:/e/swigwin-1.3.29/:/c/Tcl/bin/:${PATH}</tt>

Now, launch SCons:

* <tt>scons</tt>

This should build the complete PyGTK interface. If all goes well, this should result in a file <tt>ascend.dll</tt> in <tt>~/ascend</tt> and a file <tt>_ascpy.dll</tt> in <tt>~/ascend/pygtk</tt>.

== Runtime prerequisites ==

Please see [[Prerequisites for Windows]]. We are in the process of reorganising this content.

== Running ==

To run ASCEND, assuming you have installed all of the runtime prerequisites, you can use your MSYS commandline and type:

* <tt>cd ~/ascend/pygtk</tt>
* <tt>export ASC_DEV=1</tt>
* <tt>./ascend</tt>

Note that there are a number of [[Environment_variables_for_ASCEND|environment variables]] that affect how ASCEND runs.

Please let us know of any bugs with this under the 'pygtk-gui' section of the [[Debugging_ASCEND|bug tracker]].

In particular, it looks like some of the plotting functionality, incidence matrix, and 'diagnose' window are liable to crash. Normal solving seems fine. We are chasing these issues down with the GTK+ windows porters.

You may also experience different results depending on whether you run from the MSYS commandline as opposed to the Window 'cmd' console: under these two environment file paths are sometimes treated differently.

== Installing ==

There is a windows installer that can be created using the [http://nsis.sf.net/ NSIS] tool. Once NSIS is installed, follow the above instructions but replace the '<tt>scons</tt>' command with '<tt>scons installer</tt>'. The installer file <tt>ascend-NNNNN.exe</tt> should appear in the pygtk subdirectory. Here, <tt>NNNNN</tt> is a version number specified in the <tt>SConstruct</tt> file. The installer doesn't currently include the various prerequisites; these will need to be installed on your system before the installed version of ASCEND will sstart up correctly. We propose to add some logic to the installer warning about missing components, but this has yet to be done.

'''Note''': NSIS does '''not''' need to be in your path, because the NSIS Builder (<tt>scons/nsis.py</tt>) uses the Windows registry to locate <tt>makensis.exe</tt>. Only where the registry key cannot be found does the NSIS Builder look in your <tt>PATH</tt>.

See also [http://nsis.sourceforge.net/Docs/AppendixG.html] for info on how it should be possible to build the Windows installer from Linux

[[Category:Outdated]]
[[Category:Documentation]]

Running the Python/PyGTK GUI on Windows - Revision history

UploadBot: Restored page from Google Cache, uploaded by John Pye