Current Shareware 1994 January/SHAR194.ISO/engineer/sly138.zip/CAVEMAP1.DOC

Text File | 1993-03-22 | 10KB | 228 lines

!!!!!!!!!!!!!!!!!SPECIAL NOTICE TO EVERYONE WHO GOT THIS FAR!!!!!!!!!!!!!!!!
               Distributed as shareware on PC-SIG disk no: 1826
The reason that you couldn't get CAVEMAP to work might be that the file has
been deleted.  I usually only make that deletion when I know that you have
CAVEMAP1.BAS elsewhere.  If not then ask.

                             CAVEMAP1 INSTRUCTIONS
           Copyright (c)1987, 1993 by DP_BYTER, proliferate freely.
                            1/2 Fast Software Div of
                                   CAVE, Inc
                                  1/2 Fast Road
                               Ritner, KY  42639
                                 606/376-3137
              (please don't expect me to think on the telephone)
A new & improved (on line help, VGA map, etc) is currently under development.

Please copy this disk before using.  You might make a mistake and destroy a
file.  Please give copies of this disk to your friends who might be interested
in land surveying.  Even give it to your enemies!

This program assumes that you already know what you are doing.  If you don't,
then you need to read

                             "SURVEY IT YOURSELF:
               A Quick, Easy, and Inexpensive Preliminary Survey
                       Using the Compass & Tape Method"

which should be on the distribution disk as a set of files "SIY*.TXT".  Print a
copy with SIYPRINT.BAT and make a copy to give away, too.

Using the file GRAF1.CAV as data for CAVEMAP1 should plot Graph 1 of Chapter 1
on screen.  GRAF2.CAV should produce Graph 2 of Chapter 7.  The illustrative
surveys of Chapter 1 are in files TABLE*.CAV.  There are several examples of
surveys labeled EXAMPLE*.TXT and EXAMPLE*.CAV

CAVEMAP1 is available in a compiled QuickBASIC (.EXE) version for $5ppd.

The instruments of choice are:
#1 A Silva Ranger compass.  Available for $41. See file REGISTER.ME

#2 A 200 foot surveyor's tape measure, graduated in hundredths of a foot and
made of indestructible fiberglass & PVC.  Available for $27.  A 100' tape is
$22 and a 300' tape is $33.

Other instruments may suffice.  The compass needs to be accurate to one
degree.  The tape measure need be accurate to only one foot.  I have used a
carpenter's tape measure and even clothesline and TV antenna wire when that was
all I had.  With the Silva Ranger you can expect an error of 1% or 2%.  This is
usually plenty good enough for rural property and for preliminary surveys of
more expensive properties.

You need GW-BASIC to use the program CAVEMAP1.BAS   You should have gotten
GW-BASIC in your original MS-DOS package.  If not, raise a fuss with your
supplier until you do get BASIC.  (BASIC is so easy that you can program it
yourself, which is not what the software dealers want.)  The easiest way to
use the program is to copy GW-BASIC onto a fresh floppy disk.  Then copy all
the files with extensions of BAS and CAV from the SURVEY LAND YOURSELF
distribution disk onto that working disk.  Then from DOS;-> GWBASIC CAVEMAP1
<enter>.  QBASIC (supplied with DOS 5) should also work, as does QB 4.5

A special version of CAVEMAP is available for BASICA, the version of BASIC for
the genuine IBM.  It differs in that it has a gold write protect tab.  Limited
time special offer: $995 + $5 S&H.  Reduced from $2995!  Act now!!

Another special version, CAVEMAP1.EXE, is compiled with QuickBASIC 4.5.  It is
an executable file, which needs no supporting BASIC.  $5, ppd.

Just follow the on screen instructions and you will be presented with a full
page menu.  The main menu directs you to the various subprograms.

I = Instrument definitions

Firstly, you should set the instrument parameters.  You may measure direction
as Azimuth (360 degrees in a circle, the default); Quadrants (an archaeic
method from the days B.C.  [Before Calculators] and still sometimes found on
old deeds); or gradians (400 gradians in a circle as used by the Army of the
United States of America to confuse The Enemy).  The compass may be corrected
for declination (default is 0.0).

You may use a backcompass reading.  This is a bit more trouble in the field but
helps to catch blunders.  (Default is NO.)

Distance may be measured in feet (the default), meters, chains, poles (an
archaeic unit equalling 16.5 feet used by Professional Surveyors to confuse the
client), or a pace (user defined).

You may use a clinometer to correct the slope distance to the true horizontal
distance (default is NO) and enter a clinometer correction (default is 0.0).

You may calculate the boundary as offset to the right (left is - numbers) from
the survey.  This is convenient when the boundary is a steel fence or a river.
The fence perturbs the compass.  The river perturbs the surveyor.  (Default is
NO).  Variance is a measure of expected error used to give some parts of a
survey more weight when assigning error.  (Default is 1.0).

The instrument parameters are saved with the data, so if you R = Read in a
file, then you automatically set them.  You can change any parameter anytime.



A = Assign coordinates

Since each shot must be TO the station FROM a known station, a station must be
assigned to start.  Any station may be assigned any arbitrary coordinates, but
the same station cannot be both Assigned and then Shot.  Every station must
have a unique name.

S = Shoot a station

This is the main data entry.  You may automatically prefix your stations with a
unique identifier (Keep it short.  A few characters will suffice.) You will be
prompted for entries.

TO-> is the unique station number or name.

FROM-> is the reference station. Enter nothing if FROM is the previous station.

COMPASS-> is the compass.  May be degrees/minutes or degrees.decimal.  Multiple
readings are separated by a semicolon (;) and are automatically averaged.
BACKCOMP-> if desired.  May be multiple as above.

TAPE-> may be feet/inches or .decimal.  Chains or poles may be /links. No
multiple readings allowed.

INCLINATION-> if desired, is degrees/minutes or degrees.decimal.

REMARK-> if desired.

If you enter a mistake you may back up by entering a "-" for the next datum or
correct it later when displaying data.  A TO-> of nothing but a return ends
data input and returns to the menu.

B = Reassign coordinates

This is used to move a previously defined station.  This allows you to start
surveying at an arbitrary location and come back to a previous survey such as
surveying a boundary half in one direction and half on the other.  Note that
only the one station is reassigned.  If you want to move a whole series of
stations, then you must recalculate them.  You will be given this option.

C = Close loop

This calculates the error when you have surveyed in a circle and returned to
reoccupy (with a different name, please) the same location.  You may also
mathematically distribute the error among the stations and calculate the
acreage.




D = Display data

This shows all entered data and allows you to correct it and recalculate.
For major editing, I use BLACKBEARD.

W = Write file to disk   and   R = Read file from disk

are ordinary MS-DOS sequential textfile [flat ASCII] commands.  You should be
able to use, modify, and create these files with any standard word processing,
database, or spreadsheet program.  Holler if you can't.

L = List coordinates

This lists calculated station locations as North and East of the origin.  South
and West are - numbers.

M = Map

This attempts to draw a plot of all station coordinates on a 640 x 200 CGA
display.  For Hercules emulation, I use "HGCIBM.BAS".  It will print the plot
if your printer uses Seikosha (Star) control codes.  If it doesn't, then send
me a copy of the graphics control codes for you printer.  Will somebody please
tell me how to use the Hercules 720 x 348 graphics from GW-BASIC!!!

* = Map with no graphics

K = Kalibrate

This lets you check and change the horizontal to vertical aspect of your
monitor or printer.  It is also a test to see if you can use my graphics
routines.  If it won't work on your system, holler at me.

O = Offsets

This calculates a new boundary from the right offsets.  Be sure to W = write to
disk first, since this subroutine will destroy the original data.


P = Precision

This helps to find errors when using multiple compass readings or backcompass.

Q = Quit

This exits to BASIC.  Reenter with GOTO 1.

T = Throw out this data

Out with the old to make way for the new.

Shareware registration and instrument order form are on the file REGISTER.ME

                                  Dave Byter
                            1/2 Fast Software Div of
                                   CAVE, Inc
                                  1/2 Fast Road
                               Ritner, KY  42639
                                 606/376-3137

                       Make checks payable to CAVE, Inc.

I would appreciate any complaints, comments, collaborations, corroborations,
criticisms, or corrections.  Even catching mspellings [marital status
irrelevant] and typograhpic errors would help.  If you have any problems, ASK.

This program has undergone continuous modification since it was first written
(for surveying caves, of course) in punchcard FORTRAN for an IBM 1620 in 1966,
and there is no reason to believe that it will stop evolving now.  If you have
any problems, or you catch any bugs, or you wish that it did something else,
then let me know.

Are you interested in land in rural Kentucky?  Raw land sells here (Wayne
County) and now (1993) for $200 to $500 per acre.  Mostly hardwooded hills,
some small fields, springwater, electricity.  Sometimes usable buildings, small
scale farmland or near Lake Cumberland or Big South Fork.  This might be a good
place to retire early, or just vacation.  ASK