Home | Categories | Alphabetical | Classes | All Contents | [ < ] | [ > ]

WV_IMPORT_DATA


Syntax | Arguments | Keywords | Examples | Version History | See Also

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

Note
The IDL Wavelet Toolkit must be licensed on your system to be able to use this procedure.

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

Introduced: 5.3

See Also

WV_APPLET


Home | Categories | Alphabetical | Classes | All Contents | [ < ] | [ > ]