1   /* Copyright 2022-2026 Luc Maisonobe
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  
18  package org.orekit.utils;
19  
20  import org.hipparchus.CalculusFieldElement;
21  import org.hipparchus.geometry.euclidean.threed.FieldVector3D;
22  import org.hipparchus.geometry.euclidean.threed.Vector3D;
23  import org.orekit.frames.Frame;
24  import org.orekit.time.AbsoluteDate;
25  import org.orekit.time.FieldAbsoluteDate;
26  
27  /** Adapter from {@link Frame} to {@link ExtendedPositionProvider}.
28   * <p>
29   * The moving point is the origin of the adapted frame.
30   * </p>
31   * <p>
32   * This class is roughly the inverse of {@link ExtendedPositionProviderAdapter}
33   * </p>
34   * @see ExtendedPositionProviderAdapter
35   * @since 12.0
36   * @author Luc Maisonobe
37   */
38  public class FrameAdapter implements ExtendedPositionProvider {
39  
40      /** Frame whose origin coordinates are desired. */
41      private final Frame originFrame;
42  
43      /** Simple constructor.
44       * @param originFrame frame whose origin coordinates are desired
45       */
46      public FrameAdapter(final Frame originFrame) {
47          this.originFrame = originFrame;
48      }
49  
50      /** {@inheritDoc} */
51      @Override
52      public Vector3D getPosition(final AbsoluteDate date, final Frame frame) {
53          return originFrame.getStaticTransformTo(frame, date).transformPosition(Vector3D.ZERO);
54      }
55  
56      /** {@inheritDoc} */
57      @Override
58      public <T extends CalculusFieldElement<T>> FieldVector3D<T> getPosition(final FieldAbsoluteDate<T> date,
59                                                                              final Frame frame) {
60          return originFrame.getStaticTransformTo(frame, date).transformPosition(Vector3D.ZERO);
61      }
62  
63      /** {@inheritDoc} */
64      @Override
65      public Vector3D getVelocity(final AbsoluteDate date, final Frame frame) {
66          return originFrame.getKinematicTransformTo(frame, date).transformOnlyPV(PVCoordinates.ZERO).getVelocity();
67      }
68  
69      /** {@inheritDoc} */
70      @Override
71      public <T extends CalculusFieldElement<T>> FieldVector3D<T> getVelocity(final FieldAbsoluteDate<T> date, final Frame frame) {
72          return originFrame.getKinematicTransformTo(frame, date).transformOnlyPV(FieldPVCoordinates.getZero(date.getField())).getVelocity();
73      }
74  
75      /** {@inheritDoc} */
76      @Override
77      public TimeStampedPVCoordinates getPVCoordinates(final AbsoluteDate date, final Frame frame) {
78          return new TimeStampedPVCoordinates(date,
79                  originFrame.getTransformTo(frame, date).transformPVCoordinates(PVCoordinates.ZERO));
80      }
81  
82      /** {@inheritDoc} */
83      @Override
84      public <T extends CalculusFieldElement<T>> TimeStampedFieldPVCoordinates<T> getPVCoordinates(final FieldAbsoluteDate<T> date,
85                                                                                                   final Frame frame) {
86          return new TimeStampedFieldPVCoordinates<>(date,
87                  originFrame.getTransformTo(frame, date).transformPVCoordinates(PVCoordinates.ZERO));
88      }
89  }