WFUG 01 - Introduction
WFUG 01 - Introduction
This User’s Guide is written with the assumption that users are familiar with
the operation of Microsoft WindowsTM and have some familiarity with the use
and purpose of integrated navigation systems. If you are unfamiliar with the
Windows environment, you should spend some time reading Windows
documentation prior to operating WinFrog as this will explain some of the basic
features and concepts of the Windows operating system.
Of critical importance is the ability to navigate through the various windows of
the program. WinFrog allows you to open dialog boxes and select various
options by using a mouse or by the use of ”shortcut keys” (i.e. File > Open = Ctrl
+ O). A WinFrog function can be enabled by simultaneously holding the ALT
key and selecting the desired underlined control letter. In WinFrog, it is much
more efficient to use the mouse to highlight, copy, and paste variables. Most
WinFrog windows also have a configuration shortcut that is accessed by clicking
the right mouse button when the mouse pointer is within the border of the
desired dialog window.
The use of a file management program such as ExplorerTM or File ManagerTM
(AKA WinFileTM) is required to support WinFrog. In particular, you should be
proficient in the creation of new folders and copying and moving existing files.
You should also know how to edit the contents of a file. All of WinFrog’s files
are written as simple ASCII text, so standard WindowsTM editing programs such
as WordPadTM and NotePadTM can be used to display the contents.
This document is written in reference to WinFrog version 3.1 (released
February 2001). You can determine which version of WinFrog you are using by
selecting Help > About WinFrog from the menu bar.
Abbreviations
CRP common reference point
comm communications
COG/CMG Course Over Ground/Course Made Good
I/O input/output
QC quality control
config configuration
System Requirements
Many of the WinFrog modules have features that are computationally intensive.
As a result, a fairly powerful processor and hardware configuration is required in
order to maintain acceptable data quality.
The following list is a typical system configuration that Thales GeoSolutions
(Pacific) supplies to clients to be used in the field. This configuration has proved
to be a rugged and reliable system for almost all applications.
WinFrog Applications
The WinFrog integrated navigation and data management software is suitable
for a wide variety of applications in marine, land, and air environments and is
now being used for numerous applications on over 400 vehicles worldwide:
Fleet Monitoring
Remote Vehicle Tracking
Cable and Pipelaying Operations
Bathymetric Surveys
Geophysical Surveys
Seismic Surveys
Drill Ship/Rig Positioning
Land Surveying
Real-Time Aeronautical Vectoring
Though these are some of the more common applications, the potential use of
WinFrog in any environment is unlimited. The WinFrog suite of programs
continues to evolve and develop as users find new applications for the system
and as new computer, data acquisition, and data processing systems come onto
the market.
WinFrog Features
The WinFrog integrated navigation software consists of a “core” package with
several add-on modules that allow the choice of a final system configuration best
suited to the particular positioning and processing requirements. The core
WinFrog package contains features that are beneficial to all uses; while the
features provided in additional modules typically apply to specific applications.
Devices
WinFrog supports over 250 different peripheral devices, with the capability to
simultaneously use over 30 devices , including multiple copies of the same
device. Device data can be received in either industry-standard NMEA or
customized formats. Alphanumeric windows display the raw data for each
device configured in WinFrog. WinFrog serves as a data management system by
collecting and distributing data for an entire project. Raw data for each device
can be logged for future calculations, processing, and playback.
Vehicles
WinFrog supports the configuration of multiple vehicles, each using different
peripheral devices. The calculation of each vehicle’s position can be
independently defined. Each vehicle can have its own shape and offsets, track its
own waypoints, and line track. Events can be generated by any one of the
multiple vehicles and raw device data for each vehicle can be logged for future
use. Alphanumeric windows for each vehicle are user-configurable to display
various parameters, such as position, speed, heading, course of advance,
waypoint and line track, and crosstrack error.
If an authorized license transfer is made, the five active licensing files will still
physically exist, but will be made obsolete by the new files created in the newly
specified directory. Note: you can not simply copy these files from one directory
to another in an attempt to transfer authority. (See below for more details on
transferring a CrypKey license.) The CrypKey.ini file will be updated to include
the newly appointed directory. For “normal” installations, there should be no
need to manually remove or change the locations of these files.
Crypkey.ini is a service program that must be running in order for the CrypKey
license to work. You can ensure that this program is running by clicking Start >
Settings > Control Panel > Systems >Services. The Status must be Started, and
the Startup set to Automatic.
Local Transfer
is the term used for the process of moving the software license
Local Transfer
from one WinFrog to another WinFrog on the same computer or to a networked
computer.
The circumstance may arise when there are two or more versions of WinFrog on
the same computer. In order to run either of these programs in real-time, the
licensing authority must be switched between them as required. Both WinFrog
versions must be capable of CrypKey licensing (version 2.63.00 or newer).
Note: licensing authority may be moved via a network connection to another
computer or between two disk drives on the same computer (between one
version of WinFrog on the C: drive and another version on the D: drive, for
example).
Before you can transfer the license, you must first install WinFrog on the
unlicensed computer. Failure to install WinFrog correctly will result in the path
to this version not being included in the Crypkey.ini file, negating license
transfer capabilities.
Complete the installation and re-boot the computer.
As mentioned previously, as a part of the WinFrog installation, the program
Transfer is written to the WinFrog directory (default C:\Program Files\Thales
GeoSolutions (Pacific)\WinFrog\Transfer.exe). This program must be used to
transfer the licensing; simply copying the licensing files will not provide the
required permissions.
8 Remove the floppy from the Target machine and insert it into the Source
machine.
9 Run Transfer.exe on the Source machine from the installation directory with
the current license.
12 Remove the floppy from the Source machine and insert it into the Target
machine.
13 For ‘Step 3,’ click the Browse button and locate the floppy drive; click OK.
14 Please wait for the following dialog to pop-up: “Completed Step 3. Transfer
Successful.” Click OK.
15 Exit Transfer.exe.
Installing WinFrog
Before installing WinFrog, first check to make sure that the minimum hardware
requirements are met. (This is discussed in the System Requirements section at
the beginning of this chapter.)
Close all applications and ensure that you have Administrator privileges before
beginning the install. WinFrog should be installed on the same drive as the
Windows system directory. For example, if the Windows system directory is
installed in D:\ Winnt, then WinFrog should be installed somewhere on the D
drive.
Starting WinFrog
To Launch WinFrog from Windows NT4.0
1 Either double-click the WinFrog shortcut on the desktop (if there is one) or
click Start > Programs > Thales GeoSolutions (Pacific) > WinFrog.
Be careful not to start more than one version of WinFrog at a time. This will
cause problems with real-time operations, as well as the potential loss or
overwriting of various data files.
The WinFrog Authorization dialog box opens.
This WinFrog Authorization dialog box provides you with the CrypKey
Note: A WinFrog Smart Remote terminal does not require a security key for
operation. Smart Remote systems obtain their positioning/navigation
information via networked WinFrog systems, not directly from real-time
devices. Since this position source is available in WinFrog’s Demo mode, a
security key is not required.
5 Click OK.
Using WinFrog
WinFrog uses standard Windows menus, dialog boxes, and windows. This
section provides a quick introduction to using WinFrog.
Menu Bars
At the top of the WinFrog window is the Menu bar. This bar contains seven
categories of WinFrog items, each of which contains numerous sub-options.
The Configure menu (shown in the next figure) is a typical WinFrog menu and
provides numerous configuration options in a dropdown list. The
Configuration menu is used as an example below.
Dialog Boxes
Dialog boxes allow the user to communicate with WinFrog. WinFrog’s
parameters and options are set using these dialog boxes which can also provide
access to other dialog boxes and windows. Standard Windows conventions are
used to select items and open and close dialog boxes. The Configure Graphics
dialog box, seen below, is a typical WinFrog dialog box.
The title of each dialog box appears flush left at the top of the box. In this case,
the dialog box is entitled Configure Graphics.
Clicking the OK button accepts the changes that have been made in a specific
dialog box and closes that box. Clicking the Cancel or Close button or clicking
the X in the top right corner of the dialog box closes the dialog box without
accepting the changes made.
Speed Toolbar
WinFrog’s default configuration has a toolbar that is located below the menu
bar. The toolbar contains 21 buttons that provide shortcuts for performing often
used functions. This toolbar is actually made up of 5 individual “dockable”
sections that can be moved to anywhere in the WinFrog workspace. The
complete WinFrog toolbar is shown below.
As found from the left, the buttons on the Speed Toolbar do the following:
1 Zoom In Zooms in a Graphics or a Bird’s Eye window.
2 Zoom Out Zooms out a Graphics or a Bird’s Eye window.
3 Zoom Window Allows you to window the area that you want to see on a
Graphics or a Bird’s Eye window.
12 Graphical Route Design Used to enter survey line segment coordinates by clicking on
the Graphics or Bird’s Eye Window with Display Position
enabled.
16 Turn Left Click this button to turn the ship to the left by .1, 1, or 5
degrees, as configured in the Configure Simulator dialog
box. The default is 5 degrees. This button only works with
simulated devices.
17 Turn Right Click on this button to turn the ship to the right by .1, 1, or 5
degrees, as configured in the Configure Simulator dialog
box. The default is 5 degrees. This button only works with
simulated devices.
18 Decrease Speed Decreases the vehicle’s speed by the value entered in the
Interval (kts) field of the Configure Simulator dialog box.
The default is 0.25 knots. This button only works with
simulated devices.
19 Increase Speed Increases the vehicle’s speed by the value entered in the
Interval (kts) field of the Configure Simulator dialog box.
The default is 0.25 knots. This button only works with
simulated devices.
20 Increase Depth Click on this button to increase the vehicle depth This
button only works with simulated devices.
21 Decrease Depth Click on this button to decrease the vehicle depth. This
button only works with simulated devices.
1 Displays Position or
2 Tool Bar Information As the mouse pointer is moved from one menu bar item to
another, a brief message about that menu bar function
displays.
3 Speed/Heading/Depth Displays the speed, heading, and water depth of the vehicle
displayed in the Vehicle window.
4 Date/Time Displays WinFrog date and time information. Note: this may
be different from the computer system’s date and time.
Hotkeys
In addition to the toolbar shortcuts, the following function keys can be used to
quickly display certain dialog boxes in WinFrog:
F8 = Print Screen (File > Print...Screen)
F10 = Manual Event (Configure > Manual Event or select the Manual Event
button in the toolbar)
F11 = Cable Event dialog box. (Configure > Cable Event or select the Cable Event
button in the toolbar).
Note: this same information is written to the WinFrog.ini file when WinFrog is
exited properly.
Exiting WinFrog
To Exit WinFrog
1 File > Exit or click the X in the top right corner of the window or double-click
on the WinFrog icon in the top left corner of the window.
A dialog box displays asking, “Are you sure you want to exit?”
2 Choose Yes.
WinFrog closes and overwrites the WinFrog.ini file.