Tipsy
Tipsy is a research tool developed by the N-Body Shop.
The development of TIPSY was motivated by the need to quickly display and analyze the results of N-body simulations. Most data visualization packages are designed for the display of gridded data, and hence are unsuitable for use with particle data. Therefore, a special package was built that could easily perform the following functions:
- Display particle positions (as points), and velocities (as line segments) from an arbitrary viewpoint.
- Zoom in to a chosen position. Due to their extremely clustered nature, structure of interest in an N-body simulation is often so small that it can not be seen when looking at the simulation as a whole.
- Color particles to display scalar fields. Examples of such fields are potential energy, or for SPH particles, density and temperature.
- Selection of a subset of the particles for display and analysis. Regions of interest are generally small subsets of the simulation.
- Following selected particles from one timestep to another.
- Finding cumulative properties of a collection of particles. This usually involves just a sum over the particles.
To obtain TIPSY, get the tar file from our Anonymous ftp-site. The relevant tar file is /pub/hpcc/tipsy.tar.gz. The script in /pub/hpcc/unpackage_tipsy will extract the tar file. Also see /pub/hpcc/tipsy_tools.tar.Z for utilities that read and write the tipsy binary file format.
To build tipsy, change into the code directory, and type configure. This should create a Makefile appropriate for your system. Then type make to build the TIPSY binary. The man directory contains preliminary man pages for the TIPSY commands.
Most build problems have to do with finding the libraries on which Tipsy depends. Here are a couple of cases:
- When building the Tipsy binary it gives this error:
rldefs.h:46:23: termcap.h: No such file or directory
This indicates the termcap development libraries aren't installed. E.g., on a Redhat/Fedora system you will need to install the libtermcap-devel RPM to get the needed include file.
- When building the Tipsy binary, it gives this error:
readline/libreadline.a(readline.o): In function `_rl_set_screen_size':
/home/shen/tipsy-2.2.2/code/readline/readline.c:1261: undefined reference to `tgetnum'
Here the library libtermcap
can't be found. It may be in an unusual place, and you may need to add , e.g., -L /usr/lib64
to the LIBS definition in the Makefile to look for the library.
On Redhat/Fedora systems, the required packages include libX11-devel, libXt-devel, libXaw-devel, ncurses-devel
.
- On Ubuntu systems, the configure script may have problems finding the readline or the termcap libraries. In this case you will need to edit the Makefile by hand to change the tipsy dependency to:
tipsy: $(OBJS) $(ALLOCA) readline/libreadline.a
$(CC) -o tipsy $(LDFLAGS) $(OBJS) $(ALLOCA) $(X_LIBS) $(X_EXTRA_LIBS) $(LIBS) -lreadline -ltermcap
Just type tipsy
at the command line. A new display window is opened, but commands are typed in at the command line.
ChaNGa, by default, writes its output in a machine-independent <it>standard</it> format. In order for tipsy to read this, one needs to use the loads
or loadstandard
command, e.g.,
<yes, master>openb testpg_ms.000010
<yes, master>loads 1.0
<yes, master>zall
- Tipsy doesn't respond to mouse clicks: this can occur when the CapsLock or NumLock key has been toggled.
Yes. Tipsy needs more documentation. However, there are unix style tipsy man pages.
Tipsy can read particle data in ASCII files, the format of which is described in the man page for the readascii command.
Tipsy can also read particle data from a binary file. The format of this file is best determined by looking at the source code for the conversion tools.
ChaNGa is a publicly available N-body integrator that reads and writes the Tipsy binary format.
No.
Your "Numlock" or "Capslock" key may be set.