1   /* Copyright 2022-2025 Romain Serra
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.forces;
18  
19  import org.hipparchus.CalculusFieldElement;
20  import org.hipparchus.Field;
21  import org.hipparchus.geometry.euclidean.threed.FieldVector3D;
22  import org.hipparchus.geometry.euclidean.threed.Vector3D;
23  import org.orekit.propagation.FieldSpacecraftState;
24  import org.orekit.propagation.SpacecraftState;
25  import org.orekit.propagation.events.EventDetector;
26  import org.orekit.propagation.events.FieldEventDetector;
27  import org.orekit.time.AbsoluteDate;
28  import org.orekit.time.FieldAbsoluteDate;
29  import org.orekit.utils.ParameterDriver;
30  
31  import java.util.List;
32  import java.util.stream.Stream;
33  
34  /**
35   * Interface to wrap another force model.
36   * By default, methods do not modify anything.
37   *
38   * @since 13.0
39   * @author Romain Serra
40   *
41   */
42  public interface ForceModelModifier extends ForceModel {
43  
44      /**
45       * Get the underlying force model.
46       * @return underlying model
47       */
48      ForceModel getUnderlyingModel();
49  
50      /** {@inheritDoc} */
51      @Override
52      default void init(SpacecraftState initialState, AbsoluteDate target) {
53          getUnderlyingModel().init(initialState, target);
54      }
55  
56      /** {@inheritDoc} */
57      @Override
58      default <T extends CalculusFieldElement<T>> void init(FieldSpacecraftState<T> initialState, FieldAbsoluteDate<T> target) {
59          getUnderlyingModel().init(initialState, target);
60      }
61  
62      /** {@inheritDoc} */
63      @Override
64      default Vector3D acceleration(SpacecraftState s, double[] parameters) {
65          return getUnderlyingModel().acceleration(s, parameters);
66      }
67  
68      /** {@inheritDoc} */
69      @Override
70      default <T extends CalculusFieldElement<T>> FieldVector3D<T> acceleration(FieldSpacecraftState<T> s,
71                                                                                T[] parameters) {
72          return getUnderlyingModel().acceleration(s, parameters);
73      }
74  
75      /** {@inheritDoc} */
76      @Override
77      default boolean dependsOnPositionOnly() {
78          return getUnderlyingModel().dependsOnPositionOnly();
79      }
80  
81      /** {@inheritDoc} */
82      @Override
83      default boolean dependsOnAttitudeRate() {
84          return getUnderlyingModel().dependsOnAttitudeRate();
85      }
86  
87      /** {@inheritDoc} */
88      @Override
89      default Stream<EventDetector> getEventDetectors() {
90          return getUnderlyingModel().getEventDetectors();
91      }
92  
93      /** {@inheritDoc} */
94      @Override
95      default <T extends CalculusFieldElement<T>> Stream<FieldEventDetector<T>> getFieldEventDetectors(Field<T> field) {
96          return getUnderlyingModel().getFieldEventDetectors(field);
97      }
98  
99      /** {@inheritDoc} */
100     @Override
101     default List<ParameterDriver> getParametersDrivers() {
102         return getUnderlyingModel().getParametersDrivers();
103     }
104 }