Index Page
cspice_ssize
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_SSIZE sets the size (maximum cardinality) 
   of an Icy cell of any data type.

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

I/O

   
   Given:

      size   the scalar integer size (maximum number of elements) to 
             assign to 'cell'. 

             'size' must be non-negative and must be no larger than 
             the initial declared size of the cell.

      cell    an Icy cell of any data type. 'cell' must be declared 
              as a double precision, or integer.

   the call:

      cspice_ssize, size, cell
   
   returns:

      cell   on output, the cell with its size updated to
             the value given by the input argument 'size'.

             The cardinality of the cell is set to 0.  

             The cell becomes an Icy set:  the cell's "is a set?" 
             attribute becomes true. This routine does not clear 
             the unused portion of the cell's control area.

             The user must create 'cell' using either cspice_celld 
             or cspice_celli.

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.

      ;;
      ;; Set a size for the cell.
      ;;
      SIZE = 10

      ;;
      ;; Create an double precision cell of SIZE
      ;;
      cell = cspice_celld( SIZE )
      
      ;;
      ;; Output the cardinality and size of a new cell.
      ;;
      print, "Size of cell, initial       : ", cspice_size( cell )
      print, "Cardinality of cell, initial: ", cspice_card( cell )

      ;;
      ;; Define an array of intervals.
      ;;
      array = [ [ 1.d, 3.0], [ 7.0, 11.0], [23.0, 27.0] ]

      ;;
      ;; Insert data into the cell, creating a window.
      ;;
      for i=0,2 do begin
         cspice_wninsd, array[0,i], array[1,i], cell
      endfor

      print, "Cardinality of cell, filled : ", cspice_card( cell )

     ;;
     ;; Reset the size to SIZE - 2 to free.
     ;;
     cspice_ssize, size-2, cell

     print, "Size of cell, reset         : ", cspice_size( cell )
     print, "Cardinality of cell, reset  : ", cspice_card( cell )

  IDL outputs:
  
     Size of cell, initial       :           10
     Cardinality of cell, initial:            0
     Cardinality of cell, filled :            6
     Size of cell, reset         :            8
     Cardinality of cell, reset  :            0

Particulars


   None.

Required Reading


   ICY.REQ
   CELLS.REQ

Version



   -Icy Version 1.0.2, 08-AUG-2008, EDW (JPL)

      Minor edits to header text.

   -Icy Version 1.0.1, 28-SEP-2006, EDW (JPL)

      Corrections to English.

      Correct Required Reading citation CELL.REQ to CELLS.REQ.

   -Icy Version 1.0.0, 29-MAR-2006, EDW (JPL)

Index_Entries

 
   set the size of a cell



Wed Apr  5 17:58:04 2017