Installing s2plot for Mac OS X running Leopard:
-----------------------------------------------------------------------------
There are instructions online and in the INSTALL.TXT and ENVIRONMENT.TXT files,
as well as online. This is documentation specifically for Mac Laptops running Leopard.
Note that the full list of supported architectures is available at
http://astronomy.swin.edu.au/s2plot/index.php?title=S2PLOT:Installation
1) Install XCODE for compiling.
2) s2plot
a) Install
b) Configure
c) Test
d) Implement
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
1) Install XCODE: This has the compilers, etc. used by the s2plot scripts.
a) Using Mac Install Disc 2, in the XCODE folder click on Xcode Tools.mpkg and use the
wizard. It will install in the /Developer directory.
Alternatively grab XCODE off of web - takes 2 hours to download and is 1 GB.
b) Reboot your computer so that the gcc compiler will be put into the /usr/bin/ directory.
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
2) S2PLOT
2a) Install S2PLOT:
--Download the tar file for the full release from
http://astronomy.swin.edu.au/s2plot/index.php?title=S2PLOT:Download
-- Bunzip by clicking s2plot-all-2.4-2008-09-29.tar.bz2 in a Finder window.
-- Move the resulting s2plot-2.4. directory to /usr/local/
-- Open up the permissions
chmod -R 777 s2plot-2.4
2b) Configure S2PLOT:
-- Check that s2plot-2.4/s2plot.csh has S2X11PATH which points to /usr/X11R6
-- Set environmental variables in a dot rc file.
- check the kind of shell you are running by typing "ps". It will be
listed. The following instructions assume that bash is running.
- make a .bashrc file with the following:
# s2plot settings
export S2PATH="/usr/local/s2plot-2.4"
export S2ARCH="darwin-gnu-i386"
export PATH="${PATH}:${S2PATH}:${S2PATH}/${S2ARCH}"
export S2TEXPATH="${S2PATH}/textures"
export S2PLOT_LATEXBIN="/usr/texbin"
export S2PLOT_DVIPNGBIN="/usr/texbin"
export DYLD_LIBRARY_PATH="${DYLD_LIBRARY_PATH}:${S2PATH}/${S2ARCH}"
export LD_LIBRARY_PATH="${LD_LIBRARY_PATH}:${S2PATH}/${S2ARCH}"
export C_INCLUDE_PATH="${C_INCLUDE_PATH}:${S2PATH}"
export CPLUS_INCLUDE_PATH="${CPLUS_INCLUDE_PATH}:${S2PATH}"
export PATH="${PATH}:${S2PATH}:${S2PATH}/${S2ARCH}"
-- to source these variables type
. .bashrc
Note that the S2PLOT_LATEXBIN and S2PLOT_DVIPNGBIN environment variables
assume that you have a working installation of LaTeX and the dvipng program,
which is available from http://sourceforge.net/projects/dvipng/
These packages are *only* required for two S2PLOT functions:
ss2ltt - Create a texture with LATEX commands.
If you wish to use Freetype fonts for creating texture-mapped labels via
function:
ss2ftt - Use a named freetype font to create a texture map
will also need to set:
export S2FREETYPE="yes"
2c) Testing that the installation and configurations have worked:
Test that you can run the programs from a terminal (do not use the Apple Finder
or other file managers).
-- Change to directory for s2plot-2.4
cd $S2PATH
-- The test programs haven't been compiled yet. To do this type
build-functions.csh
which puts them in the darwin-gnu-i386 dir which can be called with
$S2PATH/$S2ARCH
-- move to the directory with the functions
cd $S2PATH/$S2ARCH
-- Select any name at random and type it's name to run.
At the graphics device prompt it best to select /S2MONO.
2d) Implement S2PLOT functions.
-- Make a directory in your home area in which you want to store the functions
(e.g. s2plotfn).
-- Copy the functions over to this directory and compile them. Example:
Copy s2opend.c from the directory ${S2PATH}/functions to ~/s2plotfn
directory. Compile with
cbuild.csh s2opend
This builds an executable binary called "s2opend"
-- To run the executable you then just type the name.
F1 toggles on info about what you can do.
Shift-ESC or Shift-Q to quit.
-- A full list of keypresses and mouse controls is available at
http://astronomy.swin.edu.au/s2plot/index.php?title=S2PLOT:Controls
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
