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

Procedure
Abstract
Required_Reading
Keywords
Brief_I/O
Detailed_Input
Detailed_Output
Parameters
Exceptions
Files
Particulars
Examples
Restrictions
Literature_References
Author_and_Institution
Version
Index_Entries

Procedure

   void spkw05_c ( SpiceInt                handle,
                   SpiceInt                body,
                   SpiceInt                center,
                   ConstSpiceChar        * frame,
                   SpiceDouble             first,
                   SpiceDouble             last,
                   ConstSpiceChar        * segid,
                   SpiceDouble             gm,
                   SpiceInt                n,
                   ConstSpiceDouble        states [][6],
                   ConstSpiceDouble        epochs []      )

Abstract

 
   Write an SPK segment of type 5 given a time-ordered set of 
   discrete states and epochs, and the gravitational parameter 
   of a central body. 
 

Required_Reading

 
   SPK 
   SPC 
   NAIF_IDS 
 

Keywords

 
   EPHEMERIS 
 

Brief_I/O

 
   Variable  I/O  Description 
   --------  ---  -------------------------------------------------- 
   handle     I   Handle of an SPK file open for writing. 
   body       I   Body code for ephemeris object. 
   center     I   Body code for the center of motion of the body. 
   frame      I   The reference frame of the states. 
   first      I   First valid time for which states can be computed. 
   last       I   Last valid time for which states can be computed. 
   segid      I   Segment identifier. 
   gm         I   Gravitational parameter of central body. 
   n          I   Number of states and epochs. 
   states     I   States. 
   epochs     I   Epochs. 
 

Detailed_Input

 
   handle      is the file handle of an SPK file that has been 
               opened for writing. 
 
   body        is the NAIF ID for the body whose states are 
               to be recorded in an SPK file. 
 
   center      is the NAIF ID for the center of motion associated 
               with BODY. 
 
   frame       is the reference frame that states are referenced to, 
               for example "J2000". 
 
   first       are the bounds on the ephemeris times, expressed as 
   last        seconds past J2000, for which the states can be used 
               to interpolate a state for BODY. 
 
   segid       is the segment identifier. An SPK segment identifier 
               may contain up to 40 characters. 
 
   gm          is the gravitational parameter of the central body 
               ( in units of kilometers **3 / seconds **2 ). 
 
   n           is the number of states and epochs to be stored 
               in the segment. 
 
   states      contains a time-ordered array of geometric states 
               ( x, y, z, dx/dt, dy/dt, dz/dt, in kilometers and 
               kilometers per second ) of the target body with 
               respect to the central body specified in the segment 
               descriptor. 
 
   epochs      contains the epochs (ephemeris seconds past J2000) 
               corresponding to the states in states.  Epochs must 
               form a strictly increasing sequence. 
 

Detailed_Output

 
   None.  A type 5 segment is written to the file attached to handle. 
 

Parameters

 
   None. 
 

Exceptions

 
   1) If the input epochs do not form an increasing sequence, the 
      error SPICE(UNORDEREDTIMES) will be signaled. 
 
   2) If the number of states and epochs is not positive then the 
      error SPICE(NUMSTATESNOTPOS) will be signaled. 
 
   3) If FIRST is greater than LAST then the error 
      SPICE(BADDESCRTIMES) will be signaled. 
 
   4) If SEGID is more than 40 characters long, the error 
      SPICE(SEGIDTOOLONG) is signaled. 
 
   5) If SEGID contains any nonprintable characters, the error 
      SPICE(NONPRINTABLECHARS) is signaled. 
 
   6) Any file I/O problems will be detected and diagnosed by one 
      of the DAF routines called by this routine. 
 
   7) The error SPICE(EMPTYSTRING) is signaled if either input
      string does not contain at least one character, since the
      input strings cannot be converted to a Fortran-style string
      in this case.
      
   8) The error SPICE(NULLPOINTER) is signaled if either input string
      pointer is null.

Files

 
   A new type 05 SPK segment is written to the SPK file attached 
   to handle. 
 

Particulars

 
   This routine writes an SPK type 05 data segment to the open SPK 
   file according to the format described in the type 05 section of 
   the SPK Required Reading. The SPK file must have been opened with 
   write access. 
 

Examples

 
   Suppose that you have states and are prepared to produce 
   a segment of type 05 in an SPK file. 
 
   The following code fragment could be used to add the new segment 
   to a previously opened SPK file attached to handle. The file must 
   have been opened with write access. 
 
      #include "SpiceUsr.h"
             .
             .
             .
      /.
      Create a segment identifier. 
      ./
      ConstSpiceChar  * segid = "MY_SAMPLE_SPK_TYPE_5_SEGMENT";
 
      /.
      Write the segment. 
      ./
      spkw05_c ( SpiceInt                handle,
                 SpiceInt                body,
                 SpiceInt                center,
                 ConstSpiceChar        * frame,
                 SpiceDouble             first,
                 SpiceDouble             last,
                 ConstSpiceChar        * segid,
                 SpiceDouble             gm,
                 SpiceInt                n,
                 SpiceDouble             states,
                 SpiceDouble             epochs  );
 

Restrictions

 
   None. 
 

Literature_References

 
   None. 
 

Author_and_Institution

 
   N.J. Bachman    (JPL)
   K.R. Gehringer  (JPL) 
   J.M. Lynch      (JPL) 
   W.L. Taber      (JPL) 
   I.M. Underwood  (JPL) 
 

Version

 
   -CSPICE Version 1.0.0, 23-JUN-1999 (NJB)(KRG)(JML)(WLT)(IMU)

Index_Entries

 
   write spk type_5 ephemeris data segment 
 
Wed Apr  5 17:54:44 2017