< previous
XML/SWF Charts Reference*1
next >
7.chart_data グラフデータを定義する

<chart_data>
  [data]
</chart_data>

(説明)

グラフデータを定義します。 グラフを生成するために、このようなテーブルにデータを作ることから始めます。
グラフデータ
  2001 2002 2003 2004
東京 75 10 30 63
大阪 100 20 65 55
札幌 56 21 20 90

それから、このようにテーブルからXML要素に変換します。
XML
<chart> <!--chartタグで全体を挟みます。ベースタグ。-->

   <chart_data> <!--chart_dataタグは、グラフのデータを定義します。-->
      <row>  <!--rowタグは、カテゴリータイトル、凡例タイトルおよびデータ値の定義の開始です。1行目始め-->
         <null/> <!--nul/タグは、NULLを定義します。カテゴリー軸ラベルを順に並べて定義を意味します。1行1列目 -->
         <string>2001</string> <!--stringタグは、タイトルを定義します。カテゴリー軸ラベルを定義します。1行2列目 -->
         <string>2002</string> <!--stringタグは、タイトルを定義します。カテゴリー軸ラベルを定義します。1行3列目 -->
         <string>2003</string> <!--stringタグは、タイトルを定義します。カテゴリー軸ラベルを定義します。1行4列目 -->
         <string>2004</string> <!--stringタグは、タイトルを定義します。カテゴリー軸ラベルを定義します。1行5列目 --> 
      </row> <!--/rowタグは、カテゴリータイトル、凡例タイトルおよびデータ値の定義の終了です。1行目終わり-->
      <row> <!--rowタグは、カテゴリータイトル、凡例タイトルおよびデータ値の定義の開始です。2行目始め-->
         <string>東京</string> <!--stringタグは、タイトルを定義します。はじめに、凡例タイトルを定義します。2行1列目 -->
         <number>75</number> <!--numberタグは、グラフデータの値を順に定義します。2行2列目-->
         <number>10</number> <!--numberタグは、グラフデータの値を順に定義します。2行3列目-->
         <number>30</number> <!--numberタグは、グラフデータの値を順に定義します。2行4列目-->
         <number>63</number> <!--numberタグは、グラフデータの値を順に定義します。2行5列目-->
      </row> <!--/rowタグは、カテゴリータイトル、凡例タイトルおよびデータ値の定義の終了です。2行目終わり-->
      <row>                             <!--以下同様。3行目-->
         <string>大阪</string>
         <number>100</number>
         <number>20</number>
         <number>65</number>
         <number>55</number>
      </row>
      <row>                           <!--以下同様。4行目-->
         <string>札幌</string>
         <number>56</number>
         <number>21</number>
         <number>20</number>
         <number>90</number>
      </row>
   </chart_data> <!--/chart_dataタグは、グラフのデータを定義の終了です。-->

</chart> <!--chartタグで全体を挟みます。ベースタグ。-->

(注記)
  • XML要素の記述は、正確にテーブルの行・列(セル)に真似て定義します。
  • たとえ、左上セルが空であるとしても、それは一貫性して、ヌルとしてXMLコードに定義します。
  • 全ての行と列タイトルは、文字列(string)です。全てのテーブルの値(データ)は、数値(number)です。
      また、空白はnull(<null/>)です。

1組の列のデータは、カテゴリーとしての行のデータと対応します。

訳者・注記;chart_datタグ行内にコメント(<!--コメント-->)を入れると、グラフが描画されないことがある)

円グラフデータ(pie data)
グラフデータ
  2001 2002 2003 2004
東京 75 10 30 63

XML
<chart>
  <chart_type>pie</chart_type><!--円グラフ-->

   <chart_data> 
      <row>  
         <null/> 
         <string>2001年</string> 
         <string>2002年</string> 
         <string>2003年</string> 
         <string>2004年</string> 
      </row>
      <row>
         <string>東京</string>
         <number>75</number>
         <number>10</number>
         <number>30</number> 
         <number>63</number>
      </row> 
   </chart_data> 

</chart>
XML全コード ex-pie.xml 

円グラフサンプル(pie)


3D 縦棒グラフデータ(3D Column Data)

3D 縦棒グラフ(3D Column)、積み上げ3D 縦棒グラフ(Stacked 3D Column)および並列縦棒グラフ(Parallel 3D Column)では、
すべてのデータは、正でなければなりません。

3D 縦棒グラフサンプル(3D Column)
XML全コード ex-3d-column.xml 


浮遊縦棒グラフデータ(Floating Column Data)

浮遊縦棒グラフ(floating column)および浮遊横棒グラフ(floating bar)は、その柱や棒(縦棒・横棒)が0値線上に固定されれます。
それぞれの縦棒・横棒は、2つの値を持っています。低い値は縦棒・横棒の始まりです。 高い値は縦棒・横棒の終わりです。

グラフデータ(四季の最高・最低気温)
  spring summer fall winter
最高気温 19 34 29 10
最低気温 5 18 12 2

XML
<chart>
  <chart_type>floating column</chart_type><!--浮遊縦棒グラフ-->

   <chart_data> 
      <row> 
         <null/>
         <string>spring</string> 
         <string>summer</string> 
         <string>fall</string> 
         <string>winter</string>
      </row> 
      <row> 
         <string>最高気温</string> 
         <number>19</number>
         <number>35</number> 
         <number>29</number>
         <number>10</number>
      </row> 
      <row> 
         <string>最低気温</string>
         <number>5</number> 
         <number>18</number>
         <number>12</number>
         <number>2</number>
      </row> 

   </chart_data> 

</chart> 
XML全コード sample_bar-floating.xml 

浮遊縦棒グラフサンプル(Floating Column)

ストックグラフデータ(Candlestick Data)

ストックグラフは、それぞれのローソクは、価格変動を時間で表すものです。
最初は、"open"の値段で始まり、最後は、"close"の値段で終わります。
最高値と最低値は、それぞれ"max"、"mini"です。(参照;chart_prefタグ)

ストックグラフは、max, min, open, closeの順に4つの列の値を持つ必要があります。

ストックグラフデータ
  MON TUE WED THU FRI
max(高値) 4 5 6 8 10
min(安値) 1 1 3 .5 2
open(始め値) 3 4.5 5 6 5
close(終り値) 3.5 2 4 7 8

XML
<chart>
  <chart_type>candlestick</chart_type><!--ストックグラフ-->

<chart_data>
  <row>
	 <null/>
	 <string>mon</string>
	 <string>tue</string>
	 <string>wed</string>
	 <string>thu</string>
	 <string>fri</string>
  </row>
  <row>
	 <string>max</string>
	 <number>4</number>
	 <number>5</number>
	 <number>6</number>
	 <number>8</number>
	 <number>10</number>
  </row>
  <row>
	 <string>min</string>
	 <number>1</number>
	 <number>1</number>
	 <number>3</number>
	 <number>.5</number>
	 <number>2</number>
  </row>
  <row>
	 <string>open</string>
	 <number>3</number>
	 <number>4.5</number>
	 <number>5</number>
	 <number>6</number>
	 <number>5</number>
  </row>
  <row>
	 <string>close</string>
	 <number>3.5</number>
	 <number>2</number>
	 <number>4</number>
	 <number>7</number>
	 <number>8</number>
  </row>
</chart_data> 

</chart> 
XML全コード ex-candle.xml 

ストックグラフサンプル(candlestick)

散布グラフデータ(Scatter Data)

散布グラは、カテゴリー軸が、まさしくデータ軸のように評価されます。
散布グラは、データポイントとしてx値とy値が1組として要求されます。
xはポイントの水平な位置を表します。yはポイントの垂直な位置を表します。 このような行の組でxとy値を組まねばなりません。

散布グラフデータ
  x
y
x
y
x
y
x
y
x
y
川崎
.5
5
2
8
3
7
1.5
6.5
2.5
2.5
横浜
1
1
3
5
2
7
3.7
10.5
3.5
2.5

XML
<chart>
  <chart_type>scatter</chart_type><!--散布グラフ-->

<chart_data>
  <row>
	 <null/>
	 <string>x</string>
	 <string>y</string>
	 <string>x</string>
	 <string>y</string>
	 <string>x</string>
	 <string>y</string>
	 <string>x</string>
	 <string>y</string>
	 <string>x</string>
	 <string>y</string>
  </row>
  <row>
	 <string>川崎</string>
	 <number>.5</number>
	 <number>5</number>
	 <number>2</number>
	 <number>8</number>
	 <number>3</number>
	 <number>7</number>
	 <number>1.5</number>
	 <number>6.5</number>
	 <number>2.5</number>
	 <number>2.5</number>
  </row>
  <row>
	 <string>横浜</string>
	 <number>1</number>
	 <number>1</number>
	 <number>3</number>
	 <number>5</number>
	 <number>2</number>
	 <number>7</number>
	 <number>3.7</number>
	 <number>10.5</number>
	 <number>3.5</number>
	 <number>2.5</number>
  </row>
</chart_data> 

</chart> 
XML全コード ex-scatter.xml 

散布グラフサンプル(scatter)

欠測データ(Missing Data)

欠けているグラフの値はヌル(null)によって表されます。ヌル値は、グラフの中で表示しません。

(例)
XML
<chart>

   <chart_type>line</chart_type>

   <chart_data>
      <row>
         <null/>
         <string>2001</string>
         <string>2002</string>
         <string>2003</string>
         <string>2004</string>
      </row>
      <row>
         <string>横浜</string>
         <number>5</number>
         <number>10</number>
         <number>30</number>
         <null/> <!--欠側データサンプル(Missing Data)-->
      </row>
   </chart_data>

</chart>
XML全コード ex-missingdata.xml 

欠側データサンプル(Missing Data)

複数行ラベル(Multi-line Labels)

カテゴリーや凡例において、複数行ラベルを作成するには、\r記号を使用します。

(例)
XML
<chart>

   <chart_data>
      <row>
         <null/>
         <string>Year\r2001</string> <!--カテゴリー 複数行ラベル(Multi-line Labels)-->
         <string>2002</string>
         <string>2003</string>
         <string>2004</string>
      </row>
      <row>
         <string>東京都\r港区</string> <!--凡例 複数行ラベル(Multi-line Labels)-->
         <number>5</number>
         <number>10</number>
         <number>30</number>
         <number>63</number>
      </row>
      <row>
         <string>渋谷区</string>
         <number>100</number>
         <number>20</number>
         <number>65</number>
         <number>55</number>
      </row>
   </chart_data>

</chart>
XML全コード ex-multiline.xml 

複数行ラベルサンプル(scatter)


< previous このページのTOP next >

*1 XML/SWF Charts Reference原本の著作権は、http://www.maani.usが所有しています

2006.12.8  by ma3ki