人気ブログランキング | 話題のタグを見る

はこにわオーディオ工学研究分科会 (旧名: バスレフ研究所)

プログラムドキュメント作成の難しさ

MCAP-CR型多自由度を含むバスレフ型の力学シミュレータプログラムは、一昨年に完成し、昨年公開しました。
そろそろ次の機能向上を考えていますが、その前に、これはこれで一つの完成形として、ドキュメントを作成しています。
プログラムは、作ったそのときは分かるのですが時間が経つと内容を追うことが難しくなり、ましてや他人が読むのは困難です。
本職のプログラマであれば、おそらくコメントだけで内容が分かるようように作れるのですが、自分のような素人のプログラムは、追っていくのが難しいと思います。
また、内容は、科学技術あるいは工学計算プログラムなので、厳密性が必要です。
そこで、最初に、サブルーチンの一覧と変数の一覧、主要な計算の一覧を作成したまでは良かったのですが..

これだけでは自分も分からないので、フローチャートを書いてみました。
すると、フローチャートが複雑になって余計に良く分かりません。
分岐ブロックが増え、同じことをあちこちに書かなければなりません。
計算オプションを分け、処理を微妙に変えてもその中には共通の処理も多くあります。

書いてみると、正直言って複雑過ぎます。
通常のフローチャート図式を使わずに、自分の書式で作ったほうがいいのかもしれません。
そういえば、フローチャートの記号も複数あるようで、これを使えば絶対、という定型はなさそうに見えます。
皆さん同じように悩んだのでしょうか。
挫折が多過ぎます。

ちょっと頭を冷やして考えてみます。
by mcap-cr | 2014-01-25 15:10 | プログラミング | Trackback | Comments(0)

生演奏を主とすれば、オーディオは箱庭で充分でしょう。
by MCAP-CR

最新の記事

飛行機での出張はつらいな
at 2024-03-28 06:49
雑談
at 2024-03-26 06:38
自作イベント...
at 2024-03-25 06:06
小澤征爾音楽塾2024コジ・..
at 2024-03-24 10:08
ベートーヴェンのピアノ・ソナ..
at 2024-03-21 22:06
Buchbinderのベート..
at 2024-03-20 08:06
何故か最後はうまくいく?
at 2024-03-19 06:54
Buchbinderのベート..
at 2024-03-18 06:36
Buchbinderのベート..
at 2024-03-16 06:54
OpenOffice BAS..
at 2024-03-12 06:45
デスクトップ環境
at 2024-03-10 07:14
Linuxのシェア拡大開始を..
at 2024-03-09 06:56
派手な楽曲から静かな楽曲へ
at 2024-03-07 20:52
終りのない議論
at 2024-03-05 06:17
除湿機
at 2024-03-02 18:27
電源タップ
at 2024-02-29 07:35
時代が追い付いてきた
at 2024-02-28 06:35
ラズパイより安くなってきたミ..
at 2024-02-27 12:48
HDDのクィックでないフォー..
at 2024-02-27 06:58
TurboCADのサポートが..
at 2024-02-26 06:25

以前の記事

2024年 03月
2024年 02月
2024年 01月
2023年 12月
2023年 11月
2023年 10月
2023年 09月
2023年 08月
2023年 07月
2023年 06月
2023年 05月
2023年 04月
2023年 03月
2023年 02月
2023年 01月
2022年 12月
2022年 11月
2022年 10月
2022年 09月
2022年 08月
2022年 07月
2022年 06月
2022年 05月
2022年 04月
2022年 03月
2022年 02月
2022年 01月
2021年 12月
2021年 11月
2021年 10月
2021年 09月
2021年 08月
2021年 07月
2021年 06月
2021年 05月
2021年 04月
2021年 03月
2021年 02月
2021年 01月
2020年 12月
2020年 11月
2020年 10月
2020年 09月
2020年 08月
2020年 07月
2020年 06月
2020年 05月
2020年 04月
2020年 03月
2020年 02月
2020年 01月
2019年 12月
2019年 11月
2019年 10月
2019年 09月
2019年 08月
2019年 07月
2019年 06月
2019年 05月
2019年 04月
2019年 03月
2019年 02月
2019年 01月
2018年 12月
2018年 11月
2018年 10月
2018年 09月
2018年 08月
2018年 07月
2018年 06月
2018年 05月
2018年 04月
2018年 03月
2018年 02月
2018年 01月
2017年 12月
2017年 11月
2017年 10月
2017年 09月
2017年 08月
2017年 07月
2017年 06月
2017年 05月
2017年 04月
2017年 03月
2017年 02月
2017年 01月
2016年 12月
2016年 11月
2016年 10月
2016年 09月
2016年 08月
2016年 07月
2016年 05月
2016年 04月
2016年 03月
2016年 02月
2016年 01月
2015年 12月
2015年 11月
2015年 10月
2015年 09月
2015年 08月
2015年 07月
2015年 06月
2015年 05月
2015年 04月
2015年 03月
2015年 02月
2015年 01月
2014年 12月
2014年 11月
2014年 10月
2014年 09月
2014年 08月
2014年 07月
2014年 06月
2014年 05月
2014年 04月
2014年 03月
2014年 02月
2014年 01月
2013年 12月
2013年 11月
2013年 10月
2013年 09月
2013年 08月
2013年 07月
2013年 06月
2013年 05月
2013年 04月
2013年 03月
2013年 02月
2013年 01月
2012年 12月
2012年 11月
2012年 10月
2012年 09月
2012年 08月
2012年 07月
2012年 06月
2012年 05月
2012年 04月
2012年 03月
2012年 02月
2012年 01月
2011年 12月

最新のコメント

> tincanさん ..
by mcap-cr at 20:06
左右で箱一つのタイプは少..
by tincan at 11:58
> Grigriさん ..
by mcap-cr at 10:14
ブレーカーが上がる?・・..
by Grigri at 18:56
> somo_somoさ..
by mcap-cr at 14:18
Linuxが普及しない理..
by somo_somo at 12:19
> tincanさん ..
by mcap-cr at 14:26
毎度お邪魔します。 ..
by tincan at 11:02
> somo_somoさ..
by mcap-cr at 06:07
2024年度にwin12..
by somo_somo at 12:20

最新のトラックバック

検索

ファン

ブログジャンル

画像一覧

イラスト:まるめな