Chart kinds

Choose the kind of chart to show, from area and bar charts to radar and mixed charts.

Area charts

AreaChart

class creator_studio_doc_format.core.AreaChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 2D area chart.

Keynote draws each series as a filled region against a shared category axis and value axis.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

Area3DChart

class creator_studio_doc_format.core.Area3DChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 3D area chart.

3D appearance settings such as rotation, depth, lighting, and textures aren’t included: rotation and depth take the default for this chart type, and lighting and a textured series’ fill come from the chart’s style.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

StackedAreaChart

class creator_studio_doc_format.core.StackedAreaChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 2D stacked area chart.

Keynote stacks each series’ filled region on top of the one before it against a shared category axis and value axis.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

StackedArea3DChart

class creator_studio_doc_format.core.StackedArea3DChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 3D stacked area chart.

3D appearance settings such as rotation, depth, lighting, and textures aren’t included: rotation and depth take the default for this chart type, and lighting and a textured series’ fill come from the chart’s style.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

Bar charts

BarChart

class creator_studio_doc_format.core.BarChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 2D bar chart.

Keynote draws each series as horizontal bars against a shared category axis and value axis.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

Bar3DChart

class creator_studio_doc_format.core.Bar3DChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 3D horizontal bar chart.

3D appearance settings such as rotation, depth, lighting, and textures aren’t included: rotation and depth take the default for this chart type, and lighting and a textured series’ fill come from the chart’s style.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

BarInteractiveChart

class creator_studio_doc_format.core.BarInteractiveChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

An interactive horizontal bar chart, which shows one data set at a time.

You can step between the data sets. The interactive control, the position of the data set name, and which data set is shown aren’t included, so they take the default for this chart type.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

StackedBarChart

class creator_studio_doc_format.core.StackedBarChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 2D stacked bar chart.

Each series contributes a segment to a single horizontal bar for each category, which Keynote measures against a shared value axis.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

StackedBar3DChart

class creator_studio_doc_format.core.StackedBar3DChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 3D stacked horizontal bar chart.

3D appearance settings such as rotation, depth, lighting, and textures aren’t included: rotation and depth take the default for this chart type, and lighting and a textured series’ fill come from the chart’s style.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

Column charts

ColumnChart

class creator_studio_doc_format.core.ColumnChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 2D column chart.

Keynote draws each series as vertical columns against a shared category axis and value axis. A chart whose type this version of the format doesn’t recognize is also written out as a column chart.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

Column3DChart

class creator_studio_doc_format.core.Column3DChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 3D vertical column chart.

3D appearance settings such as rotation, depth, lighting, and textures aren’t included: rotation and depth take the default for this chart type, and lighting and a textured series’ fill come from the chart’s style.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

ColumnInteractiveChart

class creator_studio_doc_format.core.ColumnInteractiveChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

An interactive vertical column chart, which shows one data set at a time.

You can step between the data sets. The interactive control, the position of the data set name, and which data set is shown aren’t included, so they take the default for this chart type.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

StackedColumnChart

class creator_studio_doc_format.core.StackedColumnChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 2D stacked column chart.

Each series contributes a segment to a single vertical column for each category, which Keynote measures against a shared value axis.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

StackedColumn3DChart

class creator_studio_doc_format.core.StackedColumn3DChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 3D stacked vertical column chart.

3D appearance settings such as rotation, depth, lighting, and textures aren’t included: rotation and depth take the default for this chart type, and lighting and a textured series’ fill come from the chart’s style.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

Line charts

LineChart

class creator_studio_doc_format.core.LineChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 2D line chart.

Keynote draws each series as a line against a shared category axis and value axis.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

Line3DChart

class creator_studio_doc_format.core.Line3DChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 3D line chart.

3D appearance settings such as rotation, depth, lighting, and textures aren’t included: rotation and depth take the default for this chart type, and lighting and a textured series’ fill come from the chart’s style.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

Pie and donut charts

PieChart

class creator_studio_doc_format.core.PieChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A pie chart.

Each series contributes one wedge, sized by that series’ first value; Keynote doesn’t show later values in a series. Pie charts have no categories and no axes.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

Pie3DChart

class creator_studio_doc_format.core.Pie3DChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A 3D pie chart.

Like the 2D pie chart, it has no axes. 3D appearance settings such as rotation, depth, lighting, and textures aren’t included: rotation and depth take the default for this chart type, and lighting and a textured series’ fill come from the chart’s style.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

DonutChart

class creator_studio_doc_format.core.DonutChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A donut chart.

Each series contributes one segment of the ring, sized by that series’ first value; Keynote doesn’t show later values in a series. Donut charts have no categories and no axes. The title, when shown, appears in the center of the ring.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

Bubble and scatter charts

BubbleChart

class creator_studio_doc_format.core.BubbleChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, value_axis_x=None, value_axis_y=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A bubble chart.

Keynote plots each data point against an X and a Y value axis, and its bubble area comes from a third data value rather than a series setting. See data.shared_xvalues for how the grid’s rows or columns map onto each series.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field value_axis_x : ChartValueAxis | None = None

The horizontal (X) value axis. When omitted, the X axis keeps the appearance it inherits from the chart’s style.

field value_axis_y : ChartValueAxis | None = None

The vertical (Y) value axis. When omitted, the Y axis keeps the appearance it inherits from the chart’s style.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

BubbleInteractiveChart

class creator_studio_doc_format.core.BubbleInteractiveChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, value_axis_x=None, value_axis_y=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

An interactive bubble chart, which shows one data set at a time.

You can step between the data sets. Keynote lays out the series as a bubble chart; for more information, see data.shared_xvalues. The interactive control, the position of the data set name, and which data set is shown aren’t included, so they take the default for this chart type.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field value_axis_x : ChartValueAxis | None = None

The horizontal (X) value axis. When omitted, the X axis keeps the appearance it inherits from the chart’s style.

field value_axis_y : ChartValueAxis | None = None

The vertical (Y) value axis. When omitted, the Y axis keeps the appearance it inherits from the chart’s style.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

ScatterChart

class creator_studio_doc_format.core.ScatterChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, value_axis_x=None, value_axis_y=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A scatter chart.

Keynote plots each data point against an X and a Y value axis rather than against a category axis. See data.shared_xvalues for how the grid’s rows or columns map onto each series.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field value_axis_x : ChartValueAxis | None = None

The horizontal (X) value axis. When omitted, the X axis keeps the appearance it inherits from the chart’s style.

field value_axis_y : ChartValueAxis | None = None

The vertical (Y) value axis. When omitted, the Y axis keeps the appearance it inherits from the chart’s style.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

ScatterInteractiveChart

class creator_studio_doc_format.core.ScatterInteractiveChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, value_axis_x=None, value_axis_y=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

An interactive scatter chart, which shows one data set at a time.

You can step between the data sets. Keynote lays out the series as a scatter chart; for more information, see data.shared_xvalues. The interactive control, the position of the data set name, and which data set the reader shows aren’t included, so they take the default for this chart type.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field value_axis_x : ChartValueAxis | None = None

The horizontal (X) value axis. When omitted, the X axis keeps the appearance it inherits from the chart’s style.

field value_axis_y : ChartValueAxis | None = None

The vertical (Y) value axis. When omitted, the Y axis keeps the appearance it inherits from the chart’s style.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

Radar, mixed, and two-axis charts

RadarChart

class creator_studio_doc_format.core.RadarChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A radar chart.

Keynote arranges the categories radially around a center point and plots each series against a shared radial value scale.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

MixedChart

class creator_studio_doc_format.core.MixedChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A mixed chart, which draws individual series as columns, lines, or areas.

The series share a category axis and value axis, and each series picks its shape through its ChartSeries.mixed_series_type value.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.

TwoAxisChart

class creator_studio_doc_format.core.TwoAxisChart(*, preset_identifier='', title=None, caption=None, data=None, show_legend=True, legend=None, series=None, chart_colors=None, category_axis=None, value_axis=None, value_axis_secondary=None, identifier=None, geometry=None, aspect_ratio_locked=False, description=None, **extra_data)[source]

A two-axis chart, which is a category chart with two independent value scales.

The two scales let Keynote measure different series against different value axes. It’s the only chart type that uses value_axis_secondary, and, like the mixed chart, it lets each series pick its shape through its ChartSeries.mixed_series_type value.

field title : Label | None = None

The object’s title.

field caption : Label | None = None

The object’s caption, which Keynote always places below the object. If a caption is off, you still write it out with Label.is_visible set to false, so having a value doesn’t mean the caption shows.

field data : ChartData | None = None

The chart’s data grid, together with its plot direction and data-source mode. This data replaces the placeholder data a new chart starts with; when omitted, that placeholder data remains.

field show_legend : bool = True

A Boolean value that indicates whether the chart’s legend appears. This value is independent of the legend property, which sets the legend’s placement and text style rather than its visibility.

field legend : ChartLegend | None = None

The placement and label text style of the chart’s legend. This value doesn’t control whether the legend appears (see show_legend), and it only applies to a chart that has a legend.

field series : list[ChartSeries] | None = None

The styling and label formatting for individual data series. Each entry applies to the series named by its ChartSeries.series_index, or to the series at the same position when ChartSeries.series_index is omitted; entries that don’t correspond to a series in the data don’t have an effect.

field chart_colors : list[ChartColor] | None = None

The chart’s ordered series styles. A series takes the entry at its own position, and the chart’s style supplies any position without an entry or with an empty one, so the list doesn’t wrap. Entries past the last series also remain. Keynote reads one entry for each series style in the chart’s style and ignores any further entries.

field category_axis : ChartCategoryAxis | None = None

The category axis, along which Keynote lays out the chart’s categories. When omitted, the category axis keeps the appearance it inherits from the chart’s style.

field value_axis : ChartValueAxis | None = None

The primary value axis, which carries the numeric scale to measure the series against. When omitted, the value axis keeps the appearance it inherits from the chart’s style.

field value_axis_secondary : ChartValueAxis | None = None

The second value axis, used only by a two-axis chart that actually plots a series against a second value scale. On any other chart type, this value doesn’t have an effect.

field identifier : str | None = None

An identifier for this object that other objects use to refer to it. This identifier must be unique across the whole document.

field geometry : Geometry | None = None

The object’s position and size. If this value is absent, Keynote places the object automatically, with a default position and size for its kind.

field aspect_ratio_locked : bool = False

A Boolean value that indicates whether the object’s width-to-height ratio is locked when the object resizes. The lock doesn’t constrain the geometry property. If this property is absent, images, movies, and groups default to true, and other objects to false.

field description : str | None = None

The accessibility description for the object, read aloud by assistive technologies such as VoiceOver.