MGH_DENSITY__DEFINE
Class Name
MGH_Density
Purpose
This class displays a 2-D numeric array as a colour density plot
in a window, with axes and a colour scale. The colour scale can be
edited interactively. The performance of an MGH_DENSITY object
depends on the implementation of the density plot (keyword
IMPLEMENTATION).
Object Creation Calling Sequence
mgh_new, 'MGH_Density', values[, x, y]
Positional Parameters
values
A 2D array of numeric data to be plotted
x
Position in the x direction of the columns of data
y
Position in the y direction of the rows of data
Properties
BYTE_RANGE (Init,Get)
The range of byte values to which the data range is to be mapped.
DATA_RANGE (Init,Get,Set)
The range of data values to be mapped onto the indexed color
range for the density plane and the colour bar. Data values
outside the range are mapped to the nearest end of the range. If
not specified, DATA_RANGE is calculated when the density plane
is created,
IMPLEMENTATION (Init,Get)
The implementation of the density-plot object. Valid values are:
0: MGHgrDensityPlane object based on the MGHgrColorSurface class (default)
1: MGHgrDensityPlane object based on the MGHgrColorPolygon class
2: Data are regridded on an IDLgrImage overlaid as a texture map on a
rectangular IDLgrPolygon
3: Data are regridded on a naked IDLgrImage.
4: IDLgrImage object. Non-uniform grid spacing is ignored
STYLE (Init):
The style of the plane. Values are 0 (each data point represented
by a cell of uniform colour) and 1 (colours interpolated between
data points). Default is 0. Note that the value of this property
determines the dimensions that X & Y arrays (if any) must have.
###########################################################################
Copyright (c) 1999-2012 NIWA:
http://www.niwa.co.nz/
Licensed under the MIT open source license:
http://www.opensource.org/licenses/mit-license.php
###########################################################################
Modification History
Mark Hadfield, May 1999:
Written as MGHgrDensityPlot.
Mark Hadfield, May 1999:
Renamed MGH_Density.
Mark Hadfield, 2012-02:
Added netCDF export facility. X & Y data now stored with the object.
Mark Hadfield, 2014-08:
Added COLORBAR_PROPERTIeS keyword.