                 -= Psych0's Astrology Tool documentation =-



Psych0's Astrology Tool version 1.20 
(K) 1998, 1999 by Andrew Ziem. All Rites Reserved.

Released: 1999-02-13 

                          /"Life is lived forwards, 
                         but understood backwards."/ 
                                 -- anonymous

Introduction

Psych0's Astrology Tool (from hereforth "PAT") was designed to add data
analysis functions to Astrolog not found within the program. Since then, PAT
has been expanded to work without any other programs. It makes things easier
for the you, the Astrologer, and now that sounds cheasy enough, we should move
on. 

PAT creates various data analysis reports, as mentioned, from a mass of
astrological charts: a list of planets and their locations, numerology, and
soon more. 

PAT's functions are strictly objective. Subjective interpretations are your
business. 

Astrolog is an astrology program by Walter Pullen available for DOS, Windows,
and the Macintosh. The source code, a slightly old OS/2 version, and other
derivatives are also available. PAT has only been tested with 5.30, 5.30e and
5.40. See far below for details on downloading a copy of Astrolog. 

"License Agreement"

PAT is hereby released to the public domain. It is free software: free to be
studied and adapted; free to be distributed; and free to be improved and
released. I believe the hippies would have wanted it this way. (For related
information see http://www.gnu.org.) Portions, however, were not written by me
and belong to their respective authors. 

If you make any improvments or modifications, feel free to send them to me. At
least drop me a note to say you use the program: I'd like to see how this
thing gets around. 

PAT is provided `as is' without warranty of any kind, expresed, implied or
otherwise. If it breaks, you can keep all the little pieces. 

Highlight of Features


    * Freeware. Full source code included. 
      
      Use PAT as you wish, for as long as you wish, however you wish. If not,
      freely make your own modifications. 
      
      
    * Supports multiple platforms. 
      
      
    * Linked list techonology. 
      
      PAT allocates memory as it needs it, never wasting a byte. 
      
      
    * Smart, small. 
      
      
    * Year 2000 safe. 
      
      
Included Files

If any of these are missing or damaged, see the section entitled Distribution
for information on how to get a fresh copy of PAT. 


    README  .xxx     release notes for version xxx, changes, etc.

    PAT     .EXE     DOS 16-bit executable
    PAT2    .EXE     OS/2 32-bit executable
    PAT386  .EXE     DOS 32-bit executable

    DOC\
      PAT_DOC .HTM     documentation in HTML
      PAT_DOC .TXT     sloppy plain-text translation of HTML documentation

    CHARTS\
      CHARTS  .ZIP     sample birth charts

      0PROCESS.BAT     generates Astrolog charts and PAT reads them
      *       .        many birth charts

    DATA\              ready-to-use PAT data
      TIMED   .DAT     data accurate within hours or minutes
      DATE    .DAT     data accurate within one day

    SRC\
      SRC     .ZIP     source code
                       (Contains nested subdirectories: use "PKUNZIP -D".)

    FILE_ID .DIZ     BBS-compatible description



EMX Runtime Library

The OS/2 version was compiled with GNU EMX, so it requires the the EMX runtime
library (emxrt) to run. 

Download the emxrt from hobbes.nmsu.edu via HTTP. 
Download the emxrt from ftp.leo.org via FTP. 

Recognized Celestial Bodies

PAT recognizes the Sun, the Moon, all the planets from (excluding the Earth),
the nine Uranian (trans-Neptunian) bodies, five asteriods, lunar nodes, part
of fortune, the vertex and the east point. Future expansion will allow for
more. 

Bodies not found in the birth charts PAT reads are not entered into the
database. Bodies not found in the database are ignored in the working of the
program. 

Astronumerology

Numerology annoyed me until I came across Dan Millman's _The Life You Were
Born To Live: A Guide To Finding Your Life Purpose_. I've included numerology
because of that and just because of how easy it was to code. There are many
schools of numerology (such as those name derived), by the way, but only one
is currently supported. 

Let's borrow Steve Miller's birthday (October 5, 1943) to see how this works: 

*1)* Lay out the date, changing the month to its respective numerical code: 
   10-05-1943 

*2)* Add each digit seperately: 
   1 + 0 + 0 + 5 + 1 + 9 + 4 + 3 = 23 

*3)* Save this number (23), and then add its digits seperately: 
   2 + 3 = 5 

*4)* Save this number (5) too. Steve Miller's number is a "23/5." 

For interpretation consider herewith also the Moon's nodes as the soul's
evolutionary path markers. To point you in another direction, remmeber that
some numerologists integrate the tarot into their readings. An important note:
PAT is not intuitive. If the birthtime falls near midnight, it will (of
course) be taken as the date written; however, compensation on your part may
be required. 

Command Line Arguments

usage: pat2.exe [-?] [-i] [-r[cd] ] [-w[cdnps] ] 


   -?:    information               -wc:   write Sun/Moon combonation report
   -i:    interactive mode          -wd:   write data
   -rc:   read Astrolog chart       -wn:   write numerological report
   -rd:   read data                 -wp:   write plain text
                                    -ws:   write sign-sorted text



Note: PAT does not erase the file to which it writes if it already exists; it
appends to it. 

Note: to use multiple filenames, using stars ('*') and question marks ('?')
are permissable. 

*Examples:* 

example: pat -rc kcobain -wd music.dat 
Reads Astrolog chart *kcobain* into *music.dat*. 

example: pat -rc read *. -wd celeb.dat 
Reads the entire directory of Astrolog charts (every file with no extention)
into *celeb.dat*. 

example: pat -rd music.dat -wp music.asc 
Writes the data from *music.dat* to *music.asc* as plain text. 

example: pat -rd *.dat -wn d:\numlogy\all.num 
PAT reads all data files (**.dat*), and it writes the an astronumerological
report file *d:\numlogy\all.num*. 

References and Recommended Reading

Title: Astrolog homepage 
Author: Walter D. Pullen (astara@msn.com) 
URL: http://www.magitech.com/~cruiser1/astrolog.htm 

Do you want Astrolog? Go here. It is an advanced, freeware astrological
   program for various platforms. 

Title: Psych0's Bookmark 
URL: http://www.angelfire.com/co/psych0o/links.html#astrology 

Title: SNIPPETS 
URL: http://www.snippets.org 

C SNIPPETS for you programmers. 

Registration Fees, Postcardware, Etc.

If you enjoy this program as much as I enjoyed making it, the best thing you
can do is to help expand it via chart additions or code modifications. Send
those to me. 

Otherwise, a simple note explaining that you use the program is plenty of
encouragement for me to continue publishing it. 

Where in the World is Psych0?

Andrew Ziem is Psych0 and Psych0Soft. 

*E-mail* 
psych0o@juno.com, ziem@iex.net 

*WWW* 
http://www.angelfire.com/co/psych0o/ (personal) 
http://members.xoom.com/sdexter/psoft/ (Psych0Soft) 

*Snail Mail* 
Andrew Ziem 
3080 Woodview Ct. 
Colorado Springs, CO 80918-4635 

Distribution

*WWW* 
http://members.xoom.com/sdexter/psoft/pat.html (PAT) 
http://members.xoom.com/sdexter/psoft/psoft.html (Psych0Soft) 

http://www.simtel.net 
http://hobbes.nmsu.edu, directory /pub/os2/apps/science/human/ 

*FTP* 
ftp.simtel.net/pub/simtelnet/msdos/astrolgy/ 
hobbes.nmsu.edu/pub/os2/apps/science/human/ 

Acknowledgments and Credits (in no particular order)

Public domain code from A. Reitsma (LLS.C), Jerry Coffin (DIRPORT.C), Fred
Cole (STRISTR.C), SNIPPETS, etc. 

16-bit DOS executable packed with WWPACK by Rafal Wierzbicki and Piotr
Warezak. To compress the DJGPP executable, I use DJP 1.07 by Laszlo Molnar.
OS/2 executable packed using LxLite by Andrew Pavel Zabolotny. 


  Astrolog               Water D. Pullen
  DJGPP                  DJ Delorie
  EMX                    Eberhart Mattes
  FidoNet                Tom Jennings and Fido Software
  Macintosh              Apple Corp.
  OS/2                   International Business Machines Corp.
  Turbo C                Borland Corp.


All other programs are copyright and/or trademarked by their respective author
unless otherwise noted. 

-- end of file 