Pie
#
NameSets the trace name. The trace name appears as the legend item and on hover.
In the Name text box, the name can be entered and formatted. This is automatically reflected in the Structure > Traces[link] section and in the legend[link] of the chart. The trace name can be also edited directly by double-clicking the trace name in the chart legend.
HTML tags and CSS formatting can be used to enrich text styling.
#
Trace OpacitySets the opacity (transparency) of the trace.
#
Segment Colors#
ColorsClicking on the colored bar next to "Colors" hides or reveals an extra menu, allowing the popup choice of these classes of color scales:
sequential scales Use sequential colorscales for data that smoothly changes value and has meaningful order.
divergent scales Use divergent colorscales for data that smoothly changes around a centerpoint (such as zero).
categorical scales Use categorical colorscales for data that has distinct groups and a non-meaningful order.
cyclical scales Use cyclical colorscales for data that has a natural cycle, such as angular, diurnal or seasonal data.
cubehelix scales Cubehelix colorscales are like sequential scales, but have the added benefit of printing clearly in black & white. Adjust the "start" slider to change the scale's base color. A cubehelix scale with 0 rotation transitions through a single base color. A scale with non-zero rotation "rotates" through other colors. Change the rotation slightly to add a touch of another color, change it more to create a scale with multiple colors.
cmocean scales cmocean colorscales are a mix of sequential and diverging scales. They were originally developed for oceanography data, but can be applied beautifully to any other type of data as well.
#
Extended ColorsWhen more data than colors is present, the available colors in the chosen scale are exhausted; this has two solutions:
On prevent repetition by adding random colors.
Off reuses (repeats) the indicated colors.
#
Subchart Title#
NameThe pie chart can have its own title, which is entered by filling text in the Subchart Title > Name field. The subchart title will be placed in the middle when Segment > Hole Size[link] is large enough, or atop the pie chart otherwise.
#
SegmentsShape, order and arrangement of the segments is set in this pane.
#
OrderSorted Segments can be sorted by size, starting with the largest segment working toward the smallest segment.
Unsorted takes the order of the grid rows for placing the segments.
#
DirectionClockwise is the default direction when placing the segments (starting at 12 o'clock, unless Segments > Rotation is not zero)
Counterclockwise reverses the direction of the placement
#
RotationTo place the desired segment "at twelve o'clock", Rotation (in degrees) can be used. Positive numbers rotate clockwise, negative numbers rotate counterclockwise.
#
Hole SizeThe center of the pie chart can be blanked to make room for the Name[link] of the subchart. The text size of the subchart name will be scaled down as far as necessary and possible.
#
PullPadding of the pie segments is determined as fraction of two adjacent segments: larger segments cause larger gaps between segments.
#
Border WidthAround each pie segment a border is placed increasing inward and outward size of the segment. On narrow Pull settings, this will join two segments by their border.
#
Border ColorOnly available when Border Width has a non-zero value.
The default color picker[link] is used to set the color of the segment border, if present.
#
TextText added to the pie chart segments
#
Text PositionDepending on choosing All or Custom various popups appear
All places all segment texts on the same relative position. * *Inside The segment text is placed inside the segment regardless of the available space in the chart. The text is placed horizontal in larger segments and aligned with the segment's rotation when space is scarce. This is set in the conditional popup Inside Text Orientation below. Outside places the segment text in the perimeter of the segment * *Auto uses inside when enough space is available and outside for small segments when utside the circle of the pie chart the rectangular chart area has enough space. None does not show any segment text in the chart
Custom This should[bug] position text values individually, according to the provided data positions array. The popup Data inlined in Figure appears and provides an option to chose a grid colum that holds combinations of [Top, Middle, Bottom] and [Left, Center,Right]
#
ModeValues will display the values taken from the data grid as plain text.
- Template shows an edit panel for the template string used for rendering the information text. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". Dates and times are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}".
#
ShowShow or hide information of the pie segments. Contains a hidden Text option that is activated by chosing a grid column in Text below. Tick any you want:
Label shows the text as per grid text column
Value shows the absolute value from the grid cells
% displays the relative percentage of the segment
Text
Only available when a text grid column has been chosen in Text below.
#
TextThe grid column[link], holding the text to be shown for each item on hover, can be chosen here. Only data-containing columns can be selected.
#
TypefaceHTML font family - the typeface that will be applied by the web browser. The web browser will only be able to apply a font if it is available on the system in which it operates. Plotly has a set of standard fonts available on all platforms, containing Arial, Balto, Courier New, Droid Sans, Droid Serif, Droid Sans Mono, Gravitas One, Old Standard TT, Open Sans, Overpass, PT Sans Narrow, Raleway and Times New Roman.
#
Font SizeSize of the typeface in pixels.
#
Font ColorSpecifies the color of the font, set using the default color picker[link]
#
Inside Text OrientationOnly available when Text > Text Positions is set to inside.
The text is rotated according to the setting below. When not enough space is available, the text is shown in a smaller size, regardless of the ***Font Size*** set above.Auto displays the segment text with a combination of horizontal, radial and tangential, whichever fits best.
Radial places the text aligned with the segment's axis, toward the center
Tangential places the text perpendicular to the segment's axis
Horizontal places the text horizontally
#
Scaling#
Scale GroupIf there are multiple pie charts that should be sized according to their totals, place every trace in the same group. Seems defunct[bug]: groups can be added and chosen but selecting from the popup returns to Select an Option***
#
Hover/Tooltip#
Mode- Values tooltips will show actual data values on hover.
- Template tooltips will show custom-formatted values on hover. This option also enables the template formatting field.
#
ShowShow or hide information of the pie segments when being hovered over. Contains a hidden Text option that is activated by chosing a grid column in Text below. Tick any you want:
Percent displays the relative percentage of the segment
Label shows the text as per grid text column
Value shows the absolute value from the grid cells
Text
Only available when a text grid column has been chosen in Text above.
Trace name
Only available when a text grid column has been chosen in Text above.
#
Trace NameOnly appears when Trace name is ticked in the Show menu
- Clip To The trace name is partially shown in a side pane attached to the hover pane. Opens extra numerical data field.
- No Clip An extra side-panel is added to the hover pane, showing the entire trace name.
- Hide No trace name is shown in the hover info pane.
- px Numerical field to enter the number of pixels the trace name will be clipped to, only appears when Clip To is selected.
#
Text AlignmentSets the horizontal alignment of the text content within the hover label box. Has an effect only if the hover label text spans two or more lines. Alignment of Hover/Tooltip can be set to Auto, Left or Right.