GDDM-PGF V2R1.3 Application Programming Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF | BOOK


Tower charts

GDDM-PGF V2R1.3 Application Programming Guide
SC33-0913-01



Tower charts are three-dimensional bar charts with numeric x axes. In addition to the x and y axes, they have a z axis. This is drawn as if perpendicular to the x,y plane. Each data value is represented by the height of a three-dimensional tower. Each component is drawn at a specified z value. Tower charts are sometimes called Manhattan or skyscraper charts.

The calls and options that affect tower charts are listed below. The default options are shown first:


     CHTOWR                            Plots the tower chart
     CHSET
      'BACK'|'NOBACK'                  Back planes
      'BGBASE'|'TCBASE'                Background or tower-chart color
      'FILL'|'INFILL'|'NOFILL'         Method of shading
      'PGFS'|'NPGFS'                   Numeric values punctuated
      'SCALETOWER'|'NOSCALETOWER'      Scale tower to be drawn
      'SIDE'|'NOSIDE'                  Side planes to be drawn
      'TOWERTICK'|'NOTOWERTICK'        Major tick marks to be drawn
      'ZPICK'|'XPICK'                  Pick attributes according to
                                        tower position on Z or x axis
     CHZSET
      'AXIS'|'NOAXIS'                  Axis drawn
      'GRID'|'NOGRID'                  Grid drawn
      'NTICK'|'PTICK'|'XTICK'|'PLAIN'  Tick-mark style
      'NUMERIC'|'ALPHANUMERIC'         Type of label
     CHPAT                             Shading-pattern table values
     CHCOL                             Basic color table for shading
     CHLC                              Line-color table
     CHLT                              Line-type table
     CHLW                              Line-width table
     CHTPRJ                            Set projection for next tower
                                        chart

Here is a typical specification for a tower chart:


     DCL X_DATA(5)  FLOAT DEC(6) INIT(1.1, 2.6, 3.3, 4.9, 7.7);
     DCL Y_DATA(20) FLOAT DEC(6) INIT( 31,  65,  97,  11,  21,
                                       88,  10,  98,  98,   3,
                                       43,  40,  67,  23,  54,
                                       94,  35,  59,  83,  43);
     DCL Z_DATA(4) FLOAT DEC(6) INIT(1,3,4,6);

CALL CHTOWR(1,4,5,Z_DATA,X_DATA,Y_DATA);

The first parameter to the CHTOWR call is not used by PG routines; it must be 0 or 1. The second parameter specifies, in this example, that there are four different z values - four components, in other words. The third parameter states that each component has five data values. The remaining parameters are the z, x, and y values.

Subtopics:

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012