home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / apps / math / bstat247 / graph.doc < prev    next >
Text File  |  1993-04-09  |  25KB  |  520 lines

  1.                     GRAPHICS
  2.  
  3. Graph menu
  4.  
  5. The REGULAR selection will graph the data with the labels you have
  6. entered in the data entry area along the "X" axis. The type of
  7. graph will depend on the selections you have made in the "styles"
  8. area. Up to 12 variables may be chosen. You may plot some against
  9. the left axis and some against the right axis. 
  10.  
  11. -HORIZONTAL graphs put the labels on the "Y" axis and the
  12. values along the "X". You can not have a right side axis for this
  13. type of graph.
  14.  
  15. -"XY" graphs allow up to 12 pairs of variables to be used. You must
  16. select your data a pair at a time. The first one chosen of each
  17. pair will be the "X" value of the point and the second will be the
  18. "Y". You may repeat the same selection between pairs so that you
  19. can have several variables graphed against the same "X". There are
  20. no XY bar graphs. You can not have a right side axis.
  21.  
  22. -Histogram. Allows for up to 12 variables although usually used with 
  23. just one. This graph type is like an XY in terms of look. The 
  24. variable chosen sets the limits for the "X" axix. The Y axis is 
  25. the count of values in each range. You establish the ranges by 
  26. telling the program how many bars which you wish to see. The 
  27. program then divides the X axis into that many ranges and counts 
  28. the number of points in each variable in that range. These totals 
  29. are then displayed as bar charts. You are limited to 100 bars on 
  30. screen. If you select 2 variables then you are asked if the 
  31. second variable is a count variable. This allows you to have 
  32. partially grouped data.
  33.  
  34. -HI LO graphs are stock market graphs. The first 3 variables chosen
  35. will be displayed as a high low close type of graph. The remainder
  36. of the 12 possible graphs will be shown as selected on the styles
  37. section. You can use right side axis which allows you to graph
  38. volume on the same graph as stock  prices. You can have a hi low
  39. graph with only 2 variables. In this case the data represents
  40. simply a high and low but no close.
  41.  
  42. -PIE CHARTS. You may have up to 4 pies on the screen. Simply 
  43. specify the correct number of variables. A special case exists for
  44. 2 pie charts if you have selected "component pies" from the
  45. features menu. In this case the second variable will be assumed to
  46. be an explosion of the first pie segment. 
  47.  
  48. -3D PIE CHARTS are the same as regular pie charts except for the 3D
  49. aspect.
  50.  
  51. -BUBBLE GRAPHS require 3 or more variables to be chosen. 
  52. The first specifies the "X" value of the point. The second 
  53. specifies the "Y" value of the point and the third specifies 
  54. the relative  area of the bubble. If more than 3 variables are 
  55. chosen the remaining variables are used to create a pie chart 
  56. inside the bubble.
  57.  
  58. -OPPOSED  BARS  require 2 variables  which  must  be positive. If
  59. logs are on they are ignored. Opposed bars  are good for comparing
  60. similar  data  against one another.  an example might be the
  61. population of the  U.S.A.   by  age  group where  one   variable
  62. represents  males  and  another females.  The  key feature of
  63. opposed bars is that there is no  offset between  the  variables. 
  64. One  peculiarity  of the implementation  comes up in rescaling. 
  65. The  second variable  is  treated  as  being  negative  by  the
  66. program. Thus  the  minimum value is  shown  as  a negative.  This
  67. is a requirement so ensure that you enter  a negative for the
  68. minimum,  even though  it will be printed as a positive.
  69.  
  70. -FLOATING  BARS  require 2 variables for each  bar plotted. The 
  71. first represents the minimum of the floating bar and the second the
  72. top. Like XY graphs you will continue to be prompted for input 
  73. until you  fail to enter 2 variables.
  74. This is not an  XY graph however. The X-axis is scaled by the
  75. labels just as for a regular graph.
  76.  
  77. -HORIZONTAL  FLOATING BARS are the same  as  regular floating bars 
  78. except that the graph is done horizontally.
  79.  
  80. -POLAR PLOTS are a variation on XY graphs. Selection procedures are
  81. the same. The difference is that the variables chosen give the
  82. angle in radians and distance of the point rather than "X" and "Y"
  83. respectively.
  84.  
  85. -3D BAR/LINE allow for up to 40 points in each factor. The data is
  86. displayed with a three  dimensional  aspect. The variables are
  87. displayed behind one another  with the first variable chosen being
  88. the front  variable. In some cases data points will not be seen
  89. since  the column will be entirely hidden. No right side scaling
  90. may be used. Lines will be shown as ribbon graphs unless "filled"
  91. has been chosen. In this case a 3D area graph is drawn. Point
  92. graphs are ignored.
  93.  
  94. GRAPH B
  95.  
  96. These procedures are particular graph types used for analysis. 
  97.  
  98. -A STAR GRAPH produces a chart describing the physical values of
  99. several variables at each of several points. There should be no
  100. negative values. For each point a series of lines are drawn
  101. starting at 3 O'clock and then working counter clock wise around
  102. the point. The length of the lines represents how high the value
  103. of the variable is for that point. The minimum value of the line
  104. is set to 20 percent of the maximum.
  105.  
  106. -A SUN RAY GRAPH is similar in concept. In this case each line is
  107. the same length but the line is cut at a value indicating relative
  108. length. If the line is cut exactly in the middle then the point has
  109. a value for that variable which is at the mean for all points. 
  110.  
  111. -A BOX WHISKER GRAPH requires the selection of a variable and a
  112. category variable. The box and whisker are then drawn for values
  113. from the first variable where the categorical variable is at a
  114. certain level. The box and whisker is a regular style graph. The
  115. box has it's top value at the 3rd quartile point and its bottom at
  116. the first quartile. The box is bisected by a line at the median.
  117. Extending out from the box at top and bottom are the whiskers.
  118. These reach out to the  highest and lowest point in the data
  119. variable for a given level of the categorical variable.
  120.  
  121. -The NOTCHED BOX WHISKER is the same except that there is an
  122. additional piece of information given. There is a notch in the box
  123. which covers a 95 percent confidence limit on the median. The depth
  124. of the notch is proportional to the number of  elements in  the 
  125. variable  with  that  value  of  the  categorical variable.
  126.  
  127. -XYZ graphs are similar to XY graphs.  The main difference is  that
  128. there are three coordinate axes,  and you must pick the  variables
  129. in threes. Another change is the lack of a legend.  No legend is
  130. put on the right of the graph to allow for  the  extra  width 
  131. taken  by the  three  dimensional  graph.  For  labelling you will
  132. need to use the custom labelling feature. For XYZ graphs you may
  133. select point,  line and bar  options.  The  bar  option  does not
  134. actually  produce  bars  in  this  situation.  Instead,  a 
  135. perpendicular is dropped to the  XY  plain.  This  gives a better
  136. indicator of the height of  the  point.
  137.  
  138. -Z function plots are three dimensional graphs of a  function  of 
  139. the  form Z=f(X,Y).  You will be asked  to  specify  the  graphing 
  140. limits for X,Y and Z.  You will then be  asked  to  specify the
  141. equation and then the number of steps to make in  each  of the X
  142. and Y directions.  The greater the number  of  steps,  the  finer
  143. the graph but also the slower the  graph.  With 50 steps in each
  144. direction there are 5000 calls to  the  parser  and this can be a
  145. slow process.  After  setting  the  parameters  you will be asked
  146. whether you want hidden  lines  or  not.  The  default  is for no
  147. hidden lines  (ie  a  wire  frame). If hidden lines are chosen
  148. there is one more option asked. You are asked if you want the graph
  149. textured. If yes the graph will use the colors and pie settings for
  150. pie chart fills to color the graph depending on the maximum height
  151. in each quadrilateral. 
  152.  
  153. You will be asked if you want thick or thin outlines for the 
  154. quadrilaterals. Use thin unless your intent is to print using 
  155. GDOS to a high res printer such as a laser. On a 640 by 480 
  156. screen the X axis is about 400 points wide. Since a wide line is 
  157. 3 pixels wide a thick outline leaves little room for fills. On a 
  158. laser printed horizontally the X axis is about 5 times as wide in 
  159. pixels and the line is still only 3 pixels wide.
  160.  
  161. You will be asked to specify the break points for each color.
  162.  
  163. -The next option is a combination of the previous 2. The main  use 
  164. for  this  option is to examine actual  points  from  a  regression
  165. against the 3D regression surface provided by the  computer.
  166.  
  167. -The  Z Data plot assumes that all of the data in the  editor 
  168. represents  Z values for particular combinations of X and  Y  which 
  169. are  uniformly spaced.  It does not know  what  the  minimum and
  170. maximum X and Y values are. You will be asked to  specify the
  171. maximum and minimum for X,Y, and Z just as for a  function  plot. 
  172. You will not need to specify the number  of  steps  since  that 
  173. is  determined by  the  amount  of  data  available.  As an example
  174. consider a select mortality  table  as  used by an insurance
  175. company.  There would be  rates  of  mortality  for each issue age
  176. and for each of the  first  15  durations since the policy was
  177. issued. If we were to examine  mortality rates for ages 15 to 75
  178. and for durations 1 to  15  the  data  would be set up as follows. 
  179. There  would  be  15  columns in use.  Each row in the column would
  180. represent  the  mortality  level  at a given age for  that 
  181. duration.  There  would be 61 rows to handle the various ages.  The
  182. number  of  steps would internally be set to 60 and 14 with this
  183. data.
  184.  
  185. For  all  of the XYZ graph types the "right side"  title  is  used
  186. to label the "Y" axis.
  187.  
  188. -Y function graphs are those of the form Y=f(X). the use is  very
  189. similar to Z function graphs. You can combine Y function graphs 
  190. with XY graphs.
  191.  
  192. -Histogram plus Y function graphs. This can be a most interesting 
  193. combination. It is generally used to examine fit of a distribution 
  194. to the data/
  195.  
  196. -Histogram plus Normal. Because the nomal distribution is the most 
  197. common it is set up as a special instance of the previous graph 
  198. type. 
  199.  
  200. SETTINGS
  201.  
  202. The settings menu allows you to define how the graph will look.
  203.  
  204. -The palette setting allows you to set the palette for the graph.
  205. There are 16 colors possible with B/STAT. 8 are set on each of 2
  206. pages. The settings for Red, Green and Blue are set in units from
  207. 0 to 1000. The right mouse button causes the values to decrease.
  208. The left causes them to increase. The speed is graduated depending
  209. on how long the mouse button is held.
  210.  
  211. -User Fill allows you to define up to 6 fill patterns for use
  212. by the program. These may be saved and reloaded for the next use
  213. of B/STAT. They are not compatible with fill files from DEGAS.
  214.  
  215. -Styles allows setting the line style fill pattern and point style.
  216. It also allows you to turn on lines bars or points. All 3 can be
  217. on for any given variable. The line style allows for regular lines 
  218. and step lines.
  219.  
  220. -Pie Style allows you to set colors and fill styles for pies as well
  221. as whether a slice is exploded.
  222.  
  223. -Background allows for setting a background fill pattern over which
  224. the graph is drawn. There are two types of fill, Full and Partial.
  225. For Full the entire graph area is filled in. For Partial only the
  226. part of the  graph between the axis lines is filled  in. The
  227. selection of fill style is the same as for pie or bar styles.
  228.  
  229. -Axes allows turning scaling or axes on and off as well as selecting
  230. the color to be used. Tic marks may be turned on or set  to go in
  231. or out.
  232.  
  233. -Titles allows you to enter the titles to be used on the graph.
  234.  
  235. -Title Fonts allows you to select the color and style of the titles
  236. and scales used in the graph. There are settings for most possible
  237. text uses. 
  238.  
  239. -Title Boxes allow you to place filled boxes (regular or  rounded)
  240. behind the each of the titles. The titles will then  take up more
  241. room and the graph will be consequently smaller.  These can be
  242. quite effective for presentation purposes.
  243.  
  244. -Tic size allows the setting of major and minor tic lengths.
  245.  
  246. -Overlap allows you to select the percentage overlap on bar  charts.
  247. The default is -33 which gives white space of one third the width
  248. of a bar.
  249.  
  250. Toggle
  251.  
  252. -Boxed means that for regular and horizontal graphs a line will be
  253. drawn to close in the graph.
  254.  
  255. -Rt side axis will allow a right side axis on regular graphs. This 
  256. is a three way toggle. The first setting is off. The next is for 
  257. regular right axis scaling. Variables may be graphed against the 
  258. scaling of the right axis which is independent of the left axis. 
  259. The last setting is for split screen graphs. This is similar to 
  260. regular right axis scaling in that some variables may be plotted 
  261. against this second axis. The difference is that in this case the 
  262. screen is split 2/3 1/3 with the second scale being a separate 
  263. graph drawn in the lower third of the screen. This approach is 
  264. often used for stock market graphs where volume of sales is shown 
  265. in the lower graph.
  266. Both of these options are available only on high low graphs and 
  267. regular graphs.
  268.  
  269. -Stacked will give stacked bar graphs and area graphs for line
  270. graphs.
  271.  
  272. -Filled will cause the area between lines to be filled in. It can
  273. not be combined with stacked.
  274.  
  275. -Vals above will cause the value of the point to be  displayed above
  276. it for regular and horizontal graphs. For Pie charts the values
  277. will be printed below the pie label.
  278.  
  279. -Legend will cause the legend for each variable to be displayed. If
  280. turned off then the graph will be larger but you will have to use
  281. custom labelling to define what the variables are.
  282.  
  283. -Log X causes the X axis to be on a LOG basis.
  284.  
  285. -Log Y does the same for the Y axis.
  286.  
  287. -Log Z does the same for the z axis
  288.  
  289. -Proportional Pie means that if more than 1 pie is shown on the
  290. screen at once there relative sizes will be determined by the total
  291. of the values in each pie. This is quite useful when comparing 4
  292. years of sales data.
  293.  
  294. -Component Pie. When 2 variables are selected for a pie graph this
  295. option causes the second variable to be taken as a subset of the
  296. first pie sector. The values in the second variable are displayed
  297. as a stacked bar set to the right of the pie.
  298.  
  299. -Pie  Percent  will cause the  percentage  each  pie slice
  300. represents to be printed in the  pie  slice. The  percent is
  301. rounded to the nearest whole percentage.
  302.  
  303. Toggle 2
  304.  
  305. -High Low ends. when selected causes high low lines to have a 
  306. horizontal line drawn at each end. This is useful for error bars.
  307.  
  308. -Outlined Bars. This option creates a special type of bar  chart
  309. where an overarching bar at the height of the sum of  the
  310. components is drawn under the regular bars. This has the  advantage
  311. of displaying two types of information on the same  graph.
  312.  
  313. -XY HI LOW when selected XY graphs are to be done with error bars.
  314. 4 variables must be chosen; then regular 2 and then the high and
  315. low points for the Y value. 
  316.  
  317. -Bezier. There are 3 selections here which come up in turn.  These
  318. are no Bezier, Bezier and Sorted Bezier. When selected  a Bezier
  319. curve is drawn on XY plots using the data as control  points. When
  320. the data is not sorted the Bezier curve follows  the data as it is
  321. entered. When sorted it follows the data in  ascending order of the
  322. X variable.
  323.  
  324. -B Spline. Identical to Bezier except that a B spline is used rather
  325. than a Bezier curve.
  326.  
  327. -95% Conf Lim. When selected XY and regular graphs will be
  328. interpreted to calculate the 95% confidence limits and display them
  329. as error bars. You will be asked for a categorical variable. This 
  330. variable will consist of a class identifier for each point. The 
  331. program will actually graph values for the classes rather than 
  332. individual points. The program will calculate the mean and the 95% 
  333. confidence limits. These are then graphed as error bars. You can 
  334. select either to calculate 95% confidence limits for individual 
  335. points or for the mean itself. 
  336.  
  337. -Pyramid 3D. When chosen, 3D bars will be pyramids not columns.
  338.  
  339. -Top Tics. When selected regular graphs will have a top axis with
  340. tics at the same places as the bottom axis.
  341.  
  342. -Contour is a three way toggle. The default is that no contours 
  343. will be drawn. This function is only applicable to Z function and 
  344. Z data graphs. A contour plot gives the projections on the XY 
  345. plane of constant Z values. It is most familiar on topographical 
  346. maps where the lines show the areas of constant altitude. 
  347.  
  348. You will be asked to specify the number of labels. This is done by 
  349. selecting from none, medium and high. The actual number of labels 
  350. will vary depending on the number of contour lines and their 
  351. lengths. 
  352.  
  353. If selected then you must give the values for which the contours
  354. will be drawn. There are a maximum of 14 levels you may select.
  355. The 2 other options are contours with the regularily selected graph over 
  356. the top and contours with the regular graph suppressed.
  357.  
  358. In the case where you are drawing a z function and showing it 
  359. along with the contours you will be asked if you wish to double 
  360. the resolution of the contour lines. If so then the number of 
  361. steps in each direction will be doubled in determining the 
  362. contours. They will remain as chosen for the graph itself.
  363.  
  364. -Kep scale. When chosen the previously used settings for maximum 
  365. and minimum etc will be used for the next graph. This saves work 
  366. if you are graphing a set of variables and do not want them to 
  367. have different ranges.
  368.  
  369. -Value table. If selected then below the graph will be drawn a 
  370. table showing the values in the data.
  371.  
  372. -Histogram fix. If selected, you will be asked for the mean and 
  373. standard deviation of the normal to fit to a histogram. If not set 
  374. the values are determined from the histogram.
  375.  
  376. -Label stack. If chosen then the X axis labels are offset into two 
  377. separate rows to allow for more labels.
  378.  
  379. -Equal Scales. If chosen then the spacing in millimeters for a 
  380. unit in the X direction will be the same as for a unit in the Y 
  381. direction on XY graphs and similarily for XYZ graphs. As a result 
  382. the graph will not take up the full graphing space. The 
  383. difference will be slight where the nominal scaling would be 
  384. close in any event. Where the range of values is significantly 
  385. different between the axes then it is unlikely that this option 
  386. should be used. It will likely be necessary to rescale the short 
  387. axis since the tics and label settings are not adjusted.
  388.  
  389. -Output Background. You can set the color for "color 0" which is 
  390. the basic screen color. This option allows you to output the 
  391. screen color to either a printer or a meta file. You can do the 
  392. same thing by setting a full background fill. By using this 
  393. option you can combine a background color with a partial 
  394. background fill. 
  395.  
  396. -Redraw will redraw the graph if the reset graph option is  off.
  397.  
  398. Grids
  399. These options turn on horizontal and vertical grids and the  Z
  400. grids.
  401.  
  402. There is also a "zero line" option to ensure that  a line is drawn
  403. at the zero point even if  no grids are displayed.
  404.  
  405. STYLES allows setting the type of grid. The color may be set to 
  406. color 0 which is usefull only with background fills.
  407.  
  408. Miscellaneous
  409. -Save Set. This option saves the settings in use for the graph. It
  410. saves titles, fill settings, fonts etc.
  411.  
  412. -Load set. Same as above but to bring it back in.
  413.  
  414. While  a graph is on screen labels may be added  by double clicking
  415. where you want them to appear.  You will  be required to select the
  416. font and size for the label just as for titles. You have the 
  417. option of adding an arrow.
  418.  
  419. Simply click where you want it to  point. These labels may be 
  420. dragged on the screen. To remove a floating label, double click on
  421. the label. You are now asked "What to Change?".  This can be either
  422. font, text, or arrow. You can remove the label by selecting text
  423. and erasing the existing  text. A label with no text is simply
  424. removed from the list of labels. If you choose arrow you can either
  425. add an arrow if one does not exist or move the anchor point  for
  426. an existing arrow, or remove the arrow.  You may also re-size the
  427. graph. This is done by placing the mouse in the lower right corner
  428. of the graph and then dragging the mouse. The graph can be reduced
  429. to 1/4 its original size. You may also reposition the smaller
  430. graph by holding down the mouse button while the mouse is inside
  431. the axes.
  432.  
  433. For most graph types pressing the "F1" key causes a two fold 
  434. magnification about the mouse location. Pressing "F2" does the 
  435. reverse. Pressing "ESC" brings you back to the original settings. 
  436. "F1" and "F2" may be pressed more than once.
  437.  
  438. The  menu bar displayed while a graph is on screen allows you to
  439. save or print the graph. The "Save" menu items allow three forms
  440. of saving the screen image. The first is as a DEGAS compatible un-
  441. compressed image. The second is as a ".IMG"  file which can be used
  442. by desktop publishing programs. 
  443.  
  444. With a color system you will be asked if you want  a color IMG
  445. file. Many desk top publishing programs can not handle a color file
  446. so you can put out a monochrome version of the screen. 
  447. The  IMG files produced by B/STAT are compatible  with IMG files
  448. on MSDOS machines. They can therefore be used with Wordperfect
  449. version 5.0 on these  machines. Note that IMG files are bit image
  450. files. The quality of reproduction is not as good as using a GDOS 
  451. print to the same physical size area.  
  452.  
  453. The third choice is a TIFF file. TIFF Files are a standard set up 
  454. by ALDUS corporation and Microsoft. B/STAT supports several 
  455. variants for color TIFF files. NOte that the TIFF files produced 
  456. by B/STAT are uncompressed. This should not pose a space problem 
  457. as B/STAT files are not large in any event.
  458.  
  459. The fourth choice is as a metafile. Metafiles can be read  by 
  460. programs such as Easy Draw and many desktop  publishing  programs
  461. such as Pagestream, Calamus and the Timeworks Desktop  Publisher
  462. (TWDTP). To read the files into TWDTP you will need to select  the
  463. "GEM DRAW" option in TWDTP.  
  464.  
  465. When printing you have three options. First you can print the
  466. screen using the built in  Atari screen dump utility or one which
  467. you have loaded yourself. The  second option is  useful only for
  468. 9 pin Epson printers. This option uses the Epson plotter mode to
  469. ensure properly scaled pictures. 
  470. A similar feature is available for EPSON LQ 24 pin printers. 
  471. The Hewlett Packard option does a screen dump to the HP laserjet 
  472. family in the same manner.
  473.  
  474. The third choice uses GDOS if you have it to plot to the printer.
  475. The text on the graph will not usually look quite the same as on
  476. the screen since many GDOS fonts are proportional and the default
  477. screen fonts are not. Also some of the printer fonts are not quite
  478. the same size as the screen fonts.
  479.  
  480. The remaining choices are to adjust GDOS printing. The GDOS
  481. settings item allows you to decide on the width and height of the
  482. graph on the paper. Various GDOS drivers as well as printers will
  483. start graphs in different places. Thus setting the starting
  484. position offset to be zero may not put the graph at exactly the
  485. edge of the paper. Many Epson clones start graphics 1/4 of an inch
  486. from the edge. You should therefore do a GDOS print of a graph
  487. with the standard settings. Before doing the print turn on "GDOS
  488. box". This will result in a box being drawn around the edges of
  489. the graphing area. You can then use the resulting positions to
  490. establish a vertical and horizontal offset for your particular
  491. printer. The "GDOS Device" Selection allows you to set the device
  492. ID that the program uses to that which you have set in your
  493. ASSIGN.SYS file. Most users will never have to use this setting.
  494. The default in B/STAT is device 21 which is the usual standard.
  495. This choice is for those lucky individuals who have more than one
  496. printer in use or who have a plotter which is supported by GDOS.
  497. "GDOS Rotate" allows you to print the graph in landscape mode as
  498. opposed to the normal portrait orientation.
  499.  
  500. The miscellaneous menu contains several unusual features. The 
  501. "Keep  Labels" option when chosen (the default) ensures  that  the 
  502. custom labels will be kept when you return to the  graph  selection
  503. screen. To get rid of them all, simply deselect the  option.
  504.  
  505. Also on the miscellaneous menu is the selection for "Legend  Box".
  506. When this is selected the legend may be dragged around on  the
  507. graph until you release the button. If the option has already been
  508. selected then reselecting it will result in returning to the
  509. default setting. When selected you may further  move the legend by
  510. selecting "Move Legend". 
  511.  
  512. "Values" causes the display of the value where the mouse is to be 
  513. continuously displayed in the lower left corner of the screen. 
  514. This option does not work for 3D graphs or pies, sun rays, star or 
  515. box whisker graphs.
  516.  
  517. Draw Menu
  518. This selection moves you to the draw menu which is used for 
  519. drawing filled boxes, lines, circles, and ellipses
  520.