# INELLIPSE is the jOceans module of jLab.

``` INELLIPSE  Locates points on the interior of ellipses.

INELLIPSE(Z,KAPPA,LAMBDA,THETA,ZO) where Z is a complex-valued
location Z=X+iY, and KAPPA, LAMBDA, THETA describe an ellipse at
complex-valued position ZO=XO+iYO, is true if Z is inside the ellipse.

KAPPA is the ellipse amplitude, LAMBDA is the linearity, and THETA is
the orientation of the major axis with respect to the X-axis.

KAPPA and LAMBDA are related to the semi-axis lengths A and B by
KAPPA^2=(A^2+B^2)/2 and LAMBDA=(A^2-B^2)/(A^2+B^2).  For details, see
Lilly and Gascard (2006).
__________________________________________________________________

Array or matrix input

BOOL=INELLIPSE(Z,KAPPA,LAMBDA,THETA,ZO), where Z is a length M *row*
vector, and the other input variables are length N *row* vector,
returns an M x N boolean matrix BOOL.

In this case the (m,n)th entry of BOOL is true if the mth location Z
is inside the mth ellipse.

If the input variables have the same number of multiple *rows*, say K,
this is interpreted as corresponding to K different time.  In this case
BOOL will be a 3D array with dimensions M x N x K.
__________________________________________________________________