TeeJet Fieldware Tool User Manual

FIELDWARE® TOOLS
USER MANUAL
Utilities for Guidance Applications
Software Version 3.00a
Table of Contents
MAP MANAGER 1
MENUES 8
The View Menu .................................................................................................................................................. 10
The Edit Menu .................................................................................................................................................... 11
The Build Menu .................................................................................................................................................12
THE BUILD PROFILE APPLICATION 13
Customer Prole ...............................................................................................................................................13
Dealer .................................................................................................................................................................... 14
Product .................................................................................................................................................................15
Applicator ............................................................................................................................................................16
BUILDING AN APPLICATION REPORT 17
The Maps/File Dialog .......................................................................................................................................18
The Field Conditions Dialog ..........................................................................................................................19
The Product Setup Dialog .............................................................................................................................20
Running the Product Wizard ........................................................................................................................21
The Job Setup Dialog ...................................................................................................................................... 23
The Document Setup Dialog ........................................................................................................................ 23
CONVERTING FILES USING MAP MANAGER 25
The File Conversion Process .......................................................................................................................... 25
Step 1: Selecting The Source File ...................................................................................................25
Step 2: Selecting The Destination File .............................................................................................27
Step 3: Selecting The Type Of Objects To Convert .........................................................................27
Step 4: Selecting A Template ........................................................................................................... 28
Step 5: Converting The File .............................................................................................................29
FIELD TRANSFER TEMPLATES 30
Setting Up A Field Transfer Template ........................................................................................................32
Conguring A Field Transfer .........................................................................................................................33
ABOUT FORM A SAMPLING PATTERN 35
QUICK START 36
THE SETUP PROCESS USING MENU PAGES 37
The Main Setup Page.......................................................................................................................................37
Client-Farm-Field Menu Fields ........................................................................................................37
Setup File Menu Field ......................................................................................................................37
Background File Menu Field ............................................................................................................37
Output File Menu Field ....................................................................................................................37
The Grid Setup Page ........................................................................................................................................38
Store Grid Menu Field ......................................................................................................................38
Store Points Menu Field ..................................................................................................................38
Sampling Pattern Menu Field ..........................................................................................................38
Cell Area Menu Field ........................................................................................................................................39
Cell Horizontal and Vertical Length Menu Fields .................................................................................. 39
Completing the Setup Process ....................................................................................................................40
Orienting the Sample Grid ............................................................................................................................ 40
Rotating the Grid ..............................................................................................................................................41
Rotating the grid by entering a rotation angle ..................................................................................41
Rotating the grid using the “Spin” buttons .......................................................................................42
Shifting the Grid ................................................................................................................................................ 42
Shifting the grid using the shift buttons ............................................................................................42
Shifting the grid using the mouse ....................................................................................................42
Completing the Grid Orientation................................................................................................................42
Positioning the Sample Points .....................................................................................................................43
Fieldware
®
Tools
FIELDWARE TOOLS
Copyrights
© 2011 TeeJet Technologies. All rights reserved. No part of this document or the computer programs described in it may be reproduced, copied, photocopied, translated, or reduced in any form or by any means, electronic or machine readable, recording or otherwise, without prior written consent from TeeJet Technologies.
Trademarks
Unless otherwise noted, all other brand or product names are trademarks or registered trademarks of their respective companies or organizations.
Limitation of Liability
TEEJET TECHNOLOGIES PROVIDES THIS MATERIAL “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED. NO COPYRIGHT LIABILITY OR PATENT IS ASSUMED. IN NO EVENT SHALL TEEJET TECHNOLOGIES BE LIABLE FOR ANY LOSS OF BUSINESS, LOSS OF PROFIT, LOSS OF USE OR DATA, INTERRUPTION OF BUSINESS, OR FOR INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY KIND, EVEN IF TEEJET TECHNOLOGIES HAS BEEN ADVISED OF SUCH DAMAGES ARISING FROM TEEJET TECHNOLOGIES SOFTWARE.
About Fieldware Tools
Fieldware Tools is a subset of TeeJet Technologies’ Fieldware suite. This chapter covers several utility
applications that will make your life a little bit easier. Currently Fieldware Tools consists of ve applications: Convert Files, Form A Sampling Pattern, Map Manager, Name Manager, and Reorganize Prescription les. All
Fieldware Tools are accessed from the Fieldware Launcher Tools Menu.
Figure 1: Fieldware Tools Menu
iv
www.teejet.com
Fieldware® Tools
MAP MANAGER
Map Manager is a data le viewing and conversion tool. The following Swath XL/GuideLine/Fieldware data les
can be viewed in the Map Manager:
.GMF - General Mapping File
.BND - Field Boundary File
.RCD - Spray Trajectory and Application Rate Record File
.RPT - Application Report File
.GLN - Guideline File
The current version of Map Manager can view any combination of the above le types, as well as the following les used only by Fieldware:
.ARM - Prescription File
.SPT - Marked Sample Points File
.SHP - ESRI Shape File
Map Manager also allows you to zoom, pan, and print the les displayed. (Figure 2) shows the a spray trajectory record le, a boundary le, a hazard le, and the guideline le in a single Map Manager view. The left side of the Map Manager window is the directory and le tree and the right side is the data viewing window. Data les are loaded into the view window by double clicking on the le in the directory and le tree. You can view les from different clients, farms, and elds within the same view window. Each map le that is loaded into the view page is
considered a single layer.
NOTE: Files created in fieldware programs are automatically given the “Client/Farm/field” format. Those created
in Swath XL & GuideLine products are not created in this format but can be stored that way using the procedure described in Appendix A.
98-05048 R3
1
Fieldware
Figure 2: Map Manager
®
Tools
2
www.teejet.com
Fieldware® Tools
Base Maps
You can also view background base maps such as USGS topography maps in Geo-Tif formats. (Figure 3) shows
a base map behind an as-applied map.
Figure 3: Viewing Base Maps
98-05048 R3
3
Fieldware
®
Tools
Color Prescription Maps
Map Manager now displays the Mid-Tech Application Rate Map (.ARM), a prescription map in color. (Figure 4) shows an example of an (.ARM) prescription map displayed in Map Manager.
Figure 4: View of Prescription Map
4
www.teejet.com
Fieldware® Tools
Object Information Query
It is possible to query any type of data that can be viewed in Map Manager. Using the pointer tool, select by
clicking on the area of the view you want to obtain information about. The area selected changes to a uorescent
green color and an “Object Information” dialog box appears on the left hand side of the Map Manager window. The “Object Information” dialog box displays a variety of information about the object selected, such as position
and name. If the selected object is an application Record File (.RCD) you can query the individual polygons and obtain information. (Figure 5) shows an information query on a Fieldware “as applied” map sprayed swath object. (Figure 6) shows a close up of the “Object Information” dialog box for the sprayed swath query. If the area you
select has several objects layered one on top of the other, the “Object Information” dialog box displays the number of objects selected as “Objects Found” and allows you to select and view information for each object.
Figure 5: Object Information Query Feature
Figure 6: Object Information
Dialog
98-05048 R3
5
Fieldware
®
Tools
The Map Manager Tool Bar
The tool bar allows you to rapidly manipulate how the data is viewed in the window. Layers can be added and removed from the view, as well as unloaded from the view. The current or active layer is considered to be the layer that sits on top of all other layers. To remove or unload a layer, make it the current layer and click on the remove current layer button. Only the current layer can be removed.
Figure 7: The Map Manager Tool Bar
Current (top) Layer Name Zoom to Current Layer Extents File Saving Zoom to Extents
Open Existing File Layers On/Off Pan
New File (Layer) Remove Current Layer Select, Zoom
Table 1: Map Manager Tool Bar Button Descriptions
Button Description
New File (Layer) - creates an new le (layer) and places it at the current (top layer) in the map view. You are prompted for the new le name.
Open Existing File (Layer) - you are prompted with an Open File dialog from which you can select and open an existing le (Layer), which is placed at the top layer in the map view.
Drawing Tools
6
www.teejet.com
Save File (Layer) - save the current (top layer) in the map view.
Save All - saves all les (layers) displayed in the map view.
Print - prints the current map view with all visible layers.
Remove Layer - press to remove (not delete) current (top) layer from the view. This does not delete the le.
Layers On/Off - brings up the layers On/Off dialog box. You can then turn layers on and off
from this dialog box.
Zoom to Current Layer - zooms to the data extents of the current (top) layer.
Zoom to Extent - zooms to the data extents which all visible layers are contained.
Button Description
Undo Zoom - returns to the previous zoom state.
Selection Arrow - activates the selection arrow (pointer).
Zoom In - enlarges (magnies) the map view. Two modes, drag box and point and click.
Zoom Out - increases area displayed in the map view. Two modes; drag box and point and click.
Pan - select this button and then place hand in map view and hold down left mouse button. Moving the hand with left mouse button depressed moves the contents of the map view in a panning fashion.
Point Object - select this button and left click in the map view to place a point object in the view.
Hazard Object - select this button and left click in the map view to place a hazard object in
the view. In real time applications the user is notied when approaching a hazard.
Fieldware® Tools
Polyline Object - select and draw a polyline in the map view. Double click the left mouse button to stop drawing.
Polygon Object - select and draw a polygon object in the map view. Double click the left mouse button to close and stop drawing the polygon.
Circle Tool (Drag Option) - select this and draw a circle by pressing and holding down the
left mouse button. Drag the mouse with left button depressed to create the desired radius, release left mouse button to create circle object. Select and hold down left mouse button on
the circle tool and two other circle drawing options (Radius and 3-Point) appears in the drop
down tool.
Circle Tool (Radius Option) - select and click left mouse button at center location of desired
circle in the map view. A small Radius dialog box appears. Enter the desired circle radius and click OK.
Circle Tool (3-Point Option) - select and click left mouse button on three different locations
you want the circle perimeter to intersect. Once the third point is selected, the circle is drawn.
98-05048 R3
7
Fieldware
®
Tools
MENUES
The File Menu
Almost all tool button functionality can be duplicated in one of the drop down menus. The File Menu allows you to
switch the root directory, print the view, set up the print view and exit the Map Manager tool (Table 2).
Figure 8: The File Menu
Table 2: Map Manager File Menu Item Descriptions
Menu Item File Menu Item Description
New
Open
Save Save File (Layer) - save the current (top layer) in the map view.
Save As
Save All Save All - saves all les (layers) displayed in the map view.
Convert
Print Prints the current map view with all visible layers.
Print Setup Sets up the print function.
Root Directory
Exit Select to Exit the Map Manager Program
New File (Layer) - creates an new le (layer) and places it at the current (top layer) in the map view. You are prompted for the new le name.
Open Existing File (Layer) - you are prompted with an Open File dialog from which you can select and open an existing le (Layer), which is placed at the top layer in the map view.
Saves current (top layer) le as a different le name. You are prompted with the Save As
dialog box.
Starts up the convert application which allows you to convert Fieldware data les to ESRI shape les and vise-versa.
Select to change the root (highest level) folder displayed in the le tree on left hand side of
Map Manager.
8
www.teejet.com
Fieldware® Tools
The Layers Menu
The Layers Menu allows you to manipulate and query information associated with a map layer in the map view
window (Table 3).
Figure 9: The Layers Menu
Table 3: The Layer Menu Item Descriptions
Menu Item Layer Menu Item Description
Select Current
Properties Activates the Layers Properties dialog box.
Remove Current
Remove All Removes all layers from the map view.
On/Off
Allows you to select the current (Top) layer. This can also be accomplished from the Tools
menu bar, see Table 1.
Removes current layer. This can also be accomplished from the Tools menu bar, see Table 1.
Activates the Layers On/Off dialog box. This can also be accomplished from the Tools
menu bar, see Table 1.
98-05048 R3
9
Fieldware
®
Tools
The View Menu
The View menu sets up the Map Manager window (Table 4).
Figure 10: The View Menu
Table 4: The View Menu Item Descriptions
Menu Item View Menu Item Description
Tool Bar Places or removes the Tool bar from the Map Manager window.
Status Bar
Split Activates the split screen function, allowing you to resize the map view and le tree.
Zoom to Current
Zoom to Extent
Zoom Previous
Show Tags
Options
Show All Files
Places or removes the Status bar from the bottom of the Map Manager window and displays the current action as well as the real world coordinate position of the pointer.
Zooms to the current layers data extents. This can be accomplished from the tool bar, see Table 1.
Zooms to the data extents which all visible layers are contained. This can be accomplished from the tool bar, see Table 1.
Returns to the previous zoom state. This can be accomplished from the tool bar, see Table 1.
Displays a small yellow tag next to each object in the map view. The tag contains information about the object.
Brings up the Options dialog where the system units and coordinate system can be
changed, see (Figure 11).
When selected the le tree displays all le types. When de-selected, the le tree shows only Fieldware le types.
Figure 11: The View Options Dialog
10
www.teejet.com
Fieldware® Tools
The Edit Menu
This drop down menu covers most graphical object editing functions such as cut, copy and paste (Table 5). Many
of the edit menu items can also be accessed by selecting an object in the map view and then pressing the right mouse button.
Figure 12: The Edit Menu
Table 5: Edit Menu Item Descriptions
Menu Item Edit Menu Item Descriptions
Undo Delete Undoes a previously deleted object.
Redo Undoes a redo.
Cut Cuts a highlighted object from the view.
Copy Makes a copy of a highlighted object. To place the copy in the view, use paste.
Paste Pastes an object of a copy or cut object.
Delete Deletes a highlighted object.
Edit
Properties Displays the Object Information dialog, see (Figure 6).
Activates the Edit dialog box where object attributes such as object name can be modied. (Figure 13) shows an edit dialog box for a boundary polygon object.
Figure 13: The Edit Box for a Boundary Polygon Object
98-05048 R3
11
Fieldware
®
Tools
The Build Menu
This menu item activates the Prole Builder and the Report Builder. Build Proles allows you to construct various
data bases for Customer, Dealer, Applicator and Products. This data base information is used in the Build Report
application, see “The Build Prole Application” on page 16. The Build Report application allows you to generate an application report based on an existing record (.RCD) le, see “Building an Application Report” on page 20.
Figure 14: The Build Menu Item
12
www.teejet.com
Fieldware® Tools
THE BUILD PROFILE APPLICATION
The Build Prole application allows you to construct a set of small data bases specic to Dealer information, Customer Information, Applicator information, and Product Information. These proles are used when building an
Application Report using the Build Report application.
Customer Prole
The Customer Prole allows you to enter customer information. This information can then be selected in Build
Report and printed as part of the Application report.
Table 6: Customer Profile Field Descriptions
Field Description
ID Customer Identication Code (Optional).
Name Customer Name (Required).
Address Customer Address (Required).
City/Town Customer City or Town Name (Required).
State/Prov Customer State or Province (Required).
Postal Code Customer Postal Code (Required).
Country Customer Country (Required).
Telephone # Customer Telephone Number (Required).
Contact Customer Contact Name (Optional)
Figure 15: The Customer Profile Dialog
98-05048 R3
13
Fieldware
®
Tools
Dealer
The Dealer prole allows you to build a prole containing all of your dealer information. This information is then
used in the Build Report application.
Table 7: Dealer Profile Field Descriptions
Field Description
ID Dealer Identication Code (Optional).
Name Dealer Name (Required).
Address Dealer Address (Required).
City/Town Dealer City or Town Name (Required).
State/Prov Dealer State or Province (Required).
Postal Code Dealer Postal Code (Required).
Country Dealer Country (Required).
Telephone # Dealer Telephone Number (Required).
Contact Dealer Contact Name (Optional)
Figure 16: Dealer Profile Dialog
14
www.teejet.com
Fieldware® Tools
Product
Fieldware Map Manager comes with a complete Product prole, approximately 4625 products. Each entry
includes the Product Name, Common Name, Formulation, EPA Registration # and Manufacturer. It is unlikely that
you will need to add any additional products to this prole. Prior to adding a new product to this prole, make sure it is not already included. Updated Product Proles are available from Midwest Technologies Illinois, LLC. See
their web site for more information.
Table 8: Product Profile Field Descriptions
Field Description
Product Name The Name of the Product (Required).
EPA Reg # EPA Registration Number (Required).
Manufacturer The name of the product manufacturer (Optional).
Common Name The common name of the product (Required).
Formulation The product formulation, typically Liquid, Dry or Granular (Optional).
Figure 17: The Product Profile Dialog
98-05048 R3
15
Fieldware
®
Tools
Applicator
The Applicator prole allows you to build a prole for each of your drivers. This information is then used in the
Build Report application.
Table 9: Applicator Profile Field Descriptions
Field Description
Employee ID Employee Identication Code (Optional).
Last Name Applicator’s last name (Required).
First Name Applicator’s First Name (Required).
SS# (SIN#) Applicator’s Social Security Number (SIN#) (Optional).
Drivers License Applicator’s drivers license number (Optional).
Applicators License
Expiration date The expiration date of the Applicator’s license (Optional).
Supervisor The applicator’s supervisor (Optional).
Figure 18: Applicator Profile Dialog
Applicator’s applicator’s license number (Required).
16
www.teejet.com
Fieldware® Tools
BUILDING AN APPLICATION REPORT
You can build an Application Report based on an existing record le (.RCD). The Build Report application utilizes existing Customer, Dealer, Product and Applicator proles generated by the Build Proles application.
To build an application report it is recommended that you rst select and view the record le (.RCD) the report is based on. You can also select and view the associated eld boundary (.BND) le. Viewing the (.RCD) and (.BND) les are not required, but it is very useful to view this data prior to generating a report to ensure that they are the correct les (Figure 19).
Once you have the data displayed in the map view window (right side) of Map Manager, select Report - Swath XL / GuideLine 3.0 from the Build menu located in the Map Manager menu bar, see “The Build Menu” on page 15.
Once selected, the Report Generation dialog appears.
Figure 19: Viewing Data Prior to Building an Application Report
The Report generation dialog contains ve tabbed setup dialogs, Maps/Files, Field Conditions, Product Setup, Job Setup, and Document Setup. Building a report is easy if you select each tab in order starting from the left (Maps/ Files) and ending at the right most tab (Document Setup). Each tabbed dialog is described in more detail below.
98-05048 R3
17
Fieldware
®
Tools
The Maps/File Dialog
In this report dialog you select the data les you want to base the report on. Each report is based on a single record le. Therefore you can select one record le (.RCD), one boundary le (.BND) and several general mapping les (.GMF).
Select the folder where the data is located using the Browse button. Relevant data les are displayed in the Include in Report or Don’t Include windows in the dialog (Figure 20). To move a le between these two windows, highlight the le you want to move and then press the direction of movement arrow located between the two windows. A preview of the le is displayed to the right in the preview window. Once you have the desired les you
want to base the report on in the Include in Report window, you are ready to move to the Field Conditions dialog. To move to the Field Conditions dialog, select the Field Conditions tab with the mouse.
Figure 20: The Build Report Maps/Files Dialog
18
www.teejet.com
Fieldware® Tools
The Field Conditions Dialog
The Field Conditions dialog allows you to enter Weather, Soil, Crop, and Growth Stage information in the report
(Figure 21). Enter or select the appropriate Field Conditions. You can move from one data eld to the next by
pressing the Tab key on your keyboard. None of the Field Condition information is required to generate a report. Once the desired Field Condition information has been selected, you are ready to move to the Product Setup dialog. You do this by clicking on the Product Setup Tab.
Figure 21: The Build Report Field Conditions Dialog
98-05048 R3
19
Fieldware
®
Tools
The Product Setup Dialog
The Product Setup dialog (Figure 22) allows you to enter information about the product(s) that were applied and represented in the record (.RCD) le. In order to enter the appropriate product information, you must run the
Product Wizard. To start the Product Wizard, press the Product Wizard button located in the Product Setup dialog
(Figure 22).
Figure 22: The Build Report Product Setup Dialog
20
www.teejet.com
Running the Product Wizard
Select the type of application you are doing
(Figure 23). Press the Green forward to move to the
next wizard page.
Figure 23: Product Wizard Application Type
Next select the number of products used in the
application (Figure 24).
Figure 24: Product Wizard Number of Products
Fieldware® Tools
Figure 26: Product Wizard Product Unit
Next enter the Product Application Rate, Total Amount
of product applied, or both (Figure 27)
Figure 27: Product Wizard Application Rate
Select the Product Name (Figure 25). This is the list of products found in the Product Prole. You can press the NEW button to go directly to the Prole Builder.
From there you can add or edit a product.
Figure 25: Product Wizard Product Name
Once the product name has been selected, press the
Green arrow and select the Product Unit (Figure 26).
If you have selected more than one product, the Product Wizard cycles back through Product Name, Unit, and Application Rate until all products are
identied. After all product information is entered,
the next Wizard page is based on the Application
Type selected in the rst Wizard page (Figure 23). In this example a Liquid (Wet) product was selected. Therefore the next Wizard page is Water Unit (Figure
28). If a dry application type was selected the water (carrier) Wizard pages would not appear.
Figure 28: Product Wizard Water Unit
98-05048 R3
21
Fieldware
Next enter the Water Application Rate, Total Amount of
Water applied, or both (Figure 29).
Figure 29: Product Wizard Water Rate
The Product Wizard is now complete. Press the Finish bottom to return to the Product Setup dialog. You should see your new product information displayed in
the table of this dialog (Figure 30).
Figure 30: Report Generation Product Setup Completed
®
Tools
22
www.teejet.com
Fieldware® Tools
The Job Setup Dialog
The Job Setup dialog (Figure 31) is where you can select Job related information you want included in the Application Report. Dealer, Customer, and Application names are stored in their associated proles. If you need to create or edit any of these elds, press the NEW button to launch the Build Prole application.
Figure 31: The Build Report Job Setup Dialog
The Document Setup Dialog
The last Build Report dialog is Document Setup (Figure 32). In this dialog you can select a Dealer logo (JPEG & BMP formats) that will be included in the application report. The Build Report As button will let you name the
report and save it where you like, much like a Save As option in any Windows program. The Build Report button
(recommended) builds the report based on the name of the record (.RCD) le and save it in the same folder that the record (.RCD) le is stored. The name of the report and where it will be saved is displayed in the Save Path window. After one of the Build buttons is pressed, the Report View dialog is displayed showing you the nal
Application Report. From this dialog you can zoom and pan as well as print the report.
98-05048 R3
23
Fieldware
Figure 32: The Build Report Document Setup Dialog
Figure 33: The Report View Dialog
®
Tools
24
www.teejet.com
Fieldware® Tools
CONVERTING FILES USING MAP MANAGER
Map Manager contains a le option named Convert, which provides a means of transferring data between Fieldware data les and ESRI Shape les. Convert was designed to be both exible and simple. It allows beginning users to perform conversions in ve simple steps, while offering advanced users full control over the
data transfer process. To better understand how the Convert option works, we will examine the steps required to
convert a le. Later we will show how Convert may be used to perform custom data transfers.
The File Conversion Process
The le conversion process can be broken into the following 5 steps:
1. Select the le you wish to convert (the source).
2. Select the le you wish to convert to (the destination).
3. Select the type of objects you wish to transfer between the source and destination.
4. Select a template describing how the objects should be transferred.
5. Convert the le. Each of these steps is discussed in greater detail below.
Step 1: Selecting The Source File
The source le contains data you would like to convert to a different format. Select the source le from Map Manager’s main window. To select a source le, simply open the le using Map Manager’s “File|Open” option or Map Manager’s le tree. You may open/view Swath XL/GuideLine les, Fieldware les or Shape les (.shp)
within Map Manager. Shape les must be in NAD83 or WGS84 Lat/Long coordinates. No other projections or datums are supported. ESRI shape les consist of .shp, .shx, and .dbf les, all sharing the same le name. Shape les appear as simple line drawings in the Map
Manager Map. If you choose to open multiple les, the current le (layer) is used as the source le. After selecting a source le, choose the “File|Convert” option. In (Figure 34), a prescription le named Spring 99-DAP.arm has been selected as the source le and the “File|Convert” option is being selected. When the “File|Convert” option is chosen, the Convert dialog is presented. Your source le’s name appears in the dialog’s Source group and the source le’s image appears in the dialog’s Map (see Figure 35).
98-05048 R3
25
Fieldware
Figure 34: Selecting Convert from File Menu
Figure 35: The Convert Dialog
®
Tools
Source File
Source File Image
26
www.teejet.com
Fieldware® Tools
Step 2: Selecting The Destination File
The destination le holds objects and data converted from the source le. Unlike the source le, it is selected from within the Convert dialog. To select a destination le, press the Save As button in the Destination group. A standard Save As dialog appears. Specify the full name and extension of the destination le in the Save As dialog. The destination must be a new le with one of the Save as types. Therefore, existing les may not be selected. Once you have entered a lename, press the Save button. The destination le you specied appears in the Destination group. In addition, the “Object Combo” box and Template group are activated. In (Figure 36) we have selected Spring 99-DAP.arm as the destination le. As can be seen, the “Object Combo” box and Template group
are no longer grayed out.
Step 3: Selecting The Type Of Objects To Convert
Both Shapeles and Fieldware les contain objects such as Points, Polylines, and Polygons. Where Fieldware les such as the GMF or BND le can contain several object types per le, Shapeles are limited to just one type per le. Therefore, when we convert Fieldware les to or from Shapeles, we must convert one object type at a time. For example, suppose we have a BND le containing Boundary Polygons, Polylines, and Points. Let’s assume that we wish to convert this le to a Shapele. Given that the Shapele can only hold one type of object,
we must specify whether we want to pass it Boundary Polygons, Polylines, or Points. We select which type of
object to transfer via the “Object Combo” box. The “Object Combo” box provides a list of available Fieldware le objects for us to choose from. If the source le is a Fieldware le, the “Object Combo” box contains the list of objects in the Fieldware le. If the Fieldware le is the destination le, the “Object Combo” box contains the list of objects accepted by the Fieldware le which may be attained from the Shapele. When you select a destination le, the “Object Combo” box activates and presents you with a default object type. If the type is not acceptable,
select one of the other object types from the “Object Combo” box’s list. When you select a new object type, the
template list is updated to reect the list of available templates matching the type. In (Figure 36), we have chosen to accept the default (and only available) object type: Prescription.
98-05048 R3
27
Fieldware
Figure 36: Completed Convert Dialog
File Destination
Object Combo Box
Template Group
®
Tools
Step 4: Selecting A Template
A template is essentially a set of instructions for transferring the selected object type to, or creating the selected
object type from a Shapele. The Convert Dialog provides us with a list of available templates for the conversion
we have selected and allows us to manage the templates using the New, Delete, and Edit buttons (when converting a .shp le for the rst time you are required to create a template.) In the next
section,“Field Transfer Templates” on page 34, we will discuss templates in greater detail. However, for now, let’s
just accept that we must select a template from the provided list. In (Figure 36) we have selected the Prescription
To SHP template.
28
www.teejet.com
Fieldware® Tools
Step 5: Converting The File
Before converting the le, we should discuss the “Remove Layer From Map” check box located in the Source
group and the “Add Layer To Map” check box located in the Destination group. These settings determine what
happens to the source and destination les after the conversion has completed and the Convert dialog is removed from the screen. The “Remove Layer From Map” check box species whether the source le (the current layer) should be removed from the Map Manager map. The “Add Layer To Map” check box species whether the destination le should be added to the Map Manager Map. If both boxes are checked, as in (Figure 36), the source le is replaced by the destination le as Map Manager’s current layer.
You are now ready to press the Convert button and set the data transfer in motion. Once the button is pressed, the Info bar begins displaying status information. If a problem is encountered, an error message is presented. If no
error occurs, the Convert dialog is removed from the screen and the Map Manager map is updated. (Figure
37) shows: (a) Spring 99-DAP.arm was converted to Spring 99-DAP.shp; (b) Spring 99-DAP.arm was removed from the Map Manager map; (c) Spring 99-DAP.shp was added to the Map Manager map.
Figure 37: The Converted Spring 99-DAP.SHP Map
98-05048 R3
29
Fieldware
®
Tools
FIELD TRANSFER TEMPLATES
As was mentioned earlier, a template contains the information required to transfer an Fieldware le object to an object in a Shapele, or create an Fieldware le object from an object in a Shapele. To better understand templates, we must rst understand the data which makes up an Fieldware le or Shapele object. An object (Polygon, Polyline, Point) is just a shape (one or more positions) with an associated set of attributes or elds. The shape’s elds specify information about the shape such as its name or ID. The shapes stored in a Fieldware le and Shapele objects are essentially the same. However, the elds associated with the shapes are different. In order to transfer the contents of an Fieldware le object to or from a Shapele object we must specify how the Fieldware le object’s elds are mapped or transferred to the Shapele object’s elds. It is the template which stores these eld transfers. Fieldware les can contain one or more object types where .shp les can only be a point, a polyline, or a polygon. To convert a .gmf le to .shp where the .gmf le contains points and polygons, you would run the conversion twice, once to make the point shapele and again to make the polygon shape le.
Figure 38: Converting To A Shape File
If you experiment with the Convert dialog, you will notice that different templates are displayed for different
combinations of the source le, destination le, and object type. This is because the elds for each Fieldware object type of Shapele are unique. The Convert dialog only displays templates which make sense for the selected les and object type. Under some circumstances, no templates are displayed because none of the existing templates contain appropriate eld transfers. You may have discovered that the a template named < None > is often included in the Template list (see (Figure 38)). This template is exactly what its name implies, a template
30
www.teejet.com
Fieldware® Tools
that doesn’t contain any eld transfers. When a le is converted using this template, only the shape portion of objects is passed between the source and destination les. No attribute or eld information is transferred. If
you want to create a prescription le (.arm), do not use the <NONE> template. Convert dialog does not allow the <None> template to be deleted or edited.
Sooner or later you will probably run across a situation which requires you to create or modify a template.
Templates are managed using the New, Delete, and Edit buttons located in Convert dialog’s Template group (see (Figure 38)). To create a new template press the New button. You are presented with the Field Transfer Template dialog (see “Setting Up A Field Transfer Template” on page 36). To delete the current template (the template whose name appears above the list) press the Delete button. You are presented with a message box that asks you to conrm the delete. If you are sure you want to delete the template, press the Yes button. Otherwise press
No. If you wish to edit the current template, press the Edit button. You are presented with the Field Transfer
Template dialog (see “Setting Up A Field Transfer Template” on page 36).
Figure 39: The Field Transfer Template
Field Transfer List
98-05048 R3
31
Fieldware
®
Tools
Setting Up A Field Transfer Template
In (Figure 39) we see the “Field Transfer Template” dialog. This dialog is used to set up a eld transfer
template. At the top of the dialog is the “Template Name” edit box. Templates should be given a unique
name which identies the type of conversion they are meant to handle. In (Figure 39), the template has been
named “Point to SHP”, identifying that this template
should be used for Fieldware Point object to Shapele
object conversions.
Below the “Template Name” edit box is the Field
Transfer list. This list contains the eld transfers or
mappings that will be performed between the given
source le and destination le objects. The elds of the source le object are presented in the list’s left-hand column and the elds of the destination le object are presented in the list’s right-hand column. In (Figure 39),
we are mapping the Fieldware Point object’s NAME
eld to the Shapele object’s SHP_NAME eld and the Fieldware Point object’s ELEVATION eld to the Shapele object’s ALTITUDE eld.
The New, Edit, and Delete buttons to the right of the Field Transfer List are used to change the entries in
the list. To create a new eld transfer, press the New
button. You are presented with the Field Transfer dialog
(see “Conguring A Field Transfer” on page 37). To delete the current eld transfer (the transfer currently highlighted in the list), press the Delete button. You are presented with a message box that asks you to conrm
the delete. If you are sure you want to delete the transfer, press the Yes button. Otherwise press No. If
you wish to edit the current eld transfer, press the Edit
button. You are presented with the Field Transfer dialog
(see “Conguring A Field Transfer” on page 37).
Several buttons in the Field Transfer Template dialog
only appear if you are transferring elds from an Fieldware le to a Shapele. The Up/Down Arrow buttons allow you to change the order of eld transfers
in the list. The order of the transfers determines the
order in which elds are written to the Shapele. In (Figure 39), the SHAPE_NAME eld precedes the ALTITUDE eld in the resulting Shapele. The Copy All button copies all the elds in the Fieldware le object to the Shapele object. Press this button if you want your Shapele object to contain an exact copy of the elds in the Fieldware le object.
Figure 40: The Field Transfer Dialog
32
www.teejet.com
Conguring A Field Transfer
In (Figure 40) we see the Field Transfer dialog. This dialog is used to congure a single eld transfer. The left-hand portion of the dialog denes a source eld which will be transferred to the destination eld, dened to the right. Each eld setting on the left is followed by an arrow button and a matching eld
setting on the right. When active, the arrow button may be used to transfer the contents of the left setting to the right. Pressing the Copy button at the bottom of the
screen is equivalent to pressing all of the active (not grayed out) arrow buttons.
The top pair of settings are used to dene the names of the elds. These settings may take the form of a
combo box or an edit box. If a combo box is present, you may select one of the names from its list. The list contains all the names located in or compatible
with the eld. If an edit box is present you must type in the name of the eld. In (Figure 40), we selected ELEVATION as the source eld’s name and entered ALTITUDE as the destination eld’s name.
The second pair of settings dene the eld’s types.
These settings take the form of either a combo box or
a text box (can’t edit). If a combo box is present, you
may select the type you wish to associate with the
eld. This affect how the eld is written to the le when
the conversion is performed. If a specic TYPE is listed in the box on the left it is best to chose the same for the box on the right.
In (Figure 40), we selected Double as the destination eld’s type.
Fieldware® Tools
Figure 41: The Build A Unit Of Measure Dialog
The nal pair of settings assign units of measure to the elds. These settings take the form of either a combo box or a text box (can’t edit). If a combo box
is present, you may select the unit of measure the
eld is (or will be) stored in. Take care in selecting a unit of measure. If the eld denes a name or some other non-numeric value, specify <None> for the unit of measure. If you don’t know the eld’s unit of measure, select <Unknown>. When the eld is
transferred, all necessary unit of measure conversions are automatically performed. Therefore, it is important
that the source eld’s and destination eld’s units
of measure are compatible. If you have entered incompatible units of measure, you are presented
with an error when you press OK. In (Figure 40), we selected feet as the destination eld’s unit of measure.
If the Unit Of Measure setting has a Browse button to its right, you may opt to build a unit of measure for the
eld. Pressing the button brings up the Build Unit Of Measure dialog (see (Figure 41)). This dialog allows you to select or compose a UOM (unit of measure)
from a long list of options. If you wish to select a UOM from the list, you may type the UOM’s name in the
“Unit Of Measure” edit box or nd the UOM in the list.
98-05048 R3
33
Fieldware
®
Tools
You can compose new compound UOMs (such as pounds/acre) by separating UOMs in the list with a ‘/’. Pressing the “/ (Per)” button adds the ‘/’ for you. If you
make a mistake, you can simply click the Clear button or erase the text in the “Unit Of Measure” edit box. When you select OK, your UOM is passed to the Unit Of Measure setting.
Figure 42: User Defined Fields
Under some circumstances, the Field Transfer dialog’s appearance undergoes some changes. One such circumstance arises when we set the source
eld’s name to <CONSTANT> or <COUNTER>. <CONSTANT> and <COUNTER> are special user-dened elds. They do not exist in the source le object. If you set the source eld name to <CONSTANT>, the source eld’s Type setting is replaced by a Value setting, (Figure 42). The Value
setting is a string or number that is passed to the
specied destination eld for each object written to le. If you set the source eld name to <COUNTER>, the source eld’s Type setting is replaced by a First
Number setting. As its name implies, the First Number setting represents the counter’s starting value. Each
time the counter value is transferred to the specied destination eld, it increments by one. For example, if we were to set the First Number to 2, the specied destination eld would receive a 2 for the 1st object, a
3 for the 2nd object, a 4 for the 3rd object and so on.
The Field Transfer Dialog also undergoes a change
when dealing with Fieldware prescription elds. As can
be seen in (Figure 43), two additional settings must be congured for prescription elds. The two extra
settings are Product Type and Product Name. Product Type takes the form of either a combo box or a text box
(can’t edit). If a combo box is present, you may select
the type of product being applied. Product Name takes
the form of either an edit box or a text box (can’t edit).
If an edit box is present, you may enter the name of the product being applied.
Templates are a complex, yet powerful tool. Creating templates takes some practice. However, once you get the hang of it, you should be able to perform an almost
limitless array of Fieldware/Shapele conversions.
Figure 43: Prescription Map Conversion In Field
Transfer Dialog
34
www.teejet.com
Fieldware® Tools
ABOUT FORM A SAMPLING PATTERN
The Form a Sampling Pattern program allows you to create, align, and rotate a sampling grid layer over
any existing data collected with Mid-Tech Fieldware software, such as a eld boundary. Once the grid is
properly oriented over the background data, sample point locations can be included with the grid based on several sample pattern options. This grid and point information can then be used in conjunction with the Fieldware - Sample & Waypoint Navigation and Fieldware - Field Mapping, Swath XL and GuideLine products.
Figure 44: Starting Form A Sampling Pattern From The Launcher
98-05048 R3
35
Fieldware
QUICK START
Select Form a Sampling Pattern from the Program Launcher Tools menu, or double click on the Form a Sampling Pattern icon in the Windows Explorer. The Receiver Process is not required for this program.
From the Main menu in the Setup page, enter the appropriate Client, Farm and Field information. For fast entry you may select the default Client, Farm, Field information that is
presented. Save this information in a Setup le.
Enter a background le name in the Background le menu eld. Typically this is the boundary le (.BND) for the eld that you are creating a sampling pattern for.
Enter the output le name in the Output File menu eld. The grid and associated point positions will be stored in this le.
Move to the Grid Menu page by pressing the GRID tab.
Store Grid menu eld, enter YES if you want the nal grid stored in the output data le.
Enter NO if you do not want to store the grid.
Store Points menu eld, enter YES if you want to store the sample points in the output le.
Enter NO if you do not want to store any points
Select the type of point sampling pattern.
Enter the grid cell size, either by area or height and width.
To save this information in the Setup le, press the SAVE button. To continue to the next
step press the NEXT button.
Orient the sampling grid using the rotation buttons and the shifting arrows.
Once the sampling grid is in the desired rotation, press the NEXT button to move to the Sample points page.
®
Tools
36
www.teejet.com
In the Sample Points page, edit, add, or delete any points. Once satised with sampling
pattern press the FINISH button.
Fieldware® Tools
THE SETUP PROCESS USING MENU PAGES
There are two Setup menu pages associated with this program, the Main page and the Grid page. It is important
to understand each menu item in each page in order to fully utilize this program. Each Setup page is identied by
the page tab located at the bottom of the Setup menu window. To move from one page to another, press the page tab using the associated Function key or the mouse. There are three additional buttons located at the bottom right of the Setup menu window: EXIT, SAVE and NEXT. EXIT returns you to the program launcher or the Windows
desktop. SAVE saves all menu page information in the Setup le that you select on the Main menu page. NEXT
brings you to the Orient Sample Grid page.
Navigation through all of the menu items is accomplished using the up and down arrow keys located on your computer keyboard, or via a mouse.
The Main Setup Page
The main setup page contains seven menu elds all pertaining to le information required to properly
run this program.
Client-Farm-Field Menu Fields
As mentioned in the Map Manager introduction section of this user’s guide, les and data adhere to the Client/ Farm/Field pattern. The rst three menu elds relate to this pattern, allowing you to better manage and organize your data. (Figure 45) shows the Main setup page with all menu elds selected. Once the Client-Farm-Field menu elds are selected, the next menu eld entry is the Setup le.
Setup File Menu Field
The Setup File eld contains the name of a le that will hold all menu item entries for the two menu pages, Main and Grid. A suggestion for naming the setup le is by the task being performed. As an example, in (Figure 45),
the task is building a sampling pattern for the Fall 1999 sampling campaign. Therefore the Setup and Output
le names are “Sample Pattern 99.d” and “Sample Pattern 99.gmf”. When adopting this naming convention, it becomes easier to identify which Setup le was used for which task.
Background File Menu Field
The Background File menu eld should contain the data set that you want to design a sampling pattern on. Typically this would be the boundary le (.BND) for the eld.
Output File Menu Field
The Output le is the le that will contain the sampling pattern data that you design. Typically this would be the sample point locations and the sampling grid. The Output le must be a new le each time you build a sampling pattern. If you enter the name of an existing le, you will not be allowed to store a sampling pattern in that le.
98-05048 R3
37
Fieldware
Figure 45: Main Setup Page
®
Tools
The Grid Setup Page
Pressing the GRID tab brings up the Grid Setup page. The Grid Setup page allows you to customize the sample pattern design, by selecting the type of pattern as well as the sample grid cell size.
Store Grid Menu Field
This menu item allows you to include the sampling grid in the Output le, by selecting YES. If NO is selected, then the sampling grid is not stored in the Output data le.
Store Points Menu Field
Similar to the previous menu eld, you can elect to store the sample points in the Output le by setting this eld to YES. If you select NO in this menu eld, the sample points are not stored in the Output data le. Typically you would store sample points in the Output data le. If you are interested in only generating a sample grid with out sample points then you would set this menu eld to NO.
Sampling Pattern Menu Field
The Sampling Pattern menu eld allows you to select a point distribution pattern from several sampling pattern
options: Regular, Staggered, and Unaligned. The pattern that you select directly affects where a sample point is positioned within a grid cell. If the pattern REGULAR is selected, then a sample point is positioned at the center of each sample grid cell. A STAGGERED pattern positions points in an alternating fashion, centering a point in one cell and in the next cell positioning a point in the center of the lower cell boundary. The UNALIGNED pattern
38
www.teejet.com
Fieldware® Tools
positions points in a random fashion across a gridded eld boundary ensuring that a point falls within each cell. (Figure 46) shows the “Sampling Pattern” selection box. This menu eld is only active if the Store Points menu eld is set to YES. Notice the pattern selected in (Figure 47) is Regular.
Figure 46: Sample Pattern Selection Box.
Cell Area Menu Field
The Cell Area menu eld allows you to enter the size of a sample grid cell. The cell area unit is based on the System Unit of Measure selected in the System Setup menu. If the System Unit of Measure is ENGLISH (US English), then the cell area unit is Acres. If the System Unit of Measure is METRIC, then the cell area unit is
Hectares. In the example shown in, the System Unit of Measure is ENGLISH, and therefore the Cell Area value is
5.00 Acres. As you enter a cell area value you will notice that the two additional Cell menu elds (Cell Horizontal and Vertical Length) adjusts accordingly.
NOTE: Grid cells created using this menu field generate square sample grids only. To create non-square grid
cells, use the following two menu fields.
Cell Horizontal and Vertical Length Menu Fields
These two menu elds allow you to create non-square grid cells by entering the horizontal and vertical lengths.
The unit of length is based on the System Unit of Measure set in the Program Launcher System menu page. If ENGLISH is selected, then the lengths are in Feet, and if METRIC is selected then the length unit is Meters.
98-05048 R3
39
Fieldware
Figure 47: The Grid Setup Page
®
Tools
Completing the Setup Process
Once all of the appropriate menu elds have been entered or selected, the
next step is to save these entries. To save all of the setup menu entries press the SAVE button at the bottom of the setup menu page. When SAVE
is pressed, all of the menu items are stored in the Setup le found in the Main Setup page. If you need to exit the
program process at anytime or you want to resume generating a sample pattern with the same menu items
selected, you may select the appropriate existing Setup le name and all of the menu items are lled in with the
appropriate data.
At this point you may exit the Setup process by pressing the EXIT button or you may go to the Sample Grid Placement page by pressing the NEXT button.
Orienting the Sample Grid
Once the Setup menu pages have been properly entered, then next step is to orient the sample grid over the background data. To begin this step press the NEXT button at the bottom of the Setup menu Page.
Pressing NEXT brings up the Orient Sample Grid page which should show the background le with a sample grid placed over the top, (Figure 48). This page allows you to rotate and shift the sample grid prior to positioning the
sample points within the sample grid.
40
www.teejet.com
Figure 48: The Orient Sample Grid Page
Background data
of eld boundary
Sampling Grid
Grid shift buttons
Rotation angle
Grid rotation
buttons
Fieldware® Tools
Rotating the Grid
The sample grid can be rotated by either of two methods. The rst method is to enter the desired rotation angle
and the second method is to “spin” the grid in a left or right direction to the desired rotation angle. The point of rotation for the grid is located at the center of the background data set.
Rotating the grid by entering a rotation angle
To rotate the grid by entering a rotation angle, press the button shown to the left. Once pressed, a “Rotation Angle” dialog box appears. Enter the desired angle and press Enter. The grid rotates in a clockwise direction from North, or straight up the page. To reset the grid, enter a rotation angle of 0.
(Figure 49) shows the “Grid Rotation” dialog box.
Figure 49: The Grid Rotation Dialog Box.
98-05048 R3
41
Fieldware
®
Tools
Rotating the grid using the “Spin” buttons
A second method to rotate the grid is to spin it using the two SPIN buttons shown in the column to the left. This method works best when you are attempting to visually line the
grid up with a feature in the background data le such as the edge of the eld
boundary. Pressing either of these buttons rotates the grid in the direction indicated by the arrow on the button. As you press one of these buttons, the grid spins and the rotation angle is displayed in the information bar located near the bottom of the page.
Shifting the Grid
Orientating the grid also includes shifting the grid. You may like the orientation angle of the grid but need to align
a row or column of grid cells along an edge of a eld boundary. There are two methods to shift the grid, using the
shift buttons or by using a mouse.
Shifting the grid using the shift buttons
You can shift the grid by using the four Shift buttons located to the right and bottom of the Orient Grid page. These buttons, shown to the left, can be activated by pressing the arrow keys located on your computer keyboard, or by pressing them with a mouse. As you press these buttons the grid moves in
the direction indicated by the blue arrow located on the button.
Shifting the grid using the mouse
To shift the grid using a mouse, move the mouse pointer over the grid. Hold the left mouse button down and drag the grid to the desired position.
Completing the Grid Orientation
Once you have oriented the sample grid to your satisfaction, the next step is to position the sample point locations based on the sample pattern selected in the setup process. To move to the Position Points page, press the NEXT button.
This completes the grid orientation process.
42
www.teejet.com
Fieldware® Tools
Positioning the Sample Points
After the grid orientation process is complete, the next step is to position the sample points within the grid.
Pressing the NEXT button in the Grid Orientation page brings you to the Position Points page (Figure 50).
Figure 50: The Position Sample Points Page
Sampling Grid
Sample Points
Editing Cursor
Field Boundary
Button Bar
The sample points are distributed within the sample grid based on the Grid Setup menu selections. In (Figure 50),
the grid menu selections were 5.0 Acre square grids and the point sample pattern was REGULAR. The grid had
been oriented to align with the South and West edges of the eld boundary.
The Position Point page allows you to perform some basic point editing tasks such as deleting and adding points.
You can also select a point and enter a specic point name as an attribute. Points can be selected by positioning
the Red editing cursor over a point. The editing cursor can be positioned using the arrow keys located on your computer keyboard, or by using the mouse. To add a point, position the editing cursor over the desired location and press the ADD button. To delete a point, position the editing cursor over the point you want to delete and press the DELETE button.
Once you are satised with the sample point distribution with in the sample grid, press the FINISH button to
complete the Form a Sampling Pattern process.
98-05048 R3
43
FIELDWARE® TOOLS
USER MANUAL
1801 Business Park Drive
Springeld, Illinois 62703 USA Tel: (217) 747-0235 • Fax: (217) 753-8426
www.teejet.com
98-05048 R3 © TeeJet Technologies 2011
Loading...