csvPlot

Microsoft Excel を使用して CSV ファイルからグラフをプロットするコマンドラインスクリプト。

免責事項

このプロジェクトはもともと Antoine によって書かれました。このリポジトリは、彼が作成したオリジナルプロジェクトの単なるフォークです。私は彼を個人的に知りません。この作品が気に入ったのですが、（私の知る限りでは）まだ github になかったので、ここにリポジトリを作成しました。以下、原作者による解説です。コメントや提案がある場合は、作成者のサイトにアクセスし、問題を報告したり改善をリクエストしたりするには、ここで問題をオープンしてください。

目的

幅広いプログラミング言語を使用してソフトウェアのプロトタイピングを行っています。時間の経過とともに変化するデータを生成する必要があることがよくありますが、そのデータは主にグリッド形式で表示されます。ただし、これは、データをグラフにプロットすることと比較して、データが時間の経過とともにどのように変化するかを理解するための最良の方法ではありません。

私が知っているプログラミング言語のほとんどは、データをグラフにプロットするためのネイティブライブラリを提供していません。それは簡単な仕事ではありません。ほとんどのプログラミング言語では、プロセスの実装に外部ライブラリが必要になることが多く、各ライブラリは同じように動作しません。

Excel は、カンマ区切り値 (CSV) ファイルを解析するためのネイティブプラットフォームであり、結果を画像にプロットするようにスクリプト化できます。

このスクリプトの目的は、生データを CSV ファイルに保存し、Excel の機能を使用して結果を画像にプロットすることで、データを生成する任意のプログラミング言語でデータを画像にプロットできるようにすることです。

特徴

次のセクションでは、 csvPlotスクリプトの機能をリストします。

ロスレス PNG 画像形式をサポートします。
あらゆるアプリケーションおよびプログラミング言語でサポートされる汎用のテキストファイル形式である CSV データファイル形式をサポートします。
このスクリプトは、事実上無制限の数の時系列プロットをサポートします。
グラフの適切な境界を自動的に検出します

制限事項

スクリプトには、ここで説明するいくつかの制限があります。

出力画像:

出力画像の解像度は、コマンドラインで要求された解像度と +-1 ピクセル異なる場合があります。これは、Excel が実際のピクセルではなく「ポイント」を基本単位として使用するため、画像の寸法を処理する方法の制限です。ピクセルからポイントへの変換を計算する必要がありますが、これには小さな精度誤差が含まれる可能性があります。

サポートされている画像形式は PNG のみです。 Excel が実際にグラフのエクスポートに JPG をサポートしているかどうかはまだ不明ですが、PNG は可逆圧縮形式であるため、最適な候補と思われます。

コラムタイトル:

各列の最初の行には、グラフ内でプロットされた系列の名前として使用される列のタイトルが含まれることが期待されます。

使用法

スクリプトを起動するコマンドは以下の通りです。スクリプトは、少なくとも 6 つのコマンドライン引数を使用して呼び出す必要があります。

名前	説明
入力ファイル	入力CSVファイルのパス
出力ファイル	出力PNG画像のパス
幅	出力画像の幅 (ピクセル単位)
身長	出力画像の高さ (ピクセル単位)
シリーズ #1、X 列	最初のシリーズの X 列インデックス
シリーズ #1、Y 列	最初のシリーズの Y 列インデックス
シリーズ #2、X 列	2 番目のシリーズの X 列インデックス
シリーズ #2、Y 列	2 番目のシリーズの Y 列インデックス
シリーズ #n、X 列	...
シリーズ #n、Y 列	...

列インデックスは 0 からではなく 1 から始まることに注意してください。これは、列 A が列 0 ではなく列 1 であることを意味します。

実行 (コマンドライン):

スクリプトは VBScript で書かれています。バッチファイル (*.bat) からスクリプトを実行するには、次のコマンドを使用します。

csvPlot.vbs" pathtodemo.csv pathtodemo.png 800 600 1 2 pause">

 @echo off
cscript //nologo "%~dp0 csvPlot .vbs" pathtodemo.csv pathtodemo.png 800 600 1 2
pause

出力：

csvPlotdemo C:Temp csvPlot demo>cscript //Nologo csvPlot .vbs %cd%CarEngineModel.csv %cd%CarEngineModel.png 853 479 1 3 1 4 1 2 Loading input file C:Temp csvPlot demoCarEngineModel.csv... File load successful. File has 4 columns. Plotting series of columns 1 and 3... Plotting series of columns 1 and 4... Plotting series of columns 1 and 2... File C:Temp csvPlot demoCarEngineModel.png saved successfully. C:Temp csvPlot demo>">

 Microsoft Windows [Version 6.1.7601]
Copyright (c) 2009 Microsoft Corporation.  All rights reserved.
 
C:>cd /d C:Temp csvPlot demo
 
C:Temp csvPlot demo>cscript //Nologo csvPlot .vbs %cd%CarEngineModel.csv %cd%CarEngineModel.png 853 479 1 3 1 4 1 2 Loading input file C:Temp csvPlot demoCarEngineModel.csv...
File load successful.
File has 4 columns.
Plotting series of columns 1 and 3...
Plotting series of columns 1 and 4...
Plotting series of columns 1 and 2...
File C:Temp csvPlot demoCarEngineModel.png saved successfully.
 
C:Temp csvPlot demo>