1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
.. currentmodule:: altair
.. _user-guide-marks:
Marks
~~~~~
We saw in :ref:`user-guide-encoding` that the :meth:`~Chart.encode` method is
used to map columns to visual attributes of the plot.
The ``mark`` property is what specifies how exactly those attributes
should be represented on the plot.
Altair supports the following primitive mark types:
========================================= ========================================= ================================================================================
Mark Method Description
========================================= ========================================= ================================================================================
:ref:`user-guide-arc-marks` :meth:`~Chart.mark_arc` A pie chart.
:ref:`user-guide-area-marks` :meth:`~Chart.mark_area` A filled area plot.
:ref:`user-guide-bar-marks` :meth:`~Chart.mark_bar` A bar plot.
:ref:`user-guide-circle-marks` :meth:`~Chart.mark_circle` A scatter plot with filled circles.
:ref:`user-guide-geoshape-marks` :meth:`~Chart.mark_geoshape` Visualization containing spatial data
:ref:`user-guide-image-marks` :meth:`~Chart.mark_image` A scatter plot with image markers.
:ref:`user-guide-line-marks` :meth:`~Chart.mark_line` A line plot.
:ref:`user-guide-point-marks` :meth:`~Chart.mark_point` A scatter plot with configurable point shapes.
:ref:`user-guide-rect-marks` :meth:`~Chart.mark_rect` A filled rectangle, used for heatmaps
:ref:`user-guide-rule-marks` :meth:`~Chart.mark_rule` A vertical or horizontal line spanning the axis.
:ref:`user-guide-square-marks` :meth:`~Chart.mark_square` A scatter plot with filled squares.
:ref:`user-guide-text-marks` :meth:`~Chart.mark_text` A scatter plot with points represented by text.
:ref:`user-guide-tick-marks` :meth:`~Chart.mark_tick` A vertical or horizontal tick mark.
:ref:`user-guide-trail-marks` :meth:`~Chart.mark_trail` A line with variable widths.
========================================= ========================================= ================================================================================
In addition, Altair provides the following composite marks:
========================================= ============================== ================================ ==================================
Mark Name Method Description Example
========================================= ============================== ================================ ==================================
:ref:`user-guide-boxplot-marks` :meth:`~Chart.mark_boxplot` A box plot. :ref:`gallery_boxplot`
:ref:`user-guide-errorband-marks` :meth:`~Chart.mark_errorband` A continuous band around a line. :ref:`gallery_line_with_ci`
:ref:`user-guide-errorbar-marks` :meth:`~Chart.mark_errorbar` An error bar around a point. :ref:`gallery_errorbars_with_ci`
========================================= ============================== ================================ ==================================
In Altair, marks can be most conveniently specified by the ``mark_*`` methods
of the Chart object (e.g. ``mark_bar``), which take optional keyword arguments to configure the look of the marks.
.. _mark-properties:
Mark Properties
_______________
This section lists standard mark properties for primitive mark types. Additionally, some marks may have special mark properties (listed in their documentation page).
General Mark Properties
^^^^^^^^^^^^^^^^^^^^^^^
.. altair-object-table:: altair.MarkDef
:properties: aria description style tooltip clip invalid order
Position and Offset Properties
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. altair-object-table:: altair.MarkDef
:properties: x x2 width height y y2 xOffset x2Offset yOffset y2Offset
Color Properties
^^^^^^^^^^^^^^^^
.. altair-object-table:: altair.MarkDef
:properties: filled color fill stroke blend opacity fillOpacity strokeOpacity
Stroke Style Properties
^^^^^^^^^^^^^^^^^^^^^^^
.. altair-object-table:: altair.MarkDef
:properties: strokeCap strokeDash strokeDashOffset strokeJoin strokeMiterLimit strokeWidth
Hyperlink Properties
^^^^^^^^^^^^^^^^^^^^
Marks can act as hyperlinks when the ``href`` property or :ref:`channel <hyperlink-channel>`
is defined. When the ``href`` property is specified, the ``cursor`` mark property is
set to ``"pointer"`` by default to serve as affordance for hyperlinks.
.. altair-object-table:: altair.MarkDef
:properties: href cursor
.. toctree::
:hidden:
arc
area
bar
boxplot
circle
errorband
errorbar
geoshape
image
line
point
rect
rule
square
text
tick
trail
|
