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
cspice_dasrdd

Table of contents
Abstract
I/O
Parameters
Examples
Particulars
Exceptions
Files
Restrictions
Required_Reading
Literature_References
Author_and_Institution
Version
Index_Entries

Abstract


   CSPICE_DASRDD reads double precision data from a range of DAS logical
   addresses.

I/O


   Given:

      handle   a file handle for an open DAS file.

               [1,1] = size(handle); int32 = class(handle)

      first,
      last     the lower and upper bounds of a range of DAS double
               precision logical addresses.

               [1,1] = size(first); int32 = class(first)
               [1,1] = size(last); int32 = class(last)

               The range includes these bounds. `first' and `last' must be
               greater than or equal to 1 and less than or equal to the
               highest double precision DAS address in the DAS file
               designated by `handle'.

   the call:

      [data] = cspice_dasrdd( handle, first, last )

   returns:

      data     an array of double precision numbers.

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

               `data' has length n = last - first + 1.

Parameters


   None.

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.

   1) Create a new DAS file TEST.DAS and add 200 double
      precision numbers to it. Close the file, then re-open
      it and read the data back out.


      Example code begins here.


      function dasrdd_ex1()

         %
         % Local parameters.
         %
         FNAME =   'dasrdd_ex1.das';
         TYPE  =   'TEST';

         %
         % Local variables.
         %
         data = zeros(100,1);

         %
         % Open a new DAS file. Use the file name as the internal
         % file name, and reserve no records for comments.
         %
         [handle] = cspice_dasonw( FNAME, TYPE, FNAME, 0 );

         %
         % Fill the array `data' with the double precision
         % numbers 1.0 through 100.0, and add this array
         % to the file.
         %
         for i=1:100

            data(i) = double(i);

         end

         cspice_dasadd( handle, data );

         %
         % Now append the array `data' to the file again.
         %
         cspice_dasadd( handle, data );

         %
         % Close the file.
         %
         cspice_dascls( handle );

         %
         % Now verify the addition of data by opening the
         % file for read access and retrieving the data.
         %
         [handle] = cspice_dasopr( FNAME );
         [data]   = cspice_dasrdd( handle, 1, 200 );

         %
         % Dump the data to the screen.  We should see the
         % sequence 1.0, 2.0, ..., 100.0, 1.0, 2.0, ..., 100.0.
         % The numbers will be represented as double precision
         % numbers in the output.
         %
         fprintf( '\n' )
         fprintf( 'Data from "%s":\n', FNAME )
         fprintf( '\n' )
         for i=0:24

            for j=1:8

               fprintf( '%7.1f', data(i*8+j) )

            end
            fprintf( '\n' )

         end

         %
         % Close the file.
         %
         cspice_dascls( handle );


      When this program was executed on a Mac/Intel/Octave6.x/64-bit
      platform, the output was:


      We are here
      But not here

      Data from "dasrdd_ex1.das":

          1.0    2.0    3.0    4.0    5.0    6.0    7.0    8.0
          9.0   10.0   11.0   12.0   13.0   14.0   15.0   16.0
         17.0   18.0   19.0   20.0   21.0   22.0   23.0   24.0
         25.0   26.0   27.0   28.0   29.0   30.0   31.0   32.0
         33.0   34.0   35.0   36.0   37.0   38.0   39.0   40.0
         41.0   42.0   43.0   44.0   45.0   46.0   47.0   48.0
         49.0   50.0   51.0   52.0   53.0   54.0   55.0   56.0
         57.0   58.0   59.0   60.0   61.0   62.0   63.0   64.0
         65.0   66.0   67.0   68.0   69.0   70.0   71.0   72.0
         73.0   74.0   75.0   76.0   77.0   78.0   79.0   80.0
         81.0   82.0   83.0   84.0   85.0   86.0   87.0   88.0
         89.0   90.0   91.0   92.0   93.0   94.0   95.0   96.0
         97.0   98.0   99.0  100.0    1.0    2.0    3.0    4.0
          5.0    6.0    7.0    8.0    9.0   10.0   11.0   12.0
         13.0   14.0   15.0   16.0   17.0   18.0   19.0   20.0
         21.0   22.0   23.0   24.0   25.0   26.0   27.0   28.0
         29.0   30.0   31.0   32.0   33.0   34.0   35.0   36.0
         37.0   38.0   39.0   40.0   41.0   42.0   43.0   44.0
         45.0   46.0   47.0   48.0   49.0   50.0   51.0   52.0
         53.0   54.0   55.0   56.0   57.0   58.0   59.0   60.0
         61.0   62.0   63.0   64.0   65.0   66.0   67.0   68.0
         69.0   70.0   71.0   72.0   73.0   74.0   75.0   76.0
         77.0   78.0   79.0   80.0   81.0   82.0   83.0   84.0
         85.0   86.0   87.0   88.0   89.0   90.0   91.0   92.0
         93.0   94.0   95.0   96.0   97.0   98.0   99.0  100.0


      Note that after run completion, a new DAS file exists in the
      output directory.

Particulars


   This routine provides random read access to the double precision
   data in a DAS file. This data are logically structured as a
   one-dimensional array of double precision numbers.

Exceptions


   1)  If the input file handle is invalid, an error is signaled
       by a routine in the call tree of this routine.

   2)  If `first' or `last' are out of range, an error is signaled
       by a routine in the call tree of this routine.

   3)  If `first' is greater than `last', `data' is empty.

   4)  If `data' is declared with length less than first - last + 1,
       the error cannot be diagnosed by this routine.

   5)  If a file read error occurs, the error is signaled by a
       routine in the call tree of this routine.

   6)  If any of the input arguments, `handle', `first' or `last', is
       undefined, an error is signaled by the Matlab error handling
       system.

   7)  If any of the input arguments, `handle', `first' or `last', is
       not of the expected type, or it does not have the expected
       dimensions and size, an error is signaled by the Mice
       interface.

Files


   See the description of the argument `handle' in -I/O.

Restrictions


   None.

Required_Reading


   DAS.REQ
   MICE.REQ

Literature_References


   None.

Author_and_Institution


   J. Diaz del Rio     (ODC Space)

Version


   -Mice Version 1.0.0, 26-NOV-2021 (JDR)

Index_Entries


   read double precision data from a DAS file


Fri Dec 31 18:44:23 2021