IDL 函数MIN_CURVE_SURF详细说明

Syntax

 

Result = MIN_CURVE_SURF(Z [, X, Y] [, /DOUBLE] [, /TPS] [, /REGULAR] [, /SPHERE [, /CONST]] [, XGRID=[xstart,xspacing] | , XVALUES=array] [, YGRID=[ystart, yspacing] | , YVALUES=array] [, GS=[xspace,yspace]] [, BOUNDS=[xmin, ymin, xmax, ymax]] [, NX=value] [, NY=value] [, XOUT=vector] [, YOUT=vector] [, XPOUT. YPOUT=array])

 

Return Value 

 

This function returns a two-dimensional floating-point array containing the interpolated surface, sampled at the grid points.

 

返回值：

这个函数返回一个包含插值曲面的2维浮点矩阵，例如网格点。

Arguments

 

Z, X, Y

Arrays containing the Z, X, and Y coordinates of the data points on the surface. Points need not be regularly gridded. For regularly gridded input data, X and Y are not used: the grid spacing is specified via the XGRID and YGRID (or XVALUES and YVALUES) keywords, and Z must be a two-dimensional array. For irregular grids, all three parameters must be present and have the same number of elements. If Z is specified as a double-precision value, the computation will be performed in double-precision arithmetic. If the SPHERE keyword is set, X and Y are given in degrees of longitude and latitude, respectively.

Note: The minimum curvature algorithm requires a work array that is M2 in size, where M is the total number of input data points. On 32-bit platforms, you are therefore limited to input data arrays that have less than approximately 46340 data points, with the exact number depending upon your available memory. Using an input array with too many elements will result in an error.

参数：

矩阵包含X、Y、Z曲面坐标点。点不需要是严格的网格状。对于网格状的输入数据，不适用X和Y：通过关键词XGRID和YGRID(或XVALUES和YVALUES)指定网格间距，并且Z必须是个2维的矩阵。对于非网格数据，X、Y、Z三个参数都必须存在且拥有相同个数的元素。如果Z被指定为一个双精度值，计算则在双精度进行计算。如果关键字SPHERE已经设定，X和Y需要分别给出经度和纬度。

Keywords 关键字

 

CONST

Set this keyword to fit data on the sphere with a constant baseline, otherwise, data on the sphere is fit with a baseline that contains a constant term plus linear X, Y, and Z terms. This keyword has an effect only if SPHERE is set. See Theory above for the formulae.

常数：

用一个常数基线去设置这个关键字在球面上拟合数据，否则，球面上的数据是符合基线包含常数项和线性X,Y,Z的条件。只有当SPHERE设置时这个关键词才有作用，参见上面的理论公式

DOUBLE

Set this keyword to force the computation to be done in double-precision arithmetic. If Z is double precision, the computations will also be done in double precision.

双精度：

设置该关键字来迫使计算双精度运算，如果Z是双精度,计算也将使用双精度。

SPHERE

Set this keyword to perform interpolation on the surface of a sphere. The inputs X and Y should be given in degrees of longitude and latitude, respectively.

球形：

设置该关键字为了进行球面上的插值。输入参数X和Y需要分别给出经度和纬度。

TPS

Set this keyword to use the thin-plate-spline method. The default is to use the minimum curvature surface method.

薄板样条：

设置该关键字是用来进行薄板样条插值的。默认是使用最小曲率方法。

Input Grid Description Keywords:

输入网格关键字描述：

REGULAR

If set, the Z parameter is a two-dimensional array of dimensions (n,m), containing measurements over a regular grid. If any of XGRID, YGRID, XVALUES, or YVALUES are specified, REGULAR is implied. REGULAR is also implied if there is only one parameter, Z. If REGULAR is set, and no grid specifications are present, the grid is set to (0, 1, 2, ...).

REGULAR：

如果该参数设置了，则参数Z必须是个2维矩阵（n,m），在一个常规网格里包含了测量。如果XGRID,YGRID、XVALUES或YVALUES中的一个被指定,常规网格则被隐含。如果只有一个参数Z则常规网格也一样被隐含。如果常规设置了，而且不存在网格规范，那么网格设置为（0,1,2，......）

XGRID

A two-element array, [xstart, xspacing], defining the input grid in the x direction. Do not specify both XGRID and XVALUES.

XGRID

一个二维矩阵，[xtart,xspacing]，在X方向上定义了输入网格。不要同时指定XGRID and XVALUES。

 

XVALUES

An n-element array defining the x locations of Z[i,j]. Do not specify both XGRID and XVALUES.

XVALUES

n元数组定义x Z(i,j)的位置，不要同时指定XGRID和XVALUES。

YGRID

A two-element array, [ystart, yspacing], defining the input grid in the y direction. Do not specify both YGRID and YVALUES.

YGRID

 一个两个元素的矩阵[ystart,yspacing],在Y方向上定义了输入网格。不要同时指定YGRID和YVALUES。

YVALUES

An n-element array defining the y locations of Z[i,j]. Do not specify both YGRID and YVALUES.

YVALUES

n元数组定义y Z[i,j]的位置。不要同时指定YGRID和YVALUES。

Output Grid Description Keywords:

输出网格关键字描述：

GS

The output grid spacing. If present, GS must be a two-element vector [xs, ys], where xs is the horizontal spacing between grid points and ys is the vertical spacing. The default is based on the extents of x and y. If the grid starts at x value xminand ends at xmax, then the default horizontal spacing is (xmax - xmin)/(NX-1). ys is computed in the same way. The default grid size, if neither NX or NY are specified, is 26 by 26.

GS

输出网格间距。如果存在，GS必须是含有两个元素的向量[xs,ys],其中，xs是指网格点的水平间距，ys是指网格点的垂直间距。默认值是基于输入X和Y的范围。如过网格从X的最小值开始到X的最大值结束，那么默认的水平间距为(xmax - xmin)/(NX-1)。ys也是用同样的方法。默认网格大小，如果NX和NY都没有指定，那么就是26X26的网格。

BOUNDS

If present, BOUNDS must be a four-element array containing the grid limits in x and y of the output grid: [xmin, ymin, xmax, ymax]. If not specified, the grid limits are set to the extent of x and y.

BOUNDS 界限

如果存在，那么BOUNDS必须限制在x和y输出网格中[xmin, ymin, xmax, ymax]。如果没有指定,网格限制设置为x和y的范围。

NX

The output grid size in the x direction. NX need not be specified if the size can be inferred from GS and BOUNDS. The default value is 26.

NX

在x方向上的输出网格的大小。当NX可以从GS和BOUNDS中推断出来时则不需要指定。默认值是26。

NY

The output grid size in the y direction. NY need not be specified if the size can be inferred from GS and BOUNDS. The default value is 26.

NY

在y方向上的输出网格的大小。当NY可以从GS和BOUNDS中推断出来时则不需要指定。默认值是26。

XOUT

Use the XOUT keyword to specify a vector containing the output grid x values. If this parameter is supplied, GS, BOUNDS, and NX are ignored for the x output grid. XOUT allows you to specify irregularly-spaced output grids.

XOUT

使用关键字XOUT指定指定一个包含输出网格的x值。如果这个参数提供了，那么在x输出网格中GS、BOUNDS、NX都将被忽略。XOUT允许你指定间隔不规则网格输出。

YOUT

Use the YOUT keyword to specify a vector containing the output grid y values. If this parameter is supplied, GS, BOUNDS, and NY are ignored for the y output grid. YOUT allows you to specify irregularly-spaced output grids.

YOUT

使用关键字YOUT指定指定一个包含输出网格的y值。如果这个参数提供了，那么在x输出网格中GS、BOUNDS、NY都将被忽略。YOUT允许你指定间隔不规则网格输出。

 

XPOUT

YPOUT

Use the XPOUT and YPOUT keywords to specify arrays that contain the x and y values for the output points. If these keywords are used, the output grid need not be regular, and all other output grid parameters are ignored. XPOUT and YPOUT must have the same number of points, which is also the number of points returned in the result.

XPOUT、YPOUT

使用XPOUT和YPOUT关键字指定数组包含x和y值的输出点。如果这个关键字已经使用，则输出网格不需要规定，同时其他输出网格参数也被无视。XPOUT和YPOUT必须拥有相同数量的点，这也是返回的结果的数量。