Getting Started Documentation Glish Learn More Programming Contact Us
Version 1.9 Build 1367
News FAQ
Search Home


next up previous
Next: What's Next Up: No Title Previous: Linear and Non-Linear Algebra Methods and Objects

Ancillary Methods for Basic Data Objects

While one can view data display as separate from data processing, there is great programming power in having a set of simple display, and display-interaction, methods operating on basic data objects. These ancillary methods are very important in allowing flexible prototyping of higher level display, editing, etc., methods.

Mathematical data processing is inseparable from interaction with, and display of, original, intermediate, and resulting data objects. Methods for displaying basic data objects like mvector, mmatrix, marray, and grid, and some capability to identify and locate the names or locations of data points in displays allows the programmer to provide powerful means for intervening in the data processing process. In Table 7 we list some of the useful, generic or special, methods. There is a wide range of parameters controlling the displays and interactions that we will mostly not discuss in detail in this document. Some deal with parameters of each method, and some deal with general parameters of displays that control size, windowing, labeling, tic marks, axis label values, etc.

                            Table 7
        Methods for Displaying and Interacting With Basic Data Objects
        Input
Name    Object(s)                       Role
plot    V          Make x-y plot of vector elements vs its indices
plot    V1,V2      Make x-y plot of V2 vs V1
plot    M          Make x-y plot of matrix values in an x-y grid
                   determined by matrix indices
plot    M,V1,V2    Make x-y plot of matrix values in an x-y grid
                   determined by supplied ``coordinate'' vectors
hist    V[,V]      Plot a histogram for a vector as a function of
                   is index or an a ``coordinate'' vector
picture M          Make monochrome or color display of matrix
                   in an x-y grid determined by matrix indices
picture M,V2,V2    Make monochrome or color display of matrix
                   in an x-y grid determined by supplied
                   ``coordinate'' vectors
legend             Add ``legend'' to picture display indicated
                   mapping of gray scale or color into pixel values
contour M          Make contour display of matrix in an x-y grid 
                   determined by matrix indices
contour M,V2,V2    Make contour display of matrix in an x-y grid 
                   determined by supplied ``coordinate'' vectors
perspec M          Make perspective or ruled surface display of 
                   matrix in an x-y grid determined by matrix indices,
                   with or without hidden line removal, with
                   specified or default view angle parameters
perspec M,V2,V2    Make perspective or ruled surface display of 
                   matrix in an x-y grid determined by supplied 
                   ``coordinate'' vectors
locate             For a specified plot or picture in a display
                   window, starts a mouse and mouse-button driven
                   procedure for clicking cursor (on/near) a data
                   point allowing return of ``matrix'' value and
                   x-y coordinates which are highlighted and added
                   row by row to a matrix of identified value-x-y
                   vectors; using one button for locating, and
                   another button for removing a previously 
                   located data vector; requires display boxes
                   in border area that one can click on to change
                   size of locator box, exit from the locate method,
                   or change other obvious parameters of the process
identify           Similar to locate, however one gets either or
                   both row and column names from the matrix displayed
                   next to the select data point
specdisp M[,V]     monochrome or color displays of rows and/or columns
                   of vector/matrix data values as a function of row/column
                   indices; with locate and identify methods invocable
                   once the bands are displayed
                   (allows TVFLAG-like display and interaction with
                   basic data objects)
specdisp M[,V],V1  Same as above but supplied coordinate vector is
                   used for the independent variable in a band-like
                   display with monochrome or color coded data values
                   as a function of an independent variable which is
                   an index or a ``coordinate'' vector
rotate   A         Initiate an interactive 3-d display of 3-D array values
                   as points in a 3-D space with respect to displayed
                   and labeled (from array axis names) axes in
                   array index form, with pressing a mouse button 
                   on boxes labeled right, left, circle, up, down, 
                   causing the displayed data points and axes to 
                   change their 3-D viewing angle
rotate  V1,V2,V3   same as above but x,y,z vectors are supplied
rotfind A          adds to a rotate method capabilities to locate and
                   identify data values as discussed above for the
                   locate and identify methods
rotfind V1,V2,V3   same as above but x,y,z vectors are supplied
reshow  C          redisplay previously saved display object on disk
movie   C          display movie sequence of previously saved
                   display objects stored on disk
panel   C          display sequence of objects on disk in paneled
                   sub-windows
The reshow, movie, and panel methods require saving display objects.

Each display windows should have buttons bringing up menus that

or one could have command line methods that carry out these functions; however, if one is in a window display domain, these functions are best handled with buttons/menus associated with these windows.

The identify and locator methods, or others allowing display and return of data coordinates can be used to build graphical editing capabilities for both basic data objects and higher level displays of spectal, u-v, etc., data; however, the latter are beyond the level of things useful for basic data objects.


next up previous
Next: What's Next Up: No Title Previous: Linear and Non-Linear Algebra Methods and Objects
Please send questions or comments about AIPS++ to aips2-request@nrao.edu.
Copyright © 1995-2000 Associated Universities Inc., Washington, D.C.

Return to AIPS++ Home Page
2006-03-28