RinexUtils.java
/* Copyright 2002-2024 Luc Maisonobe
* 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.utils.parsing;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
import org.hipparchus.util.FastMath;
import org.orekit.errors.OrekitException;
import org.orekit.errors.OrekitInternalError;
import org.orekit.errors.OrekitMessages;
import org.orekit.files.rinex.RinexFile;
import org.orekit.files.rinex.section.RinexBaseHeader;
import org.orekit.files.rinex.section.RinexComment;
import org.orekit.files.rinex.utils.RinexFileType;
import org.orekit.gnss.SatelliteSystem;
import org.orekit.gnss.TimeSystem;
import org.orekit.time.AbsoluteDate;
import org.orekit.time.DateComponents;
import org.orekit.time.DateTimeComponents;
import org.orekit.time.Month;
import org.orekit.time.TimeComponents;
import org.orekit.time.TimeScale;
import org.orekit.time.TimeScales;
/** Utilities for RINEX various messages files.
* @author Luc Maisonobe
* @since 12.0
*
*/
public class RinexUtils {
/** Index of label in header lines. */
public static final int LABEL_INDEX = 60;
/** Pattern for splitting date, time and time zone. */
private static final Pattern SPLITTING_PATTERN = Pattern.compile("([0-9A-Za-z/-]+) *([0-9:]+) *([A-Z][A-Z0-9_-]*)?");
/** Pattern for dates with month abbrevation. */
private static final Pattern DATE_DD_MMM_YY_PATTERN = Pattern.compile("([0-9]{2})-([A-Za-z]{3})-([0-9]{2})");
/** Pattern for dates in ISO-8601 complete representation (basic or extended). */
private static final Pattern DATE_ISO_8601_PATTERN = Pattern.compile("([0-9]{4})-?([0-9]{2})-?([0-9]{2})");
/** Pattern for dates in european format. */
private static final Pattern DATE_EUROPEAN_PATTERN = Pattern.compile("([0-9]{2})/([0-9]{2})/([0-9]{2})");
/** Pattern for time. */
private static final Pattern TIME_PATTERN = Pattern.compile("([0-9]{2}):?([0-9]{2})(?::?([0-9]{2}))?");
/** Private constructor.
* <p>This class is a utility class, it should neither have a public
* nor a default constructor. This private constructor prevents
* the compiler from generating one automatically.</p>
*/
private RinexUtils() {
}
/** Get the trimmed label from a header line.
* @param line header line to parse
* @return trimmed label
*/
public static String getLabel(final String line) {
return line.length() < LABEL_INDEX ? "" : line.substring(LABEL_INDEX).trim();
}
/** Check if a header line matches an expected label.
* @param line header line to check
* @param label expected label
* @return true if line matches expected label
*/
public static boolean matchesLabel(final String line, final String label) {
return getLabel(line).equals(label);
}
/** Parse version, file type and satellite system.
* @param line line to parse
* @param name file name (for error message generation)
* @param header header to fill with parsed data
* @param supportedVersions supported versions
*/
public static void parseVersionFileTypeSatelliteSystem(final String line, final String name,
final RinexBaseHeader header,
final double... supportedVersions) {
// Rinex version
final double parsedVersion = parseDouble(line, 0, 9);
boolean found = false;
for (final double supported : supportedVersions) {
if (FastMath.abs(parsedVersion - supported) < 1.0e-4) {
found = true;
break;
}
}
if (!found) {
final StringBuilder builder = new StringBuilder();
for (final double supported : supportedVersions) {
if (builder.length() > 0) {
builder.append(", ");
}
builder.append(supported);
}
throw new OrekitException(OrekitMessages.UNSUPPORTED_FILE_FORMAT_VERSION,
parsedVersion, name, builder.toString());
}
header.setFormatVersion(parsedVersion);
// File type
if (header.getFileType() != RinexFileType.parseRinexFileType(parseString(line, 20, 1))) {
throw new OrekitException(OrekitMessages.WRONG_PARSING_TYPE, name);
}
// Satellite system
switch (header.getFileType()) {
case OBSERVATION:
// for observation files, the satellite system is in column 40, and empty defaults to GPS
header.setSatelliteSystem(SatelliteSystem.parseSatelliteSystemWithGPSDefault(parseString(line, 40, 1)));
break;
case NAVIGATION: {
if (header.getFormatVersion() < 3.0) {
// the satellite system is hidden within the entry, with GPS as default
// set up default
header.setSatelliteSystem(SatelliteSystem.GPS);
// look if default is overridden somewhere in the entry
final String entry = parseString(line, 0, LABEL_INDEX).toUpperCase();
for (final SatelliteSystem satelliteSystem : SatelliteSystem.values()) {
if (entry.contains(satelliteSystem.name())) {
// we found a satellite system hidden in the middle of the line
header.setSatelliteSystem(satelliteSystem);
break;
}
}
} else {
// the satellite system is in column 40 for 3.X and later
header.setSatelliteSystem(SatelliteSystem.parseSatelliteSystemWithGPSDefault(parseString(line, 40, 1)));
}
break;
}
default:
// this should never happen
throw new OrekitInternalError(null);
}
}
/** Parse program, run/by and date.
* @param line line to parse
* @param lineNumber line number
* @param name file name (for error message generation)
* @param timeScales the set of time scales used for parsing dates.
* @param header header to fill with parsed data
*/
public static void parseProgramRunByDate(final String line, final int lineNumber,
final String name, final TimeScales timeScales,
final RinexBaseHeader header) {
// Name of the generating program
header.setProgramName(parseString(line, 0, 20));
// Name of the run/by name
header.setRunByName(parseString(line, 20, 20));
// there are several variations for date formatting in the PGM / RUN BY / DATE line
// in versions 2.x, the pattern is expected to be:
// XXRINEXO V9.9 AIUB 24-MAR-01 14:43 PGM / RUN BY / DATE
// however, we have also found this:
// teqc 2016Nov7 root 20180130 10:38:06UTCPGM / RUN BY / DATE
// BJFMTLcsr UTCSR 2007-09-30 05:30:06 PGM / RUN BY / DATE
// NEODIS TAS 27/05/22 10:28 PGM / RUN BY / DATE
// in versions 3.x, the pattern is expected to be:
// sbf2rin-11.3.3 20180130 002558 LCL PGM / RUN BY / DATE
// however, we have also found:
// NetR9 5.03 Receiver Operator 11-JAN-16 00:00:00 PGM / RUN BY / DATE
// so we cannot rely on the format version, we have to check several variations
final Matcher splittingMatcher = SPLITTING_PATTERN.matcher(parseString(line, 40, 20));
if (splittingMatcher.matches()) {
// date part
final DateComponents dc;
final Matcher abbrevMatcher = DATE_DD_MMM_YY_PATTERN.matcher(splittingMatcher.group(1));
if (abbrevMatcher.matches()) {
// hoping this obsolete format will not be used past year 2079…
dc = new DateComponents(convert2DigitsYear(Integer.parseInt(abbrevMatcher.group(3))),
Month.parseMonth(abbrevMatcher.group(2)).getNumber(),
Integer.parseInt(abbrevMatcher.group(1)));
} else {
final Matcher isoMatcher = DATE_ISO_8601_PATTERN.matcher(splittingMatcher.group(1));
if (isoMatcher.matches()) {
dc = new DateComponents(Integer.parseInt(isoMatcher.group(1)),
Integer.parseInt(isoMatcher.group(2)),
Integer.parseInt(isoMatcher.group(3)));
} else {
final Matcher europeanMatcher = DATE_EUROPEAN_PATTERN.matcher(splittingMatcher.group(1));
if (europeanMatcher.matches()) {
dc = new DateComponents(convert2DigitsYear(Integer.parseInt(europeanMatcher.group(3))),
Integer.parseInt(europeanMatcher.group(2)),
Integer.parseInt(europeanMatcher.group(1)));
} else {
dc = null;
}
}
}
// time part
final TimeComponents tc;
final Matcher timeMatcher = TIME_PATTERN.matcher(splittingMatcher.group(2));
if (timeMatcher.matches()) {
tc = new TimeComponents(Integer.parseInt(timeMatcher.group(1)),
Integer.parseInt(timeMatcher.group(2)),
timeMatcher.group(3) != null ? Integer.parseInt(timeMatcher.group(3)) : 0);
} else {
tc = null;
}
// zone part
final String zone = splittingMatcher.groupCount() > 2 ? splittingMatcher.group(3) : "";
if (dc != null && tc != null) {
// we successfully parsed everything
final DateTimeComponents dtc = new DateTimeComponents(dc, tc);
header.setCreationDateComponents(dtc);
final TimeScale timeScale = zone == null ?
timeScales.getUTC() :
TimeSystem.parseTimeSystem(zone).getTimeScale(timeScales);
header.setCreationDate(new AbsoluteDate(dtc, timeScale));
header.setCreationTimeZone(zone);
return;
}
}
// we were not able to extract date
throw new OrekitException(OrekitMessages.UNABLE_TO_PARSE_LINE_IN_FILE,
lineNumber, name, line);
}
/** Parse a comment.
* @param lineNumber line number
* @param line line to parse
* @param rinexFile rinex file
*/
public static void parseComment(final int lineNumber, final String line, final RinexFile<?> rinexFile) {
rinexFile.addComment(new RinexComment(lineNumber, parseString(line, 0, 60)));
}
/**
* Parse a double value.
* @param line line to parse
* @param startIndex start index
* @param size size of the value
* @return the parsed value
*/
public static double parseDouble(final String line, final int startIndex, final int size) {
final String subString = parseString(line, startIndex, size);
if (subString == null || subString.isEmpty()) {
return Double.NaN;
} else {
return Double.parseDouble(subString.replace('D', 'E').trim());
}
}
/**
* Parse an integer value.
* @param line line to parse
* @param startIndex start index
* @param size size of the value
* @return the parsed value
*/
public static int parseInt(final String line, final int startIndex, final int size) {
final String subString = parseString(line, startIndex, size);
if (subString == null || subString.isEmpty()) {
return 0;
} else {
return Integer.parseInt(subString.trim());
}
}
/**
* Parse a string value.
* @param line line to parse
* @param startIndex start index
* @param size size of the value
* @return the parsed value
*/
public static String parseString(final String line, final int startIndex, final int size) {
if (line.length() > startIndex) {
return line.substring(startIndex, FastMath.min(line.length(), startIndex + size)).trim();
} else {
return null;
}
}
/** Convert a 2 digits year to a complete year.
* @param yy year between 0 and 99
* @return complete year
* @since 12.0
*/
public static int convert2DigitsYear(final int yy) {
return yy >= 80 ? (yy + 1900) : (yy + 2000);
}
}