FILE FORMAT - TMR Measurement data files

Transcription

1 LS Elektronik AB Date: Doc: Rev: C 1 (7) FILE FORMAT - TMR Measurement data files Contents Page 1 GENERAL DATA MEDIA DATA FILES DATA RECORDS DATA SEPARATORS DATA FIELDS DESCRIPTION OF A DATA RECORD RECORD-HEAD LIST OF RECORD TYPES Type 1 MEASURE HEAD-Record Type 3 FIXPOINT-Record Type 4 COMMENT-Record Type 6 SIGNAL LEVELS -Record Type 99 END-Record... 7

2 LS Elektronik AB Date: Doc: Rev: C 2 (7) 1 GENERAL This document describes the data format for measurement data from the radio survey receiver units "TMR" manufactured by LS Elektronik AB. For most parts this format is compatible with the older "REGUS" units. The main differences arise from the fact that "TMR" supports 27 simultaneous radio channels and "REGUS" supports 21 channels. 1.1 DATAMEDIA Data is stored in MS DOS format on the hard disk in the IBM PC compatible notebook computer used with TMR. Data may be transferred to a post processing system on an other computer by copying the files to 1.44MB diskettes, RS232 communications, network connections or any other system that may be implemented in the PC computer and on the host system. 1.2 DATAFILES Measurement data is stored in text files organized as lines of printable ASCII characters ending with CR/LF The data files only contain printable IBM ASCII characters (codes dec.) and [CR][LF] (codes 13 and 10 dec.). 1.3 DATARECORDS The measurement data is organized in data records within the file. A data record always starts with the character "@" as the first character of a line. A data record always ends with the character "@" as the last character of a line Empty lines are allowed in the file (only containing CR/LF) A data record is a logical unit containing data from a given geographical point (or time if data is recorded in "TIME" mode). It may also contain information about the present measurement file, like the channels used, name of the operator, date and time, transmitter site info etc DATA SEPARATORS Data fields within a data record are separated with semicolons ";". A CR/LF may be added after a semicolon to force a new line when the file is printed. 1.5 DATA FIELDS Data fields can have one of three types: numeric type, list type or string type Numeric fields have variable lengths. Leading zeroes are normally not printed. A field with the value 0 (zero) is normally stored as an empty field to preserve file space. The numeric value may be either an integer or a floating point. For floating point values a decimal point "." is used as separator between the integer and fractional parts List fields contain one or more fields, separated by semicolons. The list starts with "{" and ends with "}". The number of fields within a list can be fixed or variable String fields are maximum 80 characters long. The characters ";" or "@" are not allowed in string fields.

3 LS Elektronik AB Date: Doc: Rev: C 3 (7) 2 DATA RECORD DESCRIPTION Start Record character Record-Identifier (in this case a TMR Signal level record) Data-Separator Sequence-Number Distance traveled Latitude Longitude CR/LF (not 15;10;30;{105;60;95};@ Record head, always the same format Variable part depending on type of record CR/LF (not printable) End Record character End character for list Signal level for measurement frequency no 3 Signal level for measurement frequency no 2 Signal level for measurement frequency no 1 Start character for list Three fields containing hours, minutes and seconds 2.1 RECORD HEAD Each data record begins with a record specifying the record type and position for the following data. This record head looks the same for all record types (except of course for the record type identifier) Field 1: Record Identifier After the start character "@" follows a numeric fields whose value identifies the type of data following after the record head. See the following description of different record data types. Integer 1-2 digits [0..9] Field 2: Sequence number This field contains the sequence number for the record. The first record of the file has number 1. Integer 1-6 characters [0..9] Field 3: Distance traveled / time This field contains the distance traveled or the time elapsed since the beginning of the measurement. For signal level data records in "DIST" and "PULSE" mode this is the center point for the local mean value (not the reading when the meanvalue is stored.) For "TIME" mode this is, in the same way, the "center" time for the meanvalue stored. For other records it represents the readings when the data is stored. Distance is stored in meters and time in seconds. Integer 1-7 digits [0..9] Field 4: Latitude Contains the North-South coordinate in degrees with 5 decimals. Southern coordinates are expressed with a leading minus sign. Invalid position data may be expressed as a single "0" (zero) character. Real value 1 or 9-10 characters [0..9 and - and. ] Field 5: Longitude Contains the East-West coordinate in degrees with 5 decimals. Western coordinates are expressed with a leading minus sign. Invalid position data may be expressed as a single "0" (zero) character. Real value 1 or characters [0..9 and - and. ] Example of a Record In this example is the Record identifier =3

4 LS Elektronik AB Date: Doc: Rev: C 4 (7) Sequence. no =37 Distance traveled =955 meter Latitude = degrees south Longitude = degrees north 3 DESCRIPTION OF RECORD TYPES 3.1 Type 1 MEASUREMENT HEAD Record Record identifier = Field 1, Measurement date String field with a date in the format YY,MM,DD 8 characters [0..9 and, ] Field 2, Measurement start time String field with a time in the format HH,MM,SS 8 characters [0..9 and, ] Field 3, Signature String field with the operator name 0-45 ASCII-characters Field 4, Measurement comment String field with optional comments on the measurement 0-60 ASCII-characters Field 5, Measurement method List field describing the measurement method: Subfield 1: String field containing the Measurement method. 4 characters "TIME", "DIST" or "PULS" Subfield 4: Subfield 5: Numeric field with: for method TIME: time in seconds for local meanvalues for method DIST: distance in meters for local meanvalues for method PULS: distance in meters for local meanvalues Real number 5 characters [0..9 and. ] Numeric field with number of scans per local meanvalue. Integer 1-4 characters Numeric field with the lowest signal level recorded. Levels lower than this threshold are stored as empty fields to preserve file space. Integer ( dBm) Numeric field with calibration value for the odometer sensor. The value is given in meters between the pulses. Real number 5 characters [0..9 and.] Field 6, Receiver data List field with receiver data: Subfield 1: The receiver type number Integer 2 characters1-99 The receiver serial number Integer 1..4 characters (1-9999)

5 LS Elektronik AB Date: Doc: Rev: C 5 (7) Numeric field with the number of measurement frequencies. Integer 1..2 characters (1..27) Subfield 4: Numeric field with the channel number for the first measurement frequency. Integer 1-4 characters ( ) Subfield 5: Numeric field with the frequency in MHz for the first measurement frequency. Real number 1-10 characters (0..9 and.) If the number of measurement frequencies according to subfield 3 is more than 1, fields 4 & 5 are repeated until the data for all measurement frequencies are listed Field 7, Measurement accessories data, receiver List field with optional data for the accessories at the receiver end: Subfield 1: String field with the text "RXDEF" as a label indicating that data for the measurement system is to follow. This label improves the readability when the data file is listed. Subfield 4: Receiver antenna gain (dbd) Receiver antenna height in meters Receiver antenna cable attenuation (db) Field 8, Receiver comment line1 String field with an optional comment about the receiver end. Line 1 (of 2 lines) 3.19 Field 9, Receiver comment line2 String field with an optional comment about the receiver end. Line 2 (of 2 lines) Fields 10-36, Measurement accessories data, Transmitter sites 1 to 27 List fields with optional data for the transmitter sites. Normally only data for as many sites as the number of measurement frequencies selected for the measurement contains valid data. However, all 27 transmitter site definitions are always stored. Subfield 1: Subfield 4: Subfield 5: Subfield 6: Subfield 7: Subfield 8: String field with the text "TXDEF01".."TXDEF27" as labels indicating that data for the transmitter sites (1..27) are to follow String field with the name of the transmitter site (0-43 ASCII-characters) Transmitter frequency in MHz (or optionally the channel number) (Real number max 10 characters [0..9 samt. ]) Gain for the transmitter antenna. [dbd] (Real number max 5 characters [0..9 samt. ]) Transmitter antenna height in meters Transmitter antenna directions in degrees Transmitter Output power in Watts (or optionally in dbm) Reflected power at Transmitter in Watts (or optionally in dbm)

6 LS Elektronik AB Date: Doc: Rev: C 6 (7) Subfield 9: Subfield 10: Reflected power at Antenna in Watts (or optionally in dbm) Transmitter cable attenuation (db) Field 11, Transmitter site comment line 1 String field with optional comment for Transmitter site 1 (line 1 of 2) Field 12, Transmitter site comment line 2 String field with optional comment for Transmitter site 2 (line 2 of 2) Fields 13-78, Definitions for transmitter sites 2-27 Definitions according to fields are repeated for all possible 27 transmitter sites Field 79, Comment keys List field with 10 sub fields containing the text strings associated with the measurement comment keys F1-F8 8 ASCII-strings with CR/LF after each semicolon ";" 3.2 Type 3 FIX POINT Record Record identifier = Field 1, Fix point number Numeric field with the number of the fix point. First fix point is no 1. Integer 2 characters (1..99) 3.3 Type 4 COMMENT Record Record identifier = Field 1, comment number Numeric field with the number of the comment key. For the text strings associated with each key se paragraph Integer 2 characters (1..99) 3.4 Type 6 SIGNAL LEVELS Record, 27-channels (TMR) Record identifier = Field 1, Hours Numeric field with the hour part of the real time clock in the PC. Integer 0..2 characters (0..23) Field 1, Minutes Numeric field with the minute part of the real time clock in the PC. Integer 0..2 characters (0..59) Field 1, Seconds

7 LS Elektronik AB Date: Doc: Rev: C 7 (7) Numeric field with the second part of the real time clock in the PC. Integer 0..2 characters (0..59) Field 4, Signal level List-field with the signal levels in -dbm but with the minus sign omitted. The list has the number of elements given in the measurement head record, data field 13 (see ) Sub fields 1-27: Signal levels for each measured channel Positive integer 0-3 characters [0..9] Note: the "-" sign is omitted 3.5 Type 99 END Record Record identifier = This record has no data fields