JCPRG : コーディングに対する補足と注意

現在はHENDELを介した入力を行うので、入力時に本マニュアルを参照する必要はない。(2009.08.14)

(1995年度改訂版)
北海道大学理学部物理　向井　重雄・吉田　ひとみ

コーディングをするにあたっての基本となる文法について

１．使用できる文字、記号

パンチ可能なもので以下はそのリストである。

文字	A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
数字	0 1 2 3 5 5 6 7 8 9
特殊記号	# @ \ * > < / + - _ ( ) [ \| & : ; ' ? ! = . , (space)

２．記号の特殊な用法

記号	説明	用例
[	[1] およそ、約。数値の後に用いる。	[5: 約5
[	[2] 範囲。数値と数値の間に用いる。	3[5: 3から5まで。
?	不確定。数値またはコードの前につける。	5?：5らしい
>	以上。数値または量をあらわすコードの前につける。	>5: 5以上
<	以下。数値または量をあらわすコードの前につける。	<5: 5以下
=	等しい。左辺はコード、右辺はコードまたは数値。	RSD=197AU: 残留核は金197である
'#'	連結子をあらわす。#は１文字または２桁以下の数字。	'5': 連結子5番
/comment/	コメント文をあらわす。コメント番号のみを /@n1n2@/ と記してよい。その場合は内容は Free Text のページにまとめて書く。	/ '1'comment /: 連結子1番を持つコメント。
+-	誤差の上限、下限をあらわす。	+-3: プラスマイナス3
\\	セクションのはじまりをあらわす。	\\BIB,1;
\	データ・テーブルのはじまり\DATAと、終わり\ENDをあらわす
,	複数個の値を分ける。	197AU,208PB: 金197と鉛208
;	文の終わりを示す
(,)	値が複数個あることをあらわす。多重カッコは許されない。	(197AU,208PB): 金197と鉛208
+	[1] 和集合を示す。２つ以上の数値またはコードの間に用いる。	MAG+MWPC: 磁気スペクトロメータと多線比例計数管
+	[2]正のパリティをあらわす。この場合、J-PI=の次に数値の後につける。	J-PI=3+: J^π=3⁺
-	負パリティをあらわす。J-PI=の次の数値の後につけられる。	J-PI=2+: J^π=2⁺
-	複合コ−ドを合成するのに用いる。 NRDFでは単純コ−ドを複合して多種多様の複合コ−ドを作成することができるが、検索の便を考えると、同一内容をもつ多くの語のあることは必ずしも好ましくないので、複合語をヘッダーなどのため新しく合成する場合には充分注意すること。	EXC-ENGY: 励起エネルギー
/	分数記号。	2/3: 3分の2

３．単位

次の単位を用いることができる。
GEV (10⁹eV), MEV (10⁶eV), KEV (10³EV), CM (cm), M (m), U (μ), P (pico）, N (nano), F (femto）
単純単位の数式表現による複合単位を用いることができる。
複合単位を用いる場合でもコ−ドとして登録する必要がある。
例） CM**2.3, ueV, KEV/CM
数式表現を単純コ−ドを用いて構成することができない場合、または複雑な表現になる場合UNITを用いコメントを付す。
例) UNIT'1'

４．連結子

同一セクション内のデ−タの連結を行う連結子は２桁以内の正整数を用いて'ｎ'，セクションにまたがる連結子は２文字以内までのアルファベットを用いて'Ｘ'あるいは'ＸＹ'とする。

５．粒子と原子核

次の記号用法を用いる。

電子: E
陽電子: EP
反粒子: Aを左側につけてあらわしてもよい。K⁰はAK (ただし、現在は、この反粒子の記号は用いることはできない。)
原子核: 208PB(鉛208), 　PB(natural Pb) 自然同位体比の窒素および燐は、999N, 999Pと書く。

６．核反応

以下、 pを入射粒子 (incident particle)、 Tを標的 (target nucleus)、 a, a1, a2, a3..., b ,b1, b2...を放出粒子 (emitted / outgoing particle)、 Rを残留核 (residual nucleus) として表示する。

反応種	反応式	NRDFコード	コメント
通常の２体反応	p+T→a+B	T(p,a)B	aは必ずしも検出粒子でなくてもよい。検出粒子は検出粒子として別途に記入する。
多粒子放出反応	p+T→a1+a2+...+an+B	T(p,a1,a2,...,an)B	a1,a2,...anは、必ずしも検出粒子でなくてもよい。 a1,a2,...an順序は普通問題にしない。しかし、粒子の放出の順序を問題にするとき、左に書かれた粒子ほど早く放出されるものとする。
同一粒子放出反応	p+T→a1+a1+....+a1+a2+a2+...+a2+B	T(p,na1,ma2)B	個数が不明の場合はnやmをXとする。
包括反応	p+T→a+X	T(p,a)X'1'	検出粒子a以外は不明として残留核の所にXを記入する。包括反応であることを連結子をつけて必ずコメントする。
順次反応	p+T→a1+a2, a2→b+B	T(p,a1)a2+a2(,b)B	検索は第一反応その後の＋記号のみで行う。二段目の核反応は検索の対象にならない。現在、この反応式は、使用できない。
準安定状態生成反応	p+T→a+B^meta	T(p,a)B'1'	準安定状態、核異性体のの記号は記入しない。コメントをつけて説明する。
核分裂反応	T(p,fissn)	T(p,FISSN)	FISSNは核分裂であることを示し、核種コ−ドに登録する。
核融合反応	p+T→B	T(p,)B	現在この反応式は使用できない。

７．Data Stream,Data Set の構成

標準的な構成: 別紙: p15〜p17を参照「荷電粒子核反応データファイル作成報告書」（昭和56年3月）から引用
同一のデータセット番号をもつ複数個の \\DATA section は、共通のnumerical data のくくりだし（例１）以外存在してはならない。従って（例２）のようなものは許されない。
例１）
```
 \\DATA,1,2;
  ...
 \\DATA,1;
  ...
 \DATA;
  ...
 \END;
```
例２）
```
 \\DATA,1;
  ...
 \DATA;
  ...
 \END;
 \\DATA,1;
  ...
```
１つの \\DATA section に複数個の表(\DATA)を持つことができる。しかし、このような構成はできるだけさける。
```
 \\DATA,1;
  ...
 \DATA;
  ...
 \END;
 \DATA;
  ...
 \END;
```

各section、及び DATA set の順序には意味がない。しかし、１つのデータsection の中で表(\DATA)、文、コメントの順序は論理的意味をもつ。

 \\DATA,1;
 文またはコメントまたは空白
 \DATA;
 データ・テーブル（１）
 \END;
 コメントまたは空白
 \DATA;
 データ・テーブル（２）
 \END;
 コメントまたは空白

入射粒子か放出粒子のエネルギーを heading に用いる場合には、必ずINC-ENGY-CM, INC-ENGY-LAB または ENGY-EMT-CM と ENGY-EMT-LABとする。

８．グラフデータ

論文中の Figure データのうち Input する Figure を赤ペンで指定する。指定時に必要な項目は次の通りである。この指定は赤文字で行う。

A) Fig.ID。必ずしも論文中のFigure NO と同じである必要はないが、コーディングの \DATA のテーブルに付したFigure No と同じものでなければならない。例) Fig.1-a
B)エラータイプ。グラフ上に示されたエラーの型をグラフの近くに以下の記号で記入する。・点データ　Ｂ・上下対称なエラー　ＡＢ・上下非対称なエラー　　　　　ＡＢＣ・上下左右対称なエラー　　　　　　ＡＢＤ・左右対称なエラー　　　　　ＢＤ・左右非対称なエラー　　　　　　　ＢＤＥ・上下対称左右非対称なエラーＡＢＤＥ
C)たて、よこ軸の変数名（コード）、単位（ユニット）としてコーディングのヘッダに記入したものと同じものを各軸の近くに記入する。
D)軸の目盛りが linear と log の何れであるかを記入する。
E)データ変数が整数であることが明らかな時、例えばカウント数などは実際は整数であるが、ディジタイザーでは整数として読み取らないのが普通であるので、 Integerと軸のそばに記入し、注意で数値の小さい方から対応する数値を書いておく。
F)グラフ読み取り時に注意を要するデータについては、論文中のfigure のそばにわかるように注意を付してその内容を書く。
例１） E2 transition
```
 B(E2) 
 Ii   2+ 4+ 6+   
 If   0+ 2+ 4+
 注意 Ｘ軸を２とおり入れてください　    
```
例２）定数倍して図示されているもの
```
X Y×10 
注意 　×１０  の部分のデータはＹの数値を１０倍にする。
```
入力する Figure データにつける番号すなわち Figure ID は、 Figure データ毎に異なるものでなくてはならない。コーディング記法は FIG.n1-n2-n3 とする。ここで ni は任意の英数字である。
例）

文献コーディング表現

FIG.1a FIG.1-A

FIG.1Aa FIG.1-(A)-(A)
コーディング・シートにおける Figure ID は /* と */で囲む例） /* FIG.1-A */

９．コメント

核データ記入用紙の書式を用いては記入しにくい情報は further information として英文で自由に記入してよい。記入の仕方は以下の方法で行う。
コメント連結子は数値または文のすぐ後ろにつける。
例）A=pcm'1';
カッコに囲まれた数値またはコードの各々にコメントがある時は、それらの数値またはコードのすぐ後ろにフラグをつける。
例）A=(P'1',Q,R'2');
または、カッコ内の全ての数値またはコードの全てにコメントを付ける時は、カッコの外にフラグをつける。
例) A=(P,Q,R)'1,2';
section 全体にわたるコメントは section 番号のすぐ後につける。
例）\\EXP,1[n; /* @1@ */

１０．フリーテキスト（ Free Text ）

コメントの内容には、辞書に登録されていない物理量、入力する物理量等に対するコメントなどの場合がある。これは文字、数字、記号で自由に書くことができる。

コーディングシートの最終シートすなわち \\END; で終わっている後につける。
記入用紙として、 FORMAT CODING 用紙の2カラムから72カラムの間(2,72カラムを含む)を用いる。
1カラム,73カラム以降には記入しないこと。英単語が72カラムを越える時は次の行の2カラム目に続く。次の@@が表れるまで何行にわたってもよい。
Free Text で書いた内容がデータセットのどこに取り込まれるか、取り込む場所（文の後すなわち；の後）に /* @n@ */ のように、取り込むべき Text の識別番号nを@で囲んで記入する。 nは任意の桁の正整数で現れる順に昇順とする。
記入書式
```
----+----1----+----2----+----3----+----4----+----5----+----6----+----7--
 @@1;
 AB-IS,D
 @@2;
 AB is D.D.C and EA
 REF
 @@;
```
2カラム目から@@ｎ；（nは comment 識別番号）を記入し、その後（改行してもよいが必ずしも改行しなくてもよい）にフリーテキストの内容を書く。フリーテキストの記入順序は定まっていない。必ずしも COMMENT 識別番号順でなくてもよい。フリーテキストの終わりは必ず @@; と記入する。
コメント文に用いる文字は@および;を除いて制限はないので、 'n'が連結子の意味を持たないであらわれてもよい。実際上は、コメント文の中の連結子の場合にのみ、コメントの中に'を用いることを認めることにしている。この場合データが連結していることは、人が目で判断しているのであって、処理手順の上で連結していることが示されるのではない。

１１．新規コードの作り方

コード表を見て対応するコードがないことを確認する。
よく使われている物理量、単語であり、フリーテキストとしてコメントで入力することでは不十分であることを確認する。この確認はコーディング担当者が行う。
すでに登録されているコード、単位を組み合わせて複合コード、新しい単位を作成しても直ちに使用可能とはならない。必ず新規コードの登録が必要である。

新規コードは次の登録手続きを行ってはじめて使用することができる。 Campus Card に

(a)	論文(D)番号（具体的な論文が無い場合は、記入しなくてもよい）
(b)	新コード、単位
(c)	定義
(d)	展開形
(e)	分類（単純コード、複合コード（核反応、検出、物理量、その他）、単位）
(f)	項目名（左辺）のものか項目値（右辺）のものか
(g)	属するクラス番号
(h)	申請者氏名
(i)	日付
(i)	日付

を以下の e-mail addressに送る。hitomi@nucl.phys.hokudai.ac.jp

申請のあったコードについては、毎月の運営委員会で議論し決定する。

１２．コーディング上での注意

コメント連結子のつけ方：正しく連結すべき数値またはコードの直後につける。空白を開けないこと。単位のついた数値に付ける連結子は単位の直後につける。
\DATA のデータ・テーブルの Figure ID, ヘッディング、ユニットが文献中の Figure 指定における Figure ID、ヘッディング、ユニットと同じくする。異ならないように注意。
\DATA のデータ・テーブルのヘッディング、ユニットが、図指定時に記入したエラーのタイプと対応すること。エラーのタイプによるヘッディングの様式の違いを下表に示す。

（エラータイプ）ヘッデイング

(AB,ABC) 　 X Y Y-DELTA

(B) X Y

(ABD,ABCD,ABDE) X DELTA-X Y DELTA-Y
エラータイプは、一つの Figure に対して一つであること。
最も詳細なエラータイプを採用する。 (例) AB 左の例は B-type のデータと AB-type のデータがあるがエラー形式はABで指定する。
すべてのセクションの最後に、データセットの終わりの制御文 \\END を必ず記入すること。
フリーテキストを書く時、 @n@ ,@@n; の文字列において文字と文字の間に空白を入れないこと。
reduced width γ2/γ2w は S-factor に対応する量なので入力する。
数値データはていねいに、エラーのないように記入すること。
英文字は全て大文字で記入、小文字は使わない。
データ・テーブルのヘッダーなどで物理量をコード DATA1, DATA2で書くとき、必ず何の物理量であるかフラグをつける。
　例） DATA,1'1' , DATA,2'A'
　 DATA コードを用いる場合は、その物理量に対応するコードがない場合であり、新規コードを作るのが困難と判断される場合である。むやみに用いないこと。 DATAにフラグを付けない。
例）DATA'1'のような使用方法は避ける。
単位のついた数値は数値と単位を切り離して書くことはできない。
A=5.0 FM; → A=5.0FM; A=(5.0,10.0)FM; → A=(5.0FM,10.0FM);
未登録のコードを用いる場合には当該コードをできるだけ登録する。やむを得ない場合単位コードとして UNIT を用い、これにコメントを与える。この時連結子は UNIT に対応する header につけること。このコメントを連結子を用いて与えることができる。しかしながら数値データの検索出力をグラフ形式で行った場合、軸の名称として UNIT が表示されるので、コメントが出力されないことに注意する必要がある。
Institution of author(s)、Journal、Reaction(s) の項目は、辞書に登録されたコードを使う。コードがない場合は、コメントの形式にし、X'1'と記入し Free Text に full name を英文で書く。
Intitute については TRIUMP、SIN のようにニックネームで呼ばれているものを含めて、該当する Institute の Key-word がない場合、その Institute の国名の Key-word(３文字)を２つ重ねてその後の連結子につけ、 Free-Text に Institute 名を英文名で書く。
例）
1CANCAN'1'：カナダにある Institute で Key-word がないもの
2JPNJPN'2' 日本にある Institute で Key-word がないもの
KEY-WORD は正しく書くこと。
- 複合コードは必ずハイフンでつなぐ "GAMMA RAY" → "GAMMA-RAY"
- "DEGREE"→"DEG"
Range を持った数値の書き方
例）
100[200MEV, (100[200)MEV, 100 [ 200MEV → 100MEV[200MEV;
Free Text の最後の行に必ず @@; をつけること。よく落ちている。
polarized beam (例; p) や inelastic-channel particle (例；p0, p1, p2)につく、ベクトル記号や添字はつけない。特にTitle にある場合が多いが、ベクトル記号、添字をつけない記入の仕方で書く。
resonance energy E_lab, E_cm, E_ex の区別は次のように書く。
E_lab→RESN-ENGY-LAB
E_cm→RESN-ENGY-CM
E_ex→RESN-ENGY-EXC

（エラータイプ）	ヘッデイング
(AB,ABC)	X Y Y-DELTA
(B)	X Y
(ABD,ABCD,ABDE)	X DELTA-X Y DELTA-Y

データテーブルで nucleus 名を変数にできる。
例）

header    TGT     XSECTN
unit     (NODIM)  (MB) 
          12C     2.0   
          16O     3.0   
          20NE    4.0

使用できる文字、記号すなわちカナ文字、英小文字を除くパンチ可能な文字、記号以外の文字、記号を使用しない。
Nilsson model 等であらわれるような［，］(例［Nl∧］) 記号は (,) で書く。
direct product [f×g]は (F D.P. G)と書く。
矢線　　　は　　　と書く
固有名詞は英字表記で書く。
英字以外の外国語における表記（例;À, Á, Â, Ã, Ä, Å 等）には注意する。
文献に現れた明らかな誤りは訂正して記入する。しかし疑問点については著者の意見に従う。
軸の変数が２種類以上ある一つのグラフは、同じグラフを２つ以上に分け、データ・テーブルを複数個作る。その際 Figure ID に注意。異なる ID を記入し識別を明確にする。
spin assignment の記入

論文中の標式 coding の標式

(7/2)^- 7/2?-

(7/2^-) 7/2?-?

(5/2,7/2) (5/2,7/2)

5/2,(7/2) (5/2,7/2?)
electron orbit, K-, L- shellはKSH, LSH のコードを用いる。
数値などのテーブル上で該当する要素（データ）がないときは、ブランクでなく必ずX記号を入れる。
テーブルにゼロックス・コピーによる論文中のテーブルを貼り付けてもよい。しかし、不必要なデータ、許されない記号は赤字で消すか書き換える。

論文中の標式	coding の標式
(7/2)^-	7/2?-
(7/2^-)	7/2?-?
(5/2,7/2)	(5/2,7/2)
5/2,(7/2)	(5/2,7/2?)

別紙

I.[1] 以下に説明するデータ記入の形式（入力書式）は、一つの実験または１篇の文献に記載されている荷電粒子核反応データの収集を目的として設計したものである。この書式にしたがって入力することによりコーディング者がデータ収集作業を行なうことができる。また、このことで原子核実験研究者が直接データ収集をできるものとしたい。
I.[2] 最初にこの入力書式全体の構成についてのべておく。図１に示すように入力データは３つの section に分かれている。これらをそれぞれ BIB section , EXP section および DATA section とよぶ。各 section には以下の内容を記入する。
- BIB タイトル、著者名、著者の所属機関などの書誌的事項
- EXP 核反応の型、加速器、ビーム測定器などの実験条件
- DATA 終状態を指定するなど数値データを同定する条件と数値データ
各 section の最初は必ず \\ の記号ではじまることになる。したがってBIB,EXP,DATA の各 section の最初は \\BIB,\\EXP,\\DATA のスティトメントではじまることになる。同一の EXP の実験条件のもとで行なわれる測定も、反応後の終状態が異なれば得られた数値データも異なってくる。このような反応の終状態などの条件は DATA section に記入する。
数値データを記入する場合ただ数値のみをならべたのでは、それらがどの研究者がいかなる測定によって得た数値データであるのか明らかでない。他の文献ファイルなど用いなくてもこのデータファイルで書誌的事項や実験条件を知ることができるようになっている。図１は簡単な例によってその記入書式全体の構成を示したものである。
図１　入力書式全体の構成例　
```
\\BIB,1,2,3,...;
  BIB section     (書誌的情報の記入)
                                                                         
\\EXP,1,2,...;
  EXP section     (一般的実験条件の記入)
       
\\EXP,2;
  EXP section     (終状態の選択など個々のデータに固有な測定条件)

\\DATA,1;
  DATA section    (測定条件記入と数値データの列)
\DATA;
  DATA subsection (数値データ 微分断面積 励起関数など)

\\DATA,2;
  ....
```
まず個々の測定によって得られた数値データの組に適当な番号、この例では１〜３の番号が与えられており、この番号がそれぞれ \\DATA につづくマス目に記入されている。例えば、微分断面積や励起関数の数値データの列、\\DATA,k　の次には、反応の終状態など個々の場合の測定条件と、 \DATA につづく数値データの列がならんでいる。いまデータの組「１」とデータの組「２」とが同一の実験条件のもとで得られたとする。この場合には同一の実験条件を２度繰り返さなくても、 \\EXP に続く枠の列のなかに「１」、「２」の番号を記入し、その下に実験条件を具体的に一度だけのべれば充分である。枠のなかの番号１、２は、それぞれ「１」「２」のデータの組みがいずれも\\EXP,1,2,...; に続いて記入されている実験条件のもとで得られたことを示している。また図１の「３」のデータの組が、「１」「２」のデータの組みの場合と異なる実験条件のもとで得られたことを示している。
さてこれらいずれのデータの組みも書誌的事項を共通にしている。このことを示すため、\\BIB につづくマス目に１、２、３の番号を記入する。
I.[3] 以上の関係を逆にいえば、 BIB section はまづ複数の EXP section に展開されている。このことを、 \\BIB と \\EXP につづくマス目に対応する番号を記入することによって示す。同じく個々の EXP section は単数または複数の DATA section に展開されている。この場合にも BIB section の場合と同じように、 \\EXPと \\DATA につづくマス目に適当な番号を記入することによって、両者の関係を表すことができる。
以上のことを要約してみよう。個々の数値データの組を同定するには、ビームの条件、標的核や個々の測定の条件など、きわめて多くの条件に関する情報を必要とするものであって、この核データの記入書式では、これらの多くの条件のうち共通した部分をできるだけ前にくり出しながら、全体に共通なものと部分的共通なものとに分けてそれぞれひとまとめにし、これらひとまとめにした条件の間の関係を表現することができるように工夫されている。
さて、核データは、一つの DATA section とこれに応じた EXP section および BIB section をあわせて、はじめてまとまったものとなる。１個の DATA section と、これに応じた EXP section および BIB section を加えたものをデータセットという。図２のように、多くのDATA section が一つの EXP section 、BIB section を共有する場合には、破線の閉曲線に応じた複数のデータセットが形成されている。実際には BIB、EXP、DATA の各 section の分け方が非常に明らかなわけではない。そこで各 section には記入に便利なように各 section に属する項目をならべておいて、これら個々の項目に対する情報を所定の場所に記入することになっている。
以下、まず２、３、４節では典型例を用いて、 BIB、EXP、DATA section の記入法について説明する。５ではデータ記入に必要な文法についてのべ、６では特殊な用例を示す。特殊な用例が必要となる場合も多いと思われるが、そのためにはあらかじめ文法を正しく厳密に理解しておくのがよい。
```
図２　　　 は一つのデータセットを示す。
              BIB section
              EXP section                           EXP section
              DATA section       DATA section       DATA section
```
この部分の説明は、 NRDF-2で処理するデータのデータ構造が、樹状的な場合に限っているような印象を与えると思われる。これは図１の示すデータ構造が樹状的であるためであって、 BIB、EXP、DATA の関係は樹状的であるとは限らない。

文献	コーディング表現
FIG.1a	FIG.1-A
FIG.1Aa	FIG.1-(A)-(A)

（エラータイプ）	ヘッデイング
(AB,ABC)	X Y Y-DELTA
(B)	X Y
(ABD,ABCD,ABDE)	X DELTA-X Y DELTA-Y