Overview   Directory   Index   Search   File   Source   Help   Etc 
   
A package to generate Postscript plots with IDL
Developer Documentation
 prev file | next file          view single page | view frames | update routines
SUMMARY: fields | routine          DETAILS: routine

.
multigraph.pro

Last modification date:
Sat May 11 11:42:47 2013
Statistics:
595 lines of code

MULTIGRAPH

procedure MULTIGRAPH, psname, g1[, g2][, g3][, g4][, g5][, g6][, g7][, g8][, g9][, g10][, g11][, g12][, g13][, g14][, g15][, g16][, g17][, g18][, g19][, g20][, g21][, g22][, g23][, g24][, g25][, g26][, g27][, g28][, g29][, g30][, g31][, g32][, g33][, g34][, g35][, g36][, g37][, g38][, g39][, g40][, g41][, g42][, g43][, g44][, g45][, g46][, g47][, g48][, g49][, g50][, g51][, g52][, g53][, g54][, g55][, g56][, g57][, g58][, g59][, g60][, g61][, g62][, g63][, g64][, g65][, g66][, g67][, g68][, g69][, g70][, g71][, g72][, g73][, g74][, g75][, g76][, g77][, g78][, g79][, g80][, g81][, g82][, g83][, g84][, g85][, g86][, g87][, g88][, g89][, g90][, g91][, g92][, g93][, g94][, g95][, g96][, g97][, g98][, g99][, g100], [MULTI=structure], [/QUIET], [VAR=structure]

MULTIGRAPH is a wrapper that generates multiplot PostScript files. It can be used with SINGLEPLOT, SINGLECONTOUR, or with any other IDL procedure. See the full procedure

Examples 

  A simple call to MULTIGRAPH is:
   x1    = FINDGEN(101)
   y1    = x1 + x1^2 - 0.01*x1^3 + 10*RANDOMN(seed,101)
   x     = -50. + FINDGEN(101)
   y     = 100. + FINDGEN(51)
   xx    = x # (1.+FLTARR(51))
   yy    = (1.+FLTARR(101)) # y
   f     = 5*(SIN(0.08*xx)*SIN(0.12*yy))^2+5*(SIN(0.05*(xx+yy)))^2 + 0.3*RANDOMN(seed,101,51)
   g1    = {type:'singlecontour', v1:{f:f}}
   g2    = {type:'singleplot',    v1:{x:x1, y:y1}}
   MULTIGRAPH, "test15a.ps", g1, g2
  See the jmaplot tutorial for additional examples.
Version
v. 3.1, 11 May 2013.
History 
                                                        

  v0.1: V1 to V5 variables and PASSIJ variables introduced.              
        LANDSCAPE flag introduced.                               
  v1.0: General clean up.                                                
  v1.1: Default values for CFILE and CTABLE become 'colorjma.tbl' and    
         37, respectively.                                               
  v2.0: English version.
  v2.1: IDLdoc documentation.
        CTABLE incompatibilities eliminated.
        Variables are received by auxiliary files always using _REF_EXTRA.
         This makes PASSIJ obsolete and allows for the easy inclusion of up
         to V9, but produces an incompatibilty with previous auxiliary
         procedures which is easily solved by adding ',_REF_EXTRA=ref_extra'
         to their definitions.
        Fix to the small font problem when using MULTIGRAPH (NPX).
  v2.2: OPENHTML introduced.
        Upgrade to IDLdoc documentation.
  v2.3: To ensure compatibility, use _EXTRA instead of _REF_EXTRA.
        I and J changed to II and JJ due to keyword problems with CONTOUR.
        Windows compatibility enhanced.
  v2.4: Error with _EXTRA fixed. 
  v2.5: Version system update.
        QUIET flag added.   
  v3.0: Full reprogramming: previous syntax obsolete. 
        Use of structures and adaptation to SINGLEPLOT and SINGLECONTOUR changes.
        Full positioning control.
        Need for auxiliary procedures eliminated.
        New wagoncircle mode.
        CMYK PS output added.
        HTML pages moved to local directory.
        General changes.       
  v3.1: Only version change.
Author
Jesús Maíz Apellániz, IAA
Statistics
Lines of code  595
McCabe Cyclomatic Complexity metric   84
McCabe Essential Complexity metric   1
McCabe Module Design Complexity metric   1

Parameters
psname
in, required
string 		Postscript file name.
g1
in, required
structure 		First graph structure. Possible tags: 
           TYPE:      Required string. It can be 'singleplot', 'singlecontour', or
                       any call to a valid IDL procedure.
           V1:        (First) data structure for SINGLEPLOT and SINGLECONTOUR.
           V1...V60:  Additional graph structures for SINGLEPLOT.
           ...:       The rest of the SINGLEPLOT/SINGLECONTOUR keywords.
g2
in, optional
structure 		Additional graph structure. See g1 for tags.
g3
in, optional
structure 		Additional graph structure. See g1 for tags.
g4
in, optional
structure 		Additional graph structure. See g1 for tags.
g5
in, optional
structure 		Additional graph structure. See g1 for tags.
g6
in, optional
structure 		Additional graph structure. See g1 for tags.
g7
in, optional
structure 		Additional graph structure. See g1 for tags.
g8
in, optional
structure 		Additional graph structure. See g1 for tags.
g9
in, optional
structure 		Additional graph structure. See g1 for tags.
g10
in, optional
structure 		Additional graph structure. See g1 for tags.
g11
in, optional
structure 		Additional graph structure. See g1 for tags.
g12
in, optional
structure 		Additional graph structure. See g1 for tags.
g13
in, optional
structure 		Additional graph structure. See g1 for tags.
g14
in, optional
structure 		Additional graph structure. See g1 for tags.
g15
in, optional
structure 		Additional graph structure. See g1 for tags.
g16
in, optional
structure 		Additional graph structure. See g1 for tags.
g17
in, optional
structure 		Additional graph structure. See g1 for tags.
g18
in, optional
structure 		Additional graph structure. See g1 for tags.
g19
in, optional
structure 		Additional graph structure. See g1 for tags.
g20
in, optional
structure 		Additional graph structure. See g1 for tags.
g21
in, optional
structure 		Additional graph structure. See g1 for tags.
g22
in, optional
structure 		Additional graph structure. See g1 for tags.
g23
in, optional
structure 		Additional graph structure. See g1 for tags.
g24
in, optional
structure 		Additional graph structure. See g1 for tags.
g25
in, optional
structure 		Additional graph structure. See g1 for tags.
g26
in, optional
structure 		Additional graph structure. See g1 for tags.
g27
in, optional
structure 		Additional graph structure. See g1 for tags.
g28
in, optional
structure 		Additional graph structure. See g1 for tags.
g29
in, optional
structure 		Additional graph structure. See g1 for tags.
g30
in, optional
structure 		Additional graph structure. See g1 for tags.
g31
in, optional
structure 		Additional graph structure. See g1 for tags.
g32
in, optional
structure 		Additional graph structure. See g1 for tags.
g33
in, optional
structure 		Additional graph structure. See g1 for tags.
g34
in, optional
structure 		Additional graph structure. See g1 for tags.
g35
in, optional
structure 		Additional graph structure. See g1 for tags.
g36
in, optional
structure 		Additional graph structure. See g1 for tags.
g37
in, optional
structure 		Additional graph structure. See g1 for tags.
g38
in, optional
structure 		Additional graph structure. See g1 for tags.
g39
in, optional
structure 		Additional graph structure. See g1 for tags.
g40
in, optional
structure 		Additional graph structure. See g1 for tags.
g41
in, optional
structure 		Additional graph structure. See g1 for tags.
g42
in, optional
structure 		Additional graph structure. See g1 for tags.
g43
in, optional
structure 		Additional graph structure. See g1 for tags.
g44
in, optional
structure 		Additional graph structure. See g1 for tags.
g45
in, optional
structure 		Additional graph structure. See g1 for tags.
g46
in, optional
structure 		Additional graph structure. See g1 for tags.
g47
in, optional
structure 		Additional graph structure. See g1 for tags.
g48
in, optional
structure 		Additional graph structure. See g1 for tags.
g49
in, optional
structure 		Additional graph structure. See g1 for tags.
g50
in, optional
structure 		Additional graph structure. See g1 for tags.
g51
in, optional
structure 		Additional graph structure. See g1 for tags.
g52
in, optional
structure 		Additional graph structure. See g1 for tags.
g53
in, optional
structure 		Additional graph structure. See g1 for tags.
g54
in, optional
structure 		Additional graph structure. See g1 for tags.
g55
in, optional
structure 		Additional graph structure. See g1 for tags.
g56
in, optional
structure 		Additional graph structure. See g1 for tags.
g57
in, optional
structure 		Additional graph structure. See g1 for tags.
g58
in, optional
structure 		Additional graph structure. See g1 for tags.
g59
in, optional
structure 		Additional graph structure. See g1 for tags.
g60
in, optional
structure 		Additional graph structure. See g1 for tags.
g61
in, optional
structure 		Additional graph structure. See g1 for tags.
g62
in, optional
structure 		Additional graph structure. See g1 for tags.
g63
in, optional
structure 		Additional graph structure. See g1 for tags.
g64
in, optional
structure 		Additional graph structure. See g1 for tags.
g65
in, optional
structure 		Additional graph structure. See g1 for tags.
g66
in, optional
structure 		Additional graph structure. See g1 for tags.
g67
in, optional
structure 		Additional graph structure. See g1 for tags.
g68
in, optional
structure 		Additional graph structure. See g1 for tags.
g69
in, optional
structure 		Additional graph structure. See g1 for tags.
g70
in, optional
structure 		Additional graph structure. See g1 for tags.
g71
in, optional
structure 		Additional graph structure. See g1 for tags.
g72
in, optional
structure 		Additional graph structure. See g1 for tags.
g73
in, optional
structure 		Additional graph structure. See g1 for tags.
g74
in, optional
structure 		Additional graph structure. See g1 for tags.
g75
in, optional
structure 		Additional graph structure. See g1 for tags.
g76
in, optional
structure 		Additional graph structure. See g1 for tags.
g77
in, optional
structure 		Additional graph structure. See g1 for tags.
g78
in, optional
structure 		Additional graph structure. See g1 for tags.
g79
in, optional
structure 		Additional graph structure. See g1 for tags.
g80
in, optional
structure 		Additional graph structure. See g1 for tags.
g81
in, optional
structure 		Additional graph structure. See g1 for tags.
g82
in, optional
structure 		Additional graph structure. See g1 for tags.
g83
in, optional
structure 		Additional graph structure. See g1 for tags.
g84
in, optional
structure 		Additional graph structure. See g1 for tags.
g85
in, optional
structure 		Additional graph structure. See g1 for tags.
g86
in, optional
structure 		Additional graph structure. See g1 for tags.
g87
in, optional
structure 		Additional graph structure. See g1 for tags.
g88
in, optional
structure 		Additional graph structure. See g1 for tags.
g89
in, optional
structure 		Additional graph structure. See g1 for tags.
g90
in, optional
structure 		Additional graph structure. See g1 for tags.
g91
in, optional
structure 		Additional graph structure. See g1 for tags.
g92
in, optional
structure 		Additional graph structure. See g1 for tags.
g93
in, optional
structure 		Additional graph structure. See g1 for tags.
g94
in, optional
structure 		Additional graph structure. See g1 for tags.
g95
in, optional
structure 		Additional graph structure. See g1 for tags.
g96
in, optional
structure 		Additional graph structure. See g1 for tags.
g97
in, optional
structure 		Additional graph structure. See g1 for tags.
g98
in, optional
structure 		Additional graph structure. See g1 for tags.
g99
in, optional
structure 		Additional graph structure. See g1 for tags.
g100
in, optional
structure 		Additional graph structure. See g1 for tags.

Keywords
MULTI
in, optional
structure 		Structure used to supress default values. The possible tags are: 
           FREE:        Flag for free positioning mode. If activated,
                         xc, yc, xcenter, ycenter) in each graph are normalized
                         with respect to the full PS file.
           BOXES:       4xngraphs float array with the xleft, ydown, xright, yup
                         normal coordinates to place the graphs. Note that 
                         xc, yc, xcenter, ycenter in each graph are normalized
                         to these boxes if FREE is not activated.
           XYN:         2-D array with the number of graphs in the x and y direction
                         that overrides the default choice. Ignored if FREE is
                         activated.
           ASPECT:      By default, each graph has an aspect ratio of 1.0. In order
                         to change this, set aspect to:
                          >0.0: The value of the aspect ratio of each graph.
                          =0.0: In this case, the aspect ratio is determined from 
                                 the ratio of yrange to xrange in the first graph.
                          <0.0: -1.0 x the aspect ratio of the PS file.
                         Note that the aspect ratio of the graph that is being
                         determined is that of its box. However, unless xc or yc
                         are specified, that is also the aspect ratio of the 
                         graph itself.
           WAGONCIRCLE: Flag (0/1) or value (0.01-0.50) for wagon circle mode.
                         It overrides axes styles and graph positions (xc, yc,
                         xcenter, ycenter). Ignored if FREE is activated.
           ALIGN:       Graph alignment flag. Ignored if FREE is activated.
           LANDSCAPE:   Flag for landscape mode.
           CMYK:        Flag to generate CMYK PS output.
           TITLE:       Main title.                       
           TITLEMARGIN: Title margin in normal units (default: 0.05).                       
           TITLEFONT:   Title font size.
QUIET
in, optional
boolean (def. FALSE) 		Flag to supress informational messages.
VAR
in, optional
structure 		Input structure to pass additional variables.

Personal IDL library of Jesús Maíz Apellániz, Ramón y Cajal Fellow, Instituto de Astrofísica de Andalucía.
Feel free to contact me for more information about these routines or to submit a bug report or a feature request.
Produced by IDLdoc 1.6 beta on Fri Jun 28 22:22:42 2013