Infty Calculator Install Document Ver. 0.3
******************************************

Supported OS
============

Windows2000 or XP


Download Files
==============

From http://www.InftyProject.org/calc/

 Infty-OpenXM_eng.txt (This file.)
 InftyOpenXMFiles.zip


How to Install
==============

0. Unpack InftyOpenXMFiles.zip.
   You get the folder Infty-OpenXM.

1. Copy the folder InftyEditor in Infty-OpenXM to 
   "c:\Program Files\CAI-SYSTEM".

2. Copy the folder OpenXM-win to c:\ (i.e., the root of C drive).

3. If Cygwin is not installed, copy the folder usr to c:\ .

4. Setting environment variables

   New:
    ASIR_LIBDIR=/cygdrive/c/OpenXM-win/lib/asir
    ASIRLOADPATH=/cygdrive/c/OpenXM-win/lib/asir-contrib
    OpenXM_HOME=/cygdrive/c/OpenXM-win

   Change:
    Add c:\OpenXM-win\bin to your PATH environment variable
    Further if you did the above no.3 operation, add c:\usr\bin.
            if your system has c:\cygwin\bin, add c:\cygwin\bin.


How to use Infty Calculator
===========================

1. Start Infty Editor and push the "Calculation" button
   at the right end of the tool bar.

2. The dialog IOpenXMDlg appears. Push [OK].

3. In the file chooser dialog, select c:\OpenXM-win\bin .

4. The OpenXM Interface Dialog is appears.

5. Select menu [Connect] --> [Asir].
   If Infty Editor succeeds in communication with Asir,
   it will be displayed "succeeded".

6. After choosing a mathematical notation in Infty Editor,
   users can calculate by choosing a computing command from 
   the calculate menu in the OpenXM Interface Dialog.
   The results will appear in the OpenXM Interface Dialog.

7. The pastes of calculation results into Infty Editor are available
   from the paste menu in the OpenXM Interface Dialog.
   There are three paste mode.
     - With `=' Mode
     - With LF Mode 
     - Normal Mode
   Users can select it by radio buttons.
   Furthermore, users can choose auto paste mode by a maximize/minimize button
   of the OpenXM Interface Dialog.


Support of Asir User Language
=============================

Asir user language is a programming language just like C language.
Type declarations of variables are unnecessary, and lists are available 
for data objects.

On Infty Editor, users can define new functions by using Asir user 
language, and use them. The following is an example of a function which 
calculates the sum from 1 to N by Asir user language.

    def sum(N){
        R=0;
        for(I=1;I<=N;I++)
            R=R+I;
        return R;
    }

First, users input the above program on **TeX mode** in Infty Editor.
What is needed in order to define the new function `sum' is to choose
`Asir language' from the calculation menu of the OpenXM Interface Dialog.

It is also possible to send Asir commands directly.
There are two methods for sending Asir commands.
One is the method choosing `Asir string' from the calculation menu of 
the OpenXM Interface Dialog.
In this case, users get the plain strings which Asir returns.
Another one is the method inputting Asir commands in the small window
(Asir String Box). In this case, the calculation result is converted to 
the Infty XML format as much as possible.


Available Functions
===================

Currently available computation functions are as follows:
 - Evaluate (Asir)
 - Expand (Asir)
 - Factorize (Asir)
 - Differentiate (Asir)
 - Integrate (Asir)
 - System of Equations (phc)
 - 2D Explicit function Plot (gnuplot) *1
 - 3D Explicit function Plot (gnuplot) *1
 - 2D Implicit function Plot (ox_plot) *1

   *1  X server is needed. (e.g. Exceed or Cygwin-XFree86)

*** These functions are very experimental and
    can run only **very simple** calculations.


About 2D and 3D plot
====================
2D and 3D plot needs X server.
You must install X server for Windows (e.g. Exceed or Cygwin-XFree86).
Exceed is a commercial software released by Hummingbird Ltd.
  http://www.hummingbird.com/products/nc/exceed/index.html
Cygwin-XFree86 is a free X server.
You can install Cygwin-XFree86 by Cygwin setup.exe.
  http://sources.redhat.com/cygwin/xfree/

If you installed Cygwin-XFree86, you must set environment variables.
  New: DISPLAY=127.0.0.1:0.0
  Change: In PATH, add "c:\cygwin\bin" and delete "c:\usr\bin" .
Further, you must rename c:\OpenXM-win\bin\cygwin1.dll to
c:\OpenXM-win\bin\cygwin1.dll_old .

How to use gnuplot from InftyEditor:
0. Click the short cut "Cygwin" on your desktop.
1. Type "startxwin.sh" .
2. Start InftyEditor .
3. Connect Asir from the OpenXM Interface Dialog.
4. Change "Math Mode".
5. Type "\sin[Enter]x".
6. Drag "sin x".
7. Choose "plot" from the calculate menu in the OpenXM Interface Dialog.
   ---> The graph of y=sin(x) will appear.
8. Type "\sin[Enter]x+\cos[Enter]y".
9. Drag "sin x + cos y".
10. Choose "splot" from the calculate menu in the OpenXM Interface Dialog.
   ---> The graph of z=sin(x)+cos(y) will appear.

   The result windows of 7 and 10 are by gnuplot.

11. Type "x^3-y^2".
12. Drag "x^3-y^2".
13. Choose "ifplot" from the calculate menu in the OpenXM Interface Dialog.
   ---> The graph of x^3-y^2=0 will appear.

   The result window of 13 is by ifplot.


Known Bugs
==========
 - When calculation errors occurred, users may have to terminate
   the following processes manually.

      InftyEd2.exe
      ox.exe
      asir.exe

-------------------------------
Ver.0.3 2004-8-8
Ver.0.2 2004-1-27
Ver.0.1 2003-9-6