cspice_nvc2pl

 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.

```

```
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`