Chapter 13. Debrief reference guide
- Table of Contents
- 13.1. Replay File Format
- 13.2. Debrief File Format
- 13.3. Importing Range Data
- 13.4. AUTEC Range Data
- 13.5. PMRF Range Data
- 13.6. Introduction to XML
13.1. Replay File Format
Debrief accepts files in the Replay datafile format. This format uses an 80 character string containing data/time, vessel name, position, heading, depth and speed. More than one vessel track can be stored in each file. The gaps between the data fields can be any whitespace characters, that is any number of spaces or tabs, but there must be a value for each data field.
The standard file-naming convention for files in the Replay format is to have a .REP suffix.
Through an extension to the format, annotation data can also be accepted. The annotation data format is described below. Whilst annotation and track data may be stored in single file, it is recommended that they are stored in separate files, to ease reading and plotting track-data only.
The standard data format is as follows
12345678901234567890123456789012345678901234567890123456789012345678901234567890
YYMMDD HHMMSS.SSS XXXXXX SY DD MM SS.SS H DDD MM SS.SS H CCC.C SS.S DDD
The field descriptions are:
Table 13-1. Fields in Debrief position entry
Field number |
Description |
|---|---|
|
1 |
Date |
|
2 |
Time |
|
3 |
Vessel Name |
|
4 |
Symbology (see below) |
|
5 |
Latitude Degrees |
|
6 |
Latitude Minutes |
|
7 |
Latitude Seconds |
|
8 |
Latitude Hemisphere |
|
9 |
Longitude Degrees |
|
10 |
Longitude Minutes |
|
11 |
Longitude Seconds |
|
12 |
Longitude Hemisphere |
|
13 |
Heading (0..359.9 degrees) |
|
14 |
Speed (knots) |
|
13 |
Depth (metres) |
Table 13-2. Debrief symbology data fields
|
Line Style |
Colour | ||
|---|---|---|---|
|
@ |
Solid |
@ |
White |
|
A |
Dotted |
A |
Blue |
|
B |
Dot-Dash |
B |
Green |
|
C |
Short Dashes |
C |
Red |
|
D |
Long Dashes |
D |
Yellow |
|
E |
Unconnected |
E |
Purple |
|
F |
Orange | ||
|
G |
Brown | ||
|
H |
Cyan | ||
|
I |
Light Green | ||
|
J |
Gold | ||
|
K |
Pink | ||
 | Note that historically only the first symbology style read in from file for a particular track was implemented, this has been changed in order that the colour value is used for each position read in. |
In addition to the positional vessel track data, annotations can also be added. Each annotation is placed on a single line in a replay file, each line beginning with the comment marker; a semi-colon ';'.To put a comment on a line, begin with two semi-colons.
The format for the different types of annotations is:
1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890
;LINE: @@ DD MM SS H DDD MM SS.S H DD MM SS.S H DDD MM SS H XX.XXX
;; symb, start lat & long, end lat & long, text label (optional)
;TEXT: @@ DD MM SS H DDD MM SS H XX..XX
;; symb, lat & long, text
;NARRATIVE: YYMMDD HHMMSS TTT.TTT XX..XX
;; dtg, track name, narrative entry
;TIMETEXT: @@ YYMMDD HHMMSS DD MM SS.S H DDD MM SS.S H XX..XX
;; symb, date, lat & long, text
;PERIODTEXT: @@ YYMMDD HHMMSS YYMMDD HHMMSS DD MM SS.S H DDD MM SS.S H DDD XX..XX
;; symb, start date, end date, lat & long, Depth(optional) text
;GRID: @@ DD MM SS.S H DDD MM SS.S H MM.MM MM.MM XX..XX
;; symb, centre lat & long (N13) lat increment, long increment, text
;RECT: @@ DD MM SS.S H DDD MM SS.S H DDMMSS H DDDMMSS H
;; symb, tl corner lat & long, br corner lat & long
;SGSAGEOG: @@ YYMMDD HHMMSS YYMMDD HHMMSS DD MM SS.S H DDD MM SS.S H DD MM SS.S H DDD MM SS.S H XX..XX
;; symb, start date, end date, tl lat & long, br lat & long, text label (1 word)
;SGSAGRID: @@ YYMMDD HHMMSS YYMMDD HHMMSS AA NN AA NN XX..XX
;; symb, start date, end date, tl corner, br corner, text label (1 word)
;WHEEL: @@ DD MM SS.S H DDD MM SS.S H YYY YYY
;; symb, centre lat, centre long, inner radius (yards), outer radius (yards)
;CIRCLE: @@ DD MM SS.S H DDD MM SS.S H YYY XX.XX
;; symb, centre lat, centre long, radius (yards), label
;ELLIPSE: BD YYMMDD HHMMSS DD MM SS.SS H DD MM SS.SS H CCC XXXX YYYY xx.xx
;; symb, date, time, lat, long, orientation, maxima (yards), minima (yards), label
;BRG: BD YYMMDD HHMMSS DD MM SS.SS H DD MM SS.SS H CCC XXXX xx.xx
;; symb, date, time, lat, long, orientation, length (yards), label (one word)
;SENSOR: YYMMDD HHMMSS.SSS AAAAAA @@ DD MM SS.SS H DDD MM SS.SS H BBB.B RRRR yy.yy xx.xx
;; date, ownship name, symbology, sensor lat/long (or the single word NULL), bearing (degs), range(yds), sensor name, label (to end of line)
| Note, when null positions are entered for Sensor data, the position is taken from the track named in "ownship name". Debrief finds the nearest track location equal to or greater than the indicated time, and uses this as the sensor lat and long. |
Annotation positions are specified in degrees as in the standard replay file format, and symbology representations are as in the above tables.