SatelliteType.java
/* Copyright 2002-2024 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.gnss.antenna;
import java.util.HashMap;
import java.util.Map;
import java.util.regex.Pattern;
import org.orekit.errors.OrekitIllegalArgumentException;
import org.orekit.errors.OrekitMessages;
import org.orekit.frames.Frame;
import org.orekit.gnss.attitude.BeidouGeo;
import org.orekit.gnss.attitude.BeidouIGSO;
import org.orekit.gnss.attitude.BeidouMeo;
import org.orekit.gnss.attitude.GNSSAttitudeProvider;
import org.orekit.gnss.attitude.GPSBlockIIA;
import org.orekit.gnss.attitude.GPSBlockIIF;
import org.orekit.gnss.attitude.GPSBlockIIR;
import org.orekit.gnss.attitude.Galileo;
import org.orekit.gnss.attitude.GenericGNSS;
import org.orekit.gnss.attitude.Glonass;
import org.orekit.time.AbsoluteDate;
import org.orekit.utils.ExtendedPVCoordinatesProvider;
/**
* Enumerate for satellite types.
*
* @author Luc Maisonobe
* @since 9.3
*/
public enum SatelliteType {
/** BeiDou-2 GEO. */
BEIDOU_2G("BEIDOU-2G") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new BeidouGeo(validityStart, validityEnd, sun, inertialFrame);
}
},
/** BeiDou-2 IGSO. */
BEIDOU_2I("BEIDOU-2I") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new BeidouIGSO(validityStart, validityEnd, sun, inertialFrame);
}
},
/** BeiDou-2 MEO. */
BEIDOU_2M("BEIDOU-2M") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new BeidouMeo(validityStart, validityEnd, sun, inertialFrame);
}
},
/** BeiDou-3 IGSO. */
BEIDOU_3I("BEIDOU-3I") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// it seems Beidou III satellites use Galileo mode
return new Galileo(Galileo.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** BeiDou-3. */
BEIDOU_3SI_SECM("BEIDOU-3SI-SECM") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// it seems Beidou III satellites use Galileo mode
return new Galileo(Galileo.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** BeiDou-3. */
BEIDOU_3SI_CAST("BEIDOU-3SI-CAST") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// it seems Beidou III satellites use Galileo mode
return new Galileo(Galileo.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** BeiDou-3. */
BEIDOU_3M_CAST("BEIDOU-3M-CAST") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// it seems Beidou III satellites use Galileo mode
return new Galileo(Galileo.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** BeiDou-3. */
BEIDOU_3SM_CAST("BEIDOU-3SM-CAST") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// it seems Beidou III satellites use Galileo mode
return new Galileo(Galileo.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** BeiDou-3. */
BEIDOU_3M_SECM("BEIDOU-3M-SECM") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// it seems Beidou III satellites use Galileo mode
return new Galileo(Galileo.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** BeiDou-3. */
BEIDOU_3G_CAST("BEIDOU-3G-CAST") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// it seems Beidou III satellites use Galileo mode
return new Galileo(Galileo.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** GPS Block I : SVN 01-11. */
BLOCK_I("BLOCK I") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new GPSBlockIIA(GPSBlockIIA.getDefaultYawRate(prnNumber),
GPSBlockIIA.DEFAULT_YAW_BIAS,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** GPS Block II : SVN 13-21. */
BLOCK_II("BLOCK II") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new GPSBlockIIA(GPSBlockIIA.getDefaultYawRate(prnNumber),
GPSBlockIIA.DEFAULT_YAW_BIAS,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** GPS Block IIA : SVN 22-40. */
BLOCK_IIA("BLOCK IIA") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new GPSBlockIIA(GPSBlockIIA.getDefaultYawRate(prnNumber),
GPSBlockIIA.DEFAULT_YAW_BIAS,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** GPS Block IIR : SVN 41, 43-46, 51, 54, 56. */
BLOCK_IIR_A("BLOCK IIR-A") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new GPSBlockIIR(GPSBlockIIR.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** GPS Block IIR : SVN 47, 59-61. */
BLOCK_IIR_B("BLOCK IIR-B") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new GPSBlockIIR(GPSBlockIIR.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** GPS Block IIR-M : SVN 48-50, 52-53, 55, 57-58. */
BLOCK_IIR_M("BLOCK IIR-M") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new GPSBlockIIR(GPSBlockIIR.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** GPS Block IIF : SVN 62-73. */
BLOCK_IIF("BLOCK IIF") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new GPSBlockIIF(GPSBlockIIF.DEFAULT_YAW_RATE,
GPSBlockIIF.DEFAULT_YAW_BIAS,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** GPS Block IIIA : SVN 74-81. */
BLOCK_IIIA("BLOCK IIIA") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// we don't have yet a specific mode for block IIIA, we reuse block IIF
return new GPSBlockIIF(GPSBlockIIF.DEFAULT_YAW_RATE,
GPSBlockIIF.DEFAULT_YAW_BIAS,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** Galileo In-Orbit Validation Element A (GIOVE-A). */
GALILEO_0A("GALILEO-0A") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new Galileo(Galileo.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** Galileo In-Orbit Validation Element B (GIOVE-B). */
GALILEO_0B("GALILEO-0B") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new Galileo(Galileo.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** Galileo IOV : GSAT 0101-0104. */
GALILEO_1("GALILEO-1") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new Galileo(Galileo.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** Galileo FOC : GSAT 0201-0222. */
GALILEO_2("GALILEO-2") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new Galileo(Galileo.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** GLONASS : GLONASS no. 201-249, 750-798. */
GLONASS("GLONASS") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new Glonass(Glonass.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** GLONASS-M : GLONASS no. 701-749, IGS SVN R850-R861 (GLO no. + 100). */
GLONASS_M("GLONASS-M") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new Glonass(Glonass.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** GLONASS-K1 : IGS SVN R801-R802 (GLO no. + 100). */
GLONASS_K1("GLONASS-K1") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new Glonass(Glonass.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** GLONASS-K2. */
GLONASS_K2("GLONASS-K2") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
return new Glonass(Glonass.DEFAULT_YAW_RATE,
validityStart, validityEnd, sun, inertialFrame);
}
},
/** IRNSS-1 GEO. */
IRNSS_1GEO("IRNSS-1GEO") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// we don't have yet a specific mode for IRNSS, we use generic GNSS (simple yaw steering)
return new GenericGNSS(validityStart, validityEnd, sun, inertialFrame);
}
},
/** IRNSS-1 IGSO. */
IRNSS_1IGSO("IRNSS-1IGSO") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// we don't have yet a specific mode for IRNSS, we use generic GNSS (simple yaw steering)
return new GenericGNSS(validityStart, validityEnd, sun, inertialFrame);
}
},
/** QZSS Block I (Michibiki-1). */
QZSS("QZSS") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// we don't have yet a specific mode for QZSS, we use generic GNSS (simple yaw steering)
return new GenericGNSS(validityStart, validityEnd, sun, inertialFrame);
}
},
/** QZSS Block II (Michibiki-2). */
QZSS_2A("QZSS-2A") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// we don't have yet a specific mode for QZSS, we use generic GNSS (simple yaw steering)
return new GenericGNSS(validityStart, validityEnd, sun, inertialFrame);
}
},
/** QZSS Block II IGSO (Michibiki-2,4). */
QZSS_2I("QZSS-2I") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// we don't have yet a specific mode for QZSS, we use generic GNSS (simple yaw steering)
return new GenericGNSS(validityStart, validityEnd, sun, inertialFrame);
}
},
/** QZSS Block II GEO (Michibiki-3). */
QZSS_2G("QZSS-2G") {
/** {@inheritDoc} */
@Override
public GNSSAttitudeProvider buildAttitudeProvider(final AbsoluteDate validityStart,
final AbsoluteDate validityEnd,
final ExtendedPVCoordinatesProvider sun,
final Frame inertialFrame, final int prnNumber) {
// we don't have yet a specific mode for QZSS, we use generic GNSS (simple yaw steering)
return new GenericGNSS(validityStart, validityEnd, sun, inertialFrame);
}
};
/** Pattern for satellite antenna code. */
private static final Pattern PATTERN = Pattern.compile("[-_ ]");
/** Parsing map. */
private static final Map<String, SatelliteType> NAMES_MAP = new HashMap<>();
static {
for (final SatelliteType satelliteAntennaCode : values()) {
NAMES_MAP.put(satelliteAntennaCode.getName(), satelliteAntennaCode);
NAMES_MAP.put(PATTERN.matcher(satelliteAntennaCode.getName()).replaceAll(""), satelliteAntennaCode);
}
}
/** IGS name for the antenna code. */
private final String name;
/** Simple constructor.
* @param name IGS name for the antenna code
*/
SatelliteType(final String name) {
this.name = name;
}
/** Get the IGS name for the antenna code.
* @return IGS name for the antenna code
*/
public String getName() {
return name;
}
/** Build an attitude provider suitable for this satellite type.
* <p>
* Apart from the caller-provided validity interval, Sun provider,
* frame and PRN number, all construction parameters required for
* the {@link GNSSAttitudeProvider} (for example yaw rates and biases)
* will be the default ones. If non-default values are needed, the
* constructor of the appropriate {@link GNSSAttitudeProvider} must be
* called explicitly instead of relying on this general purpose factory
* method.
* </p>
* @param validityStart start of validity for this provider
* @param validityEnd end of validity for this provider
* @param sun provider for Sun position
* @param inertialFrame inertial frame where velocity are computed
* @param prnNumber number within the satellite system
* @return an attitude provider suitable for this satellite type
*/
public abstract GNSSAttitudeProvider buildAttitudeProvider(AbsoluteDate validityStart,
AbsoluteDate validityEnd,
ExtendedPVCoordinatesProvider sun,
Frame inertialFrame, int prnNumber);
/** Parse a string to get the satellite type.
* <p>
* The name must be either a strict IGS name (like "BLOCK IIR-B") or
* an IGS name canonicalized by removing all spaces, hypen and underscore
* characters (like BLOCKIIRB").
* </p>
* @param s string to parse (must be a strict IGS name)
* @return the satellite type
* @exception OrekitIllegalArgumentException if the string does not correspond to a satellite antenna code
*/
public static SatelliteType parseSatelliteType(final String s)
throws OrekitIllegalArgumentException {
final SatelliteType satelliteAntennaCode = NAMES_MAP.get(s);
if (satelliteAntennaCode == null) {
throw new OrekitIllegalArgumentException(OrekitMessages.UNKNOWN_SATELLITE_ANTENNA_CODE, s);
}
return satelliteAntennaCode;
}
}