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 vdistg_c

Table of contents

Procedure Abstract Required_Reading Keywords Brief_I/O Detailed_Input | Detailed_Output Parameters Exceptions Files Particulars Examples | Restrictions Literature_References Author_and_Institution Version Index_Entries

#### Procedure

       vdistg_c ( Vector distance, general dimension )

       SpiceDouble vdistg_c ( ConstSpiceDouble   * v1,
                              ConstSpiceDouble   * v2,
                              SpiceInt             ndim )

#### Abstract

       Return the distance between two vectors of arbitrary dimension.

#### Required_Reading

       None.

#### Keywords

       VECTOR

#### Brief_I/O

       VARIABLE  I/O  DESCRIPTION
       --------  ---  --------------------------------------------------
       v1,
       v2         I   Two vectors of arbitrary dimension.
       ndim       I   The common dimension of v1 and v2

       The function returns the distance between v1 and v2.

#### Detailed_Input

       v1,
       v2          are two vectors of arbitrary dimension, the
                   distance between which is desired.

       ndim        is the common dimension of v1 and v2. ndim must be
                   non-negative and must not exceed the minimum of the
                   declared sizes of the actual arguments corresponding
                   to v1 and v2.

#### Detailed_Output

       The function returns the distance between v1 and v2. This is
       defined as

                ||  v1 - v2  ||,

       where || x || indicates the Euclidean norm of the vector x.

       If ndim is less than 1, the function value is set to 0..

#### Parameters

       None.

#### Exceptions

       Error free.

#### Files

       None.

#### Particulars

       The Euclidean norm of an n-dimensional vector

          (x ,  x , ... , x )
            1    2         n

       is defined as

                                                  1/2
                2        2                  2
          (   x    +   x    +  . . .  +   x     ).
               1        2                  n

       This number is the distance of the point (x, y, z) from the
       origin. If n = 3, and A and B are two vectors whose components
       are

          ( a[0], a[1], a[2] )    and    ( b[0], b[1], b[2] ),

       then the distance between A and B is the norm of the difference
       A - B, which has components

          (  a[0] - b[0],  a[1] - b[1],  a[2] - b[2]  ).

       A related routine is vdist_c, which computes the distance between
       two 3-vectors.

#### Examples

       1)  If v1 is

              [ 2.0,  3.0 ]

           and v2 is

              [ 5.0,  7.0 ],

           and ndim is 2, then

              vdistg_c ( v1, v2, ndim );

           will be 5.0.

#### Restrictions

       None.

#### Literature_References

       None.

#### Author_and_Institution

       N.J. Bachman        (JPL)
       J. Diaz del Rio     (ODC Space)
       E.D. Wright         (JPL)

#### Version

       -CSPICE Version 1.1.1, 05-JUL-2021 (JDR)

           Edited the header to comply with NAIF standard.

       -CSPICE Version 1.1.0, 22-OCT-1998 (NJB)

           Made input vectors const.

       -CSPICE Version 1.0.0, 23-MAR-1998 (EDW)

#### Index_Entries

       distance between n-dimensional vectors

#### Link to routine vdistg_c source file vdistg_c.c

    Fri Dec 31 18:41:14 2021