1   /* Copyright 2002-2024 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 org.orekit.attitudes.FrameAlignedProvider;
20  import org.orekit.estimation.measurements.EstimatedMeasurement;
21  import org.orekit.estimation.measurements.EstimatedMeasurementBase;
22  import org.orekit.estimation.measurements.EstimationModifier;
23  import org.orekit.estimation.measurements.GroundStation;
24  import org.orekit.estimation.measurements.Range;
25  import org.orekit.models.earth.troposphere.TroposphericModel;
26  import org.orekit.propagation.SpacecraftState;
27  
28  /** Class modifying theoretical range measurement with tropospheric delay.
29   * <p>
30   * The effect of tropospheric correction on the range is directly computed
31   * through the computation of the tropospheric delay.
32   * </p>
33   * <p>
34   * In general, for GNSS, VLBI, ... there is hardly any frequency dependence in the delay.
35   * For SLR techniques however, the frequency dependence is sensitive.
36   * </p>
37   *
38   * @author Maxime Journot
39   * @author Joris Olympio
40   * @since 8.0
41   */
42  public class RangeTroposphericDelayModifier extends BaseRangeTroposphericDelayModifier implements EstimationModifier<Range> {
43  
44      /** Constructor.
45       *
46       * @param model  Tropospheric delay model appropriate for the current range measurement method.
47       * @deprecated as of 12.1, replaced by {@link #RangeTroposphericDelayModifier(TroposphericModel)}
48       */
49      @Deprecated
50      public RangeTroposphericDelayModifier(final org.orekit.models.earth.troposphere.DiscreteTroposphericModel model) {
51          this(new org.orekit.models.earth.troposphere.TroposphericModelAdapter(model));
52      }
53  
54      /** Constructor.
55       *
56       * @param model  Tropospheric delay model appropriate for the current range measurement method.
57       * @since 12.1
58       */
59      public RangeTroposphericDelayModifier(final TroposphericModel model) {
60          super(model);
61      }
62  
63      /** {@inheritDoc} */
64      @Override
65      public void modifyWithoutDerivatives(final EstimatedMeasurementBase<Range> estimated) {
66  
67          final Range         measurement = estimated.getObservedMeasurement();
68          final GroundStation station     = measurement.getStation();
69  
70          RangeModifierUtil.modifyWithoutDerivatives(estimated,  station,
71                                                     this::rangeErrorTroposphericModel,
72                                                     this);
73  
74  
75      }
76  
77      /** {@inheritDoc} */
78      @Override
79      public void modify(final EstimatedMeasurement<Range> estimated) {
80  
81          final Range           measurement = estimated.getObservedMeasurement();
82          final GroundStation   station     = measurement.getStation();
83          final SpacecraftState state       = estimated.getStates()[0];
84  
85          RangeModifierUtil.modify(estimated, getTropoModel(),
86                                   new ModifierGradientConverter(state, 6, new FrameAlignedProvider(state.getFrame())),
87                                   station,
88                                   this::rangeErrorTroposphericModel,
89                                   this::rangeErrorTroposphericModel,
90                                   this);
91  
92  
93      }
94  
95  }