# IBM Visualization Data Explorer User's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

### Regrid

Category

Realization

Function

Maps scattered points onto a grid.

Syntax

    output = Regrid(input, grid, nearest, radius, exponent, missing);

Inputs

Name | Type | Default | Description
--- | --- | --- | ---
`input` | field or vector list | none | field with positions to regrid
`grid` | field | none | grid to be used as template
`nearest` | integer or string | 1 | number of nearest neighbors to use
`radius` | scalar or string | "infinity" | radius from grid point
`exponent` | scalar | 1.0 | weighting exponent
`missing` | value | no default | missing value to be inserted if necessary

Outputs

Name | Type | Description
--- | --- | ---
`output` | field | regridded field

Functional Details

This module uses a specified set of scattered points (`input`) to assign data values to every position of a specified grid.

`input` | should be either (1) a field with a 1-, 2-, or 3-dimensional "positions" component or (2) a list of 1-, 2-, or 3-dimensional vectors. In the second case, the vectors are interpreted as positions.
`grid` | is required. It specifies the grid to be used as a base for creating a "connections" component. The dimensionality of positions in this grid must match that of the positions in `input`. The specified `grid` could be created with the Construct module.
`nearest` | must be an integer or the string "infinity." An integer value specifies the number of nearest points (to each grid point) to be used in computing an average data value for that grid point.
`radius` | specifies the maximum radius (from the grid point) within which the nearest neighbors can be found. The parameter must specify a scalar value or the string "infinity."
`exponent` | The averaging method is a weighted average. The expression for this average is 1/radius`(exponent)`. The default value is 1.0, reducing the expression to the reciprocal of the radius.
`missing` | is used when `radius` is set to a value other than "infinity." The parameter specifies how to treat those grid points for which no points in `input` occur within the specified radius. If `missing` is not set, the module creates an "invalid positions" component, and grid points with no assigned data value are invalidated. If `missing` is set, the data value is inserted for the missing data values. It must match the data component of `input` in rank, type, and shape. All components that are position-dependent are treated in the same way as the "data" component.

Note: To remove invalidated positions, use the Include module. However, it is not necessary to remove invalidated positions in order to have them treated as invalid by other modules.

Components

Adds a "connections" component. The "positions" and "connections" components are those of `grid` while all components in `input` that depend on "positions" will be present in the output, modified by averaging.

Example Visual Program

    SIMPLE/Regrid.net

See Also

Connect, Construct, Include, AutoGrid

[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]

[IBM Home Page | Order | Search | Contact IBM | Legal ]