2.1. 運用方法¶

ANGEL は、Windows系、各種UNIX系マシンで利用可能です。どのマシンでも同じ結果を得ることができます。パッケージの中に、代表的なマシンとOS毎に実行形式のファイルが梱包されていますので、まず動かしてみてください。それらが利用できれば問題ありませんが、そうでない場合は、以下にコンパイルの仕方も説明します。まず、ANGEL 起動から説明します。

2.1.1. 本体起動¶

実行形式の ANGEL の本体は、梱包されているもので、 angel400.exe, angel400.alp, angel400.hp, angel400.g77, angel400.pgf など、angelの後にバージョン番号とマシン識別子がついています。例えば、識別子がexeのものはWindows系のものです。 ANGEL を利用するには、最低限この実行ファイルだけで運用できます。次に述べる ANGEL 本体を動かすシェルスクリプトや、バッチファイルを使わなくても、ちょっと不便ですが利用できます。

まず本体の起動パラメーターを説明します。本体を起動すると、

List 1.3　● ANGEL 起動場面

 > angel400
 >
 > ANGEL     (R) Graphic Program Version  4.00
 > Copyright (C) Koji NIITA  1993-2002. All rights reserved.
 >

のように商標とコピーライトが標準出力に書かれ、その後、起動パラメーターの入力待ちの状態になります。ここで、入力ファイル名、処理するページの指定、出力ファイル名などを入力します。これらは、空白で区切って一行入力です。入力後、Enter を押すと ANGEL の処理が行われます。入力の書式は、

input_filename　 [ -f \(n_1\) ] 　 [ -t \(n_2\) ] 　 [ -o output_filename ] 　 [ -a ] 　 [ -v12 ] 　 [ -exp ]

ここで、[ ] の付いているものは省略可能です。最低インプットのファイル名が必要です。これらのパラメーターは、空白で区切られている限り順番は自由です。各パラメーターは次のような働きをします。

表 2.1 起動パラメーター¶
パラメーター	説明
input_filename	ANGEL で処理する入力ファイル名。必須です。
`-f` \(n_1\)	処理する最初のページ \(n_1\) これを省略すると1ページから処理します。
`-t` \(n_2\)	処理する最後のページ \(n_2\) これを省略すると最後のページまで処理します。
`-o` output_filename	出力するEPSファイル名。これを省略すると、入力ファイル名の拡張子を eps に変えたファイルに出力します。
`-a`	A4 横置きか縦置きかの情報をGhostviewの立ち上げに反映するための起動シェルを書き出します。起動シェルのファイル名は、`angelbat` です。デフォルトは書き出しません。 UNIXユーザーのためのものです。
`-v12`	ANGEL バージョン2以前のインプットをバージョン3のインプットに変換します。ギリシャ文字などの特殊文字の記述の仕様が大幅に変わったので、それらを変換します。変換したインプットは、入力ファイル名の拡張子を an2 に変えたファイルに出力します。変換後、通常の ANGEL の処理も行います。
`-exp`	入力ファイルにインクルードファイルのある場合、それを展開した新たな入力ファイルを作成し、ANGEL の処理を行います。展開した結果は、入力ファイル名の拡張子を new に変えたファイルに出力します。

2.1.2. 本体起動シェル¶

本体を直接起動しても運用できますが、本体を起動するシェルやバッチファイルを利用すれば、より便利な使い方ができます。以下に、Windows系バッチファイルとUNIX系の起動シェルの例題を示します。これらは、ANGEL のパッケージの中に含まれています。

List 1.4　● Windows系バッチファイル

 @echo off
 if "%1"=="" goto man
 goto start
 :man
 echo ANGEL     (R) Graphic Program Version 4.00
 echo Copyright (C) Koji NIITA  1993-2002. All rights reserved.
 echo usage:
 echo   angel4 INPUT [-a] [-f N1] [-t N2] [-o OUTPUT] [-v12] [-exp]
 echo   -----------------------------------------------------------
 echo              INPUT  : input file name
 echo              N1     : first page
 echo              N2     : terminate page
 echo              OUTPUT : output file name
 goto end
 :start
 if exist error.ang del error.ang
 echo %1 %2 %3 %4 %5 %6 %7 %8 %9 > input.ang
 c:\angel\angel400.exe < input.ang
 del input.ang
 :end

パラメータがない場合は、商標とコピーライト、簡単な使い方を示して終わります。 16行で消している error.ang は、ANGEL のエラー出力ファイルです。古いものが残っているときに消します。 17行で最大9個のパラメーターを input.ang に書き込んでいます。次の行でこのファイルを ANGEL にリダイレクトして起動しています。 ANGEL 本体が、c:\angel にあるとして書いていますが、 PATH を切っていれば実行ファイル名だけで十分です。処理後 input.ang を消します。

UNIX系の起動シェルもほぼ同様ですが、-a パラメーターに関してUNIX独特のものもあります。

List 1.5　● UNIX系シェルファイル

 #!/bin/sh
 if [ "$1" = "" ]
 then
 echo 'ANGEL     (R) Graphic Program Version 4.00'
 echo 'Copyright (C) Koji NIITA  1993-2002 All rights reserved.'
 echo 'usage:'
 echo '  angel4 INPUT [-a] [-f N1] [-t N2] [-o OUTPUT] [-v12] [-exp]'
 echo '  -----------------------------------------------------------'
 echo '             INPUT  : input file name'
 echo '             N1     : first page'
 echo '             N2     : terminate page'
 echo '             OUTPUT : output file name'
 exit
 fi
 if [ -r error.ang ]
 then
    rm error.ang
 fi
 if [ -r angelbat ]
 then
    rm angelbat
 fi
 echo $1 $2 $3 $4 $5 $6 $7 $8 $9 > input.ang
    angel400 < input.ang
    rm input.ang
 if [ -r error.ang ]
 then
    if [ -r angelbat ]
    then
       rm angelbat
    fi
    exit
 else
    if [ -r angelbat ]
    then
       . angelbat
    fi
 fi

25行目までの ANGEL の処理とinput.ang の消去まではほぼ同じですが、その後で、エラーがない場合は、 angelbat を起動するようになっています。このシェルの中でGhostviewなどを起動するようにユーザーが設定できます。

2.1.3. Ghostview起動シェル¶

起動パラメーターで -a を指定した時には、angelbat というファイルが作られます。 ANGEL では、A4用紙を横置きに使うLandscapeと縦置きに使う Portraitを選択できます。その選択に合わせてビューアーを起動する時に使います。 angelbat の中身は、

List 1.6　● angelbat for Landscape

1:  angel-gs output_filename >/dev/null &
2:  rm angelbat

List 1.7　● angelbat for Portrait

1:  angel-gp output_filename >/dev/null &
2:  rm angelbat

これらは、Landscapeの時にはangel-gs、Portraitの時には angel-gpというシェルに出力ファイル名を渡して起動し、自分自身を消去するというものです。ユーザーは、angel-gs, angel-gp というシェルを用意してGhostviewなどのビューアーを起動することになります。これらの例題を以下に示します。

List 1.8　● angel-gs

 #!/bin/sh
 if [ "$1" = "" ]
 then
    exit
 fi
 ghostview -fg black -bg white -a4 -magstep 1 -landscape $1 -display myscreen &

List 1.9　● angel-gp

 #!/bin/sh
 if [ "$1" = "" ]
 then
    exit
 fi
 ghostview -fg black -bg white -a4 -magstep 1 $1 -display myscreen &

ふたつの違いは、angel-gs に -landscape があるだけです。これにより出力を即座に正しい方向から見ることができます。大きさ-magstep、色などのパラメーターは各自の好みで決めてください。 -display のパラメーターmyscreen は、画像を出したい画面のIPを入れると便利です。

2.1.4. エラー出力¶

ANGEL の処理中にエラーが生じた場合は、error.ang というファイルに、エラーの原因、起こったファイル名と行番号が示されます。タグジャンプ形式にしてありますのでご利用ください。エラーファイルの名前は変えられませんので注意してください。

2.1.5. ソースファイル¶

パッケージの中にある実行形式のファイルでは動かない場合、また、入力パラメーターでは動かせないデフォルト値を変えたい場合など、コンパイルが必要になることがあります。そのような時は、パッケージの中の source ディレクトリーからソースファイルとmakefileをコピーしてコンパイルしてください。

ソースは、Fortran77 で書かれています。特殊なことや、機種依存することは殆ど使っていないので、どんなFortranのコンパイラでもメイクできると思います。ただし、日付と時間を取る関数が含まれますので、うまく動かない時は、mdp-uni.f を mdp-win.f に変えるか、これらのプログラムの中身を変更して下さい。ソースファイルとインクルードファイルは、

a-alone.f  a-main0.f  a-main1.f  a-hsect.f  a-line.f  a-func.f   a-utl00.f
a-wtext.f  mdp-uni.f

の9つのファイルからなります。

改造、改変は自由です。ただし、それらのものを別名で配布することは禁止します。また、無断でソースの一部を転用することを禁止いたします。

2.1.6. インクルードファイル¶

上のソースファイルには、angel00.inc, angel01.inc の 2つのインクルードファイルが必要です。

まず、angel00.inc では、コード全体のメモリー量を定義する mdas を記述しています。デフォルト値は5000000で、 40Mb取っています。大きな2次元表示や点数の非常に大きなグラフの時に足りなくなり、メッセージをだして止まりますので、この値を大きくして下さい。また、デフォルト値では、メモリーが大きすぎて動かないマシンの時はこの値を小さくしてコンパイルして下さい。

List 1.10　● angel00.inc

 ************************************************************************
 *                                                                      *
 *     angel00.inc                                                      *
 *                                                                      *
 ************************************************************************

 *-----------------------------------------------------------------------

       parameter ( mdas = 5000000 )

       common /mdasa/ das( mdas )
       common /mdasb/ mmmax

 *-----------------------------------------------------------------------

次に、angel01.inc では、入力の数値データの最大コラム数、読み込みの最大コラム数、コメントや矢印の最大数などが定義されます。特殊な入力ファイルの時などに、これらの値を変更してコンパイルして下さい。

List 1.11　● angel01.inc

 ************************************************************************
 *                                                                      *
 *     angel01.inc                                                      *
 *                                                                      *
 ************************************************************************

 *-----------------------------------------------------------------------

       parameter ( mh = 30 )
 *                 max column terms in one h: section

       parameter ( mfc = 100 )
 *                 mfc : max number of constant
 *                       and max terms of equation

 *-----------------------------------------------------------------------

       parameter ( icolm = 200 )
 *                 icolm : max column number, should be less than ichrl

       parameter ( ichrl = 2048 )
 *                 ichrl : length of character for dimension
 *                         and max column number for ps file

 *-----------------------------------------------------------------------

       parameter ( inig = 500 )
 *                 inig : length of character for dimension

       parameter ( mc = 500 )
 *                 mc : max number of line comments (total)
 *                      max number of arrows
 *                      max number of multi records

       parameter ( numtic = 1000 )
 *                 numtic : max number of tic number

       parameter ( ipsm = 100 )
 *                   max number of include ps file in one graph

       parameter ( nr = 50 )
       parameter ( nc = 50 )

 *     nr: maximum number of row in one table
 *     nc: maximum number of column in one table

 *-----------------------------------------------------------------------

       parameter ( r0max = 1.0d+40,  r1max = 1.0d+41 )
 *                   max real number

       parameter ( r9max = 1.0d+39 )
       parameter ( r9min = 1.0d-39 )

       parameter ( pi = 3.1415926535898d0 )

 *-----------------------------------------------------------------------

       parameter (jol=18)
 *                   output temporary file of lines
       parameter (jil=19)
 *                   output temporary file of region line
       parameter (jhc=20)
 *                   output temporary file of 3D color plot
       parameter (jhl=21)
 *                   output temporary file of 3D cluster plot
       parameter (jer=22)
 *                   for error message
       parameter (jps=23)
 *                   input ps file
       parameter (jab=24)
 *                   angelbat for psview only for unix
       parameter (jht=25)
 *                   final eps output for angel
       parameter (jhs=26)
 *                   temporary file of gauss smearing for contour plot
 *                   temporary new input file
 *                   temporary file for wtab
       parameter (jwt=71)
 *                   temporary file for wtab:
       parameter (jhm=72)
 *                   temporary file for w: wt:
       parameter (jha=73)
 *                   temporary file for aw:
       parameter (jhy=74)
 *                   temporary file for y-comment

 *-----------------------------------------------------------------------

2.1.7. メイクファイル¶

パッケージに入っているMakefileを以下に示します。機種依存のところのコメントを目的のものに合わせて外してください。全てPATHが通っているとして書いてあります。またオプションは、コンパイラに合わせて変えてください。 ANGEL としては、特別なオプションは必要ありません。ライブラリーとしては、日時をとるためにdate( ), time( )を使っています。これが利用できるようにしてください。

List 1.12　● Makefile

 #------------------------------------------------------------------------
 #
 #       @(#)Makefile  2002/08/06
 #
 #       Makefile for ANGEL
 #
 #------------------------------------------------------------------------
 ##### sources #####
 #------------------------------------------------------------------------

 OBJ1 = \
       a-alone.o

 OBJ2 = \
       a-main1.o  a-hsect.o  a-line.o  a-func.o  a-utl00.o  \
       a-main0.o  a-wtext.o  mdp-uni.o

 #------------------------------------------------------------------------
 ##### set executable file name #####
 #------------------------------------------------------------------------

 TERGET = angel400

 #------------------------------------------------------------------------
 ##### set compile options #####
 #------------------------------------------------------------------------
 #Alpha
 # FFLAGS = -O4 -warn noalignments -warn nousage
 # FC = f77
 #------------------------------------------------------------------------
 #Linux pgf
   FFLAGS = -O4
   FC = pgf77
 #------------------------------------------------------------------------
 #Linux g77
 # FFLAGS = -O4 -fno-automatic
 # FC = g77
 #------------------------------------------------------------------------
 #Sun
 # FFLAGS = -O
 # FC = f90
 #------------------------------------------------------------------------
 #HP
 # FFLAGS = +DA1.1 +O0 +e +U77 +Onolimit
 # FC = f77
 #------------------------------------------------------------------------

 MAKE    = Makefile
 CC      =  cc
 CFLAGS  = -O0

 OBJS = $(OBJ1) $(OBJ2)

 .f.o    :
         $(FC) $(FFLAGS) -c $*.f
 .c.o    :
         $(CC) $(CFLAGS) -c $*.c

 all     :$(OBJS)
         $(FC) -o $(TERGET) $(OBJS)

 $(OBJ1) : angel00.inc
 $(OBJ2) : angel01.inc

 clean   :
         rm -f $(OBJS)

2.1. 運用方法¶

2.1.1. 本体起動¶

2.1.2. 本体起動シェル¶

2.1.3. Ghostview起動シェル¶

2.1.4. エラー出力¶

2.1.5. ソースファイル¶

2.1.6. インクルードファイル¶

2.1.7. メイクファイル¶

外部リンク

目次

前のトピックへ

次のトピックへ

このページ