Coordinate Conversions

Depending upon the data and type of visualization, you may want to convert between normalized, data or device coordinates (described in IDL Coordinate Systems). This section details two-dimensional and three-dimensional coordinate system characteristics provides resources for various coordinate conversions. See the following for details:

Two-Dimensional Coordinate Conversion

This section describes the formulae for conversions to and from each coordinate system. In the following discussion, D_x is a data coordinate, N_x is a normalized coordinate, and R_x is a raw device coordinate. Let V_x and V_y represent the size of the visible area of the currently selected display or drawing surface.

The field S is a two-element array of scaling factors used to convert X coordinates from data units to normalized units. S contains the parameters of the linear equation, converting data coordinates to normalized coordinates. S[0] is the intercept, and S[1] is the slope. Also, let D_x be the data coordinate, N_x the normalized coordinate, R_x the device coordinate, V_x the device X size (in device coordinates).

With the above variables defined, the linear two-dimensional coordinate conversions for the x coordinate can be written as follows:

Table 3-1: Equations for X-axis Coordinate Conversion

Table 3-1: Equations for X-axis Coordinate Conversion
Coordinate Conversion	Linear	Logarithmic
Data to normal
Data to device
Normal to device
Normal to data
Device to data
Device to normal

The y- and z-axis coordinates are converted in exactly the same manner, with the exception that there is no z device coordinate and that logarithmic z-axes are not permitted.

This coordinate conversion functionality is built into object graphics through the XCOORD_CONVERT and YCOORD_CONVERT properties or each type of visualization object. If you are working with a Direct Graphics display, you can use the CONVERT_COORD function.

Three-Dimensional Coordinate Conversion

To convert from a three-dimensional coordinate to a two-dimensional coordinate, IDL follows these steps:

Data coordinates are converted to three-dimensional normalized coordinates. To convert the x coordinate from data to normalized coordinates, use the formula N_x = X₀ + X₁D_x. The same process is used to convert the y and z coordinates using !Y.S and !Z.S.

The three-dimensional normalized coordinate, P = (N_x, N_y, N_z), whose homogeneous representation is (N_x, N_y, N_z, 1), is multiplied by the concatenated transformation matrix !P.T:

P¢ = P · !P.T

The vector P¢ is scaled by dividing by w, and the normalized two-dimensional coordinates are extracted:

N¢_x = P¢_x/P¢_w and N¢_y = P¢_y/P¢_w

The normalized xy coordinate is converted to device coordinates as described in Two-Dimensional Coordinate Conversion.

Using Coordinate Conversions

iTools — in an iTool display, the interactive nature of the tool makes coordinate conversions transparent. There is no need to programmatically configure the transformation matrices of the objects. See Manipulating the Display for information on zooming, scaling and translation.

Object Graphics — converting an object's data coordinates into normalized coordinates for display is a common task. See Positioning Visualizations in a View for details on the elements involved in defining an object's position. Positioning Objects in a View also includes information on how to use coordinate conversions (see Converting Data to Normal Coordinates) and information on programmatically defining the object's placement in a view (see Translating, Rotating and Scaling Objects).

Direct Graphics — the IDL Direct Graphics system automatically positions and sizes static visualizations so there is no need to set up a transformation matrix. However, you can convert between the supported coordinate systems. See CONVERT_COORD for information on this conversion in Direct Graphics.