Index Page
cspice_pdpool
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_PDPOOL inserts double precision data into the kernel pool.

I/O


   Given:

      name    name of the kernel pool variable to associate with the values
              supplied in the array 'dvals'. 'name' is restricted to a length
              of 32 characters or less.

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

      dvals   values to load into the kernel pool sub-system with the assigned
              variable name 'name'.

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

   the call:

       cspice_pdpool( name, dvals)

   returns:

      Inserts the variable 'name' into the kernel pool with values as
      defined in 'dvals'.

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.

      %
      % Define the parameters for the double array.
      %
      PDPOOL_DIM  = 9;
      PDPOOL_VAR  = 'pdpool_array';
      START       = 1;

      %
      % Populate the 'pdpool_arr' array with PDPOOL_DIM values.
      %
      pdpool_arr = [0:PDPOOL_DIM-1]';

      %
      % Insert the array data into the kernel pool
      % with variable name 'pipool_array'.
      %
      cspice_pdpool( PDPOOL_VAR, pdpool_arr)

      %
      % Retrieve the variable's associated values in
      % array 'dvals'.
      %
      dvals = cspice_gdpool( PDPOOL_VAR, START, PDPOOL_DIM );

      %
      % Check we found the expected variable, and ensure
      % the expected values.
      %
      if ( ~isempty(dvals) )

         txt = sprintf( 'Found array variable %s with entries:', PDPOOL_VAR );
         disp(txt)

         n_elements = size( dvals );

         txt = sprintf( '   %f\n', dvals );
         disp(txt)

      else

         txt = sprintf( 'Failed to find %s in the kernel pool',  PDPOOL_VAR  );
         disp(txt)

      end

      %
      % Clear the kernel pool.
      %
      cspice_clpool

   MATLAB outputs:

      Found array variable pdpool_array with entries:
         0.000000
         1.000000
         2.000000
         3.000000
         4.000000
         5.000000
         6.000000
         7.000000
         8.000000

Particulars


   None.

Required Reading


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

   MICE.REQ
   KERNEL.REQ

Version


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

      Edited I/O section to conform to NAIF standard for Mice documentation.

      Added mention of the length restriction on the kernel pool variable
      name 'name'.

   -Mice Version 1.1.0, 23-FEB-2009, EDW (JPL)

      Added zzmice_str call on input 'name' to convert string cells to
      character arrays if 'name' has type string cells. Added proper
      markers for usage string variable types.

   -Mice Version 1.0.0, 24-JAN-2006, EDW (JPL)

Index_Entries


   Set the value of a d.p. kernel pool variable


Wed Apr  5 18:00:33 2017