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