CIRFProvider.java

  1. /* Copyright 2002-2019 CS Systèmes d'Information
  2.  * Licensed to CS Systèmes d'Information (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.frames;

  19. import java.io.Serializable;

  21. import org.hipparchus.RealFieldElement;
  22. import org.hipparchus.geometry.euclidean.threed.FieldRotation;
  23. import org.hipparchus.geometry.euclidean.threed.FieldVector3D;
  24. import org.hipparchus.geometry.euclidean.threed.Rotation;
  25. import org.hipparchus.geometry.euclidean.threed.Vector3D;
  26. import org.hipparchus.util.FastMath;
  27. import org.orekit.errors.OrekitException;
  28. import org.orekit.errors.OrekitInternalError;
  29. import org.orekit.time.AbsoluteDate;
  30. import org.orekit.time.FieldAbsoluteDate;
  31. import org.orekit.time.TimeVectorFunction;

  33. /** Celestial Intermediate Reference Frame.
  34.  * <p>This provider includes precession effects according to either the IAU 2006 precession
  35.  * (also known as Nicole Capitaines's P03 precession theory) and IAU 2000A_R06 nutation
  36.  * for IERS 2010 conventions or the IAU 2000A precession-nutation model for IERS 2003
  37.  * conventions. These models replaced the older IAU-76 precession (Lieske) and IAU-80
  38.  * theory of nutation (Wahr) which were used in the classical equinox-based paradigm.
  39.  * It <strong>must</strong> be used with the Earth Rotation Angle (REA) defined by
  40.  * Capitaine's model and <strong>not</strong> IAU-82 sidereal
  41.  * time which is consistent with the older models only.</p>
  42.  * <p>Its parent frame is the GCRF frame.
  43.  */
  44. class CIRFProvider implements EOPBasedTransformProvider {

  46.     /** Serializable UID. */
  47.     private static final long serialVersionUID = 20130806L;

  49.     /** Function computing CIP/CIO components. */
  50.     private final transient TimeVectorFunction xysPxy2Function;

  52.     /** EOP history. */
  53.     private final EOPHistory eopHistory;

  55.     /** Simple constructor.
  56.      * @param eopHistory EOP history
  57.      * @see Frame
  58.      */
  59.     CIRFProvider(final EOPHistory eopHistory) {

  61.         // load the nutation model
  62.         xysPxy2Function = eopHistory.getConventions().getXYSpXY2Function();

  64.         // store correction to the model
  65.         this.eopHistory = eopHistory;

  67.     }

  69.     /** {@inheritDoc} */
  70.     @Override
  71.     public EOPHistory getEOPHistory() {
  72.         return eopHistory;
  73.     }

  75.     /** {@inheritDoc} */
  76.     @Override
  77.     public CIRFProvider getNonInterpolatingProvider() {
  78.         return new CIRFProvider(eopHistory.getNonInterpolatingEOPHistory());
  79.     }

  81.     /** {@inheritDoc} */
  82.     @Override
  83.     public Transform getTransform(final AbsoluteDate date) {

  85.         final double[] xys  = xysPxy2Function.value(date);
  86.         final double[] dxdy = eopHistory.getNonRotatinOriginNutationCorrection(date);

  88.         // position of the Celestial Intermediate Pole (CIP)
  89.         final double xCurrent = xys[0] + dxdy[0];
  90.         final double yCurrent = xys[1] + dxdy[1];

  92.         // position of the Celestial Intermediate Origin (CIO)
  93.         final double sCurrent = xys[2] - xCurrent * yCurrent / 2;

  95.         // set up the bias, precession and nutation rotation
  96.         final double x2Py2  = xCurrent * xCurrent + yCurrent * yCurrent;
  97.         final double zP1    = 1 + FastMath.sqrt(1 - x2Py2);
  98.         final double r      = FastMath.sqrt(x2Py2);
  99.         final double sPe2   = 0.5 * (sCurrent + FastMath.atan2(yCurrent, xCurrent));
  100.         final double cos    = FastMath.cos(sPe2);
  101.         final double sin    = FastMath.sin(sPe2);
  102.         final double xPr    = xCurrent + r;
  103.         final double xPrCos = xPr * cos;
  104.         final double xPrSin = xPr * sin;
  105.         final double yCos   = yCurrent * cos;
  106.         final double ySin   = yCurrent * sin;
  107.         final Rotation bpn  = new Rotation(zP1 * (xPrCos + ySin), -r * (yCos + xPrSin),
  108.                                            r * (xPrCos - ySin), zP1 * (yCos - xPrSin),
  109.                                            true);

  111.         return new Transform(date, bpn, Vector3D.ZERO);

  113.     }

  115.     /** {@inheritDoc} */
  116.     @Override
  117.     public <T extends RealFieldElement<T>> FieldTransform<T> getTransform(final FieldAbsoluteDate<T> date) {

  119.         final T[] xys  = xysPxy2Function.value(date);
  120.         final T[] dxdy = eopHistory.getNonRotatinOriginNutationCorrection(date);

  122.         // position of the Celestial Intermediate Pole (CIP)
  123.         final T xCurrent = xys[0].add(dxdy[0]);
  124.         final T yCurrent = xys[1].add(dxdy[1]);

  126.         // position of the Celestial Intermediate Origin (CIO)
  127.         final T sCurrent = xys[2].subtract(xCurrent.multiply(yCurrent).multiply(0.5));

  129.         // set up the bias, precession and nutation rotation
  130.         final T x2Py2  = xCurrent.multiply(xCurrent).add(yCurrent.multiply(yCurrent));
  131.         final T zP1    = x2Py2.subtract(1).negate().sqrt().add(1);
  132.         final T r      = x2Py2.sqrt();
  133.         final T sPe2   = sCurrent.add(yCurrent.atan2(xCurrent)).multiply(0.5);
  134.         final T cos    = sPe2.cos();
  135.         final T sin    = sPe2.sin();
  136.         final T xPr    = xCurrent.add(r);
  137.         final T xPrCos = xPr.multiply(cos);
  138.         final T xPrSin = xPr.multiply(sin);
  139.         final T yCos   = yCurrent.multiply(cos);
  140.         final T ySin   = yCurrent.multiply(sin);
  141.         final FieldRotation<T> bpn  = new FieldRotation<>(zP1.multiply(xPrCos.add(ySin)),
  142.                                                           r.multiply(yCos.add(xPrSin)).negate(),
  143.                                                           r.multiply(xPrCos.subtract(ySin)),
  144.                                                           zP1.multiply(yCos.subtract(xPrSin)),
  145.                                                           true);

  147.         return new FieldTransform<>(date, bpn, FieldVector3D.getZero(date.getField()));

  149.     }

  151.     /** Replace the instance with a data transfer object for serialization.
  152.      * <p>
  153.      * This intermediate class serializes only the frame key.
  154.      * </p>
  155.      * @return data transfer object that will be serialized
  156.      */
  157.     private Object writeReplace() {
  158.         return new DataTransferObject(eopHistory);
  159.     }

  161.     /** Internal class used only for serialization. */
  162.     private static class DataTransferObject implements Serializable {

  164.         /** Serializable UID. */
  165.         private static final long serialVersionUID = 20131209L;

  167.         /** EOP history. */
  168.         private final EOPHistory eopHistory;

  170.         /** Simple constructor.
  171.          * @param eopHistory EOP history
  172.          */
  173.         DataTransferObject(final EOPHistory eopHistory) {
  174.             this.eopHistory = eopHistory;
  175.         }

  177.         /** Replace the deserialized data transfer object with a {@link CIRFProvider}.
  178.          * @return replacement {@link CIRFProvider}
  179.          */
  180.         private Object readResolve() {
  181.             try {
  182.                 // retrieve a managed frame
  183.                 return new CIRFProvider(eopHistory);
  184.             } catch (OrekitException oe) {
  185.                 throw new OrekitInternalError(oe);
  186.             }
  187.         }

  189.     }

  191. }
Created with JaCoCo 0.8.2.201808211720