The query
command allows the user to get information
about a variety of aspects of the current GrADS session.
Configuration, plot characteristics, graphics specifics, and
file structure are some examples. The use of query pos
combined with the coordinate transformations is the basis of many
interactive applications with buttons and drop menus. The
query
command may be shortened to simply
q
. The syntax is:
query <option>
q <option>
When given without an option
, the
query
command returns a list of the possible
options. These are:
config
Returns GrADS configuration informationdefine
Lists currently defined variablesdefval v1 i j
Returns the value of defined variable v1
at point i,j
dialog args
Launches a dialog box that prompts for text or numeric data entrydims
Returns current dimension environmentfile n
Returns info on file number n
files
Lists open filesfwrite
Returns status and characteristics of fwrite ouput filegxinfo
Returns graphics environment infolats
Returns the status of the GrADS-LATS interfacepos
Waits for mouse click, then returns the position in screen coordinatesshades
Lists colors and levels of shaded contoursstring str
Returns the width of string str
time
Returns info about time settingsudft
Returns the user defined function tablexinfo
Returns characteristics of the graphics display windowxy2w v1 v2
Converts XY coords to world coordsxy2gr v1 v2
Converts XY coords to grid coordsw2xy v1 v2
Converts world coords to XY coordsw2gr v1 v2
Converts world coords to grid coordsgr2w v1 v2
Converts grid coords to world coordsgr2xy v1 v2
Converts grid coords to XY coordspp2xy v1 v1
Converts virtual page XY coords to real page XY coords
For more information on the use of the query
command, see
the section of the User's Guide on commands that complement the scripting
language.