1   /* Copyright 2002-2025 CS GROUP
2    * Licensed to CS GROUP (CS) under one or more
3    * contributor license agreements.  See the NOTICE file distributed with
4    * this work for additional information regarding copyright ownership.
5    * CS licenses this file to You under the Apache License, Version 2.0
6    * (the "License"); you may not use this file except in compliance with
7    * the License.  You may obtain a copy of the License at
8    *
9    *   http://www.apache.org/licenses/LICENSE-2.0
10   *
11   * Unless required by applicable law or agreed to in writing, software
12   * distributed under the License is distributed on an "AS IS" BASIS,
13   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14   * See the License for the specific language governing permissions and
15   * limitations under the License.
16   */
17  package org.orekit.estimation.measurements.modifiers;
18  
19  import java.util.Collections;
20  import java.util.List;
21  
22  import org.hipparchus.geometry.euclidean.threed.Vector3D;
23  import org.orekit.attitudes.AttitudeProvider;
24  import org.orekit.estimation.measurements.EstimatedMeasurementBase;
25  import org.orekit.estimation.measurements.EstimationModifier;
26  import org.orekit.estimation.measurements.gnss.OneWayGNSSPhase;
27  import org.orekit.gnss.antenna.FrequencyPattern;
28  import org.orekit.utils.ParameterDriver;
29  
30  /** On-board antenna offset effect on one-way GNSS phase measurements.
31   * @author Bryan Cazabonne
32   * @since 10.3
33   */
34  public class OnBoardAntennaOneWayGNSSPhaseModifier
35      extends PhaseCentersOneWayGNSSBaseModifier<OneWayGNSSPhase>
36      implements EstimationModifier<OneWayGNSSPhase> {
37  
38      /** Simple constructor.
39       * @param receiverPhaseCenter position of the Antenna Phase Center in satellite 1 frame
40       * (i.e. the satellite which receives the signal and performs the measurement)
41       * @param emitterPhaseCenter position of the Antenna Phase Center in satellite 2 frame
42       * (i.e. the satellite which simply emits the signal)
43       * @param attitudeProvider attitude provider of the emitting satellite
44       */
45      public OnBoardAntennaOneWayGNSSPhaseModifier(final Vector3D receiverPhaseCenter,
46                                                   final Vector3D emitterPhaseCenter,
47                                                   final AttitudeProvider attitudeProvider) {
48          this(new FrequencyPattern(receiverPhaseCenter, null),
49               new FrequencyPattern(emitterPhaseCenter, null),
50               attitudeProvider);
51      }
52  
53      /** Simple constructor.
54       * @param receiverPattern pattern for receiver satellite
55       * @param emitterPattern  pattern for emitter satellite
56       * @param attitudeProvider attitude provider of the emitting satellite
57       * @since 12.1
58       */
59      public OnBoardAntennaOneWayGNSSPhaseModifier(final FrequencyPattern receiverPattern,
60                                                   final FrequencyPattern emitterPattern,
61                                                   final AttitudeProvider attitudeProvider) {
62          super(receiverPattern, emitterPattern, attitudeProvider);
63      }
64  
65      /** {@inheritDoc} */
66      @Override
67      public List<ParameterDriver> getParametersDrivers() {
68          return Collections.emptyList();
69      }
70  
71      /** {@inheritDoc} */
72      @Override
73      public void modifyWithoutDerivatives(final EstimatedMeasurementBase<OneWayGNSSPhase> estimated) {
74          estimated.modifyEstimatedValue(this,
75                                         estimated.getEstimatedValue()[0] +
76                                         oneWayDistanceModification(estimated) /
77                                         estimated.getObservedMeasurement().getWavelength());
78      }
79  
80  }