Procedure

   void uddc_c ( void            ( * udfunc ) ( SpiceDouble    x,
                                                SpiceDouble  * value ),
                 SpiceDouble         x,
                 SpiceDouble         dx,
                 SpiceBoolean      * isdecr )
                     

Abstract

   SPICE private routine intended solely for the support of SPICE
   routines. Users should not call this routine directly due to the
   volatile nature of this routine.

   This routine calculates the derivative of 'udfunc' with respect 
   to time for 'et', then determines if the derivative has a 
   negative value.

Required_Reading

   GF

Keywords

   DERIVATIVE
   GEOMETRY

Brief_I/O

   VARIABLE  I/O  DESCRIPTION
   --------  ---  --------------------------------------------------

   udfunc     I   The routine that computes the scalar value
                  of interest.
   x          I   Independent variable of 'udfunc'.
   dx         I   Interval from 'x' for derivative calculation.
   isdecr     O   Boolean indicating if the derivative is negative.

Detailed_Input

   udfunc     the routine that returns the value of the scalar quantity  
              function of interest at X. The calling sequence for UDFUNC is: 
 
                 udfunc ( x, &value ); 
 
              where: 
 
                 x       the double precision value of the  
                         independent variable of the function 
                         at which to determine the scalar value. 
 
                 value   the double precision value returned by  
                         'udfunc' at 'x'. 
 
              Functionally: 
 
                 value = udfunc ( x ) 
 
   x          a scalar double precision value at which to determine 
              the derivative of 'udfunc'. 
 
              For many SPICE uses, 'x' will represent ephemeris time,  
              expressed as seconds past J2000 TDB. 
 
  dx         a scalar double precision value representing half the  
              interval in units of 'x' separating the evaluation 
              values of 'udfunc'; the evaluations occur at (x + dx)  
              and (x - dx). 
 
              'dx' may be negative but must be non-zero. 

Detailed_Output

   isdecr   a scalar boolean indicating if the first derivative
            of 'udfunc' with respect to time at 'et' is less than 
            zero.

            Functionally:

              d udfunc(x) |
              --          |  <  0
              dx          |
                           x

Parameters

   None.

Exceptions

 
   1) A routine in the call tree of this routine signals 
      SPICE(DIVIDEBYZERO) if DX has a value of zero. 
 

Files

 
   If the evaluation of 'udfunc' requires SPICE kernel data, the 
   appropriate kernels must be loaded before calling this routine. 
 
      - SPK data: the calling application must load ephemeris data 
        for the targets, observer, and any intermediate objects in  
        a chain connecting the targets and observer for the time 
        used in the evaluation. If aberration corrections are used,  
        the states of target and observer relative to the solar system  
        barycenter must be calculable from the available ephemeris  
        data. 
 
      - If non-inertial reference frames are used, then PCK 
        files, frame kernels, C-kernels, and SCLK kernels may be 
        needed. 
 
   Such kernel data are normally loaded once per program run, NOT  
   every time this routine is called.  
   

Particulars

   None.

Examples

   See gfuds_c.

Restrictions

   None.

Literature_References

   None.

Author_and_Institution

   N.J. Bachman   (JPL)
   E.D. Wright    (JPL)
 

Version

   -CSPICE Version 1.0.0, 31-MAR-2010 (EDW) 

Index_Entries

   first derivative less-than zero

Link to routine uddc_c source file uddc_c.c