Disk(s) under separate cover
Circular 660
pey and Mapping
S iii Pro~grams
j:; Rti!i i ,: j :^.,.dj t:.^ ,L W :K ,l!u". 4
. .. ....-. . . .. . .
l|B:|+R : i +:+'." : j .." : j ".' :" .. jd E
: f ..:...E ;.... ..
H 1 ?:, !' .. .:" ."" .
... .... ..........
!0;gu ide I i.'. .. : .
,"T ,+[;+ ::::'::'"% :::::a: : ";: . .b .: . :
...V::,,a.0, '+ 'i:+;::;!t :! .;;N m -;::". ::.. .... .
g u id e,"::+ ?i:.:i: ".: :i:;i:.i: ,;,i,"i . "
JNIVERSITV OF FLORIDA
(904) 392-7853
FLORIDA COOPERATIVE EXTENSION SERVICE
UNIVERSITY OF FLORIDA
INSTITUTE OF FOOD AND AGRICULTURAL SCIENCES
COOPERATIVE EXTENSION SERVICE AGRICULTURAL EXPERIMENT STATION
SCHOOL OF FOREST RESOURCES AND CONSERVATION COLLEGE OF AGRICULTURE
REPLY TO IFAS Software Support
Building 120, Room 203
University of Florida
Gainesville, FL 32611
December 8, 1988
M E M 0 R A N D U N
TO: IFAS Software Customers
FR: Dennis G. Watson
RE: Running BASIC programs
The program you have just purchased was written in the BASIC programming language.
Originally, we distributed only the BASIC language source file and required that you use a
BASIC interpreter to run the program.
We now distribute BASIC programs in compiled form.
to load BASIC prior to running the program. Until the
this change, please refer to the following instructions to
Mapping".
This means that you do not have
documentation is updated to reflect
start program 025, titled "Citrus
First, make a duplicate copy of the distribution disk. Store the distribution disk in a safe
place and use the duplicate copy as your working disk. To run the program simply type:
CITMAP
at the DOS prompt and press the Enter (or Return) key.
Once you have started the program, the instructions in the documentation should apply. In
some cases, the documentation or program may allow you the option of exiting to BASIC
or DOS. With a compiled program, regardless of which you choose, you will exit to
DOS.
If you need more space on your working disk, you can delete any files with the extension
".BAS". These are BASIC source files and you do not need them to run the program.
If you have any questions about this program, please contact the IFAS Software Support
office, Bldg 120 Room 203, Gainesville, FL 32611 or phone (904) 392-7853.
... .. ..
CITRUS SURVEY AND MAPPING
MICROCOMPUTER PROGRAMS
by
Thomas W. Oswalt
Extension Agent, Citrus
Polk County Cooperative Extension Service
Bartow, Florida
(C) IFAS, University of Florida, 1985
DISCLAIMER
The University of Florida (UF), Institute of Food and Agricultural
Sciences (IFAS), and Florida Cooperative Extension Service (FCES)
shall have no liability or responsibility to cooperator or any other
person or entity with respect to any liability, loss, or damage caused
or alleged to be caused directly or indirectly by programs released by
IFAS for sale or cooperative use including but not limited to any
interruption of service, loss of business, or anticipatory profits or
consequential damages resulting from use or operation. And in no
event shall FCES be liable for loss of profits, indirect, special, or
consequential damages arising out of any breach of the agreement or
obligations of this contract.
CONDITIONS OF RELEASE OR SALE
All computer software distributed by IFAS or FCES are on an 'AS IS'
basis without warranty. Distribution or resale without written
permission of the department of origin is not permitted.
UNIVEIY OF FLOI AU LWRARIES
ABSTRACT
Citrus Survey and Mapping Microcomputer Program consists of two parts
- Part I, Citrus Survey and Part II, Citrus Mapping.
Citrus Survey is a microcomputer program designed to collect tree
data in the field and store this information as a data or ASCII file.
With this program, the user can gather information on varieties, tree
size and tree conditions using a handheld portable microprocessor.
The field information can be printed in report form using a companion
program, Citrus Mapping.
Citrus Mapping is a microcomputer program designed to create a map
report from the data collected with the Citrus Survey Program. The
Citrus Mapping Program consists of two parts the Cit.Convert
Program creates three ASCII or text files which are then used by the
Cit.Print Program to print a grove map to scale. The user has
several options when printing a grove map. The map can be printed in
the same direction as mapped in the field or the user may rotate the
grove and print the map with North at the top of the page. The user
may select all the labels used to describe the trees in a grove to be
printed or the user may arbitrarily select only certain labels to be
printed.
Growers, production managers, harvesters, appraisers, and lending
institutions can use these programs to print information gathered in
the field using the Citrus Survey and Mapping Program.
KEY WORDS: Citrus Mapping, Citrus Inventory, Grove Counting, Citrus,
Agricultural Resource Inventory, Grove Survey.
CONTENTS
Abstract..... ................. ......***** *** *.* *********************** i
Introduction.............**................................... ....... 1
PART I CITRUS SURVEY........... **........................... .....**.3
Running The Program................................................. *********************5
Resource Identification Menu.........................................5***
Resource Correction Menu.........................................******** **7
Grove Survey Menu......................**.............................**************************
Grove Input Routine.......**..................*....********************i0
Recall Menu..... **......................................**** *** ** 12
Tree Correction Menu..........................*.******* .************13
Miscellaneous.................................. .**** ***. ****. ********16
Changing Program Variables......................................... 17
Flowchart of Citrus Survey Program .................................19
PART II CITRUS MAPPING............................................21
Transferring ASCII Files.........................................*... 23
Citrus Grove Resource Menu.......................................***23
Citrus Print Menu........... **............................********* 25
Print Format For Grove Maps.........................................26
Programming Instructions..................................*.........27
Flowchart of Citrus Mapping Program ................................29
INTRODUCTION
Sound economic management practices are only as reliable as the
resource information upon which they are based. Few industrial
managers would attempt to engage in manufacturing without an accurate
inventory of holdings. The same is true of citrus managers, yet due
to the difficulty of collecting information few engage in resource
mapping. Thus the citrus grower can only approximate grove condition
by a cursory inspection of holdings or shifts in costs or yields.
Part I Citrus Survey describes a program which allows the user to
select up to 15 labels to describe trees in a grove, such as but not
limited to varieties, bearing potential, size, age, vigor, stress or
any combination of these or other labels. The program is designed to
receive data from a grove of any shape.
The Citrus Survey Program was written in Microsoft(R) basic for use on
the Radio Shack TRS-80 Model 100(R) portable computer with 32K memory.
Additional equipment to aid the user may include an external power
source to prolong battery life in the Model 100, a cable to
connect the Model 100 to a cassette recorder, a cassette recorder to
save grove data files, several "computer tapes" without leaders and an
RS-232C cable to connect the Model 100 to an Apple(R) Personal
Computer in order to transfer data. The program will also run on the
Apple Hec with a power pack with some modifications of the
Microsoft(R) basic code to conform with Applesoft(R) basic.
Part II Citrus Mapping describes a program which allows the user to
print to scale data collected by using the Citrus Survey Program. The
report consists of two parts: 1.) a statistical report containing the
physical description of the grove and a summary of. the tree and
acreage subtotals and totals with percentages and 2.) a scale map of
the grove. The map can be printed in the same orientation as mapped
in the field or it may be rotated so that North is printed at the top
of the page. The user may also print all the tree information or he
may arbitrarily select some number less than the total.
The Citrus Mapping Program was written in Applesoft Basic for use on
an Apple II, Apple II+, Apple lIe or Apple lic with a minimum of 48K
memory and two disk drives. A serial interface card is used with
communication software to receive data from the RS-232 port of the
Model 100. The printing routine was written specifically for the IDS
560 Paper Tiger printer. Other printers with intercharacter spacing
and vertical spacing may be used with appropriate printer commands.
For information on ordering this or other IFAS computer programs,
contact your local County Cooperative Extension Service or write:
Farm Computer Support Group
c/o*Dean John T. Woeste
Florida Cooperative Extension Service
1038 McCarty Hall
University of Florida
Gainesville, FL 32611
PART I
CITRUS SURVEY
RUNNING THE PROGRAM
The user is referred to the owners manual for instructions for loading
a program into the computer's random access memory (RAM). To run the
file "CITMAP.BA", the user must press the function key "F8" to call up
the menu. The user must move the cursor over the filename
"CITMAP.BA" using the cursor movement keys. The
key is
pressed. The user will see the program title and the amount of memory
available while the initialization values are read into memory.
Figure 1 is a flowchart of the Citrus Survey Program showing the
menus for collecting and correcting data and the direction of movement
from one part of the program to another.
*** CITRUS SURVEY ***
NOTE!
LIMIT OF 3 GROVES IN MEMORY WITH 800
TREES IN EACH.
PRESS TO CONTINUE
CAUTION: Care must be taken to avoid exceeding the tree limit set in
the above statement! Instructions for changing this value are listed
on page 15. Once the user presses the key the display on the
screen will be:
*** RESOURCE IDENTIFICATION MENU ***
ENTER THE NUMBER OF LABELS YOU WISH TO USE (MAX=15)? (5)
ENTER TO RECALL FILE FROM MEMORY
The user will be asked to enter the number of labels to be used in
identifying the grove. The labels may describe trees in a grove
according to but not limited to varieties, bearing potential, age,
size, vigor, stress or any combination of these or other labels. If
is entered and no grove files are under program control, then the
user may read any grove file in memory into program control. This is
useful when the user has exited the program and later wants to recall
grove files for revision.
The display onr the screen will be a list of all files in memory both
basic (e.g. CITMAP.BA, the grove surveying program) and ASCII (e.g.
HOME.DO, a grove data file).
CITMAP.BA* HOME.DO
ENTER NAME OF FILE...?
If a file name is entered incorrectly the user will be prompted by the
following message:
FILE DOES NOT EXIST
PRESS TO CONTINUE
The user is returned to the'Resource Identification Menu. A proper
entry will result in the following display:
READING HOME DATA FILE
Upon completion the display on the screen will be:
MORE...(ENTER Y/N)?
A response (yes) will prompt -he user to enter another file. A
(no) will exit the user to the Grove Survey Menu.
In an example where the user responds with a number between 1 and 15
(in this example 5 is used) the following message will be displayed on
the screen:
ENTER TREE LABEL? (PINEAPPLE)
The selected response is entered i.g. PINEAPPLE and the key is
pressed. The next question asks for the keyboard character by which
this information will be entered:
ENTER THE LETTER OR NUMBER TO REPRESENT
THIS LABEL? (Q)
This may be any key between "0" t) "9" and "A" to "Z". For example,
suppose the block to be mapped contains Pineapples and Hamlins with
resets of both varieties and skip3 or missing trees. The user may
enter the variety or condition and use either the first letter of the
label or select a key from a cluster of keyboard characters to
identify the respective labels. The following is an example of
clustering keyboard characters on the left side of the keyboard which
often reduces the time the user must search for each key.
KEYBOARD LABEL
Q PINEAPPLE
A' HAMLIN
W PINEAPPLE RESET
S HAMLIN RESET
X MISSING
PRESS TO CONTINUE
Whatever choice is made, the characters printed out as a grove map
will be the keyboard character selected by the user. Care must be
taken to avoid using the same keyboard character to describe several
different conditions.
Once the five keyboard characters and variables have been entered, the
user will be asked for the following verification.
*** RESOURCE CORRECTION MENU ***
1. MAKE INDIVIDUAL CHANGES
2. START OVER
3. CONTINUE ON WITHOUT CHANGES
ENTER 1, 2 OR 3
SELECTION 1: MAKE INDIVIDUAL CHANGES can be accessed by pressing the
key <1>. The display on the screen will be:
ENTER ITEM# (1 TO 5) TO CHANGE? (1)
CHANGE PINEAPPLE TO --> ? (VALENCIA)
The user will enter the correction and then press . The next
question displayed on the screen will ask for any change in the
previously selected keyboard character:
CHANGE Q TO --> ? (Q)
In this example the variety is changed but the keyboard character is
retained in the keyboard cluster originally selected. Only a single
number or character should be entered. The final response on the
screen will be:
MORE CHANGES?
If the letter is pressed, the user will be
change in both labels and keyboard characters.
pressed, the program will proceed to the Grove
asked to enter the next
If the letter is
Survey Menu.
SELECTION #2: START OVER allows the user to return to the Resource
Identification Menu. At this point the user must reenter all
labels.
SELECTION #3. CONTINUE ON WITHOUT CHANGES will call up the following
message to be displayed on the screen:
AVAILABLE MEMORY FOR (2874) TREES
PRESS TO CONTINUE
If the remaining memory is less than that required to hold a grove
having the number of trees displayed in the "Citrus Survey" screen
display, the following message will be displayed on the screen:
WARNING!
GROVE TOO LARGE FOR AVAILABLE MEMORY
PRESS TO CONTINUE
Once one of the above messages is displayed, the user will see the
following menu on the screen:
*** GROVE SURVEY MENU ***
1. SETUP NEW GROVE?
2. RECALL MENU?
3. CHANGE LABELS?
4. SAVE FILE TO CASSETTE?
5. QUIT
PRESS 1,2,3, OR 4
SELECTION #1: SETUP NEW GROVE will bring up on the screen 8
questions about the block to be surveyed. Each question will require
a response terminated by pressing . Each entry will be
followed with the response for verification of the information
entered. The questions and accompanying limitations are:
GROVE INFORMATION
BLOCK NAME ?
COMPANY ?
YOUR NAME ?
SPACING N TO S ?
SPACING E TO W ?
DIRECTION OF TRAVEL ?
MOVEMENT ACROSS BLOCK ?
COMMENTS ?
EXPLANATIONS
6 character limit: First character
must be a letter only followed by
any combination of letters or
numbers except a period.
10 Character limit: May be the
owner, caretaker or cooperative.
10 character limit: The name or
initials of the surveyor.
The distance between trees from
north to south of 7.5 to 30 feet in
multiples of 2.5 feet.
The distance between trees from
east to west of 7.5 TO 30 feet in
multiples of 2.5 feet.
N)orth, S)outh, E)ast, or W)est.
Single entry only. Direction
surveyor moves down first row.
N, S, E or W which is at right
angles to the "direction of travel".
Direction surveyor turns at the end
of any row.
40 character limitation to describe
the block, e.g. age, condition, etc
The following example contains acceptable responses to describe a
grove prior to mapping:
BLOCK NAME ? CGI198 (Company intials & Block #)
COMPANY ? Citrus Groves, Inc.
YOUR NAME ? TWO
SPACING N to S ? 12.5
SPACING E to W ? 25
DIRECTION OF TRAVEL ? N
MOVEMENT ACROSS BLOCK ? W
COMMENTS ? Tree survey following Dec
'83 freeze
Each entry will terminate with the following question before
displaying the next entry:
OK?...PRESS OR AND
Two additional responses date stamp and time stamp are queried
automatically by the program as the user exits this routine and enters
the grove input routine.
Once the background information is entered, the program will begin the
grove input routine where field information can be collected. The
program is designed to count the trees in each row. Therefore, if a
grove has rows of varying lengths (due to sinkholes, bayheads, lakes)
the program will recognize each row when the user presses to
begin a new row or to complete a grove.
The mapping program is designed so that the surveyor upon finishing a
row can simply turn to the next row and begin mapping in the opposite
direction.
To map a grove with rows of different lengths, the user must select a
"base" for the grove. This term denotes that an entry must be made
for the first space in each row along the "base". Regardless of the
direction the user is traveling, at least one entry must be made for
the space in the row representing the base. If a drainage ditch lies
in place of a entire row, the only entry necessary would be a single
or if there is only one tree in a row then the appropriate
keyboard character. The key is pressed after either input to
terminate the current row and begin a new row. The Citrus Mapping
Program will fill in the remainder of the row in both situations
automatically when the grove file is printed.
If a ditch or other nonplanted area begins at the "base" and extends
some distance into the grove where a tree row originates, the user
must enter from the base up to where the first tree begins.
Mapping this same situation from the top of the grove, the user must
first key-in the trees and enter along the entire distance of
the drainage ditch or nonplantable row to the "base". The important
concept to keep in mind is that a continuous series of inputs must be
made from the "base" to the last tree in the row or from the last tree
to the "base".
The next message on the screen will display the following message:
*** GROVE INPUT ROUTINE ***
PRESS FOR NEXT ROW
PRESS WHEN FINISHED
PRESS <- FOR CORRECTIONS
PRESS < ? > TO LIST LABELS
PRESS ENTER NEW LABELS
ENTER LABEL KEY
GO N.. ROW# 1.. TREE# 1 >>
The user will be instructed on the direction to travel, the current
row number and the tree number for which the next entry is to be
made. In this example, the surveyor is GOing North on ROW# 1 at TREE#
1. The user has available several keys which may be used in addition
to the keyboard characters chosen to represent tree labels. These
are:
1. ENTER....Allows the user to begin a new row
2. ESCAPE...Exits the input routine and saves data as an ASCII
file
3. <----....Left cursor movement key allows correction of only
the last tree entered or if is pressed by
mistake, allows the user to return to the preceding
row and tree#.
4. ? ......Allows the user to review the keyboard characters
and labels selected to map grove
5. CTRL L...All-ws user to interrupt grove input routine to enter
additional labels and keyboard characters up to a
maximum of 15.
6. SPACE....Used to indicate nonplantable spaces. CAUTION: Do
NOT use the SPACE BAR to represent MISSING TREES.
The mapping program will not count inputs;
therefore, calculations for tree totals and acreages
will be in error.
Only these inputs and the keyboard characters will be accepted. All
others will result in the statement "INPUT ERROR!" echoed by a DOUBLE
BEER. Each input statement indicates the direction of travel, the row
number, tree number and upon keying in an acceptable character the
label will be displayed echoed by a SINGLE BEEP. A space bar input is
displayed as a series of periods. When a mistake is made and the left
cursor movement key is pressed, a statement similar to the following
will be displayed.
L CHANGE PINEAPPLE --> (PINEAPPLE RESET)
Once the correction is made in this example by entering the keyboard
character "W" (see the keyboard characters and labels example on page
6, the label "PINEAPPLE RESET" will be displayed on the screen. The
user will be returned to the next input statement.
If the user presses the left cursor key twice in succession, the
following error message will be displayed on the screen:
CORRECT ONLY 1 TREE AT A TIME
The user must correct the tree before returning to the Grove Input
Routine.
If the user mistakenly presses before reaching the end of the
row, the left cursor movement key can be pressed and a message similar
to the following message will be displayed:
GO S.. ROW # 2.. TREE # 1 >> REMOVE THIS ROW?
If the user responds by entering , the row# will be decremented by
one and the user will be returned to the previous row and tree. If
the user responds by pressing , the Input Routine will continue.
If the user presses the left cursor key before a tree is entered on a
new row, the following message will be displayed on the screen:
DO YOU WISH TO RETURN TO ROW# 1
If the response is , the row# is checked and if it would be less
than one then the following message is displayed on the screen:
WARNING...ROW# 0 DOES NOT EXIST!
The user is then returned to the Grove Input Routine for the next
entry. If the row# is greater than one the row is decremented and the
user is returned to the Grove Input Routine.
An internal error routine will also decrement a row# if the user
mistakenly presses at the end of a mapping exercise instead of
pressing . If the key is pressed followed immediately by
the key, the routine will automatically decrement the row# by
one.
When mapping is completed, the user may exit by pressing . The
program.will save the grove file as an ASCII file (data file) with the
suffix ".DO". The user will be returned to the Grove Survey Menu.
During the operation of the program, the user will be limited by
several built in error routines. Once the user maps three groves and
attempts to set up a new grove, the following error message is
displayed on the screen:
STOP! SAVE FILES TO CASSETTE BEFORE STARTING
The user should proceed to Selection #4 to transfer the data files to
a cassette recorder. This procedure will allow surveyors to remain in
the field and complete several groves before returning to the office.
The maximum number of rows which can be entered is 66. Beyond row#
66, the user will be exited out of the tree input routine and the
grove will be saved as an ASCII file. The rationale for the built-in
limitations is to conserve space in memory and to prevent the program
from aborting because of an out of memory error.
SELECTION #2: RECALL MENU will give the user access to any grove
mapping file in memory. If a grove by the name of "HOME" is in memory,
the following statement will be displayed on the screen:
LOOK AT HOME OK? (PRESS Y/N) J
If the response is , the name of the next file is displayed and
each time is pressed the next file is displayed until the
following error message is displayed:
L STOP! ONLY (number) GROVE(S) IN MEMORY
The user is returned to the Grove Survey Menu. If the response is
, the screen will display the following message:
SI READING HOME FILE
Upon reading the grove data file into memory, the user may select any
one of four options displayed on the screen:
*** RECALL MENU ***
1. GROVE INFORMATION
2. TREE CORRECTION
3. CONTINUE GROVE MAPPING
4. RETURN TO SURVEY MENU
PRESS 1,2,3 OR 4
OPTION #1: GROVE INFORMATION allows the user to re-enter the grove
information routine and make any corrections to the 8 questions
describing the grove and mapping procedures. The routine is
sequential which requires the user to press either a "Y" or "N" in
response to all eight questions. If the user responds with "N", the
user must enter the corrected data. The user will be asked the
following message:
OK?...PRESS OR AND
The user may enter and continue to the next entry or enter and
repeat the above step. At the conclusion of the routine, the user
will be returned to the Recall Menu.
OPTION #2: TREE CORRECTION allows the user to reenter the tree input
routine to correct any errors made in the field. The message
displayed is:
*** TREE CORRECTION MENU ***
1. CORRECT A TREE
2. DELETE A TREE
3. ADD A TREE
4. EXIT
PRESS 1,2,3 OR 4
When the user makes an entry, the following message is displayed on
the screen:
RECALL TREE DATA BY ROW# (3)
PRESS < E > TO EXIT
The user keys in the row number, in this example "3", and presses
. The program responds with the message:
26 TREES IN ROW# 3 1
MOVING S ENTER TREE# ? (5)
The program will respond with the row number, the trees found in that
particular row and a display of all trees in the recalled row. The
trees in the recalled row will be printed in consecutive order in groups
of five. The groups of five trees are a counting aid for the user.
An input error will cause the input message to repeat. The next
statement indicates the direction the user is moving and asks for the
tree number, in this example "5".
CHOICE #1: CORRECT A TREE provides the user a means of correcting
errors after the grove mapping exercise has been completed. The user
will enter the keyboard character (e.g. "A" which is Hamlin) and.see
the following display on the screen:
CHANGE VALENCIA ---> (HAMLIN)
The program displays the current variety at tree #5 in row #3 in this
case a Valencia. The user will enter the corrected input which is a
Hamlin. The entire row will be re-displayed with the correction. An
improper response will cause an INPUT ERROR! response. A correct
entry will cause the corrected input to be printed and the program will
wait for the user to enter the next tree number.
13
Pressing will allow the user to select another row. Pressing
again will return the user to the CORRECT A TREE routine and return
the user to the TREE CORRECTION MENU. Pressing will return the
listing of the keyboard characters and grove labels selected to
describe the grove being mapped.
CHOICE #2: DELETE A TREE will, upon the user keying in the row number
and tree number, remove the tree at the selected position and
decrement all trees by one from the tree above the deleted tree to the
end of the file. The user will see the following display:
RECALL TREE DATA BY ROW#? (1)
26 TREES IN ROW# 1
MOVING N ENTER TREE#? (5)
REMOVE VALENCIA
The trees in the row will be displayed. A correct entry will
re-display the entire row with the deletion and then wait for the user
to enter another tree number for further deletions. Pressing will
allow the user to select another row. Pressing again will return
the user to the Tree Correction Menu and pressing will print the
grove labels and keyboard characters.
CHOICE #3: ADD A TREE will insert a tree at the row and tree location
selected by the user and increment all trees by one from the original
tree to the end of the file.
RECALL TREE DATA BY ROW#? (5)
26 TREES IN ROW# 5
MOVING N ENTER TREE#? (25)
INSERT >> (HAMLIN RESET)
The trees in the row will be displayed. A correct keyboard character
(e.g. "S" which is a Hamlin reset) will be displayed on the screen as
Hamlin reset. Also, the entry will re-display the entire row with the
addition and.then wait for the user to enter another tree number for
further additions. Pressing will allow the user to select another
row. Pressing again returns the user to the Tree Correction Menu
and pressing will print the grove labels and keyboard characters.
OPTION #3: CONTINUE GROVE MAPPING allows the user to continue
mapping any selected grove which has been terminated by pressing
. The display is similar to the Grove Input Routine. The
program when entered at this level will increment to the next row
number and reset tree value to "I". The direction of travel will be
reversed. The user may use any of the options at this level as
described in the Grove Input Routine.
If the grove map was terminated before all of the last row was
entered, the user may recover by first entering the Recall Menu option
#2, TREE CORRECTION. The row can be completed by selecting Choice #3
ADD A TREE under the Tree Correction Menu. Any number of trees can be
added to complete the row. Once the partial row is completed, then
the Option #3 CONTINUE GROVE MAPPING can be selected to complete
the remaining rows in the grove.
OPTION #4: RETURN TO SURVEY MENU will exit the Correction Menu and
the following message will be displayed:
-WRITING HOME FILE
The user is returned to the Grove Survey Menu.
SELECTION #3: CHANGE LABELS allows the user to return to the
"Resource Identification Menu". Previously selected keyboard
characters and labels will be removed and the user must re-enter the
appropriate data. The user may select this option to customize the
keyboard inputs for each grove.
SELECTION #4: SAVE FILE TO CASSETTE will allow the user to transfer
grove mapping files to a cassette recorder and if desired to remove
the files from memory.
The following message will be displayed on the screen:
DATA FILE SAVE
CONNECT THE RECORDER-TO-COMPUTER CABLE
DEPRESS CASSETTE RECORD & PLAY KEYS
PRESS TO CONTINUE
Before transferring files, the user must connect the
recorder-to-computer cable. The cassette recorder cable at one end
has 2 gray jacks and one black jack. The black jack is inserted into
the "EAR" plug. The large gray jack is inserted into the "AUX" plug
and the small gray jack is inserted in the "REM" plug. The opposite
end of the cassette cable has a round connector which is inserted into
the cassette socket on the Model 100. A cassette tape is inserted
into the recorder and the digital counter is reset to zero (if the
groves to be saved on tape are the first to be recorded). It is
recommended that as data files are saved on cassette tape that the
digital counter values be recorded with the exact name of the file.
Once the user presses , the following message will be displayed
on the screen:
READING HOME DATA FILE
In this example the grove mapping file is named "HOME". The file is
read into memory. The next message displayed is:....
SAVE HOME FILE TO RECORDER
The file in memory is saved on cassette tape. Each grove data file in
memory will be read into memory and then transferred to cassette tape.
The following message appears on the screen:
GROVE FILE REMOVAL
THE FOLLOWING FILE(S) ARE IN MEMORY
HOME.DO
DESTROY THESE FILES?
.. i ______ ^ ^ ^ _
The user will see listed on the screen all grove data files currently
in memory. The user will be asked to respond with either a yes or no
to the following message:
OK?...PRESS OR AND
If is pressed the screen message will be:
THE FOLLOWING FILE(S) HAVE BEEN DESTROYED
HOME.DO
PRESS TO CONTINUE
Once the user presses , the program will return to the Grove
Mapping Menu.
If is pressed the following message is displayed on the screen:
REMOVE THE RECORDER-TO-COMPUTER CABLE
DEPRESS CASSETTE STOP KEY
PRESS TO CONTINUE
The files will remain intact, but they will not be in RAM memory; thus
the mapping program will restart. When is pressed, the user
will be returned to the Grove Mapping Menu.
SELECTION #5: QUIT allows the user to exit the Citrus Survey Program..
The screen will be cleared and all files in memory will be listed.
MISCELLANEOUS
When the batteries become weak, a low battery power signal located-on
the right side of the keyboard will light. The user will have about
15 minutes of computer use before the computer becomes inoperable.
Removal of the old batteries will not interfere with any file in
memory.
New batteries should be inserted as soon as possible. However, the
user must finish the row being counted and exit the Citrus survey
Program by pressing . Once the batteries are replaced, the user
can press Selection #2 of the Grove Survey Menu RECALL MENU. The
Correction Menu will be displayed and the user can press Option #3
CONTINUE GROVE MAPPING. The user will be returned to the next row at
the first tree.
The "MEMORY POWER SWITCH" is located on the bottom of the Model 100.
When this switch is turned off, all RAM memory is erased. If copies
of the data in RAM do not exist including theCitrus Survey Program,
then the grove data must be entered via the keyboard once more or the
programs and data files must be reloaded into memory from cassette
tape or disk.
CHANGING PROGRAM VARIABLES
In many cases groves of 20 to 40 acres and smaller high density groves
will have more than 800 trees. The user may change two data values to
increase the maximum number of trees that can be entered into memory.
Under the current program constraints, only 800 trees may be mapped
without generating an error message.
The user can change these values by first moving the cursor movement
key over the filename "BASIC" and pressing . Enter the command
LOAD "CITMAP.BA" (quotes are required) and press . Once the
CITMAP.BA is loaded which is indicated by the word "OK" enter the
command as follows:
EDIT 2600
When is pressed, the user will see on the screen the following
source code listed:
2600 DATA 10: DATA 8: DATA 15: DATA 3: DATA 800: DATA 66
The values listed above are used for the following routines:
DATA: 10 The variables used to describe the grove to be surveyed
DATA: 8 Field information requested for each grove
DATA: 15 The maximum labels available to describe trees
DATA: 3 The maximum groves mapped without saving to cassette
DATA: 800 The maximum trees in a grove
DATA: 66 The maximum rows in a grove
Changing the values for "DATA 3" and "DATA 800" will increase the
number of trees that can be entered for one grove. The user may use
the horizontal cursor key to move the cursor over the number "3".
When the combination of the shift and delete keys are pressed
simultaneously the "3" can be deleted. Once deleted another value,
for example "1" can be entered. NOTE: do not press the key
after entering a value. The cursor key can be moved over the digit
"8" of the number "800". Entering a shift-delete will remove the
number "8". Once deleted another value, for example "24" can be
entered. The line should read as follows:
2600 DATA 10: DATA 8: DATA 15: DATA 1: DATA 2400: DATA 66
Once the correct values are confirmed, the key must be pressed
before the change will be accepted. If the combinations of number of'
groves and number of trees in a grove are too large an out of memory
error will occur either while entering trees during the survey or
while saving the data as an ASCII file.
To change the number of labels, the user must move the horizontal
cursor key over the "15" of DATA 15. Pressing the Shift and Delete
keys simultaneously will remove the digits and the user can enter a
new value. To save the change, the "F8" key must be pressed to save
the new value.
It is not advisable to change the first two data values because
of the number of changes necessary in the source code.
FIGURE 1. Flowchart of Citrus Survey Program
START
SELECTION 2
OPTION 2 TREE
CORRECTION
MENU
I -- --
PART II
CITRUS MAPPING
TRANSFERRING ASCII FILES
The user must first transfer the ASCII files in the Radio Shack TRS-80
Model 100 to the Apple computer. The instructions with the Model 100
contain the necessary protocol for the transfer. Any communications
software package for an Apple II such as but not limited to ASCII
Express or Softerm will allow the transfer via the RS-232 port of a
serial card from 300 to 19200 baud. Once the transfer is complete,
the data files are saved on disk.
Figure 2 is a flowchart of the Citrus Mapping Program showing the
menus for creating text files and map reports.
The user must insert the Citrus Mapping Program disk into the disk
drive #1 and the data disk containing the grove files on disk #2.
Once the Apple is powered up, the following menu will be displayed on
the monitor screen:
CITRUS GROVE RESOURCE MENU
1. CONVERT TO APPLE TEXT FILES
2. PRINT GROVE MAP
3. DIRECTORY
4. QUIT
SELECT 1, 2, 3 OR 4...
SELECTION #1: CONVERT TO APPLE TEXT FILES allows the user to format
three Apple text files from the TRS-80 Model 100 grove file. The user
will be asked to enter the specific name of the grove file. The
display on the screen will be:
ENTER GROVE FILE NAME
>>> (DUNCAN)
ENTER <0> TO EXIT
In this example the grove file name is Duncan. If <0> is entered, the
user will be returned to the Citrus Mapping Menu. If a filename is
entered and cannot be located on the disk in drive #1, then the disk
in drive #2 will be checked. If the file is not located on either
disk the user will be returned to the above input for the file name.
A double beep will signal the user of the erroneous input with the
message:
FILE NOT FOUND....
If the file is found, the display on the screen will be:
...PLEASE WAIT...
...LOADING DUNCAN...
Once the grove file is loaded, in this example the grove named
DUNCAN, the following message will be displayed on the screen:
...PLEASE WAIT...
CREATING ROWS 22 TREES LONG
This particular routine will even out the block with dots in the event
that the grove has irregular rows due to ponds, bayheads, ditches,
etc. The exact length of the rows will be determined by the longest
row in the grove. In this example row length was chosen to be 22
trees long. Once completed, the following message is displayed on the
screen:
...PLEASE WAIT...
REVERSING ALTERNATE ROWS
This routine reverses alternate rows because the field inputs are
continuously entered from one row to the next. Without this routine,
the data from alternate rows would be read onto the screen or printed
on the printer backwards. The next message displayed on the screen
is:
...PLEASE WAIT...
CREATING DUNCAN:0584.MAP
The map routine writes a sequential file containing 1.) the number of
rows in the block, 2.) the trees in each row, and 3.) tree
information as modified by the two routines "squaring out the block"
and "reversing alternate rows". The name of the grove file is
automatically inserted in the screen message, for example
"DUNCAN:0584". The file name in this example consists of the block
name and the survey date consisting of the month (05) and year (84).
When the map routine is completed, the following message is displayed
on the screen:
...PLEASE WAIT...
CREATING DUNCAN:0584.TREES
1235
The tree routine first calculates the total acreage, total trees, and
the acreage and trees for each label used in mapping a particular
grove. An inverse video window displays the tree number as each tree
is counted. The data is then written onto the disk as a sequential
file. The following message appears on the screen:
...PLEASE WAIT...
CREATING DUNCAN:0584.INDEX
The index routine writes a sequential file containing 1.) the number
of labels selected by the user, 2.) the name of each label and the
ASCII equivalent of the keyboard character representing the label, 3.)
the number of rows in the block, 4.) the trees per row, 5.) the eight
inputs describing the grove and 6.) the date and time inputs. Upon
completion, the user is returned to the Citrus Grove Resource Menu.
SELECTION #2: PRINT GROVE MAP allows the user to create a printed
copy of the grove map file using the three files created by selection
#1 CONVERT TO APPLE TEXT FILES. The following message will be
displayed on the screen:
CITRUS PRINT MENU
1. PRINT A GROVE MAP
2. DIRECTORY
3. RETURN TO RESOURCE MENU
4. QUIT
SELECT 1, 2, 3, OR 4...
SELECTION #1: PRINT A GROVE MAP allows the user to print a
statistical report which includes the name and description of the
grove and a scale map of the grove. The user'will be asked to
identify the name and the date of the block selected to be mapped.
The following message will be displayed on the screen:
NAME OF BLOCK TO BE MAPPED? (DUNCAN)
ENTER MONTH YEAR SURVEYED 0584
The name of the data file is entered, for example DUNCAN and the month
and year is entered in numerical form as 0584 without a space between
the month and year. If the name and/or month are incorrect, the
following message will be displayed on the screen:
FILE NOT FOUND
A double beep will sound to alert the user of the input error. The
user will then have to reenter the name and date of the desired 'lock.
Upon entering the correct information, the user will see the following
message on the screen:
...PLEASE WAIT...
LOADING DUNCAN:0584.INDEX
Once the file is loaded into memory, the user will be asked the
following question:
DO YOU WANT MAP PRINTED WITH
NORTH AT TOP OF PAGE?...(Y/N)
>. -'
The user may enter and the program will
same orientation as the grove was surveyed.
then the program will rotate the grove file
the grove will be printed at the top of the
print the grove, map in the
If the user enters
so that the north side of
page.
First, the grove map file is loaded into memory as the following
message is displayed on the screen:
...PLEASE WAIT...
LOADING GROVE MAP
While the data sort is underway, the user will see the following
message on the screen:
...PLEASE WAIT...
...DATA SORT...
The following message will be displayed on the screen upon completion
of the data sort:
PRINT FORMAT FOR GROVE MAPS
1. PRINT ALL INFORMATION
2. PRINT SELECTED INFORMATION
ENTER CHOICE (1 OR 2)...?
OPTION #1: PRINT ALL INFORMATION allows the user to create a map
report that will include all information entered by the surveyor for a
particular grove.
OPTION #2: PRINT SELECTED INFORMATION will allow the user to
selectively choose the number of labels used to map a given grove.
After a choice is made, the following information will be displayed on
the screen:
SYMBOLS LABEL
Q VALENCIA
A HAMLIN
W PINEAPPLE RESET
S HAMLIN RESET
X MISSING
In this example the above keyboard characters were chosen to represent
the varieties listed in the opposite column. The user will see the
following message._.n.th score n: ........ .. .. ........
(SELECT NUMBER OF SYMBOLS TO BE PRINTED
ENTER CHOICE (1 TO N-1)...?
If the input is incorrect, the user will be alerted to the error 'Ty a
double beep and be returned for a correct entry. The user may select
any number of labels up to one less than the total labels used in the
survey. "N-I" represents the maximum number of symbols that can be
selected. The next screen to be displayed is:
I ENTER SYMBOLS TO BE PRINTED...
The user may enter any of the keyboard characters as listed above. An
incorrect entry will result in a double beep and the following message
will be displayed on the screen:
IMPROPER ENTRY...TRY AGAIN!
Upon completion, the grove file is ready for printing. If the printer
is not on, the following message will be displayed on the screen:
PLEASE TURN PRINTER ON!
Once the printer is turned on, the map report will be printed with a
statistical report and a scale map of the grove. Upon completion,
the Citrus Map Print Menu will be displayed on the screen.
SELECTION #2: DIRECTORY displays or catalogs all files found on the
data disk in Drive #2.
SELECTION #3: RETURN TO MAPPING MENU returns the user to the Citrus
Mapping Menu for additional formatting of Model 100 ASCII files into
Apple text files.
SELECTION #4: QUIT terminates the Citrus Mapping Program.
PROGRAMMING INSTRUCTIONS
Substantial changes may be necessary to alter the Citrus Mapping
Program to operate on printers other than the IDS 560 Paper Tiger
printer. These printer commands are:
CHR$(9);"132N"
CHR$(30)
CHR$(27);"J,0,1020,$"
2110 CHR$(27);"H,12,$"
Line# 2450
Line# 2455
Line# 2500
2500
Line# 2535
Line# 2630
Line# 2650
2650
CHR$(12)
CHR$(27);"H,12,$"
CHR$(27);"P,84,$"
CHR$(27);"B,17,$"
CHR$(27);"H,48,$"
CHR$ (12)
CHR$(27);"P,0,$"
CHR$(27);"B,6,$"
Horizontal tab
12 Characters per inch
Left & Right Margins-Printing
width of 8.25 inches
Absolute Vertical Position 1/4
inch from top of page
Form feed
Absolute Vertical Position 1/4
inch from top of page
Intercharacter spacing
Vertical spacing
Absolute Vertical Position
1 inch from top of page
Form feed
Intercharacter spacing & Vert
spacing default values
Line# 2110
2110
2110
The values in the data statements in Line# 2880 and 2890 are the
values used for the ten spacings from 7.5 feet to 30 feet. These
values are read in groups of four representing:
1. The spacing in feet between trees
2. The horizontal printer value representing the above spacing
3. The vertical printer value representing the above spacing
4. The number of rows across a ten acre block
Line# 2880:
DATA 7.5,2,4,88,10,11,6,66,12.5,20,7,52,15,29,9,44,17.5,38,10,37
Line# 2890
DATA 20,47,12,33,22.5,56,13,29,25,65,14,26,27.5,75,16,24,30,84,17,22
If a scale map is desired of the grove, these values must be
calculated for the specific printer to be used. Note: The values
"84" and "17" used in Line# 2500 represent the horizontal scale and
vertical scale respectively for a 30-foot spacing.
FIGURE 2. Flowchart of Citrus Mapping Program
ADDENDUM
The Citrus Grove Resource Menu on page 23 has been expanded
to include a wide variety of printers in addition to the IDS-560
Paper Tiger. When the program disk is inserted in disk drive #1
and the computer is turned on, the following menu will be
displayed on the monitor screen:
CITRUS GROVE RESOURCE MENU
1. CONVERT TO APPLE TEXT FILES
2. PRINT MAP IDS PRINTER
3. PRINT MAP GENERIC PRINTER
4. DIRECTORY
5. QUIT
SELECT 1, 2, 3, 4 OR 5...
SELECTION #2: PRINT MAP IDS PRINTER allows the user to
create a printed copy of the grove map file consisting of a
statistical report and a tree map printed to scale. This program
require an IDS-460 or IDS-560 Paper Tiger printer.
SELECTION #3: PRINT MAP GENERIC PRINTER produces a grove
map similar to selection #2. This is a generic program which
should run on most printers. The printer must be set for 10
characters per inch and either 6 or 8 lines per inch. The tree
map produced will be printed in text form; therefore, the maps
will be distorted vertically with most tree spacings.
-=OPMR^ArWVE EXTENSION SERVICE, UNIVERSITY OF FLORIDA, INSTITUTE OF FOOD AND AGRICULfTURAL
SOIENCML K MT~Y11atler, director, In cooperation with the United States Department of Agricuirture, publishes thts Infor-
thatt6n I~to hot the purPott Of the MAY I and June 30, 1914 Acts of Contgressl and Is authorized to Provide research, *due&-
Vorw InfonnOdnAndt other sarvIces onty to Individuals and Institutions that function without "egrd to rcace color, sex or
4utionitt ottals, $WW*e ioples of Extension putilications (excluding 4-H and Youth oublicattors) are avastable free to Florkin
'fsktontu frm CO4ostv Extension Offices. InforMation an bulk rates or coPles for out-of-state PUrchasers Is walalabe fhon
1:_1 K, +4(jttoo, OWMd~alions Distfibution Comme, WFAS aulldin~g 664. University of Florida, Gainestilim, Florida 32611. Before pubtdiizhlittals
pubimtto editaest Moutd contact this address to determine availability.
