Index Page
cspice_nvc2pl
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_NVC2PL constructs a SPICE plane from a normal vector
   and a constant.

I/O


   Given:

      normal     [3,1] = size(normal); double = class(normal)

      constant   [1,1] = size(constant); double = class(constant)

                 are, respectively, a normal vector and constant
                 defining a plane. 'normal' need not be a unit
                 vector.  Let the symbol < a, b > indicate the
                 inner product of vectors a and b; then the
                 then the geometric plane is the set of vectors x
                 in three-dimensional space that satisfy

                    < x,  normal >  =  constant.

   the call:

      plane = cspice_nvc2pl( normal, constant )

   returns:

      plane   a structure describing a SPICE plane defined by
              'normal' and 'constant'

              [1,1] = size(plane); struct = class(plane)

              The structure has the fields:

                 normal:     [3,1] = size(normal); double = class(normal)
                 constant:   [1,1] = size(constant); double = class(constant)

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.

      %
      % Define an arbitrary normal and constant...
      %
      normal    = [ 1.; 1.; 1. ];
      constant  = 23.;

      %
      % ...then construct the plane.
      %
      plane = cspice_nvc2pl( normal, constant );

      plane.constant
      plane.normal

   Matlab outputs:

      For plane.constant:

      ans =

         13.2791


      For plane.normal:

      ans =

          0.5774
          0.5774
          0.5774

Particulars


   Mice geometry routines that deal with planes use the `plane'
   data type to represent input and output planes.  This data type
   makes the subroutine interfaces simpler and more uniform.

   The Mice routines that produce SPICE planes from data that
   define a plane are:

      cspice_nvc2pl ( Normal vector and constant to plane )
      cspice_nvp2pl ( Normal vector and point to plane    )
      cspice_psv2pl ( Point and spanning vectors to plane )

   The Mice routines that convert SPICE planes to data that
   define a plane are:

      cspice_pl2nvc ( Plane to normal vector and constant )
      cspice_pl2nvp ( Plane to normal vector and point    )
      cspice_pl2psv ( Plane to point and spanning vectors )

   Any of these last three routines may be used to convert this
   routine's output, 'plane', to another representation of a
   geometric plane.

Required Reading


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

   MICE.REQ
   PLANES.REQ

Version


   -Mice Version 1.0.1, 27-AUG-2012, EDW (JPL)

      Edited I/O section to conform to NAIF standard for Mice documentation.

   -Mice Version 1.0.0, 30-DEC-2008, EDW (JPL)

Index_Entries


   normal vector and constant to plane


Wed Apr  5 18:00:33 2017