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