F j w M a p
Program for planning of transmitter locations in ARDF competitions
and simple creations of data necessary for ARDF-FjwW
All rights reserve: © Karl-Heinz Schade, www.DL7VDB.de
Hints to improve this English text are welcome !
Thanks for download and using FjwMap. The author is interested in error messages and new ideas.
Note: please do not use monitor resolution with 256 colors !
Generation of the data for planning a new contest:
- Open the picture map of the competition area, best in the JPG, also in the GIF or BMP format.
The picture should be in size of 500...2000 pixel (big pictures slow down the displaying), the
optimal size can be choose by zoom function. A GIF picture should not contain transparent color,
because it comes to increased flickering.
- The picture map can also be loaded with Drag&Drop, in other words, drag a MAP/JPG/GIF/BMP file
into the window of FjwMap and drop it there.
- On the left a location window is showing. In that a marked locations can be drag with pressed left
mouse key on the desired point into the map.
The symbols -S-, B, +F+, F?
or two digits indicates for start, (finish)beacon, finish and fox locations, S|F indicate
for identical start/finish locations. The beacon is always arranged as the latter before the finish
for the optimal searching order.
When the location window is not showing, it will be visible with
View/Location/Coordinate tool bar.
- During moving positions with Drag&Drop, the X-Y-coordinates of the momentary cursor position
in pixel or meter are indicated in the left part of status bar. Drag&Drop can be interrupted always
with key ESC during the time of clicked left mouse key.
- Reference(zero)-point is the corner in upper left of map or of main window itself if no map is
loaded; increasing values of pixel or meter arise towards to the top and to the right.
If both coordinate points, whose distances and the start-location are set, the start location itself
determine the Reference(zero)-point.
- With each new location or in changing of already set locations, the sequence is sought, that yields
the shortest(optimal) running route from start, over the fox locations to the finish. With a number of
more then eight locations a progress bar is indicated in the status bar, as long as the calculation
still runs (every additional location will be increase the necessary time drastically).
Also the suboptimal (calculation very quickly, more than ca. 11-13 transmitter necessarily),
fixed, rising sequence or no sequence can be shown with View/... or by clicking the
corresponding button in tool bar.
- The running route is issued in pixel as long as the scale of the map does not take place through
setting of two coordinates points by meaning of the symbols
+ | −.
After these are set and the distance with Edit/Coordinates distance between these in
meters (or GPS-data, WGS84, see below) is enter, the running route in meter will be displaying.
- The IARU rules of ARDF Championships demands minimal distances between Start and Foxes (>=750m),
Finish and Foxes (>=400m) and between Foxes themselves (>=400m).
Menu Exclusion circle/Start (750m) or Exclusion circle/Foxes (400m)
activates the display of this circles. For Sprint competitions this areas have to set to 100m distance.
- If the related map possesses the same scale in horizontal and vertical direction (that is the normal
case) and the card picture be aligned with north arrow towards the top perpendicularly, the easy to handle
symbols | or − can be used.
With | only the horizontal, with − only the vertical distance is
decisively and is to enter in Edit/Coordinates distance. The coordinate points
| don't have lie on a horizontal, − don't have to
lie on a vertical line.
When identical X-Y-map scale, the coordinate crosses + can also be setted if it's
known only a diagonal distance between these points.
For a good accuracy, the coordinate points in the map should be seted so far from one to another if
possible (when + then X- and Y-direction).
- In each case, the coordinate crosses + can be set, whose distances are from one
another well known in X- and Y-direction or its GPS statements are given. If with GPS coordinate worked
becomes, the additional advantage emerges that the card picture must not be aligned with the north arrow
vertically towards the top.
It is possible to enter the distance of coordinates with Edit/Coordinates distance
for one of the Y- or X-distances '0'; then this corresponds again to the behavior of vertical
| or horizontal − coordinate lines (how above described).
Are these coordinate points set with GPS-statements, marked locations can be set in the map over
Edit and Set with GPS data or with right mouse key on the location
field in the location window on GPS-position exactly. The input of the special characters ( ° ' " ) for
the GPS values is not necessary, e.g. for 12° 34' 56.78" it suffices to enter
12 34 56.78 .
For sufficient exactness these points must be away at least 100 meter in direction X/Y of each other.
- When all locations and coordinate points are set, the location data can be picked up in a started
program ARDF-FjwW to use for evaluation.
Edit functions:
- The locations and coordinate points become red and in the marked condition blue represented.
Marked locations are showed only with the ellipse outlines and an internal cross (as long as with key
ESC the designation become canceled) so that the map background remains visible at this place
for small, exact changes. The colors red and blue can be changed by Extras/....
Certain functions under Edit are carried out only for these marked. These menu points
are also available after right mouse click in the main window.
- The locations and coordinate points becomes red and in the marked case the Ctrl+TAB keys
marked the next location coordinate point (in optimal order), the keys Ctrl+Shift+TAB in
opposite order to run. In statusbar it is possible to see the distance (pixel or meter) from marked
location to next location.
The four cursor keys move a marked location respectively coordinate point around 1-3 pixel in
one of the four directions.
ESC cancelled the marked location. If the location will be marked with the right mouse key,
the danger does not exist to shift it unintentionally through small mouse movements.
- A click into the map (on locations coordinate points) and hold the left mouse key lets appear
the cursor as a hand and enables the shifting of the map if this is larger than the main window.
Turning of the mouse scroll wheel causes a vertical scrolling, with pressed key Strg a zooming
of the display.
- Each setting, deleting, changing of locations (foxes, start, beacon, finish) can be made through
Edit/Undo or Edit/Redo of the last 100 actions again annulled or can
be restored.
- After establishment of all locations theses can be anchored, so they can't mistakenly be changed.
- With menu Title of competition it's possible to enter a description for the
competition, that will be stored also in data.
- To the facilitation of the location establishment, a grid with 500m distance can be activated under
View/500-m background grid if both necessary coordinate points are set.
- For many functions there are key combinations (see in the menus) or Icons in the upper tool bar
to the fast operation, after clicking the right mouse key you see a context menu that corresponds to
the Edit menu.
- FjwMap can do the location data one in ARDF-FjwW
loaded competition take over and display. Because FjwW works only with relative location data in meter,
two conditions are necessary in FjwMap:
1) The coordinate points must be set and their distances be given
(Edit/Coordinates distance), so that the scale of the map is known.
2) Exactly one and only one location (typically the start, also finish or fox) must be set in FjwMap,
this location must also exist in the current competition in FjwW by which the location data should
be got.
Other condition is a running program ARDF-FjwW (from version 8.8) which shows the desired competition
as the current competition.
Now can be got the locations by FjwW with Edit/Get Locations from FjwW and be shown in
FjwMap and be further used. If start and finish are closer then 50 meters, they are mixed together and
represent with the symbol S|F, in the other case, the two symbols will be separated
-S- and +F+.
Precise setting of locations with GPS data from GPX files (way points):
- Many GPS devices have the possibility to store her just topical location as a so-called way point
and to file the accumulated way points later in a GPX file (other file formats must be converted
for FjwMap into the GPX format, see below). The use of these data can occur in parallel with manual
definition of the locations or also only.
- At first the GPX file is to be loaded with Edit/Set with GPX way points. The opening
dialog shows in every line both GPS data of way point, a name and maybe a description. By the following
actions the GPS data of the marked line are used always. For setting of the coordinate crosses or the
locations is to be working differently.
- Coordinate crosses + : Because with them only the real location of the loaded map
is fixed, they must be set first on the map. Now there are two possibilities to assign the marked GPS
data lines to these.
1) Click on coordinate cross (left mouse key) and drawing (drag&drop) on the round target in the
left, upper part of the dialog with the loaded way points and there drop, or
2) Click on the round target and drawing (drag&drop) on the coordinate cross to be set.
If the setting was successful, the line in dialog is marked with another icon.
- If both coordinate crosses are set, then the transmitter locations can also be set. First the line,
which data should be used, is to be marked in the way points dialog for each setting. It is checked immediately
whether the accompanying GPS data also reside within the map, the target circle on the top left of dialog
will be green (or red - when not in map).
Now you can drag the location symbol 1) from the location tool bar or from the map and drop in the way points
dialog on the target circle or 2) drag the target circle from the way points dialog and drop on the location
somewhere located in the map.
Storage of the generated data:
- The data in a MAP file can be stored independent of the JPG, GIF or BMP format of the loaded map
under Save data in additional MAP. The MAP file is small and contains also the data
of the related map picture (file name, file length, time stamp), several MAP files can refer to the
same one picture file.
- All data base of the competition and picture will be saves in a MAP file. This file containes the
path, the data and time of creation of this file. Therewith an unambiguous coordination of MAP and
picture file is reached. A comment concerning data of competition can be add.
- When loaded file is a JPG picture (internal format "JFIF"), the data can be stored also in the JPG
file itself (as a commentary) with File/Save or with File/Save data in JPG as
under an other file name as a new JPG picture. The presentation in picture programs is not influenced
by this commentary, but it is possible, that this commentary will be removed after editing and save of
picture in these programs! Attention: there the 'comment' in the JPG file not just like that becomes
visible, one does transmit perhaps not public competition data, it seems to be a 'picture' only !!!
- If the loaded map is under GIF or BMP picture format, the data can be stored only in a MAP file.
- The map, together with the locations/route lines, can be stored also as BMP file. This file can
become very large because it is not compressed how in JPG pictures.
- The keyword line @POSITIONS and its following data are contain in the TLN file of FjwW.
It contain the coordinate of all foxes, beacon, departure and arrival. Via clipboard, is it possible
to export these data for using in FjwW.
Open a MAP file:
- During the opening, the picture file indicated in the MAP file will be searched and compared to the
file length and time stamp read out of the MAP file. In agreement, the picture is loaded and the
location/coordinate points drawn into the picture. If the length of file or time stamp doesn’t fit, a
warning box appears.
- If the picture file is not found on the directory, this file is displayed on the menu already opened.
This picture file will be loaded without confirmation by the user. If it doesn’t work, the user will have
to make his own choice.
- The MAP file can be loaded also with Drag&Drop, in other words through drag of a MAP icons into
the window of FjwMap and drop there.
- After picture is loaded, location/coordinates/running route data, contained in the MAP file, will be
drawing into the picture map.
Receiving of GPS-NMEA data on serial COM port:
- FjwMap is able to receive data of GPS receivers (e.g., from so-called GPS-USB-'Mouses') in the
NMEA-0183 format on serial interface, to indicate some of the data and to show the position of the
receiver in the map after correct receipt. After menu View/GPS Receiving (NMEA)
the interface, on which the GPS receiver is connected, and the baudrate must be selected,
- As soon as valid data are received, they are shown in the window; this can require up to some minutes.
Close the window with key ESC or the button on the top right make visible an icon in the Systray of
task bar, a click on icon makes the window again visible. Both indicated position data GPS can be marked
and be copied afterwards to the clipboard for other use.
- If the coordinate crosses with GPS data have been set and the check box is activated in the window,
the received position is shown in the map if she is located within the map.
Printing the map with the locations:
- With File/Print the map can be printed, including the locations coordinate points
and optimal running route. The size of the printed map (limited to a printing page) can be adjusted in
the dialogue.
- If the DPI statement of the loaded map (e.g. in a JPG picture file) is known, can be printed
in original size. Increasing of the DPI value in the dialogue reduces, smaller DPI value enlarges the
printed map. Parts of map going out over the paper edge get lost.
- If the map scale is known through setting of the coordinate points, the map with the necessary
size can be printed for the input map scale (e.g. 1:15000).
- The map can be printed in a scale that both coordinate point set exactly the input distance
(in + two distances) in printing page.
Running route calculations for categories:
- To determinate the optimal running route of the several categories, the foxes have to be registered
under Edit/Foxlist/Sequence for each category. With Add IARU categories
the eleven IARU categories W19, W21, W35, W50, W60, M19, M21, M40, M50, M60, M70 can be inserted.
- With New or Del single categories can be added or deleted. The category
name or the list of the transmitter (fox list) can edited after double click into the corresponding line
and column. With Enter or OK the changes are confirmed, with ESC or
Cancel the changes are rejected. The evaluated transmitters are shown in the upper part
of the window, additional start/beacon/finish (if are set in map).
- If the transmitter number is attached with an exclamation mark '!', this transmitter will be a so-called
"duty transmitter". All listed transmitters before have to search first (in any order), after that the
"duty transmitter" and after that the following transmitters. Such "duty transmitter" there are e.g. on
SPRINT competitions, here called 'Spectator point". Following 'Fox list' of SPRINT as example:
"1 3 4 5 6! 11 12 14 15" means, the transmitters 1,3,4,5
first (in any order), then transmitter 6 and then transmitters 11,12,14,15 (in any order).
- The written sequence of the transmitter numbers can also be a fixed sequence by activating the check
button on the right hand side. In fixe sequence, single transmitter numbers can be find more often than
one’s (loops in the running route), otherwise the multiple numbers will be ignored.
- If the menu View/Order for one category is activated, the category that you have
choose is displayed on the screen.
- With View/All opt. searching orders the respective of the optimal that which is
sought sequences are represented for the available categories. All categories can be shown by scrolling.
In the left upper part, the shortest running routes are sorted by rising length.
Under the list field, the limit time is showed if the necessary statements are available (see limit
time recommendation).
Limit time recommendation:
- The limit time of a competition is dimensioned according to the longest running route of one of the
categories. With View/Limit time recommendation it's possible to select different
conditions that there are during competition. An additional charge of minutes can be registered below.
The determined time limit will be up grade to 5 minutes and display at the lower left hand side part of
the window.
Display of running route stored in GPX files:
- GPS tracking units records a personal running route. If the recording is in a GPX file format, it can
be shown in FjwMap. There are Freeware which convert the most different other used file formats into the
GPX format and/or are able to read out the data from the GPS tracker directly (see below).
Prerequisite is the use of the coordinate crosses and setting its GPS positions on the loaded map or no
loaded map.
- To display running tracks, use the menu View/GPX track display. The GPX file will be
loaded. The founded way points which lie within the map and chronologically after the entered start time
in dialog; however the date will be disregarded. If no map is loaded, FjwMap searches the maximum expansion
of running route in the GPX file and set the suitable coordinate crosses independently.
- A dialog box is opened. With this one, the displaying of running route can be started, stopped,
proceeded, finished. You can also change the time-lapse factor or the start time for first running point.
With Alt+V the dialog will be larger, so the labelling of 'running point' can changed.
The 'running point' can also draw a track in one color or in 1-min-color segments.
If you zoom, scroll or move in the main window, the track will now not be erase. With Alt+Y
the drawing of track can be accelerate at every time.
- It is possible to add (fox arrival) time to a list box with Alt+(+) or delete these in list
with Alt+(-). When the displaying arrive this time(s) the drawing of track will be stopped,
after that it can be proceed with Continue. While displaying, the locations F1...F5
change the form and color in the 1-min-rythmus (same behaviour for locations F11...F15 and F21...F25).
- During the displaying of run route different data are given on every road point in the dialog title
such as: (1) currently run time, (2) up to now run distance, (3) currently working
transmitter (F1:0-1min, F2:1-2min, ...), (4) currently altitude.
The text field under give statistical information, build by average of a small number of short taped road
segments, such as: (5) currently running velocity, (6) running velocity since start and at finish,
(7) total running velocity and (8) minimum and maximum of altitude for whole running route.
- With View/Map redraw or key F5 the drawing tracks can be erase at every time.
- Examples You can find on homepage of www.DL7VDB.de
Drawing of the personal running route:
- With Edit/Running route sketch in the cursor becomes the look of pencil.
By multiple clicking in small sections (max. 200) a personal running route can be drawing now.
In the status bar, the section length is indicated.
The last drawing section of running route can be deleted with the keys Ctrl+Backspace, the
deleting of the total running route or segmental is possible also via the context menu (right mouse key).
- The personal running route is stored also by save the data.
Work with Altitude data:
- Program is able for working with data of 'Shuttle Radar Topography Mission' (SRTM, see
Wikipedia).
The freely accessible data can find on a NASA FTP server. The data give for a surface of approx.
50 x 90 meters (Central Europe) the height about sea level in meter. More precise data
are accessible either not freely, or to agree only against payment.
- With Topography/Path of Local data and
Topography/Path of Download data it's need to given paths at first where already
locally available altitude data are (possible path as 'read only', e.g. CD/DVD-ROM) and where got data
from FTP server are stored (path must be writeable). Both paths (then absolutely writeable) can be also
identical.
With Topography/SRTM Server name the right earth part in which the loaded map lies must
be chosen if necessary. The server name and path are to be changed if necessary in the future.
- In order to use altitude data, the two coordinate crosses + must be placed on the
map and they own GPS coordinates.
Now can be loaded the height data with Topography/Get/Load SRTM data.
If these data do not exist in your computer, an Internet connection to the FTP server is established
automatically to download the necessary data (ZIP files). If everything goes normally, the highest point
within the map is searched and indicated.
- With loaded altitude data the height is indicated for a marked location in his momentary position in
the status bar.
Additional:
- With Topography/Locations on Google-Maps an generated URL will be copy only to
clipboard or hand over to (default)Internet browser. With it a GIF picture with the 640 x 640
pixel is shown on Google-Maps in the browser which indicates the locations on different map background.
A condition are setting coordinate crosses with GPS data. It can be necessary, a "Google-Maps-API-Key"
to put in the edit field; the link leads to Google-Maps where the key is to be get.
- With Topography/Save KML file the locations can be stored in a KML file, precondition
is the using of coordinate crosses with setted GPS data. About usage of KML file see Wikipedia
Keyhole Markup Language.
- The menu Extras/Shortcut to FjwMap give the possibility to create a direct connection
(shortkey) from the MAP-files and the program FjwMap. As soon as this “connection” is done, double click
on the picture map. The program FjwMap will open automatically before to load the selected picture.
- With File/Picture prepare external a picture file can be converted or rotated
for using in FjwMap (only formats JPG, GIF, BMP). Listen: only on PC with WinME and WinXP !
- Links for finding out the 'Magnetic declination'
www.magnetic-declination.com
www-app3.gfz-potsdam.de/...
www.ngdc.noaa.gov/...
The declination is strong dependant of location on earth and not constant of the time, examples are:
London -2°, Berlin +2,5°, Warschawa +4,5°, Kiew +6,5°, Seoul -8°
(ca. value in degree)
- Link for freeware to converting different GPS track formats to GPX format using in FjwMap
www.gpsbabel.org .
Copyright:
All rights reserved: Karl-Heinz Schade, Berlin/Germany DL7VDB
For all linked pages on top, that I no influence on them contents,
I outdistances me herewith expressly from the contents of this pages.
Program is using library to unpack of ZIP altitude data
// zlib.h -- interface of the 'zlib' general purpose compression library, version 1.1.3, July 9th, 1998
// Copyright (C) 1995-1998 Jean-loup Gailly and Mark Adler