1   /* Copyright 2002-2026 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.propagation.analytical.tle;
18  
19  import java.util.List;
20  
21  import org.hipparchus.analysis.differentiation.Gradient;
22  import org.orekit.attitudes.AttitudeProvider;
23  import org.orekit.frames.Frame;
24  import org.orekit.propagation.FieldSpacecraftState;
25  import org.orekit.propagation.analytical.AbstractAnalyticalGradientConverter;
26  import org.orekit.propagation.analytical.tle.generation.TleGenerationAlgorithm;
27  import org.orekit.time.TimeScale;
28  import org.orekit.utils.ParameterDriver;
29  
30  /** Converter for TLE propagator.
31   * @author Luc Maisonobe
32   * @author Bryan Cazabonne
33   * @author Thomas Paulet
34   * @since 11.0
35   */
36  class TLEGradientConverter extends AbstractAnalyticalGradientConverter {
37  
38      /** Fixed dimension of the state. */
39      public static final int FREE_STATE_PARAMETERS = 6;
40  
41      /** Current TLE. */
42      private final TLE tle;
43  
44      /** UTC time scale. */
45      private final TimeScale utc;
46  
47      /** TEME frame. */
48      private final Frame teme;
49  
50      /** Attitude provider. */
51      private final AttitudeProvider provider;
52  
53      /** Propagator. */
54      private final TLEPropagator propagator;
55  
56      /** Simple constructor.
57       * @param propagator TLE propagator used to access initial orbit
58       */
59      TLEGradientConverter(final TLEPropagator propagator) {
60          super(propagator, FREE_STATE_PARAMETERS);
61          this.tle                 = propagator.getTLE();
62          this.teme                = propagator.getFrame();
63          this.utc                 = tle.getUtc();
64          this.provider            = propagator.getAttitudeProvider();
65          this.propagator          = propagator;
66      }
67  
68      /** {@inheritDoc} */
69      @Override
70      public FieldTLEPropagator<Gradient> getPropagator() {
71  
72          final FieldSpacecraftState<Gradient> state = getState(this);
73          final Gradient[] parameters = getParameters(state, tle);
74  
75          // Zero
76          final Gradient zero = state.getMass().getField().getZero();
77  
78          // Template TLE
79          final int satelliteNumber         = tle.getSatelliteNumber();
80          final char classification         = tle.getClassification();
81          final int launchYear              = tle.getLaunchYear();
82          final int launchNumber            = tle.getLaunchNumber();
83          final String launchPiece          = tle.getLaunchPiece();
84          final int ephemerisType           = tle.getEphemerisType();
85          final int elementNumber           = tle.getElementNumber();
86          final int revolutionNumberAtEpoch = tle.getRevolutionNumberAtEpoch();
87          final double bStar                = tle.getBStar(state.getDate().toAbsoluteDate());
88  
89          // Initialize the new TLE
90          final FieldTLE<Gradient> templateTLE = new FieldTLE<>(satelliteNumber, classification,
91                  launchYear, launchNumber, launchPiece,
92                  ephemerisType, elementNumber, state.getDate(),
93                  zero, zero, zero, zero, zero, zero, zero, zero,
94                  revolutionNumberAtEpoch, bStar, utc);
95  
96          // TLE
97          final TleGenerationAlgorithm algorithm = propagator.getTleGenerationAlgorithm();
98          final FieldTLE<Gradient> gTLE = algorithm.generate(state, templateTLE);
99  
100         // Return the "Field" propagator
101         final FieldTLEPropagator<Gradient> fieldPropagator =
102             FieldTLEPropagator.selectExtrapolator(gTLE, provider, state.getMass(), teme, parameters);
103         fieldPropagator.setTleGenerationAlgorithm(algorithm);
104         return fieldPropagator;
105     }
106 
107     /** {@inheritDoc} */
108     @Override
109     public List<ParameterDriver> getParametersDrivers() {
110         return tle.getParametersDrivers();
111     }
112 
113 }