Index Page
cspice_ekfind
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_EKFIND find E-kernel data that satisfy a set of constraints.

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

I/O

   
   Given:
   
      query   a string scalar specifying the data to locate from data
              available in all loaded EK files. The general
              form of a query general form:
   
                 SELECT   <column list> 
                 FROM     <table list> 
                [WHERE    <constraint list>] 
                [ORDER BY <ORDER BY column list>]
   
              (WHERE and ORDER BY are optional parameters)
   
   the call:
   
      cspice_ekfind, query, nmrows, error, errmsg
   
   returns:
   
      nmrows   a scalar integer containing the number of rows
               matching the query.
               
      error    a scalar boolean indicating whether the query parsed
               correctly (TRUE) or not (FALSE).
               
      errmsg   a string scalar containing a description of the parse 
               error should one occur, otherwise the string returns
               as blank.

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.

      ;;
      ;; A query string.
      ;;   
      query = "Select c_col_1, d_col_1, i_col_1, t_col_1 from " + $
              " scalar_2 order by row_no"

      cspice_ekfind, query, nmrows, error, errmsg

      ;;
      ;; Check if an error occurred during parsing of the query string.
      ;; If so, the errmsg string contains the error message.
      ;;
      if ( error ) then begin
         print, 'Error message: ', errmsg
      endif

      ;;
      ;; If no error, nmrows contains the number of rows matching the
      ;; constraints specified in the query string
      ;;   
      print, 'Number of matching row: ', nmrows

   Load at least one EK kernel prior to calling cspice_ekfind otherwise
   the CSPICE library signals an error.

   IDL outputs:

      Number of matching row:    20

Particulars


   None.

Required Reading


   ICY.REQ
   EK.REQ

Version


   -Icy Version 1.0.0, 16-JUN-2003, EDW (JPL)

Index_Entries

 
   find EK data 
   issue EK query 
 



Wed Apr  5 17:58:00 2017