1 |
johnpye |
438 |
BUILDING AND INSTALLING ASCEND |
2 |
aw0a |
1 |
|
3 |
johnpye |
438 |
Thanks for downloading ASCEND! We hope you'll find it straight- |
4 |
|
|
forward to set up and run ASCEND. If you have any comments on |
5 |
|
|
your experience with this, we're very keen to hear about that. |
6 |
|
|
Please check out the up-to-date contact details at: |
7 |
|
|
https://pse.cheme.cmu.edu/wiki/view/Ascend/WebHome |
8 |
johnpye |
146 |
|
9 |
johnpye |
438 |
There are older versions of this document, which include instructions |
10 |
|
|
on how to build ASCEND with GNU Autotools. This may or may not work |
11 |
|
|
with the version are currently looking at. |
12 |
|
|
https://pse.cheme.cmu.edu/svn-view/ascend/code/trunk/INSTALL?view=log |
13 |
johnpye |
146 |
|
14 |
johnpye |
438 |
----- |
15 |
|
|
BUILDING ON LINUX AND WINDOWS |
16 |
johnpye |
146 |
|
17 |
johnpye |
438 |
To build ASCEND we now recommend using SCons. This is supported |
18 |
|
|
both on Windows (using the MinGW toolset) and Linux. |
19 |
aw0a |
1 |
|
20 |
johnpye |
438 |
ASCEND provides two possible interfaces. The older, more mature |
21 |
|
|
GUI is based on Tcl/Tk. A newer interface that is more in keeping |
22 |
|
|
with modern GUI design is implemented using PyGTK, but it is still |
23 |
|
|
missing some functionality. |
24 |
aw0a |
1 |
|
25 |
johnpye |
438 |
Using SCons 0.96.91 or newer, see your build options by typing |
26 |
aw0a |
1 |
|
27 |
johnpye |
438 |
scons -Qh |
28 |
aw0a |
1 |
|
29 |
johnpye |
438 |
You can add your build options to a file in this directory |
30 |
|
|
which you can create, called 'config.py'. |
31 |
aw0a |
1 |
|
32 |
johnpye |
438 |
Then to build ASCEND, type |
33 |
aw0a |
1 |
|
34 |
johnpye |
438 |
scons |
35 |
aw0a |
1 |
|
36 |
johnpye |
438 |
SCons will tell you what version(s) of ASCEND it is able to build. |
37 |
|
|
The PyGTK interface requires Python (which is present if you have |
38 |
|
|
SCons). The Tcl/Tk interface requires that you have Tcl/Tk and |
39 |
|
|
TkTable installed on your system. |
40 |
aw0a |
1 |
|
41 |
johnpye |
438 |
For updates on this information, please check |
42 |
|
|
https://pse.cheme.cmu.edu/wiki/view/Ascend/BuildingAscend |
43 |
aw0a |
1 |
|
44 |
johnpye |
438 |
For specific information on building the Python interface and |
45 |
|
|
setting up the PyGTK GUI, please see |
46 |
|
|
https://pse.cheme.cmu.edu/wiki/view/Ascend/PythonWrapper |
47 |
aw0a |
1 |
|
48 |
johnpye |
438 |
------ |
49 |
|
|
INSTALLING ON LINUX |
50 |
aw0a |
1 |
|
51 |
johnpye |
438 |
To then install ASCEND, you will need to have write access to the |
52 |
|
|
directories INSTALL_DATA, INSTALL_BIN as specified in your |
53 |
|
|
SCons configuration. You can then type |
54 |
aw0a |
1 |
|
55 |
johnpye |
438 |
scons install |
56 |
aw0a |
1 |
|
57 |
johnpye |
438 |
------ |
58 |
|
|
INSTALLING ON WINDOWS |
59 |
aw0a |
1 |
|
60 |
johnpye |
438 |
More details to come here. For the PyGTK GUI, you can install |
61 |
|
|
ASCEND by running the 'create.nsi' script (using the NSIS |
62 |
|
|
installer-creator from http://nsis.sf.net/ which is free) |
63 |
|
|
then running the created installation package. |
64 |
aw0a |
1 |
|
65 |
johnpye |
438 |
------ |
66 |
|
|
CREATING AN RPM/DEB PACKAGE |
67 |
aw0a |
1 |
|
68 |
johnpye |
438 |
Many users prefer to keep their systems clear of unpackaged |
69 |
|
|
software. For this reason, we aim to provide the ability to build |
70 |
|
|
SCons as an RPM package. If you are in your home directory, type |
71 |
aw0a |
1 |
|
72 |
johnpye |
438 |
rpmbuild -ta ascend-NNNNN.tar.bz2 |
73 |
aw0a |
1 |
|
74 |
johnpye |
438 |
This will pull out the 'spec' from from the source package, |
75 |
|
|
which hopefully will be up to date in correspondance with the |
76 |
|
|
package version number NNNNN. |
77 |
aw0a |
1 |
|
78 |
johnpye |
438 |
You will then be able to install ASCEND using something like |
79 |
aw0a |
1 |
|
80 |
johnpye |
438 |
rpm -i ~/rpm/ascend-NNNNN-0.jdpipe.i386.rpm |
81 |
aw0a |
1 |
|
82 |
johnpye |
438 |
Debian/Unbuntu users should find that they can create a usable |
83 |
|
|
.deb package using the tool 'alien'. We haven't got native |
84 |
|
|
support for the generation of .deb packages at this stage. |
85 |
aw0a |
1 |
|
86 |
johnpye |
438 |
------ |
87 |
|
|
GETTING SUPPORT AND FURTHER INFORMATION |
88 |
aw0a |
1 |
|
89 |
johnpye |
438 |
For support with ASCEND, details of mailing lists and other |
90 |
|
|
useful information, please visit |
91 |
aw0a |
1 |
|
92 |
johnpye |
438 |
ASCEND user's website: |
93 |
|
|
http://ascend.cheme.cmu.edu/ |
94 |
aw0a |
1 |
|
95 |
johnpye |
438 |
ASCEND developer's wiki: |
96 |
|
|
https://pse.cheme.cmu.edu/wiki/view/Ascend/WebHome |