Annotation of OpenXM/doc/install.oxweave, Revision 1.10
1.10 ! takayama 1: %% $OpenXM: OpenXM/doc/install.oxweave,v 1.9 2000/01/20 08:21:50 takayama Exp $
1.1 takayama 2: OpenXM/doc/install.oxweave
3:
1.6 takayama 4: /*&C
5: OpenXM URL : http://www.math.kobe-u.ac.jp/OpenXM
6:
7: OpenXM package : Getting started.
8:
9: */
1.1 takayama 10: /*&jp
1.6 takayama 11: ★ OpenXM パッケージの利用方法
12: この節では, OpenXM package binary distribution のインストール法を説明します.
13: インストールに必要なシステムの仕様については, 動作環境を御覧ください.
1.1 takayama 14: */
15: /*&eg
1.6 takayama 16: ***** HOW TO USE OpenXM PACKAGE?
17: In this section, we will explain how to install OpenXM package binary
18: distribution.
19: As to the required environment, see the section "System Requirement"
20: */
21: /*&jp
22:
23: (1) Tar ボールより次のようにしてディレクトリ OpenXM を取り出します.
24: OpenXM はどこにおいてもかまいません.
25:
1.1 takayama 26: */
1.6 takayama 27: /*&eg
1.1 takayama 28:
1.6 takayama 29: (1) Extract the directory OpenXM from the tar ball.
30: You can put the directory OpenXM at any place in the file system.
1.2 takayama 31:
32: */
1.6 takayama 33: /*&C
34: tar xzvf OpenXM-binary-OPERATING_SYSTEM_CPU_TYPE.tgz
35:
1.2 takayama 36: */
1.6 takayama 37: /*&jp
38: 以下 (1) で生成されたディレクトリ OpenXM の絶対パスを /xxx/yyy/OpenXM
39: と書きます.
40:
1.1 takayama 41: */
1.6 takayama 42: /*&eg
43: In the sequel, we will denote the absolute path of the directory OpenXM
44: by /xxx/yyy/OpenXM.
1.1 takayama 45:
46: */
47: /*&jp
1.6 takayama 48: (2) 次のように入力して OpenXM/rc/dot.cshrc, OpenXM/rc/dot.bashrc
49: ファイルを自動生成します.
50: これらのファイルには, OpenXM/bin のファイルを実行するための
51: 環境変数が定義されています.
52:
1.5 takayama 53: */
54: /*&eg
1.6 takayama 55: (2) Generate OpenXM/rc/dot.cshrc and OpenXM/rc/dot.bashrc
56: by the following command.
57: Environmental variables to execute commands in OpenXM/bin
58: are defined in these files.
59:
1.5 takayama 60: */
1.6 takayama 61: /*&C
62:
1.8 takayama 63: cd /xxx/yyy/OpenXM/rc
1.6 takayama 64: make
1.5 takayama 65:
66: */
67: /*&jp
1.6 takayama 68: (3) csh を利用してる場合, 次の行を ~/.cshrc の最後に加えます.
69:
1.1 takayama 70: */
71: /*&eg
1.6 takayama 72: (3) Append the following line to the end of ~/.cshrc when you are
73: using csh as your shell.
74:
1.1 takayama 75: */
76: /*&C
1.2 takayama 77:
1.6 takayama 78: source /xxx/yyy/OpenXM/rc/dot.cshrc
1.2 takayama 79:
1.1 takayama 80: */
81: /*&jp
1.6 takayama 82: (3') bash を利用してる場合, 次の行を ~/.bashrc の最後に加えます.
83:
1.1 takayama 84: */
85: /*&eg
1.6 takayama 86: (3') Append the following line to the end of ~/.bashrc when you are
87: using bash as your shell.
88:
89: */
90: /*&C
91:
92: source /xxx/yyy/OpenXM/rc/dot.bash
93:
1.1 takayama 94: */
1.6 takayama 95:
1.2 takayama 96: //&C
1.6 takayama 97: //&jp (4) asir の利用には key が必要です. 以下のファイルを御覧ください.
98: //&eg (5) You need key to use asir. See the following file:
1.2 takayama 99: //&C OpenXM/lib/asir/asir_key
100: //&C
1.6 takayama 101:
102: /*&C
1.8 takayama 103:
104: ***** QUALITY:
105: the following modules and functions have still experimental qualities:
1.6 takayama 106: OpenXM/bin/k0, OpenXM/bin/d0
107: OpenXM/bin/ox_math, OpenXM/bin/math2ox
108: OpenXM/lib/java-support/ *
109: Asir client functions: m_* (Mathematica) , om_* (OpenMath)
110: */
111: /*&C
112:
113:
1.8 takayama 114: */
115: /*&jp
116: ★ Java に関する注意:
117: 注意 1.
118: OpenMath 用の OMproxy には現在のところ, jdk が必要です.
119: たとえば bash を利用している場合, .bashrc で
120: PATH=/usr/local/jdk1.1.8/bin:$PATH
121: export PATH
1.10 ! takayama 122: などとして, jdk の java, javac をサーチパスの先のほうへもっていくようにして
1.8 takayama 123: ください.
1.10 ! takayama 124: csh を利用している場合, .cshrc で
! 125: set path=(/usr/local/jdk1.1.8/bin $path)
! 126: として, jdk の java, javac をサーチパスにいれます.
1.8 takayama 127: */
128: /*&eg
129: ***** JAVA
130: In order to use OMproxy, asir client om_*,
131: you need to install JDK.
132: The bin dir of the JDK must be in yur search path.
133: For example, you need to add the following line
1.10 ! takayama 134: to your .chsrc when your shell is csh
1.8 takayama 135: set path=(/usr/local/jdk1.1.8/bin $path)
1.10 ! takayama 136: Bash users put the following line to .bashrc
! 137: PATH=/usr/local/jdk1.1.8/bin:$PATH
! 138: export PATH
1.8 takayama 139: */
140:
141: /*&C
142:
143:
1.6 takayama 144:
145:
146: */
147: /*&jp
148: ★ 動作環境
149:
150: */
151: /*&eg
1.7 takayama 152: ***** SYSTEM REQUIREMENTS
1.6 takayama 153:
154: */
155: /*&C
156:
1.7 takayama 157: OS: FreeBSD 3.3,
158: Linux systems (Plamo Linux on Linux 2.0.33, glibc5, )
159:
160: X window system is required.
161:
162: Most part of the OpenXM package may work on other versions of
1.8 takayama 163: FreeBSD and Linux, but we have not yet tested.
1.6 takayama 164:
165: */
166: /*&jp
1.8 takayama 167: 次の modules は, OS の標準 distribution 以外に, さらに下に記したソフトを
1.6 takayama 168: 必要とします.
169: */
170: /*&eg
171: The following modules require the listed softwares other than the standard
172: OS package.
173: */
174: /*&C
175:
176: (1) OpenXM/bin/ox_math : Mathematica Version 3.x or 4.x
177: (Mathematica server) at /usr/local/Mathematica
178: OpenXM/bin/math2ox [ see http://www.wolfram.com ]
179: Asir client functions m_*
180: (2) OpenXM/lib/java-support : JDK at /usr/local/jdk??
1.8 takayama 181: [ see the section on JAVA]
1.6 takayama 182: Asir client functions om_*
183: sm1 client functions om_*
1.7 takayama 184: (3) PHC pack (OpenXM/bin/phc) and asir client functions
185: phc_* run only on linux (glib5).
1.8 takayama 186: If you install the linux emulation^{note 1} on Free BSD, they run on
187: FreeBSD, too.
188: <note 1>
189: Add linux_enable="YES" in /etc/rc.conf
190: You need the following packages:
191: pkg_info | grep linu
192: linux_base-5.2 The base set of packages needed in Linux mode
193: linux_devtools-5.2 Packages needed for doing development in Linux mode
1.6 takayama 194:
195: */
196:
197:
1.1 takayama 198: /*&jp
1.7 takayama 199: 日本語版の注意.
1.3 maekawa 200: 注意 1.
201: asir で日本語のヘルプを利用するには,
1.1 takayama 202: PAGER=jless
203: export PAGER
1.3 maekawa 204: などで, 日本語を扱える PAGER を指定する必要があるかもしれません.
1.1 takayama 205: */
1.7 takayama 206:
207: /*&eg
208:
1.8 takayama 209: The installation is completed.
1.7 takayama 210:
211: */
212: /*&jp
213:
214: 以上.
215:
216: */
217:
1.1 takayama 218: /*&jp
1.7 takayama 219: ★ 文書
220:
221: OpenXM パッケージでもっとも充実しているクライアントは,
222: asir です.
223: asir のつかいかたは
224: OpenXM/doc/asir2000/man-jp.dvi
225: または OpenXM/doc/asir2000/html-jp の HTML ファイルを見て下さい.
226: asir 用 OpenXM クライアントライブラリのつかい方は,
227: OpenXM/doc/asir-contrib/cman-jp.dvi
228: を見て下さい. dvi の付くファイルは xdvi で見ることができます.
229:
230: OpenXM の設計の概要については,
231: OpenXM/doc/issac2000/issac2000.ps
232: を見て下さい.
233: ps の付くファイルは, ghostview で見ることができます.
234:
235: */
236: /*&eg
237: ***** DOCUMENTS
238:
239: The best OpenXM client in the OpenXM package is now
240: asir.
241: Documents on asir are
242: OpenXM/doc/asir2000/man-eg.dvi
243: OpenXM/doc/asir2000/html-eg (HTML)
244:
245: The file
246: OpenXM/doc/asir-contrib/cman-eg.dvi
247: is a document on OpenXM client libraries for asir.
1.1 takayama 248:
1.7 takayama 249: The design outline is described in
250: OpenXM/doc/issac2000/issac2000.ps
251:
252: Dvi files can be previewed by xdvi and
253: ps files can be previewed by ghostview.
254: */
1.1 takayama 255:
256:
1.8 takayama 257: /*&eg
258:
259:
260: ***** A QUICK TOUR OF OPENXM BY ASIR
261:
262: */
1.7 takayama 263: /*&jp
1.1 takayama 264:
265:
1.8 takayama 266: ★ ASIR による使用例
1.1 takayama 267:
268:
1.3 maekawa 269: asir を動作させるには, key が必要です.
1.8 takayama 270: OpenXM/lib/asir/asir_key のコメントまたは起動時のメッセージをみて,
271: key を E-mail でとりよせて下さい.
1.1 takayama 272:
1.8 takayama 273: */
274: /*&C
275: ---------------- Call ox_sm1 from asir.
276: bash-2.03$ asir
277: This is Risa/Asir, Version 20000120.
278: Copyright (C) FUJITSU LABORATORIES LIMITED.
279: 1994-1999. All rights reserved.
280: xm Version 20000116. ox_help(0); ox_help("keyword"); for help message
281: [269] sm1_genericAnn([x^3-y^2,[s,x,y]]);
282: /* The annihilating ideal of (x^3-y^2)^s */
283: [-2*y*dx-3*x^2*dy,2*x*dx+3*y*dy-6*s]
284:
285:
286: --------------- Call gnuplot from asir.
287: bash-2.03$ asir
288: This is Risa/Asir, Version 20000120.
289: Copyright (C) FUJITSU LABORATORIES LIMITED.
290: 1994-1999. All rights reserved.
291: xm Version 20000116. ox_help(0); ox_help("keyword"); for help message
292: [269] gnuplot("plot sin(x);");
293: 0
294: [270]
1.1 takayama 295:
1.8 takayama 296: */
297: /*&jp
1.1 takayama 298:
1.3 maekawa 299: --------------- 例 : asir より tigers を呼び出す.
1.1 takayama 300: asir
301: load("xm");
302: tigers_start();
303: B = tigers(0,[[1,1,1,1],[0,1,2,3]]);
1.3 maekawa 304: length(B) は 8 です. これは, 行列 A = [[1,1,1,1],[0,1,2,3]]
305: に付随した, toric ideal I_A の Grobner fan が 8 つの maximal
306: dimensional fan を持つことを意味します.
307: A[i] は i 番目の GB (グレブナ基底)です.
308: Binomial polynomial x^a-x^b を [[a_1, ..., a_n],[b_1, ..., b_n]] なる形式で
309: 表示します.
310: たとえば A[0];
1.1 takayama 311: [[[1,0,1,0],[0,2,0,0]],[[1,0,0,1],[0,1,1,0]],[[0,1,0,1],[0,0,2,0]]]
1.3 maekawa 312: ですから,
1.1 takayama 313: x1 x3 - x2^2, x1 x4 - x2 x3, x2 x4 - x3^2
1.3 maekawa 314: が GB であり, initial ideal は
1.1 takayama 315: x1 x3 , x1 x4 , x2 x4
1.3 maekawa 316: で生成されています.
1.8 takayama 317: */
1.1 takayama 318:
1.8 takayama 319: /*&C
320: -------------------------------------- call ox_asir from sm1
1.1 takayama 321: sm1
322: (oxasir.sm1) run ;
1.8 takayama 323: [(x^20-y^20) (x,y)] fctr pmat ; factorize x^20-y^20 by call ox_asir
1.1 takayama 324:
325:
1.8 takayama 326: */
1.1 takayama 327:
1.8 takayama 328: /*&jp
1.5 takayama 329: [著作権表示]
330: OpenXM/Copyright を御覧ください.
1.6 takayama 331: */
1.8 takayama 332: /*&eg
333: [COPYRIGHT]
334: See OpenXM/Copyright.
335: */
336:
337: /*&eg
338:
1.6 takayama 339:
1.7 takayama 340:
1.8 takayama 341: ***** TO COMPILE FROM A SOURCE *****
1.7 takayama 342:
343: */
1.6 takayama 344: /*&jp
1.8 takayama 345:
346:
1.6 takayama 347: ★ OpenXM パッケージの Make 法
348: FreeBSD 2.2.8, FreeBSD 3.3, Linux で動作するものと期待してます.
1.8 takayama 349: Linux glib6 では, いまのところ, /usr/include/features.h
350: で #define __FAVOR_BSD 1 してコンパイルする必要があります.
351: (setjmp と sigsetjmp の問題, dirty trick)
352:
1.6 takayama 353: OpenXM, OpenXM_contrib, OpenXM_contrib2 が必要です.
354: cvs コミッタの場合次のようにしてソースをとりよせます.
355: */
356: /*&eg
357: * How to make OpenXM package?
358: We have tested the OpenXM package on FreeBSD 2.2.8, FreeBSD 3.3, Linux.
1.8 takayama 359: On Linux glib6, you need to define
360: #define __FAVOR_BSD 1
361: in /usr/include/features.h
362: (setjmp vs sigsetjmp)
363:
1.6 takayama 364: Do you have directories OpenXM, OpenXM_contrib, OpenXM_contrib2?
365: If you are a CVS committer, then you can get all sources as follows:
366: */
367: //&C rcvs checkout OpenXM OpenXM_contrib OpenXM_contrib2
368: //&C
369: //&jp これらがそろっていたらあとは次のように入力するだけです.
370: //&eg Check that you have these directories, then just type in the following commands
371: /*&C
372:
373: cd OpenXM/src
374: make configure
375: make
376: make install
377:
378: */
379: /*&jp なお, OpenXM/src/ox_math のコンパイルおよび利用には Mathematica が,
380: OpenXM/src/OpenMath のコンパイルおよび利用には
381: には, jdk (java 環境) が必要です.
382: */
383: /*&eg In order to use and compile OpenXM/src/ox_math, you need Mathematica.
384: In order to use and compile OpenXM/src/OpenMath,
385: you need jdk (java environment).
386: */
387: /*&C
1.9 takayama 388:
389: */
390: /*&jp
391:
392: OpenXM_contrib2/asir2000 の配布を受けてない場合 (ソースライセンスを
393: 富士通より受ける必要があります),
394: OpenXM/src/Makefile の各モジュール名 たとえば
395: make all-kan96xx
396: などと各モジュール名を指定してコンパイルして下さい.
397:
398: */
399: /*&eg
400:
401: If you cannot get a source liscence of OpenXM_contrib2/asir2000
402: from Fujitsu labs,
403: compile each modules independently, e.g.,
404: make all-kan96xx
1.1 takayama 405:
1.6 takayama 406: */
1.1 takayama 407:
1.6 takayama 408: /*&jp
1.1 takayama 409:
1.8 takayama 410: [OpenXM 下のファイルの構成メモ]
1.3 maekawa 411: lib/asir には, asir のライブラリ, ox_asir 本体
412:
1.8 takayama 413: cd OpenXM/src/kxx ; make install-for-debug した場合,
1.3 maekawa 414: lib/sm1 は src/SSkan/Doc への symbolic link
415: であり, sm1 のライブラリファイルが格納されています.
416: lib/sm1/bin には, binaryfiles
1.1 takayama 417: sm1, ox_sm1, ox, ox_log, ox_sm1_*
1.3 maekawa 418: へのシンボリックリンクが格納されます.
1.8 takayama 419: このシンボリックリンクは src/kxx で make install-for-debug を実行することにより
1.3 maekawa 420: 作成されます.
1.1 takayama 421:
1.3 maekawa 422: sm1 が ox_asir を利用するのに必要なファイル.
1.1 takayama 423: lib/asir/ox_asir,
424: lib/sm1/bin/ox, lib/sm1/bin/ox_log (src/kxx/ox, src/kxx/ox_log)
425: lib/sm1/ox.sm1, lib/sm1/oxasir.sm1
426:
1.3 maekawa 427: asir が ox_sm1_forAsir を利用するのに必要なファイル:
1.1 takayama 428: lib/asir/ox_launch
1.3 maekawa 429: lib/sm1/bin/ox_sm1_forAsir (ox_sm1 へのリンク)
1.1 takayama 430: lib/asir/xm
1.3 maekawa 431: lib/sm1/ 以下の *.sm1 なるすべての ライブラリファイル.
1.1 takayama 432: callsm1.sm1 callsm1b.sm1
1.3 maekawa 433: (ox_sm1_forAsir の定義ファイル, src/kxx/oxserver00.c
434: ox_sm1 が ox_sm1_forAsir という名前で呼ばれるとこれらのファイルをロード.)
1.1 takayama 435:
1.3 maekawa 436: asir が ox_sm1_gnuplot を利用するのに必要なファイル:
1.1 takayama 437: lib/asir/ox_launch
1.3 maekawa 438: lib/sm1/bin/ox_sm1_gnuplot (ox_sm1 へのリンク, ox_sm1_gnuplot は fork して
1.4 maekawa 439: gnuplot4ox を実行します.)
1.1 takayama 440: lib/asir/xm
441: lib/sm1/callsm1.sm1, lib/sm1/gnuplot.sm1
1.3 maekawa 442: (ox_sm1_gnuplot の定義ファイル, src/kxx/oxserver00.c
443: ox_sm1 が ox_sm1_gnuplot という名前で呼ばれるとこれらのファイルをロード.)
1.4 maekawa 444: bin/gnuplot4ox, bin/gnuplot_x11 (gnuplot 本体, src/gnuplot*)
1.1 takayama 445:
446: ----------------------------------------
1.3 maekawa 447: [開発者用メモ]
1.1 takayama 448:
1.3 maekawa 449: << sm1, ox_sm1, ox, oxlog の debug >>
450: binary file は各 directory の make install により
451: OpenXM/bin にコピーされますが,
452: debug 用にいちいちコピーするのは面倒なので,
1.8 takayama 453: OpenXM/src/kan96xx で make install-for-debug
454: OpenXM/src/kxx で make install-for-debug
1.3 maekawa 455: を実行すると,
456: OpenXM/bin/sm1, ox, ox_sm1, oxlog より,
1.1 takayama 457: OpenXM/src/kan96xx/Kan/sm1
458: OpenXM/src/kxx/ox, OpenXM/src/kxx/ox_sm1, OpenXM/src/kxx/oxlog
1.3 maekawa 459: へのシンボリックリンクが作成されます.
1.1 takayama 460:
1.3 maekawa 461: [CVSコミッタ用メモ]
462: << OpenXM ディレクトリ配布版の作成方法 >>
1.1 takayama 463: rcvs export -rHEAD OpenXM
464: rcvs export -rHEAD OpenXM_contrib
465: rcvs export -rHEAD OpenXM_contrib2
1.3 maekawa 466: して, OpenXM, OpenXM_contrib, OpenXM_contrib2 全体を tar+gzip.
1.7 takayama 467: */
468:
469: /*&C
470:
471: */
472: /*&jp
473:
474: ★ Solaris に関する注意.
475: Solaris ではまだ問題が山積してます.
476: Solaris での make の問題点については, OpenXM/doc/OpenXM-FAQ-jp.txt
477: を見てください.
1.8 takayama 478: Solaris でコンパイルするには, /usr/ccs/bin をサーチパスの最初へもっていって
479: おきます.
1.7 takayama 480:
481: */
1.8 takayama 482: /*&eg
483: ***** COMPILE ON SOLARIS
484: There are a lot of troubles on Solaris for now.
485: At least,
486: /usr/ccs/bin must be at the top of the command search path to compile
487: on Solaris.
488: */
489:
1.7 takayama 490:
491: /*&C
492:
1.1 takayama 493: */
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>