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. ★ OpenXM GENERIC パッケージの利用方法 この節では, OpenXM package binary distribution のインストール法を説明します. インストールに必要なシステムの仕様については, 動作環境を御覧ください. (1) Tar ボールより次のようにしてディレクトリ OpenXM を取り出します. OpenXM はどこにおいてもかまいません. ルートになってインストール する必要もありません. できれば, /usr/local/OpenXM においてほしいと思います. tar xzvf OpenXM-shared.tgz tar xzvf OpenXM-binary-OPERATING_SYSTEM_CPU_TYPE.tgz 以下 (1) で生成されたディレクトリ OpenXM の絶対パスを /xxx/yyy/OpenXM と書きます. (2) OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc, OpenXM/rc/openxm, OpenXM/rc/asir, OpenXM/rc/oxmath, 等の ファイルを自動生成します. openxm, asir, oxmath などは OpenXM クライアントを起動するための シエルスクリプトです. これらを /usr/local/bin にインストールするには 次のように入力します. cd /xxx/yyy/OpenXM/rc make install /usr/local/bin でなく, home directory の bin にインストールしたい ときは, 次のように入力してください. cd /xxx/yyy/OpenXM/rc make install PREFIX=$HOME/bin [Note] If you are Solaris user, you might have to type in like /usr/ccs/bin/make install PREFIX=$HOME/bin OpenXM/bin の下のファイルを直接実行したい場合は, 以下の設定が必要です. OpenXM clients を実行するだけの場合は, (3), (3') は skip してください. (3) csh を利用してる場合, 次の行を ~/.cshrc の最後に加えます. source /xxx/yyy/OpenXM/rc/dot.cshrc (3') bash を利用してる場合, 次の行を ~/.bashrc の最後に加えます. source /xxx/yyy/OpenXM/rc/dot.bashrc (3) または (3') を終了したら, いったん logout して login しなおすか または, source コマンドで, dot.bashrc または dot.csh を読み込んで下さい. (4) asir の利用には key が必要です. asir の起動時のメッセージまたは OpenXM/lib/asir/asir_key を 参照して, key を取得して下さい (数秒しかかかりません). Mail の利用ができて, /var/mail の下にメールを着信できれば, /xxx/yyy/OpenXM/rc/fetch_asir_key を実行することにより asir_key を自動で設定できます. FreeBSD の package, Redhat Package manager を利用している 場合は, /usr/local/OpenXM/lib/asir/asir_key がすでに存在して いる場合, このファイルは保存されます. FAQ Q. OpenXM の asir OpenXM client を icon でスタートするには? A. 次の行を, .Xdefaults または, xrdb で読み込むファイルに書いておきます. ox_xterm*iconic: on ★ OpenXM FreeBSD binary パッケージのインストール方法 openxm-version.tgz を ftp サイトより copy して, root になって, pkg_add openxm-version.tgz OpenXM は /usr/local/OpenXM にインストールされます. あとは, 上の (4) へ. ここで version は OpenXM の version 番号で, たとえば, 2000, 3/20(Mon) 版は 1.1.2 java および linux emulation が実行に必要です. java が, サーチパスのなかにある必要がありますので, たとえば, set path=(/usr/local/jdk1.1.8 $path) rehash してから, pkg_add して下さい. インストール終了後のメッセージにしたがい, 必要な設定を おこなって下さい. /usr/local にインストールしなかった場合は, (2) を実行して下さい. ★ OpenXM Redhat Package manager (Linux) binary パッケージのインストール方法 openxm-shared-version-suffix.noarch.rpm openxm-binary-version-suffix.i386.rpm を ftp サイトより copy して, root になって, rpm -i openxm-shared-version-suffix.noarch.rpm rpm -i openxm-binary-version-suffix.i386.rpm OpenXM は /usr/local/OpenXM にインストールされます. あとは, 上の (4) へ. ここで version は OpenXM の version 番号で, たとえば, 2000, 3/20(Mon) 版は 1.1.2 suffix は, RPM 版の minor version number. Debian を利用している場合, コマンド alien で, rpm 形式を deb 形式に 変換できます. /usr/local の下へインストールしなかった場合は, (2) を実行して下さい. ***** OpenXM client programs under OpenXM/bin or /usr/local/bin: asir oxmath openxm sm1 ***** OpenXM server programs: OpenXM/bin/ox_asir OpenXM/bin/ox_sm1 OpenXM/bin/ox_math OpenXM/lib/sm1/bin/ox_sm1_gnuplot OpenXM/lib/sm1/bin/ox_sm1_phc OpenXM/lib/sm1/bin/ox_sm1_tigers OpenXM/lib/java-support/OMproxy.class ***** QUALITY: Experimental: OpenXM/bin/k0, OpenXM/bin/d0 Asir client functions: m_* (Mathematica) , om_* (OpenMath) OpenXM/lib/java-support/ * 70% OpenXM/bin/ox_math, OpenXM/bin/math2ox OpenXM/bin/sm1, ox_sm1 on Linux libc6. ★ Java に関する注意: 注意 1. OpenMath 用の OMproxy には現在のところ, jdk が必要です. たとえば bash を利用している場合, .bashrc で PATH=/usr/local/jdk1.1.8/bin:$PATH export PATH などとして, jdk の java, javac をサーチパスの先のほうへもっていくようにして ください. csh を利用している場合, .cshrc で set path=(/usr/local/jdk1.1.8/bin $path) として, jdk の java, javac をサーチパスにいれます. 注意: なお, Kaffe 1.0.b4 の java は, class BigInteger に method toByteArray が含まれてないため, OpenMath モジュールでは使用できません. ★ 動作環境 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. 次の modules は, OS の標準 distribution 以外に, さらに下に記したソフトを 必要とします. (1) OpenXM/bin/oxmath : 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 日本語版の注意. 注意 1. asir で日本語のヘルプを利用するには, PAGER=jless export PAGER などで, 日本語を扱える PAGER を指定する必要があるかもしれません. 以上. ★ 文書 OpenXM パッケージでもっとも充実しているクライアントは, asir です. asir のつかいかたは OpenXM/doc/asir2000/man-jp.dvi または OpenXM/doc/asir2000/html-jp の HTML ファイルを見て下さい. asir 用 OpenXM クライアントライブラリのつかい方は, OpenXM/doc/asir-contrib/cman-jp.dvi を見て下さい. dvi の付くファイルは xdvi で見ることができます. OpenXM の設計の概要については, OpenXM/doc/issac2000/issac2000.ps を見て下さい. ps の付くファイルは, ghostview で見ることができます. Mathematica client については, OpenXM/doc/ox_math を御覧ください. sm1 client については, OpenXM/doc/kan96xx を御覧ください. asir は, 多項式処理用のライブラリとしてリンクできます. これについては, OpenXM/doc/oxlib を御覧ください. OpenXM 対応の, サーバ を作成するには, OpenXM/src/ox_toolkit が参考になるかもしれません. Java のクラスについては OpenXM/src/OpenMath が参考になるかもしれません. ★ ASIR による使用例 asir を動作させるには, key が必要です. OpenXM/lib/asir/asir_key のコメントまたは起動時のメッセージをみて, key を E-mail でとりよせて下さい. ---------------- 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] ★ sm1 クライアントの利用例 -------------------------------------- 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 [著作権表示] OpenXM/Copyright を御覧ください. ★ OpenXM パッケージの Make 法 FreeBSD 2.2.8, FreeBSD 3.3, Linux で動作するものと期待してます. Linux glib6 では, いまのところ, /usr/include/features.h で #define __FAVOR_BSD 1 してコンパイルする必要がありしたが, 一部のソースを -D_BSD_SOURCE option をつけて gcc でコンパイルするように変えてます (setjmp と sigsetjmp の問題, dirty trick). OpenXM, OpenXM_contrib, OpenXM_contrib2 が必要です. cvs コミッタの場合次のようにしてソースをとりよせます. rcvs checkout OpenXM OpenXM_contrib OpenXM_contrib2 これらがそろっていたらあとは次のように入力するだけです. cd OpenXM/src make configure make make install なお, OpenXM/src/ox_math のコンパイルおよび利用には Mathematica が, OpenXM/src/OpenMath のコンパイルおよび利用には には, jdk (java 環境) が必要です. Documents を生成するには, tex, ptex (ascii 日本語 tex), dvips, texinfo, texi2html, nkf, が必要です. 詳しくは Makefiles を見て下さい. Document は, binary distribution の OpenXM/doc, OpenXM/lib より得るのが簡単です. OpenXM_contrib2/asir2000 の配布を受けてない場合 (ソースライセンスを 富士通より受ける必要があります), OpenXM/src/Makefile の各モジュール名 たとえば make all-kan96xx などと各モジュール名を指定してコンパイルして下さい. または OpenXM/src/asir2000 の Makefile を Makefile.forSkip に置き換えて 下さい. [OpenXM 下のファイルの構成メモ] lib/asir には, asir のライブラリ, ox_asir 本体 cd OpenXM/src/kxx ; make install-for-debug した場合, lib/sm1 は src/SSkan/Doc への symbolic link であり, sm1 のライブラリファイルが格納されています. lib/sm1/bin には, binaryfiles sm1, ox_sm1, ox, ox_log, ox_sm1_* へのシンボリックリンクが格納されます. このシンボリックリンクは src/kxx で make install-for-debug を実行することにより 作成されます. sm1 が ox_asir を利用するのに必要なファイル. lib/asir/ox_asir, lib/sm1/bin/ox, lib/sm1/bin/ox_log (src/kxx/ox, src/kxx/ox_log) lib/sm1/ox.sm1, lib/sm1/oxasir.sm1 asir が ox_sm1_forAsir を利用するのに必要なファイル: lib/asir/ox_launch lib/sm1/bin/ox_sm1_forAsir (ox_sm1 へのリンク) lib/asir/xm lib/sm1/ 以下の *.sm1 なるすべての ライブラリファイル. callsm1.sm1 callsm1b.sm1 (ox_sm1_forAsir の定義ファイル, src/kxx/oxserver00.c ox_sm1 が ox_sm1_forAsir という名前で呼ばれるとこれらのファイルをロード.) asir が ox_sm1_gnuplot を利用するのに必要なファイル: lib/asir/ox_launch lib/sm1/bin/ox_sm1_gnuplot (ox_sm1 へのリンク, ox_sm1_gnuplot は fork して gnuplot4ox を実行します.) lib/asir/xm lib/sm1/callsm1.sm1, lib/sm1/gnuplot.sm1 (ox_sm1_gnuplot の定義ファイル, src/kxx/oxserver00.c ox_sm1 が ox_sm1_gnuplot という名前で呼ばれるとこれらのファイルをロード.) bin/gnuplot4ox, bin/gnuplot_x11 (gnuplot 本体, src/gnuplot*) ---------------------------------------- [開発者用メモ] << sm1, ox_sm1, ox, oxlog の debug >> binary file は各 directory の make install により OpenXM/bin にコピーされますが, debug 用にいちいちコピーするのは面倒なので, OpenXM/src/kan96xx で make install-for-debug OpenXM/src/kxx で make install-for-debug を実行すると, OpenXM/bin/sm1, ox, ox_sm1, oxlog より, OpenXM/src/kan96xx/Kan/sm1 OpenXM/src/kxx/ox, OpenXM/src/kxx/ox_sm1, OpenXM/src/kxx/oxlog へのシンボリックリンクが作成されます. [CVSコミッタ用メモ] << OpenXM ディレクトリ配布版の作成方法 >> rcvs export -rHEAD OpenXM rcvs export -rHEAD OpenXM_contrib rcvs export -rHEAD OpenXM_contrib2 cd OpenXM/src ; make generate-source-distribution して, OpenXM, OpenXM_contrib, OpenXM_contrib2 全体を tar+gzip. ★ Solaris に関する注意. Solaris ではまだ問題が山積してます. Solaris での make の問題点については, OpenXM/doc/OpenXM-FAQ-jp.txt を見てください. Solaris でコンパイルするには, /usr/ccs/bin をサーチパスの最初へもっていって おきます. ★ Redhat Linux 6.1 上でのコンパイル m4-1.4 と autoconf-2.13 が必要. (あらかじめはいっている, autoconf は 2.12 でありこれは gnuplot の make で不具合を生じます.)