DO NOT EDIT THIS FILE. OpenXM URL : http://www.math.kobe-u.ac.jp/OpenXM Consult firstly the ERRATA section for your release on this web cite for troubles. OpenXM package : Getting started. ***** HOW TO USE OpenXM PACKAGE? In this section, we will explain how to install OpenXM package binary distribution. As to the required environment, see the section "System Requirement" (1) Extract the directory OpenXM from the tar ball. You can put the directory OpenXM at any place in the file system. You do not need to be a root to install it. We are happy if you put OpenXM at /usr/local/OpenXM tar xzvf OpenXM-binary-OPERATING_SYSTEM_CPU_TYPE.tgz In the sequel, we will denote the absolute path of the directory OpenXM by /xxx/yyy/OpenXM. (2) Generate OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc and OpenXM/rc/openxm by the following command. Environmental variables to execute commands in OpenXM/bin are defined in these files. cd /xxx/yyy/OpenXM/rc make (3) Append the following line to the end of ~/.cshrc when you are using csh as your shell. source /xxx/yyy/OpenXM/rc/dot.cshrc (3') Append the following line to the end of ~/.bashrc when you are using bash as your shell. source /xxx/yyy/OpenXM/rc/dot.bashrc After finishing the step (3) or (3'), logout and login again, or read dot.bashrc or dot.cshrc file by the source command. You may skip the step (3) or (3'). In this case, move the shell script OpenXM/rc/openxm to your command search path. To execute commands in OpenXM/bin, type in openxm command-name For example, "openxm asir" starts asir and "openx sm1" starts sm1 with a proper setting of environmental variables. (4) You need a key to use asir. Please get the key by following the instruction from asir itself or that in OpenXM/lib/asir/asir_key (it takes only a few seconds to get the key). ***** QUALITY: the following modules and functions have still experimental qualities: OpenXM/bin/k0, OpenXM/bin/d0 OpenXM/bin/ox_math, OpenXM/bin/math2ox OpenXM/lib/java-support/ * Asir client functions: m_* (Mathematica) , om_* (OpenMath) OpenXM/bin/sm1, ox_sm1 on Linux libc6. ***** JAVA In order to use OMproxy, asir client om_*, you need to install JDK. The bin dir of the JDK must be in yur search path. For example, you need to add the following line to your .chsrc when your shell is csh set path=(/usr/local/jdk1.1.8/bin $path) Bash users put the following line to .bashrc PATH=/usr/local/jdk1.1.8/bin:$PATH export PATH Remark: The Java interpreter of Kaffe 1.0.b4 does not contain the method toByteArray in the class BigInteger. So, it cannot be used for the OpenMath module. ***** SYSTEM REQUIREMENTS OS: FreeBSD 3.3 (Intel CPU), Linux systems (Intel CPU): Most Linux with libc5 and with libc6 (glibc 2.x). X window system is required. Most part of the OpenXM package may work on other versions of FreeBSD 3.x and Linux, but we have not yet tested. The following modules require the listed softwares other than the standard OS package. (1) OpenXM/bin/ox_math : Mathematica Version 3.x or 4.x (Mathematica server) at /usr/local/Mathematica OpenXM/bin/math2ox [ see http://www.wolfram.com ] Asir client functions m_* (2) OpenXM/lib/java-support : JDK at /usr/local/jdk?? [ see the section on JAVA] Asir client functions om_* sm1 client functions om_* (3) PHC pack (OpenXM/bin/phc) and asir client functions phc_* run only on linux (glib5). If you install the linux emulation^{note 1} on Free BSD, they run on FreeBSD, too. Add linux_enable="YES" in /etc/rc.conf You need the following packages: pkg_info | grep linu linux_base-5.2 The base set of packages needed in Linux mode linux_devtools-5.2 Packages needed for doing development in Linux mode The installation is completed. ***** DOCUMENTS The best OpenXM client in the OpenXM package is now asir. Documents on asir are OpenXM/doc/asir2000/man-eg.dvi OpenXM/doc/asir2000/html-eg (HTML) The file OpenXM/doc/asir-contrib/cman-eg.dvi is a document on OpenXM client libraries for asir. The design outline is described in OpenXM/doc/issac2000/issac2000.ps Dvi files can be previewed by xdvi and ps files can be previewed by ghostview. ***** A QUICK TOUR OF OPENXM BY ASIR ---------------- Call ox_sm1 from asir. bash-2.03$ asir This is Risa/Asir, Version 20000120. Copyright (C) FUJITSU LABORATORIES LIMITED. 1994-1999. All rights reserved. xm Version 20000116. ox_help(0); ox_help("keyword"); for help message [269] sm1_genericAnn([x^3-y^2,[s,x,y]]); /* The annihilating ideal of (x^3-y^2)^s */ [-2*y*dx-3*x^2*dy,2*x*dx+3*y*dy-6*s] --------------- Call gnuplot from asir. bash-2.03$ asir This is Risa/Asir, Version 20000120. Copyright (C) FUJITSU LABORATORIES LIMITED. 1994-1999. All rights reserved. xm Version 20000116. ox_help(0); ox_help("keyword"); for help message [269] gnuplot("plot sin(x);"); 0 [270] ****** Example of the use of sm1 client -------------------------------------- call ox_asir from sm1 sm1 (oxasir.sm1) run ; [(x^20-y^20) (x,y)] fctr pmat ; factorize x^20-y^20 by call ox_asir [COPYRIGHT] See OpenXM/Copyright. ***** TO COMPILE FROM A SOURCE ***** * How to make OpenXM package? We have tested the OpenXM package on FreeBSD 2.2.8, FreeBSD 3.3, Linux. On Linux glib6, you need to define #define __FAVOR_BSD 1 in /usr/include/features.h (setjmp vs sigsetjmp) Do you have directories OpenXM, OpenXM_contrib, OpenXM_contrib2? If you are a CVS committer, then you can get all sources as follows: rcvs checkout OpenXM OpenXM_contrib OpenXM_contrib2 Check that you have these directories, then just type in the following commands cd OpenXM/src make configure make make install In order to use and compile OpenXM/src/ox_math, you need Mathematica. In order to use and compile OpenXM/src/OpenMath, you need jdk (java environment). In order to generate the full documentation including Japanese documents, you need tex, ptex (ASCII Inc. Japanese tex), dvips, texinfo, texi2html, nkf. See each Makefile. The generated documents are in OpenXM/doc and OpenXM/lib in the binary distribution. If you do not like to install Japanese environment such as ptex, type in R for the tex error prompt ? or prepare empty shell scripts ptex and nkf. If you cannot get a source liscence of OpenXM_contrib2/asir2000 from Fujitsu labs, compile each modules independently, e.g., make all-kan96xx ***** COMPILE ON SOLARIS There are a lot of troubles on Solaris for now. At least, /usr/ccs/bin must be at the top of the command search path to compile on Solaris.