# XYチャート
## 描画タイプ
XYチャートでは、以下の描画タイプと、それらを組み合わせた複合チャートを作成できます。
| 折れ線
| 棒
| 積み上げ棒
|
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 面
| 積み上げ面
| 100%積み上げ棒
|
| 散布図
| バブル
| 100%積み上げ面
|
## 仕様
### 集計の仕様
XYチャートでは、[X軸がディメンション、Y軸がメトリクス](https://docs.codatum.jp/data-exploration/chart-common#dimension-metric)となり、X軸ごとに集計されたY軸の値が系列として描画されます。（[XYZチャート](https://docs.codatum.jp/data-exploration/chart/xyz-chart)では、X軸とY軸がディメンション、Z軸がメトリクスとなり、X軸とY軸の組み合わせごとにZ軸の値が集計される点が異なります）
| 項目 | 役割 | 補足 |
| ------ | ------- | -------------- |
| X軸 | ディメンション | 集計の単位（Xごとに集計） |
| Y軸 | メトリクス | メトリクスごとに系列が増える |
| グループ化 | ディメンション | 値ごとに系列が分割される |
| バブルサイズ | メトリクス | バブル描画時のみ指定 |
#### 使用例
* 「月別の売上合計」を折れ線で表示
* X軸（ディメンション）: 月
* Y軸（メトリクス）: 売上の合計値
* 「商品カテゴリごとの売上合計」を棒グラフで表示
* X軸（ディメンション）: 商品カテゴリ
* Y軸（メトリクス）: 売上の合計値
### X軸の仕様
XYチャートでは、**X軸のデータ型**と**描画タイプの構成**でX軸の種類が決まります。
| X軸のデータ型 | 描画タイプの構成 | X軸の分類 |
| ------- | ------------- | ----- |
| 日付・日時型 | すべて | 日時軸 |
| 数値型 | 散布図・バブル・折れ線のみ | 数値軸 |
| 数値型 | 棒・面・積み上げを含む | カテゴリ軸 |
| 上記以外 | すべて | カテゴリ軸 |
#### カテゴリ軸
カテゴリ軸では、指定された値が数値型や日付・日時型であっても、離散的な値として等間隔に描画されます。
**軸の上限や下限の指定**
カテゴリ軸で軸の上限や下限を指定した場合、指定された値はデータの並び順のインデックス（0番目、1番目、2番目...）として扱われます。
| インデックス | X軸の値 |
| ------ | ----- |
| 0番目 | `1` |
| 1番目 | `10` |
| 2番目 | `20` |
| 3番目 | `30` |
| ... | ... |
| 10番目 | `100` |
この場合、軸の上限を `10` に設定すると、10番目のデータまで表示されるため、X軸の値が `100` まで表示されます。
#### 日時軸
日時軸では、指定された日付・日時型のデータが連続的な時系列として描画されます。
* 軸のラベルは、指定された日付・日時のデータを元に動的に決定されます
* タイムゾーン付きの日時型のデータを指定した場合、ブラウザで指定されたタイムゾーンに変換して描画されます
* 軸のラベルはブラウザで指定されたタイムゾーンに基づいて表示されるため、ブラウザ側のタイムゾーンとデータのタイムゾーンが一致しない場合、軸ラベルとデータラベルがズレて描画されます
* タイムゾーンの無い日時型に変換することで、ブラウザ側のタイムゾーンの影響を受けないようにすることも可能です
#### 数値軸
数値軸では、指定された数値型のデータが連続的な数値として描画されます。
## Tips
### 系列の複数指定
複数の系列を設定すると、系列の設定内に「系列独自のY軸を設定」という項目が表示されます。この項目をオンにすると、対象の系列のY軸スケールが独立し、右側に描画されます。
独立したY軸のラベル等の設定は、「詳細設定」＞「独立軸」で行えます。
| 
|
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
複数の系列を設定すると、「系列ごとに分割表示」という項目が、「系列」の設定項目の下に表示されます。この項目をオンにすると、各系列のY軸スケールが独立し、系列ごとに縦に並べて描画されます。
「系列ごとに分割表示」を有効にすると[フレーム機能](#frame-feature)は無効化されます。また、上記の「系列独自のY軸を設定」の項目が非表示になり、すべての系列が独立軸として扱われます。 系列ごとのY軸の設定は、「詳細設定」＞「独立軸」で行えます。
| 
|
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
### フレーム機能
XYチャートはフレーム機能に対応しています。詳細は[フレーム機能](https://docs.codatum.jp/data-exploration/chart-common#frame-feature)を参照ください。
### 基準線
XYチャートおよびXYZチャートでは、X軸とY軸に基準線を追加できます。目標値や許容範囲、危険ゾーンなど、チャートに目安となるラインや領域を表示することで、データの評価を視覚的に支援します。\
Y軸の基準線は横向き、X軸の基準線は縦向きに表示されます。
| 
|
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
* 設定方法
* チャート編集画面「詳細設定」において、基準線を表示したい軸を選択し「基準線」＞「追加」を押下。表示したい基準線のタイプと値を入力します。
* できること
* ライン：特定の値に破線を表示（例：売上目標、閾値、特定日付のマーカー）
* バンド（範囲）：特定の範囲を半透明の帯で表示（例：許容範囲、危険ゾーン、注意期間）
* 色・ラベル設定：成功（緑）、警告（黄）、危険（赤）から色を選択し、必要に応じてラベルを付与
### トレンド
XYチャートおよびXYZチャートでは、系列のトレンドライン（回帰直線や移動平均など）を表示できます。トレンドラインは元の系列とは別の系列として追加され、データの傾向を視覚的に把握するのに役立ちます。
| 
|
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
* 設定方法
* チャート編集画面「詳細設定」において「系列」＞「トレンド」＞「表示」を押下、表示したいトレンドの種類を選択。
* トレンドラインは破線で表示され、移動平均以外のトレンドタイプでは方程式とR²（決定係数）がチャート上に表示されます。（決定係数は非表示にできます）
#### トレンドタイプ
| トレンドタイプ | 説明 | 追加設定 |
| ------- | ----------------------------- | ----------- |
| 線形 | 線形回帰（y = mx + c）を表示します | なし |
| 多項式 | 多項式回帰を表示します | 次数を2〜5で指定 |
| 移動平均 | 移動平均を表示します | ウィンドウサイズを指定 |
| 指数 | 指数関数回帰（y = ae^(bx)）を表示します | なし |
| 対数 | 対数関数回帰（y = a + b ln(x)）を表示します | なし |
| 累乗 | 累乗関数回帰（y = ax^b）を表示します | なし |
※データ件数が少ない場合や、指定したトレンドタイプの適用に失敗した場合は表示されません
### 統計
XYチャートおよびXYZチャートでは、系列の統計値（平均値、中央値、最大値、最小値）を破線で表示することができます。
| 
|
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
* 設定方法
* チャート編集画面「詳細設定」において「系列」＞「統計」＞「表示」を押下、表示したい統計値を選択。
* 破線には統計タイプとその値がラベルとして表示されます。
#### トレンドとの違い
| 特徴 | 統計 | トレンド |
| ----------- | ------------------- | ------------------ |
| 表示形式 | 同じ系列として表示 | 別の系列（トレンドライン）として追加 |
| チャートのズーム時 | 表示されている範囲のデータのみで再計算 | 再計算されない（常に全データ基準） |
| 積み上げグラフでの表示 | 積み上げっぽい差動になる | 積み上げにならない |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.codatum.jp/data-exploration/chart/xy-chart.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
