Next Previous Contents

1. Installation

This assumes you have the July 2001 release (version 0.6 or later) of partiview, not the earlier "gview" release that was described in earlier versions of this document. We keep copies of some Linux support files (Mesa, FLTK) on our current http://www.astro.umd.edu/nemo/amnh website. Although more current versions of support libraries may be available, they may not have been tested out. Note that this current development release is only documented for work under Linux (redhat 6.2 and 7.1 have been tested), although we expect it to work for at least SGI and maybe Solaris too.

partiview needs two libaries to compile: OpenGL (or MESA) for the drawing operations, and FLTK for the window makeup.

1.1 MESA/OpenGL

First make sure Mesa is installed, for redhat6.2 there are rpm files available. Check if you have the following:


       % rpm -qa | grep Mesa
       Mesa-3.2-2
       Mesa-devel-3.2-2

       % rpm -i Mesa-3.2-2.i686.rpm Mesa-devel-3.2-2.i686.rpm

You should have both installed. Some packages will use libMesaGL, others libGL. The configure script (see below) should take care of the two possible options.

Homepage: http://mesa3d.sourceforge.org

Redhat packages: (part of powertools I believe)

Mesa3D is under continuous development. As of this writing the stable release is 3.4.2, but it has not been tested with the current partiview release. Redhat 7.1 comes with Mesa-3.4 and also works with partiview.

1.2 FLTK

Also make sure fltk is installed. If you got my version, do this (as root)


       % locate libfltk.a 
       % locate Fl_Slider.h

       % cd <where-ever>/fltk-1.0.9
       % make install
  

(you only need it if you want to recompile the program at some point, not if you just want to run it)

Homepage: http://www.fltk.org/

Redhat packages: http://www.cs.cornell.edu/nogin/RPM/fltk-devel.html

Find rpms: http://rpmfind.net

FLTK is under continuous development. As of this writing the latest release is 1.0.10, but has not been tested with the current partiview release.

1.3 partiview

Extract the tarball, and install the program from within the src directory:


       % tar zxf partiview-0.6.tar.gz

       % cd partiview-0.6/src
       % make clean                (if you really must compile a new executable)
       % ./configure               (GNU autoconf toolset to ease installation)
       % make depend               (might need to make new local dependancies)
       % make partiview            (should not have to edit Makefile anymore)

1.4 CVS

Since version 0.5 partiview is under CVS control, and occasionally we will stamp out a new release when we deem it stable. Anonymous or read-only CVS access is also offered. Currently the CVS repository machine is cvs.astro.umd.edu and you will need to setup your developers account with Peter (teuben@astro.umd.edu). Here's a sample session with some commonly used CVS commands:


 setenv CVSROOT   :pserver:myname@cvs.astro.umd.edu:/home/cvsroot
 setenv CVSEDITOR emacs
 setenv CVS_RSH   ssh           (not needed for pserver access though)

 cvs login                      (only needed once, and only for pserver type access)

 cvs checkout partiview              # get a new local sandbox to work in, or

 cvs -n -q update partiview          # check if others had made any changes
 cvs update partiview                # if so, update your sandbox and/or resolve conflicts

 cd partiview/src
 ./configure
 emacs partibrains.c                 # edit some files
 make all                            # compile the program
 ./partiview                         # test the program
 emacs kira_parti.cc                 # edit another file
 make all                            # check if it still compiles

 cvs -n -q update                    # check if anybody else made changes
 cvs update                          # if so, update your sandbox again, resolve conflicts

 cvs commit                          # and commit your changes


Next Previous Contents