home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / calculat / prmath40.zip / INSTALL.EXE / MANUAL.DOC < prev    next >
Text File  |  1993-07-22  |  67KB  |  1,644 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                ProMATHeus II
  9.  
  10.                            The Formula Processor
  11.  
  12.                          (c) 1993 by Mark Brissman
  13.                           Blarney Stone Software
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                      Shareware Manual Version 12Jul93
  33.               A Guide to ProMATHeus II Version 4.0,  (c) 1993
  34.  
  35. ProMATHeus II is a copyrighted product designed to aid you in solving
  36. simple and complicated calculations of all types.  It was created by a
  37. professional mathematician and actuary who was frustrated by the lack of
  38. affordable calculation software which avoids the pitfalls of old-fashioned
  39. calculators (and their PC-based mimics) and spreadsheets.  ProMATHeus II
  40. differs from other calculator software in that it works like you think--not
  41. the way the mechanics require.  Further, it differs from spreadsheets in
  42. that it does not rely on cumbersome cell-address "logic".  Features in-
  43. clude:
  44.  
  45. -    Variables have names rather than the nondescript numbered memories of
  46.      calculators.
  47.  
  48. -    Formulas are entered easily and they can interact with each other.
  49.  
  50. -    Active formulas (i.e., those with variables) are reviewed constantly
  51.      and full or partial solutions are displayed.
  52.  
  53. -    Formulas can contain functions and variables with known or unknown
  54.      values.
  55.  
  56. -    Many common functions are preprogrammed, including:
  57.  
  58.      statistical:   Factorials, combinations, permutations, normal, chi-
  59.                     square, student's t, F, and gamma distributions (Most
  60.                     inverses are included),
  61.  
  62.      logarithmic:   Log (base 10), ln (base e), exponential, and y-to-the-x
  63.                     (power).
  64.  
  65.      trigonometric: Normal and hyperbolic sine, cosine, tangent, arcsine,
  66.                     arccosine, and arctangent.
  67.  
  68.      financial:     Loans, present value and future value of annuities.
  69.  
  70.  
  71.      miscellaneous: Integer part, absolute value, and square root.
  72.  
  73. -    Custom functions can be defined easily, call other functions, and sim-
  74.      plify calculations.  They can also be: solved (by iteration) for any
  75.      one of their variables, numerically integrated and numerically differ-
  76.      entiated.
  77.  
  78. -    Libraries of custom functions can be created relating to any disci-
  79.      pline: mathematics, finance, engineering, statistics, surveying, navi-
  80.      gation, etc.
  81.  
  82. -    Up to five one-variable custom functions can be plotted simultaneously
  83.      with the Graph feature.
  84.  
  85. -    Entire work sessions (formulas, custom functions, and variables) can
  86.      be saved and retrieved easily.
  87. -    The current work session is saved automatically.
  88.  
  89.  
  90.                           New with ProMATHeus II
  91.  
  92. The success of the original ProMATHeus versions spurred us to develop the
  93. ultimate, easy-to-use interface for this new version.  Many new enhance-
  94. ments have been added to make ProMATHeus II the ultimate tool for educa-
  95. tors, students, scientists and professionals.  New features include:
  96.  
  97. -    A sensible, easy pull-down menu system.
  98.  
  99. -    A window environment with windows which can be resized, moved, and
  100.      scrolled.
  101.  
  102. -    Control via keyboard (several ways!) or mouse.
  103.  
  104. -    Online, context-sensitive help screens.
  105.  
  106. -    Clear, powerful screens for file retrieval, numeric format, color
  107.      selection, printer setup, graph setup, and other options.
  108.  
  109. -    Improved graphics system.
  110.  
  111. -    More error and information messages.
  112.  
  113. -    More internal functions.
  114.  
  115. -    Easier registration, an 800 telephone number, MasterCard/Visa, and
  116.      instant updates!
  117.                           Things You Need to Know
  118.  
  119. Required Registration
  120.  
  121. Most of you reading this manual have already registered.  Thank-you!!!
  122. Your support is greatly appreciated!  Those of you who haven't yet please
  123. read on.
  124.  
  125. After many hundreds of hours of development, ProMATHeus II is now being
  126. released under the shareware concept.  It is only through the registrations
  127. of honest customers that shareware authors are provided the motivation to
  128. further refine and improve their products.  Shareware allows you, the user,
  129. the chance to try a product before you buy it.  If, after trying it, you
  130. would like to continue using ProMATHeus II, you must register your usage by
  131. one of the methods listed in the next section.  Why register?
  132.  
  133. 1.   Honesty: It may seem old fashioned, but it is the right thing.
  134.  
  135. 2.   Legality: Your license to use the software without registration
  136.      expires after 14 days.
  137.  
  138. 3.   Functions and Features: Full functionality requires full registration.
  139.  
  140.      It's that simple.  Register over the telephone and receive all func-
  141.      tions immediately!  The full version of ProMATHeus II including all
  142.      the features and functions not included in the "Test Drive" version.
  143.      Those additional features are identified in the "Functions" section of
  144.      this manual.  Also, registration reminder messages will be removed.
  145.  
  146. 4.   Documentation: A full, printed, bound User's Manual with examples and
  147.      formulas will be provided to each registered user.  The manual ex-
  148.      plores the richness of ProMATHeus II and includes hints for users of
  149.      all levels and abilities.
  150.  
  151. 5.   Timeliness: You will receive the most recent version.
  152.  
  153. 6.   Support: Free technical support is included with your registration;
  154.      Our support policy is defined later.
  155.  
  156. 7.   Notices: of future releases.  We'll keep improving and keep in touch.
  157.  
  158. Methods of Registration and Payment
  159.  
  160. The registration cost is $45 (plus shipping/handling of $3 continental
  161. U.S., $5 elsewhere).  For $52, you will also receive Blarney Stone's Quick
  162. Calculator (c)1992--at a greater than 50% savings.  Several other pricing
  163. options, including multiple licenses, may be described on our order form
  164. (the file ORDER.ME).
  165.  
  166. Please chose the method which is most convenient:
  167.  
  168.      OUR 800 NUMBER AND MASTERCARD OR VISA
  169.      You may purchase ProMATHeus II with this method and begin using all
  170.      its features immediately!
  171.  
  172.           First dial                    1-800-484-8091
  173.  
  174.      A computer will answer and state: "Please enter your four digit
  175.      security code now or hold for an operator."  Enter our security code
  176.      (2771) immediately or wait and tell the operator.  That is:
  177.  
  178.           When asked for the security code, dial  2771
  179.  
  180.      You will be connected to us, free of charge, immediately.  Please,
  181.      this line is for sales only.
  182.  
  183.      If we cannot answer the telephone:
  184.  
  185.           We accept telephone orders between the hours of 8 am and 10 pm,
  186.           CST.  We do not staff full-time sales help, so you may get our
  187.           answering machine.  If so, please tell us the following:
  188.  
  189.           1.   The product you want to purchase.
  190.           2.   Your name and full address.
  191.           3.   Your MasterCard or Visa number, and expiration date.
  192.           4.   Your telephone number, and the best time to call.
  193.  
  194.           If all information is complete and we have successfully verified
  195.           your credit card, we will bill your credit card and begin ship-
  196.           ping procedures.  If that is not satisfactory, please tell us so.
  197.  
  198.      CASH, CASHIER'S CHECK, MONEY ORDER
  199.      These aid quick turnaround for you and are the surest for us.  Howev-
  200.      er, we are not responsible for amounts lost in the mail.
  201.  
  202.      PERSONAL CHECK
  203.      Always welcome, but there may be a slight delay for balance verifica-
  204.      tion.
  205.  
  206. For the last two options, please print the order form file ORDER.ME,
  207. complete it, and return it with your payment.  We must have this form!  You
  208. may do so by using the "Order Form" selection from the "Register" menu.
  209. Or, you can print it with DOS commands like "COPY", "TYPE" or "PRINT".  For
  210. example:
  211.      Type:     copy order.me prn<Enter>
  212.      Or:       print order.me<Enter>
  213.      Or:       type order.me > prn<Enter>
  214.  
  215. Please make checks payable to Mark Brissman.  Please mail to the address
  216. given in the next section.
  217.  
  218. Although we strive to ship our products as quickly as possible, please
  219. allow four to six weeks for delivery.
  220.  
  221.  
  222. Contacting Us
  223.  
  224. To call, use one of the following numbers:
  225.  
  226.      Sales only:  For sales with a MasterCard or Visa, please follow the
  227.      procedure outlined in the previous section.
  228.  
  229.      Technical support and other matters:         1-309-662-1725
  230.      (We might move, see below!)
  231.  
  232. By mail, use the following address, but...we might be moving!!!  Our mail
  233. would be forwarded, but if you have trouble, please use our 800 telephone
  234. number (in the previous section) to get the new address and technical
  235. support number.
  236.  
  237.      Our current address:     Mark D. Brissman
  238.                               Blarney Stone Software
  239.                               2510 Blarney Stone Lane
  240.                               Bloomington, IL 61704
  241.  
  242. By modem, you can leave messages or check for new versions on:
  243.  
  244.      Bulletin Boards
  245.  
  246.      GEnie: M.Brissman        CompuServe: 70324,1676
  247.  
  248.  
  249. License Agreement
  250.  
  251. Only registered users may use the full version of ProMATHeus II.
  252.  
  253. You may use the "Test Drive" version of ProMATHeus II for 14 days prior to
  254. obtaining a permanent license.  ProMATHeus II is distributed under the
  255. shareware concept.  You are permitted to copy and distribute the "Test
  256. Drive" version of this product unmodified with all original files and
  257. without the registration number to other potential users.  You may not
  258. share your registration number, which is supplied to licensed users only.
  259. You may not charge for sharing a copy unless you comply with the provisions
  260. in file VENDOR.DOC.  If you do not have a copy of this file and wish to
  261. distribute our software for a fee, please contact us as described in the
  262. previous section.
  263. If you choose to register and to continue using the program, your registra-
  264. tion number may be used only by you, the licensee specified in the original
  265. order for the license.  By ordering a license, you acknowledge that this
  266. file represents a trade secret and agree to protect it as such.  Misuse of
  267. a registration number is subject to collection of triple the fees that
  268. should have been collected and all legal fees and costs.  Licenses are not
  269. transferrable and may not be modified.
  270.  
  271. Blarney Stone Software disclaims all warranties relating to this software,
  272. whether express or implied, including but not limited to any implied
  273. warranties of merchantability and fitness for a particular purpose, and all
  274. such warranties are expressly and specifically disclaimed.  Neither Blarney
  275. Stone Software nor anyone else who has been involved in the creation,
  276. production, or delivery of this software shall be liable for any indirect,
  277. consequential, or incidental damages arising out of the use or inability to
  278. use such software even if Blarney Stone Software has been advised of the
  279. possibility of such damages or claims.  In no event shall Blarney Stone
  280. Software's liability for any damages ever exceed the price paid for the
  281. license to use the software, regardless of the form of claim.  The person
  282. using the software bears all risks as to the quality and performance of the
  283. software.
  284.  
  285. This agreement shall be governed by the laws of the state of Illinois, or
  286. if we move, the state of Blarney Stone Software's current residence.  This
  287. agreement shall inure to the benefit of Blarney Stone Software and any
  288. successors, administrators, heirs and assigns.  Any action or proceeding
  289. brought by either party against the other arising out of or related to this
  290. agreement shall be brought only in a STATE or FEDERAL COURT of competent
  291. jurisdiction located in McLean County, Illinois, or if we move, the county
  292. and state of Blarney Stone Software's current residence.  The parties
  293. hereby consent to in personam jurisdiction of said courts.
  294.  
  295. It is your responsibility to determine if the program will work reliably on
  296. your equipment and for your particular personal or business environment.
  297. That's why "Test-Drive" evaluation copies are made available to you.  This
  298. software probably has bugs; no significant software has ever been produced
  299. without them.  If you feel that this program or documentation can be
  300. improved in some way, we are open to your ideas.  If you discover a
  301. problem, please notify us as defined in the "Support Policy" section.  In
  302. any case, your remedy for any problem is limited to the purchase price paid
  303. to Blarney Stone Software.  Blarney Stone Software has tried to assure the
  304. accuracy of ProMATHeus II. However, because computer programs are inherent-
  305. ly complex and may not be completely free of errors, you are advised to
  306. verify your work.
  307.  
  308. If you don't agree with these conditions, delete the program from your
  309. computer.
  310. Copyright and Trademark
  311.  
  312. "ProMATHeus", "ProMATHeus Plus", and "ProMATHeus II" are copyrighted by
  313. Mark Brissman, Blarney Stone Software.  All rights reserved.
  314.  
  315. "Blarney Stone Software", "ProMATHeus", "ProMATHeus Plus", and "ProMATHeus
  316. II" are trademarks of Mark Brissman and Blarney Stone Software.
  317.  
  318. ProMATHeus II is distributed under the shareware concept.  You are permit-
  319. ted to copy and distribute the "Test Drive" version of this product
  320. unmodified with all original files to other potential users.  See the
  321. license agreement for details.
  322.                                Installation
  323.  
  324. All the files needed to operate ProMATHeus II need to be copied to the
  325. directory or disk from which you wish to operate ProMATHeus II.  These
  326. files have been distributed to you in one of two ways:
  327.  
  328. Method 1. Each file is distributed separately on a disk or as a part of a
  329.           ZIP (compressed archive) file.  These must be copied to the
  330.           desired directory or disk.  Then you must run PKUNZIP or a
  331.           similar decompression program available from your supplier.
  332.  
  333. Method 2. The files are "stored" within the file PM2FILES.EXE.  To install,
  334.           you must simply copy and execute PM2FILES.EXE in the desired
  335.           directory or disk.  All  files will be extracted into the direc-
  336.           tory.
  337.  
  338.  
  339. Copying from a Floppy Drive to a Hard Drive
  340.  
  341. There are many programs to copy files and create directories.  The follow-
  342. ing approach uses some traditional DOS commands.  See your DOS manual for
  343. details.  First, select the hard drive with the appropriate letter.  For
  344. example, if your hard drive is 'C' (throughout the manual, keys are
  345. represented in angle brackets like <F1> or <Enter>) :
  346.  
  347.      Type:          C:<Enter>
  348.  
  349. Next, use the 'change directory' command to select the directory to which
  350. you wish to attach your ProMATHeus II subdirectory.  For example, if you
  351. wish to attach it to the root directory (\):
  352.  
  353.      Type:          cd \<Enter>
  354.  
  355. Next, use the 'make directory' command to create your ProMATHeus II
  356. subdirectory.  For example, if you wish it to be named 'PM2':
  357.  
  358.      Type:          md pm2<Enter>
  359.  
  360. Now, use the 'change directory' command to move to the new directory.
  361. Continuing the example:
  362.  
  363.      Type:          cd pm2<Enter>
  364.  
  365. Last, copy the files from the floppy to the new directory.  For example, if
  366. the floppy drive is 'A':
  367.  
  368.      Method 1:      Type:     copy A:\*.*<Enter>
  369.  
  370.      Method 2:      Type:     copy A:\pm2files.exe<Enter>
  371.  
  372.                     Then execute the program.
  373.                     Type:     pm2files<Enter>
  374.  
  375. Now you are ready to operate!  You must always be in this newly created
  376. directory to run ProMATHeus II.  However you chose to use ProMATHeus II, in
  377. order to access all features you must include the following files in your
  378. working directory:
  379.  
  380.      PROMATH.EXE    program file
  381.      PROMATH.SET    program setup info
  382.      PROMATH.HLP    help file
  383.      PROMATH.DAT    session file
  384.      ORDER.ME       order form
  385.      ?????.BGI      the appropriate graphics interface for your monitor/-
  386.                     card
  387.  
  388. Optionally, you may want to include other saved session files which you
  389. have named.
  390.  
  391.  
  392. Running Off a Floppy Drive
  393.  
  394. If you must run from a floppy, copy the above listed files to a floppy
  395. disk.  We recommend using 720K or higher density diskette.  If disk space
  396. is limited, you may wish to save your session files to another disk.
  397.  
  398.  
  399. Registered Users
  400.  
  401. If you have taken advantage of registering this program, you may now follow
  402. the registration procedure provided to you.  If you later move or copy your
  403. program, the new copy will become unregistered and you would need to redo
  404. the registration procedure.  Of course, only you are licensed to have the
  405. registered version of this program.
  406.  
  407. To register, select 'Registration Code' from the 'Register' menu.  Then
  408. enter your personal registration code provided by us.
  409.                                 Quick Start
  410.  
  411. You want to give it a whirl before getting into the particulars?  Great!
  412. First, you must install the program and files as explained in the previous
  413. section.  Then, at the DOS prompt:
  414.  
  415.      Type:          promath<Enter>
  416.  
  417. You will see the title screen.  When prompted, press a key (<Enter> works
  418. well).  The main ProMATHeus II desk top appears.  If you have not registe-
  419. red, the top window will remind you that this is the "Test Drive Version"
  420. of the program.  This version is functional but does not have all of the
  421. registered version's many features.  Press <Enter>.
  422.  
  423. Let's analyze a 30-year, fixed-rate mortgage which nets, after closing
  424. expenses, $80,000.  We have two options: a 9% loan with no points down or a
  425. 8.5% loan with two points down.  In either case, we have to pay $500
  426. closing costs.  Which is better in the short-term?  The long-term?
  427.  
  428. Let's first calculate how much each loan would have to be to net $80,000:
  429.  
  430.      Type:          amount1=amount+500<Enter>
  431.                     amount2=(amount+500)/(1-.02)<Enter>
  432.  
  433. Several things happened.  First, two formulas were entered in the Formulas
  434. window and partially evaluated: 1-.02 became .9800.  However, since
  435. 'amount' is not known we don't have final answers yet.  Also, ProMATHeus II
  436. recognized that you defined three variables and entered them in the
  437. Variables window.  We don't know their values yet either.
  438.  
  439. We can use the internal function 'pmt' to get the monthly payment.  For the
  440. two options:
  441.  
  442.      Type:          pay1=pmt(amount1,.09/12,30*12)<Enter>
  443.                     pay2=pmt(amount2,.085/12,30*12)<Enter>
  444.  
  445.           Note: You could use the menu command 'Copy/Formula' to
  446.           edit a copy of the pay1 formula to become the pay2
  447.           formula.
  448.  
  449. Several things happened again.  First, two more formulas were entered in
  450. the Formulas window and were partially evaluated.  Two more unknown
  451. variables were entered in the Variables window.
  452.  
  453. So what's missing?  Type:     amount=80000<Enter>
  454.  
  455. Wow, everything is calculated!  Even though it costs more at the beginning,
  456. option 2 is cheaper in the long run.  By the way, we could have entered the
  457. formulas in any order and achieved the same results.  Now, we can define
  458. our own function to measure the final cost (fees, points, and interest) of
  459. each option:
  460.  
  461.      Type:          cost(points,pay,amount)=points*amount+360*pay-amount
  462. Note that a function has been defined in the Custom Functions window.  Now,
  463.  
  464.      Type:          cost1=cost(0,pay1,amount1)<Enter>
  465.                     cost2=cost(.02,pay2,amount2)<Enter>
  466.                     cost2-cost1<Enter>
  467.  
  468. Our own function did the work automatically!  Now we know the exact cost
  469. over the life of both options, and the difference in their costs.  What
  470. would be the payments and costs of a $100,000 mortgage?
  471.  
  472.      Type      amount=100000<Enter>     and find out!
  473.  
  474. ProMATHeus II is a powerful tool for users ranging from the beginning
  475. algebra student to the advanced engineering or scientific professional.  It
  476. shapes easily to fit the computational needs of each individual.
  477.                    Using ProMATHeus II: Basic Operation
  478.  
  479. Starting
  480.  
  481. First, you should install ProMATHeus II as described in the "Installation"
  482. section of this manual,  ProMATHeus II must be operated from the drive and
  483. directory in which it is installed.  First, set the correct drive (for
  484. example, type "C:").  Next, use the "cd" command (see your DOS manual) to
  485. set the correct directory.  For example,
  486.  
  487.      Type:          cd \promath<Enter>
  488.  
  489. Once in the correct directory, you may type one of the three command-line
  490. options:
  491.  
  492. promath<Enter>
  493.  
  494.      Upon entry, ProMATHeus II calls the PROMATH.DAT (formulas, functions,
  495.      and variables) and PROMATH.SET (options) files which contain the
  496.      complete previous session.
  497.  
  498. promath FILENAME<Enter>
  499.  
  500.      Upon entry, the previously saved session FILENAME will be loaded in
  501.      place of PROMATH.DAT.  This includes only the formulas, functions, and
  502.      variables.  The PROMATH.SET file is then called to set your session
  503.      characteristics.
  504.  
  505. promath 0
  506.  
  507.      ProMATHeus II will not recall the previous session or options and will
  508.      start with a clear screen with default values.  Also, users will have
  509.      to re-register.  Note: This is a fail-safe mechanism.  If you save the
  510.      session, or, exit with Alt-X or "Save and Exit", your previous
  511.      PROMATH.DAT and PROMATH.SET files will be overwritten.
  512.  
  513.  
  514. Creating a Session
  515.  
  516. Just what are you looking at?  The "ProMATHeus II Screen" section describes
  517. the various portions of the screen.
  518.  
  519. The basic stuff--your formulas, custom functions, variables, and values--
  520. are entered in the Input window (<F8>).  Generally, you enter information
  521. using the syntax of ProMATHeus II and let the program figure out what you
  522. intend.  The details of syntax and how you enter information are presented
  523. in the "Formulas" and "Variables" sections.  Functions, both internal and
  524. ones you create, are described in the "Functions" section.
  525.  
  526. After you've created a few formulas and functions, you'll want to know how
  527. to control the program.  The "Menus" section describes program control.
  528. Saving and Recalling Libraries of Formulas, Functions and Variables
  529.  
  530. Once you've mastered ProMATHeus II, you may want make it a tool for a
  531. number of disciplines: finance, math, statistics, engineering, science,
  532. etc.  To do so, simply save and retrieve libraries/sessions using the
  533. File/Save, File/Save-and-Exit, or File/Open menu commands.  See the "Menus"
  534. section for more details.
  535.  
  536.  
  537. Saving and Recalling Session Characteristics
  538.  
  539. ProMATHeus II stores session (colors, formats, defaults) information in its
  540. setup file PROMATH.SET.  Each time you end your session with "Save and
  541. Exit" or Alt-X the PROMATH.SET file is automatically updated.  Upon reentry
  542. into ProMATHeus II, the previous session characteristics are recalled
  543. automatically.
  544.                            ProMATHeus II Screen
  545.  
  546. The screen consists of several areas.  Their use is described in following
  547. sections.  For each area, a discription is followed by the key which calls
  548. it and the actions which can be performed on it.
  549.  
  550. Menu Line           This is the top line of the display from which you op-
  551.                     erate the program.  Pop-down menus can be selected with
  552.                     the <F10> and arrow keys, by pressing <Alt> and the
  553.                     first menu letter, or with a mouse.
  554.  
  555.                     Key: <F10>     Actions: (none)
  556.  
  557. Formula Window      This is (usually) the largest window and is always
  558.                     visible.  It includes a listing of all formulas and
  559.                     their calculated values.
  560.  
  561.                     Key: <F5>      Actions: resize, move
  562.  
  563. Function Window     Initially at the top left, this window lists all user-
  564.                     defined functions.
  565.  
  566.                     Key: <F6>      Actions: close, resize, move
  567.  
  568. Variable Window     Initially at the top right, this window lists all for-
  569.                     mula variables and their values.  If values are not de-
  570.                     termined, '--unknown--' appears.
  571.  
  572.                     Key: <F7>      Actions: close, resize, move
  573.  
  574. Input Window        This is the second line from the bottom.  This window
  575.                     automatically scrolls for long input.
  576.  
  577.                     Key: <F8>      Actions: (none)
  578.  
  579. Status Line         The bottom line which displays relevant information
  580.                     about key and menu options.
  581.  
  582.                     Key: (none)    Actions: (none)
  583.  
  584. Entry Menus         These appear when needed for you to control operation.
  585.  
  586.                     Key: (none)    Actions: close, move
  587.  
  588. Message Windows     These appear as necessary to give you operational
  589.                     information and inform you of errors.
  590.  
  591.                     Key: (none)    Actions: close, move
  592.                                  Formulas
  593.  
  594. Formulas are the beginning and end of ProMATHeus II.  Using formulas, you
  595. start with the problem you would like to solve and, ultimately, you receive
  596. that problem's solution.  In between, ProMATHeus II may have used numbers,
  597. other formulas, function calls, and variables to produce that solution.
  598. Functions and variables are discussed in following sections.
  599.  
  600. A ProMATHeus II formula can be as simple or complex as you like.  Pre-
  601. schoolers use it to solve beginning addition problems.  Physicists use it
  602. to solve optics equations.  You can enter several types of formulas.  The
  603. simplest is a direct calculation such as:
  604.  
  605. (Input window)
  606.   ??: 2+3      Note: In order to enter a formula or function, the cursor
  607.                must be in the Input Window.  If it is not, press <F8>.
  608.  
  609. After pressing <Enter> ProMATHeus II responds:
  610.  
  611. (Formula window)
  612.    1| 2+3 --> 5
  613.  
  614. The ProMATHeus II response consists of several parts:
  615.  
  616.      (number)(indicator) (original expression) --> (reduced expression)
  617.  
  618.           'Number' is used for copying and deleting formulas.
  619.  
  620.           'Indicator' identifies formulas which are evaluated once (|) from
  621.           those that will be re-evaluated continuously ().
  622.  
  623.           'Reduced expression' is the current value for the 'original
  624.           expression' which you typed.
  625.  
  626. When entering formulas, any number of parentheses may be used.  The input
  627. line is limited to 200 characters.  Longer equations can be split into sub-
  628. parts by using interim variables (see Hint Box).
  629.  
  630.  
  631. Entering Numbers
  632.  
  633. Numbers may be in decimal or scientific notation.  Numbers are carried
  634. internally to about 15 significant digits.  The following list is of
  635. acceptable numeric entries:
  636.      [sign]##.##e[sign][exponent]
  637.            2.3
  638.           -2.3
  639.            2.3e5
  640.           -2.3e-12
  641.  
  642. The number following the 'e' is the exponent of the base 10.  Thus 2.3e5 is
  643. the same as 2.3*10^5 or 230000.  The constant PI may be used.  It represents
  644. 3.14159265358979.  The range limit for values is +/-  1.7 x 10e-308 to
  645. 1.7 x 10e308.
  646.                                    Operators
  647.  
  648. ProMATHeus II offers three types of calculation operators: mathematical,
  649. logical and comparison.
  650.  
  651. Mathematical operators perform the basic arithmetic calculations.  In order
  652. of precedence (the details of operator precedence are discussed in the next
  653. section), they are:
  654.  
  655.      ^         power, for example, 2^3 --> 8
  656.      *  /  %   multiplication, division, remainder.  Example: 12%5 --> 2
  657.      +  -      addition, subtraction
  658.  
  659. There are four logical operators In order of precedence:
  660.  
  661.      !         not
  662.      &         and
  663.      |  #      or, exclusive or
  664.  
  665. With logical operators, a value of 0 is false and any non-zero value is
  666. true.  Logical operators return a value of either 0 or 1.  Thus:
  667.  
  668.      1|0 --> 1
  669.      1&0 --> 0
  670.      5.43|0 --> 1
  671.  
  672. In all other aspects, logical operators behave like regular ones.  Similar
  673. to logical operators are the conditional operators of:
  674.  
  675.      <         (greater than)
  676.      <=        (greater than or equal to)
  677.      >         (less than)
  678.      >=        (less than or equal to)
  679.      !=        (not equal to)
  680.      ==        (equal to--the double equals distinguishs it from the as-
  681.                signment equals)
  682.  
  683. These operators perform tests on two numbers and, like logic operators,
  684. return values of 0 or 1.  Thus, we can now have expressions like (these
  685. formulas introduce variables which are discussed in the next section):
  686.  
  687.      y=(x<0)*x/3 + (z!=9)*5
  688.  
  689. If x and z were equal to 5 and 7, respectively, then:
  690.  
  691.      y=(0)*3/3 + (1)*5
  692.       =5
  693.  
  694. One construction of interest is as follows:
  695.  
  696.      (x<0)*sqrt(-x)+(x>=0)*sqrt(x)
  697.  
  698. It would seem that this might eliminate taking the square root of a
  699. negative number.  However, it would cause an error because every part of a
  700. formula is evaluated whether it's needed or not!  The internal function
  701. "if" takes care of that.  See the "Functions" section.
  702.  
  703.  
  704. Calculation Precedence
  705.  
  706. The order in which a formula is evaluated is critical.  Does 2+3*5 equal 25
  707. (doing the addition first) or 17 (doing the multiplication first)?  Left-
  708. to-right reading logic might suggest the first.  Mathematical convention
  709. makes the second choice the correct one.  The precedence used by ProMATHeus
  710. II is shown below:
  711.  
  712.                     Highest:  () including functions
  713.                               !
  714.                               ^
  715.                               *  /  %
  716.                               +  -
  717.                               >=  >  <=  <
  718.                               !=  ==
  719.                               &  |  #
  720.                               [other operators]
  721.                     Lowest:   [left-to-right]
  722.  
  723. Note that given no other operator precedence, calculations are performed
  724. left to right.
  725.  
  726. Some examples demonstrating precedence are:
  727.  
  728. (Formula window)
  729.    1| 2*3+5 --> 11
  730.    2| 2+3*5 --> 17
  731.    3| 2*(3+5) --> 16
  732.    4| 2^3*5 --> 40
  733.    5| 2^3^2 --> 64
  734.    6| 2^(3^2) --> 512
  735.                                  Variables
  736.  
  737. An important feature of ProMATHeus II are variables which allow formulas to
  738. interact and serve as numeric memories.  Variables names must begin with an
  739. alpha character (a-z _ A-Z) and may be followed by up to nine alphanumeric
  740. characters (a-z _ A-Z 0-9).  The constant PI cannot be used as a name.
  741. While function names can also be used as variable names in some cases, this
  742. practice is not recommended.
  743.  
  744. Formulas can contain variables in place of numbers.  ProMATHeus II evalu-
  745. ates as much of the formula as it can and prints the result after the
  746. arrow.  For example, if you entered:
  747.  
  748. (Input window)
  749. ?? cents+5*nickels
  750.  
  751. Then, one of the following would result:
  752.  
  753. (Formula window)
  754.    1 cents+5*nickels --> cents+5*nickels    if cents & nickels are un-
  755.                                               known,
  756.  
  757.    1 cents+5*nickels --> 7+5*nickels        if cents equals 7,
  758.  
  759.    1 cents+5*nickels --> cents+15           if nickels equals 3, or,
  760.  
  761.    1 cents+5*nickels --> 22                 if both variables are known.
  762.  
  763. Note the symbols next to the formula numbers are  instead of |.   signi-
  764. fies an "active" formula with variables which will be recalculated with
  765. each press of the <enter> key.  | signifies an "inactive" formula (without
  766. variables) which is calculated only once.
  767.  
  768. The Variables window keeps track of all variables and their values, if
  769. known.  I f you have a large number of variables, you may need to scroll or
  770. resize this window to see all of them.  See the information on "Windows"
  771. and the "Windows/Size" command for more information.
  772.  
  773. The simplest way for a variable to become "known" is through an assignment
  774. expression, like 'cents=9', as shown in the Input Window below.  Simple
  775. assignments like this do not become formulas--they simply update the value
  776. of the variable involved.  Variables also become "known" through assignment
  777. formulas like formulas 2 and 3 below.  Note that variables assigned to a
  778. constant expression (formula 2) are evaluated only once (i.e., '|' is the
  779. indicator).  Since the Input Window reassigns "cents" to equal 9, this
  780. value is used for "cents" in formula 1 (which is active) and the older
  781. information of formula 2 (which is inactive) is ignored.
  782. (Formula window)
  783.    1 cents+5*nickels --> 9+5*nickels
  784.    2| cents=10-3 --> cents=7
  785.    3 rabbits=5*carrots+6 --> 5*carrots+6
  786. (Input window)
  787.    cents=9
  788.  
  789. A variable retains its value until it is:
  790.  
  791. -    changed by another assignment expression (as "cents" is in the Input
  792.      window above),
  793.  
  794. -    changed by a current assignment expression (as rabbits is in #3
  795.      above),
  796.  
  797. -    set to --unknown-- by the "Erase/Clear Variables" command (see Menu
  798.      Commands).
  799.  
  800. A variable cannot be "clear"ed if it is defined by an active assignment
  801. expression (like the variable 'rabbits' in formula #3).  However a depen-
  802. dent variable (like  "rabbits") will automatically be set to --unknown-- if
  803. any of its assignment expression variables (e.g., "carrots") is
  804. --unknown--.
  805.  
  806. If two formulas are both active and define the same dependent variable, the
  807. first formula is in effect until deleted.
  808.                                  Functions
  809.  
  810. Functions are another part of formulas which provide an easy way to do
  811. detailed calculations.  There are two types: internal ProMATHeus II
  812. functions and custom functions which you have created.  Simply enter them
  813. in your formulas in the correct format.  For example:
  814.  
  815. (Formula window)
  816.    1 x=log(2) --> x=.301029995663981
  817.  
  818. You may input any valid expression (including variables and other func-
  819. tions) into a function.  Thus, the following are valid:
  820.  
  821. (Formula window)
  822.    1 y=log(2+z) --> y=1.39794000867204
  823.    2| z=19+4
  824. or
  825.    1| log(log(12)+3*log(13)) --> .645521625245258
  826.  
  827.  
  828. ProMATHeus II Internal Functions
  829.  
  830. Internal functions are listed in the Help screens <F1>.  Note that some
  831. functions are available to registered users only.
  832.  
  833.  
  834. The IF Function (Registered users only)
  835.  
  836. The "if" function works like the conditional operators discussed in the
  837. "Formulas" section except that it throws out the part of the formula it
  838. doesn't need!  It is of the form if(condition, if true, if false).  Thus if
  839. the condition is true, the second argument is executed, if false, the
  840. third.  Thus the formula we discussed before could be easily handled as
  841. follows:
  842.  
  843.      (x<0)*sqrt(-x)+(x>=0)*sqrt(x)      Previous version
  844.      if(x<0,sqrt(-x),sqrt(x))           Better version
  845.  
  846. Some interesting constructs are possible.  Try the following with various
  847. combinations of  a, b, and e set to 0 or 1:
  848.  
  849.      if(a,if(b,c,d),if(e,f,g))
  850.  
  851.  
  852. Logarithmic
  853.  
  854. In addition to the power operator (^), these functions are available:
  855.  
  856.      log(x)         x>0       logarithm to the base 10
  857.      ln(x)          x>0       logarithm to the base e
  858.      exp(x)                   exponential function (e^x)
  859. Trigonometric
  860.  
  861. The following functions are defined over their usual ranges:
  862.  
  863.      sin(x)    sine of x
  864.      cos(x)    cosine of x
  865.      tan(x)    tangent of x
  866.      asin(x)   arcsine of x
  867.      acos(x)   arccosine of x
  868.      atan(x)   arctangent of x
  869.      rad(x)    convert from degrees to   radians
  870.      deg(x)    convert from radians to degrees
  871.  
  872. These functions use and return angles measured in radians.  Thus, to get
  873. the cosine of PI/3 radians enter "cos(PI/3)".  To get the cosine of 60 de-
  874. grees (which equals PI/3 radians) enter "cos(rad(60))".  Conversely, to get
  875. the number of degrees associated with a sine of .5 enter "deg(asin(.5))".
  876.  
  877. (Registered users only) Hyperbolic functions are also included.  They are:
  878.  
  879.      sinh(x)        hyperbolic sine of x    = ( e^x - e^(-x) ) / 2
  880.      cosh(x)        hyperbolic cosine of x  = ( e^x + e^(-x) ) / 2
  881.      tanh(x)        hyperbolic tangent of x = sinh(x) / cosh(x)
  882.      asinh(x)       hyperbolic arcsine of x
  883.      acosh(x)       hyperbolic arccosine of x
  884.      atanh(x)       hyperbolic arctangent of x
  885.  
  886. The latter functions are inverses of the first three.
  887.  
  888.  
  889. Financial
  890.  
  891. Three functions are provided for amortization calculations:
  892.  
  893.      pmt(balance,interest,periods)
  894.      loan payment
  895.  
  896. (Registered users only)
  897.      pv(payment,interest,periods)
  898.      present value of a series of payments
  899.  
  900.      fv(payment,interest,periods)
  901.      future value of a series of payments
  902.  
  903. The interest rate must be the decimal equivalent of the interest rate per
  904. period. Thus 10% annually with monthly payments requires either a 10/1200
  905. or a .0083 entry.  For example, the monthly payments for a five-year, 10%,
  906. $4000 loan:
  907.  
  908.      pmt(4000,10/1200,5*12) --> 84.99
  909.  
  910. The present and future values of payments of $84.99 at 10% annual interest
  911. for five years is:
  912.      pv(84.99,10/1200,5*12) --> 4000.00
  913.      fv(84.99,10/1200,5*12) --> 6581.38
  914.  
  915.  
  916. Statistical
  917.  
  918. The following functions are provided (values must be non-negative inte-
  919. gers):
  920.  
  921.      fact(x)   The factorial of x which is the product of x with all posi-
  922.                tive integers below it.  For example, fact(4)=4*3*2=24.
  923.  
  924.      comb(n,r) (Registered users only) The number of combinations (order
  925.                does not matter) of n things taken r at a time.  For objects
  926.                A, B, C, and D, they can be grouped in twos as: AB, AC, AD,
  927.                BC, BD, CD.  Thus comb(4,2)=6.
  928.  
  929.      perm(n,r) (Registered users only) The number of permutations (order
  930.                does matter) of n things taken r at a time.  The pairs in
  931.                the above example can be ordered in two ways.  Thus
  932.                perm(4,2)=12.
  933.  
  934. Functions which estimate the following standard statistical distributions,
  935. and their inverses, are also provided.  These functions are based on the
  936. integral of their respective density functions from -∞ to x:
  937.  
  938.      Function            Returns   Distribution
  939. (All users)
  940.      norm(x,mean,stdev)    1-p     Normal distribution
  941.      inorm(p,mean,stdev)    x      Inverse Normal distribution
  942.  
  943. (Registered users only)
  944.      chi(x,df)             1-p     Chi-Square distribution
  945.      ichi(p,df)             x      Inverse Chi-Square distribution
  946.      fdis(x,df1,df2)       1-p     F-distribution
  947.      ifdis(p,df1,df2)       x      Inverse F-distribution
  948.      tdis(x,df)            1-p     student's t-distribution
  949.      itdis(p,df)            x      Inverse student's t-distribution
  950.      gamma(x)              1-p     Gamma distribution [no inverse]
  951.      erf(x)                 *      The statistical error function
  952.  
  953. In the above:
  954.  
  955.      x    is the test value
  956.      p    is the probability that the value of x will be exceeded
  957.      df   is the degrees of freedom
  958.      *    is a value used in the estimation of some statistical distri-
  959.           butions.
  960.  
  961. For example, the test value for the 95th-percentile of the standard normal
  962. distribution is given by inorm(.95,0,1) = 1.645.  That is, only 5% of
  963. observations of a population with mean 0 and standard deviation of 1 would
  964. be expected to exceed 1.645.
  965. The details of these distributions are beyond the scope of this manual.
  966. Users are urged to consult a college textbook.
  967.  
  968.  
  969. Date and Time Functions (Registered Users Only)
  970.  
  971. Several functions are provided to aid in time calculations.  The 'date'
  972. function converts the date into the number of days since January 1, 1900.
  973. The 'year', 'mon', and 'day' functions reverse this conversion.  For
  974. example, the number of days between 2/24/83 and 7/2/99 is:
  975.  
  976. date(1999,7,2) - date(1983,2,24) = 5972
  977.  
  978. Similarly, the 'time' function converts the time of day to fractions of a
  979. day since midnight.  The 'hour', 'minute', and 'sec' functions convert
  980. back.  Since time and dates are based on days, they can be added for
  981. calculations to get the number of full and partial days since 1/1/1900.
  982.  
  983.      date(y,m,d)    Converts year, month and day into the number of days
  984.                     since 1/1/1900.  Year must be 1900 or greater, other
  985.                     values must be valid.
  986.  
  987.      year(x)        Converts x into year.
  988.  
  989.      mon(x)         Converts x into month of year.
  990.  
  991.      day(x)         Converts x into day of month.
  992.  
  993.      time(h,m,s)    Converts hours, minutes, and seconds into fraction of
  994.                     day since midnight.
  995.  
  996.      hour(y)        Converts fractional day into hours since midnight.
  997.  
  998.      minute(y)      Converts fractional day into minutes since the hour.
  999.  
  1000.      sec(y)         Converts fractional day into seconds since the last
  1001.                     minute.
  1002.  
  1003.  
  1004. Other
  1005.  
  1006. The following mathematical functions are also included:
  1007.  
  1008.      int(x)         Returns the integer portion of a number
  1009.      abs(x)         Returns the absolute value of a number
  1010.      sqrt(x)        Returns the square root of a number
  1011. Custom Functions
  1012.  
  1013. Customs functions are created by naming the function, listing the function
  1014. variables, and assigning a valid arithmetic expression.  For example:
  1015.  
  1016. (Function window)
  1017.   1: f(x)=x*x-3
  1018.   2: g(q)=2*q+3
  1019.   3: fire(fuel,heat)=f(fuel)*3-g(4+heat)
  1020.  
  1021. The function definition must be of the following form:
  1022.  
  1023.      (name)(variable list)=(equation using "variable list" variables only)
  1024.  
  1025. The function name must be of the form defined for variables in the Formulas
  1026. section.  The function variable list may include a list of up to ten
  1027. function variables and is of the form:
  1028.  
  1029.      (var1,var2,var3,...)
  1030.  
  1031. These variables are used for the function definition only and are not
  1032. retained as regular variables of ProMATHeus II.  All function variables in
  1033. the equation to the right of the equal sign must be in the function
  1034. variable list.   Any functions called by a function must have been already
  1035. defined.  With the above functions:
  1036.  
  1037. (Formula window)
  1038.   1 fire(5,3) --> 49
  1039.  
  1040. If all function variables are known, a function will return the calculated
  1041. value, otherwise the function is not evaluated.  Thus if a value for "ce-
  1042. ment" is supplied but not for "gravel", formula 1 below is not evaluated:
  1043.  
  1044. (Function window)
  1045.   1: concrete(cement,gravel)=cement*3+gravel*2
  1046.  
  1047. (Formula window)
  1048.   1 concrete(cmnt,rocks) --> concrete(15,rocks)
  1049.   2| cmnt=15
  1050.  
  1051. Functions may be changed by using the "Copy/Custom Functions" command (see
  1052. Menu Commands) which copies function # to the Input window for editing.
  1053. Note that even though a function is changed, values of function calls in
  1054. inactive formulas (|) do not change.
  1055.  
  1056. Although presented only briefly, custom functions are one of ProMATHeus
  1057. II's most important features.  You can customize ProMATHeus II for many
  1058. different uses by creating libraries of custom functions.
  1059. Solving Custom Functions
  1060.  
  1061. The solve operation allows you to solve any custom function for any one of
  1062. its function variables, given:
  1063.  
  1064.      1.   Supplied values for its other function variables,
  1065.      2.   The desired value which the function would normally return, and,
  1066.      3.   A starting guess of the function variable which is being solved
  1067.           for.
  1068.  
  1069. It uses an iterative technique (Newton-Raphson) which may or may not con-
  1070. verge.  Convergence and the solution achieved are aided by a good starting
  1071. guess for the value.  Assume a defined custom function 'f' which returns
  1072. the value 'a':
  1073.  
  1074.      a = f(...,b,c,d,...)    [i.e., any number of parameters]
  1075.  
  1076. If all other function variables are known (including 'b' and 'd'), then an
  1077. estimate of 'c' would be entered as:
  1078.  
  1079.      estimate of c  = f(...,b value,{desired a ,guess of c},d value,...).
  1080.  
  1081. That is, the value of 'c' is replaced by two numbers in braces--the desired
  1082. outcome and a first guess.
  1083.  
  1084. Thus if        f(s,t)=s*s+t,
  1085.      then      f(3,5) --> 14,
  1086.      and       f({14,1},5) --> 3.
  1087.  
  1088. Internal functions are solved by creating custom functions with them.  As
  1089. mentioned in a previous hint:
  1090.  
  1091. (Function Window)
  1092.      pay(b,i,n)=pmt(b,i,n)
  1093. (Formula Window)
  1094.   1 interest=pay(balance,{payment,guess},periods)
  1095.  
  1096. If difficulties are encountered, try different starting guesses for the
  1097. value.  Also, change the values in the "Setup/Max Solve Error" and "Set-
  1098. up/Max Solve Iterations" menus.  The first effects the difference used in
  1099. the iteration process (specifically, the derivative calculation).  The
  1100. default is 1e-7.  The second affects the maximum number of iterations used
  1101. to solve the function.  The default is 50.
  1102.  
  1103.  
  1104. Calculus and Custom Functions (Registered Users Only)
  1105.  
  1106. Custom functions can be integrated over a range or differentiated at a
  1107. point through numeric approximation.
  1108.  
  1109. The intg(fn#,begx,endx) function will integrate custom function fn# using a
  1110. Simpson's rule type of approach, if possible.  You can control the number
  1111. of intervals it uses with the 'Setup/Integration Intervals' command.  The
  1112. default is 50.  The lower the number the faster, the higher the more
  1113. accurate, within some limits.
  1114.  
  1115. The der(fn#,x) function takes the slope or derivative of custom function
  1116. fn# at the point x.  You can control the increment it uses in this calcula-
  1117. tion with the 'Setup/Max Solve Error' command.  (This same value is used in
  1118. the Solve feature of ProMATHeus II.)  The default is 1e-7.  Because of the
  1119. inherent problems of truncation and roundoff errors, you may want to
  1120. experiment with different values of this error value.
  1121.  
  1122. For example, given the function g(x) = x2+1, to solve its integral from x=0
  1123. to x=5 first create the custom function g(x)=x^2+1.  Let's assume it
  1124. becomes custom function #3.  Then simply enter the formula intg(3,0,5) to
  1125. get 46.6667, the desired answer.  By the way, the derivative of function
  1126. 'g' at 5 is then der(3,5) which returns the answer 10.
  1127.  
  1128.  
  1129.                                    Menus
  1130.  
  1131. The main menu appears horizontally across the top of the screen.  Menu
  1132. items help you control how ProMATHeus II operates.  Menu items can be
  1133. selected in four ways:
  1134.  
  1135. -    Press <F10> and the first letter of the menu item.
  1136. -    Press <F10> and use the left/right arrows and press <Enter>.
  1137. -    Press <Alt> and the first letter of the menu item.
  1138. -    Click the menu item with the mouse cursor.
  1139.  
  1140. Similarly, pull-down menu items can be selected in the same fashion:
  1141. -    Press the first letter of the menu item.
  1142. -    Use the up/down arrows and press <Enter>.
  1143. -    Click the menu item with the mouse cursor.
  1144. -    You can select a menu item at any time by pressing its <F#> key, if
  1145.      applicable.
  1146.  
  1147. The function of each menu item follows.
  1148.  
  1149.                                  Data Menu
  1150.  
  1151. The Data menu contains commands regarding clearing, saving, and recalling
  1152. sessions, the ProMATHeus II program, and exiting.
  1153.  
  1154. Data/Open: Retrieve session formulas, functions and variables
  1155.  
  1156.      Sessions are saved and retrieved automatically into the PROMATH.DAT
  1157.      file.  However, as you develop various applications, you'll want to
  1158.      save them into separate retrievable files.
  1159.  
  1160.      Selecting Data/Open command opens the "Read Data File" menu.  This
  1161.      menu consists of two sections and two buttons.  The first section can
  1162.      be used to enter a filename from the keyboard.  The wildcards of ? and
  1163.      * can be used to modify the files listed in the "Files" section.
  1164.      Clicking the down arrow with the mouse will display previous file
  1165.      names you have used.
  1166.      The "Files" section allows you to page through and select file names.
  1167.      You can also move up and down directory lists by selecting them in
  1168.      this section.
  1169.  
  1170.      Once a file has been highlighted or entered, select the "Open" button
  1171.      or press <Enter> to open the file.
  1172.  
  1173.      Use <Tab>, arrows, and page up and down, or a mouse to move around
  1174.      this menu.
  1175.  
  1176. Data/Save: Save session formulas, functions and variables
  1177.  
  1178.      To save a session, simply enter the file name.  Path names may be
  1179.      included.  ProMATHeus II will check before overwriting previously
  1180.      saved files of the same name.
  1181.  
  1182. Data/Clear: Clear all formulas, functions, and variables WITHOUT SAVING
  1183.  
  1184.      This is permanent--use with caution.  If you do so by accident, you
  1185.      can restore ProMATHeus II to the condition it was when you first
  1186.      started by using the Data/Open command to read the PROMATH.DAT file.
  1187.  
  1188. Data/DOS Shell: Shell to DOS prompt
  1189.  
  1190.      At the prompt, you can execute DOS commands and return by typing
  1191.      "exit".
  1192.  
  1193. Data/Memory: Display the usage of available memory
  1194.  
  1195.      This provides and indication of remaining memory.  Memory usage varies
  1196.      with your use of commands and menus.  For this reason, memory percent-
  1197.      age may not equal 100% after a clear of all data.
  1198.  
  1199. Data/About: Program information
  1200.  
  1201.      Displays program and registration information.
  1202.  
  1203. Data/Save and Exit (Alt-x): Save session, then exit
  1204.  
  1205.      The session is saved to PROMATH.DAT (or the current session file) and
  1206.      current session characteristics are updated to PROMATH.SET.
  1207.  
  1208. Data/Quit and Exit: Quit without saving
  1209.  
  1210.      The program quits, nothing is saved (and PROMATH.DAT is not updated).
  1211.                                 Window Menu
  1212.  
  1213. Windows can be controlled with the keyboard or mouse.  Windows, and the
  1214. keys used for selecting them, are described in the table of the "ProMATHeus
  1215. II Screen" section.  To change a window it must be selected:
  1216.  
  1217. Keyboard: Either press the <F#> key defined in the table or select from the
  1218.           menu.
  1219.  
  1220.           Alternatively, use the <F3> to cycle through open windows.
  1221.  
  1222. Mouse:    Select the desired window in the Window submenu as described in
  1223.           the "Menu" section.  Or, just click on any open window to select
  1224.           it.
  1225.  
  1226. To scroll a window:
  1227.  
  1228. Keyboard: The arrow, Page Up, Page Down, Home, and End keys all function to
  1229.           scroll the active window.  The Variables window may only be
  1230.           scrolled up and down.
  1231.  
  1232. Mouse:    Click on the scroll bars, or their arrows, to scroll the screen.
  1233.  
  1234. The following are window menu commands:
  1235.  
  1236. Window/Next (F3): Move to next window
  1237.  
  1238.      This command cycles between open windows.
  1239.  
  1240. Window/Zoom (F4): Zoom current window
  1241.  
  1242.      Zoom toggles the current window between its current size and full
  1243.      screen.
  1244.  
  1245.      Mouse:    Clicking the upper, right-hand arrow does the same thing.
  1246.  
  1247. Window/Close (Ctrl-F3): Close current Custom Functions or Variables window
  1248.  
  1249.      Only a Custom Functions, Variables, or message window may be closed.
  1250.      While you could use this menu command, pressing <Ctrl><F3> or <Esc> is
  1251.      usually easiest.
  1252.  
  1253.      Mouse:    Click on the square in the upper left border.
  1254.  
  1255. Window/Size (Ctrl-F4):  Resize or move current window
  1256.  
  1257.      To resize a Formulas, Custom Functions, or Variables window, use the
  1258.      <Shift> arrow keys to resize and the <Enter> key to quit.
  1259.  
  1260.      Mouse:    Move the mouse cursor over the bottom right corner of the
  1261.                window.  Click and hold down the mouse button.  Drag the
  1262.                corner to the desired size and release.
  1263.      To move a Formulas, Custom Functions, Variables, or message window:
  1264.      use the arrow keys to move and the <Enter> key to quit.
  1265.  
  1266.      Mouse:    Move the mouse cursor over the top border of the window.
  1267.                Click and hold down the mouse button.  Drag the window to
  1268.                the desired location and release.
  1269.  
  1270. Window/Formulas (F5):              Choose Formulas window
  1271. Window/Custom Functions (F6):      Choose Custom Functions window
  1272. Window/Variables (F7):             Choose Variables window
  1273. Window/Input (F8):                 Choose Input window
  1274.  
  1275.      These menu commands and function keys bring the selected window to the
  1276.      top of the screen.
  1277.  
  1278.      Mouse:    Click anywhere on the visible portion of the desired window.
  1279.  
  1280.  
  1281.                                  Copy Menu
  1282.  
  1283. This menu is used to copy formulas or functions to the Input window for
  1284. editing.
  1285.  
  1286. Copy/Formula: Copy a formula for editing
  1287. Copy/Custom Function: Copy a function for editing
  1288.  
  1289.      Enter the desired formula or function number in the menu provided.  If
  1290.      you create a second formula with the same dependent variable, you will
  1291.      need to then erase the first formula, as shown below.
  1292.  
  1293.  
  1294.                                 Erase Menu
  1295.  
  1296. You can use the Erase menu to delete formulas, functions, or variables.
  1297.  
  1298. Erase/Formula(s): Delete one or more formulas
  1299.  
  1300.      Enter a list of formulas to be deleted in the menu provided.  A hyphen
  1301.      may be used to indicate a range.  Thus, "1 5-8 10" would delete equa-
  1302.      tions 1, 5, 6, 7, 8, and 10.  Variables contained in deleted formulas
  1303.      are not deleted.
  1304.  
  1305. Erase/Function(s): Delete one or more unused custom functions
  1306.  
  1307.      Enter a list of functions to be deleted in the menu provided.  Thus,
  1308.      "1 5 6 7 8 10" would delete equations 1, 5, 6, 7, 8, and 10.  Func-
  1309.      tions which are used in any formula are not deleted.  Because custom
  1310.      functions are not stored in order (for program speed reasons), there
  1311.      is no range delete.
  1312. Erase/Clear Variable(s): Clear independent variable(s) to --unknown--
  1313.  
  1314.      Enter a list of variables to be cleared in the menu provided.  Only
  1315.      variables which are not dependent (assigned on the left of the equals
  1316.      sign in an active formula) are affected.  If "ALL" is entered, all
  1317.      qualifying variables are cleared.
  1318.  
  1319. Erase/Erase Variable(s): Erase unused variables
  1320.  
  1321.      Enter a list of variables to be erased in the menu provided.  Only
  1322.      variables which are not included in any formula are affected.  If
  1323.      "ALL" is entered, all qualifying variables are erased.
  1324.  
  1325.  
  1326.                                 Print Menu
  1327.  
  1328. Print/Report: Print a report of formulas, functions, and variables
  1329.  
  1330.      When your printer is ready, press <Enter> or mouse click "Yes" on the
  1331.      confirmation window.  The ProMATHeus II report assumes an 80 column
  1332.      printer.  To customize your report, use the following setup command.
  1333.  
  1334. Print/Setup: Define printer codes
  1335.  
  1336.      The "Printer Setup" window appears.  Use the mouse or <Tab>,
  1337.      <Space_Bar> to make your selections.
  1338.  
  1339.           Printer Setup Strings:  To customize your output, you may enter
  1340.           any printer codes to be sent before or after the printed report.
  1341.           Codes must be entered in hexadecimal (base 16) separated by
  1342.           spaces.  See your printer manual for details.
  1343.  
  1344.           Form Feed: Check if you would like a form feed sent before or
  1345.           after printing.
  1346.  
  1347.           Print Items: You may select which of Variables, Formulas, or
  1348.           Custom Functions you would like printed.
  1349.  
  1350.           Page width: Enter your desired page width.  ProMATHeus II will
  1351.           reformat the report to fit this width.
  1352.  
  1353.  
  1354.                                 Graph Menu
  1355.  
  1356. Graph/Draw: Graph up to 5 custom functions
  1357.  
  1358.      ProMATHeus II will graph up to five, one-variable, custom functions.
  1359.      The program will automatically select one of the following graphic
  1360.      modes (in priority order): VGA, EGA, CGA, or mono graphics.  If you
  1361.      have difficulty or a non-standard monitor/card, contact Blarney Stone
  1362.      Software.
  1363.      This command brings up the "Custom Function Graph Setup" screen.  Use
  1364.      <Tab> to move between items.  <Space-bar> will select items and
  1365.      <Enter> will begin graphing (if the Graph button is highlighted).
  1366.  
  1367.      Title: Enter a title you would like to appear on the graph.
  1368.  
  1369.      Functions #s:  Enter up to five, one-variable function numbers.
  1370.  
  1371.      X-Range:  Enter the beginning and ending horizontal axis values, which
  1372.      must differ.
  1373.  
  1374.      Y-Range:  Enter the beginning and ending vertical axis values, which
  1375.      must differ.  This is not required if "Automatic Y-Range" is selected
  1376.      below.
  1377.  
  1378.      Automatic Y-Range:  This uses the entire vertical screen to show the
  1379.      graphs (showing the max and min values of all graphs).  Be wary if
  1380.      your functions approach infinity!
  1381.  
  1382.      Square X & Y Ranges:  This creates Y units of length to the X units on
  1383.      the screen.  The graph is centered on the max and min Y values.
  1384.  
  1385.      Color:  Leaving this blank (i.e., black and white) is usually best for
  1386.      printing the graphs.
  1387.  
  1388.      Grid:  Draw grid lines on the graph.
  1389.  
  1390.      Quality:  Choose "Rough" for the quickest graph, "Fine" for the best
  1391.      quality.
  1392.  
  1393.      Once graphed, pressing "z" or "Z" zooms the graph in or out.  Pressing
  1394.      <Enter> returns to the main ProMATHeus II windows.  If your printer is
  1395.      compatible with the DOS "graphics" command, you can print the graphs
  1396.      by pressing <Shift><Print Screen>.  This requires you to enter the DOS
  1397.      "graphics" command before starting ProMATHeus II.  Please see your DOS
  1398.      manual for details.
  1399.  
  1400. Although graphing should work on all computer types, it is of course
  1401. fastest on 286 or faster machines.  Several factors can increase calcula-
  1402. tion time significantly:
  1403.  
  1404. -    The time increases proportionately to the number of functions request-
  1405.      ed.
  1406.  
  1407. -    Functions calling other functions or using the "solve" feature will
  1408.      have significantly more functions calls, and hence computation time.
  1409.  
  1410. -    Each level of refinement of graph "Quality" doubles the calculation
  1411.      time.
  1412.                                 Setup Menu
  1413.  
  1414. Setup/Numeric Format: Change numeric format of variables & ACTIVE formulas
  1415.      On the "Numeric Format" window, select the style (fixed decimal or
  1416.      scientific notation) and the number of digits.  Fixed format will
  1417.      automatically convert to scientific for extreme values.  This only
  1418.      affects the appearance of the values, not the method of input or the
  1419.      stored values.
  1420.  
  1421. Setup/Colors: Change colors
  1422.  
  1423.      Using the mouse or <Tab> and arrow keys, select the group you would
  1424.      like to change in the first column.  Then, select the desired Item
  1425.      within that group in the second column.  Lastly, select the desired
  1426.      foreground and background colors in the last column.  An example of
  1427.      your selection is shown in the bottom right corner.
  1428.  
  1429.      Main screen:   ProMATHeus II automatically selects your video mode:
  1430.                     color, monochrome, or black and white.  The palette you
  1431.                     see should differ based on this selection.
  1432.  
  1433.      Graphing:      Graph colors are selected automatically and cannot be
  1434.                     changed.
  1435.  
  1436.  
  1437. Setup/Max Solve Iterations: Change the maximum number of iterations used to
  1438. solve functions.
  1439.  
  1440. Setup/Max Solve Error: Change the maximum error allowed, for function
  1441. solving and differentiation.
  1442.  
  1443.      The "solve" feature of functions uses an iterative procedure to
  1444.      estimate the function solution.  That process continues until either
  1445.      the estimation error is less than the maximum allowed error or the
  1446.      maximum number of iterations is reached.
  1447.  
  1448.      Enter your desired value in the entry screen.
  1449.  
  1450.  
  1451.                                Register Menu
  1452.  
  1453. Register/Benefits: Benefits to you for upgrading to ProMATHeus II
  1454.  
  1455. Register/MasterCard/Visa: Information on ordering by telephone
  1456.  
  1457.      These commands call the help screen for further information.
  1458.  
  1459. Register/Order Form: Print an order form for this and other products
  1460.  
  1461.      At the confirm window, when the printer is ready, select "Yes".
  1462. Register/Registration Code: Enter the registration code for this program.
  1463.  
  1464.      If you are a legal registrant of the program, enter the registration
  1465.      code provided with your materials.  This code is available for your
  1466.      use only!  All features will be available to you instantly.  Thanks
  1467.      for your support!
  1468.  
  1469.  
  1470.                                Other Matters
  1471.  
  1472. Formula, Function, and Variable Order
  1473.  
  1474. ProMATHeus II was designed to balance speed, memory usage, and ease of use.
  1475.  
  1476. If the same variable is defined by two different formulas, the result is
  1477. order dependent in the following manner:
  1478.  
  1479.      If the first assignment was in a inactive formula--the latter assign-
  1480.      ment of the same variable supersedes the first.  For example:
  1481.  
  1482.           (Formula window)
  1483.           1| y=12+5 --> y=17
  1484.           2| y=12+9 --> y=21
  1485.  
  1486.           (Variable window)
  1487.           y: 21
  1488.  
  1489.           Since the first definition is the oldest, it is ignored and y=21.
  1490.  
  1491.      Otherwise, the second assignment is ignored until the first is delet-
  1492.      ed.  For example:
  1493.  
  1494.           (Formula window)
  1495.           1 y=x+5 --> y=17
  1496.           2| x=10+2 --> x=12
  1497.           3| y=12+9 --> y=21
  1498.  
  1499.           (Variable window)
  1500.           y: 17
  1501.           x: 12
  1502.  
  1503.           Since x=12, and the first equation is updated by x, now the third
  1504.           equation is ignored even though it is newer.  Thus y=17, not 21.
  1505.  
  1506. Formulas are listed and numbered in order of their entry.  For speed, it is
  1507. more efficient to not restrict functions and variables to any order.  Thus,
  1508. they are placed in the first available space in their lists.  In fact,
  1509. deleted function numbers are only replaced when new functions are entered.
  1510. The same is true for the order of variables in the Variable Screen.
  1511. Circularity
  1512.  
  1513. Circularity occurs when a formula or function calls itself, possibly
  1514. through a long chain.  ProMATHeus II does not allow circularity within
  1515. functions (unless you are too ambitious with the "solve" feature) as it
  1516. would cause an infinite loop.  Formulas are allowed to be circular as it
  1517. might be required temporarily with some editing tasks.  Generally,
  1518. ProMATHeus II will return no values for any formulas which contain circu-
  1519. larity.  In most cases, you would want to delete formulas which create
  1520. circularity.
  1521.  
  1522.  
  1523. Error Messages
  1524.  
  1525. ProMATHeus II displays a number of error messages.  Calculation errors are
  1526. indicated in the "reduced expression" portion of a formula listing.  Opera-
  1527. tional error messages appear in Error windows and begin with two numbers:
  1528. the first is an internal code for Blarney Stone Software's use and the
  1529. second identifies, if possible, the formula where the error occurred.
  1530. ProMATHeus II detects many input errors and makes you correct them before
  1531. proceeding.
  1532.  
  1533.  
  1534. Sample Sessions
  1535.  
  1536. FINANCE.DAT and STATS.DAT are provided as short examples of the power of
  1537. ProMATHeus II's custom functions.  The first includes loan analysis
  1538. functions for determining the difference in total interest between a 15 and
  1539. 30 year mortgage.  The second shows the development of the binomial and
  1540. Poisson distributions.  You may retrieve them using the Data/Open command
  1541. described previously.
  1542.  
  1543.  
  1544. File Backup
  1545.  
  1546. Please be sure to back up your files.  This program does check for data
  1547. corruption (this can be caused by a number of factors, including hardware
  1548. failure or attempts to hack the program) and will refuse to run if the
  1549. files do not check out.  In that case, your only recovery will be from your
  1550. backup.
  1551.  
  1552.  
  1553. Problems
  1554.  
  1555. With a free-form entry system like ProMATHeus II, occasionally what you
  1556. enter may confuse ProMATHeus II as to what you intend.  Generally error
  1557. messages will alleviate this problem.  If not, review what has been entered
  1558. earlier and try deleting offending formulas or functions.  Check for circu-
  1559. larity.  Try saving what you have to a new .dat file and recall your
  1560. original PROMATH.DAT file with the Data/Open menu command.  You should be
  1561. where you started at the beginning of the session.  If you feel you have
  1562. identified a true bug, please contact us as provided earlier.
  1563. Support Policy
  1564.  
  1565. Up to thirty minutes telephone support time will be provided (on our
  1566. technical support line only) without charge to registered users during the
  1567. three months following registration.  This support is for installation and
  1568. general use of the program.
  1569.  
  1570. Unregistered users seriously considering paying their registration fee are
  1571. also invited to call to have their brief questions answered.
  1572.  
  1573. Significant bugs will be fixed for free for one year following registra-
  1574. tion, if possible.  If not, a full refund will be offered.  If problems
  1575. occur, please make a note of any messages received, describe your hard-
  1576. ware/software environment, and send a diskette with copies of your
  1577. PROMATH.DAT, PROMATH.SET, and program files.  These steps are essential in
  1578. notifying us of a bug so we can duplicate the problem.
  1579.  
  1580. Support will be provided to non-registered users and users beyond the free
  1581. support period on a time and materials basis.
  1582.  
  1583.  
  1584. Suggestions
  1585.  
  1586. We welcome your comments and/or suggestions for improvement.  Please send
  1587. all correspondence to the address given in the earlier "Contacting Us"
  1588. section.
  1589.  
  1590. We would also appreciate your suggestions for new professional and educa-
  1591. tional markets for this program.  Please help us with your ideas.
  1592.  
  1593.  
  1594. Get BBS Upload Credits!!!
  1595.  
  1596. Most BBS's give you credits for uploading software.  Please help yourself
  1597. and us by uploading the included, unchanged, ProMATHeus II archive file:
  1598. PRMATH40.ZIP file.  Also included is a sample description which you can use
  1599. in BBS catalogs: DESCRIBE.BBS.  Thanks!
  1600. Files Shipped with ProMATHeus II 4.0
  1601.  
  1602. You may have received PRMATH.ZIP or PRMATH40.ZIP which are compressed,
  1603. archived files.  You may upload the above files to the bulletin boards of
  1604. your choice.  They require PKUNZIP or a compatible decompression program to
  1605. unarchive these files:
  1606.  
  1607. FILE_ID.DIZ    A standardized identification file used by bulletin boards.
  1608.  
  1609. PM2FILES.EXE   Described below.
  1610.  
  1611. The file PM2FILES.EXE is a complete, executable archive of ProMATHeus II
  1612. files.  Typing 'pm2files<Enter>' executes the file and expands the files
  1613. listed below into the disk/directory that the PM2FILES.EXE file resides:
  1614.  
  1615. README.1ST     Important new information.
  1616.  
  1617. PROMATH.EXE    ProMATHeus II main file.
  1618.  
  1619. PROMATH.DAT    Contains previous session data (automatically saved).
  1620.  
  1621. PROMATH.SET    Contains previous session settings (automatically saved).
  1622.  
  1623. PROMATH.HLP    File used with the "help" key <F1>.
  1624.  
  1625. FINANCE.DAT
  1626. STATS.DAT      Example sessions.
  1627.  
  1628. ORDER.ME       Order and registration form for your printer!
  1629.  
  1630. DESCRIBE.BBS   Sample description to be used in BBS catalogs.
  1631.  
  1632. FILE_ID.DIZ    A standardized identification file used by bulletin boards.
  1633.  
  1634. ?????.BGI      Borland Graphics Interface files to interact with your video
  1635.                setup.
  1636.  
  1637. QUIKSTRT.DOC   Contains the "Quick Start" section of this manual.
  1638.  
  1639. MANUAL.DOC     Contains the rest of this manual.
  1640.  
  1641. REGISTER.DOC   Registration information.
  1642.  
  1643. VENDOR.DOC     Information for software vendors and BBSs.
  1644.