RINEX File Header Information
R2026bRINEX file header information describes metadata contained in the header section of a RINEX file. This metadata provides information about the file, including the file type, satellite systems present, and the definitions of navigation messages or observation data recorded in the file. The set of available header fields depends on the type and version of the RINEX file and the header entries present in the file, and applies to both RINEX v3 and RINEX v4 files.
Unlike navigation data, RINEX header information uses a mostly consistent structure across RINEX version 3 and version 4 files. However, RINEX v4 does include possible header entries depending on the contents of the file.
Both the rinexread and
rinexinfo
functions return this header information as a structure.
Navigation File Header Information
If the specified RINEX file is a navigation message file, the
header output is a structure with these fields:
| Field | Type | Description |
|---|---|---|
FileName | string | Name of the file. This field is present if you use
|
FileSize | double | File size in bytes. This field is present if you use
|
FileVersion | double | RINEX file version. |
FileSatelliteSystem | char |
|
FileType | char | File type, specified as either 'N' for navigation message
files and 'O' for observation data files. |
PGM | string | Name of the program that created the file |
RunBy | string | Name of the agency that created the file |
CreationDate | string | Date and time of file creation |
Comments (Optional) | string | Comment lines from file header |
IonosphericCorrections (Optional) | structure array | An array of structures with a number of elements equal to the number
of
Correction type:
Parameters:
|
TimeSystemCorrections | structure | An array of structures with a number of elements equal to the number of
Correction type:
Parameters:
|
LeapSecondParameters (Optional) | structure | Leap second parameters in a structure with fields
|
For RINEX v4 navigation files, the header structure may include these fields in addition to the fields listed for RINEX v3 navigation files.
| Field | Type | Description |
|---|---|---|
NumMergedFiles (Optional) | double | Number of files merged. This line appears when the
filename is a merged navigation file. |
DOI (Optional) | string array | Digital object identifier (DOI) for data citation |
LicenseOfUse (Optional) | string array | Name of license and a link to the specific version of the license. Use standard data licenses from https://creativecommons.org/licenses/. |
StationInformation (Optional) | string array | One or more persistent links to station metadata describing the receiver, antenna, and monument configuration. Station metadata can be specified in formats such as site logs or GeodesyML. |
Note that optional fields are not present in the structure unless specified in the RINEX file.
Observation File Header Information
If the specified RINEX file is an observation data file, the output is a structure with these fields:
| Field | Type | Entry |
|---|---|---|
FileName | string | Name of the file. This field is present if you use
|
FileSize | double | File size in bytes. This field is present if you use
|
FileVersion | double | RINEX file version. |
FileSatelliteSystem | char |
|
FileType | char | File type, specified as either 'N' for navigation message
files and 'O' for observation data files. |
PGM | string | Name of the program that created the file |
RunBy | string | Name of the agency that created the file |
CreationDate | string | Date and time of file creation |
Comments (Optional) | string | Comment lines from file header |
MarkerName | string | Name of antenna marker |
MarkerNumber (Optional) | string | Number of antenna marker |
MarkerType (Optional for GEODETIC and
NON_GEODETIC marker types) | string | Type of marker |
Observer | string | Name of observer |
Agency | string | Name of agency |
ReceiverNumber | string | Receiver number |
ReceiverType | string | Receiver type |
ReceiverVersion | string | Receiver version |
AntennaNumber | string | Antenna number |
AntennaType | string | Antenna type |
ApproxPosition | double | Approximate marker position in meters. |
AntennaDeltaHEN | double | Height of the antenna reference point (ARP) above marker, and horizontal eccentricity of ARP relative to marker (East/North) in meters. |
AntennaDeltaXYZ | double | Position of antenna reference point for antenna on vehicle in meters. |
AntennaPhaseCenter (Optional) | structure array | A structure array with number of elements equal to the number of
|
AntennaBSightXYZ | double | Direction of the vertical antenna axis toward the GNSS satellites. If the antenna is on a vehicle, the direction is a unit vector in a body-fixed coordinate system. If the antenna is a tilted antenna on fixed station, the direction is a unit vector in East-North-Up (ENU) left-handed system. |
AntennaZeroDirXYZ (Optional) | double | Zero direction of the antenna. If the antenna is on a vehicle, the zero direction is unit vector is in a body-fixed coordinate system. If the tilted antenna is on a fixed station, the zero direction is a unit vector in East-North-Up (ENU) left-handed system. |
CenterOfMassXYZ | double | Current center of mass of the vehicle in a body-fixed coordinate system, in meters. |
ObservationTypes | structure array | A structure array with number of elements equal to the number of
satellite systems in the file. Each structure has
|
SignalStrengthUnit (Optional) | string | Unit of the carrier to noise ratio observables SNN (if present) DBHZ: S/N given in dbHz. |
Interval (Optional) | double | Observation interval in seconds. |
FirstObsTime (Optional, unless RINEX file is a mixed GNSS
file) | datetime | Time of first observation record. Time systems are:
|
HasReceiverClockOffset (Optional, unless, the epoch lines
of the data section reports clock offsets) | logical | Epoch, code, and phase are corrected by applying the real-time-derived receiver clock offset. |
DCBS (Optional) | structure array | An array with number of elements equal to number of satellite systems
in the file. Each structure has
|
PCVS (Optional) | structure array | An array with number of elements equal to number of satellite systems
in the file. Each structure has
|
ScaleFactor | structure array | An array with number of elements equal to number of
|
PhaseShift (Optional) | structure array | An array with number of elements equal to number of
|
GLONASSFrequencyNumbers (Optional unless using files with
GLONASS satellites) | structure | A structure with fields
|
GLONASSCodePhaseBias | structure | A structure with fields
|
LeapSecondParameters (Optional) | structure | Leap second parameters in a structure with fields
|
NumSatellites (Optional) | double | Number of satellites, for which observations are stored in the file. |
TotalObservations (Optional) | structure array | An array of structure with the number of elements equal to the number of
PRN / # OF OBS header lines in the file. Each structure has a
SatelliteID and NumObservations field.
|
Note that optional fields are not present in the structure unless specified in the RINEX file.