
                          WHERITIS V 1.0

                   Copyright 1987 by Dennis Hevener, 
                                     Personal Database Applications
                                     2634 Meadow Bend Court
                                     Duluth, GA  30136-6037


WHERITIS will calculate the distance and direction between any two 
points on earth. It was written to test subroutines for  ham radio 
AND SWL logging database systems.

When  you run WHERITIS,  you will be asked for your  latitude  and 
longitude. Latitude is the measure of distance a point is from the 
equator.  Points  north of the equator are expressed  in  positive 
degree  values,  and points south of the equator are expressed  in 
negative degree values.  The equator is 0 degrees,  the north pole 
is 90 degrees, and the south pole is -90 degrees.

Longitude is a measure of how far from the Prime Meridian a  point 
is.  The prime meridian is an imaginary line running from pole  to 
pole,  passing thru Greenwich,  England.  Points east of the prime 
meridian,  between the prime meridian and halfway around the earth 
are  measured from 0 thru 180 degrees.  Points west of  the  prime 
meridian,  between the prime meridian and halfway around the earth 
may be measured in two ways:

*in negative degree values ranging from 0 to -180 degrees. This is 
referred to as WEST longitude, since it measures the distance west 
of the prime meridian.

*in positive degree values ranging from 360 to 180  degrees.  This 
is referred to as EAST longitude,  since it measures distance EAST 
of the prime meridian.

To illustrate,  the state of Alabama  is roughly three-quarters of 
the way around the earth going east from the prime  meridian,  and 
therefore  one-forth of the way around going west from  the  prime 
meridian.  Alabama's  longitude  may be expressed  as  either  -90 
degrees or 270 degrees.

If  all this is too confusing to understand,  just  remember  this 
simple rule:

*points  in the Western hemisphere,  (where North & South  America 
are),  must  be  either  a negative number or  a  positive  number 
greater than 180. Many maps give latitudes in West longitude (0 to 
-180),  but  leave  off the negative  sign.   When  entering  data 
derived from these maps, be sure to enter them as negative numbers.

Ok,  let's  try out WherItIs.   Enter your latitude.   It  may  be 
entered  in  decimal degrees (for instance 28.5)  or  in  degrees, 
minutes,  and seconds.  Enter separate the degrees,  minutes,  and 
seconds with a space.  You may leave off the minutes or seconds if 
they are zero.  28 degrees 30 minutes 0 seconds may be entered  as 
28 30 0 or 28 30 or 28.5.

If you are using degree-minute-second format for input,  and  want 
to  enter a negative value and the degree is 0,  you must put  the 
minus sign before the minute. For instance, 0 -30 15.  If both the 
degree  and minute are 0,  you must put the minus sign before  the 
seconds, like 0 0 -28.

Next  you will be asked for your longitude.  It may be entered  in 
east  or west longitude,  and in decimal  or  degree-minute-second 
format.

After  entering  your  location,   you  will  be  asked  for   the 
coordinates of a location to find distance and direction to. Enter 
these coordinates as you did your own.

The following information will be displayed:

*direction in degrees. (0 is north, 90 is east, etc.) 
*distance in miles 
*distance in kilometers 
*location there in decimal degree format 
*location there in degree, minute, second format 
*gridsquare of location there (Gridsquares is another 
 method of defining a point on earth, used primarily by 
 ham radio operators).

The  longitude  for  the decimal degree  coordinates  is  in  east 
longitude,   and   the  longitude  for  the   degree-minute-second 
coordinates   is  in  west  longitude.   These   coordinates   are 
equivalent.

After   the  program  has  calculated  and   displayed   distance, 
direction,  and the various ways to express the THERE location, it 
will   re-prompt  for  THERE  coordinates.    To   re-enter   YOUR 
coordinates, enter "REDO" for LATITUDE THERE. To exit the program, 
enter "QUIT" for LATITUDE THERE.

WherItIs  was  written  in Megamax C on the  Atari  ST.   The  IBM 
version was compiled with Borland Turbo C.   A version for the HP-
3000 compiled with CCSC C is also available.   Please contact  PDA 
if  you want the HP-3000 version.   A talking version is  included 
with the Atari version. See notes for installation.

FEATURES OF PDA HAM RADIO LOGGING SYSTEM:

A  comprehensive  ham  radio logging program  is  currently  under 
devlopment for the Atari ST and IBM PC.  Here is a list of planned 
features:

*automatic calculation and display of direction and distance based 
on call sign prefix or state.

*automatic logging of country based on call sign prefix.

*user-definable band limits with out-of-band warning.

*user-definable edits for mode.

*contesting system with user-definable dupe criteria.

*automatic logging of time and date.

*automatic  logging  of  frequency  and mode  with  Icom  735  and 
possibly other radios.

*keypad frequency input for Icom 735 and possibly other radios.

And like all other PDA database products, will feature:

*ease of use.

*convenient on-line inquiry on any field.

*most field sizes user-definable.

*easy import-export of data to/from other programs.

*capacity limited only by disk size.

*extensive on-line help.

*extensive reporting facilities.

*Atari ST version uses GEM.

LICENSE  INFORMATION:  This product may be freely distributed  for 
individual  use provided this documentation and  all  accompanying 
advertising and other files are included in the distribution file.  
These files may not be changed in any way. Users may add their own 
comments  in  a  separate  file,  provided  the  file  contains  a 
statement that it is not provided or sanctioned by PDA.

This  product may not be distributed with any commercial  product, 
nor  may  it be sold or used in a commercial  environment  without 
written permission from PDA. Dennis Hevener retains full rights to 
this  and  future  versions  of  this  application.

Atari is a trademark of the Atari Corporation.  GEM is a trademark 
of Digital research.  IBM is a trademark of International Business 
Machines. 

This product carries no warranty,  and PDA shall not be liable for 
any damage resulting from use of this product.

NOTES:

The  Atari ST  version  will TELL you the distance and  direction. 
Make  sure your monitor's volume is turned  up.  More  interesting 
than  useful,   but  fun  nonetheless.   Locate  version  2.0   of 
STSPEECH.TOS  in one of three places on the same drive frow  which 
you are running WherItIs:

   *in the same directory as whertalk,
   *in the root directory,
   *or in an \etc directory.

That's all there is to it!   If WherItIs cannot find STSpeech.tos, 
it will still  function--it simply won't talk.

Here are some latitudes and longitudes to try out with WHERITIS.

 CITY         LATITUDE  LONGITUDE (E)

ACAPULCO       16.90      260.10 
ACCRA           5.60      359.75 
ADDIS ABABA     9.05       38.70 
ALGIERS        36.50        3.00 
ARCHANGEL      64.50       40.70 
ATHENS         38.00       23.70 
ATLANTA        33.75      275.60 
AUCKLAND      -36.90      174.80 
AUSTIN,TX      30.30      262.20 
AZORES         38.50      332.00 
B. ARIES      -34.70      301.50 
BAGHDAD        33.30       44.40 
BAKER IS.        .23      183.50 
BERLIN         52.50       13.40 
BERMUDA        32.30      295.20 
BOGOTA          4.63      285.90 
BOMBAY         18.90       72.90 
BONN           50.70        7.10 
BOSTON         42.30      288.90 
BRASILIA      -16.20      315.50 
BRISBANE      -27.50      153.00 
BUDAPEST       47.50       19.10 
CAIRO          30.10       31.30 
CANARY IS.     28.50      344.80 
CARACAS        10.60      293.10 
CASABLANCA     33.40      352.42 
CHRISTCHURCH  -43.50      172.70 
COLOMBO         6.92       79.90 
CONCEPCION    -36.80      286.90 
COOK IS.      -21.00      158.00 
COSTA RICA      9.98      275.90 
DENVER         39.70      255.00 
DETROIT        42.30      277.00 
FAIRBANKS      64.80      212.20 
GILBERT IS       .25      176.00 
GUATEMALA      14.60      269.60 
HAVANA         23.10      277.60 
HELSINKI       60.10       25.00 
HONG KONG      22.00      115.00 
HONOLULU       21.30      202.20 
ISTANBUL       41.00       29.00 
JAN MAYEN      70.20      351.00 
JERUSALEM      31.80       35.20 
JUNEAU         58.30      225.70 
KHARTOUM       15.60       32.60 
KINGSTON       18.00      283.20 
LAGOS           6.50        3.50 
LENINGRAD      59.90       30.40 
LIMA          -12.10      282.90 
LISBON         38.70      350.90 
LONDON         51.50         .17 
LOS ANGELES    34.00      241.70 
LUANDA         -8.83       13.30 
MADRAS         13.10       80.30 
MADRID         40.40      356.28 
MALTA          36.00       14.00 
MANILA         14.50      121.00 
MARSHALLS      10.00      170.00 
MELBOURNE     -37.80      145.00 
MEXICO CITY    19.40      260.80 
MIAMI          25.80      279.70 
MONTEVIDEO    -33.90      303.80 
MOSCOW         55.75       37.58 
NAGASAKI       32.80      129.90 
NAIROBI        -1.30       36.80 
NEW YORK       40.70      286.20 
PARIS          48.90        2.30 
PEKING         39.90      116.40 
PERTH         -32.00      115.80 
PITCAIRN IS   -25.10      230.00 
PRAGUE         50.10       14.40 
PT MORESBY      9.50      147.10 
PUERTO RICO    18.50      294.00 
QUITO           -.23      281.50 
RANGOON        16.80       96.20 
REYKJAVIK      64.20      338.00 
RIYADH         24.70       46.80 
SAIGON         10.80      106.70 
SAMOA         -13.00      170.00 
SAN FRANCISCO  37.80      237.50 
SEATTLE        47.60      237.70 
SEOUL          37.50      127.00 
SINGAPORE       1.30      104.00 
ST. JOHN'S     47.50      307.30 
ST. LOUIS      38.70      269.70 
SYDNEY        -33.90      151.20 
TAIPEI         29.10      117.60 
TASHKENT       41.30       69.20 
TEHRAN         35.70       51.40 
THULE          77.50      290.70 
TOKYO          35.70      139.80 
TORONTO        43.70      280.60 
VANCOUVER      49.20      237.00 
VLADIVOSTOCK   43.00      131.80 
VOLGOGRAD      48.80       44.50 
WARSAW         52.30       21.00 
WASHINGTON     38.90      283.00 
WINNEPEG       49.90      262.80 
