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.control.indirect.adjoint;
18  
19  import org.hipparchus.analysis.differentiation.Gradient;
20  import org.hipparchus.analysis.differentiation.GradientField;
21  import org.hipparchus.geometry.euclidean.threed.FieldVector3D;
22  import org.hipparchus.util.Binary64;
23  import org.hipparchus.util.Binary64Field;
24  import org.hipparchus.util.MathArrays;
25  import org.junit.jupiter.api.Assertions;
26  import org.junit.jupiter.api.Test;
27  import org.mockito.Mockito;
28  import org.orekit.forces.gravity.NewtonianAttraction;
29  import org.orekit.frames.Frame;
30  import org.orekit.frames.FramesFactory;
31  import org.orekit.propagation.FieldSpacecraftState;
32  import org.orekit.time.AbsoluteDate;
33  import org.orekit.time.FieldAbsoluteDate;
34  import org.orekit.utils.Constants;
35  
36  class CartesianAdjointKeplerianTermTest {
37  
38      @Test
39      @SuppressWarnings("unchecked")
40      void testGetPositionAdjointContribution() {
41          // GIVEN
42          final CartesianAdjointKeplerianTerm keplerianTerm = new CartesianAdjointKeplerianTerm(Constants.EGM96_EARTH_MU);
43          final double[] adjoint = new double[6];
44          final double[] state = new double[6];
45          for (int i = 0; i < adjoint.length; i++) {
46              state[i] = -i+1;
47              adjoint[i] = i;
48          }
49          // WHEN
50          final double[] contribution = keplerianTerm.getPositionAdjointContribution(Mockito.mock(AbsoluteDate.class),
51                  state, adjoint, FramesFactory.getGCRF());
52          // THEN
53          final NewtonianAttraction newtonianAttraction = new NewtonianAttraction(keplerianTerm.getMu());
54          final int dimension = 3;
55          final GradientField field = GradientField.getField(dimension);
56          final FieldSpacecraftState<Gradient> mockedState = Mockito.mock(FieldSpacecraftState.class);
57          final FieldVector3D<Gradient> fieldPosition = new FieldVector3D<>(
58                  Gradient.variable(dimension, 0, state[0]),
59                  Gradient.variable(dimension, 1, state[1]),
60                  Gradient.variable(dimension, 2, state[2]));
61          Mockito.when(mockedState.getPosition()).thenReturn(fieldPosition);
62          final Gradient[] fieldMu = MathArrays.buildArray(field, 1);
63          fieldMu[0] = Gradient.constant(dimension, keplerianTerm.getMu());
64          final FieldVector3D<Gradient> acceleration = newtonianAttraction.acceleration(mockedState, fieldMu);
65          Assertions.assertEquals(-contribution[0], acceleration.getX().getGradient()[0] * adjoint[3]
66                  + acceleration.getY().getGradient()[0] * adjoint[4] + acceleration.getZ().getGradient()[0] * adjoint[5]);
67          Assertions.assertEquals(-contribution[1], acceleration.getX().getGradient()[1] * adjoint[3]
68                  + acceleration.getY().getGradient()[1] * adjoint[4] + acceleration.getZ().getGradient()[1] * adjoint[5]);
69          Assertions.assertEquals(-contribution[2], acceleration.getX().getGradient()[2] * adjoint[3]
70                  + acceleration.getY().getGradient()[2] * adjoint[4] + acceleration.getZ().getGradient()[2] * adjoint[5]);
71      }
72  
73      @Test
74      void testGetPositionAdjointFieldContribution() {
75          // GIVEN
76          final CartesianAdjointKeplerianTerm keplerianTerm = new CartesianAdjointKeplerianTerm(Constants.EGM96_EARTH_MU);
77          final Binary64Field field = Binary64Field.getInstance();
78          final Binary64[] fieldAdjoint = MathArrays.buildArray(field, 6);
79          final Binary64[] fieldState = MathArrays.buildArray(field, 6);
80          for (int i = 0; i < fieldAdjoint.length; i++) {
81              fieldState[i] = field.getZero().newInstance(-i+1);
82              fieldAdjoint[i] = field.getZero().newInstance(i);
83          }
84          final Frame frame = FramesFactory.getGCRF();
85          final FieldAbsoluteDate<Binary64> fieldDate = FieldAbsoluteDate.getArbitraryEpoch(field);
86          // WHEN
87          final Binary64[] fieldContribution = keplerianTerm.getPositionAdjointFieldContribution(fieldDate, fieldState,
88                  fieldAdjoint, frame);
89          // THEN
90          final double[] state = new double[fieldState.length];
91          for (int i = 0; i < fieldState.length; i++) {
92              state[i] = fieldState[i].getReal();
93          }
94          final double[] adjoint = new double[fieldAdjoint.length];
95          for (int i = 0; i < fieldAdjoint.length; i++) {
96              adjoint[i] = fieldAdjoint[i].getReal();
97          }
98          final double[] contribution = keplerianTerm.getPositionAdjointContribution(fieldDate.toAbsoluteDate(), state,
99                  adjoint, frame);
100         for (int i = 0; i < contribution.length; i++) {
101             Assertions.assertEquals(fieldContribution[i].getReal(), contribution[i]);
102         }
103     }
104 }