RinexNavigation.java
/* Copyright 2002-2025 CS GROUP
* Licensed to CS GROUP (CS) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* CS licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.orekit.files.rinex.navigation;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import org.orekit.files.rinex.RinexFile;
import org.orekit.gnss.SatelliteSystem;
import org.orekit.propagation.analytical.gnss.data.BeidouCivilianNavigationMessage;
import org.orekit.propagation.analytical.gnss.data.BeidouLegacyNavigationMessage;
import org.orekit.propagation.analytical.gnss.data.GLONASSFdmaNavigationMessage;
import org.orekit.propagation.analytical.gnss.data.GPSCivilianNavigationMessage;
import org.orekit.propagation.analytical.gnss.data.GPSLegacyNavigationMessage;
import org.orekit.propagation.analytical.gnss.data.GalileoNavigationMessage;
import org.orekit.propagation.analytical.gnss.data.NavICL1NvNavigationMessage;
import org.orekit.propagation.analytical.gnss.data.NavICLegacyNavigationMessage;
import org.orekit.propagation.analytical.gnss.data.QZSSCivilianNavigationMessage;
import org.orekit.propagation.analytical.gnss.data.QZSSLegacyNavigationMessage;
import org.orekit.propagation.analytical.gnss.data.SBASNavigationMessage;
/**
* Represents a parsed RINEX navigation messages files.
* @author Bryan Cazabonne
* @author Luc Maisonobe
* @since 11.0
*/
public class RinexNavigation extends RinexFile<RinexNavigationHeader> {
/** A map containing the GPS navigation messages. */
private final Map<String, List<GPSLegacyNavigationMessage>> gpsLegacyData;
/** A map containing the GPS navigation messages. */
private final Map<String, List<GPSCivilianNavigationMessage>> gpsCivilianData;
/** A map containing the Galileo navigation messages. */
private final Map<String, List<GalileoNavigationMessage>> galileoData;
/** A map containing the Beidou navigation messages. */
private final Map<String, List<BeidouLegacyNavigationMessage>> beidouLegacyData;
/** A map containing the Beidou navigation messages. */
private final Map<String, List<BeidouCivilianNavigationMessage>> beidouCivilianData;
/** A map containing the QZSS navigation messages. */
private final Map<String, List<QZSSLegacyNavigationMessage>> qzssLegacyData;
/** A map containing the QZSS navigation messages. */
private final Map<String, List<QZSSCivilianNavigationMessage>> qzssCivilianData;
/** A map containing the NavIC navigation messages. */
private final Map<String, List<NavICLegacyNavigationMessage>> navicLegacyData;
/** A map containing the NavIC navigation messages.
* @since 13.0
*/
private final Map<String, List<NavICL1NvNavigationMessage>> navicL1NVData;
/** A map containing the GLONASS navigation messages. */
private final Map<String, List<GLONASSFdmaNavigationMessage>> glonassData;
/** A map containing the SBAS navigation messages. */
private final Map<String, List<SBASNavigationMessage>> sbasData;
/** System time offsets.
* @since 12.0
*/
private final List<SystemTimeOffsetMessage> systemTimeOffsets;
/** Earth orientation parameters.
* @since 12.0
*/
private final List<EarthOrientationParameterMessage> eops;
/** Ionosphere Klobuchar messages.
* @since 12.0
*/
private final List<IonosphereKlobucharMessage> klobucharMessages;
/** Ionosphere Nequick G messages.
* @since 12.0
*/
private final List<IonosphereNequickGMessage> nequickGMessages;
/** Ionosphere BDGIM messages.
* @since 12.0
*/
private final List<IonosphereBDGIMMessage> bdgimMessages;
/** Ionosphere NavIC Klobuchar messages.
* @since 14.0
*/
private final List<IonosphereNavICKlobucharMessage> navICKlobucharMessages;
/** Ionosphere NavIC NeQuick N messages.
* @since 14.0
*/
private final List<IonosphereNavICNeQuickNMessage> navICNeQuickNMessages;
/** Ionosphere GLONASS CDMS messages.
* @since 14.0
*/
private final List<IonosphereGlonassCdmsMessage> glonassCDMSMessages;
/** Constructor. */
public RinexNavigation() {
super(new RinexNavigationHeader());
this.gpsLegacyData = new HashMap<>();
this.gpsCivilianData = new HashMap<>();
this.galileoData = new HashMap<>();
this.beidouLegacyData = new HashMap<>();
this.beidouCivilianData = new HashMap<>();
this.qzssLegacyData = new HashMap<>();
this.qzssCivilianData = new HashMap<>();
this.navicLegacyData = new HashMap<>();
this.navicL1NVData = new HashMap<>();
this.glonassData = new HashMap<>();
this.sbasData = new HashMap<>();
this.systemTimeOffsets = new ArrayList<>();
this.eops = new ArrayList<>();
this.klobucharMessages = new ArrayList<>();
this.nequickGMessages = new ArrayList<>();
this.bdgimMessages = new ArrayList<>();
this.navICKlobucharMessages = new ArrayList<>();
this.navICNeQuickNMessages = new ArrayList<>();
this.glonassCDMSMessages = new ArrayList<>();
}
/**
* Get all the GPS legacy navigation messages contained in the file.
* @return an unmodifiable list of GPS legacy navigation messages
* @since 12.0
*/
public Map<String, List<GPSLegacyNavigationMessage>> getGPSLegacyNavigationMessages() {
return Collections.unmodifiableMap(gpsLegacyData);
}
/**
* Get the GPS legacy navigation messages for the given satellite Id.
* @param satId satellite Id (i.e. Satellite System (e.g. G) + satellite number)
* @return an unmodifiable list of GPS legacy navigation messages
* @since 12.0
*/
public List<GPSLegacyNavigationMessage> getGPSLegacyNavigationMessages(final String satId) {
return Collections.unmodifiableList(gpsLegacyData.get(satId));
}
/**
* Add a GPS legacy navigation message to the list.
* @param message message to add
* @since 12.0
*/
public void addGPSLegacyNavigationMessage(final GPSLegacyNavigationMessage message) {
final int gpsPRN = message.getPRN();
final String prnString = gpsPRN < 10 ? "0" + gpsPRN : String.valueOf(gpsPRN);
final String satId = SatelliteSystem.GPS.getKey() + prnString;
gpsLegacyData.putIfAbsent(satId, new ArrayList<>());
gpsLegacyData.get(satId).add(message);
}
/**
* Get all the GPS civilian navigation messages contained in the file.
* @return an unmodifiable list of GPS civilian navigation messages
* @since 12.0
*/
public Map<String, List<GPSCivilianNavigationMessage>> getGPSCivilianNavigationMessages() {
return Collections.unmodifiableMap(gpsCivilianData);
}
/**
* Get the GPS civilian navigation messages for the given satellite Id.
* @param satId satellite Id (i.e. Satellite System (e.g. G) + satellite number)
* @return an unmodifiable list of GPS civilian navigation messages
* @since 12.0
*/
public List<GPSCivilianNavigationMessage> getGPSCivilianNavigationMessages(final String satId) {
return Collections.unmodifiableList(gpsCivilianData.get(satId));
}
/**
* Add a GPS civilian navigation message to the list.
* @param message message to add
* @since 13.0
*/
public void addGPSCivilianNavigationMessage(final GPSCivilianNavigationMessage message) {
final int gpsPRN = message.getPRN();
final String prnString = gpsPRN < 10 ? "0" + gpsPRN : String.valueOf(gpsPRN);
final String satId = SatelliteSystem.GPS.getKey() + prnString;
gpsCivilianData.putIfAbsent(satId, new ArrayList<>());
gpsCivilianData.get(satId).add(message);
}
/**
* Get all the Galileo navigation messages contained in the file.
* @return an unmodifiable list of Galileo navigation messages
*/
public Map<String, List<GalileoNavigationMessage>> getGalileoNavigationMessages() {
return Collections.unmodifiableMap(galileoData);
}
/**
* Get the Galileo navigation messages for the given satellite Id.
* @param satId satellite Id (i.e. Satellite System (e.g. E) + satellite number)
* @return an unmodifiable list of Galileo navigation messages
*/
public List<GalileoNavigationMessage> getGalileoNavigationMessages(final String satId) {
return Collections.unmodifiableList(galileoData.get(satId));
}
/**
* Add a Galileo navigation message to the list.
* @param message message to add
*/
public void addGalileoNavigationMessage(final GalileoNavigationMessage message) {
final int galPRN = message.getPRN();
final String prnString = galPRN < 10 ? "0" + galPRN : String.valueOf(galPRN);
final String satId = SatelliteSystem.GALILEO.getKey() + prnString;
galileoData.putIfAbsent(satId, new ArrayList<>());
galileoData.get(satId).add(message);
}
/**
* Get all the Beidou navigation messages contained in the file.
* @return an unmodifiable list of Beidou navigation messages
* @since 12.0
*/
public Map<String, List<BeidouLegacyNavigationMessage>> getBeidouLegacyNavigationMessages() {
return Collections.unmodifiableMap(beidouLegacyData);
}
/**
* Get the Beidou navigation messages for the given satellite Id.
* @param satId satellite Id (i.e. Satellite System (e.g. C) + satellite number)
* @return an unmodifiable list of Beidou navigation messages
* @since 12.0
*/
public List<BeidouLegacyNavigationMessage> getBeidouLegacyNavigationMessages(final String satId) {
return Collections.unmodifiableList(beidouLegacyData.get(satId));
}
/**
* Add a Beidou navigation message to the list.
* @param message message to add
* @since 12.0
*/
public void addBeidouLegacyNavigationMessage(final BeidouLegacyNavigationMessage message) {
final int bdtPRN = message.getPRN();
final String prnString = bdtPRN < 10 ? "0" + bdtPRN : String.valueOf(bdtPRN);
final String satId = SatelliteSystem.BEIDOU.getKey() + prnString;
beidouLegacyData.putIfAbsent(satId, new ArrayList<>());
beidouLegacyData.get(satId).add(message);
}
/**
* Get all the Beidou navigation messages contained in the file.
* @return an unmodifiable list of Beidou navigation messages
* @since 12.0
*/
public Map<String, List<BeidouCivilianNavigationMessage>> getBeidouCivilianNavigationMessages() {
return Collections.unmodifiableMap(beidouCivilianData);
}
/**
* Get the Beidou navigation messages for the given satellite Id.
* @param satId satellite Id (i.e. Satellite System (e.g. C) + satellite number)
* @return an unmodifiable list of Beidou navigation messages
* @since 12.0
*/
public List<BeidouCivilianNavigationMessage> getBeidouCivilianNavigationMessages(final String satId) {
return Collections.unmodifiableList(beidouCivilianData.get(satId));
}
/**
* Add a Beidou navigation message to the list.
* @param message message to add
* @since 12.0
*/
public void addBeidouCivilianNavigationMessage(final BeidouCivilianNavigationMessage message) {
final int bdtPRN = message.getPRN();
final String prnString = bdtPRN < 10 ? "0" + bdtPRN : String.valueOf(bdtPRN);
final String satId = SatelliteSystem.BEIDOU.getKey() + prnString;
beidouCivilianData.putIfAbsent(satId, new ArrayList<>());
beidouCivilianData.get(satId).add(message);
}
/**
* Get all the QZSS navigation messages contained in the file.
* @return an unmodifiable list of QZSS navigation messages
* @since 12.0
*/
public Map<String, List<QZSSLegacyNavigationMessage>> getQZSSLegacyNavigationMessages() {
return Collections.unmodifiableMap(qzssLegacyData);
}
/**
* Get the QZSS navigation messages for the given satellite Id.
* @param satId satellite Id (i.e. Satellite System (e.g. J) + satellite number)
* @return an unmodifiable list of QZSS navigation messages
* @since 12.0
*/
public List<QZSSLegacyNavigationMessage> getQZSSLegacyNavigationMessages(final String satId) {
return Collections.unmodifiableList(qzssLegacyData.get(satId));
}
/**
* Add a QZSS navigation message to the list.
* @param message message to add
* @since 12.0
*/
public void addQZSSLegacyNavigationMessage(final QZSSLegacyNavigationMessage message) {
final int qzsPRN = message.getPRN();
final String prnString = qzsPRN < 10 ? "0" + qzsPRN : String.valueOf(qzsPRN);
final String satId = SatelliteSystem.QZSS.getKey() + prnString;
qzssLegacyData.putIfAbsent(satId, new ArrayList<>());
qzssLegacyData.get(satId).add(message);
}
/**
* Get all the QZSS navigation messages contained in the file.
* @return an unmodifiable list of QZSS navigation messages
* @since 12.0
*/
public Map<String, List<QZSSCivilianNavigationMessage>> getQZSSCivilianNavigationMessages() {
return Collections.unmodifiableMap(qzssCivilianData);
}
/**
* Get the QZSS navigation messages for the given satellite Id.
* @param satId satellite Id (i.e. Satellite System (e.g. J) + satellite number)
* @return an unmodifiable list of QZSS navigation messages
* @since 12.0
*/
public List<QZSSCivilianNavigationMessage> getQZSSCivilianNavigationMessages(final String satId) {
return Collections.unmodifiableList(qzssCivilianData.get(satId));
}
/**
* Add a QZSS navigation message to the list.
* @param message message to add
* @since 12.0
*/
public void addQZSSCivilianNavigationMessage(final QZSSCivilianNavigationMessage message) {
final int qzsPRN = message.getPRN();
final String prnString = qzsPRN < 10 ? "0" + qzsPRN : String.valueOf(qzsPRN);
final String satId = SatelliteSystem.QZSS.getKey() + prnString;
qzssCivilianData.putIfAbsent(satId, new ArrayList<>());
qzssCivilianData.get(satId).add(message);
}
/**
* Get all the NavIC navigation messages contained in the file.
* @return an unmodifiable list of NavIC navigation messages
*/
public Map<String, List<NavICLegacyNavigationMessage>> getNavICLegacyNavigationMessages() {
return Collections.unmodifiableMap(navicLegacyData);
}
/**
* Get the NavIC navigation messages for the given satellite Id.
* @param satId satellite Id (i.e. Satellite System (e.g. I) + satellite number)
* @return an unmodifiable list of NavIC navigation messages
*/
public List<NavICLegacyNavigationMessage> getNavICLegacyNavigationMessages(final String satId) {
return Collections.unmodifiableList(navicLegacyData.get(satId));
}
/**
* Add a NavIC navigation message to the list.
* @param message message to add
*/
public void addNavICLegacyNavigationMessage(final NavICLegacyNavigationMessage message) {
final int irsPRN = message.getPRN();
final String prnString = irsPRN < 10 ? "0" + irsPRN : String.valueOf(irsPRN);
final String satId = SatelliteSystem.NAVIC.getKey() + prnString;
navicLegacyData.putIfAbsent(satId, new ArrayList<>());
navicLegacyData.get(satId).add(message);
}
/**
* Get all the NavIC navigation messages contained in the file.
* @return an unmodifiable list of NavIC navigation messages
*/
public Map<String, List<NavICL1NvNavigationMessage>> getNavICL1NVNavigationMessages() {
return Collections.unmodifiableMap(navicL1NVData);
}
/**
* Get the NavIC navigation messages for the given satellite Id.
* @param satId satellite Id (i.e. Satellite System (e.g. I) + satellite number)
* @return an unmodifiable list of NavIC navigation messages
*/
public List<NavICL1NvNavigationMessage> getNavICL1NVNavigationMessages(final String satId) {
return Collections.unmodifiableList(navicL1NVData.get(satId));
}
/**
* Add a NavIC navigation message to the list.
* @param message message to add
*/
public void addNavICL1NVNavigationMessage(final NavICL1NvNavigationMessage message) {
final int irsPRN = message.getPRN();
final String prnString = irsPRN < 10 ? "0" + irsPRN : String.valueOf(irsPRN);
final String satId = SatelliteSystem.NAVIC.getKey() + prnString;
navicL1NVData.putIfAbsent(satId, new ArrayList<>());
navicL1NVData.get(satId).add(message);
}
/**
* Get all the Glonass navigation messages contained in the file.
* @return an unmodifiable list of Glonass navigation messages
*/
public Map<String, List<GLONASSFdmaNavigationMessage>> getGlonassNavigationMessages() {
return Collections.unmodifiableMap(glonassData);
}
/**
* Get the Glonass navigation messages for the given satellite Id.
* @param satId satellite Id (i.e. Satellite System (e.g. R) + satellite number)
* @return an unmodifiable list of Glonass navigation messages
*/
public List<GLONASSFdmaNavigationMessage> getGlonassNavigationMessages(final String satId) {
return Collections.unmodifiableList(glonassData.get(satId));
}
/**
* Add a Glonass navigation message to the list.
* @param message message to add
*/
public void addGlonassNavigationMessage(final GLONASSFdmaNavigationMessage message) {
final int gloPRN = message.getPRN();
final String prnString = gloPRN < 10 ? "0" + gloPRN : String.valueOf(gloPRN);
final String satId = SatelliteSystem.GLONASS.getKey() + prnString;
glonassData.putIfAbsent(satId, new ArrayList<>());
glonassData.get(satId).add(message);
}
/**
* Get all the SBAS navigation messages contained in the file.
* @return an unmodifiable list of SBAS navigation messages
*/
public Map<String, List<SBASNavigationMessage>> getSBASNavigationMessages() {
return Collections.unmodifiableMap(sbasData);
}
/**
* Get the SBAS navigation messages for the given satellite Id.
* @param satId satellite Id (i.e. Satellite System (e.g. S) + satellite number)
* @return an unmodifiable list of SBAS navigation messages
*/
public List<SBASNavigationMessage> getSBASNavigationMessages(final String satId) {
return Collections.unmodifiableList(sbasData.get(satId));
}
/**
* Add a SBAS navigation message to the list.
* @param message message to add
*/
public void addSBASNavigationMessage(final SBASNavigationMessage message) {
final int sbsPRN = message.getPRN();
final String prnString = sbsPRN < 10 ? "0" + sbsPRN : String.valueOf(sbsPRN);
final String satId = SatelliteSystem.SBAS.getKey() + prnString;
sbasData.putIfAbsent(satId, new ArrayList<>());
sbasData.get(satId).add(message);
}
/**
* Get the system time offsets.
* @return an unmodifiable list of system time offsets
* @since 12.0
*/
public List<SystemTimeOffsetMessage> getSystemTimeOffsets() {
return Collections.unmodifiableList(systemTimeOffsets);
}
/**
* Add a system time offset.
* @param systemTimeOffset system time offset message
* @since 12.0
*/
public void addSystemTimeOffset(final SystemTimeOffsetMessage systemTimeOffset) {
systemTimeOffsets.add(systemTimeOffset);
}
/**
* Get the Earth orientation parameters.
* @return an unmodifiable list of Earth orientation parameters
* @since 12.0
*/
public List<EarthOrientationParameterMessage> getEarthOrientationParameters() {
return Collections.unmodifiableList(eops);
}
/**
* Add an Earth orientation parameter.
* @param eop Earth orientation oarameter message
* @since 12.0
*/
public void addEarthOrientationParameter(final EarthOrientationParameterMessage eop) {
eops.add(eop);
}
/**
* Get the ionosphere Klobuchar messages.
* @return an unmodifiable list of ionosphere Klobuchar messages
* @since 12.0
*/
public List<IonosphereKlobucharMessage> getKlobucharMessages() {
return Collections.unmodifiableList(klobucharMessages);
}
/**
* Add an ionosphere Klobuchar message.
* @param klobuchar ionosphere Klobuchar message
* @since 12.0
*/
public void addKlobucharMessage(final IonosphereKlobucharMessage klobuchar) {
klobucharMessages.add(klobuchar);
}
/**
* Get the ionosphere Nequick-G messages.
* @return an unmodifiable list of ionosphere Nequick-G messages
* @since 12.0
*/
public List<IonosphereNequickGMessage> getNequickGMessages() {
return Collections.unmodifiableList(nequickGMessages);
}
/**
* Add an ionosphere Nequick-G message.
* @param nequickG ionosphere Nequick-G message
* @since 12.0
*/
public void addNequickGMessage(final IonosphereNequickGMessage nequickG) {
nequickGMessages.add(nequickG);
}
/**
* Get the ionosphere BDGIM messages.
* @return an unmodifiable list of ionosphere BDGIM messages
* @since 12.0
*/
public List<IonosphereBDGIMMessage> getBDGIMMessages() {
return Collections.unmodifiableList(bdgimMessages);
}
/**
* Add an ionosphere BDGIM message.
* @param bdgim ionosphere BDGIM message
* @since 12.0
*/
public void addBDGIMMessage(final IonosphereBDGIMMessage bdgim) {
bdgimMessages.add(bdgim);
}
/**
* Get the ionosphere NavIC Klobuchar messages.
* @return an unmodifiable list of ionosphere NavIC Klobuchar messages
* @since 14.0
*/
public List<IonosphereNavICKlobucharMessage> getNavICKlobucharMessages() {
return Collections.unmodifiableList(navICKlobucharMessages);
}
/**
* Add an ionosphere NavIC Klobuchar message.
* @param navIcKlobuchar ionosphere NavIC Klobuchar message
* @since 14.0
*/
public void addNavICKlobucharMessage(final IonosphereNavICKlobucharMessage navIcKlobuchar) {
navICKlobucharMessages.add(navIcKlobuchar);
}
/**
* Get the ionosphere NavIC NeQuick N messages.
* @return an unmodifiable list of ionosphere NavIC NeQuick N messages
* @since 14.0
*/
public List<IonosphereNavICNeQuickNMessage> getNavICNeQuickNMessages() {
return Collections.unmodifiableList(navICNeQuickNMessages);
}
/**
* Add an ionosphere NavIC NeQuick N message.
* @param navIcNeQuickN ionosphere NavIC NeQuick N message
* @since 14.0
*/
public void addNavICNeQuickNMessage(final IonosphereNavICNeQuickNMessage navIcNeQuickN) {
navICNeQuickNMessages.add(navIcNeQuickN);
}
/**
* Get the ionosphere GLONASS CDMS messages.
* @return an unmodifiable list of ionosphere GLONASS CDMS messages
* @since 14.0
*/
public List<IonosphereGlonassCdmsMessage> getGlonassCDMSMessages() {
return Collections.unmodifiableList(glonassCDMSMessages);
}
/**
* Add an ionosphere GLONASS CDMS message.
* @param glonassCDMS ionosphere GLONASS CDMS message
* @since 14.0
*/
public void addGlonassCDMSMessage(final IonosphereGlonassCdmsMessage glonassCDMS) {
glonassCDMSMessages.add(glonassCDMS);
}
}