[BACK]Return to install.oxweave CVS log [TXT][DIR] Up to [local] / OpenXM / doc

Annotation of OpenXM/doc/install.oxweave, Revision 1.9

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

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>