Index Page
cspice_unitim
A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X 

Abstract
I/O
Examples
Particulars
Required Reading
Version
Index_Entries

Abstract


   CSPICE_UNITIM returns the double precision value of an input epoch converted
   from one uniform time scale to another.

I/O


   Given:

      epoch    epoch(s) relative to the 'insys' time scale.

               [1,n] = size(epoch); double = class(epoch)

      insys    naming the uniform time scale of 'epoch'. Acceptable values:

               [1,m] = size(insys); char = class(insys)

                  'TAI'     International Atomic Time.

                  'TDB'     Barycentric Dynamical Time.

                  'TDT'     Terrestrial Dynamical Time.

                  'ET'      Ephemeris time (in the SPICE system, this is
                            equivalent to TDB).

                  'JDTDB'   Julian Date relative to TDB.

                  'JDTDT'   Julian Date relative to TDT.

                  'JED'     Julian Ephemeris Date (in the SPICE system
                            this is equivalent to JDTDB).

               The routine is not sensitive to the case of insys;
               'tai' 'Tai' and 'TAI' are all equivalent from the point of
               view of this routine.

      outsys   naming the uniform time scale to which 'epoch' should be
               converted. Acceptable values are the same as for 'insys'.

               [1,m] = size(outsys); char = class(outsys)

               The routine is not sensitive to the case of 'outsys'.

   the call:

      [unitim] = cspice_unitim( epoch, insys, outsys )

   returns:

      unitim   time(s) in the system specified by 'outsys' equivalent to the
               'epoch' in the 'insys' time scale.

               [1,n] = size(unitim); double = class(unitim)

               'unitimt' returns with the same vectorization measure (N)
               as 'epoch'.

Examples


   Any numerical results shown for this example may differ between
   platforms as the results depend on the SPICE kernels used as input
   and the machine specific arithmetic implementation.

      Use the meta-kernel shown below to load the required SPICE
      kernels.

         KPL/MK

         This meta-kernel is intended to support operation of SPICE
         example programs. The kernels shown here should not be
         assumed to contain adequate or correct versions of data
         required by SPICE-based user applications.

         In order for an application to use this meta-kernel, the
         kernels referenced here must be present in the user's
         current working directory.

         The names and contents of the kernels referenced
         by this meta-kernel are as follows:

            File name                     Contents
            ---------                     --------
            de421.bsp                     Planetary ephemeris
            pck00009.tpc                  Planet orientation and
                                          radii
            naif0009.tls                  Leapseconds


         \begindata

            KERNELS_TO_LOAD = ( '/kernels/gen/lsk/naif0009.tls'
                                '/kernels/gen/spk/de421.bsp'
                                '/kernels/gen/pck/pck00009.tpc'
                      )

         \begintext


      %
      % Load a leapseconds kernel, use a meta kernel for convenience.
      %
      cspice_furnsh( 'standard.tm' )

      et = cspice_str2et( 'Dec 19 2003' );

      converted_et = cspice_unitim(et, 'ET','JED')

      %
      % It's always good form to unload kernels after use,
      % particularly in Matlab due to data persistence.
      %
      cspice_kclear

   MATLAB outputs:

      converted_et =

           2.452992500742865e+06

Particulars


   None.

Required Reading


   For important details concerning this module's function, please refer to
   the CSPICE routine unitim_c.

   MICE.REQ
   TIME.REQ

Version


   -Mice Version 1.0.0, 12-MAR-2012, EDW (JPL), SCK (JPL)

Index_Entries


   Transform between two uniform numeric time systems
   Transform between two additive numeric time systems
   Convert one uniform numeric time system to another
   Convert one additive numeric time system to another


Wed Apr  5 18:00:36 2017