generates a relief plot of an array of height values.

Details and Options


open allclose all

Basic Examples  (3)

Use elevation data to display shaded terrain:

Display density data with shading:

Show heights with a legend:

Scope  (14)

Data  (6)

By default, the and data ranges are taken to be integer values:

Provide explicit and data ranges by using DataRange:

Reverse the data range by using DataReversed:

Use MaxPlotPoints to limit the number of points used:

PlotRange->Automatic can be used to drop the outlying area:

Specify explicit ranges:

Presentation  (8)

Add labels:

Shadings with no color:

Color the data by height:

Use predefined gradients:

Specify the direction where the simulated lighting is placed:

Specify the box ratios:

Use the "AspectBasedShading" method:

Provide overlay meshes:

Use automatic legends:

Use a theme with bold colors and simple ticks:

Options  (48)

BoxRatios  (3)

Automatically choose appropriate box ratios:

Make overall shading closely match 3D plots with the box ratios {1,1,5}:

Increasing the ratio produces more contrast in shading:

ClippingStyle  (4)

Clipped regions are not shown by default:

Color clipped regions like the rest of the plot:

Use pink to fill the clipped regions:

Use gray where the surface is clipped at the top and purple where it is clipped at the bottom:

ColorFunction  (6)

Shadings with no color:

Color by scaled coordinate:

Specify gray-level intensity by scaled coordinate:

Named color gradients color in the direction:

Use brightness to correspond to the height or density of a function:

Use the blend between two colors to indicate the height or density of a function:

ColorFunctionScaling  (1)

Scaled color functions may not be suitable for real-world elevation data:

Instead, use a nonscaled color function for accurate representation of the elevation:

DataRange  (2)

Arrays are displayed against the number of elements in each direction:

Rescale to the sampling space:

DataReversed  (1)

Reverse the range:

LightingAngle  (4)

By default, the simulated lighting is placed at , or the top-left corner, with altitude :

Place the light source at 180°, or the left side of the map:

Place the light source at 0°, or the right side of the map, with altitude:

The result with no shading:

MaxPlotPoints  (2)

ReliefPlot normally uses all the points in the dataset:

Limit the number of points used in each direction:

Mesh  (5)

No mesh is used by default:

Show the final sampling meshes:

Provide 8 meshes in each direction:

Mesh lines at specific positions:

Specify the style of each mesh line:

MeshStyle  (3)

Mesh lines are partially transparent by default:

Use red dashed lines for meshes:

Individually styled mesh lines can be used together with MeshStyle, and have higher priority:

Method  (2)

Normally, the "DiffuseReflection" method is used for shading:

Use the "AspectBasedShading" method:

PerformanceGoal  (2)

Generate a higher-quality plot:

Emphasize performance, possibly at the cost of quality:

PlotLegends  (6)

Use an automatic legend to show the heights:

No legend is used by default:

PlotLegends automatically picks up ColorFunction and ColorFunctionScaling values:

Use BarLegend to change legend appearance:

Add a legend to a plot using an unscaled color function:

Use Placed to change legend placement:

PlotRange  (5)

Normally, ReliefPlot uses all points to compute the range:

Automatically compute the range and clip extreme portions of it:

Use an explicit range and range to focus on areas of interest:

PlotRange interacts with DataRange:

Specify the range to emphasize features:

PlotRangeClipping  (1)

Clip the plot at PlotRange:

PlotTheme  (1)

Use a theme with no frame or axes:

Change the color function:

Properties & Relations  (3)

Some Import functions use ReliefPlot to display elevation maps with shaded relief:

Use GeoDensityPlot to color a map:

Use ArrayPlot3D for 3D arrays of data:

Possible Issues  (1)

Define two consecutive datasets:

Due to -value scaling, two results may not be consistent:

By specifying the same plot range, two results become consistent with each other:

Neat Examples  (2)

A sum of quotients of norms seen in relief:

Sample a sum of 5 sine waves in random directions:

Wolfram Research (2007), ReliefPlot, Wolfram Language function, (updated 2014).


Wolfram Research (2007), ReliefPlot, Wolfram Language function, (updated 2014).


Wolfram Language. 2007. "ReliefPlot." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2014.


Wolfram Language. (2007). ReliefPlot. Wolfram Language & System Documentation Center. Retrieved from


@misc{reference.wolfram_2024_reliefplot, author="Wolfram Research", title="{ReliefPlot}", year="2014", howpublished="\url{}", note=[Accessed: 24-June-2024 ]}


@online{reference.wolfram_2024_reliefplot, organization={Wolfram Research}, title={ReliefPlot}, year={2014}, url={}, note=[Accessed: 24-June-2024 ]}