File Format - ajmas/EarthFrequencies GitHub Wiki
For the most part the data files are in the form of 'tab delimited' text files, using the UTF8 character set. This choice was made, since it makes it easier to open and edit the data files in spreadsheet applications and other applications, without needing to build any special parsers. The choice of UTF8 allows for broad selection of characters in the unicode range, while recognising in the general case the characters used are within the 256-byte range.
Text Files
Text files are tab-delimited and in UTF8 format. In all cases you should treat the first line of the file as a header line, with the entries indicating the data in the column. You should not depend on field offsets independent to the column name. While a certain column is encouraged, it is not enforced and it is possible for a file to contain additional fields.
Fields & their Definitions
Irrespective of the file format used, the common field names are standardised, such that their meaning can be defined globally and easily interchanged between file formats used in this project, without a need to do data mapping. While the field names should be presented in lowercase, they should be considered case-insensitive, such that 'lower_frequency' and 'Lower_Frequency' are considered equivalent. Also, it is possible that files will contain additional fields, not listed here.
General
If a file contains both frequency & lower/upper frequency, then a non-empty value will decide which is being used for the current entry.
- frequency - specific frequency (in Hz)
- lower_frequency - lower frequency in a frequency band (in Hz)
- upper_frequency - upper frequency in a frequency band (in Hz). If this value is empty, while lower_frequency is defined, then treat the value as equivalent to +infinity.
Frequency Allocation Tables
- region - ITU region (ISO2 format, plus ITU1, ITU2, ITU3)
- sub-table - certain regions, such as the US, split their tables into 'sub-tables'
- lower_frequency - as described above
- upper_frequency - as described above
- service - service name as defined in the ITU handbook. An entry with a dash (-) describes the band in general
- footnotes - footnotes describing service or band
- applications - applications of service or band
- standard - standard describing the entry
- notes - freeform notes
Frequency Allocation Footnotes
- ref - footnotes reference
- description - description of the footnote