Routines (alphabetical) > Routines: W > WV_IMPORT_DATA

# WV_IMPORT_DATA

The WV_IMPORT_DATA procedure allows the user to add a variable to the currently active WV_APPLET widget from the IDL> command prompt.

## Syntax

WV_IMPORT_DATA, Data [, MESSAGE_OUT=string] [, PARENT=variable]

## Arguments

### Data

A one- or two-dimensional array of data, or a structure containing the data.

## Keywords

### MESSAGE_OUT

A scalar string giving a message to be output to the WV_APPLET message bar.

### PARENT

A long integer specifying the ID of the WV_APPLET widget in which to import the data. The default is the most-recently active WV_APPLET widget.

## Examples

To import a 1D or 2D array directly into the active WV_APPLET widget:

WV_IMPORT_DATA, Array

To import a data structure:

WV_IMPORT_DATA, {DATA: PTR_NEW(Array), $

SOURCE: ’Chandra X-Ray Observatory’, $

TITLE: ’Cygnus X-1 X-Ray Image’, $

VARIABLE: ’Cygnus X-1’, $

UNITS: ’Intensity’}

If Data is a structure then it must include at the very least a DATA tag containing a pointer to a one- or two-dimensional array. Recognized tags are shown in the following table. Tags other than these will be quietly ignored.

Tag | Type | Definition
DATA | PTR->Array | Pointer to data array
TITLE | STRING | Long name of data variable
VARIABLE | STRING | Short name of data variable
UNITS | STRING | Units for variable
XNAME | STRING | Name of X coordinate
XUNITS | STRING | Units for X coordinate
XSTART | STRING | Starting value for X coord
DX | STRING | Sampling rate for X coord
YNAME | STRING | Name of Y coordinate
YUNITS | STRING | Units for Y coordinate
YSTART | STRING | Starting value for Y coord
DY | STRING | Sampling rate for Y coord
XOFFSET | LONG | Starting index of X coord to use
XCOUNT | LONG | Number of X coords to use
XSTRIDE | LONG | X sampling interval to use
YOFFSET | LONG | Starting index of Y coord to use
YCOUNT | LONG | Number of Y coords to use
YSTRIDE | LONG | Y sampling interval to use
SOURCE | STRING | Filename or contact info
NOTES | STRING | Miscellaneous notes
COLORS | PTR->Bytarr(3,256) | Pointer to color table for Data

## Version History

5.3 | Introduced

## See Also

WV_APPLET