Trendline класс

Trendline класс

Представляет линию тренда на диаграмме.

Наследование: TrendlineLine

Тип Trendline предоставляет следующие элементы:

Характеристики

СвойствоОписание
compound_typeУказывает тип составной линии
dash_typeУказывает тип пунктирной линии
cap_typeУказывает конечные прописные буквы.
join_typeУказывает соединительные заглушки.
begin_typeУказывает стрелку в начале строки.
end_typeУказывает стрелку в конце строки.
begin_arrow_lengthУказывает длину стрелки в начале строки.
end_arrow_lengthУказывает длину стрелки в конце строки.
begin_arrow_widthОпределяет ширину стрелки в начале строки.
end_arrow_widthОпределяет ширину стрелки в конце строки.
theme_colorПолучает и устанавливает цвет темы.
colorПредставляет цвет линии.
transparencyВозвращает или задает степень прозрачности линии в диапазоне от 0,0 (непрозрачная) до 1,0 (прозрачная).
styleПредставляет стиль линии.
weightПолучает или задает WeightType строки.
weight_ptПолучает или задает вес линии в точках.
weight_pxПолучает или задает вес линии в пикселях.
formatting_typeПолучает или задает тип формата.
is_automatic_colorУказывает, назначается ли цвет линии автоматически.
is_visibleУказывает, видна ли линия.
is_autoУказывает, назначается ли этот стиль линии автоматически.
gradient_fillПредставляет градиентную заливку.
is_name_autoВозвращается, если Microsoft Excel автоматически определяет имя линии тренда.
typeВозвращает тип линии тренда.
nameВозвращает имя линии тренда.
orderВозвращает или устанавливает порядок линий тренда (целое число больше 1), если тип линии тренда — полиномиальный.
Порядок должен быть от 2 до 6.
periodВозвращает или задает период для линии тренда скользящего среднего.
forwardВозвращает или задает количество периодов (или единиц на точечной диаграмме), на которые линия тренда простирается вперед.
Количество периодов должно быть больше или равно нулю.
backwardВозвращает или задает количество периодов (или единиц на точечной диаграмме), на которые линия тренда простирается назад.
Количество периодов должно быть больше или равно нулю.
Если тип диаграммы столбчатый, количество периодов должно быть от 0 до 0,5.
display_equationУказывает, отображается ли уравнение линии тренда на диаграмме (в той же метке данных, что и значение R-квадрата). Установка для этого свойства значения True автоматически включает метки данных.
display_r_squaredУказывает, отображается ли значение R-квадрата линии тренда на диаграмме (в той же метке данных, что и уравнение). Установка для этого свойства значения True автоматически включает метки данных.
interceptВозвращает или задает точку, в которой линия тренда пересекает ось значений.
data_labelsПредставляет объект DataLabels для указанной серии.
legend_entryПолучает запись легенды в соответствии с этой линией тренда.

Пример

from aspose.cells import Workbook
from aspose.cells.charts import ChartType, TrendlineType

# Instantiating a Workbook object
workbook = Workbook()
# Adding a new worksheet to the Excel object
sheetIndex = workbook.worksheets.add()
# Obtaining the reference of the newly added worksheet by passing its sheet index
worksheet = workbook.worksheets[sheetIndex]
# Adding a sample value to "A1" cell
worksheet.cells.get("A1").put_value(50)
# Adding a sample value to "A2" cell
worksheet.cells.get("A2").put_value(100)
# Adding a sample value to "A3" cell
worksheet.cells.get("A3").put_value(150)
# Adding a sample value to "A4" cell
worksheet.cells.get("A4").put_value(200)
# Adding a sample value to "B1" cell
worksheet.cells.get("B1").put_value(60)
# Adding a sample value to "B2" cell
worksheet.cells.get("B2").put_value(32)
# Adding a sample value to "B3" cell
worksheet.cells.get("B3").put_value(50)
# Adding a sample value to "B4" cell
worksheet.cells.get("B4").put_value(40)
# Adding a sample value to "C1" cell as category data
worksheet.cells.get("C1").put_value("Q1")
# Adding a sample value to "C2" cell as category data
worksheet.cells.get("C2").put_value("Q2")
# Adding a sample value to "C3" cell as category data
worksheet.cells.get("C3").put_value("Y1")
# Adding a sample value to "C4" cell as category data
worksheet.cells.get("C4").put_value("Y2")
# Adding a chart to the worksheet
chartIndex = worksheet.charts.add(ChartType.COLUMN, 5, 0, 15, 5)
# Accessing the instance of the newly added chart
chart = worksheet.charts[chartIndex]
# Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B4"
chart.n_series.add("A1:B4", True)
# Setting the data source for the category data of NSeries
chart.n_series.category_data = "C1:C4"
# adding a linear trendline
index = chart.n_series[0].trend_lines.add(TrendlineType.LINEAR)
trendline = chart.n_series[0].trend_lines[index]
# Setting the custom name of the trendline.
trendline.name = "Linear"
# Displaying the equation on chart
trendline.display_equation = True
# Displaying the R-Squared value on chart
trendline.display_r_squared = True
# Saving the Excel file
workbook.save("book1.xls")

Смотрите также