[公式ガイドサンプル] CSVファイルにデータを丸めて書き出し、読み込んで2次元グラフを描く

このプログラムは、 「 VCSSLスタートアップガイド 」 の 「 CSVファイルとグラフの描画 」 の回に登場するサンプルコードです。 ここでは、そのサンプルコードを実行環境ごとダウンロードして、実際に実行してみる事ができます。 プログラミングガイド的な詳しい解説については、上記ページをご参照ください。

スポンサーリンク

---

使用方法

ダウンロードと展開（解凍）

まず、PC（スマホは未対応）で上の画面の「 ダウンロード 」ボタンを押してください。 するとZIP形式で圧縮されたファイルがダウンロードされます。

その後、ZIPファイルを右クリックして「すべて展開」や「ここに展開」などで展開（解凍）してください。 展開が成功すると、ZIPファイルと同じ名前のフォルダができ、その中にZIPファイルの中身が入っています。

» 展開がエラーで止まってしまう場合や、ファイル名が文字化けしてしまう場合は…

プログラムの起動

Windows をご使用の場合

上記でZIPファイルを展開したフォルダ内にある、以下のバッチファイルをダブルクリック実行してください：

もしプログラムを書き変えながら使いたい場合は、代わりに「 VCSSL_Editor__プログラム編集はこちら.bat 」を実行してください。

正常に起動できると、初回のみ、Java実行環境を入手するか等を尋ねられるので、適時答えて済ませると、プログラムが起動します。 2回目以降はすぐに起動します。

» うまく起動できずにエラーになってしまう場合は…

Linux 等をご使用の場合

ZIPファイルを展開したフォルダ内へコマンドライン端末で cd して、以下の通り入力して実行してください：

» javaコマンドが使用できない等のエラーが表示される場合は…

起動後

起動すると、まず同じフォルダ内に「 file.csv 」という名前のCSVファイルが作成され、 その中に以下の内容が書き出されます（メモ帳などのテキストエディタで開いてみてください）：

- file.csv -

これはカンマ記号「 , 」区切りで、 2列（縦の並び）のデータが記載されているものです。 1行（横の並び）がグラフの1点に対応していて、左の値がX座標、右の値がY座標とみなされます。

さて、上記のファイルが書き出された直後に、自動でグラフソフトが起動し、下図の2次元グラフが描画されます：

これは、上で書き出されたCSVファイル「 file.csv 」の中に記載されたデータが、2次元グラフとしてプロットされたものです。

別に、一旦ファイルに書き出さなくても、プログラム内のデータから直接グラフを描く事はできるのですが（アニメーション等ではそうした方が高速です）、 データの数値を目視で確認したり、別のソフトやプログラムと組み合わせて使用する場合などには、ファイルを介してデータをやり取りするのが便利です。

コード解説

このプログラムのコードはVCSSLで記述されています。

内容を書き変えて改造したい場合には、 プログラムのコード「 Graph2DRoundWriteLoadCsv.vcssl 」をテキストエディタで開いて改造してください。 スクリプト言語なので、コンパイラなどの別ソフトは不要で、コードを書き換えるだけでOKです。 VCSSLはC系の単純な文法の言語なので、C言語などに触れた事のある方なら簡単に読めると思います。

コード全体は以下の通りです。

以上です。30行程度の非常に短いコードですね。 詳しい解説は、このサンプルコードの掲載元である 「 VCSSLスタートアップガイド 」 の 「 CSVファイルとグラフの描画 」 の回をご参照ください。

なお、このサンプルコードは、前回のサンプルコード 「 CSVファイルにデータを書き出し、読み込んで2次元グラフを描く 」 とほとんど同じで、数行追記しただけです。 なので、コード内容を追いかけての説明は、上記ページをご参照ください。

さて、今回のコードが前回とどう違うのかというと、x と y の値をファイルに書き出す直前に、 以下の「 丸め処理 」の行が新たに追記されています：

もしこの部分が無いとどうなるかというと、出力ファイルに書き出す x と y の値に、 以下のように非常に小さな（ ...000001 のような ）誤差が入ってしまいます：

- file.csv （上記の丸め処理の行が無い場合） -

なぜこのような誤差が出るのかは、小数点の付いたfloat/double型の数値（浮動小数点数）を、コンピューター内部で、有限桁数の2進数で扱っている事に関係しています。

例えば、私たちが10進数で小数点付きの数値を記述しようとした際、1/2 の値なら 0.5 と綺麗に書けますが、1/3 の値は 0.33333... と永遠に続いてしまいますね。 イメージ的にはこれと似たような事が起こって、10進数では 0.1 という数値は綺麗に書けますが、実は2進数だと無限に続く数値になってしまったりします。 でも、コンピューター内部では、無限に続く数値は扱えないので、それなりの長さで打ち切って扱います。すると、その打ち切った部分が小さな誤差になってしまうのです。

このような数値は 0.1 以外にも実はたくさんあって、さらに他の種類の誤差もあります。 つまり基本的には、「 float/double型の数値には小さい誤差がかかってくるもの 」と思っておくのが無難です。

幸い、この種の誤差は、大抵の場合はかなり（誤差でない部分と比べて相対的に）小さいので、 数値の適当な桁数以降の部分を切り捨てたり、四捨五入したりすれば、それで済む事が多いです （もちろん、誤差がどの程度かまでを厳密に把握しないといけない専門的な計算などでは、より深い注意が必要です）。

そういった、目的の桁数からはみ出る端数をどうこうするのが丸め処理です。 先ほども見た以下のコードでは、まさにその丸め処理を行っています：

内容はコメントの通りです。 さて、この丸め処理が入る事によって、直後の x と y の値は、ファイルに書き出されている通り：

- file.csv -

このように綺麗になっています。 なお、今回の丸め処理の効果は、このようにデータを記載したファイルが読みやすくなるだけで、 そもそもが誤差自体が非常に小さいため、グラフにはほとんど影響しません。 ただ、計算がうまくできているかを確認するために、数値ファイルの内容を目視で読む事は恐らくよくあるため、その際に役立ちます。

コード内容は以上です。

ライセンス

このVCSSL/Vnanoコード（ 拡張子が「.vcssl」や「.vnano」のファイル ）は実質的な著作権フリー（パブリックドメイン) である CC0 の状態で公開しています※。 記事中にC言語/C++/Java言語などでのサンプルコードが掲載されいてる場合は、それらについても同様です。 そのままでのご利用はもちろん、改造や流用などもご自由に行ってください。

※ ただし、このコードの配布フォルダ内には、ダウンロード後すぐに実行できるように、 VCSSLの実行環境も同梱されており、そのライセンス文書は「 License 」フォルダ内に同梱されています （要約すると、商用・非商用問わず自由に使用できますが、使用の結果に対して開発元は一切の責任を負いません、といった具合の内容です）。 配布フォルダ内の各構成物の一覧やライセンスについては「 ReadMe_使用方法_必ずお読みください.txt 」をご参照ください。

※ Vnano の実行環境については、別途スクリプトエンジンのソースコードも一般公開しており、 何らかのソフトウェア内に組み込んでご利用いただく事も可能です。詳細はこちらをご参照ください。

この記事中の商標などについて

• OracleとJavaは、Oracle Corporation 及びその子会社、関連会社の米国及びその他の国における登録商標です。文中の社名、商品名等は各社の商標または登録商標である場合があります。
• Windows は、米国 Microsoft Corporation の米国およびその他の国における登録商標です。この記事は独立著作物であり、Microsoft Corporation と関連のある、もしくはスポンサーを受けるものではありません。
• Linux は、Linus Torvalds 氏の米国およびその他の国における商標または登録商標です。
• その他、文中に使用されている商標は、その商標を保持する各社の各国における商標または登録商標です。