Window To The Stars ******************* Automatical Installation ************************ First, try to install automatically. This will require Perl, GTK, and the Intel compiler (ifort) to be installed. If you do not have all the Perl modules installed you will need to install the following packages on your system (e.g. with yum, apt, synaptic... whatever) glib2-devel Gtk2-devel and please try to install the following Perl modules as native packages *before* you try the installation script, it will make my life so much easier! :) 1 ExtUtils::PkgConfig e.g. from http://search.cpan.org/CPAN/authors/id/R/RM/RMCFARLA/Gtk2-Perl/ExtUtils-PkgConfig-1.07.tar.gz 2 ExtUtils::Depends e.g. from http://search.cpan.org/CPAN/authors/id/R/RM/RMCFARLA/Gtk2-Perl/ExtUtils-Depends-0.205.tar.gz 3 Glib e.g. from http://search.cpan.org/CPAN/authors/id/T/TS/TSCH/Glib-1.120.tar.gz 4 Gtk2 e.g. from http://search.cpan.org/CPAN/authors/id/T/TS/TSCH/Gtk2-1.122.tar.gz 5 Gtk2::Gdk::Keysyms e.g. from http://search.cpan.org/CPAN/authors/id/T/TS/TSCH/Gtk2-1.122.tar.gz 6 File::Tail e.g. from http://search.cpan.org/CPAN/authors/id/M/MG/MGRABNAR/File-Tail-0.99.3.tar.gz 7 File::Copy e.g. from 8 File::Basename e.g. from 9 Compress::Zlib e.g. from http://www.cpan.org/modules/by-module/Compress/Compress-Zlib-1.14.tar.gz 10 File::Which e.g. from http://search.cpan.org/CPAN/authors/id/P/PE/PEREINAR/File-Which-0.05.tar.gz 11 Archive::Zip e.g. from http://search.cpan.org/CPAN/authors/id/A/AD/ADAMK/Archive-Zip-1.18.tar.gz Download the automatic installer (called, oddly, "installer") from the web page, then run: chmod 755 ./installer ./installer This will download all the necessary files from the Window To The Stars website, and then (try to) build/install them. You must choose both a binary executable directory (usually $HOME/bin) and a directory for Window To The Stars (usually $HOME/wtts). Once installed you can just exectuate the command 'wtts' Note: I am starting to make binary executables (in the bin/ directory at the WTTS website) which require no perl module download/installation. They do, however, require TWIN to be installed, but you can do this with the separate TWIN.zip file. If you are NOT using ifort (e.g. if you have a Mac) then please follow the instructions below for manual install (haha!). Manual Installation guide (for V0.09 upward) ******************************************** You require: GTK (2.4 at least), Perl, Perl-GTK2, the Perl File module (for Tail, Copy, and Basename) and the stuff in the downloads directory, gnuplot (4.0), Image Magick (for animation saving via convert), (Gnu?) sed, ghostscript. I have these packages (and their dependencies) installed (Redhat Enterprise Linux 4.0) with updates from http://atrpms.net (see the end of this file for details) perl-5.8.5-24 perl-Gtk2-1.102-1.2 perl-File-Tail-0.99.3-1.2 gnuplot-4.0.0-4 ImageMagick-6.2.2.0-3 sed-4.1.2-4 ghostscript-7.07-33 NB Redhat/Fedora's gnuplot is crippled, as it cannot handle PNGs properly. Use the postscript images instead of PNG. Follow these instructions for immediate gratification: 0) Install the following Perl modules perl-Glib perl-Gtk2 preferably versions 1.120 and 1.121 respectively, also perl-File-Tail (make sure this is AT LEAST 0.99.3, earlier are buggy) You can get these from CPAN (www.cpan.org) ... Evert had to install the following perl modules from CPAN on his machine: ExtUtils-Depends-0.205 ExtUtils-PkgConfig-1.07 File-Tail-0.99.3 Glib-1.102 Gtk2-1.102 You should get the LATEST versions of these (esp. File-Tail!). 1) Get Evert's STARS package (TWIN.zip), unzip it in some directory (say ~/stars). I am not responsbile for this package! :) But it does have some necessary files (notably "wrong.png", "noimage.png" and "variable_help") Follow the instructions in README to build TWIN. 2) Get the STARS_perl_module.zip and rob_misc_perl_module.zip, make two directories (stars_perl and rob_misc_perl), copy the zip files to their respective directories, unzip them, then do the usual Perl module install: perl Makefile.PL make (as root) make install If you don't have root access, try reading the section below "Installing perl modules locally". 3) Copy stars.perlscript to ~/stars and rename it to stars.pl (I had to change the extension because the web server didn't like it... but you can change it back). You may have to do a "chmod 744 stars.pl" (or similar) to make it executable. 4) Run stars.pl - it should just work! If not, check the location of Perl is /usr/bin/perl (if it's not, edit the first line of stars.pl to match your Perl executable location). If you cannot make it work, try running "stars.pl vb=1" to turn on verbose mode and let me know what it says. To change the prefix of stellar evolution files from 'window_to_the_stars' to something else, edit $runname in the script (or use "stars.pl runname=..."). Cached files are stored in /tmp/window_to_the_stars, so make sure /tmp exists (and is a local disk, otherwise everything will be slow). I have never used a system without /tmp/, even my ipod has it..! A config file (~/.window_to_the_stars) will be put in your home directory, this just stores the Misc tab settings and is quite harmless. Note the bugs file! Changes are in CHANGES (look here for hints if something breaks, it might be something I fixed recently but is not really fixed). Rob Izzard, 25/12/2005 (merry christmas!) Updated 26/01/2006 (V0.04), 03/03/2006 (V0.07), 30/04/2006 (V0.09) ************************************************************ Installing perl modules locally ******************************* In .bashrc I have this: # rob's perl libraries export PERL5LIB=$HOME/lib/perl/lib/perl5/site_perl/5.8.5 which is my local perl directory (I have a lib, etc, etc. in my home directory for local installs, you just need to create the directory structure - note that 5.8.5 is my perl version) then, in my install script I have PREFIX=$HOME/lib/perl cd perl Makefile.PL PREFIX=$PREFIX which installs in the correct place (same as PERL5LIB) - things might go wrong with a new Perl version, but nothing a few softlinks or quick rebuilds won't fix.