From 9:00 AM - 12:00 PM CDT on Saturday, June 6th, ni.com will be undergoing system upgrades that may result in temporary service interruption.

We appreciate your patience as we improve our online experience.

# gradient (MathScript RT Module Function)

LabVIEW 2012 MathScript RT Module Help

Edition Date: June 2012

Part Number: 373123C-01

»View Product Info

Owning Class: vector

Requires: MathScript RT Module

## Syntax

fx = gradient(f, d)

fx = gradient(f, dx, dy)

[fx, fy] = gradient(f)

[fx, fy] = gradient(f, d)

[fx, fy] = gradient(f, dx, dy)

## Description

Computes the gradient function of the input elements.

Details

Examples

## Inputs

Name Description
f Specifies the values of the function for which you want to compute the gradient. f is a vector or matrix.
d Specifies the spacing between points along the x- and y-axes, or between values of the first and second dimensions in a 2D array. d is an array of real, double-precision, floating-point numbers. The default is 1, or dx = dy = 1.
dx Specifies the spacing between points along the x-axis, or between values of the second dimension in a 2D array. dx is an array of real, double-precision, floating-point numbers. The default is 1.
dy Specifies the spacing between points along the y-axis, or between values of the first dimension in a 2D array. dy is an array of real, double-precision, floating-point numbers. The default is 1.

## Outputs

Name Description
fx Returns the difference in gradient function values of f with respect to the x-axis, or df/dx. fx has the same dimension and data type as f.
fy Returns the difference in gradient function values of f with respect to the y-axis, or df/dy. fy has the same dimension and data type as f.

## Details

You can specify the spacing between the points of the gradient function in two ways. If dx or dy contains only one element, the spacing between two consecutive points in the corresponding axis is constant. If dx or dy contains more than one element, the values of the elements specify the coordinates of the points in the corresponding axis. The length of dx or dy must therefore conform to the corresponding dimension of f.

The following table lists the support characteristics of this function.

 Supported in the LabVIEW Run-Time Engine Yes Supported on RT targets Yes Suitable for bounded execution times on RT Not characterized

## Examples

F = rand(3, 4)
[Fx, Fy] = gradient(F, [1, 2, 3, 4], [1, 2, 3])