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