<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
<TITLE> Partiview (PC-VirDir): Running the program</TITLE>
<LINK HREF="partiview-4.html" REL=next>
<LINK HREF="partiview-2.html" REL=previous>
<LINK HREF="partiview.html#toc3" REL=contents>
</HEAD>
<BODY>
<A HREF="partiview-4.html">Next</A>
<A HREF="partiview-2.html">Previous</A>
<A HREF="partiview.html#toc3">Contents</A>
<HR>
<H2><A NAME="s3">3. Running the program</A></H2>
<P>First we describe a simple example how to run <CODE>partiview</CODE> with a supplied sample
dataset. Then we describe the different windows that <CODE>partiview</CODE> is made up of, and
the different commands and keystrokes it listens to.
<P>
<H2><A NAME="ss3.1">3.1 Simple example: Hipparcos Bright Star Catalogue</A>
</H2>
<P>
<P>Now start the program using one of the sample "speck" files in the
<CODE>data</CODE> directory:
<P>
<BLOCKQUOTE><CODE>
<HR>
<PRE>
% cd partiview-0.2/src
% ./hipbright
</PRE>
<HR>
</CODE></BLOCKQUOTE>
<P>and this will come up with a display. You should probably enlarge the
window a bit. Mine comes up in roughly a 300 by 300 display window,
which may be a bit small (certainly on my screen :-)
<P>
<P>hit the TAB key to bring focus to the one line command window inbetween
the log screen (top) and viewing screen (bottom). Type the commands
<P>
<BLOCKQUOTE><CODE>
<HR>
<PRE>
fov 50 (field of view 50 degrees)
jump 0 0 0 80 70 60 (put yourself in the origin
and look at to euler angles
RxRyRz (80,70,60)
</PRE>
<HR>
</CODE></BLOCKQUOTE>
<P>and it should give a nice comfy view :-)
<P>
<FIGURE>
<IMG SRC="pv1.gif">
<CAPTION>partiview view</CAPTION>
</FIGURE>
<P>
<P>[spatial units are parsecs, angle units are degrees]
<P>Now play with the display, use the 't', 'r', 'f' and 'o' keys in the viewing
window and use the
left and mouse buttons down to (carefully) move around a bit, and make
yourself comfortable with moving around. Using the 't' button you get
some idea of the distance of the stars by moving back and forth a little
(the parallax trick). In fact, if you 't' around a little bit, you may
see a green line flashing through the display. That is on of the RGB
(xyz) axes attached to the (0,0,0) [our sun] position. You should see
Procyon and Sirius exhibit pretty large parallaxes, but Orion is pretty
steady since it is several hundred parsecs away.
If you move the right mouse button you will zoom in/out and
should see our Sun flash by with the red-green-blue axes.
<P>Try and use the middle mouse button (or the 'p' key) to click on Sirius
or Procyon, and see if you can get it to view its properties. Now use
the 'P' key to switch center to rotation to that star. Sirius is
probably a good choice. Move around a bit, and try and get the sun and orion
in the same view :-)
<P>[NOTE: these Hipparcos data do not have reliably distance above
100-200 pc, so Orion's distances are probably uncertain to 30%]
<P>
<P>A little bit on the types of motion, and what the mouse buttons do
<P>
<BLOCKQUOTE><CODE>
<HR>
<PRE>
| left middle right
| button-1 button-2 button-3
--------------------------------------------------------------------
f (fly) | fly 'pick' zoom
o (orbit) | orbit 'pick' zoom
r (rotate) | rotate X/Y 'pick' rotate Z (+bug?)
t (translate) | translate 'pick' zoom
</PRE>
<HR>
</CODE></BLOCKQUOTE>
<P>The point of origin for rotations can be changed with the 'P' button.
First you can try and pick ('p' or button-2) a point, and if found,
hit 'P' to make this point the new rotation center default.
<P>
<P>
<P>
<BLOCKQUOTE><CODE>
<HR>
<PRE>
red = X axis
green = Y axis
blue = Z axis
</PRE>
<HR>
</CODE></BLOCKQUOTE>
<P>
<H2><A NAME="ss3.2">3.2 Top Row</A>
</H2>
<P>The top row, from left to right, shows the following buttons:
<P>
<DL>
<P>
<DT><B> More </B><DD><P>item
<P>
<DT><B> [g1] </B><DD><P>g1 (or whichever group) is the currently selected group. See command <CODE>object</CODE> ?
<P>
<DT><B> [f]ly </B><DD><P>Shortcut to select fly/orbit/rot/tran, which can also be activate
by pressing the f/o/r/t keys inside the viewing window.
<P>
<DT><B> point </B><DD><P>Toggle to turn the points on/off
<P>
<DT><B> poly </B><DD><P>Toggle to turn polygons on/off
<P>
<DT><B> lbl </B><DD><P>Toggle to turn labels on/off
<P>
<DT><B> tex </B><DD><P>Toggle to turn textures on/off
<P>
<DT><B> box </B><DD><P>Toggle to turn boxes on/off
<P>
<DT><B> logslum lum </B><DD><P>Slider controlling a <B>datavar</B> variable (which?)
<P>
</DL>
<P>
<P>
<H2><A NAME="ss3.3">3.3 Second Row</A>
</H2>
<P>The second row from the top
controls loading and playing sequences of moving through space
<P>
<DL>
<P>
<DT><B> Load... </B><DD><P>Brings up a filebrowser to load a <B>.wf</B> path file. This is a file with on each
line 7 numbers: xyz location, RxRyRz viewing direction, and FOV (field of view).
<P>
<DT><B> Play </B><DD><P>Play the currently loaded path
<P>
<DT><B> << < [###] >>> </B><DD><P>Control individual path frames
<P>
<DT><B> slider </B><DD><P>Slider
<P>
</DL>
<P>
<H2><A NAME="ss3.4">3.4 Logfile window</A>
</H2>
<P>The third window from the top contains a logfile of commands gives, and can be resized
by dragging the bar between command window and viewing window. The Logfile windows also
has a scroll bar on the left.
<P>
<P>
<H2><A NAME="ss3.5">3.5 Command window</A>
</H2>
<P>The Command window is a single line entry window, in which VIRDIR commands can be given.
Some commands show their result in the Logfile window, others on the originating console.
<P>
<P>
<H2><A NAME="ss3.6">3.6 Viewing window</A>
</H2>
<P>The Viewing window is where all the action occurs. Typically this is where you give
single keystroke commands and/or move the mouse for an interactive view of the data.
It can be resized two ways: either by resizing the master window, or by picking up
the separator between Viewing window and Command window above.
<P>
<P>
<HR>
<A HREF="partiview-4.html">Next</A>
<A HREF="partiview-2.html">Previous</A>
<A HREF="partiview.html#toc3">Contents</A>
</BODY>
</HTML>