naginterfaces.library.pde.dim2_​gen_​order2_​rectilinear_​extractgrid

naginterfaces.library.pde.dim2_gen_order2_rectilinear_extractgrid(level, xmin, ymin, dxb, dyb, lgrid, istruc, lenxy)

dim2_gen_order2_rectilinear_extractgrid is designed to be used in conjunction with dim2_gen_order2_rectilinear(). It can be called from the $\text{monitr}$ to obtain the number of grid points and their $(x,y)$ coordinates on a solution grid.

For full information please refer to the NAG Library document for d03rz

https://support.nag.com/numeric/nl/nagdoc_30.3/flhtml/d03/d03rzf.html

Parameters

levelint

The grid level at which the coordinates are required.

xminfloat

$xmin$ as supplied to $\text{monitr}$ must be passed unchanged to dim2_gen_order2_rectilinear_extractgrid

yminfloat

$ymin$ as supplied to $\text{monitr}$ must be passed unchanged to dim2_gen_order2_rectilinear_extractgrid

dxbfloat

$dxb$ as supplied to $\text{monitr}$ must be passed unchanged to dim2_gen_order2_rectilinear_extractgrid

dybfloat

$dyb$ as supplied to $\text{monitr}$ must be passed unchanged to dim2_gen_order2_rectilinear_extractgrid

lgridint, array-like, shape $\left(\text{nlev}\right)$

$lgrid$ as supplied to $\text{monitr}$ must be passed unchanged to dim2_gen_order2_rectilinear_extractgrid.

istrucint, array-like, shape $\left(lgrid\right[\text{nlev}-1]+2\times \text{nrows}+\text{npts}+1)$

$istruc$ as supplied to $\text{monitr}$ must be passed unchanged to dim2_gen_order2_rectilinear_extractgrid.

lenxyint

The dimension of the arrays $x$ and $y$.

Returns

nptsint

The number of grid points in the grid level $level$.

xfloat, ndarray, shape $\left(lenxy\right)$

$x[\text{i}-1]$ and $y[\text{i}-1]$ contain the $(x,y)$ coordinates respectively of the $\text{i}$th grid point, for $\text{i}=1,2,\dots ,npts$.

yfloat, ndarray, shape $\left(lenxy\right)$

$x[\text{i}-1]$ and $y[\text{i}-1]$ contain the $(x,y)$ coordinates respectively of the $\text{i}$th grid point, for $\text{i}=1,2,\dots ,npts$.

Raises

NagValueError

(errno $1$)

On entry, $level=⟨value⟩$ and $\text{nlev}=⟨value⟩$.

Constraint: $level\le \text{nlev}$.

(errno $1$)

On entry, $level=⟨value⟩$.

Constraint: $level\ge 1$.

(errno $2$)

On entry, $lenxy=⟨value⟩$.

Constraint: $lenxy\ge ⟨value⟩$.

Notes

No equivalent traditional C interface for this routine exists in the NAG Library.

dim2_gen_order2_rectilinear_extractgrid extracts the number of grid points and their $(x,y)$ coordinates on a specific solution grid produced by dim2_gen_order2_rectilinear(). It must be called only from within the $\text{monitr}$. The arguments $\text{nlev}$, $\text{xmin}$, $\text{ymin}$, $\text{dxb}$, $\text{dyb}$, $\text{lgrid}$ and $\text{istruc}$ to $\text{monitr}$ must be passed unchanged to dim2_gen_order2_rectilinear_extractgrid.