SAD本体のコードは20年選手なので、紆余曲折を経て謎コードになっている部分を理解するには、古いコードを発掘して変更内容を追跡することが必要になったりしますが、関連する変更箇所を探しながら時間方向に遡る作業は CVS向きでは無いのでCVS repositoryをコピーしてきて調査用の Subversion repositoryを生成してみる。

ふむ、CVS repository上最古のコードは 1995年なのか... その時点で呼び出し元と呼び出し先で引数の数と型が整合していない例を見たことがあるが、そこから遡る追跡調査は至難の技かな

変更差分調査の意義

「ソースがドキュメントだ」とか「ソースにすべて書いてある」とか言う人もいますが、下記の理由によりコードやデータ構造を理解するにはインクリメンタルな変更差分から変更意図を類推する作業が必要です。

内部のデータ構造/APIの仕様書とその改訂履歴が無い
内部での大域的データ構造へのアクセスコードにMagic Numberが即値で埋められている
ソース上にコメント等の解説が無い、もしくはコードと同期していない
- 複数のソースのコメント間に矛盾した記述が有る場合も...
- 同一のデータ構造の取扱いにコード間で矛盾がある場合も...
CVS repositoryのコミットログに変更意図が記述されていないので変更差分から類推する必要がある
- Version番号だけでは、変更意図が分かりません
- 変更差分が、バグ入りで変更意図を反映していない場合も...

最近調査中のコード

コメントを読む限り、 src/inc/MACPHYS.incの echargには、昔は elementary chargeがC単位で入っていたようなのですが、途中からエネルギーの単位がJからeVに変更され echargが1になっているが、参照コードによっては 1.602176487x 10^-19 Cであることを期待しているものが見受けられる。

同じ物理定数が異なる名前で、複数箇所で定義されている。光速cや真空の透磁率$\mu_0$のように定義値になってるものはまだ良いが、観測量なものに関しては複数箇所で定義するのは保守性の悪化を招く。 (kg(シリコン単結晶の真球を使ってアボガドロ数を定義値にして定める)か J(ホール効果等からプランク定数hを定義値にして定める)を定義値にするって話は出てるけど、置き換えまだ〜)

事実、収録元か収録時期が異なる観測量な物理定数が存在する。また、こうした定数は 2003年から更新されていない。

_ [雑記]最近、暗くなるのが遅い

流石に 7時半を回ると真っ暗ですが、 7時だとまだ明るい。

ついに、明るいうちに店がしまる季節到来 Orz

[ツッコミを入れる]

カテゴリー: Admin | Emacs | EPICS | Fortran | FreeBSD | GCC | hgsubversion | IPv6 | KEKB | LHC | Lisp | LLVM | MADX | Ryzen | SAD | samba | tDiary | unix | WWW | YaSAI | お仕事 | イベント | 出張 | 宴会 | 数学 | 艦これ | 買いもの | 追記 | 雑記