funhist-クラウドでのオンライン

プログラム：

NAME

funhist-列の1Dヒストグラムを作成します（FITSバイナリテーブルまたは生のイベントファイルから）
または画像

SYNOPSIS

ファンヒスト [-n⎪-w⎪-T] [列][[lo：hi：] bins]

OPTIONS

-n＃各ビンの幅でビン値を正規化します
-w＃arg3のビン数の代わりにビン幅を指定します
-T＃rdb / starbase形式で出力（タブ区切り文字）

DESCRIPTION

ファンヒスト FITS拡張機能の指定された列からXNUMX次元ヒストグラムを作成します
FITSファイル（または非FITS生イベントファイル）のバイナリテーブル、またはFITSイメージまたは
配列を作成し、そのヒストグラムをASCIIテーブルとして書き込みます。 または、プログラムで実行できます
画像軸の1つのXNUMXD投影。

プログラムの最初の引数は必須であり、Funtoolsファイルを指定します：FITSテーブル
または画像、生のイベントファイル、または配列。 「stdin」が指定されている場合、データは
標準入力。 Funtools Bracket Notationを使用して、FITS拡張機能とフィルターを指定します。

テーブルの場合、XNUMX番目の引数も必要です。 使用する列を指定します
ヒストグラムを生成します。 データファイルのタイプがimage（またはarray）の場合、列は次のようになります。
オプション：「x」（または「X」）、「y」（または「Y」）が指定されている場合、投影は実行されます。
それぞれx（dim1）軸またはy（dim2）軸。 （つまり、この予測では同じ結果が得られます
同等のx、yイベント行を含むテーブルで実行されたヒストグラムとして結果が得られます。）
列名が指定されていないか、画像に「xy」（または「XY」）が指定されている場合は、ヒストグラム
画像ピクセルに含まれる値に対して実行されます。

次の引数はオプションであり、作成に使用するビンの数を指定します
ヒストグラムと、必要に応じてビン値の範囲。 画像と表のヒストグラムの場合、
範囲は、最小および最大データ値を指定する必要があります。 xとyの画像ヒストグラムの場合
軸の場合、範囲は最小および最大の画像ビン値を指定する必要があります。 この引数が
省略した場合、テーブルの出力ビンの数は、TLMIN/TLMAXのいずれかから計算されます。
ヘッダー値（指定された列のテーブルFITSヘッダーに存在する場合）または
データを調べて、最小値と最大値を計算します。 画像の場合、
出力ビンは、DATAMIN / DATAMAXヘッダー値から、または次のようにして計算されます。
データを介して最小値と最大値を計算します。 （この後者の計算は
画像がメモリに収まらない場合は失敗します。）データが浮動小数点（テーブルまたは
image）で、ビンの数が指定されていない場合、任意のデフォルトの128が使用されます。

バイナリテーブル処理の場合、 -w （ビン幅）スイッチを使用して、の幅を指定できます
ビンの数ではなく、各ビン。 したがって：

funhist test.ev pha 1：100：5

ヒストグラムでは幅5の20つのビンが使用され、次のことを意味します。

funhist -w test.ev pha 1：100：5

幅20の5個のビンがヒストグラムで使用されることを意味します。

データは、指定された数のビンと結果の1Dヒストグラムに分割されます
（またはプロジェクション）はASCIIテーブル形式で出力されます。 テーブルの場合、出力には
データのlow_edge（包括的）およびhi_edge（排他的）値。 たとえば、15行
-7.5から7.5の範囲の値を持つ「pha」列を含むテーブルは次のように処理できます。

[sh] funhist test.ev pha
＃データファイル：/home/eric/data/test.ev
＃列：pha
＃最小、最大、ビン：-7.5 7.5 15

ビン値lo_edgehi_edge
------ --------- --------------------- -------------- -------
1 -22-7.50000000
2 -21-6.50000000
3 -20-5.50000000
4 -19-4.50000000
5 -18-3.50000000
6 -17-2.50000000
7 -16-1.50000000
8 -30
9 16 0.50000000 1.50000000
10 17 1.50000000 2.50000000
11 18 2.50000000 3.50000000
12 19 3.50000000 4.50000000
13 20 4.50000000 5.50000000
14 21 5.50000000 6.50000000
15 22 6.50000000 7.50000000

[sh] funhist test.ev pha 1：6
＃データファイル：/home/eric/data/test.ev
＃列：pha
＃最小、最大、ビン：0.5 6.5 6

ビン値lo_edgehi_edge
------ --------- --------------------- -------------- -------
1 16 0.50000000 1.50000000
2 17 1.50000000 2.50000000
3 18 2.50000000 3.50000000
4 19 3.50000000 4.50000000
5 20 4.50000000 5.50000000
6 21 5.50000000 6.50000000

[sh] funhist test.ev pha 1：6：3
＃データファイル：/home/eric/data/test.ev
＃列：pha
＃最小、最大、ビン：0.5 6.5 3

ビン値lo_edgehi_edge
------ --------- --------------------- -------------- -------
1 33 0.50000000 2.50000000
2 37 2.50000000 4.50000000
3 41 4.50000000 6.50000000

テーブルヒストグラムの場合、 -n（正規化）スイッチを使用して、ビンの値を正規化できます。
ビンの幅（つまり、hi_edge-lo_edge）：

[sh] funhist -n test.ev pha 1：6：3
＃データファイル：test.ev
＃列：pha
＃最小、最大、ビン：0.5 6.5 3
＃幅の正規化（val /（hi_edge-lo_edge））が適用されます

ビン値lo_edgehi_edge
------ --------------------- ----------------------- -------------------
1 16.50000000 0.50000000 2.50000000
2 6.16666667 2.50000000 4.50000000
3 4.10000000 4.50000000 6.50000000

これは、たとえば、次の単位を持つ値を持つ光度曲線を生成するために使用できます。
カウントの代わりにカウント/秒。

画像ヒストグラムの場合、出力には低い画像値と高い画像値（両方を含む）が表示されます
ヒストグラムの生成に使用されます。 たとえば、次の例では、184ピクセルに
値1、31の値は2でしたが、値が2、3,4,5,6、7、またはXNUMXの場合はXNUMXつだけでした。

[sh] funhist test.fits
＃データファイル：/home/eric/data/test.fits
＃最小、最大、ビン：1 7 7

ビン値lo_valhi_val
------ --------------------- ----------------------- -------------------
1 184.00000000 1.00000000 1.00000000
2 31.00000000 2.00000000 2.00000000
3 2.00000000 3.00000000 3.00000000
4 2.00000000 4.00000000 4.00000000
5 2.00000000 5.00000000 5.00000000
6 2.00000000 6.00000000 6.00000000
7 2.00000000 7.00000000 7.00000000

画像の軸投影の場合、出力には低画像ビンと高画像ビン（両方）が表示されます
包括的）投影を生成するために使用されます。 たとえば、次の例では、21
カウントのXビン値は2などです。

[sh] funhist test.fits x 2：7
＃データファイル：/home/eric/data/test.fits
＃列：X
＃最小、最大、ビン：2 7 6

ビン値lo_binhi_bin
------ --------------------- ----------------------- -------------------
1 21.00000000 2.00000000 2.00000000
2 20.00000000 3.00000000 3.00000000
3 19.00000000 4.00000000 4.00000000
4 18.00000000 5.00000000 5.00000000
5 17.00000000 6.00000000 6.00000000
6 16.00000000 7.00000000 7.00000000

[sh] funhist test.fits x 2：7：2
＃データファイル：/home/eric/data/test.fits
＃列：X
＃最小、最大、ビン：2 7 2

ビン値lo_binhi_bin
------ --------------------- ----------------------- -------------------
1 60.00000000 2.00000000 4.00000000
2 51.00000000 5.00000000 7.00000000

gnuplotまたは他のプロットプログラムを使用して、次のようなスクリプトを使用して結果をグラフ化できます。
を次のように定義しています：

#!/bin/sh
sed -e '1、/----。*/ d
/ ^ $ /、$d'⎪\
awk'\
BEGIN {print "set nokey; set title \" funhist \ "; set xlabel \" bin \ "; set ylabel \" counts \ "; plot \"-\" with box"} \
{$ 3、$ 2、$ 4-$3}を印刷'⎪\
gnuplot -persist-1> / dev / null 2>＆1

同様のプロットコマンドがスクリプトで提供されています funhist.プロット:

funhist test.evpha...⎪funhist.plotgnuplot

onworks.netサービスを使用してfunhistをオンラインで使用する