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.

Table 4-13: Tags Recognized by WV_IMPORT_DATA
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