[AIT logo]

Institut für Astronomie und Astrophysik

Abteilung Astronomie

Sand 1, D-72076 Tübingen, Germany
[Uni logo]


plot_data2 Source code in cafe_plot_data2.pro

plot_data2

Name
           plot_data2
Purpose
           plot 2-d data as is
Category
           cafe
SUBCATEGORY:
           plot type
Input Parameters
           group    - (optional) Define the data group to plot.
                      Default is the current group. Must be in
                      range [0..29].
PLOT OUTPUT:
           data2    - plots the data of group given . X/Y ranges are
                      kept. Undefined points are not plotted by default.
                      No subgroup distinction will be performed (the
                      data points are plotted together).
SETPLOT KEYWORDS:
           Apart from IDL shade_surf/surface keywords following special
                      are defined:
           shade    - Plot a shaded surface instead surface mesh.
                      USING THIS OPTION WILL CLEAR ALL FORMER
                      DRAWINGS!
          polyshade - Plot a shaded surface. Instead of shade the data
                      will be plot as polygons with their
                      positions. Usefull for very irregulary gridded
                      data. Uses polyshade internally.
                      USING THIS OPTION WILL CLEAR ALL FORMER
                      DRAWINGS!
           surf     - Plot a surface mesh. (default)
           trisurf  - Plot a surface mesh consisting of
                      triangles. The advantage in respect of surf is
                      that (as in polyshade) the actual data point position is
                      taken into account. The disadvantage is that no
                      hidden line removal is performed, and plotting
                      takes a long time for larger data sets.
                      Triangles with orientations normal pointing not
                      to the observer are not displayed (simplest
                      form of hidden line removal)
           contour  - Plot a contour plot.
           isolines - Plot on shade/surface isolevel contour lines
                      (disable contour zvalue).
                 tv - Plot pixel in a plane. Internally the procedure
                      polyfill is used. This keyword works with zbuff
                      only. Use the shading keyword to define the
                      color distribution.
         gridspacing- Two component vector defining the grid spacing
                      in x and y direction (refer TRIGRID, keyword
                      GS).
         gridlimits - Four component vector defining the grid
                      boundary as [x0,y0,x1,y1] (refer TRIGRID,
                      keyword limits).
           shading  - Expression string which defines how to color
                      encode shaded plots. Applicable for
                      shade/polyshade modes only. The expression
                      string may be any arithmetic
                      expression. Special keywords are 'x', 'y' and
                      'z' which will be used.
                      The expression will be applied to all (x,y)
                      pairs used in given grid. Default is the
                      built-in light source shading (refer shades
                      keyword for shade_surf procedure).
                      The result of the expression should be within
                      0..1 (assuming that x,y,z are in this range
                      also).
Example
                      > plot,data2[shading=z]
                      -> color encode z values
                      > plot,data2[shading=x*y]
                      -> color encode diagonal to x/y (less usefull)
                      > plot,data2[shading=100]
                      -> monochrome shading
           undefined- Plot undefined data points also. Useful for
                      closer inspection.
           noselect - Do not mark selected data points. Useful for
                      final plot.
           norange  - Do not compute range (auxiliary data). Should
                      not be used if single plot type.
        deltacolor  - Color difference for distinct data sets.
        selectcolor - Color for selected data points.
        undefcolor  - Color for undefined data points.
     deltalinestyle - Increase of line styles for distinct data
                      sets. Default: 0 (no change).
          deltapsym - Increase of point symbols for distinct data
                      sets. May be positive or negative
                      integer number. Default: 0 (no change).
                      If psym exceeds -7..7 it will be set at 0 (no
                      symbol). Therefore it is recomended to
                      plot data sets with lines with a negative
                      deltapsym (to decrease and restart from 0).
Side Effects
           None.
Example
           > data, bla.dat,dat2
           > plot, data2
                -> 2-dim data is displayed as shaded.
Revision History
           $Id: cafe_plot_data2.pro,v 1.26 2004/07/30 17:17:25 goehler Exp $

Last modified by pro2html on 2005 January 04 at 16:14 UTC

[Home Page] [Software, Documentation] [IDL Documentation] [Quick Reference] [Feedback]

Jörn Wilms (wilms@astro.uni-tuebingen.de)
Updated automatically