harmonica.derivative_upward

harmonica.derivative_upward#

harmonica.derivative_upward(grid, *, order=1, pad=True, pad_kwargs=None)[source]#

Calculate the derivative of a potential field grid in the upward direction.

Compute the spatial derivative in the upward direction of regular gridded data using frequency domain calculations through Fast Fourier Transform.

Parameters:
gridxarray.DataArray

A two dimensional xarray.DataArray whose coordinates are evenly spaced (regular grid). Its dimensions should be in the following order: northing, easting. Its coordinates should be defined in the same units.

orderint, optional

The order of the derivative. Default to 1.

padbool, optional

If True, will add padding to the grid before taking the Fourier Transform and applying the filter and remove it after the inverse Fourier Transform. Adding padding usually helps reduce edge effects from signal truncation. Default is True.

pad_kwargsdict or None, optional

Any additional keyword arguments that should be passed to the xarray.DataArray.pad function in the form of a dictionary. If none are given, the default padding of 25% the dimensions of the grid will be added using the “edge” method.

Returns:
derivativexarray.DataArray

A xarray.DataArray with the upward derivatives of the passed grid. Its units are the same units of the grid per units of its coordinates.

References

[Blakely1995]

Examples using harmonica.derivative_upward#

Upward derivative of a regular grid

Upward derivative of a regular grid