interpolationRBF

URI

<datasetInterpolation_uri>/rbf[.<format>]

Supported methods

GET, POST, HEAD

Parent resource

datasetInterpolation

Child resources

interpolationRBFResult

Introduction

You can create a Radial Basis Function interpolation analysis result resource by sending POST request to the resource.

Supported Methods:

GET: Radial Basis Function interpolation resource, you can perform Radial Basis Function interpolation analsis with this resource.
POST: Creates the resource of an Radial Basis Function interpolation analysis result, i.e., performs an interpolation kriging analysis.
HEAD: Checks if the interpolationRBF resource exists, or if there is permission to access the interpolationRBF resource.

Supported output formats:rjson、json、jsonp、html、xml.

GIS Services Resource Hierarchy

HTTP request methods

Implement the HTTP request on the following URI, where supermapiserver is the server name, with rjson being the output format.

http://supermapiserver:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation/interpolation/rbf.rjson

GET request

Gets a form for the POST request.

POST request

Creates the resource of an Radial Basis Function interpolation analysis result, i.e., performs an interpolation kriging analysis.

Request parameter

When perform the POST request, the request body should contain the following parameters:

Name	Type	Description
smooth	double	Smooth coefficient, the range is 0-1. The value commonly use are 0, 0.001, 0.01, 0.1 and 0.5. This value represent the the degree of closeness of the the interpolation function curve and the point.
tension	double	Tension coefficient, the default value is 40, the commonly used values are 0, 1, 5 and 10. Used to adjust the characteristics of the result raster data surface, the greater the tension the less the effect on the results.
bounds	Rectangle2D	The extent of the interpolation analysis, used to determine the extent of the result raster dataset. It's the extent of the original dataset by default. Since it is the method of interpolation, only the result inside the original dataset is meaningful, so it is recommended that this parameter should not larger than the original dataset extent.
searchMode	SearchMode	When performing interpolation operation, the mode to search the point used in the operation, fixed point number search, fixed distance query and block query are supported.
expectedCount	int	[Fixed point number search] Set the number of points to query, the default is 12.
searchRadius	double	[Fixed distance search] The search extent used in the operation points.
maxPointCountForInterpolation	int	[Block search] The sum total of the points in the interpolation in block search, the default is 200.
maxPointCountInNode	int	[Block search] The maximum point number in a single block to used in the operation, the default is 50.
zValueFieldName	String	The name of fields that used to perform interpolation analysis, text field is not supported.
zValueScale	double	The scale used in the interpolation analysis, the default is 1. The values used in the interpolation analysis is multiplied by this value.
resolution	double	The resolution of the interpolation result raster dataset, that is the actual distance represented by a pixel, the unit is the same with the point dataset. The value can't be larger than the side of the dataset extent to analysis. When setting this value, it is needed to consider the size of the point dataset.
filterQueryParameter	QueryParameter	the filtering condition used to filter points in the dataset. Only points that meet the filtering condition will be included in the analysis.
outputDatasetName	String	The name of the interpolation analysis result dataset.
outputDatasourceName	String	The name of the interpolation analysis result dataset.
pixelFormat	PixelFormat	specifies the pixel formats to storage the result raster dataset, which supports BIT8, BIT16, BIT32, DOUBLE, SINGLE, UBIT1, UBIT4, UBIT8, UBIT16, UBIT32.
clipParam	ClipParameter	The parameter used to clip the interpolation result.

Response structure

Normal response code(s): 201. The response parameters are as follows:

	Field	Type	Description
succeed	boolean	Whether the query is successful.
newResourceID	String	The ID for the analysis result resource.
postResultType	PostResultType	The result type fo the POST request.
newResourceLocation	String	The URI of the newly created resource.

Respose example

Perform POST request on interpolationDensity resource, that is submit request body to http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation/interpolation/rbf.rjson, as shown below:

{

"smooth": 0.1,

"tension": 40,

"searchMode": "QUADTREE",

"maxPointCountForInterpolation": 20,

"maxPointCountInNode": 5,

"pixelFormat": "BIT16",

"zValueFieldName": "AVG_TMP",

"resolution": 3000,

"filterQueryParameter": {

"attributeFilter": ""

"outputDatasetName": "test_rbf",

"outputDatasourceName":"Interpolation"

}

The result in rjson format returned is as follows:

{

"succeed": true,

"newResourceID": "7akwbldn_c6ce72973e9c43c487633d61a6add313",

"postResultType": "CreateChild",

"newResourceLocation": "http://localhost:8090/iserver/services/spatialanalyst-sample/restjsr/spatialanalyst/datasets/SamplesP@Interpolation/interpolation/rbf/7akwbldn_c6ce72973e9c43c487633d61a6add313"

}

HEAD request

Asks for the response identical to the one that would correspond to a GET request, but without the response body. This is useful for retrieving meta-information written in response headers, without having to transport the entire content. The meta-information includes the media-type, content-encoding, transfer-encoding, content-length, etc.

HEAD request can be used to check if the interpolationRBF resource exists, or if the resource can be accessed by clients. It can also determine if the interpolationRBF resource supports an output format <format> if performed on a URI with .<format> included.