[AIT logo]

Institut für Astronomie und Astrophysik

Abteilung Astronomie

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


plot_model2 Source code in cafe_plot_model2.pro

plot_model2

Name
           plot_model2
Purpose
           plot 2-d model over existing data
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:
           model2   - 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
                 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,model2[shading=z]
                      -> color encode z values
                      > plot,model2[shading=y*z]
                      -> color encode diagonal to y/z (less usefull)
                      > plot,model2[shading=200]
                      -> monochrome red shading
           undefined- Plot model for undefined data points also. Useful for
                      closer inspection. (No color distinction to
                      defined data points)
           selected - Plot model for selected datapoints only.
           norange  - Do not compute range (auxiliary data). Should
                      not be used if single plot type.
        modelrange  - Perform range determination for model size also
                      (if range is not required anyway because still
                      not defined).
        deltacolor  - Color difference for distinct data sets.
     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).
        selectcolor - Color for selected data points.
Side Effects
           None.
Example
           > data, bla.dat,dat2
           > plot, model2
                -> 2-dim data is displayed as shaded.
Revision History
           $Id: cafe_plot_model2.pro,v 1.18 2004/07/30 17:17:26 goehler Exp $

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

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

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