
       Welcome to the world of vector fields !

"vect2gp" is a command to convert ASCII data into a set 
of gnuplot command script  to draw  vector  field  maps 
using  "nawk"  under  UNIX  environment.   In addition, 
"vect2gp" itself will work on PCs with (g)awk as a mere
awk command script.

"nawk", "awk" or "gawk" is available on most modern UNIX 
boxes and others.  If you do not have any one of them in 
your computer,  ask the system administrator for getting 
and installing "gawk"  which is a free implementation of 
an enhanced awk distributed  by Free Software Foundation 
as a part of  the GNU project.  "gawk" is also available 
for DOS PCs and other personal computers.

How to Install:
~~~~~~~~~~~~~~~
--Modify the first line of vect2gp if you have "nawk" as
  different name from /usr/bin/nawk in your box. In case 
  your shell should not accept the "#!" comment, you can 
  use vect2gp only as an awk script,  which might be the 
  only possible way  to use "vet2gp" on your PCs.  Then,
  place vect2gp in any directory convenient to you.

--( Option for an online manual )
  A roff source for the online manual is included in
  this package as vect2gp.man which should be copied to
  your manual directry, if you want.
  Example:
     cp vect2gp.man /usr/man/man1/vect2gp.1
  Also, plain text version of this is included with a short
  greeting massage as vect2gp.doc.

--( Option for better pictures )
  The author strongly recommend you to replace "do_arrow()",
  the arrow drawing routine in "term.c" of gnuplot sources, 
  with what is distributed in "ray_do_arrow.c" as a part of
  vect2gp package. A tiny bit of knowledge of the programming
  language C will help you to do so, though this is a very
  simple project.

--Send any comment or request on "vect2gp" to the author.
  (This is *NOT* option :-)


How to Use:
~~~~~~~~~~~
  Although a brief user's manual is included in this package 
  as "vect2gp.man" and "vect2gp.doc", here I will show you 
  the simplest guide for the patients.

  First, try re-producing  the picture of  "sample4.gp"  by 
  typing [ load "sample4.gp" ] into the command line of your 
  gnuplot.

  Then, read the "EXAMPLES" section of the "vect2gp.doc" or
  your online manual which will tell you how to reproduce 
  such scripts as "sample4.gp" by yourself, step by step.


CAUTION:
~~~~~~~~
Please let the author know about the the *re*-distribution 
of this package *before* you do so. This is because the
current version is the test release for developers. In 
addition, _DON'T_ SELL any programme which contains or 
uses any code of this package without the permission of 
the author.


__ANY question or comment is VERY welcome.__

  Yasu-Hiro Yamazaki
  Dept. of Physics, Univ. of Toronto
  60 St. George St.
  Toronto, Ontario
  CANADA M5S 1A7

  e-mail: hiro@rainbow.physics.utoronto.ca
       or hiro@ice3.ori.u-tokyo.ac.jp

Enjoy !

Hiro Yamazaki
