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")

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