k-Wave Toolbox |

# cart2grid

Interpolate a set of Cartesian points onto a binary grid

## Syntax

    [grid_data, order_index, reorder_index] = cart2grid(kgrid, cart_data)

## Description

`cart2grid` interpolates the set of Cartesian points defined by `cart_data` onto a binary matrix defined by the k-space grid structure `kgrid` using nearest neighbour interpolation. An error is returned if the Cartesian points are outside the computational domain defined by kgrid.

## Inputs

`kgrid` | k-Wave grid structure returned by `makeGrid`
`cart_data` | 1 x N, 2 x N, or 3 x N (for 1, 2, and 3 dimensions) array of Cartesian sensor points

## Outputs

`grid_data` | binary grid with the same dimensions as the k-Wave input grid `kgrid`
`order_index` | the order that the Cartesian points appear in `grid_data` according to MATLAB's standard column-wise linear matrix index ordering
`reorder_index` | the order that the binary points in `grid_data` (according to MATLAB's standard column-wise linear matrix index ordering) appear in the original Cartesian data

## Examples

- Homogenous Propagation Medium
- Loading External Image Maps
- Comparison Of Modelling Functions
- Simulations In Three Dimensions
- Modelling Sensor Directivity in 2D
- Modelling Sensor Directivity in 3D
- 2D Time Reversal For A Circular Sensor

## See Also

`grid2cart`, `interpCartData`, `makeGrid`

© 2009-2012 Bradley Treeby and Ben Cox.