cafeplotpanel

           plots data/model of fit in single panel

           cafe

           plot

           cafeplotpanel, panel ,group,position=position,
                          cursor=cursor,
                          range=range

           panel    - Defines the panel number from environment to
                      draw in current window.
           group    - Define the data group to plot.
                      Must be in range [0..9].
           position - 4-vector containing edge coordinates
                      of panel to plot. Coordinates are values
                      between 0..1.
           cursor   - Input information about current cursor position
                      in data coordinates. Must be 2-element vector
                      [Xpos,Ypos].

           range    - 6-dim double array. It defines best matching
                      ranges for data/values to display. The elements
                      are defined as follow:
                          0 - xmin
                          1 - xmax
                          2 - ymin
                          3 - ymax
                          4 - zmin  (for 3-d plots only)
                          5 - zmax  (for 3-d plots only)
                      This range is necessary to export a common
                      range for different panels (usually the x-range
                      must be the same for stacked plots).
                      From this range the x/y/z ranges are taken if
                      not defined with inputs above.
                      The elements should be preset with values
                      [infty,-infty].
           closest  - Information about closest data point to
                      cursor. This is an anonymous record with
                      following entries:
                       DIST     - currently used best distance from cursor.
                       GROUP    - group number of group containing
                                  closest  data point
                       SUBGROUP - Subgroup number of closest data point.
                       NUM      - Number of closest data point.
                       X        - X position of closest data point.
                       Y        - Y position of closest data point.

           The plots to be inserted in panels are defined
           with plot types defining what to plot. There
           are some plot types available (and could be
           extended just as in case of fit models).
           Syntax:
                 <plot type>:group...+:group

                 > cafeplotpanel, data+model...
                   -> Draw data and model in the same panel.
                 > cafeplotpanel,data:2+data:3
                   -> Draw data from group 2,3 to panel.
                 The "+" adds several plot types in the same
                 panel. In this case each will be drawn in a
                 different color (refer also to the plot types
                 itself).
                 The optional ":<group>" defines the group for
                 the specific plot type to look data/model for.
                 Common plot types are
                  "data" - draw the data as is
                  "model"- draw the computed model with
                            current parameters
                   "res" - Residuum between data/model
                "delchi" - Same but in units of 1 sigma

           quiet - do not plot but determine range only.

           None

           $Id: cafeplotpanel.pro,v 1.35 2005/01/04 14:04:53 goehler Exp $
 $Log: cafeplotpanel.pro,v $
 Revision 1.35  2005/01/04 14:04:53  goehler
 fix: proper header
 Revision 1.34  2004/07/30 15:52:36  goehler
 change: allow a position keyword to arbitrary move a plot in the displayed field.
 Revision 1.33  2003/11/10 12:44:36  goehler
 fix: apply psym change only when deltapsym is actually set
 Revision 1.32  2003/11/06 10:24:01  goehler
 fix: allow "_" in keywords also
 Revision 1.31  2003/11/05 14:38:53  goehler
 fix: allow numeric parameter keyword also
 Revision 1.30  2003/11/05 10:04:50  goehler
 fix: allow improper written plot type parameters to be recognized for
 double occurence.
 Revision 1.29  2003/11/05 09:03:10  goehler
 fix: handle x/y/z range as normal parameters thus avoiding double
 parameters (e.g. in case of calling wplot)
 Revision 1.28  2003/11/05 08:45:42  goehler
 VERSION 5.0:
 Streamlined handling of plot approach: do not use the _EXTRA keyword
 to pass parameter to cafeplotpanel procedure (refer plot) but build
 and entire plot parameter string which takes into account parameter precedence:
 1.) local parameters (given in [param...] to plot types)
 2.) global parameters (defined with setplot,key=val)
 3.) intrinsic settings like color change, line style change etc.
 Also removed double execute procedure (once in cafe_plot, the other in
 cafeplotpanel).
 Additionally the frame drawn is handled as a normal plot type which will be set
 by default. This allows multiple frame drawing, post-2d-shade frame etc.
 Revision 1.27  2003/06/23 08:15:57  goehler
 removed spurious /add
 Revision 1.26  2003/06/16 08:55:17  goehler
 added major task: information about currently used plot type is written
                   into the plot.legendinfo environment structure list.
                   This information is used by the legend type "data" which
                   displays information about the different plotted lines.
 Also added: _EXTRA setting of PSYM entry with cafeaddextrakey function,
             new plot when legend will change
             add/remove facility for legends
             legend show type
 Revision 1.25  2003/06/03 16:13:40  goehler
 beta state: added possibility to retrieve information
 about closest data point to cursor in wplot. This includes selecting
 of correct plot panels. Not extensively tested.
 Revision 1.24  2003/05/13 09:37:16  goehler
 added tex setplot parameter which helps to access mathematical symbols.
 Revision 1.23  2003/05/07 08:18:57  goehler
 fixes:
 - addition of models simplified
 - x ranges now bound together
 Revision 1.22  2003/05/05 09:22:59  goehler
 changed scheme of representing pannels:
 - /add deleted
 - added possibility to set each panel via number
 - added +add/-remove facility
 - added linestyle/psym change facility for different lines
 Revision 1.21  2003/04/28 07:38:15  goehler
 moved parameter determination into separate function cafequotestr
 Revision 1.20  2003/03/03 11:18:34  goehler
 major change: environment struct has become a pointer -> support of wplot/command line
 in common.
 Branch to be able to maintain the former line also.
 Revision 1.19  2003/02/12 12:44:42  goehler
 added proper range setting
 Revision 1.18  2003/02/11 17:25:59  goehler
 improved axis display
 Revision 1.17  2003/02/11 15:54:02  goehler
 removed debug print
 Revision 1.16  2003/02/11 15:03:35  goehler
 added gauss model, and method to plot models.
 Revision 1.15  2002/09/19 14:02:38  goehler
 documentized
 Revision 1.14  2002/09/10 13:24:36  goehler
 updated name convention:
 - the command name for all commands
 - the command name + "_" + subcommand name for all subcommands
 Revision 1.13  2002/09/10 13:06:47  goehler
 removed ";-" to make auxilliary routines invisible
 Revision 1.12  2002/09/09 17:36:20  goehler
 public version: updated help matching aitlib html structure.
 common version: 3.0

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