Chart
Chart — Aspose.Cells FOSS for Python API Reference
aspose-cells-foss はワークシートへのチャート埋め込みをサポートしています。チャートは以下を通じて管理されます ws.charts,、 ChartCollection 各に添付される Worksheet.シリーズ データは以下を通じて追加されます chart.n_series,1つの NSeries コレクションです。.
SaveOptions: aspose.cells_foss
from aspose.cells_foss import ChartTypeChartType
ChartType は IntEnum チャートタイプを識別するものです。.
| SaveOptions | SaveOptions | SaveOptions |
|---|---|---|
LINE | 0 | 保存に完全に対応しています。. |
BAR | 1 | 保存に完全に対応しています。. |
PIE | 2 | 保存に完全に対応しています。. |
AREA | 3 | 保存に完全に対応しています。. |
BOX_WHISKER | 4 | chartEx 形式で保存されました。. |
WATERFALL | 5 | chartEx 形式で保存されました。. |
COMBO | 6 | SaveOptions NotImplementedError 保存時に。. |
SCATTER | 7 | SaveOptions NotImplementedError 保存時に。. |
STOCK | 8 | 保存に完全に対応しています。. |
SURFACE | 9 | SaveOptions NotImplementedError 保存時に。. |
RADAR | 10 | SaveOptions NotImplementedError 保存時に。. |
TREEMAP | 11 | SaveOptions NotImplementedError 保存時に。. |
SUNBURST | 12 | SaveOptions NotImplementedError 保存時に。. |
HISTOGRAM | 13 | SaveOptions NotImplementedError 保存時に。. |
FUNNEL | 14 | SaveOptions NotImplementedError 保存時に。. |
MAP | 15 | SaveOptions NotImplementedError 保存時に。. |
SaveOptions
Chart オブジェクトは直接構築されません。使用 ws.charts.add(...) または型指定された便利メソッド（add_bar(), add_line(), add_pie(), add_area()).
SaveOptions
| SaveOptions | SaveOptions | SaveOptions | SaveOptions |
|---|---|---|---|
type | ChartType | SaveOptions | 作成時に設定されたチャートタイプ。. |
title | `str | None` | 読み取り/書き込み |
category_data | `str | None` | 読み取り/書き込み |
n_series | NSeries | SaveOptions | データ系列のコレクション。. |
show_legend | bool | 読み取り/書き込み | True (デフォルト) チャートの凡例を表示します。. |
legend_position | str | 読み取り/書き込み | 凡例の配置: 'right', 'left', 'top', 'bottom', 'top_right' (短縮形も受け付けます 'r', 'l', 't', 'b', 'tr'). |
smooth | bool | 読み取り/書き込み | True ラインチャートで滑らかな（スプライン）線を使用します。. |
grouping | str | 読み取り/書き込み | シリーズのグループ化: 'standard', 'stacked', 'percentStacked', 'clustered'. |
bar_direction | str | 読み取り/書き込み | SaveOptions BAR チャート: 'bar' (横方向) または 'col' (縦方向/列)。. |
gap_width | int | Read/Write | 棒/列 クラスタ間の間隔、0–500（デフォルト 150）。. |
overlap | int | Read/Write | シリーズの重なり率、-100〜100（デフォルト 0）。. |
vary_colors | bool | Read/Write | True 各データポイントに固有の色を割り当てるために。. |
first_slice_angle | int | Read/Write | 最初の円グラフスライスの開始角度、0〜360 度。. |
is_3d | bool | Read/Write | True 3Dレンダリングを有効にするために。. |
view_3d | ChartView3D | SaveOptions | 3D rotation and perspective settings. |
axes | list[ChartAxis] | SaveOptions | チャート軸のリスト。. |
upper_left_row | int | SaveOptions | 0-based row index of the chart’s top-left anchor cell. |
upper_left_column | int | SaveOptions | 0-based column index of the chart’s top-left anchor cell. |
lower_right_row | int | SaveOptions | 0-based row index of the chart’s bottom-right anchor cell. |
lower_right_column | int | SaveOptions | 0-based column index of the chart’s bottom-right anchor cell. |
ChartCollection
ChartCollection は次のようにアクセスされます ws.charts.。ワークシートに埋め込まれたすべてのチャートが含まれています。.
SaveOptions
add
ws.charts.add(
chart_type: ChartType,
upper_left_row: int,
upper_left_column: int,
lower_right_row: int,
lower_right_column: int
) -> Chart指定されたタイプのチャートを追加します。すべての位置引数は 0 ベースの行/列インデックスです。.
add_bar
ws.charts.add_bar(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chartショートカットは add(ChartType.BAR, ...).
add_line
ws.charts.add_line(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chartショートカットは add(ChartType.LINE, ...).
add_pie
ws.charts.add_pie(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chartショートカットは add(ChartType.PIE, ...).
add_area
ws.charts.add_area(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chartショートカットは add(ChartType.AREA, ...).
プロパティとイテレーション
| SaveOptions | SaveOptions |
|---|---|
count | コレクション内のチャート数（読み取り専用）。. |
__len__() | SaveOptions count. |
__iter__() | すべてに対して反復処理します Chart オブジェクト。. |
__getitem__(index) | 返します Chart ゼロベースの index. |
NSeries
NSeries は次を介してアクセスされます chart.n_series.。チャートに属するデータ系列を管理します。.
SaveOptions
add
chart.n_series.add(
area: str,
is_vertical: bool = False,
category_data: str | None = None,
name: str | None = None,
chart_type: ChartType | None = None
) -> ChartSeriesデータ系列を追加します。. area は次のような範囲文字列です "Sheet1!B1:B5".。設定 is_vertical=True データが列方向に配置されている場合。. chart_type この系列の親チャートタイプを上書きします（コンボチャートで使用）。.
プロパティとイテレーション
| SaveOptions | SaveOptions |
|---|---|
count | 系列数（読み取り専用）。. |
__len__() | SaveOptions count. |
__iter__() | すべてを反復処理します ChartSeries オブジェクト。. |
__getitem__(index) | 返します ChartSeries ゼロベースの index. |
ChartSeries
ChartSeries チャート内の単一データ系列を表します。取得方法は chart.n_series[index].
SaveOptions
| SaveOptions | SaveOptions | SaveOptions |
|---|---|---|
values | str | Y 値データの範囲文字列（例：., "Sheet1!B2:B6"). |
category_data | str | この系列のカテゴリ／X 軸ラベルの範囲文字列です。. |
name | `str | None` |
chart_type | `ChartType | None` |
x_values | str | 散布図の X 値の範囲文字列。. |
error_bars | `ChartErrorBars | None` |
smooth | bool | True このシリーズにスムーズラインを使用する。. |
SaveOptions
add_error_bars
series.add_error_bars(
direction='y',
bar_type='both',
val_type='fixedVal',
val=1.0,
no_end_cap=False
) -> ChartErrorBarsこのシリーズにエラーバーを追加し、返す ChartErrorBars オブジェクト。.
| SaveOptions | SaveOptions |
|---|---|
direction | 'x', 'y', 'xy' |
bar_type | 'both', 'minus', 'plus' |
val_type | 'fixedVal', 'percentage', 'stdDev', 'stdErr' |
ChartAxis
ChartAxis は次を介してアクセスされます chart.axes[index].
SaveOptions
| SaveOptions | SaveOptions | SaveOptions |
|---|---|---|
title | `str | None` |
number_format | `str | None` |
minimum_scale | `float | None` |
maximum_scale | `float | None` |
major_unit | `float | None` |
minor_unit | `float | None` |
is_logarithmic | bool | True 対数スケールを使用する。. |
log_base | float | 対数の底（ベース）は、次の場合 is_logarithmic は True. |
crosses | str | この軸が垂直軸と交差する位置：: 'autoZero', 'min', 'max'. |
crosses_at | `float | None` |
reverse_order | bool | True 軸の方向を反転する。. |
axis_type | str | 軸のカテゴリタイプ：: 'catAx', 'valAx', 'dateAx', 'serAx'. |
orientation | str | 'minMax' 通常方向の場合、, 'maxMin' 逆順用です。. |
ChartView3D
ChartView3D は～経由でアクセスされます chart.view_3d. 適用されるのは chart.is_3d です True.
SaveOptions
| SaveOptions | SaveOptions | SaveOptions |
|---|---|---|
rotation_x | int | X軸回転（仰角）、0–90度。. |
rotation_y | int | Y軸回転、0〜360度。. |
right_angle_axes | bool | True 直角軸（等角ビュー）を使用する。. |
perspective | int | 遠近歪み、0〜100。無視されるのは right_angle_axes です True. |
height_percent | int | 基準に対するチャートの高さ（%）、5〜500。. |
depth_percent | int | 基準に対するチャートの奥行き（%）、20〜2000。. |
ChartErrorBars
ChartErrorBars は次からアクセスできます series.error_bars.で作成 series.add_error_bars(...).
SaveOptions
| SaveOptions | SaveOptions | SaveOptions |
|---|---|---|
direction | str | エラーバーの方向: 'x', 'y', 'xy'. |
bar_type | str | 表示するバー: 'both', 'minus', 'plus'. |
val_type | str | 値の種類: 'fixedVal', 'percentage', 'stdDev', 'stdErr'. |
val | float | 固定またはパーセンテージ値が使用される場合 val_type は 'fixedVal' または 'percentage'. |
no_end_cap | bool | True エラーバーの端キャップ線を省略する。. |
plus_formula | `str | None` |
minus_formula | `str | None` |
line_width | `int | None` |
line_color | `str | None` |
SaveOptions
以下の例は月次売上データを書き込み、タイトルと 2 つのデータ系列を持つクラスター化棒グラフを作成し、ワークブックを保存します。.
from aspose.cells_foss import Workbook, ChartType
wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Revenue"
# Write headers and data
headers = ["Month", "Product A", "Product B"]
data = [
["Jan", 12000, 9500],
["Feb", 14500, 11000],
["Mar", 13200, 12800],
["Apr", 15800, 14100],
]
for col, h in enumerate(headers):
ws.cells[0][col].put_value(h)
for row, row_data in enumerate(data, start=1):
for col, val in enumerate(row_data):
ws.cells[row][col].put_value(val)
# Add a bar chart covering rows 6-20, columns 0-6
chart = ws.charts.add_bar(6, 0, 20, 6)
chart.title = "Monthly Revenue by Product"
chart.bar_direction = "col" # vertical (column chart)
chart.grouping = "clustered"
# Series: Product A and Product B
chart.n_series.add("Revenue!B2:B5", is_vertical=True, category_data="Revenue!A2:A5", name="Product A")
chart.n_series.add("Revenue!C2:C5", is_vertical=True, category_data="Revenue!A2:A5", name="Product B")
chart.show_legend = True
chart.legend_position = "bottom"
wb.save("revenue_chart.xlsx")