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
See Also
WV_APPLET