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.leastsquares;
18  
19  import java.util.List;
20  
21  import org.hipparchus.linear.MatrixUtils;
22  import org.hipparchus.linear.RealMatrix;
23  import org.orekit.estimation.measurements.ObservedMeasurement;
24  import org.orekit.orbits.Orbit;
25  import org.orekit.propagation.MatricesHarvester;
26  import org.orekit.propagation.Propagator;
27  import org.orekit.propagation.conversion.PropagatorBuilder;
28  import org.orekit.propagation.numerical.NumericalPropagator;
29  import org.orekit.utils.ParameterDriversList;
30  
31  /** Bridge between {@link ObservedMeasurement measurements} and {@link
32   * org.hipparchus.optim.nonlinear.vector.leastsquares.LeastSquaresProblem
33   * least squares problems}.
34   * @author Luc Maisonobe
35   * @since 8.0
36   */
37  public class BatchLSModel extends AbstractBatchLSModel {
38  
39      /** Name of the State Transition Matrix state. */
40      private static final String STM_NAME = BatchLSModel.class.getName() + "-derivatives";
41  
42      /** Simple constructor.
43       * @param propagatorBuilders builders to use for propagation
44       * @param measurements measurements
45       * @param estimatedMeasurementsParameters estimated measurements parameters
46       * @param observer observer to be notified at model calls
47       */
48      public BatchLSModel(final PropagatorBuilder[] propagatorBuilders,
49                          final List<ObservedMeasurement<?>> measurements,
50                          final ParameterDriversList estimatedMeasurementsParameters,
51                          final ModelObserver observer) {
52          // call super constructor
53          super(propagatorBuilders, measurements, estimatedMeasurementsParameters, observer);
54      }
55  
56      /** {@inheritDoc} */
57      @Override
58      protected MatricesHarvester configureHarvester(final Propagator propagator) {
59          final RealMatrix initialStm;
60          if (propagator instanceof NumericalPropagator) {
61              initialStm = MatrixUtils.createRealIdentityMatrix(7);
62          } else {
63              initialStm = MatrixUtils.createRealIdentityMatrix(6);
64          }
65          return propagator.setupMatricesComputation(STM_NAME, initialStm, null);
66      }
67  
68      /** {@inheritDoc} */
69      @Override
70      protected Orbit configureOrbits(final MatricesHarvester harvester, final Propagator propagator) {
71          // Directly return the propagator's initial state
72          return propagator.getInitialState().getOrbit();
73      }
74  
75  }