[AIT logo]

Institut für Astronomie und Astrophysik

Abteilung Astronomie

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


plot_datascal Source code in cafe_plot_datascal.pro

plot_datascal

Name
           plot_datascal
Purpose
           plot data with the possibility to shift/scale the plot in
           X/Y direction.
Category
           cafe
SUBCATEGORY:
           plot type
Input Parameters
           group    - (optional) Define the data group to plot.
                      Default is current group. Must be in
                      range [0..29].
PLOT OUTPUT:
         datascal   - plots the data of group given. According
                      setplot keywords xoffset,yoffset,xscal,yscal
                      the plot is shifted/scaled in X/Y direction.
                      X/Y ranges are kept from unscaled/unshifted
                      data set. Undefined points are plot but not
                      connected. Error bars also will be drawn if not
                      inhibited (s.b.).
SETPLOT KEYWORDS:
           Apart from IDL oplot keywords following special
                      are defined:
           xoffset  - Add this value to all x values when
                      plotting. Changing this keyword does not affect
                      range determination. Default: 0.
           yoffset  - Add this value to all y values when
                      plotting. Changing this keyword does not affect
                      range determination.  Default: 0
           xscal    - Multiply all x values with this factor (before
                      applying xoffset). Changing this keyword does
                      not affect range determination. Default: 1.
           yscal    - Multiply all y values with this factor (before
                      applying yoffset). Changing this keyword does
                      not affect range determination. Default: 1.
           noerror  - Do not plot error bars. This is useful for
                      tight data sets.
       undefined    - Plot undefined data points. 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.
           gaps     - Do not connect datapoints which are gaps in
                      respect of a regular x base. It is assumed that
                      the periodicity is defined by x[1] - x[0].
           gaptol   - Defines above which x difference gaps are
                      recognized. Must be given in units of binning
                      width=x[1] - x[0]. Default is 0.1 = 10%.
           distinct - Plot each subgroup file with a different
                      color.
           xbin     - Plot bin width of each data point. If no dx
                      column is given the half distance between two
                      data points is used.
     witherrorrange - Include error ranges into range determination.
        selectcolor - Color for selected data points.
        undefcolor  - Color for undefined data points.
        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).
Side Effects
           None.
Example
           > setplot,xoffset=1
           > plot, data+datascal:1
                -> data in current group is overlaid with data from
                group 1 shifted by x=x+1.
Revision History
           $Id: cafe_plot_datascal.pro,v 1.4 2004/07/30 17:17:26 goehler Exp $

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

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

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