1 /* Copyright 2002-2024 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 18 package org.orekit.utils; 19 20 import org.hipparchus.geometry.euclidean.threed.Vector3D; 21 import org.orekit.frames.Frame; 22 import org.orekit.time.AbsoluteDate; 23 24 /** 25 * Interface for PV coordinates providers. 26 * @author Veronique Pommier 27 * <p>The PV coordinates provider interface can be used by any class used for position/velocity 28 * computation, for example celestial bodies or spacecraft position/velocity propagators, 29 * and many others... 30 * </p> 31 */ 32 public interface PVCoordinatesProvider { 33 34 /** Get the position of the body in the selected frame. 35 * @param date current date 36 * @param frame the frame where to define the position 37 * @return position of the body (m and) 38 * @since 12.0 39 */ 40 default Vector3D getPosition(final AbsoluteDate date, final Frame frame) { 41 return getPVCoordinates(date, frame).getPosition(); 42 } 43 44 /** Get the {@link PVCoordinates} of the body in the selected frame. 45 * @param date current date 46 * @param frame the frame where to define the position 47 * @return time-stamped position/velocity of the body (m and m/s) 48 */ 49 TimeStampedPVCoordinates getPVCoordinates(AbsoluteDate date, Frame frame); 50 51 }