Index of Functions: A B C D E F G H I J K L M N O P Q R S T U V W X
Index Page pckcls_c
Table of contents
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
       pckcls_c ( PCK, close file )

       void pckcls_c ( SpiceInt handle )
#### Abstract
       Close an open PCK file.
#### Required_Reading
       PCK
#### Keywords
       PCK
#### Brief_I/O
       VARIABLE  I/O  DESCRIPTION
       --------  ---  --------------------------------------------------
       handle     I   Handle of the PCK file to be closed.
#### Detailed_Input
       handle      is the handle of the PCK file that is to be closed.
#### Detailed_Output
       None.
#### Parameters
       None.
#### Exceptions
       1)  If there are no segments in the file, the error
           SPICE(NOSEGMENTSFOUND) is signaled by a routine in the call
           tree of this routine.
#### Files
       See argument `handle'.
#### Particulars
       None.
#### Examples
       The numerical results shown for this example may differ across
       platforms. The results depend on the SPICE kernels used as
       input, the compiler and supporting libraries, and the machine
       specific arithmetic implementation.

       1) Suppose that you have sets of Chebyshev polynomial
          coefficients in an array pertaining to the orientation of
          the Moon body-fixed frame with the frame class ID 301
          relative to the J2000 reference frame, and want
          to put these into a type 2 segment PCK file. The following
          example could be used to add one new type 2 segment. To add
          multiple segments, put the call to pckw02_c in a loop.

          Example code begins here.

          /.
             Program pckcls_ex1
          ./
          #include "SpiceUsr.h"

          int main( )
          {

             /.
             Local parameters
             ./
             #define FNAME        "pckcls_ex1.bpc"
             #define BODY         301
             #define POLYDG       9
             #define SZCDAT       60

             /.
             Local variables
             ./
             SpiceChar          * ifname;
             SpiceChar          * segid;

             SpiceDouble          btime;
             SpiceDouble          first;
             SpiceDouble          intlen;
             SpiceDouble          last;

             SpiceInt             handle;
             SpiceInt             n;
             SpiceInt             nresvc;

             /.
             Set the input data: RA/DEC/W coefficients,
             begin time for the first record, start/end times
             for the segment, length of the time covered by
             each record, and number of logical records.

             `cdata' contains the ra/dec/w coefficients: first the
             the polydeg + 1 for the RA first record, then the
             polydeg + 1 for the DEC first record, then the
             polydeg +1 for W first record, then the polydeg + 1
             for the RA second record, and so on.
             ./
             SpiceDouble          cdata  [SZCDAT] = {
                           -5.4242086033301107e-002, -5.2241405162792561e-005,
                            8.9751456289930307e-005, -1.5288696963234620e-005,
                            1.3218870864581395e-006,  5.9822156790328180e-007,
                           -6.5967702052551211e-008, -9.9084309118396298e-009,
                            4.9276055963541578e-010,  1.1612267413829385e-010,
                            0.42498898565916610,      1.3999219324235620e-004,
                           -1.8855140511098865e-005, -2.1964684808526649e-006,
                            1.4229817868138752e-006, -1.6991716166847001e-007,
                           -3.4824688140649506e-008,  2.9208428745895990e-009,
                            4.4217757657060300e-010, -3.9211207055305402e-012,
                            2565.0633504619473,       0.92003769451305328,
                           -8.0503797901914501e-005,  1.1960860244433900e-005,
                           -1.2237900518372542e-006, -5.3651349407824562e-007,
                            6.0843372260403005e-008,  9.0211287487688797e-009,
                           -4.6460429330339309e-010, -1.0446918704281774e-010,
                           -5.3839796353225056e-002,  4.3378021974424991e-004,
                            4.8130091384819459e-005, -1.2283066272873327e-005,
                           -5.4099296265403208e-006, -4.4237368347319652e-007,
                            1.3004982445546169e-007,  1.9017128275284284e-008,
                           -7.0368223839477803e-011, -1.7119414526133175e-010,
                            0.42507987850614548,     -7.1844899448557937e-005,
                           -5.1052122872412865e-005, -8.9810401387721321e-006,
                           -1.4611718567948972e-007,  4.0883847771062547e-007,
                            4.6812854485029333e-008, -4.5698075960784951e-009,
                           -9.8679875320349531e-010, -7.9392503778178240e-011,
                            2566.9029069934054,       0.91952244801740568,
                           -6.0426151041179828e-005,  1.0850559330577959e-005,
                            5.1756033678137497e-006,  4.2127585555214782e-007,
                           -1.1774737441872970e-007, -1.7397191490163833e-008,
                            5.8908810244396165e-012,  1.4594279337955166e-010 };

             first  =   -43200.0;
             last   =  1339200.0;
             btime  =  first;
             intlen =   691200.0;
             n      =  2;

             /.
             Open a new PCK file.  For simplicity, we will not
             reserve any space for the comment area, so the
             number of reserved comment characters is zero.
             The variable `ifname' is the internal file name.
             ./
             nresvc  =  0;
             ifname  =  "Test PCK/Created 04-SEP-2019";

             pckopn_c ( FNAME, ifname, nresvc, &handle );

             /.
             Create a segment identifier.
             ./
             segid = "MY_SAMPLE_PCK_TYPE_2_SEGMENT";

             /.
             Write the segment.
             ./
             pckw02_c ( handle, BODY, "J2000", first, last, segid,
                        intlen, n,    POLYDG,  cdata, btime       );

             /.
             Close the file.
             ./
             pckcls_c ( handle );

             return ( 0 );
          }

          When this program is executed, no output is presented on
          screen. After run completion, a new PCK type 2 exists in
          the output directory.
#### Restrictions
       None.
#### Literature_References
       None.
#### Author_and_Institution
       N.J. Bachman        (JPL)
       J. Diaz del Rio     (ODC Space)
       K.R. Gehringer      (JPL)
#### Version
       -CSPICE Version 1.0.1, 04-AUG-2021 (JDR)

           Edited the header to comply with NAIF standard. Added
           complete code examples based on existing fragment.

       -CSPICE Version 1.0.0, 16-DEC-2016 (NJB) (KRG)
#### Index_Entries
       close a PCK file
#### Link to routine pckcls_c source file pckcls_c.c

    Fri Dec 31 18:41:10 2021