home *** CD-ROM | disk | FTP | other *** search
/ Education Sampler 1992 [NeXTSTEP] / Education_1992_Sampler.iso / READMEFiles / nxyplot1.87.README < prev    next >
Text File  |  1992-08-29  |  7KB  |  138 lines
  1. This is the README file for the nxyplot package.  nxyplot is a plotting
  2. program for NeXT machines running operating system 2.0 (or higher).
  3.  
  4. Program Summary:
  5. nxyplot is a program for plotting two-dimensional curves, with data
  6. coming from one or more files.  Each file can contain multiple
  7. y-values for each x value.  Each data file should be an ASCII or
  8. compressed file, with each line containing the x-value followed by the
  9. y-values for each curve.  Thus, each data file should look like
  10. x1 y1 ... yn
  11. x2 y2 ... yn
  12. etc., where there are n curves to be plotted.  A sample file
  13. (test2.xyp) is provided to illustrate this format and to use for
  14. testing the program.  The input file can contain text comments as long
  15. as the text contains no periods or numerals.
  16.  
  17. We have tried to comply with the standard NeXT user interface.  The
  18. various panels (controls, lines, symbols, legends) have some
  19. information displayed on them.  They allow manipulation of the line
  20. style, symbol type, legend, minimum and maximum value along each axis,
  21. and titles.  Also provided is the ability to move the legend and
  22. titles and to "zoom" in on a section of the plot.  Printing capability
  23. is provided by standard NeXT system methods; the plot will be
  24. automatically scaled to an 8.5 in. x 11 in. page in either landscape
  25. or portrait mode (depending on whether the screen plot is landscape or
  26. portrait).
  27.  
  28. Writing this program served as our introduction to programming using
  29. the Interface Builder and Objective-C.  We wanted to emulate the
  30. functionality of a program called "xyplot", written by Marshal Merriam
  31. of NASA/Ames Research Center and T. Krysten Nguyen.  The plotting
  32. program "QuickPlot" of Fred Richards (University of Illinois) was very
  33. helpful in showing how to get started with the Interface Builder.
  34.  
  35. We use this program ourselves and intend to support it (in our spare
  36. time).  Constructive criticism and suggestions for improvement are
  37. welcome; send e-mail to jesperse@rft28.nas.nasa.gov or
  38. pulliam@rft29.nas.nasa.gov.  We always have a wish list.
  39.  
  40. This code is provided as-is, and no warranty express or implied is
  41. made.  It is definitely not a product of the U.S. Government.  The
  42. source code is not to be used in any commercial for-profit endeavor.
  43.  
  44. Dennis Jespersen                  Tom Pulliam
  45. jesperse@rft28.nas.nasa.gov       pulliam@rft29.nas.nasa.gov
  46.  
  47. Version 1.0 of nxyplot.
  48. Quick summary of enhancements: can now plot data from multiple files;
  49. can select different fonts for the various labels; better labeling
  50. along the axes.
  51.  
  52. Version 1.5 of nxyplot.
  53. Quick summary of enhancements:
  54. 1. More robust handling of input files; they can now have limited text
  55. comments and arbitrary non-ASCII characters.
  56. 2. Capability to read and write "format" files.  A format file
  57. contains information about the min/max, line types, etc., and can be
  58. used as a template to allow easily regenerating plots where many
  59. non-default options have been selected.
  60. 3. Capability to read compressed files.  This is to help conserve disk
  61. space.
  62. 4. Service providing.  Under NeXT system 2.0 and higher, applications
  63. can register as service providers.  This program offers a plotting
  64. service to any application which can put appropriate data on an ASCII
  65. pasteboard.  See the help file (under "Preferences") for more
  66. information.
  67.  
  68. Version 1.6 of nxyplot.
  69. Quick summary of enhancements:
  70. 1. Supports color: lines, background, text can be colored.
  71. 2. Titles may be moved, just like the legend box.
  72. 3. More robust handling of tic label formatting; also bug fixes.
  73. 4. Line thickness and symbol size controlled by sliders.
  74. 5. Format file supports colors and the previous enhancements.  This
  75. implies that format files written with earlier version of nxyplot MAY
  76. MALFUNCTION when read with this version of nxyplot.
  77. 6. Axis thickness now user-controllable.
  78. 7. Added capability to save data files; this may be handy if one has
  79. read in data off the pasteboard (using services) and would like to
  80. save the data in a file.
  81.  
  82. Version 1.7 of nxyplot.
  83. Quick summary of enhancements:
  84. 1. Allow user-specified formatting of tic labels; also bug fixes of
  85. automatic tic label formatting. 
  86. 2. Allow data files with only one column of data (the given data is
  87. assumed to be y values, and the x values are taken to be the integers
  88. 1,2,3,...).
  89. 3. The linestyle and symbolstyle matrices now automatically arrange to
  90. turn off all but one button in each column.
  91. 4. The linestyle, symbolstyle, and legendstyle windows are now
  92. scrolling windows; they can be resized and scroll bars will appear
  93. (suggested and code supplied by Paul Howell using the ScrollWindow
  94. class of David Joerg).
  95. 5. Title of plot window now reflects name of data file most recently
  96. read in, or "pasteboard" if data came from a pasteboard.
  97. 6. Initial curve titles in legend window now reflect file names.
  98. 7. Arbitrary column of data file can be selected as the x-data for a
  99. plot.  Note that choice of a column other than the first for the
  100. x-data is not taken into account when a format file is written or read.
  101. 8. Added capability for the Workspace Manager to launch nxyplot when
  102. any file with the extension "xyp", "dat", or "nxyplot" is
  103. double-clicked.
  104. 9. Added color vs black/white option in Preferences.
  105. 10. Any curve whose line style and symbol style are both set to none
  106. will be ignored when doing min/max calculations.  A file's x-data will
  107. also be ignored if all the curves from that file are ignored.
  108. 11. Data files now may contain the comment character "!" anywhere on a
  109. line; anything following the "!" on a given line will be ignored.
  110. 12. nxyplot can now read options given on the command line.  Usage is
  111.  nxyplot file [file...] [-f formatfile] [-o epsfile] [-q] [-h]
  112. 13. Length of tic marks is now user-controllable by a slider/text
  113. field combination.
  114. 14. "Previous View" button added to control panel.
  115. 15. Print panel additions to allow easy printing in black and white
  116. even if display is being viewed in color.
  117. 16. "Fine tuning" panel added to organize many small details.  Frame
  118. box control added.  Ability to locate tic marks on axes added.  Note
  119. that format files written by nxyplot version 1.6 or earlier may not
  120. work properly with version 1.7 of nxyplot.
  121.  
  122. Version 1.8 of nxyplot.
  123. Quick summary of enhancements:
  124. 1. Error bar capability added; see Error bars (under Windows menu item).
  125. 2. Some bug fixes.
  126. 3. Services menu item added.
  127. 4. Copy Graphics menu item added.
  128. 5. Preview button added to main control panel.
  129. 6. Added capability to read and write binary files.
  130. 7. Tic marks can be on all four sides of the frame box.
  131. 8. Main menu reorganized to be more in conformance with NeXT UI Guidelines.
  132.  
  133. Version 1.85 of nxyplot.
  134. Quick summary of enhancements:
  135. 1. Capability to delete selected files.
  136. 2. Drag and drop capability added.
  137. 3. Bug fixes.
  138.