home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 597a.lha / GodelCalc_v0.01 / GODEL_CALC.DOC < prev    next >
Encoding:
Text File  |  1991-11-28  |  5.6 KB  |  159 lines
  1.                                 Godel Calc
  2.                  The Self-Referential SpreadSheet Program
  3.                                Version 0.01
  4.                                     by
  5.                                Jamie Mueller
  6.  
  7.    Godel Calc is a simple spreadsheet program that allows multiple sheets
  8. to be open at once (up to 20).  Each sheet can have references to the other
  9. sheets (which get automatically loaded if done correctly).
  10.  
  11.    Basically the cell formulas look something similar to:
  12.  
  13.             =A0+B2+sin(B6)*cos([3,4])
  14.  
  15. The cell references can either be alphanumeric (e.g. B6) or in [column,row]
  16. format.  When you use the [column,row] format the numbers in the brackets
  17. can be references to other cells (e.g. [B1,C2] or [ [1,2],[3,4] ] or
  18. [B1,[3,4]] etc.).  They can even be formula's of some sort: [Sin(a0),0]
  19. although some formulas won't be too helpful (like the above Sin(a0)!).
  20. (This is where some of the self-reference comes in)
  21.  
  22.    If you really want Godel Calc to perform loops you must have either 2.04
  23. or ARexx.  Godel Calc uses ARexx scripts for its macros in three separate
  24. places: You can specify macros for the Alt-F1 through Alt-F10 keys in the
  25. files AF1.gcs through AF10.gcs (.gcs for Godel Calc Script).  You can have
  26. macros show up on the menu under the ARexx heading (a maximum of 15). These
  27. files end in the extension .gcmn (for Godel Calc MeNu). Finally you can
  28. reference a macro directly from a cell within the spreadsheet and this
  29. macro can reference anything on any spreadsheet loaded! These files end in
  30. the extension .gcfn (for Godel Calc FunctioN).  There is no limit to the
  31. amount of ARexx functions you can have for Godel Calc.
  32.  
  33. Godel Calc Menu Items:
  34.  
  35. Project: 
  36.    New:     This selection opens up a new blank spreadsheet.
  37.  
  38.    Open:    This selection allows you to open a new spreadsheet.
  39.  
  40.    Save:    This selection will save the current spreadsheet to a file.
  41.  
  42.    Save As: This selection will save the current spreadsheet to a new file.
  43.  
  44.    Close:   This selection will close the current spreadsheet and not save
  45.             it.
  46.  
  47.    Exit:    Exit Godel Calc.
  48.  
  49. Edit:
  50.    Insert:
  51.       Row:     Inserts a row at the current cursor location.
  52.  
  53.       Column:  Inserts a column at the current cursor location.
  54.  
  55.    Delete:
  56.       Cell:    Deletes a cell or the marked block of cells
  57.  
  58.       Row:     Deletes the row at the current cursor location.
  59.  
  60.       Column:  Deletes the column at the current cursor location.
  61.  
  62.    Fill:
  63.       Right:   Takes the current marked block and fills the block
  64.                with the left column of the marked block.
  65.  
  66.       Down:    Takes the current marked block and fills the block
  67.                with the top row of the marked block.
  68.  
  69. Options:
  70.    Recalc:
  71.       On:      Turns on automatic recalculation.
  72.  
  73.       Off:     Turns off automatic recalculation (default).
  74.  
  75.       Now:     Recalculates the current spreadsheet.
  76.  
  77. Formats:
  78.    Column Width: Sets the current or marked range of columns to a specified
  79.             width (default 10).
  80.  
  81.    Decimals:   Sets the number of digits to the right of the decimal point
  82.          to be printed (default 0).
  83.  
  84. ARexx:
  85.    Items under this menu are the filenames of the scripts to execute when
  86.    the items are selected.
  87.  
  88. Note: When using the Fill Right, Down, or Insert Row, or Column the cell
  89. references in the formulas are updated unless they are preceeded by a dollar
  90. sign ($).  The dollar sign ($) must preceed EVERY item that you wish not
  91. to be changed (e.g. $a$0 will keep both row and column references, just $a0
  92. will mean the 0 can change, etc.).  This does not apply to cell references
  93. that take the form [col,row] these do not get changed and must be updated
  94. manually.
  95.  
  96.    Godel Calc allows the following functions:
  97.  
  98.    sqrt()   abs()    sin()    cos()    tan()      atan()     ln()
  99.    exp()    sinh()   cosh()   tanh()   u()        sum(range) ave(range)
  100.    atan2(,) ceil()   floor()  mod(,)   max(range) min(range)
  101.  
  102. The functions that have no argument listed take just one, ones with a
  103. comma take two arguments, the range is identified by cell:cell.
  104.  
  105. If Godel_Calc sees a function of this form name() it searches the above
  106. list and if no match is found it looks for a file of the name name.gcfn
  107. If the file exists it is executed as an ARexx script with the arguments
  108. passed in followed by the title of the spreadsheet that is calling the
  109. function.  An example function rad() that calculates radians from degrees
  110. is shown below:
  111.  
  112. /* convert degrees to radians */
  113. parse arg num sheet
  114. radian=num*3.141592657
  115. radian=radian/180.0
  116. return radian
  117.  
  118. Currently the following commands are available to an ARexx script from
  119. Godel Calc:
  120.  
  121.    NEW title
  122.    EXIT
  123.    CLOSE sheet
  124.    MOVE TO cell sheet
  125.    MOVE UP n sheet
  126.    MOVE DOWN n sheet
  127.    MOVE LEFT n sheet
  128.    MOVE RIGHT n sheet
  129.    ENTER string sheet
  130.    RECALC sheet
  131.    SAVE sheet
  132.    OPEN sheet
  133.    EVL formula sheet             Evaluate (make sure OPTIONS RESULTS is on)
  134.    INSERT ROW sheet
  135.    INSERT COLUMN sheet
  136.    ARC ON sheet                  Auto Recalc
  137.    ARC OFF sheet
  138.    DELETE CELL sheet
  139.    DELETE ROW sheet
  140.    DELETE COLUMN sheet
  141.    FORMAT COLUMNS n sheet
  142.    FORMAT DECIMALS n sheet
  143.    MARK range sheet
  144.    FILL RIGHT sheet
  145.    FILL DOWN sheet
  146.  
  147. where: n is a number, sheet is the title of a sheet, formula is a valid
  148. formula, string is a string, and cell is either in A0 form or [col,row]
  149. form.
  150.  
  151. The commands that change a cell (like ENTER, INSERT, DELETE, etc.) change
  152. whereever the cursor is currently at, to move it use the MOVE command.
  153.  
  154. Unfortunately at this point in time the range for MARK range can *ONLY* be
  155. in the alphanumeric format (e.g. A3:B12) and not in the [col,row]:[col,row]
  156. format..this will be changed.
  157.  
  158. To mark a block use the shift-arrow keys...
  159.