plotly.graph_objects
.Layout¶
-
class
plotly.graph_objects.
Layout
(arg=None, activeselection=None, activeshape=None, annotations=None, annotationdefaults=None, autosize=None, autotypenumbers=None, barcornerradius=None, bargap=None, bargroupgap=None, barmode=None, barnorm=None, boxgap=None, boxgroupgap=None, boxmode=None, calendar=None, clickmode=None, coloraxis=None, colorscale=None, colorway=None, computed=None, datarevision=None, dragmode=None, editrevision=None, extendfunnelareacolors=None, extendiciclecolors=None, extendpiecolors=None, extendsunburstcolors=None, extendtreemapcolors=None, font=None, funnelareacolorway=None, funnelgap=None, funnelgroupgap=None, funnelmode=None, geo=None, grid=None, height=None, hiddenlabels=None, hiddenlabelssrc=None, hidesources=None, hoverdistance=None, hoverlabel=None, hovermode=None, hoversubplots=None, iciclecolorway=None, images=None, imagedefaults=None, legend=None, map=None, mapbox=None, margin=None, meta=None, metasrc=None, minreducedheight=None, minreducedwidth=None, modebar=None, newselection=None, newshape=None, paper_bgcolor=None, piecolorway=None, plot_bgcolor=None, polar=None, scattergap=None, scattermode=None, scene=None, selectdirection=None, selectionrevision=None, selections=None, selectiondefaults=None, separators=None, shapes=None, shapedefaults=None, showlegend=None, sliders=None, sliderdefaults=None, smith=None, spikedistance=None, sunburstcolorway=None, template=None, ternary=None, title=None, titlefont=None, transition=None, treemapcolorway=None, uirevision=None, uniformtext=None, updatemenus=None, updatemenudefaults=None, violingap=None, violingroupgap=None, violinmode=None, waterfallgap=None, waterfallgroupgap=None, waterfallmode=None, width=None, xaxis=None, yaxis=None, **kwargs)¶ -
__init__
(arg=None, activeselection=None, activeshape=None, annotations=None, annotationdefaults=None, autosize=None, autotypenumbers=None, barcornerradius=None, bargap=None, bargroupgap=None, barmode=None, barnorm=None, boxgap=None, boxgroupgap=None, boxmode=None, calendar=None, clickmode=None, coloraxis=None, colorscale=None, colorway=None, computed=None, datarevision=None, dragmode=None, editrevision=None, extendfunnelareacolors=None, extendiciclecolors=None, extendpiecolors=None, extendsunburstcolors=None, extendtreemapcolors=None, font=None, funnelareacolorway=None, funnelgap=None, funnelgroupgap=None, funnelmode=None, geo=None, grid=None, height=None, hiddenlabels=None, hiddenlabelssrc=None, hidesources=None, hoverdistance=None, hoverlabel=None, hovermode=None, hoversubplots=None, iciclecolorway=None, images=None, imagedefaults=None, legend=None, map=None, mapbox=None, margin=None, meta=None, metasrc=None, minreducedheight=None, minreducedwidth=None, modebar=None, newselection=None, newshape=None, paper_bgcolor=None, piecolorway=None, plot_bgcolor=None, polar=None, scattergap=None, scattermode=None, scene=None, selectdirection=None, selectionrevision=None, selections=None, selectiondefaults=None, separators=None, shapes=None, shapedefaults=None, showlegend=None, sliders=None, sliderdefaults=None, smith=None, spikedistance=None, sunburstcolorway=None, template=None, ternary=None, title=None, titlefont=None, transition=None, treemapcolorway=None, uirevision=None, uniformtext=None, updatemenus=None, updatemenudefaults=None, violingap=None, violingroupgap=None, violinmode=None, waterfallgap=None, waterfallgroupgap=None, waterfallmode=None, width=None, xaxis=None, yaxis=None, **kwargs)¶ Construct a new Layout object
- Parameters
arg – dict of properties compatible with this constructor or an instance of
plotly.graph_objects.Layout
activeselection –
plotly.graph_objects.layout.Activeselection
instance or dict with compatible propertiesactiveshape –
plotly.graph_objects.layout.Activeshape
instance or dict with compatible propertiesannotations – A tuple of
plotly.graph_objects.layout.Annotation
instances or dicts with compatible propertiesannotationdefaults – When used in a template (as layout.template.layout.annotationdefaults), sets the default property values to use for elements of layout.annotations
autosize – Determines whether or not a layout width or height that has been left undefined by the user is initialized on each relayout. Note that, regardless of this attribute, an undefined layout width or height is always initialized on the first call to plot.
autotypenumbers – Using “strict” a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis
type
detection. This is the default value; however it could be overridden for individual axes.barcornerradius – Sets the rounding of bar corners. May be an integer number of pixels, or a percentage of bar width (as a string ending in %).
bargap – Sets the gap (in plot fraction) between bars of adjacent location coordinates.
bargroupgap – Sets the gap (in plot fraction) between bars of the same location coordinate.
barmode – Determines how bars at the same location coordinate are displayed on the graph. With “stack”, the bars are stacked on top of one another With “relative”, the bars are stacked on top of one another, with negative values below the axis, positive values above With “group”, the bars are plotted next to one another centered around the shared location. With “overlay”, the bars are plotted over one another, you might need to reduce “opacity” to see multiple bars.
barnorm – Sets the normalization for bar traces on the graph. With “fraction”, the value of each bar is divided by the sum of all values at that location coordinate. “percent” is the same but multiplied by 100 to show percentages.
boxgap – Sets the gap (in plot fraction) between boxes of adjacent location coordinates. Has no effect on traces that have “width” set.
boxgroupgap – Sets the gap (in plot fraction) between boxes of the same location coordinate. Has no effect on traces that have “width” set.
boxmode – Determines how boxes at the same location coordinate are displayed on the graph. If “group”, the boxes are plotted next to one another centered around the shared location. If “overlay”, the boxes are plotted over one another, you might need to set “opacity” to see them multiple boxes. Has no effect on traces that have “width” set.
calendar – Sets the default calendar system to use for interpreting and displaying dates throughout the plot.
clickmode – Determines the mode of single click interactions. “event” is the default value and emits the
plotly_click
event. In addition this mode emits theplotly_selected
event in drag modes “lasso” and “select”, but with no event data attached (kept for compatibility reasons). The “select” flag enables selecting single data points via click. This mode also supports persistent selections, meaning that pressing Shift while clicking, adds to / subtracts from an existing selection. “select” withhovermode
: “x” can be confusing, consider explicitly settinghovermode
: “closest” when using this feature. Selection events are sent accordingly as long as “event” flag is set as well. When the “event” flag is missing,plotly_click
andplotly_selected
events are not fired.coloraxis –
plotly.graph_objects.layout.Coloraxis
instance or dict with compatible propertiescolorscale –
plotly.graph_objects.layout.Colorscale
instance or dict with compatible propertiescolorway – Sets the default trace colors.
computed – Placeholder for exporting automargin-impacting values namely
margin.t
,margin.b
,margin.l
andmargin.r
in “full-json” mode.datarevision – If provided, a changed value tells
Plotly.react
that one or more data arrays has changed. This way you can modify arrays in-place rather than making a complete new copy for an incremental change. If NOT provided,Plotly.react
assumes that data arrays are being treated as immutable, thus any data array with a different identity from its predecessor contains new data.dragmode – Determines the mode of drag interactions. “select” and “lasso” apply only to scatter traces with markers or text. “orbit” and “turntable” apply only to 3D scenes.
editrevision – Controls persistence of user-driven changes in
editable: true
configuration, other than trace names and axis titles. Defaults tolayout.uirevision
.extendfunnelareacolors – If
true
, the funnelarea slice colors (whether given byfunnelareacolorway
or inherited fromcolorway
) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can setfalse
to disable. Colors provided in the trace, usingmarker.colors
, are never extended.extendiciclecolors – If
true
, the icicle slice colors (whether given byiciclecolorway
or inherited fromcolorway
) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can setfalse
to disable. Colors provided in the trace, usingmarker.colors
, are never extended.extendpiecolors – If
true
, the pie slice colors (whether given bypiecolorway
or inherited fromcolorway
) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can setfalse
to disable. Colors provided in the trace, usingmarker.colors
, are never extended.extendsunburstcolors – If
true
, the sunburst slice colors (whether given bysunburstcolorway
or inherited fromcolorway
) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can setfalse
to disable. Colors provided in the trace, usingmarker.colors
, are never extended.extendtreemapcolors – If
true
, the treemap slice colors (whether given bytreemapcolorway
or inherited fromcolorway
) will be extended to three times its original length by first repeating every color 20% lighter then each color 20% darker. This is intended to reduce the likelihood of reusing the same color when you have many slices, but you can setfalse
to disable. Colors provided in the trace, usingmarker.colors
, are never extended.font – Sets the global font. Note that fonts used in traces and other layout components inherit from the global font.
funnelareacolorway – Sets the default funnelarea slice colors. Defaults to the main
colorway
used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, seeextendfunnelareacolors
.funnelgap – Sets the gap (in plot fraction) between bars of adjacent location coordinates.
funnelgroupgap – Sets the gap (in plot fraction) between bars of the same location coordinate.
funnelmode – Determines how bars at the same location coordinate are displayed on the graph. With “stack”, the bars are stacked on top of one another With “group”, the bars are plotted next to one another centered around the shared location. With “overlay”, the bars are plotted over one another, you might need to reduce “opacity” to see multiple bars.
geo –
plotly.graph_objects.layout.Geo
instance or dict with compatible propertiesgrid –
plotly.graph_objects.layout.Grid
instance or dict with compatible propertiesheight – Sets the plot’s height (in px).
hiddenlabels – hiddenlabels is the funnelarea & pie chart analog of visible:’legendonly’ but it can contain many labels, and can simultaneously hide slices from several pies/funnelarea charts
hiddenlabelssrc – Sets the source reference on Chart Studio Cloud for
hiddenlabels
.hidesources – Determines whether or not a text link citing the data source is placed at the bottom-right cored of the figure. Has only an effect only on graphs that have been generated via forked graphs from the Chart Studio Cloud (at https://chart-studio.plotly.com or on- premise).
hoverdistance – Sets the default distance (in pixels) to look for data to add hover labels (-1 means no cutoff, 0 means no looking for data). This is only a real distance for hovering on point-like objects, like scatter points. For area-like objects (bars, scatter fills, etc) hovering is on inside the area and off outside, but these objects will not supersede hover on point-like objects in case of conflict.
hoverlabel –
plotly.graph_objects.layout.Hoverlabel
instance or dict with compatible propertieshovermode – Determines the mode of hover interactions. If “closest”, a single hoverlabel will appear for the “closest” point within the
hoverdistance
. If “x” (or “y”), multiple hoverlabels will appear for multiple points at the “closest” x- (or y-) coordinate within thehoverdistance
, with the caveat that no more than one hoverlabel will appear per trace. If x unified (or y unified), a single hoverlabel will appear multiple points at the closest x- (or y-) coordinate within thehoverdistance
with the caveat that no more than one hoverlabel will appear per trace. In this mode, spikelines are enabled by default perpendicular to the specified axis. If false, hover interactions are disabled.hoversubplots – Determines expansion of hover effects to other subplots If “single” just the axis pair of the primary point is included without overlaying subplots. If “overlaying” all subplots using the main axis and occupying the same space are included. If “axis”, also include stacked subplots using the same axis when
hovermode
is set to “x”, x unified, “y” or y unified.iciclecolorway – Sets the default icicle slice colors. Defaults to the main
colorway
used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, seeextendiciclecolors
.images – A tuple of
plotly.graph_objects.layout.Image
instances or dicts with compatible propertiesimagedefaults – When used in a template (as layout.template.layout.imagedefaults), sets the default property values to use for elements of layout.images
legend –
plotly.graph_objects.layout.Legend
instance or dict with compatible propertiesmap –
plotly.graph_objects.layout.Map
instance or dict with compatible propertiesmapbox –
plotly.graph_objects.layout.Mapbox
instance or dict with compatible propertiesmargin –
plotly.graph_objects.layout.Margin
instance or dict with compatible propertiesmeta – Assigns extra meta information that can be used in various
text
attributes. Attributes such as the graph, axis and colorbartitle.text
, annotationtext
trace.name
in legend items,rangeselector
,updatemenus
andsliders
label
text all supportmeta
. One can accessmeta
fields using template strings:%{meta[i]}
wherei
is the index of themeta
item in question.meta
can also be an object for example{key: value}
which can be accessed %{meta[key]}.metasrc – Sets the source reference on Chart Studio Cloud for
meta
.minreducedheight – Minimum height of the plot with margin.automargin applied (in px)
minreducedwidth – Minimum width of the plot with margin.automargin applied (in px)
modebar –
plotly.graph_objects.layout.Modebar
instance or dict with compatible propertiesnewselection –
plotly.graph_objects.layout.Newselection
instance or dict with compatible propertiesnewshape –
plotly.graph_objects.layout.Newshape
instance or dict with compatible propertiespaper_bgcolor – Sets the background color of the paper where the graph is drawn.
piecolorway – Sets the default pie slice colors. Defaults to the main
colorway
used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, seeextendpiecolors
.plot_bgcolor – Sets the background color of the plotting area in- between x and y axes.
polar –
plotly.graph_objects.layout.Polar
instance or dict with compatible propertiesscattergap – Sets the gap (in plot fraction) between scatter points of adjacent location coordinates. Defaults to
bargap
.scattermode – Determines how scatter points at the same location coordinate are displayed on the graph. With “group”, the scatter points are plotted next to one another centered around the shared location. With “overlay”, the scatter points are plotted over one another, you might need to reduce “opacity” to see multiple scatter points.
scene –
plotly.graph_objects.layout.Scene
instance or dict with compatible propertiesselectdirection – When
dragmode
is set to “select”, this limits the selection of the drag to horizontal, vertical or diagonal. “h” only allows horizontal selection, “v” only vertical, “d” only diagonal and “any” sets no limit.selectionrevision – Controls persistence of user-driven changes in selected points from all traces.
selections – A tuple of
plotly.graph_objects.layout.Selection
instances or dicts with compatible propertiesselectiondefaults – When used in a template (as layout.template.layout.selectiondefaults), sets the default property values to use for elements of layout.selections
separators – Sets the decimal and thousand separators. For example, *. * puts a ‘.’ before decimals and a space between thousands. In English locales, dflt is “.,” but other locales may alter this default.
shapes – A tuple of
plotly.graph_objects.layout.Shape
instances or dicts with compatible propertiesshapedefaults – When used in a template (as layout.template.layout.shapedefaults), sets the default property values to use for elements of layout.shapes
showlegend – Determines whether or not a legend is drawn. Default is
true
if there is a trace to show and any of these: a) Two or more traces would by default be shown in the legend. b) One pie trace is shown in the legend. c) One trace is explicitly given withshowlegend: true
.sliders – A tuple of
plotly.graph_objects.layout.Slider
instances or dicts with compatible propertiessliderdefaults – When used in a template (as layout.template.layout.sliderdefaults), sets the default property values to use for elements of layout.sliders
smith –
plotly.graph_objects.layout.Smith
instance or dict with compatible propertiesspikedistance – Sets the default distance (in pixels) to look for data to draw spikelines to (-1 means no cutoff, 0 means no looking for data). As with hoverdistance, distance does not apply to area-like objects. In addition, some objects can be hovered on but will not generate spikelines, such as scatter fills.
sunburstcolorway – Sets the default sunburst slice colors. Defaults to the main
colorway
used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, seeextendsunburstcolors
.template – Default attributes to be applied to the plot. This should be a dict with format:
{'layout': layoutTemplate, 'data': {trace_type: [traceTemplate, ...], ...}}
wherelayoutTemplate
is a dict matching the structure offigure.layout
andtraceTemplate
is a dict matching the structure of the trace with typetrace_type
(e.g. ‘scatter’). Alternatively, this may be specified as an instance of plotly.graph_objects.layout.Template. Trace templates are applied cyclically to traces of each type. Container arrays (egannotations
) have special handling: An object ending indefaults
(egannotationdefaults
) is applied to each array item. But if an item has atemplateitemname
key we look in the template array for an item with matchingname
and apply that instead. If no matchingname
is found we mark the item invisible. Any named template item not referenced is appended to the end of the array, so this can be used to add a watermark annotation or a logo image, for example. To omit one of these items on the plot, make an item with matchingtemplateitemname
andvisible: false
.ternary –
plotly.graph_objects.layout.Ternary
instance or dict with compatible propertiestitle –
plotly.graph_objects.layout.Title
instance or dict with compatible propertiestitlefont – Deprecated: Please use layout.title.font instead. Sets the title font. Note that the title’s font used to be customized by the now deprecated
titlefont
attribute.transition – Sets transition options used during Plotly.react updates.
treemapcolorway – Sets the default treemap slice colors. Defaults to the main
colorway
used for trace colors. If you specify a new list here it can still be extended with lighter and darker colors, seeextendtreemapcolors
.uirevision – Used to allow user interactions with the plot to persist after
Plotly.react
calls that are unaware of these interactions. Ifuirevision
is omitted, or if it is given and it changed from the previousPlotly.react
call, the exact new figure is used. Ifuirevision
is truthy and did NOT change, any attribute that has been affected by user interactions and did not receive a different value in the new figure will keep the interaction value.layout.uirevision
attribute serves as the default foruirevision
attributes in various sub-containers. For finer control you can set these sub-attributes directly. For example, if your app separately controls the data on the x and y axes you might setxaxis.uirevision=*time*
andyaxis.uirevision=*cost*
. Then if only the y data is changed, you can updateyaxis.uirevision=*quantity*
and the y axis range will reset but the x axis range will retain any user-driven zoom.uniformtext –
plotly.graph_objects.layout.Uniformtext
instance or dict with compatible propertiesupdatemenus – A tuple of
plotly.graph_objects.layout.Updatemenu
instances or dicts with compatible propertiesupdatemenudefaults – When used in a template (as layout.template.layout.updatemenudefaults), sets the default property values to use for elements of layout.updatemenus
violingap – Sets the gap (in plot fraction) between violins of adjacent location coordinates. Has no effect on traces that have “width” set.
violingroupgap – Sets the gap (in plot fraction) between violins of the same location coordinate. Has no effect on traces that have “width” set.
violinmode – Determines how violins at the same location coordinate are displayed on the graph. If “group”, the violins are plotted next to one another centered around the shared location. If “overlay”, the violins are plotted over one another, you might need to set “opacity” to see them multiple violins. Has no effect on traces that have “width” set.
waterfallgap – Sets the gap (in plot fraction) between bars of adjacent location coordinates.
waterfallgroupgap – Sets the gap (in plot fraction) between bars of the same location coordinate.
waterfallmode – Determines how bars at the same location coordinate are displayed on the graph. With “group”, the bars are plotted next to one another centered around the shared location. With “overlay”, the bars are plotted over one another, you might need to reduce “opacity” to see multiple bars.
width – Sets the plot’s width (in px).
xaxis –
plotly.graph_objects.layout.XAxis
instance or dict with compatible propertiesyaxis –
plotly.graph_objects.layout.YAxis
instance or dict with compatible properties
- Returns
- Return type
-
plotly.graph_objects
.layout¶
-
class
plotly.graph_objects.layout.
Activeselection
(arg=None, fillcolor=None, opacity=None, **kwargs)¶ -
property
fillcolor
¶ Sets the color filling the active selection’ interior.
- The ‘fillcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
opacity
¶ Sets the opacity of the active selection.
- The ‘opacity’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
-
class
plotly.graph_objects.layout.
Activeshape
(arg=None, fillcolor=None, opacity=None, **kwargs)¶ -
property
fillcolor
¶ Sets the color filling the active shape’ interior.
- The ‘fillcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
opacity
¶ Sets the opacity of the active shape.
- The ‘opacity’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
-
class
plotly.graph_objects.layout.
Annotation
(arg=None, align=None, arrowcolor=None, arrowhead=None, arrowside=None, arrowsize=None, arrowwidth=None, ax=None, axref=None, ay=None, ayref=None, bgcolor=None, bordercolor=None, borderpad=None, borderwidth=None, captureevents=None, clicktoshow=None, font=None, height=None, hoverlabel=None, hovertext=None, name=None, opacity=None, showarrow=None, standoff=None, startarrowhead=None, startarrowsize=None, startstandoff=None, templateitemname=None, text=None, textangle=None, valign=None, visible=None, width=None, x=None, xanchor=None, xclick=None, xref=None, xshift=None, y=None, yanchor=None, yclick=None, yref=None, yshift=None, **kwargs)¶ -
property
align
¶ Sets the horizontal alignment of the
text
within the box. Has an effect only iftext
spans two or more lines (i.e.text
contains one or more <br> HTML tags) or if an explicit width is set to override the text width.- The ‘align’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘left’, ‘center’, ‘right’]
- Returns
- Return type
Any
-
property
arrowcolor
¶ Sets the color of the annotation arrow.
- The ‘arrowcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
arrowhead
¶ Sets the end annotation arrow head style.
- The ‘arrowhead’ property is a integer and may be specified as:
An int (or float that will be cast to an int) in the interval [0, 8]
- Returns
- Return type
-
property
arrowside
¶ Sets the annotation arrow head position.
The ‘arrowside’ property is a flaglist and may be specified as a string containing:
Any combination of [‘end’, ‘start’] joined with ‘+’ characters (e.g. ‘end+start’) OR exactly one of [‘none’] (e.g. ‘none’)
- Returns
- Return type
Any
-
property
arrowsize
¶ Sets the size of the end annotation arrow head, relative to
arrowwidth
. A value of 1 (default) gives a head about 3x as wide as the line.- The ‘arrowsize’ property is a number and may be specified as:
An int or float in the interval [0.3, inf]
- Returns
- Return type
int|float
-
property
arrowwidth
¶ Sets the width (in px) of annotation arrow line.
- The ‘arrowwidth’ property is a number and may be specified as:
An int or float in the interval [0.1, inf]
- Returns
- Return type
int|float
-
property
ax
¶ Sets the x component of the arrow tail about the arrow head. If
axref
ispixel
, a positive (negative) component corresponds to an arrow pointing from right to left (left to right). Ifaxref
is notpixel
and is exactly the same asxref
, this is an absolute value on that axis, likex
, specified in the same coordinates asxref
.The ‘ax’ property accepts values of any type
- Returns
- Return type
Any
-
property
axref
¶ Indicates in what coordinates the tail of the annotation (ax,ay) is specified. If set to a x axis id (e.g. “x” or “x2”), the
x
position refers to a x coordinate. If set to “paper”, thex
position refers to the distance from the left of the plotting area in normalized coordinates where 0 (1) corresponds to the left (right). If set to a x axis ID followed by “domain” (separated by a space), the position behaves like for “paper”, but refers to the distance in fractions of the domain length from the left of the domain of that axis: e.g., x2 domain refers to the domain of the second x axis and a x position of 0.5 refers to the point between the left and the right of the domain of the second x axis. In order for absolute positioning of the arrow to work, “axref” must be exactly the same as “xref”, otherwise “axref” will revert to “pixel” (explained next). For relative positioning, “axref” can be set to “pixel”, in which case the “ax” value is specified in pixels relative to “x”. Absolute positioning is useful for trendline annotations which should continue to indicate the correct trend when zoomed. Relative positioning is useful for specifying the text offset for an annotated point.- The ‘axref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘pixel’]
- A string that matches one of the following regular expressions:
[‘^x([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
ay
¶ Sets the y component of the arrow tail about the arrow head. If
ayref
ispixel
, a positive (negative) component corresponds to an arrow pointing from bottom to top (top to bottom). Ifayref
is notpixel
and is exactly the same asyref
, this is an absolute value on that axis, likey
, specified in the same coordinates asyref
.The ‘ay’ property accepts values of any type
- Returns
- Return type
Any
-
property
ayref
¶ Indicates in what coordinates the tail of the annotation (ax,ay) is specified. If set to a y axis id (e.g. “y” or “y2”), the
y
position refers to a y coordinate. If set to “paper”, they
position refers to the distance from the bottom of the plotting area in normalized coordinates where 0 (1) corresponds to the bottom (top). If set to a y axis ID followed by “domain” (separated by a space), the position behaves like for “paper”, but refers to the distance in fractions of the domain length from the bottom of the domain of that axis: e.g., y2 domain refers to the domain of the second y axis and a y position of 0.5 refers to the point between the bottom and the top of the domain of the second y axis. In order for absolute positioning of the arrow to work, “ayref” must be exactly the same as “yref”, otherwise “ayref” will revert to “pixel” (explained next). For relative positioning, “ayref” can be set to “pixel”, in which case the “ay” value is specified in pixels relative to “y”. Absolute positioning is useful for trendline annotations which should continue to indicate the correct trend when zoomed. Relative positioning is useful for specifying the text offset for an annotated point.- The ‘ayref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘pixel’]
- A string that matches one of the following regular expressions:
[‘^y([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
bgcolor
¶ Sets the background color of the annotation.
- The ‘bgcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
bordercolor
¶ Sets the color of the border enclosing the annotation
text
.- The ‘bordercolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
borderpad
¶ Sets the padding (in px) between the
text
and the enclosing border.- The ‘borderpad’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
borderwidth
¶ Sets the width (in px) of the border enclosing the annotation
text
.- The ‘borderwidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
captureevents
¶ Determines whether the annotation text box captures mouse move and click events, or allows those events to pass through to data points in the plot that may be behind the annotation. By default
captureevents
is False unlesshovertext
is provided. If you use the eventplotly_clickannotation
withouthovertext
you must explicitly enablecaptureevents
.The ‘captureevents’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
clicktoshow
¶ Makes this annotation respond to clicks on the plot. If you click a data point that exactly matches the
x
andy
values of this annotation, and it is hidden (visible: false), it will appear. In “onoff” mode, you must click the same point again to make it disappear, so if you click multiple points, you can show multiple annotations. In “onout” mode, a click anywhere else in the plot (on another data point or not) will hide this annotation. If you need to show/hide this annotation in response to differentx
ory
values, you can setxclick
and/oryclick
. This is useful for example to label the side of a bar. To label markers though,standoff
is preferred overxclick
andyclick
.- The ‘clicktoshow’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[False, ‘onoff’, ‘onout’]
- Returns
- Return type
Any
-
property
font
¶ Sets the annotation text font.
The ‘font’ property is an instance of Font that may be specified as:
An instance of
plotly.graph_objects.layout.annotation.Font
A dict of string/value properties that will be passed to the Font constructor
Supported dict properties:
color
- family
HTML 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 which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren’t available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include “Arial”, “Balto”, “Courier New”, “Droid Sans”, “Droid Serif”, “Droid Sans Mono”, “Gravitas One”, “Old Standard TT”, “Open Sans”, “Overpass”, “PT Sans Narrow”, “Raleway”, “Times New Roman”.
- lineposition
Sets the kind of decoration line(s) with text, such as an “under”, “over” or “through” as well as combinations e.g. “under+over”, etc.
- shadow
Sets the shape and color of the shadow behind text. “auto” places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en- US/docs/Web/CSS/text-shadow for additional options.
size
- style
Sets whether a font should be styled with a normal or italic face from its family.
- textcase
Sets capitalization of text. It can be used to make text appear in all-uppercase or all- lowercase, or with each word capitalized.
- variant
Sets the variant of the font.
- weight
Sets the weight (or boldness) of the font.
- Returns
- Return type
-
property
height
¶ Sets an explicit height for the text box. null (default) lets the text set the box height. Taller text will be clipped.
- The ‘height’ property is a number and may be specified as:
An int or float in the interval [1, inf]
- Returns
- Return type
int|float
-
property
hoverlabel
¶ The ‘hoverlabel’ property is an instance of Hoverlabel that may be specified as:
An instance of
plotly.graph_objects.layout.annotation.Hoverlabel
A dict of string/value properties that will be passed to the Hoverlabel constructor
Supported dict properties:
- bgcolor
Sets the background color of the hover label. By default uses the annotation’s
bgcolor
made opaque, or white if it was transparent.- bordercolor
Sets the border color of the hover label. By default uses either dark grey or white, for maximum contrast with
hoverlabel.bgcolor
.- font
Sets the hover label text font. By default uses the global hover font and size, with color from
hoverlabel.bordercolor
.
- Returns
- Return type
-
property
hovertext
¶ Sets text to appear when hovering over this annotation. If omitted or blank, no hover label will appear.
- The ‘hovertext’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
name
¶ When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- The ‘name’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
opacity
¶ Sets the opacity of the annotation (text + arrow).
- The ‘opacity’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
showarrow
¶ Determines whether or not the annotation is drawn with an arrow. If True,
text
is placed near the arrow’s tail. If False,text
lines up with thex
andy
provided.The ‘showarrow’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
standoff
¶ Sets a distance, in pixels, to move the end arrowhead away from the position it is pointing at, for example to point at the edge of a marker independent of zoom. Note that this shortens the arrow from the
ax
/ay
vector, in contrast toxshift
/yshift
which moves everything by this amount.- The ‘standoff’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
startarrowhead
¶ Sets the start annotation arrow head style.
- The ‘startarrowhead’ property is a integer and may be specified as:
An int (or float that will be cast to an int) in the interval [0, 8]
- Returns
- Return type
-
property
startarrowsize
¶ Sets the size of the start annotation arrow head, relative to
arrowwidth
. A value of 1 (default) gives a head about 3x as wide as the line.- The ‘startarrowsize’ property is a number and may be specified as:
An int or float in the interval [0.3, inf]
- Returns
- Return type
int|float
-
property
startstandoff
¶ Sets a distance, in pixels, to move the start arrowhead away from the position it is pointing at, for example to point at the edge of a marker independent of zoom. Note that this shortens the arrow from the
ax
/ay
vector, in contrast toxshift
/yshift
which moves everything by this amount.- The ‘startstandoff’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
templateitemname
¶ Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- The ‘templateitemname’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
text
¶ Sets the text associated with this annotation. Plotly uses a subset of HTML tags to do things like newline (<br>), bold (<b></b>), italics (<i></i>), hyperlinks (<a href=’…’></a>). Tags <em>, <sup>, <sub>, <s>, <u> <span> are also supported.
- The ‘text’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
textangle
¶ Sets the angle at which the
text
is drawn with respect to the horizontal.The ‘textangle’ property is a angle (in degrees) that may be specified as a number between -180 and 180. Numeric values outside this range are converted to the equivalent value (e.g. 270 is converted to -90).
- Returns
- Return type
int|float
-
property
valign
¶ Sets the vertical alignment of the
text
within the box. Has an effect only if an explicit height is set to override the text height.- The ‘valign’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘top’, ‘middle’, ‘bottom’]
- Returns
- Return type
Any
-
property
visible
¶ Determines whether or not this annotation is visible.
The ‘visible’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
width
¶ Sets an explicit width for the text box. null (default) lets the text set the box width. Wider text will be clipped. There is no automatic wrapping; use <br> to start a new line.
- The ‘width’ property is a number and may be specified as:
An int or float in the interval [1, inf]
- Returns
- Return type
int|float
-
property
x
¶ Sets the annotation’s x position. If the axis
type
is “log”, then you must take the log of your desired range. If the axistype
is “date”, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axistype
is “category”, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears.The ‘x’ property accepts values of any type
- Returns
- Return type
Any
-
property
xanchor
¶ Sets the text box’s horizontal position anchor This anchor binds the
x
position to the “left”, “center” or “right” of the annotation. For example, ifx
is set to 1,xref
to “paper” andxanchor
to “right” then the right-most portion of the annotation lines up with the right-most edge of the plotting area. If “auto”, the anchor is equivalent to “center” for data-referenced annotations or if there is an arrow, whereas for paper-referenced with no arrow, the anchor picked corresponds to the closest side.- The ‘xanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘auto’, ‘left’, ‘center’, ‘right’]
- Returns
- Return type
Any
-
property
xclick
¶ Toggle this annotation when clicking a data point whose
x
value isxclick
rather than the annotation’sx
value.The ‘xclick’ property accepts values of any type
- Returns
- Return type
Any
-
property
xref
¶ Sets the annotation’s x coordinate axis. If set to a x axis id (e.g. “x” or “x2”), the
x
position refers to a x coordinate. If set to “paper”, thex
position refers to the distance from the left of the plotting area in normalized coordinates where 0 (1) corresponds to the left (right). If set to a x axis ID followed by “domain” (separated by a space), the position behaves like for “paper”, but refers to the distance in fractions of the domain length from the left of the domain of that axis: e.g., x2 domain refers to the domain of the second x axis and a x position of 0.5 refers to the point between the left and the right of the domain of the second x axis.- The ‘xref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘paper’]
- A string that matches one of the following regular expressions:
[‘^x([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
xshift
¶ Shifts the position of the whole annotation and arrow to the right (positive) or left (negative) by this many pixels.
- The ‘xshift’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
y
¶ Sets the annotation’s y position. If the axis
type
is “log”, then you must take the log of your desired range. If the axistype
is “date”, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axistype
is “category”, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears.The ‘y’ property accepts values of any type
- Returns
- Return type
Any
-
property
yanchor
¶ Sets the text box’s vertical position anchor This anchor binds the
y
position to the “top”, “middle” or “bottom” of the annotation. For example, ify
is set to 1,yref
to “paper” andyanchor
to “top” then the top-most portion of the annotation lines up with the top-most edge of the plotting area. If “auto”, the anchor is equivalent to “middle” for data- referenced annotations or if there is an arrow, whereas for paper-referenced with no arrow, the anchor picked corresponds to the closest side.- The ‘yanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘auto’, ‘top’, ‘middle’, ‘bottom’]
- Returns
- Return type
Any
-
property
yclick
¶ Toggle this annotation when clicking a data point whose
y
value isyclick
rather than the annotation’sy
value.The ‘yclick’ property accepts values of any type
- Returns
- Return type
Any
-
property
yref
¶ Sets the annotation’s y coordinate axis. If set to a y axis id (e.g. “y” or “y2”), the
y
position refers to a y coordinate. If set to “paper”, they
position refers to the distance from the bottom of the plotting area in normalized coordinates where 0 (1) corresponds to the bottom (top). If set to a y axis ID followed by “domain” (separated by a space), the position behaves like for “paper”, but refers to the distance in fractions of the domain length from the bottom of the domain of that axis: e.g., y2 domain refers to the domain of the second y axis and a y position of 0.5 refers to the point between the bottom and the top of the domain of the second y axis.- The ‘yref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘paper’]
- A string that matches one of the following regular expressions:
[‘^y([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
yshift
¶ Shifts the position of the whole annotation and arrow up (positive) or down (negative) by this many pixels.
- The ‘yshift’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
-
class
plotly.graph_objects.layout.
Coloraxis
(arg=None, autocolorscale=None, cauto=None, cmax=None, cmid=None, cmin=None, colorbar=None, colorscale=None, reversescale=None, showscale=None, **kwargs)¶ -
property
autocolorscale
¶ Determines whether the colorscale is a default palette (
autocolorscale: true
) or the palette determined bycolorscale
. In casecolorscale
is unspecified orautocolorscale
is true, the default palette will be chosen according to whether numbers in thecolor
array are all positive, all negative or mixed.The ‘autocolorscale’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
cauto
¶ Determines whether or not the color domain is computed with respect to the input data (here corresponding trace color array(s)) or the bounds set in
cmin
andcmax
Defaults tofalse
whencmin
andcmax
are set by the user.The ‘cauto’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
cmax
¶ Sets the upper bound of the color domain. Value should have the same units as corresponding trace color array(s) and if set,
cmin
must be set as well.- The ‘cmax’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
cmid
¶ Sets the mid-point of the color domain by scaling
cmin
and/orcmax
to be equidistant to this point. Value should have the same units as corresponding trace color array(s). Has no effect whencauto
isfalse
.- The ‘cmid’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
cmin
¶ Sets the lower bound of the color domain. Value should have the same units as corresponding trace color array(s) and if set,
cmax
must be set as well.- The ‘cmin’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
colorbar
¶ The ‘colorbar’ property is an instance of ColorBar that may be specified as:
An instance of
plotly.graph_objects.layout.coloraxis.ColorBar
A dict of string/value properties that will be passed to the ColorBar constructor
Supported dict properties:
- bgcolor
Sets the color of padded area.
- bordercolor
Sets the axis line color.
- borderwidth
Sets the width (in px) or the border enclosing this color bar.
- dtick
Sets the step in-between ticks on this axis. Use with
tick0
. Must be a positive number, or special strings available to “log” and “date” axes. If the axistype
is “log”, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, … set dtick to 1. To set tick marks at 1, 100, 10000, … set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, … set dtick to log_10(5), or 0.69897000433. “log” has several special values; “L<f>”, wheref
is a positive number, gives ticks linearly spaced in value (but not position). For exampletick0
= 0.1,dtick
= “L0.5” will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use “D1” (all digits) or “D2” (only 2 and 5).tick0
is ignored for “D1” and “D2”. If the axistype
is “date”, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, setdtick
to 86400000.0. “date” also has special values “M<n>” gives ticks spaced by a number of months.n
must be a positive integer. To set ticks on the 15th of every third month, settick0
to “2000-01-15” anddtick
to “M3”. To set ticks every 4 years, setdtick
to “M48”- exponentformat
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If “none”, it appears as 1,000,000,000. If “e”, 1e+9. If “E”, 1E+9. If “power”, 1x10^9 (with 9 in a super script). If “SI”, 1G. If “B”, 1B.
- labelalias
Replacement text for specific tick or hover labels. For example using {US: ‘USA’, CA: ‘Canada’} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
- len
Sets the length of the color bar This measure excludes the padding of both ends. That is, the color bar length is this length minus the padding on both ends.
- lenmode
Determines whether this color bar’s length (i.e. the measure in the color variation direction) is set in units of plot “fraction” or in *pixels. Use
len
to set the value.- minexponent
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when
tickformat
is “SI” or “B”.- nticks
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to
nticks
. Has an effect only iftickmode
is set to “auto”.- orientation
Sets the orientation of the colorbar.
- outlinecolor
Sets the axis line color.
- outlinewidth
Sets the width (in px) of the axis line.
- separatethousands
If “true”, even 4-digit integers are separated
- showexponent
If “all”, all exponents are shown besides their significands. If “first”, only the exponent of the first tick is shown. If “last”, only the exponent of the last tick is shown. If “none”, no exponents appear.
- showticklabels
Determines whether or not the tick labels are drawn.
- showtickprefix
If “all”, all tick labels are displayed with a prefix. If “first”, only the first tick is displayed with a prefix. If “last”, only the last tick is displayed with a suffix. If “none”, tick prefixes are hidden.
- showticksuffix
Same as
showtickprefix
but for tick suffixes.- thickness
Sets the thickness of the color bar This measure excludes the size of the padding, ticks and labels.
- thicknessmode
Determines whether this color bar’s thickness (i.e. the measure in the constant color direction) is set in units of plot “fraction” or in “pixels”. Use
thickness
to set the value.- tick0
Sets the placement of the first tick on this axis. Use with
dtick
. If the axistype
is “log”, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set thetick0
to 2) except whendtick`=*L<f>* (see `dtick
for more info). If the axistype
is “date”, it should be a date string, like date data. If the axistype
is “category”, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.- tickangle
Sets the angle of the tick labels with respect to the horizontal. For example, a
tickangle
of -90 draws the tick labels vertically.- tickcolor
Sets the tick color.
- tickfont
Sets the color bar’s tick label font
- tickformat
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- tickformatstops
A tuple of
plotly.graph_objects.layout. coloraxis.colorbar.Tickformatstop
instances or dicts with compatible properties- tickformatstopdefaults
When used in a template (as layout.template.lay out.coloraxis.colorbar.tickformatstopdefaults), sets the default property values to use for elements of layout.coloraxis.colorbar.tickformatstops
- ticklabeloverflow
Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. In other cases the default is hide past div.
- ticklabelposition
Determines where tick labels are drawn relative to the ticks. Left and right options are used when
orientation
is “h”, top and bottom whenorientation
is “v”.- ticklabelstep
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled.
tick0
determines which labels are shown. Not implemented for axes withtype
“log” or “multicategory”, or whentickmode
is “array”.- ticklen
Sets the tick length (in px).
- tickmode
Sets the tick mode for this axis. If “auto”, the number of ticks is set via
nticks
. If “linear”, the placement of the ticks is determined by a starting positiontick0
and a tick stepdtick
(“linear” is the default value iftick0
anddtick
are provided). If “array”, the placement of the ticks is set viatickvals
and the tick text isticktext
. (“array” is the default value iftickvals
is provided).- tickprefix
Sets a tick label prefix.
- ticks
Determines whether ticks are drawn or not. If “”, this axis’ ticks are not drawn. If “outside” (“inside”), this axis’ are drawn outside (inside) the axis lines.
- ticksuffix
Sets a tick label suffix.
- ticktext
Sets the text displayed at the ticks position via
tickvals
. Only has an effect iftickmode
is set to “array”. Used withtickvals
.- ticktextsrc
Sets the source reference on Chart Studio Cloud for
ticktext
.- tickvals
Sets the values at which ticks on this axis appear. Only has an effect if
tickmode
is set to “array”. Used withticktext
.- tickvalssrc
Sets the source reference on Chart Studio Cloud for
tickvals
.- tickwidth
Sets the tick width (in px).
- title
plotly.graph_objects.layout.coloraxis.c olorbar.Title
instance or dict with compatible properties- titlefont
Deprecated: Please use layout.coloraxis.colorbar.title.font instead. Sets this color bar’s title font. Note that the title’s font used to be set by the now deprecated
titlefont
attribute.- titleside
Deprecated: Please use layout.coloraxis.colorbar.title.side instead. Determines the location of color bar’s title with respect to the color bar. Defaults to “top” when
orientation
if “v” and defaults to “right” whenorientation
if “h”. Note that the title’s location used to be set by the now deprecatedtitleside
attribute.- x
Sets the x position with respect to
xref
of the color bar (in plot fraction). Whenxref
is “paper”, defaults to 1.02 whenorientation
is “v” and 0.5 whenorientation
is “h”. Whenxref
is “container”, defaults to 1 whenorientation
is “v” and 0.5 whenorientation
is “h”. Must be between 0 and 1 ifxref
is “container” and between “-2” and 3 ifxref
is “paper”.- xanchor
Sets this color bar’s horizontal position anchor. This anchor binds the
x
position to the “left”, “center” or “right” of the color bar. Defaults to “left” whenorientation
is “v” and “center” whenorientation
is “h”.- xpad
Sets the amount of padding (in px) along the x direction.
- xref
Sets the container
x
refers to. “container” spans the entirewidth
of the plot. “paper” refers to the width of the plotting area only.- y
Sets the y position with respect to
yref
of the color bar (in plot fraction). Whenyref
is “paper”, defaults to 0.5 whenorientation
is “v” and 1.02 whenorientation
is “h”. Whenyref
is “container”, defaults to 0.5 whenorientation
is “v” and 1 whenorientation
is “h”. Must be between 0 and 1 ifyref
is “container” and between “-2” and 3 ifyref
is “paper”.- yanchor
Sets this color bar’s vertical position anchor This anchor binds the
y
position to the “top”, “middle” or “bottom” of the color bar. Defaults to “middle” whenorientation
is “v” and “bottom” whenorientation
is “h”.- ypad
Sets the amount of padding (in px) along the y direction.
- yref
Sets the container
y
refers to. “container” spans the entireheight
of the plot. “paper” refers to the height of the plotting area only.
- Returns
- Return type
-
property
colorscale
¶ Sets the colorscale. The colorscale must be an array containing arrays mapping a normalized value to an rgb, rgba, hex, hsl, hsv, or named color string. At minimum, a mapping for the lowest (0) and highest (1) values are required. For example,
[[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]
. To control the bounds of the colorscale in color space, usecmin
andcmax
. Alternatively,colorscale
may be a palette name string of the following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric, Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis, YlGnBu,YlOrRd.The ‘colorscale’ property is a colorscale and may be specified as:
A list of colors that will be spaced evenly to create the colorscale. Many predefined colorscale lists are included in the sequential, diverging, and cyclical modules in the plotly.colors package.
A list of 2-element lists where the first element is the normalized color level value (starting at 0 and ending at 1), and the second item is a valid color string. (e.g. [[0, ‘green’], [0.5, ‘red’], [1.0, ‘rgb(0, 0, 255)’]])
- One of the following named colorscales:
- [‘aggrnyl’, ‘agsunset’, ‘algae’, ‘amp’, ‘armyrose’, ‘balance’,
‘blackbody’, ‘bluered’, ‘blues’, ‘blugrn’, ‘bluyl’, ‘brbg’, ‘brwnyl’, ‘bugn’, ‘bupu’, ‘burg’, ‘burgyl’, ‘cividis’, ‘curl’, ‘darkmint’, ‘deep’, ‘delta’, ‘dense’, ‘earth’, ‘edge’, ‘electric’, ‘emrld’, ‘fall’, ‘geyser’, ‘gnbu’, ‘gray’, ‘greens’, ‘greys’, ‘haline’, ‘hot’, ‘hsv’, ‘ice’, ‘icefire’, ‘inferno’, ‘jet’, ‘magenta’, ‘magma’, ‘matter’, ‘mint’, ‘mrybm’, ‘mygbm’, ‘oranges’, ‘orrd’, ‘oryel’, ‘oxy’, ‘peach’, ‘phase’, ‘picnic’, ‘pinkyl’, ‘piyg’, ‘plasma’, ‘plotly3’, ‘portland’, ‘prgn’, ‘pubu’, ‘pubugn’, ‘puor’, ‘purd’, ‘purp’, ‘purples’, ‘purpor’, ‘rainbow’, ‘rdbu’, ‘rdgy’, ‘rdpu’, ‘rdylbu’, ‘rdylgn’, ‘redor’, ‘reds’, ‘solar’, ‘spectral’, ‘speed’, ‘sunset’, ‘sunsetdark’, ‘teal’, ‘tealgrn’, ‘tealrose’, ‘tempo’, ‘temps’, ‘thermal’, ‘tropic’, ‘turbid’, ‘turbo’, ‘twilight’, ‘viridis’, ‘ylgn’, ‘ylgnbu’, ‘ylorbr’, ‘ylorrd’].
Appending ‘_r’ to a named colorscale reverses it.
- Returns
- Return type
-
property
reversescale
¶ Reverses the color mapping if true. If true,
cmin
will correspond to the last color in the array andcmax
will correspond to the first color.The ‘reversescale’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
-
class
plotly.graph_objects.layout.
Colorscale
(arg=None, diverging=None, sequential=None, sequentialminus=None, **kwargs)¶ -
property
diverging
¶ Sets the default diverging colorscale. Note that
autocolorscale
must be true for this attribute to work.The ‘diverging’ property is a colorscale and may be specified as:
A list of colors that will be spaced evenly to create the colorscale. Many predefined colorscale lists are included in the sequential, diverging, and cyclical modules in the plotly.colors package.
A list of 2-element lists where the first element is the normalized color level value (starting at 0 and ending at 1), and the second item is a valid color string. (e.g. [[0, ‘green’], [0.5, ‘red’], [1.0, ‘rgb(0, 0, 255)’]])
- One of the following named colorscales:
- [‘aggrnyl’, ‘agsunset’, ‘algae’, ‘amp’, ‘armyrose’, ‘balance’,
‘blackbody’, ‘bluered’, ‘blues’, ‘blugrn’, ‘bluyl’, ‘brbg’, ‘brwnyl’, ‘bugn’, ‘bupu’, ‘burg’, ‘burgyl’, ‘cividis’, ‘curl’, ‘darkmint’, ‘deep’, ‘delta’, ‘dense’, ‘earth’, ‘edge’, ‘electric’, ‘emrld’, ‘fall’, ‘geyser’, ‘gnbu’, ‘gray’, ‘greens’, ‘greys’, ‘haline’, ‘hot’, ‘hsv’, ‘ice’, ‘icefire’, ‘inferno’, ‘jet’, ‘magenta’, ‘magma’, ‘matter’, ‘mint’, ‘mrybm’, ‘mygbm’, ‘oranges’, ‘orrd’, ‘oryel’, ‘oxy’, ‘peach’, ‘phase’, ‘picnic’, ‘pinkyl’, ‘piyg’, ‘plasma’, ‘plotly3’, ‘portland’, ‘prgn’, ‘pubu’, ‘pubugn’, ‘puor’, ‘purd’, ‘purp’, ‘purples’, ‘purpor’, ‘rainbow’, ‘rdbu’, ‘rdgy’, ‘rdpu’, ‘rdylbu’, ‘rdylgn’, ‘redor’, ‘reds’, ‘solar’, ‘spectral’, ‘speed’, ‘sunset’, ‘sunsetdark’, ‘teal’, ‘tealgrn’, ‘tealrose’, ‘tempo’, ‘temps’, ‘thermal’, ‘tropic’, ‘turbid’, ‘turbo’, ‘twilight’, ‘viridis’, ‘ylgn’, ‘ylgnbu’, ‘ylorbr’, ‘ylorrd’].
Appending ‘_r’ to a named colorscale reverses it.
- Returns
- Return type
-
property
sequential
¶ Sets the default sequential colorscale for positive values. Note that
autocolorscale
must be true for this attribute to work.The ‘sequential’ property is a colorscale and may be specified as:
A list of colors that will be spaced evenly to create the colorscale. Many predefined colorscale lists are included in the sequential, diverging, and cyclical modules in the plotly.colors package.
A list of 2-element lists where the first element is the normalized color level value (starting at 0 and ending at 1), and the second item is a valid color string. (e.g. [[0, ‘green’], [0.5, ‘red’], [1.0, ‘rgb(0, 0, 255)’]])
- One of the following named colorscales:
- [‘aggrnyl’, ‘agsunset’, ‘algae’, ‘amp’, ‘armyrose’, ‘balance’,
‘blackbody’, ‘bluered’, ‘blues’, ‘blugrn’, ‘bluyl’, ‘brbg’, ‘brwnyl’, ‘bugn’, ‘bupu’, ‘burg’, ‘burgyl’, ‘cividis’, ‘curl’, ‘darkmint’, ‘deep’, ‘delta’, ‘dense’, ‘earth’, ‘edge’, ‘electric’, ‘emrld’, ‘fall’, ‘geyser’, ‘gnbu’, ‘gray’, ‘greens’, ‘greys’, ‘haline’, ‘hot’, ‘hsv’, ‘ice’, ‘icefire’, ‘inferno’, ‘jet’, ‘magenta’, ‘magma’, ‘matter’, ‘mint’, ‘mrybm’, ‘mygbm’, ‘oranges’, ‘orrd’, ‘oryel’, ‘oxy’, ‘peach’, ‘phase’, ‘picnic’, ‘pinkyl’, ‘piyg’, ‘plasma’, ‘plotly3’, ‘portland’, ‘prgn’, ‘pubu’, ‘pubugn’, ‘puor’, ‘purd’, ‘purp’, ‘purples’, ‘purpor’, ‘rainbow’, ‘rdbu’, ‘rdgy’, ‘rdpu’, ‘rdylbu’, ‘rdylgn’, ‘redor’, ‘reds’, ‘solar’, ‘spectral’, ‘speed’, ‘sunset’, ‘sunsetdark’, ‘teal’, ‘tealgrn’, ‘tealrose’, ‘tempo’, ‘temps’, ‘thermal’, ‘tropic’, ‘turbid’, ‘turbo’, ‘twilight’, ‘viridis’, ‘ylgn’, ‘ylgnbu’, ‘ylorbr’, ‘ylorrd’].
Appending ‘_r’ to a named colorscale reverses it.
- Returns
- Return type
-
property
sequentialminus
¶ Sets the default sequential colorscale for negative values. Note that
autocolorscale
must be true for this attribute to work.The ‘sequentialminus’ property is a colorscale and may be specified as:
A list of colors that will be spaced evenly to create the colorscale. Many predefined colorscale lists are included in the sequential, diverging, and cyclical modules in the plotly.colors package.
A list of 2-element lists where the first element is the normalized color level value (starting at 0 and ending at 1), and the second item is a valid color string. (e.g. [[0, ‘green’], [0.5, ‘red’], [1.0, ‘rgb(0, 0, 255)’]])
- One of the following named colorscales:
- [‘aggrnyl’, ‘agsunset’, ‘algae’, ‘amp’, ‘armyrose’, ‘balance’,
‘blackbody’, ‘bluered’, ‘blues’, ‘blugrn’, ‘bluyl’, ‘brbg’, ‘brwnyl’, ‘bugn’, ‘bupu’, ‘burg’, ‘burgyl’, ‘cividis’, ‘curl’, ‘darkmint’, ‘deep’, ‘delta’, ‘dense’, ‘earth’, ‘edge’, ‘electric’, ‘emrld’, ‘fall’, ‘geyser’, ‘gnbu’, ‘gray’, ‘greens’, ‘greys’, ‘haline’, ‘hot’, ‘hsv’, ‘ice’, ‘icefire’, ‘inferno’, ‘jet’, ‘magenta’, ‘magma’, ‘matter’, ‘mint’, ‘mrybm’, ‘mygbm’, ‘oranges’, ‘orrd’, ‘oryel’, ‘oxy’, ‘peach’, ‘phase’, ‘picnic’, ‘pinkyl’, ‘piyg’, ‘plasma’, ‘plotly3’, ‘portland’, ‘prgn’, ‘pubu’, ‘pubugn’, ‘puor’, ‘purd’, ‘purp’, ‘purples’, ‘purpor’, ‘rainbow’, ‘rdbu’, ‘rdgy’, ‘rdpu’, ‘rdylbu’, ‘rdylgn’, ‘redor’, ‘reds’, ‘solar’, ‘spectral’, ‘speed’, ‘sunset’, ‘sunsetdark’, ‘teal’, ‘tealgrn’, ‘tealrose’, ‘tempo’, ‘temps’, ‘thermal’, ‘tropic’, ‘turbid’, ‘turbo’, ‘twilight’, ‘viridis’, ‘ylgn’, ‘ylgnbu’, ‘ylorbr’, ‘ylorrd’].
Appending ‘_r’ to a named colorscale reverses it.
- Returns
- Return type
-
property
-
class
plotly.graph_objects.layout.
Font
(arg=None, color=None, family=None, lineposition=None, shadow=None, size=None, style=None, textcase=None, variant=None, weight=None, **kwargs)¶ -
property
color
¶ - The ‘color’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
family
¶ HTML 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 which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren’t available on the system. The Chart Studio Cloud (at https://chart- studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include “Arial”, “Balto”, “Courier New”, “Droid Sans”, “Droid Serif”, “Droid Sans Mono”, “Gravitas One”, “Old Standard TT”, “Open Sans”, “Overpass”, “PT Sans Narrow”, “Raleway”, “Times New Roman”.
- The ‘family’ property is a string and must be specified as:
A non-empty string
- Returns
- Return type
-
property
lineposition
¶ Sets the kind of decoration line(s) with text, such as an “under”, “over” or “through” as well as combinations e.g. “under+over”, etc.
The ‘lineposition’ property is a flaglist and may be specified as a string containing:
Any combination of [‘under’, ‘over’, ‘through’] joined with ‘+’ characters (e.g. ‘under+over’) OR exactly one of [‘none’] (e.g. ‘none’)
- Returns
- Return type
Any
-
property
shadow
¶ Sets the shape and color of the shadow behind text. “auto” places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en-US/docs/Web/CSS/text-shadow for additional options.
- The ‘shadow’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
size
¶ - The ‘size’ property is a number and may be specified as:
An int or float in the interval [1, inf]
- Returns
- Return type
int|float
-
property
style
¶ Sets whether a font should be styled with a normal or italic face from its family.
- The ‘style’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘normal’, ‘italic’]
- Returns
- Return type
Any
-
property
textcase
¶ Sets capitalization of text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized.
- The ‘textcase’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘normal’, ‘word caps’, ‘upper’, ‘lower’]
- Returns
- Return type
Any
-
property
variant
¶ Sets the variant of the font.
- The ‘variant’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘normal’, ‘small-caps’, ‘all-small-caps’, ‘all-petite-caps’, ‘petite-caps’, ‘unicase’]
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Geo
(arg=None, bgcolor=None, center=None, coastlinecolor=None, coastlinewidth=None, countrycolor=None, countrywidth=None, domain=None, fitbounds=None, framecolor=None, framewidth=None, lakecolor=None, landcolor=None, lataxis=None, lonaxis=None, oceancolor=None, projection=None, resolution=None, rivercolor=None, riverwidth=None, scope=None, showcoastlines=None, showcountries=None, showframe=None, showlakes=None, showland=None, showocean=None, showrivers=None, showsubunits=None, subunitcolor=None, subunitwidth=None, uirevision=None, visible=None, **kwargs)¶ -
property
bgcolor
¶ Set the background color of the map
- The ‘bgcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
center
¶ The ‘center’ property is an instance of Center that may be specified as:
An instance of
plotly.graph_objects.layout.geo.Center
A dict of string/value properties that will be passed to the Center constructor
Supported dict properties:
- lat
Sets the latitude of the map’s center. For all projection types, the map’s latitude center lies at the middle of the latitude range by default.
- lon
Sets the longitude of the map’s center. By default, the map’s longitude center lies at the middle of the longitude range for scoped projection and above
projection.rotation.lon
otherwise.
- Returns
- Return type
-
property
coastlinecolor
¶ Sets the coastline color.
- The ‘coastlinecolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
coastlinewidth
¶ Sets the coastline stroke width (in px).
- The ‘coastlinewidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
countrycolor
¶ Sets line color of the country boundaries.
- The ‘countrycolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
countrywidth
¶ Sets line width (in px) of the country boundaries.
- The ‘countrywidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
domain
¶ The ‘domain’ property is an instance of Domain that may be specified as:
An instance of
plotly.graph_objects.layout.geo.Domain
A dict of string/value properties that will be passed to the Domain constructor
Supported dict properties:
- column
If there is a layout grid, use the domain for this column in the grid for this geo subplot . Note that geo subplots are constrained by domain. In general, when
projection.scale
is set to 1. a map will fit either its x or y domain, but not both.- row
If there is a layout grid, use the domain for this row in the grid for this geo subplot . Note that geo subplots are constrained by domain. In general, when
projection.scale
is set to 1. a map will fit either its x or y domain, but not both.- x
Sets the horizontal domain of this geo subplot (in plot fraction). Note that geo subplots are constrained by domain. In general, when
projection.scale
is set to 1. a map will fit either its x or y domain, but not both.- y
Sets the vertical domain of this geo subplot (in plot fraction). Note that geo subplots are constrained by domain. In general, when
projection.scale
is set to 1. a map will fit either its x or y domain, but not both.
- Returns
- Return type
-
property
fitbounds
¶ Determines if this subplot’s view settings are auto-computed to fit trace data. On scoped maps, setting
fitbounds
leads tocenter.lon
andcenter.lat
getting auto-filled. On maps with a non-clipped projection, settingfitbounds
leads tocenter.lon
,center.lat
, andprojection.rotation.lon
getting auto-filled. On maps with a clipped projection, settingfitbounds
leads tocenter.lon
,center.lat
,projection.rotation.lon
,projection.rotation.lat
,lonaxis.range
andlonaxis.range
getting auto-filled. If “locations”, only the trace’s visible locations are considered in thefitbounds
computations. If “geojson”, the entire trace inputgeojson
(if provided) is considered in thefitbounds
computations, Defaults to False.- The ‘fitbounds’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[False, ‘locations’, ‘geojson’]
- Returns
- Return type
Any
-
property
framecolor
¶ Sets the color the frame.
- The ‘framecolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
framewidth
¶ Sets the stroke width (in px) of the frame.
- The ‘framewidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
lakecolor
¶ Sets the color of the lakes.
- The ‘lakecolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
landcolor
¶ Sets the land mass color.
- The ‘landcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
lataxis
¶ The ‘lataxis’ property is an instance of Lataxis that may be specified as:
An instance of
plotly.graph_objects.layout.geo.Lataxis
A dict of string/value properties that will be passed to the Lataxis constructor
Supported dict properties:
- dtick
Sets the graticule’s longitude/latitude tick step.
- gridcolor
Sets the graticule’s stroke color.
- griddash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- gridwidth
Sets the graticule’s stroke width (in px).
- range
Sets the range of this axis (in degrees), sets the map’s clipped coordinates.
- showgrid
Sets whether or not graticule are shown on the map.
- tick0
Sets the graticule’s starting tick longitude/latitude.
- Returns
- Return type
-
property
lonaxis
¶ The ‘lonaxis’ property is an instance of Lonaxis that may be specified as:
An instance of
plotly.graph_objects.layout.geo.Lonaxis
A dict of string/value properties that will be passed to the Lonaxis constructor
Supported dict properties:
- dtick
Sets the graticule’s longitude/latitude tick step.
- gridcolor
Sets the graticule’s stroke color.
- griddash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- gridwidth
Sets the graticule’s stroke width (in px).
- range
Sets the range of this axis (in degrees), sets the map’s clipped coordinates.
- showgrid
Sets whether or not graticule are shown on the map.
- tick0
Sets the graticule’s starting tick longitude/latitude.
- Returns
- Return type
-
property
oceancolor
¶ Sets the ocean color
- The ‘oceancolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
projection
¶ The ‘projection’ property is an instance of Projection that may be specified as:
An instance of
plotly.graph_objects.layout.geo.Projection
A dict of string/value properties that will be passed to the Projection constructor
Supported dict properties:
- distance
For satellite projection type only. Sets the distance from the center of the sphere to the point of view as a proportion of the sphere’s radius.
- parallels
For conic projection types only. Sets the parallels (tangent, secant) where the cone intersects the sphere.
- rotation
plotly.graph_objects.layout.geo.project ion.Rotation
instance or dict with compatible properties- scale
Zooms in or out on the map view. A scale of 1 corresponds to the largest zoom level that fits the map’s lon and lat ranges.
- tilt
For satellite projection type only. Sets the tilt angle of perspective projection.
- type
Sets the projection type.
- Returns
- Return type
-
property
resolution
¶ Sets the resolution of the base layers. The values have units of km/mm e.g. 110 corresponds to a scale ratio of 1:110,000,000.
- The ‘resolution’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[110, 50]
- Returns
- Return type
Any
-
property
rivercolor
¶ Sets color of the rivers.
- The ‘rivercolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
riverwidth
¶ Sets the stroke width (in px) of the rivers.
- The ‘riverwidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
scope
¶ Set the scope of the map.
- The ‘scope’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘africa’, ‘asia’, ‘europe’, ‘north america’, ‘south america’, ‘usa’, ‘world’]
- Returns
- Return type
Any
-
property
showcoastlines
¶ Sets whether or not the coastlines are drawn.
The ‘showcoastlines’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showcountries
¶ Sets whether or not country boundaries are drawn.
The ‘showcountries’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showframe
¶ Sets whether or not a frame is drawn around the map.
The ‘showframe’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showlakes
¶ Sets whether or not lakes are drawn.
The ‘showlakes’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showland
¶ Sets whether or not land masses are filled in color.
The ‘showland’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showocean
¶ Sets whether or not oceans are filled in color.
The ‘showocean’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showrivers
¶ Sets whether or not rivers are drawn.
The ‘showrivers’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showsubunits
¶ Sets whether or not boundaries of subunits within countries (e.g. states, provinces) are drawn.
The ‘showsubunits’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
subunitcolor
¶ Sets the color of the subunits boundaries.
- The ‘subunitcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
subunitwidth
¶ Sets the stroke width (in px) of the subunits boundaries.
- The ‘subunitwidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
uirevision
¶ Controls persistence of user-driven changes in the view (projection and center). Defaults to
layout.uirevision
.The ‘uirevision’ property accepts values of any type
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Grid
(arg=None, columns=None, domain=None, pattern=None, roworder=None, rows=None, subplots=None, xaxes=None, xgap=None, xside=None, yaxes=None, ygap=None, yside=None, **kwargs)¶ -
property
columns
¶ The number of columns in the grid. If you provide a 2D
subplots
array, the length of its longest row is used as the default. If you give anxaxes
array, its length is used as the default. But it’s also possible to have a different length, if you want to leave a row at the end for non-cartesian subplots.- The ‘columns’ property is a integer and may be specified as:
An int (or float that will be cast to an int) in the interval [1, 9223372036854775807]
- Returns
- Return type
-
property
domain
¶ The ‘domain’ property is an instance of Domain that may be specified as:
An instance of
plotly.graph_objects.layout.grid.Domain
A dict of string/value properties that will be passed to the Domain constructor
Supported dict properties:
- x
Sets the horizontal domain of this grid subplot (in plot fraction). The first and last cells end exactly at the domain edges, with no grout around the edges.
- y
Sets the vertical domain of this grid subplot (in plot fraction). The first and last cells end exactly at the domain edges, with no grout around the edges.
- Returns
- Return type
-
property
pattern
¶ If no
subplots
,xaxes
, oryaxes
are given but we do haverows
andcolumns
, we can generate defaults using consecutive axis IDs, in two ways: “coupled” gives one x axis per column and one y axis per row. “independent” uses a new xy pair for each cell, left-to-right across each row then iterating rows according toroworder
.- The ‘pattern’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘independent’, ‘coupled’]
- Returns
- Return type
Any
-
property
roworder
¶ Is the first row the top or the bottom? Note that columns are always enumerated from left to right.
- The ‘roworder’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘top to bottom’, ‘bottom to top’]
- Returns
- Return type
Any
-
property
rows
¶ The number of rows in the grid. If you provide a 2D
subplots
array or ayaxes
array, its length is used as the default. But it’s also possible to have a different length, if you want to leave a row at the end for non-cartesian subplots.- The ‘rows’ property is a integer and may be specified as:
An int (or float that will be cast to an int) in the interval [1, 9223372036854775807]
- Returns
- Return type
-
property
subplots
¶ Used for freeform grids, where some axes may be shared across subplots but others are not. Each entry should be a cartesian subplot id, like “xy” or “x3y2”, or “” to leave that cell empty. You may reuse x axes within the same column, and y axes within the same row. Non-cartesian subplots and traces that support
domain
can place themselves in this grid separately using thegridcell
attribute.The ‘subplots’ property is an info array that may be specified as: * a 2D list where:
The ‘subplots[i][j]’ property is an enumeration that may be specified as: - One of the following enumeration values:
[‘’]
- A string that matches one of the following regular expressions:
[‘^x([2-9]|[1-9][0-9]+)?y([2-9]|[1-9][0-9]+)?$’]
- Returns
- Return type
-
property
xaxes
¶ Used with
yaxes
when the x and y axes are shared across columns and rows. Each entry should be an x axis id like “x”, “x2”, etc., or “” to not put an x axis in that column. Entries other than “” must be unique. Ignored ifsubplots
is present. If missing butyaxes
is present, will generate consecutive IDs.The ‘xaxes’ property is an info array that may be specified as: * a list of elements where:
The ‘xaxes[i]’ property is an enumeration that may be specified as: - One of the following enumeration values:
[‘’]
- A string that matches one of the following regular expressions:
[‘^x([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
-
property
xgap
¶ Horizontal space between grid cells, expressed as a fraction of the total width available to one cell. Defaults to 0.1 for coupled-axes grids and 0.2 for independent grids.
- The ‘xgap’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
xside
¶ Sets where the x axis labels and titles go. “bottom” means the very bottom of the grid. “bottom plot” is the lowest plot that each x axis is used in. “top” and “top plot” are similar.
- The ‘xside’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘bottom’, ‘bottom plot’, ‘top plot’, ‘top’]
- Returns
- Return type
Any
-
property
yaxes
¶ Used with
yaxes
when the x and y axes are shared across columns and rows. Each entry should be an y axis id like “y”, “y2”, etc., or “” to not put a y axis in that row. Entries other than “” must be unique. Ignored ifsubplots
is present. If missing butxaxes
is present, will generate consecutive IDs.The ‘yaxes’ property is an info array that may be specified as: * a list of elements where:
The ‘yaxes[i]’ property is an enumeration that may be specified as: - One of the following enumeration values:
[‘’]
- A string that matches one of the following regular expressions:
[‘^y([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
-
property
ygap
¶ Vertical space between grid cells, expressed as a fraction of the total height available to one cell. Defaults to 0.1 for coupled-axes grids and 0.3 for independent grids.
- The ‘ygap’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
yside
¶ Sets where the y axis labels and titles go. “left” means the very left edge of the grid. left plot is the leftmost plot that each y axis is used in. “right” and right plot are similar.
- The ‘yside’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘left’, ‘left plot’, ‘right plot’, ‘right’]
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Hoverlabel
(arg=None, align=None, bgcolor=None, bordercolor=None, font=None, grouptitlefont=None, namelength=None, **kwargs)¶ -
property
align
¶ Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines
- The ‘align’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘left’, ‘right’, ‘auto’]
- Returns
- Return type
Any
-
property
bgcolor
¶ Sets the background color of all hover labels on graph
- The ‘bgcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
bordercolor
¶ Sets the border color of all hover labels on graph.
- The ‘bordercolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
font
¶ Sets the default hover label font used by all traces on the graph.
The ‘font’ property is an instance of Font that may be specified as:
An instance of
plotly.graph_objects.layout.hoverlabel.Font
A dict of string/value properties that will be passed to the Font constructor
Supported dict properties:
color
- family
HTML 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 which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren’t available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include “Arial”, “Balto”, “Courier New”, “Droid Sans”, “Droid Serif”, “Droid Sans Mono”, “Gravitas One”, “Old Standard TT”, “Open Sans”, “Overpass”, “PT Sans Narrow”, “Raleway”, “Times New Roman”.
- lineposition
Sets the kind of decoration line(s) with text, such as an “under”, “over” or “through” as well as combinations e.g. “under+over”, etc.
- shadow
Sets the shape and color of the shadow behind text. “auto” places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en- US/docs/Web/CSS/text-shadow for additional options.
size
- style
Sets whether a font should be styled with a normal or italic face from its family.
- textcase
Sets capitalization of text. It can be used to make text appear in all-uppercase or all- lowercase, or with each word capitalized.
- variant
Sets the variant of the font.
- weight
Sets the weight (or boldness) of the font.
- Returns
- Return type
-
property
grouptitlefont
¶ Sets the font for group titles in hover (unified modes). Defaults to
hoverlabel.font
.The ‘grouptitlefont’ property is an instance of Grouptitlefont that may be specified as:
An instance of
plotly.graph_objects.layout.hoverlabel.Grouptitlefont
A dict of string/value properties that will be passed to the Grouptitlefont constructor
Supported dict properties:
color
- family
HTML 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 which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren’t available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include “Arial”, “Balto”, “Courier New”, “Droid Sans”, “Droid Serif”, “Droid Sans Mono”, “Gravitas One”, “Old Standard TT”, “Open Sans”, “Overpass”, “PT Sans Narrow”, “Raleway”, “Times New Roman”.
- lineposition
Sets the kind of decoration line(s) with text, such as an “under”, “over” or “through” as well as combinations e.g. “under+over”, etc.
- shadow
Sets the shape and color of the shadow behind text. “auto” places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en- US/docs/Web/CSS/text-shadow for additional options.
size
- style
Sets whether a font should be styled with a normal or italic face from its family.
- textcase
Sets capitalization of text. It can be used to make text appear in all-uppercase or all- lowercase, or with each word capitalized.
- variant
Sets the variant of the font.
- weight
Sets the weight (or boldness) of the font.
- Returns
- Return type
-
property
namelength
¶ Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to
namelength - 3
characters and add an ellipsis.- The ‘namelength’ property is a integer and may be specified as:
An int (or float that will be cast to an int) in the interval [-1, 9223372036854775807]
- Returns
- Return type
-
property
-
class
plotly.graph_objects.layout.
Image
(arg=None, layer=None, name=None, opacity=None, sizex=None, sizey=None, sizing=None, source=None, templateitemname=None, visible=None, x=None, xanchor=None, xref=None, y=None, yanchor=None, yref=None, **kwargs)¶ -
property
layer
¶ Specifies whether images are drawn below or above traces. When
xref
andyref
are both set topaper
, image is drawn below the entire plot area.- The ‘layer’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘below’, ‘above’]
- Returns
- Return type
Any
-
property
name
¶ When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- The ‘name’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
opacity
¶ Sets the opacity of the image.
- The ‘opacity’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
sizex
¶ Sets the image container size horizontally. The image will be sized based on the
position
value. Whenxref
is set topaper
, units are sized relative to the plot width. Whenxref
ends with ` domain`, units are sized relative to the axis width.- The ‘sizex’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
sizey
¶ Sets the image container size vertically. The image will be sized based on the
position
value. Whenyref
is set topaper
, units are sized relative to the plot height. Whenyref
ends with ` domain`, units are sized relative to the axis height.- The ‘sizey’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
sizing
¶ Specifies which dimension of the image to constrain.
- The ‘sizing’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘fill’, ‘contain’, ‘stretch’]
- Returns
- Return type
Any
-
property
source
¶ Specifies the URL of the image to be used. The URL must be accessible from the domain where the plot code is run, and can be either relative or absolute.
- The ‘source’ property is an image URI that may be specified as:
A remote image URI string (e.g. ‘http://www.somewhere.com/image.png’)
A data URI image string (e.g. ‘data:image/png;base64,iVBORw0KGgoAAAANSU’)
A PIL.Image.Image object which will be immediately converted to a data URI image string See http://pillow.readthedocs.io/en/latest/reference/Image.html
- Returns
- Return type
-
property
templateitemname
¶ Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- The ‘templateitemname’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
visible
¶ Determines whether or not this image is visible.
The ‘visible’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
x
¶ Sets the image’s x position. When
xref
is set topaper
, units are sized relative to the plot height. Seexref
for more infoThe ‘x’ property accepts values of any type
- Returns
- Return type
Any
-
property
xanchor
¶ Sets the anchor for the x position
- The ‘xanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘left’, ‘center’, ‘right’]
- Returns
- Return type
Any
-
property
xref
¶ Sets the images’s x coordinate axis. If set to a x axis id (e.g. “x” or “x2”), the
x
position refers to a x coordinate. If set to “paper”, thex
position refers to the distance from the left of the plotting area in normalized coordinates where 0 (1) corresponds to the left (right). If set to a x axis ID followed by “domain” (separated by a space), the position behaves like for “paper”, but refers to the distance in fractions of the domain length from the left of the domain of that axis: e.g., x2 domain refers to the domain of the second x axis and a x position of 0.5 refers to the point between the left and the right of the domain of the second x axis.- The ‘xref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘paper’]
- A string that matches one of the following regular expressions:
[‘^x([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
y
¶ Sets the image’s y position. When
yref
is set topaper
, units are sized relative to the plot height. Seeyref
for more infoThe ‘y’ property accepts values of any type
- Returns
- Return type
Any
-
property
yanchor
¶ Sets the anchor for the y position.
- The ‘yanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘top’, ‘middle’, ‘bottom’]
- Returns
- Return type
Any
-
property
yref
¶ Sets the images’s y coordinate axis. If set to a y axis id (e.g. “y” or “y2”), the
y
position refers to a y coordinate. If set to “paper”, they
position refers to the distance from the bottom of the plotting area in normalized coordinates where 0 (1) corresponds to the bottom (top). If set to a y axis ID followed by “domain” (separated by a space), the position behaves like for “paper”, but refers to the distance in fractions of the domain length from the bottom of the domain of that axis: e.g., y2 domain refers to the domain of the second y axis and a y position of 0.5 refers to the point between the bottom and the top of the domain of the second y axis.- The ‘yref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘paper’]
- A string that matches one of the following regular expressions:
[‘^y([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Legend
(arg=None, bgcolor=None, bordercolor=None, borderwidth=None, entrywidth=None, entrywidthmode=None, font=None, groupclick=None, grouptitlefont=None, indentation=None, itemclick=None, itemdoubleclick=None, itemsizing=None, itemwidth=None, orientation=None, title=None, tracegroupgap=None, traceorder=None, uirevision=None, valign=None, visible=None, x=None, xanchor=None, xref=None, y=None, yanchor=None, yref=None, **kwargs)¶ -
property
bgcolor
¶ Sets the legend background color. Defaults to
layout.paper_bgcolor
.- The ‘bgcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
bordercolor
¶ Sets the color of the border enclosing the legend.
- The ‘bordercolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
borderwidth
¶ Sets the width (in px) of the border enclosing the legend.
- The ‘borderwidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
entrywidth
¶ Sets the width (in px or fraction) of the legend. Use 0 to size the entry based on the text width, when
entrywidthmode
is set to “pixels”.- The ‘entrywidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
entrywidthmode
¶ Determines what entrywidth means.
- The ‘entrywidthmode’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘fraction’, ‘pixels’]
- Returns
- Return type
Any
-
property
font
¶ Sets the font used to text the legend items.
The ‘font’ property is an instance of Font that may be specified as:
An instance of
plotly.graph_objects.layout.legend.Font
A dict of string/value properties that will be passed to the Font constructor
Supported dict properties:
color
- family
HTML 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 which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren’t available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include “Arial”, “Balto”, “Courier New”, “Droid Sans”, “Droid Serif”, “Droid Sans Mono”, “Gravitas One”, “Old Standard TT”, “Open Sans”, “Overpass”, “PT Sans Narrow”, “Raleway”, “Times New Roman”.
- lineposition
Sets the kind of decoration line(s) with text, such as an “under”, “over” or “through” as well as combinations e.g. “under+over”, etc.
- shadow
Sets the shape and color of the shadow behind text. “auto” places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en- US/docs/Web/CSS/text-shadow for additional options.
size
- style
Sets whether a font should be styled with a normal or italic face from its family.
- textcase
Sets capitalization of text. It can be used to make text appear in all-uppercase or all- lowercase, or with each word capitalized.
- variant
Sets the variant of the font.
- weight
Sets the weight (or boldness) of the font.
- Returns
- Return type
-
property
groupclick
¶ Determines the behavior on legend group item click. “toggleitem” toggles the visibility of the individual item clicked on the graph. “togglegroup” toggles the visibility of all items in the same legendgroup as the item clicked on the graph.
- The ‘groupclick’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘toggleitem’, ‘togglegroup’]
- Returns
- Return type
Any
-
property
grouptitlefont
¶ Sets the font for group titles in legend. Defaults to
legend.font
with its size increased about 10%.The ‘grouptitlefont’ property is an instance of Grouptitlefont that may be specified as:
An instance of
plotly.graph_objects.layout.legend.Grouptitlefont
A dict of string/value properties that will be passed to the Grouptitlefont constructor
Supported dict properties:
color
- family
HTML 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 which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren’t available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include “Arial”, “Balto”, “Courier New”, “Droid Sans”, “Droid Serif”, “Droid Sans Mono”, “Gravitas One”, “Old Standard TT”, “Open Sans”, “Overpass”, “PT Sans Narrow”, “Raleway”, “Times New Roman”.
- lineposition
Sets the kind of decoration line(s) with text, such as an “under”, “over” or “through” as well as combinations e.g. “under+over”, etc.
- shadow
Sets the shape and color of the shadow behind text. “auto” places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en- US/docs/Web/CSS/text-shadow for additional options.
size
- style
Sets whether a font should be styled with a normal or italic face from its family.
- textcase
Sets capitalization of text. It can be used to make text appear in all-uppercase or all- lowercase, or with each word capitalized.
- variant
Sets the variant of the font.
- weight
Sets the weight (or boldness) of the font.
- Returns
- Return type
-
property
indentation
¶ Sets the indentation (in px) of the legend entries.
- The ‘indentation’ property is a number and may be specified as:
An int or float in the interval [-15, inf]
- Returns
- Return type
int|float
-
property
itemclick
¶ Determines the behavior on legend item click. “toggle” toggles the visibility of the item clicked on the graph. “toggleothers” makes the clicked item the sole visible item on the graph. False disables legend item click interactions.
- The ‘itemclick’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘toggle’, ‘toggleothers’, False]
- Returns
- Return type
Any
-
property
itemdoubleclick
¶ Determines the behavior on legend item double-click. “toggle” toggles the visibility of the item clicked on the graph. “toggleothers” makes the clicked item the sole visible item on the graph. False disables legend item double-click interactions.
- The ‘itemdoubleclick’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘toggle’, ‘toggleothers’, False]
- Returns
- Return type
Any
-
property
itemsizing
¶ Determines if the legend items symbols scale with their corresponding “trace” attributes or remain “constant” independent of the symbol size on the graph.
- The ‘itemsizing’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘trace’, ‘constant’]
- Returns
- Return type
Any
-
property
itemwidth
¶ Sets the width (in px) of the legend item symbols (the part other than the title.text).
- The ‘itemwidth’ property is a number and may be specified as:
An int or float in the interval [30, inf]
- Returns
- Return type
int|float
-
property
orientation
¶ Sets the orientation of the legend.
- The ‘orientation’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘v’, ‘h’]
- Returns
- Return type
Any
-
property
title
¶ The ‘title’ property is an instance of Title that may be specified as:
An instance of
plotly.graph_objects.layout.legend.Title
A dict of string/value properties that will be passed to the Title constructor
Supported dict properties:
- font
Sets this legend’s title font. Defaults to
legend.font
with its size increased about 20%.- side
Determines the location of legend’s title with respect to the legend items. Defaulted to “top” with
orientation
is “h”. Defaulted to “left” withorientation
is “v”. The top left options could be used to expand top center and top right are for horizontal alignment legend area in both x and y sides.- text
Sets the title of the legend.
- Returns
- Return type
-
property
tracegroupgap
¶ Sets the amount of vertical space (in px) between legend groups.
- The ‘tracegroupgap’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
traceorder
¶ Determines the order at which the legend items are displayed. If “normal”, the items are displayed top-to-bottom in the same order as the input data. If “reversed”, the items are displayed in the opposite order as “normal”. If “grouped”, the items are displayed in groups (when a trace
legendgroup
is provided). if “grouped+reversed”, the items are displayed in the opposite order as “grouped”.The ‘traceorder’ property is a flaglist and may be specified as a string containing:
Any combination of [‘reversed’, ‘grouped’] joined with ‘+’ characters (e.g. ‘reversed+grouped’) OR exactly one of [‘normal’] (e.g. ‘normal’)
- Returns
- Return type
Any
-
property
uirevision
¶ Controls persistence of legend-driven changes in trace and pie label visibility. Defaults to
layout.uirevision
.The ‘uirevision’ property accepts values of any type
- Returns
- Return type
Any
-
property
valign
¶ Sets the vertical alignment of the symbols with respect to their associated text.
- The ‘valign’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘top’, ‘middle’, ‘bottom’]
- Returns
- Return type
Any
-
property
visible
¶ Determines whether or not this legend is visible.
The ‘visible’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
x
¶ Sets the x position with respect to
xref
(in normalized coordinates) of the legend. Whenxref
is “paper”, defaults to 1.02 for vertical legends and defaults to 0 for horizontal legends. Whenxref
is “container”, defaults to 1 for vertical legends and defaults to 0 for horizontal legends. Must be between 0 and 1 ifxref
is “container”. and between “-2” and 3 ifxref
is “paper”.- The ‘x’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
xanchor
¶ Sets the legend’s horizontal position anchor. This anchor binds the
x
position to the “left”, “center” or “right” of the legend. Value “auto” anchors legends to the right forx
values greater than or equal to 2/3, anchors legends to the left forx
values less than or equal to 1/3 and anchors legends with respect to their center otherwise.- The ‘xanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘auto’, ‘left’, ‘center’, ‘right’]
- Returns
- Return type
Any
-
property
xref
¶ Sets the container
x
refers to. “container” spans the entirewidth
of the plot. “paper” refers to the width of the plotting area only.- The ‘xref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘container’, ‘paper’]
- Returns
- Return type
Any
-
property
y
¶ Sets the y position with respect to
yref
(in normalized coordinates) of the legend. Whenyref
is “paper”, defaults to 1 for vertical legends, defaults to “-0.1” for horizontal legends on graphs w/o range sliders and defaults to 1.1 for horizontal legends on graph with one or multiple range sliders. Whenyref
is “container”, defaults to 1. Must be between 0 and 1 ifyref
is “container” and between “-2” and 3 ifyref
is “paper”.- The ‘y’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
yanchor
¶ Sets the legend’s vertical position anchor This anchor binds the
y
position to the “top”, “middle” or “bottom” of the legend. Value “auto” anchors legends at their bottom fory
values less than or equal to 1/3, anchors legends to at their top fory
values greater than or equal to 2/3 and anchors legends with respect to their middle otherwise.- The ‘yanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘auto’, ‘top’, ‘middle’, ‘bottom’]
- Returns
- Return type
Any
-
property
yref
¶ Sets the container
y
refers to. “container” spans the entireheight
of the plot. “paper” refers to the height of the plotting area only.- The ‘yref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘container’, ‘paper’]
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Map
(arg=None, bearing=None, bounds=None, center=None, domain=None, layers=None, layerdefaults=None, pitch=None, style=None, uirevision=None, zoom=None, **kwargs)¶ -
property
bearing
¶ Sets the bearing angle of the map in degrees counter-clockwise from North (map.bearing).
- The ‘bearing’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
bounds
¶ The ‘bounds’ property is an instance of Bounds that may be specified as:
An instance of
plotly.graph_objects.layout.map.Bounds
A dict of string/value properties that will be passed to the Bounds constructor
Supported dict properties:
- east
Sets the maximum longitude of the map (in degrees East) if
west
,south
andnorth
are declared.- north
Sets the maximum latitude of the map (in degrees North) if
east
,west
andsouth
are declared.- south
Sets the minimum latitude of the map (in degrees North) if
east
,west
andnorth
are declared.- west
Sets the minimum longitude of the map (in degrees East) if
east
,south
andnorth
are declared.
- Returns
- Return type
-
property
center
¶ The ‘center’ property is an instance of Center that may be specified as:
An instance of
plotly.graph_objects.layout.map.Center
A dict of string/value properties that will be passed to the Center constructor
Supported dict properties:
- lat
Sets the latitude of the center of the map (in degrees North).
- lon
Sets the longitude of the center of the map (in degrees East).
- Returns
- Return type
-
property
domain
¶ The ‘domain’ property is an instance of Domain that may be specified as:
An instance of
plotly.graph_objects.layout.map.Domain
A dict of string/value properties that will be passed to the Domain constructor
Supported dict properties:
- column
If there is a layout grid, use the domain for this column in the grid for this map subplot .
- row
If there is a layout grid, use the domain for this row in the grid for this map subplot .
- x
Sets the horizontal domain of this map subplot (in plot fraction).
- y
Sets the vertical domain of this map subplot (in plot fraction).
- Returns
- Return type
-
property
layerdefaults
¶ When used in a template (as layout.template.layout.map.layerdefaults), sets the default property values to use for elements of layout.map.layers
The ‘layerdefaults’ property is an instance of Layer that may be specified as:
An instance of
plotly.graph_objects.layout.map.Layer
A dict of string/value properties that will be passed to the Layer constructor
Supported dict properties:
- Returns
- Return type
-
property
layers
¶ The ‘layers’ property is a tuple of instances of Layer that may be specified as:
A list or tuple of instances of plotly.graph_objects.layout.map.Layer
A list or tuple of dicts of string/value properties that will be passed to the Layer constructor
Supported dict properties:
- below
Determines if the layer will be inserted before the layer with the specified ID. If omitted or set to ‘’, the layer will be inserted above every existing layer.
- circle
plotly.graph_objects.layout.map.layer.C ircle
instance or dict with compatible properties- color
Sets the primary layer color. If
type
is “circle”, color corresponds to the circle color (map.layer.paint.circle-color) Iftype
is “line”, color corresponds to the line color (map.layer.paint.line-color) Iftype
is “fill”, color corresponds to the fill color (map.layer.paint.fill-color) Iftype
is “symbol”, color corresponds to the icon color (map.layer.paint.icon-color)- coordinates
Sets the coordinates array contains [longitude, latitude] pairs for the image corners listed in clockwise order: top left, top right, bottom right, bottom left. Only has an effect for “image”
sourcetype
.- fill
plotly.graph_objects.layout.map.layer.F ill
instance or dict with compatible properties- line
plotly.graph_objects.layout.map.layer.L ine
instance or dict with compatible properties- maxzoom
Sets the maximum zoom level (map.layer.maxzoom). At zoom levels equal to or greater than the maxzoom, the layer will be hidden.
- minzoom
Sets the minimum zoom level (map.layer.minzoom). At zoom levels less than the minzoom, the layer will be hidden.
- name
When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- opacity
Sets the opacity of the layer. If
type
is “circle”, opacity corresponds to the circle opacity (map.layer.paint.circle-opacity) Iftype
is “line”, opacity corresponds to the line opacity (map.layer.paint.line-opacity) Iftype
is “fill”, opacity corresponds to the fill opacity (map.layer.paint.fill-opacity) Iftype
is “symbol”, opacity corresponds to the icon/text opacity (map.layer.paint.text- opacity)- source
Sets the source data for this layer (map.layer.source). When
sourcetype
is set to “geojson”,source
can be a URL to a GeoJSON or a GeoJSON object. Whensourcetype
is set to “vector” or “raster”,source
can be a URL or an array of tile URLs. Whensourcetype
is set to “image”,source
can be a URL to an image.- sourceattribution
Sets the attribution for this source.
- sourcelayer
Specifies the layer to use from a vector tile source (map.layer.source-layer). Required for “vector” source type that supports multiple layers.
- sourcetype
Sets the source type for this layer, that is the type of the layer data.
- symbol
plotly.graph_objects.layout.map.layer.S ymbol
instance or dict with compatible properties- templateitemname
Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- type
Sets the layer type, that is the how the layer data set in
source
will be rendered Withsourcetype
set to “geojson”, the following values are allowed: “circle”, “line”, “fill” and “symbol”. but note that “line” and “fill” are not compatible with Point GeoJSON geometries. Withsourcetype
set to “vector”, the following values are allowed: “circle”, “line”, “fill” and “symbol”. Withsourcetype
set to “raster” or*image*
, only the “raster” value is allowed.- visible
Determines whether this layer is displayed
- Returns
- Return type
-
property
pitch
¶ Sets the pitch angle of the map (in degrees, where 0 means perpendicular to the surface of the map) (map.pitch).
- The ‘pitch’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
style
¶ Defines the map layers that are rendered by default below the trace layers defined in
data
, which are themselves by default rendered below the layers defined inlayout.map.layers
. These layers can be defined either explicitly as a Map Style object which can contain multiple layer definitions that load data from any public or private Tile Map Service (TMS or XYZ) or Web Map Service (WMS) or implicitly by using one of the built-in style objects which use WMSes or by using a custom style URL Map Style objects are of the form described in the MapLibre GL JS documentation available at https://maplibre.org/maplibre-style-spec/ The built-in plotly.js styles objects are: basic, carto-darkmatter, carto- darkmatter-nolabels, carto-positron, carto-positron-nolabels, carto-voyager, carto-voyager-nolabels, dark, light, open- street-map, outdoors, satellite, satellite-streets, streets, white-bg.The ‘style’ property accepts values of any type
- Returns
- Return type
Any
-
property
uirevision
¶ Controls persistence of user-driven changes in the view:
center
,zoom
,bearing
,pitch
. Defaults tolayout.uirevision
.The ‘uirevision’ property accepts values of any type
- Returns
- Return type
Any
-
property
zoom
¶ Sets the zoom level of the map (map.zoom).
- The ‘zoom’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
-
class
plotly.graph_objects.layout.
Mapbox
(arg=None, accesstoken=None, bearing=None, bounds=None, center=None, domain=None, layers=None, layerdefaults=None, pitch=None, style=None, uirevision=None, zoom=None, **kwargs)¶ -
property
accesstoken
¶ Sets the mapbox access token to be used for this mapbox map. Alternatively, the mapbox access token can be set in the configuration options under
mapboxAccessToken
. Note that accessToken are only required whenstyle
(e.g with values : basic, streets, outdoors, light, dark, satellite, satellite- streets ) and/or a layout layer references the Mapbox server.- The ‘accesstoken’ property is a string and must be specified as:
A non-empty string
- Returns
- Return type
-
property
bearing
¶ Sets the bearing angle of the map in degrees counter-clockwise from North (mapbox.bearing).
- The ‘bearing’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
bounds
¶ The ‘bounds’ property is an instance of Bounds that may be specified as:
An instance of
plotly.graph_objects.layout.mapbox.Bounds
A dict of string/value properties that will be passed to the Bounds constructor
Supported dict properties:
- east
Sets the maximum longitude of the map (in degrees East) if
west
,south
andnorth
are declared.- north
Sets the maximum latitude of the map (in degrees North) if
east
,west
andsouth
are declared.- south
Sets the minimum latitude of the map (in degrees North) if
east
,west
andnorth
are declared.- west
Sets the minimum longitude of the map (in degrees East) if
east
,south
andnorth
are declared.
- Returns
- Return type
-
property
center
¶ The ‘center’ property is an instance of Center that may be specified as:
An instance of
plotly.graph_objects.layout.mapbox.Center
A dict of string/value properties that will be passed to the Center constructor
Supported dict properties:
- lat
Sets the latitude of the center of the map (in degrees North).
- lon
Sets the longitude of the center of the map (in degrees East).
- Returns
- Return type
-
property
domain
¶ The ‘domain’ property is an instance of Domain that may be specified as:
An instance of
plotly.graph_objects.layout.mapbox.Domain
A dict of string/value properties that will be passed to the Domain constructor
Supported dict properties:
- column
If there is a layout grid, use the domain for this column in the grid for this mapbox subplot .
- row
If there is a layout grid, use the domain for this row in the grid for this mapbox subplot .
- x
Sets the horizontal domain of this mapbox subplot (in plot fraction).
- y
Sets the vertical domain of this mapbox subplot (in plot fraction).
- Returns
- Return type
-
property
layerdefaults
¶ When used in a template (as layout.template.layout.mapbox.layerdefaults), sets the default property values to use for elements of layout.mapbox.layers
The ‘layerdefaults’ property is an instance of Layer that may be specified as:
An instance of
plotly.graph_objects.layout.mapbox.Layer
A dict of string/value properties that will be passed to the Layer constructor
Supported dict properties:
- Returns
- Return type
-
property
layers
¶ The ‘layers’ property is a tuple of instances of Layer that may be specified as:
A list or tuple of instances of plotly.graph_objects.layout.mapbox.Layer
A list or tuple of dicts of string/value properties that will be passed to the Layer constructor
Supported dict properties:
- below
Determines if the layer will be inserted before the layer with the specified ID. If omitted or set to ‘’, the layer will be inserted above every existing layer.
- circle
plotly.graph_objects.layout.mapbox.laye r.Circle
instance or dict with compatible properties- color
Sets the primary layer color. If
type
is “circle”, color corresponds to the circle color (mapbox.layer.paint.circle-color) Iftype
is “line”, color corresponds to the line color (mapbox.layer.paint.line-color) Iftype
is “fill”, color corresponds to the fill color (mapbox.layer.paint.fill-color) Iftype
is “symbol”, color corresponds to the icon color (mapbox.layer.paint.icon-color)- coordinates
Sets the coordinates array contains [longitude, latitude] pairs for the image corners listed in clockwise order: top left, top right, bottom right, bottom left. Only has an effect for “image”
sourcetype
.- fill
plotly.graph_objects.layout.mapbox.laye r.Fill
instance or dict with compatible properties- line
plotly.graph_objects.layout.mapbox.laye r.Line
instance or dict with compatible properties- maxzoom
Sets the maximum zoom level (mapbox.layer.maxzoom). At zoom levels equal to or greater than the maxzoom, the layer will be hidden.
- minzoom
Sets the minimum zoom level (mapbox.layer.minzoom). At zoom levels less than the minzoom, the layer will be hidden.
- name
When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- opacity
Sets the opacity of the layer. If
type
is “circle”, opacity corresponds to the circle opacity (mapbox.layer.paint.circle-opacity) Iftype
is “line”, opacity corresponds to the line opacity (mapbox.layer.paint.line-opacity) Iftype
is “fill”, opacity corresponds to the fill opacity (mapbox.layer.paint.fill-opacity) Iftype
is “symbol”, opacity corresponds to the icon/text opacity (mapbox.layer.paint.text- opacity)- source
Sets the source data for this layer (mapbox.layer.source). When
sourcetype
is set to “geojson”,source
can be a URL to a GeoJSON or a GeoJSON object. Whensourcetype
is set to “vector” or “raster”,source
can be a URL or an array of tile URLs. Whensourcetype
is set to “image”,source
can be a URL to an image.- sourceattribution
Sets the attribution for this source.
- sourcelayer
Specifies the layer to use from a vector tile source (mapbox.layer.source-layer). Required for “vector” source type that supports multiple layers.
- sourcetype
Sets the source type for this layer, that is the type of the layer data.
- symbol
plotly.graph_objects.layout.mapbox.laye r.Symbol
instance or dict with compatible properties- templateitemname
Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- type
Sets the layer type, that is the how the layer data set in
source
will be rendered Withsourcetype
set to “geojson”, the following values are allowed: “circle”, “line”, “fill” and “symbol”. but note that “line” and “fill” are not compatible with Point GeoJSON geometries. Withsourcetype
set to “vector”, the following values are allowed: “circle”, “line”, “fill” and “symbol”. Withsourcetype
set to “raster” or*image*
, only the “raster” value is allowed.- visible
Determines whether this layer is displayed
- Returns
- Return type
-
property
pitch
¶ Sets the pitch angle of the map (in degrees, where 0 means perpendicular to the surface of the map) (mapbox.pitch).
- The ‘pitch’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
style
¶ Defines the map layers that are rendered by default below the trace layers defined in
data
, which are themselves by default rendered below the layers defined inlayout.mapbox.layers
. These layers can be defined either explicitly as a Mapbox Style object which can contain multiple layer definitions that load data from any public or private Tile Map Service (TMS or XYZ) or Web Map Service (WMS) or implicitly by using one of the built-in style objects which use WMSes which do not require any access tokens, or by using a default Mapbox style or custom Mapbox style URL, both of which require a Mapbox access token Note that Mapbox access token can be set in theaccesstoken
attribute or in themapboxAccessToken
config option. Mapbox Style objects are of the form described in the Mapbox GL JS documentation available at https://docs.mapbox.com/mapbox-gl- js/style-spec The built-in plotly.js styles objects are: carto-darkmatter, carto-positron, open-street-map, stamen- terrain, stamen-toner, stamen-watercolor, white-bg The built- in Mapbox styles are: basic, streets, outdoors, light, dark, satellite, satellite-streets Mapbox style URLs are of the form: mapbox://mapbox.mapbox-<name>-<version>The ‘style’ property accepts values of any type
- Returns
- Return type
Any
-
property
uirevision
¶ Controls persistence of user-driven changes in the view:
center
,zoom
,bearing
,pitch
. Defaults tolayout.uirevision
.The ‘uirevision’ property accepts values of any type
- Returns
- Return type
Any
-
property
zoom
¶ Sets the zoom level of the map (mapbox.zoom).
- The ‘zoom’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
-
class
plotly.graph_objects.layout.
Margin
(arg=None, autoexpand=None, b=None, l=None, pad=None, r=None, t=None, **kwargs)¶ -
property
autoexpand
¶ Turns on/off margin expansion computations. Legends, colorbars, updatemenus, sliders, axis rangeselector and rangeslider are allowed to push the margins by defaults.
The ‘autoexpand’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
b
¶ Sets the bottom margin (in px).
- The ‘b’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
l
¶ Sets the left margin (in px).
- The ‘l’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
pad
¶ Sets the amount of padding (in px) between the plotting area and the axis lines
- The ‘pad’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
r
¶ Sets the right margin (in px).
- The ‘r’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
t
¶ Sets the top margin (in px).
- The ‘t’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
-
class
plotly.graph_objects.layout.
Modebar
(arg=None, activecolor=None, add=None, addsrc=None, bgcolor=None, color=None, orientation=None, remove=None, removesrc=None, uirevision=None, **kwargs)¶ -
property
activecolor
¶ Sets the color of the active or hovered on icons in the modebar.
- The ‘activecolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
add
¶ Determines which predefined modebar buttons to add. Please note that these buttons will only be shown if they are compatible with all trace types used in a graph. Similar to
config.modeBarButtonsToAdd
option. This may include “v1hovermode”, “hoverclosest”, “hovercompare”, “togglehover”, “togglespikelines”, “drawline”, “drawopenpath”, “drawclosedpath”, “drawcircle”, “drawrect”, “eraseshape”.- The ‘add’ property is a string and must be specified as:
A string
A number that will be converted to a string
A tuple, list, or one-dimensional numpy array of the above
- Returns
- Return type
str|numpy.ndarray
-
property
addsrc
¶ Sets the source reference on Chart Studio Cloud for
add
.The ‘addsrc’ property must be specified as a string or as a plotly.grid_objs.Column object
- Returns
- Return type
-
property
bgcolor
¶ Sets the background color of the modebar.
- The ‘bgcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
color
¶ Sets the color of the icons in the modebar.
- The ‘color’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
orientation
¶ Sets the orientation of the modebar.
- The ‘orientation’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘v’, ‘h’]
- Returns
- Return type
Any
-
property
remove
¶ Determines which predefined modebar buttons to remove. Similar to
config.modeBarButtonsToRemove
option. This may include “autoScale2d”, “autoscale”, “editInChartStudio”, “editinchartstudio”, “hoverCompareCartesian”, “hovercompare”, “lasso”, “lasso2d”, “orbitRotation”, “orbitrotation”, “pan”, “pan2d”, “pan3d”, “reset”, “resetCameraDefault3d”, “resetCameraLastSave3d”, “resetGeo”, “resetSankeyGroup”, “resetScale2d”, “resetViewMap”, “resetViewMapbox”, “resetViews”, “resetcameradefault”, “resetcameralastsave”, “resetsankeygroup”, “resetscale”, “resetview”, “resetviews”, “select”, “select2d”, “sendDataToCloud”, “senddatatocloud”, “tableRotation”, “tablerotation”, “toImage”, “toggleHover”, “toggleSpikelines”, “togglehover”, “togglespikelines”, “toimage”, “zoom”, “zoom2d”, “zoom3d”, “zoomIn2d”, “zoomInGeo”, “zoomInMap”, “zoomInMapbox”, “zoomOut2d”, “zoomOutGeo”, “zoomOutMap”, “zoomOutMapbox”, “zoomin”, “zoomout”.- The ‘remove’ property is a string and must be specified as:
A string
A number that will be converted to a string
A tuple, list, or one-dimensional numpy array of the above
- Returns
- Return type
str|numpy.ndarray
-
property
removesrc
¶ Sets the source reference on Chart Studio Cloud for
remove
.The ‘removesrc’ property must be specified as a string or as a plotly.grid_objs.Column object
- Returns
- Return type
-
property
uirevision
¶ Controls persistence of user-driven changes related to the modebar, including
hovermode
,dragmode
, andshowspikes
at both the root level and inside subplots. Defaults tolayout.uirevision
.The ‘uirevision’ property accepts values of any type
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Newselection
(arg=None, line=None, mode=None, **kwargs)¶ -
property
line
¶ The ‘line’ property is an instance of Line that may be specified as:
An instance of
plotly.graph_objects.layout.newselection.Line
A dict of string/value properties that will be passed to the Line constructor
Supported dict properties:
- color
Sets the line color. By default uses either dark grey or white to increase contrast with background color.
- dash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- width
Sets the line width (in px).
- Returns
- Return type
-
property
mode
¶ Describes how a new selection is created. If
immediate
, a new selection is created after first mouse up. Ifgradual
, a new selection is not created after first mouse. By adding to and subtracting from the initial selection, this option allows declaring extra outlines of the selection.- The ‘mode’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘immediate’, ‘gradual’]
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Newshape
(arg=None, drawdirection=None, fillcolor=None, fillrule=None, label=None, layer=None, legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, legendwidth=None, line=None, name=None, opacity=None, showlegend=None, visible=None, **kwargs)¶ -
property
drawdirection
¶ When
dragmode
is set to “drawrect”, “drawline” or “drawcircle” this limits the drag to be horizontal, vertical or diagonal. Using “diagonal” there is no limit e.g. in drawing lines in any direction. “ortho” limits the draw to be either horizontal or vertical. “horizontal” allows horizontal extend. “vertical” allows vertical extend.- The ‘drawdirection’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘ortho’, ‘horizontal’, ‘vertical’, ‘diagonal’]
- Returns
- Return type
Any
-
property
fillcolor
¶ Sets the color filling new shapes’ interior. Please note that if using a fillcolor with alpha greater than half, drag inside the active shape starts moving the shape underneath, otherwise a new shape could be started over.
- The ‘fillcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
fillrule
¶ Determines the path’s interior. For more info please visit https://developer.mozilla.org/en- US/docs/Web/SVG/Attribute/fill-rule
- The ‘fillrule’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘evenodd’, ‘nonzero’]
- Returns
- Return type
Any
-
property
label
¶ The ‘label’ property is an instance of Label that may be specified as:
An instance of
plotly.graph_objects.layout.newshape.Label
A dict of string/value properties that will be passed to the Label constructor
Supported dict properties:
- font
Sets the new shape label text font.
- padding
Sets padding (in px) between edge of label and edge of new shape.
- text
Sets the text to display with the new shape. It is also used for legend item if
name
is not provided.- textangle
Sets the angle at which the label text is drawn with respect to the horizontal. For lines, angle “auto” is the same angle as the line. For all other shapes, angle “auto” is horizontal.
- textposition
Sets the position of the label text relative to the new shape. Supported values for rectangles, circles and paths are top left, top center, top right, middle left, middle center, middle right, bottom left, bottom center, and bottom right. Supported values for lines are “start”, “middle”, and “end”. Default: middle center for rectangles, circles, and paths; “middle” for lines.
- texttemplate
Template string used for rendering the new shape’s label. Note that this will override
text
. Variables are inserted using %{variable}, for example “x0: %{x0}”. Numbers are formatted using d3-format’s syntax %{variable:d3-format}, for example “Price: %{x0:$.2f}”. See https://github.com/d3/d3- format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format’s syntax %{variable|d3-time- format}, for example “Day: %{x0|%m %b %Y}”. See https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format for details on the date formatting syntax. A single multiplication or division operation may be applied to numeric variables, and combined with d3 number formatting, for example “Length in cm: %{x0*2.54}”, “%{slope*60:.1f} meters per second.” For log axes, variable values are given in log units. For date axes, x/y coordinate variables and center variables use datetimes, while all other variable values use values in ms. Finally, the template string has access to variablesx0
,x1
,y0
,y1
,slope
,dx
,dy
,width
,height
,length
,xcenter
andycenter
.- xanchor
Sets the label’s horizontal position anchor This anchor binds the specified
textposition
to the “left”, “center” or “right” of the label text. For example, iftextposition
is set to top right andxanchor
to “right” then the right-most portion of the label text lines up with the right-most edge of the new shape.- yanchor
Sets the label’s vertical position anchor This anchor binds the specified
textposition
to the “top”, “middle” or “bottom” of the label text. For example, iftextposition
is set to top right andyanchor
to “top” then the top-most portion of the label text lines up with the top-most edge of the new shape.
- Returns
- Return type
-
property
layer
¶ Specifies whether new shapes are drawn below gridlines (“below”), between gridlines and traces (“between”) or above traces (“above”).
- The ‘layer’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘below’, ‘above’, ‘between’]
- Returns
- Return type
Any
-
property
legend
¶ Sets the reference to a legend to show new shape in. References to these legends are “legend”, “legend2”, “legend3”, etc. Settings for these legends are set in the layout, under
layout.legend
,layout.legend2
, etc.The ‘legend’ property is an identifier of a particular subplot, of type ‘legend’, that may be specified as the string ‘legend’ optionally followed by an integer >= 1 (e.g. ‘legend’, ‘legend1’, ‘legend2’, ‘legend3’, etc.)
- Returns
- Return type
-
property
legendgroup
¶ Sets the legend group for new shape. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
- The ‘legendgroup’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
legendgrouptitle
¶ The ‘legendgrouptitle’ property is an instance of Legendgrouptitle that may be specified as:
An instance of
plotly.graph_objects.layout.newshape.Legendgrouptitle
A dict of string/value properties that will be passed to the Legendgrouptitle constructor
Supported dict properties:
- font
Sets this legend group’s title font.
- text
Sets the title of the legend group.
- Returns
- Return type
-
property
legendrank
¶ Sets the legend rank for new shape. Items and groups with smaller ranks are presented on top/left side while with “reversed”
legend.traceorder
they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items.- The ‘legendrank’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
legendwidth
¶ Sets the width (in px or fraction) of the legend for new shape.
- The ‘legendwidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
line
¶ The ‘line’ property is an instance of Line that may be specified as:
An instance of
plotly.graph_objects.layout.newshape.Line
A dict of string/value properties that will be passed to the Line constructor
Supported dict properties:
- color
Sets the line color. By default uses either dark grey or white to increase contrast with background color.
- dash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- width
Sets the line width (in px).
- Returns
- Return type
-
property
name
¶ Sets new shape name. The name appears as the legend item.
- The ‘name’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
opacity
¶ Sets the opacity of new shapes.
- The ‘opacity’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
showlegend
¶ Determines whether or not new shape is shown in the legend.
The ‘showlegend’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
visible
¶ Determines whether or not new shape is visible. If “legendonly”, the shape is not drawn, but can appear as a legend item (provided that the legend itself is visible).
- The ‘visible’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[True, False, ‘legendonly’]
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Polar
(arg=None, angularaxis=None, bargap=None, barmode=None, bgcolor=None, domain=None, gridshape=None, hole=None, radialaxis=None, sector=None, uirevision=None, **kwargs)¶ -
property
angularaxis
¶ The ‘angularaxis’ property is an instance of AngularAxis that may be specified as:
An instance of
plotly.graph_objects.layout.polar.AngularAxis
A dict of string/value properties that will be passed to the AngularAxis constructor
Supported dict properties:
- autotypenumbers
Using “strict” a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis
type
detection. Defaults to layout.autotypenumbers.- categoryarray
Sets the order in which categories on this axis appear. Only has an effect if
categoryorder
is set to “array”. Used withcategoryorder
.- categoryarraysrc
Sets the source reference on Chart Studio Cloud for
categoryarray
.- categoryorder
Specifies the ordering logic for the case of categorical variables. By default, plotly uses “trace”, which specifies the order that is present in the data supplied. Set
categoryorder
to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Setcategoryorder
to “array” to derive the ordering from the attributecategoryarray
. If a category is not found in thecategoryarray
array, the sorting behavior for that attribute will be identical to the “trace” mode. The unspecified categories will follow the categories incategoryarray
. Setcategoryorder
to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.- color
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
- direction
Sets the direction corresponding to positive angles.
- dtick
Sets the step in-between ticks on this axis. Use with
tick0
. Must be a positive number, or special strings available to “log” and “date” axes. If the axistype
is “log”, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, … set dtick to 1. To set tick marks at 1, 100, 10000, … set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, … set dtick to log_10(5), or 0.69897000433. “log” has several special values; “L<f>”, wheref
is a positive number, gives ticks linearly spaced in value (but not position). For exampletick0
= 0.1,dtick
= “L0.5” will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use “D1” (all digits) or “D2” (only 2 and 5).tick0
is ignored for “D1” and “D2”. If the axistype
is “date”, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, setdtick
to 86400000.0. “date” also has special values “M<n>” gives ticks spaced by a number of months.n
must be a positive integer. To set ticks on the 15th of every third month, settick0
to “2000-01-15” anddtick
to “M3”. To set ticks every 4 years, setdtick
to “M48”- exponentformat
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If “none”, it appears as 1,000,000,000. If “e”, 1e+9. If “E”, 1E+9. If “power”, 1x10^9 (with 9 in a super script). If “SI”, 1G. If “B”, 1B.
- gridcolor
Sets the color of the grid lines.
- griddash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- gridwidth
Sets the width (in px) of the grid lines.
- hoverformat
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- labelalias
Replacement text for specific tick or hover labels. For example using {US: ‘USA’, CA: ‘Canada’} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
- layer
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot’s traces If below traces, this axis is displayed below all the subplot’s traces, but above the grid lines. Useful when used together with scatter-like traces with
cliponaxis
set to False to show markers and/or text nodes above this axis.- linecolor
Sets the axis line color.
- linewidth
Sets the width (in px) of the axis line.
- minexponent
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when
tickformat
is “SI” or “B”.- nticks
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to
nticks
. Has an effect only iftickmode
is set to “auto”.- period
Set the angular period. Has an effect only when
angularaxis.type
is “category”.- rotation
Sets that start position (in degrees) of the angular axis By default, polar subplots with
direction
set to “counterclockwise” get arotation
of 0 which corresponds to due East (like what mathematicians prefer). In turn, polar withdirection
set to “clockwise” get a rotation of 90 which corresponds to due North (like on a compass),- separatethousands
If “true”, even 4-digit integers are separated
- showexponent
If “all”, all exponents are shown besides their significands. If “first”, only the exponent of the first tick is shown. If “last”, only the exponent of the last tick is shown. If “none”, no exponents appear.
- showgrid
Determines whether or not grid lines are drawn. If True, the grid lines are drawn at every tick mark.
- showline
Determines whether or not a line bounding this axis is drawn.
- showticklabels
Determines whether or not the tick labels are drawn.
- showtickprefix
If “all”, all tick labels are displayed with a prefix. If “first”, only the first tick is displayed with a prefix. If “last”, only the last tick is displayed with a suffix. If “none”, tick prefixes are hidden.
- showticksuffix
Same as
showtickprefix
but for tick suffixes.- thetaunit
Sets the format unit of the formatted “theta” values. Has an effect only when
angularaxis.type
is “linear”.- tick0
Sets the placement of the first tick on this axis. Use with
dtick
. If the axistype
is “log”, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set thetick0
to 2) except whendtick`=*L<f>* (see `dtick
for more info). If the axistype
is “date”, it should be a date string, like date data. If the axistype
is “category”, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.- tickangle
Sets the angle of the tick labels with respect to the horizontal. For example, a
tickangle
of -90 draws the tick labels vertically.- tickcolor
Sets the tick color.
- tickfont
Sets the tick font.
- tickformat
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- tickformatstops
A tuple of
plotly.graph_objects.layout. polar.angularaxis.Tickformatstop
instances or dicts with compatible properties- tickformatstopdefaults
When used in a template (as layout.template.lay out.polar.angularaxis.tickformatstopdefaults), sets the default property values to use for elements of layout.polar.angularaxis.tickformatstops
- ticklabelstep
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled.
tick0
determines which labels are shown. Not implemented for axes withtype
“log” or “multicategory”, or whentickmode
is “array”.- ticklen
Sets the tick length (in px).
- tickmode
Sets the tick mode for this axis. If “auto”, the number of ticks is set via
nticks
. If “linear”, the placement of the ticks is determined by a starting positiontick0
and a tick stepdtick
(“linear” is the default value iftick0
anddtick
are provided). If “array”, the placement of the ticks is set viatickvals
and the tick text isticktext
. (“array” is the default value iftickvals
is provided).- tickprefix
Sets a tick label prefix.
- ticks
Determines whether ticks are drawn or not. If “”, this axis’ ticks are not drawn. If “outside” (“inside”), this axis’ are drawn outside (inside) the axis lines.
- ticksuffix
Sets a tick label suffix.
- ticktext
Sets the text displayed at the ticks position via
tickvals
. Only has an effect iftickmode
is set to “array”. Used withtickvals
.- ticktextsrc
Sets the source reference on Chart Studio Cloud for
ticktext
.- tickvals
Sets the values at which ticks on this axis appear. Only has an effect if
tickmode
is set to “array”. Used withticktext
.- tickvalssrc
Sets the source reference on Chart Studio Cloud for
tickvals
.- tickwidth
Sets the tick width (in px).
- type
Sets the angular axis type. If “linear”, set
thetaunit
to determine the unit in which axis value are shown. If *category, useperiod
to set the number of integer coordinates around polar axis.- uirevision
Controls persistence of user-driven changes in axis
rotation
. Defaults topolar<N>.uirevision
.- visible
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
- Returns
- Return type
-
property
bargap
¶ Sets the gap between bars of adjacent location coordinates. Values are unitless, they represent fractions of the minimum difference in bar positions in the data.
- The ‘bargap’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
barmode
¶ Determines how bars at the same location coordinate are displayed on the graph. With “stack”, the bars are stacked on top of one another With “overlay”, the bars are plotted over one another, you might need to reduce “opacity” to see multiple bars.
- The ‘barmode’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘stack’, ‘overlay’]
- Returns
- Return type
Any
-
property
bgcolor
¶ Set the background color of the subplot
- The ‘bgcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
domain
¶ The ‘domain’ property is an instance of Domain that may be specified as:
An instance of
plotly.graph_objects.layout.polar.Domain
A dict of string/value properties that will be passed to the Domain constructor
Supported dict properties:
- column
If there is a layout grid, use the domain for this column in the grid for this polar subplot .
- row
If there is a layout grid, use the domain for this row in the grid for this polar subplot .
- x
Sets the horizontal domain of this polar subplot (in plot fraction).
- y
Sets the vertical domain of this polar subplot (in plot fraction).
- Returns
- Return type
-
property
gridshape
¶ Determines if the radial axis grid lines and angular axis line are drawn as “circular” sectors or as “linear” (polygon) sectors. Has an effect only when the angular axis has
type
“category”. Note thatradialaxis.angle
is snapped to the angle of the closest vertex whengridshape
is “circular” (so that radial axis scale is the same as the data scale).- The ‘gridshape’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘circular’, ‘linear’]
- Returns
- Return type
Any
-
property
hole
¶ Sets the fraction of the radius to cut out of the polar subplot.
- The ‘hole’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
radialaxis
¶ The ‘radialaxis’ property is an instance of RadialAxis that may be specified as:
An instance of
plotly.graph_objects.layout.polar.RadialAxis
A dict of string/value properties that will be passed to the RadialAxis constructor
Supported dict properties:
- angle
Sets the angle (in degrees) from which the radial axis is drawn. Note that by default, radial axis line on the theta=0 line corresponds to a line pointing right (like what mathematicians prefer). Defaults to the first
polar.sector
angle.- autorange
Determines whether or not the range of this axis is computed in relation to the input data. See
rangemode
for more info. Ifrange
is provided and it has a value for both the lower and upper bound,autorange
is set to False. Using “min” applies autorange only to set the minimum. Using “max” applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using “reversed” applies autorange on both ends and reverses the axis direction.- autorangeoptions
plotly.graph_objects.layout.polar.radia laxis.Autorangeoptions
instance or dict with compatible properties- autotickangles
When
tickangle
is set to “auto”, it will be set to the first angle in this array that is large enough to prevent label overlap.- autotypenumbers
Using “strict” a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis
type
detection. Defaults to layout.autotypenumbers.- calendar
Sets the calendar system to use for
range
andtick0
if this is a date axis. This does not set the calendar for interpreting data on this axis, that’s specified in the trace or via the globallayout.calendar
- categoryarray
Sets the order in which categories on this axis appear. Only has an effect if
categoryorder
is set to “array”. Used withcategoryorder
.- categoryarraysrc
Sets the source reference on Chart Studio Cloud for
categoryarray
.- categoryorder
Specifies the ordering logic for the case of categorical variables. By default, plotly uses “trace”, which specifies the order that is present in the data supplied. Set
categoryorder
to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Setcategoryorder
to “array” to derive the ordering from the attributecategoryarray
. If a category is not found in thecategoryarray
array, the sorting behavior for that attribute will be identical to the “trace” mode. The unspecified categories will follow the categories incategoryarray
. Setcategoryorder
to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.- color
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
- dtick
Sets the step in-between ticks on this axis. Use with
tick0
. Must be a positive number, or special strings available to “log” and “date” axes. If the axistype
is “log”, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, … set dtick to 1. To set tick marks at 1, 100, 10000, … set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, … set dtick to log_10(5), or 0.69897000433. “log” has several special values; “L<f>”, wheref
is a positive number, gives ticks linearly spaced in value (but not position). For exampletick0
= 0.1,dtick
= “L0.5” will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use “D1” (all digits) or “D2” (only 2 and 5).tick0
is ignored for “D1” and “D2”. If the axistype
is “date”, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, setdtick
to 86400000.0. “date” also has special values “M<n>” gives ticks spaced by a number of months.n
must be a positive integer. To set ticks on the 15th of every third month, settick0
to “2000-01-15” anddtick
to “M3”. To set ticks every 4 years, setdtick
to “M48”- exponentformat
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If “none”, it appears as 1,000,000,000. If “e”, 1e+9. If “E”, 1E+9. If “power”, 1x10^9 (with 9 in a super script). If “SI”, 1G. If “B”, 1B.
- gridcolor
Sets the color of the grid lines.
- griddash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- gridwidth
Sets the width (in px) of the grid lines.
- hoverformat
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- labelalias
Replacement text for specific tick or hover labels. For example using {US: ‘USA’, CA: ‘Canada’} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
- layer
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot’s traces If below traces, this axis is displayed below all the subplot’s traces, but above the grid lines. Useful when used together with scatter-like traces with
cliponaxis
set to False to show markers and/or text nodes above this axis.- linecolor
Sets the axis line color.
- linewidth
Sets the width (in px) of the axis line.
- maxallowed
Determines the maximum range of this axis.
- minallowed
Determines the minimum range of this axis.
- minexponent
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when
tickformat
is “SI” or “B”.- nticks
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to
nticks
. Has an effect only iftickmode
is set to “auto”.- range
Sets the range of this axis. If the axis
type
is “log”, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axistype
is “date”, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axistype
is “category”, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elementsnull
impacts the defaultautorange
.- rangemode
If *tozero*`, the range extends to 0, regardless of the input data If “nonnegative”, the range is non-negative, regardless of the input data. If “normal”, the range is computed in relation to the extrema of the input data (same behavior as for cartesian axes).
- separatethousands
If “true”, even 4-digit integers are separated
- showexponent
If “all”, all exponents are shown besides their significands. If “first”, only the exponent of the first tick is shown. If “last”, only the exponent of the last tick is shown. If “none”, no exponents appear.
- showgrid
Determines whether or not grid lines are drawn. If True, the grid lines are drawn at every tick mark.
- showline
Determines whether or not a line bounding this axis is drawn.
- showticklabels
Determines whether or not the tick labels are drawn.
- showtickprefix
If “all”, all tick labels are displayed with a prefix. If “first”, only the first tick is displayed with a prefix. If “last”, only the last tick is displayed with a suffix. If “none”, tick prefixes are hidden.
- showticksuffix
Same as
showtickprefix
but for tick suffixes.- side
Determines on which side of radial axis line the tick and tick labels appear.
- tick0
Sets the placement of the first tick on this axis. Use with
dtick
. If the axistype
is “log”, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set thetick0
to 2) except whendtick`=*L<f>* (see `dtick
for more info). If the axistype
is “date”, it should be a date string, like date data. If the axistype
is “category”, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.- tickangle
Sets the angle of the tick labels with respect to the horizontal. For example, a
tickangle
of -90 draws the tick labels vertically.- tickcolor
Sets the tick color.
- tickfont
Sets the tick font.
- tickformat
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- tickformatstops
A tuple of
plotly.graph_objects.layout. polar.radialaxis.Tickformatstop
instances or dicts with compatible properties- tickformatstopdefaults
When used in a template (as layout.template.lay out.polar.radialaxis.tickformatstopdefaults), sets the default property values to use for elements of layout.polar.radialaxis.tickformatstops
- ticklabelstep
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled.
tick0
determines which labels are shown. Not implemented for axes withtype
“log” or “multicategory”, or whentickmode
is “array”.- ticklen
Sets the tick length (in px).
- tickmode
Sets the tick mode for this axis. If “auto”, the number of ticks is set via
nticks
. If “linear”, the placement of the ticks is determined by a starting positiontick0
and a tick stepdtick
(“linear” is the default value iftick0
anddtick
are provided). If “array”, the placement of the ticks is set viatickvals
and the tick text isticktext
. (“array” is the default value iftickvals
is provided).- tickprefix
Sets a tick label prefix.
- ticks
Determines whether ticks are drawn or not. If “”, this axis’ ticks are not drawn. If “outside” (“inside”), this axis’ are drawn outside (inside) the axis lines.
- ticksuffix
Sets a tick label suffix.
- ticktext
Sets the text displayed at the ticks position via
tickvals
. Only has an effect iftickmode
is set to “array”. Used withtickvals
.- ticktextsrc
Sets the source reference on Chart Studio Cloud for
ticktext
.- tickvals
Sets the values at which ticks on this axis appear. Only has an effect if
tickmode
is set to “array”. Used withticktext
.- tickvalssrc
Sets the source reference on Chart Studio Cloud for
tickvals
.- tickwidth
Sets the tick width (in px).
- title
plotly.graph_objects.layout.polar.radia laxis.Title
instance or dict with compatible properties- titlefont
Deprecated: Please use layout.polar.radialaxis.title.font instead. Sets this axis’ title font. Note that the title’s font used to be customized by the now deprecated
titlefont
attribute.- type
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
- uirevision
Controls persistence of user-driven changes in axis
range
,autorange
,angle
, andtitle
if ineditable: true
configuration. Defaults topolar<N>.uirevision
.- visible
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
- Returns
- Return type
-
property
sector
¶ - Sets angular span of this polar subplot with two angles (in
degrees). Sector are assumed to be spanned in the counterclockwise direction with 0 corresponding to rightmost limit of the polar subplot.
The ‘sector’ property is an info array that may be specified as:
a list or tuple of 2 elements where:
- The ‘sector[0]’ property is a number and may be specified as:
An int or float
- The ‘sector[1]’ property is a number and may be specified as:
An int or float
list
-
property
uirevision
¶ Controls persistence of user-driven changes in axis attributes, if not overridden in the individual axes. Defaults to
layout.uirevision
.The ‘uirevision’ property accepts values of any type
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Scene
(arg=None, annotations=None, annotationdefaults=None, aspectmode=None, aspectratio=None, bgcolor=None, camera=None, domain=None, dragmode=None, hovermode=None, uirevision=None, xaxis=None, yaxis=None, zaxis=None, **kwargs)¶ -
property
annotationdefaults
¶ When used in a template (as layout.template.layout.scene.annotationdefaults), sets the default property values to use for elements of layout.scene.annotations
The ‘annotationdefaults’ property is an instance of Annotation that may be specified as:
An instance of
plotly.graph_objects.layout.scene.Annotation
A dict of string/value properties that will be passed to the Annotation constructor
Supported dict properties:
- Returns
- Return type
-
property
annotations
¶ The ‘annotations’ property is a tuple of instances of Annotation that may be specified as:
A list or tuple of instances of plotly.graph_objects.layout.scene.Annotation
A list or tuple of dicts of string/value properties that will be passed to the Annotation constructor
Supported dict properties:
- align
Sets the horizontal alignment of the
text
within the box. Has an effect only iftext
spans two or more lines (i.e.text
contains one or more <br> HTML tags) or if an explicit width is set to override the text width.- arrowcolor
Sets the color of the annotation arrow.
- arrowhead
Sets the end annotation arrow head style.
- arrowside
Sets the annotation arrow head position.
- arrowsize
Sets the size of the end annotation arrow head, relative to
arrowwidth
. A value of 1 (default) gives a head about 3x as wide as the line.- arrowwidth
Sets the width (in px) of annotation arrow line.
- ax
Sets the x component of the arrow tail about the arrow head (in pixels).
- ay
Sets the y component of the arrow tail about the arrow head (in pixels).
- bgcolor
Sets the background color of the annotation.
- bordercolor
Sets the color of the border enclosing the annotation
text
.- borderpad
Sets the padding (in px) between the
text
and the enclosing border.- borderwidth
Sets the width (in px) of the border enclosing the annotation
text
.- captureevents
Determines whether the annotation text box captures mouse move and click events, or allows those events to pass through to data points in the plot that may be behind the annotation. By default
captureevents
is False unlesshovertext
is provided. If you use the eventplotly_clickannotation
withouthovertext
you must explicitly enablecaptureevents
.- font
Sets the annotation text font.
- height
Sets an explicit height for the text box. null (default) lets the text set the box height. Taller text will be clipped.
- hoverlabel
plotly.graph_objects.layout.scene.annot ation.Hoverlabel
instance or dict with compatible properties- hovertext
Sets text to appear when hovering over this annotation. If omitted or blank, no hover label will appear.
- name
When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- opacity
Sets the opacity of the annotation (text + arrow).
- showarrow
Determines whether or not the annotation is drawn with an arrow. If True,
text
is placed near the arrow’s tail. If False,text
lines up with thex
andy
provided.- standoff
Sets a distance, in pixels, to move the end arrowhead away from the position it is pointing at, for example to point at the edge of a marker independent of zoom. Note that this shortens the arrow from the
ax
/ay
vector, in contrast toxshift
/yshift
which moves everything by this amount.- startarrowhead
Sets the start annotation arrow head style.
- startarrowsize
Sets the size of the start annotation arrow head, relative to
arrowwidth
. A value of 1 (default) gives a head about 3x as wide as the line.- startstandoff
Sets a distance, in pixels, to move the start arrowhead away from the position it is pointing at, for example to point at the edge of a marker independent of zoom. Note that this shortens the arrow from the
ax
/ay
vector, in contrast toxshift
/yshift
which moves everything by this amount.- templateitemname
Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- text
Sets the text associated with this annotation. Plotly uses a subset of HTML tags to do things like newline (<br>), bold (<b></b>), italics (<i></i>), hyperlinks (<a href=’…’></a>). Tags <em>, <sup>, <sub>, <s>, <u> <span> are also supported.
- textangle
Sets the angle at which the
text
is drawn with respect to the horizontal.- valign
Sets the vertical alignment of the
text
within the box. Has an effect only if an explicit height is set to override the text height.- visible
Determines whether or not this annotation is visible.
- width
Sets an explicit width for the text box. null (default) lets the text set the box width. Wider text will be clipped. There is no automatic wrapping; use <br> to start a new line.
- x
Sets the annotation’s x position.
- xanchor
Sets the text box’s horizontal position anchor This anchor binds the
x
position to the “left”, “center” or “right” of the annotation. For example, ifx
is set to 1,xref
to “paper” andxanchor
to “right” then the right-most portion of the annotation lines up with the right-most edge of the plotting area. If “auto”, the anchor is equivalent to “center” for data-referenced annotations or if there is an arrow, whereas for paper-referenced with no arrow, the anchor picked corresponds to the closest side.- xshift
Shifts the position of the whole annotation and arrow to the right (positive) or left (negative) by this many pixels.
- y
Sets the annotation’s y position.
- yanchor
Sets the text box’s vertical position anchor This anchor binds the
y
position to the “top”, “middle” or “bottom” of the annotation. For example, ify
is set to 1,yref
to “paper” andyanchor
to “top” then the top- most portion of the annotation lines up with the top-most edge of the plotting area. If “auto”, the anchor is equivalent to “middle” for data-referenced annotations or if there is an arrow, whereas for paper-referenced with no arrow, the anchor picked corresponds to the closest side.- yshift
Shifts the position of the whole annotation and arrow up (positive) or down (negative) by this many pixels.
- z
Sets the annotation’s z position.
- Returns
- Return type
-
property
aspectmode
¶ If “cube”, this scene’s axes are drawn as a cube, regardless of the axes’ ranges. If “data”, this scene’s axes are drawn in proportion with the axes’ ranges. If “manual”, this scene’s axes are drawn in proportion with the input of “aspectratio” (the default behavior if “aspectratio” is provided). If “auto”, this scene’s axes are drawn using the results of “data” except when one axis is more than four times the size of the two others, where in that case the results of “cube” are used.
- The ‘aspectmode’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘auto’, ‘cube’, ‘data’, ‘manual’]
- Returns
- Return type
Any
-
property
aspectratio
¶ Sets this scene’s axis aspectratio.
The ‘aspectratio’ property is an instance of Aspectratio that may be specified as:
An instance of
plotly.graph_objects.layout.scene.Aspectratio
A dict of string/value properties that will be passed to the Aspectratio constructor
Supported dict properties:
x
y
z
- Returns
- Return type
-
property
bgcolor
¶ - The ‘bgcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
camera
¶ The ‘camera’ property is an instance of Camera that may be specified as:
An instance of
plotly.graph_objects.layout.scene.Camera
A dict of string/value properties that will be passed to the Camera constructor
Supported dict properties:
- center
Sets the (x,y,z) components of the ‘center’ camera vector This vector determines the translation (x,y,z) space about the center of this scene. By default, there is no such translation.
- eye
Sets the (x,y,z) components of the ‘eye’ camera vector. This vector determines the view point about the origin of this scene.
- projection
plotly.graph_objects.layout.scene.camer a.Projection
instance or dict with compatible properties- up
Sets the (x,y,z) components of the ‘up’ camera vector. This vector determines the up direction of this scene with respect to the page. The default is {x: 0, y: 0, z: 1} which means that the z axis points up.
- Returns
- Return type
-
property
domain
¶ The ‘domain’ property is an instance of Domain that may be specified as:
An instance of
plotly.graph_objects.layout.scene.Domain
A dict of string/value properties that will be passed to the Domain constructor
Supported dict properties:
- column
If there is a layout grid, use the domain for this column in the grid for this scene subplot .
- row
If there is a layout grid, use the domain for this row in the grid for this scene subplot .
- x
Sets the horizontal domain of this scene subplot (in plot fraction).
- y
Sets the vertical domain of this scene subplot (in plot fraction).
- Returns
- Return type
-
property
dragmode
¶ Determines the mode of drag interactions for this scene.
- The ‘dragmode’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘orbit’, ‘turntable’, ‘zoom’, ‘pan’, False]
- Returns
- Return type
Any
-
property
hovermode
¶ Determines the mode of hover interactions for this scene.
- The ‘hovermode’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘closest’, False]
- Returns
- Return type
Any
-
property
uirevision
¶ Controls persistence of user-driven changes in camera attributes. Defaults to
layout.uirevision
.The ‘uirevision’ property accepts values of any type
- Returns
- Return type
Any
-
property
xaxis
¶ The ‘xaxis’ property is an instance of XAxis that may be specified as:
An instance of
plotly.graph_objects.layout.scene.XAxis
A dict of string/value properties that will be passed to the XAxis constructor
Supported dict properties:
- autorange
Determines whether or not the range of this axis is computed in relation to the input data. See
rangemode
for more info. Ifrange
is provided and it has a value for both the lower and upper bound,autorange
is set to False. Using “min” applies autorange only to set the minimum. Using “max” applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using “reversed” applies autorange on both ends and reverses the axis direction.- autorangeoptions
plotly.graph_objects.layout.scene.xaxis .Autorangeoptions
instance or dict with compatible properties- autotypenumbers
Using “strict” a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis
type
detection. Defaults to layout.autotypenumbers.- backgroundcolor
Sets the background color of this axis’ wall.
- calendar
Sets the calendar system to use for
range
andtick0
if this is a date axis. This does not set the calendar for interpreting data on this axis, that’s specified in the trace or via the globallayout.calendar
- categoryarray
Sets the order in which categories on this axis appear. Only has an effect if
categoryorder
is set to “array”. Used withcategoryorder
.- categoryarraysrc
Sets the source reference on Chart Studio Cloud for
categoryarray
.- categoryorder
Specifies the ordering logic for the case of categorical variables. By default, plotly uses “trace”, which specifies the order that is present in the data supplied. Set
categoryorder
to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Setcategoryorder
to “array” to derive the ordering from the attributecategoryarray
. If a category is not found in thecategoryarray
array, the sorting behavior for that attribute will be identical to the “trace” mode. The unspecified categories will follow the categories incategoryarray
. Setcategoryorder
to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.- color
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
- dtick
Sets the step in-between ticks on this axis. Use with
tick0
. Must be a positive number, or special strings available to “log” and “date” axes. If the axistype
is “log”, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, … set dtick to 1. To set tick marks at 1, 100, 10000, … set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, … set dtick to log_10(5), or 0.69897000433. “log” has several special values; “L<f>”, wheref
is a positive number, gives ticks linearly spaced in value (but not position). For exampletick0
= 0.1,dtick
= “L0.5” will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use “D1” (all digits) or “D2” (only 2 and 5).tick0
is ignored for “D1” and “D2”. If the axistype
is “date”, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, setdtick
to 86400000.0. “date” also has special values “M<n>” gives ticks spaced by a number of months.n
must be a positive integer. To set ticks on the 15th of every third month, settick0
to “2000-01-15” anddtick
to “M3”. To set ticks every 4 years, setdtick
to “M48”- exponentformat
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If “none”, it appears as 1,000,000,000. If “e”, 1e+9. If “E”, 1E+9. If “power”, 1x10^9 (with 9 in a super script). If “SI”, 1G. If “B”, 1B.
- gridcolor
Sets the color of the grid lines.
- gridwidth
Sets the width (in px) of the grid lines.
- hoverformat
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- labelalias
Replacement text for specific tick or hover labels. For example using {US: ‘USA’, CA: ‘Canada’} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
- linecolor
Sets the axis line color.
- linewidth
Sets the width (in px) of the axis line.
- maxallowed
Determines the maximum range of this axis.
- minallowed
Determines the minimum range of this axis.
- minexponent
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when
tickformat
is “SI” or “B”.- mirror
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If True, the axis lines are mirrored. If “ticks”, the axis lines and ticks are mirrored. If False, mirroring is disable. If “all”, axis lines are mirrored on all shared-axes subplots. If “allticks”, axis lines and ticks are mirrored on all shared-axes subplots.
- nticks
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to
nticks
. Has an effect only iftickmode
is set to “auto”.- range
Sets the range of this axis. If the axis
type
is “log”, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axistype
is “date”, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axistype
is “category”, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elementsnull
impacts the defaultautorange
.- rangemode
If “normal”, the range is computed in relation to the extrema of the input data. If *tozero*`, the range extends to 0, regardless of the input data If “nonnegative”, the range is non- negative, regardless of the input data. Applies only to linear axes.
- separatethousands
If “true”, even 4-digit integers are separated
- showaxeslabels
Sets whether or not this axis is labeled
- showbackground
Sets whether or not this axis’ wall has a background color.
- showexponent
If “all”, all exponents are shown besides their significands. If “first”, only the exponent of the first tick is shown. If “last”, only the exponent of the last tick is shown. If “none”, no exponents appear.
- showgrid
Determines whether or not grid lines are drawn. If True, the grid lines are drawn at every tick mark.
- showline
Determines whether or not a line bounding this axis is drawn.
- showspikes
Sets whether or not spikes starting from data points to this axis’ wall are shown on hover.
- showticklabels
Determines whether or not the tick labels are drawn.
- showtickprefix
If “all”, all tick labels are displayed with a prefix. If “first”, only the first tick is displayed with a prefix. If “last”, only the last tick is displayed with a suffix. If “none”, tick prefixes are hidden.
- showticksuffix
Same as
showtickprefix
but for tick suffixes.- spikecolor
Sets the color of the spikes.
- spikesides
Sets whether or not spikes extending from the projection data points to this axis’ wall boundaries are shown on hover.
- spikethickness
Sets the thickness (in px) of the spikes.
- tick0
Sets the placement of the first tick on this axis. Use with
dtick
. If the axistype
is “log”, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set thetick0
to 2) except whendtick`=*L<f>* (see `dtick
for more info). If the axistype
is “date”, it should be a date string, like date data. If the axistype
is “category”, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.- tickangle
Sets the angle of the tick labels with respect to the horizontal. For example, a
tickangle
of -90 draws the tick labels vertically.- tickcolor
Sets the tick color.
- tickfont
Sets the tick font.
- tickformat
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- tickformatstops
A tuple of
plotly.graph_objects.layout. scene.xaxis.Tickformatstop
instances or dicts with compatible properties- tickformatstopdefaults
When used in a template (as layout.template.lay out.scene.xaxis.tickformatstopdefaults), sets the default property values to use for elements of layout.scene.xaxis.tickformatstops
- ticklen
Sets the tick length (in px).
- tickmode
Sets the tick mode for this axis. If “auto”, the number of ticks is set via
nticks
. If “linear”, the placement of the ticks is determined by a starting positiontick0
and a tick stepdtick
(“linear” is the default value iftick0
anddtick
are provided). If “array”, the placement of the ticks is set viatickvals
and the tick text isticktext
. (“array” is the default value iftickvals
is provided).- tickprefix
Sets a tick label prefix.
- ticks
Determines whether ticks are drawn or not. If “”, this axis’ ticks are not drawn. If “outside” (“inside”), this axis’ are drawn outside (inside) the axis lines.
- ticksuffix
Sets a tick label suffix.
- ticktext
Sets the text displayed at the ticks position via
tickvals
. Only has an effect iftickmode
is set to “array”. Used withtickvals
.- ticktextsrc
Sets the source reference on Chart Studio Cloud for
ticktext
.- tickvals
Sets the values at which ticks on this axis appear. Only has an effect if
tickmode
is set to “array”. Used withticktext
.- tickvalssrc
Sets the source reference on Chart Studio Cloud for
tickvals
.- tickwidth
Sets the tick width (in px).
- title
plotly.graph_objects.layout.scene.xaxis .Title
instance or dict with compatible properties- titlefont
Deprecated: Please use layout.scene.xaxis.title.font instead. Sets this axis’ title font. Note that the title’s font used to be customized by the now deprecated
titlefont
attribute.- type
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
- visible
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
- zeroline
Determines whether or not a line is drawn at along the 0 value of this axis. If True, the zero line is drawn on top of the grid lines.
- zerolinecolor
Sets the line color of the zero line.
- zerolinewidth
Sets the width (in px) of the zero line.
- Returns
- Return type
-
property
yaxis
¶ The ‘yaxis’ property is an instance of YAxis that may be specified as:
An instance of
plotly.graph_objects.layout.scene.YAxis
A dict of string/value properties that will be passed to the YAxis constructor
Supported dict properties:
- autorange
Determines whether or not the range of this axis is computed in relation to the input data. See
rangemode
for more info. Ifrange
is provided and it has a value for both the lower and upper bound,autorange
is set to False. Using “min” applies autorange only to set the minimum. Using “max” applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using “reversed” applies autorange on both ends and reverses the axis direction.- autorangeoptions
plotly.graph_objects.layout.scene.yaxis .Autorangeoptions
instance or dict with compatible properties- autotypenumbers
Using “strict” a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis
type
detection. Defaults to layout.autotypenumbers.- backgroundcolor
Sets the background color of this axis’ wall.
- calendar
Sets the calendar system to use for
range
andtick0
if this is a date axis. This does not set the calendar for interpreting data on this axis, that’s specified in the trace or via the globallayout.calendar
- categoryarray
Sets the order in which categories on this axis appear. Only has an effect if
categoryorder
is set to “array”. Used withcategoryorder
.- categoryarraysrc
Sets the source reference on Chart Studio Cloud for
categoryarray
.- categoryorder
Specifies the ordering logic for the case of categorical variables. By default, plotly uses “trace”, which specifies the order that is present in the data supplied. Set
categoryorder
to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Setcategoryorder
to “array” to derive the ordering from the attributecategoryarray
. If a category is not found in thecategoryarray
array, the sorting behavior for that attribute will be identical to the “trace” mode. The unspecified categories will follow the categories incategoryarray
. Setcategoryorder
to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.- color
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
- dtick
Sets the step in-between ticks on this axis. Use with
tick0
. Must be a positive number, or special strings available to “log” and “date” axes. If the axistype
is “log”, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, … set dtick to 1. To set tick marks at 1, 100, 10000, … set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, … set dtick to log_10(5), or 0.69897000433. “log” has several special values; “L<f>”, wheref
is a positive number, gives ticks linearly spaced in value (but not position). For exampletick0
= 0.1,dtick
= “L0.5” will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use “D1” (all digits) or “D2” (only 2 and 5).tick0
is ignored for “D1” and “D2”. If the axistype
is “date”, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, setdtick
to 86400000.0. “date” also has special values “M<n>” gives ticks spaced by a number of months.n
must be a positive integer. To set ticks on the 15th of every third month, settick0
to “2000-01-15” anddtick
to “M3”. To set ticks every 4 years, setdtick
to “M48”- exponentformat
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If “none”, it appears as 1,000,000,000. If “e”, 1e+9. If “E”, 1E+9. If “power”, 1x10^9 (with 9 in a super script). If “SI”, 1G. If “B”, 1B.
- gridcolor
Sets the color of the grid lines.
- gridwidth
Sets the width (in px) of the grid lines.
- hoverformat
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- labelalias
Replacement text for specific tick or hover labels. For example using {US: ‘USA’, CA: ‘Canada’} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
- linecolor
Sets the axis line color.
- linewidth
Sets the width (in px) of the axis line.
- maxallowed
Determines the maximum range of this axis.
- minallowed
Determines the minimum range of this axis.
- minexponent
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when
tickformat
is “SI” or “B”.- mirror
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If True, the axis lines are mirrored. If “ticks”, the axis lines and ticks are mirrored. If False, mirroring is disable. If “all”, axis lines are mirrored on all shared-axes subplots. If “allticks”, axis lines and ticks are mirrored on all shared-axes subplots.
- nticks
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to
nticks
. Has an effect only iftickmode
is set to “auto”.- range
Sets the range of this axis. If the axis
type
is “log”, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axistype
is “date”, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axistype
is “category”, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elementsnull
impacts the defaultautorange
.- rangemode
If “normal”, the range is computed in relation to the extrema of the input data. If *tozero*`, the range extends to 0, regardless of the input data If “nonnegative”, the range is non- negative, regardless of the input data. Applies only to linear axes.
- separatethousands
If “true”, even 4-digit integers are separated
- showaxeslabels
Sets whether or not this axis is labeled
- showbackground
Sets whether or not this axis’ wall has a background color.
- showexponent
If “all”, all exponents are shown besides their significands. If “first”, only the exponent of the first tick is shown. If “last”, only the exponent of the last tick is shown. If “none”, no exponents appear.
- showgrid
Determines whether or not grid lines are drawn. If True, the grid lines are drawn at every tick mark.
- showline
Determines whether or not a line bounding this axis is drawn.
- showspikes
Sets whether or not spikes starting from data points to this axis’ wall are shown on hover.
- showticklabels
Determines whether or not the tick labels are drawn.
- showtickprefix
If “all”, all tick labels are displayed with a prefix. If “first”, only the first tick is displayed with a prefix. If “last”, only the last tick is displayed with a suffix. If “none”, tick prefixes are hidden.
- showticksuffix
Same as
showtickprefix
but for tick suffixes.- spikecolor
Sets the color of the spikes.
- spikesides
Sets whether or not spikes extending from the projection data points to this axis’ wall boundaries are shown on hover.
- spikethickness
Sets the thickness (in px) of the spikes.
- tick0
Sets the placement of the first tick on this axis. Use with
dtick
. If the axistype
is “log”, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set thetick0
to 2) except whendtick`=*L<f>* (see `dtick
for more info). If the axistype
is “date”, it should be a date string, like date data. If the axistype
is “category”, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.- tickangle
Sets the angle of the tick labels with respect to the horizontal. For example, a
tickangle
of -90 draws the tick labels vertically.- tickcolor
Sets the tick color.
- tickfont
Sets the tick font.
- tickformat
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- tickformatstops
A tuple of
plotly.graph_objects.layout. scene.yaxis.Tickformatstop
instances or dicts with compatible properties- tickformatstopdefaults
When used in a template (as layout.template.lay out.scene.yaxis.tickformatstopdefaults), sets the default property values to use for elements of layout.scene.yaxis.tickformatstops
- ticklen
Sets the tick length (in px).
- tickmode
Sets the tick mode for this axis. If “auto”, the number of ticks is set via
nticks
. If “linear”, the placement of the ticks is determined by a starting positiontick0
and a tick stepdtick
(“linear” is the default value iftick0
anddtick
are provided). If “array”, the placement of the ticks is set viatickvals
and the tick text isticktext
. (“array” is the default value iftickvals
is provided).- tickprefix
Sets a tick label prefix.
- ticks
Determines whether ticks are drawn or not. If “”, this axis’ ticks are not drawn. If “outside” (“inside”), this axis’ are drawn outside (inside) the axis lines.
- ticksuffix
Sets a tick label suffix.
- ticktext
Sets the text displayed at the ticks position via
tickvals
. Only has an effect iftickmode
is set to “array”. Used withtickvals
.- ticktextsrc
Sets the source reference on Chart Studio Cloud for
ticktext
.- tickvals
Sets the values at which ticks on this axis appear. Only has an effect if
tickmode
is set to “array”. Used withticktext
.- tickvalssrc
Sets the source reference on Chart Studio Cloud for
tickvals
.- tickwidth
Sets the tick width (in px).
- title
plotly.graph_objects.layout.scene.yaxis .Title
instance or dict with compatible properties- titlefont
Deprecated: Please use layout.scene.yaxis.title.font instead. Sets this axis’ title font. Note that the title’s font used to be customized by the now deprecated
titlefont
attribute.- type
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
- visible
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
- zeroline
Determines whether or not a line is drawn at along the 0 value of this axis. If True, the zero line is drawn on top of the grid lines.
- zerolinecolor
Sets the line color of the zero line.
- zerolinewidth
Sets the width (in px) of the zero line.
- Returns
- Return type
-
property
zaxis
¶ The ‘zaxis’ property is an instance of ZAxis that may be specified as:
An instance of
plotly.graph_objects.layout.scene.ZAxis
A dict of string/value properties that will be passed to the ZAxis constructor
Supported dict properties:
- autorange
Determines whether or not the range of this axis is computed in relation to the input data. See
rangemode
for more info. Ifrange
is provided and it has a value for both the lower and upper bound,autorange
is set to False. Using “min” applies autorange only to set the minimum. Using “max” applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using “reversed” applies autorange on both ends and reverses the axis direction.- autorangeoptions
plotly.graph_objects.layout.scene.zaxis .Autorangeoptions
instance or dict with compatible properties- autotypenumbers
Using “strict” a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis
type
detection. Defaults to layout.autotypenumbers.- backgroundcolor
Sets the background color of this axis’ wall.
- calendar
Sets the calendar system to use for
range
andtick0
if this is a date axis. This does not set the calendar for interpreting data on this axis, that’s specified in the trace or via the globallayout.calendar
- categoryarray
Sets the order in which categories on this axis appear. Only has an effect if
categoryorder
is set to “array”. Used withcategoryorder
.- categoryarraysrc
Sets the source reference on Chart Studio Cloud for
categoryarray
.- categoryorder
Specifies the ordering logic for the case of categorical variables. By default, plotly uses “trace”, which specifies the order that is present in the data supplied. Set
categoryorder
to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Setcategoryorder
to “array” to derive the ordering from the attributecategoryarray
. If a category is not found in thecategoryarray
array, the sorting behavior for that attribute will be identical to the “trace” mode. The unspecified categories will follow the categories incategoryarray
. Setcategoryorder
to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.- color
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
- dtick
Sets the step in-between ticks on this axis. Use with
tick0
. Must be a positive number, or special strings available to “log” and “date” axes. If the axistype
is “log”, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, … set dtick to 1. To set tick marks at 1, 100, 10000, … set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, … set dtick to log_10(5), or 0.69897000433. “log” has several special values; “L<f>”, wheref
is a positive number, gives ticks linearly spaced in value (but not position). For exampletick0
= 0.1,dtick
= “L0.5” will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use “D1” (all digits) or “D2” (only 2 and 5).tick0
is ignored for “D1” and “D2”. If the axistype
is “date”, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, setdtick
to 86400000.0. “date” also has special values “M<n>” gives ticks spaced by a number of months.n
must be a positive integer. To set ticks on the 15th of every third month, settick0
to “2000-01-15” anddtick
to “M3”. To set ticks every 4 years, setdtick
to “M48”- exponentformat
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If “none”, it appears as 1,000,000,000. If “e”, 1e+9. If “E”, 1E+9. If “power”, 1x10^9 (with 9 in a super script). If “SI”, 1G. If “B”, 1B.
- gridcolor
Sets the color of the grid lines.
- gridwidth
Sets the width (in px) of the grid lines.
- hoverformat
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- labelalias
Replacement text for specific tick or hover labels. For example using {US: ‘USA’, CA: ‘Canada’} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
- linecolor
Sets the axis line color.
- linewidth
Sets the width (in px) of the axis line.
- maxallowed
Determines the maximum range of this axis.
- minallowed
Determines the minimum range of this axis.
- minexponent
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when
tickformat
is “SI” or “B”.- mirror
Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If True, the axis lines are mirrored. If “ticks”, the axis lines and ticks are mirrored. If False, mirroring is disable. If “all”, axis lines are mirrored on all shared-axes subplots. If “allticks”, axis lines and ticks are mirrored on all shared-axes subplots.
- nticks
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to
nticks
. Has an effect only iftickmode
is set to “auto”.- range
Sets the range of this axis. If the axis
type
is “log”, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axistype
is “date”, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axistype
is “category”, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elementsnull
impacts the defaultautorange
.- rangemode
If “normal”, the range is computed in relation to the extrema of the input data. If *tozero*`, the range extends to 0, regardless of the input data If “nonnegative”, the range is non- negative, regardless of the input data. Applies only to linear axes.
- separatethousands
If “true”, even 4-digit integers are separated
- showaxeslabels
Sets whether or not this axis is labeled
- showbackground
Sets whether or not this axis’ wall has a background color.
- showexponent
If “all”, all exponents are shown besides their significands. If “first”, only the exponent of the first tick is shown. If “last”, only the exponent of the last tick is shown. If “none”, no exponents appear.
- showgrid
Determines whether or not grid lines are drawn. If True, the grid lines are drawn at every tick mark.
- showline
Determines whether or not a line bounding this axis is drawn.
- showspikes
Sets whether or not spikes starting from data points to this axis’ wall are shown on hover.
- showticklabels
Determines whether or not the tick labels are drawn.
- showtickprefix
If “all”, all tick labels are displayed with a prefix. If “first”, only the first tick is displayed with a prefix. If “last”, only the last tick is displayed with a suffix. If “none”, tick prefixes are hidden.
- showticksuffix
Same as
showtickprefix
but for tick suffixes.- spikecolor
Sets the color of the spikes.
- spikesides
Sets whether or not spikes extending from the projection data points to this axis’ wall boundaries are shown on hover.
- spikethickness
Sets the thickness (in px) of the spikes.
- tick0
Sets the placement of the first tick on this axis. Use with
dtick
. If the axistype
is “log”, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set thetick0
to 2) except whendtick`=*L<f>* (see `dtick
for more info). If the axistype
is “date”, it should be a date string, like date data. If the axistype
is “category”, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.- tickangle
Sets the angle of the tick labels with respect to the horizontal. For example, a
tickangle
of -90 draws the tick labels vertically.- tickcolor
Sets the tick color.
- tickfont
Sets the tick font.
- tickformat
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- tickformatstops
A tuple of
plotly.graph_objects.layout. scene.zaxis.Tickformatstop
instances or dicts with compatible properties- tickformatstopdefaults
When used in a template (as layout.template.lay out.scene.zaxis.tickformatstopdefaults), sets the default property values to use for elements of layout.scene.zaxis.tickformatstops
- ticklen
Sets the tick length (in px).
- tickmode
Sets the tick mode for this axis. If “auto”, the number of ticks is set via
nticks
. If “linear”, the placement of the ticks is determined by a starting positiontick0
and a tick stepdtick
(“linear” is the default value iftick0
anddtick
are provided). If “array”, the placement of the ticks is set viatickvals
and the tick text isticktext
. (“array” is the default value iftickvals
is provided).- tickprefix
Sets a tick label prefix.
- ticks
Determines whether ticks are drawn or not. If “”, this axis’ ticks are not drawn. If “outside” (“inside”), this axis’ are drawn outside (inside) the axis lines.
- ticksuffix
Sets a tick label suffix.
- ticktext
Sets the text displayed at the ticks position via
tickvals
. Only has an effect iftickmode
is set to “array”. Used withtickvals
.- ticktextsrc
Sets the source reference on Chart Studio Cloud for
ticktext
.- tickvals
Sets the values at which ticks on this axis appear. Only has an effect if
tickmode
is set to “array”. Used withticktext
.- tickvalssrc
Sets the source reference on Chart Studio Cloud for
tickvals
.- tickwidth
Sets the tick width (in px).
- title
plotly.graph_objects.layout.scene.zaxis .Title
instance or dict with compatible properties- titlefont
Deprecated: Please use layout.scene.zaxis.title.font instead. Sets this axis’ title font. Note that the title’s font used to be customized by the now deprecated
titlefont
attribute.- type
Sets the axis type. By default, plotly attempts to determined the axis type by looking into the data of the traces that referenced the axis in question.
- visible
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
- zeroline
Determines whether or not a line is drawn at along the 0 value of this axis. If True, the zero line is drawn on top of the grid lines.
- zerolinecolor
Sets the line color of the zero line.
- zerolinewidth
Sets the width (in px) of the zero line.
- Returns
- Return type
-
property
-
class
plotly.graph_objects.layout.
Selection
(arg=None, line=None, name=None, opacity=None, path=None, templateitemname=None, type=None, x0=None, x1=None, xref=None, y0=None, y1=None, yref=None, **kwargs)¶ -
property
line
¶ The ‘line’ property is an instance of Line that may be specified as:
An instance of
plotly.graph_objects.layout.selection.Line
A dict of string/value properties that will be passed to the Line constructor
Supported dict properties:
- color
Sets the line color.
- dash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- width
Sets the line width (in px).
- Returns
- Return type
-
property
name
¶ When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- The ‘name’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
opacity
¶ Sets the opacity of the selection.
- The ‘opacity’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
path
¶ For
type
“path” - a valid SVG path similar toshapes.path
in data coordinates. Allowed segments are: M, L and Z.- The ‘path’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
templateitemname
¶ Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- The ‘templateitemname’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
type
¶ Specifies the selection type to be drawn. If “rect”, a rectangle is drawn linking (
x0
,`y0`), (x1
,`y0`), (x1
,`y1`) and (x0
,`y1`). If “path”, draw a custom SVG path usingpath
.- The ‘type’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘rect’, ‘path’]
- Returns
- Return type
Any
-
property
x0
¶ Sets the selection’s starting x position.
The ‘x0’ property accepts values of any type
- Returns
- Return type
Any
-
property
x1
¶ Sets the selection’s end x position.
The ‘x1’ property accepts values of any type
- Returns
- Return type
Any
-
property
xref
¶ Sets the selection’s x coordinate axis. If set to a x axis id (e.g. “x” or “x2”), the
x
position refers to a x coordinate. If set to “paper”, thex
position refers to the distance from the left of the plotting area in normalized coordinates where 0 (1) corresponds to the left (right). If set to a x axis ID followed by “domain” (separated by a space), the position behaves like for “paper”, but refers to the distance in fractions of the domain length from the left of the domain of that axis: e.g., x2 domain refers to the domain of the second x axis and a x position of 0.5 refers to the point between the left and the right of the domain of the second x axis.- The ‘xref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘paper’]
- A string that matches one of the following regular expressions:
[‘^x([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
y0
¶ Sets the selection’s starting y position.
The ‘y0’ property accepts values of any type
- Returns
- Return type
Any
-
property
y1
¶ Sets the selection’s end y position.
The ‘y1’ property accepts values of any type
- Returns
- Return type
Any
-
property
yref
¶ Sets the selection’s x coordinate axis. If set to a y axis id (e.g. “y” or “y2”), the
y
position refers to a y coordinate. If set to “paper”, they
position refers to the distance from the bottom of the plotting area in normalized coordinates where 0 (1) corresponds to the bottom (top). If set to a y axis ID followed by “domain” (separated by a space), the position behaves like for “paper”, but refers to the distance in fractions of the domain length from the bottom of the domain of that axis: e.g., y2 domain refers to the domain of the second y axis and a y position of 0.5 refers to the point between the bottom and the top of the domain of the second y axis.- The ‘yref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘paper’]
- A string that matches one of the following regular expressions:
[‘^y([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Shape
(arg=None, editable=None, fillcolor=None, fillrule=None, label=None, layer=None, legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, legendwidth=None, line=None, name=None, opacity=None, path=None, showlegend=None, templateitemname=None, type=None, visible=None, x0=None, x0shift=None, x1=None, x1shift=None, xanchor=None, xref=None, xsizemode=None, y0=None, y0shift=None, y1=None, y1shift=None, yanchor=None, yref=None, ysizemode=None, **kwargs)¶ -
property
editable
¶ Determines whether the shape could be activated for edit or not. Has no effect when the older editable shapes mode is enabled via
config.editable
orconfig.edits.shapePosition
.The ‘editable’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
fillcolor
¶ Sets the color filling the shape’s interior. Only applies to closed shapes.
- The ‘fillcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
fillrule
¶ Determines which regions of complex paths constitute the interior. For more info please visit https://developer.mozilla.org/en- US/docs/Web/SVG/Attribute/fill-rule
- The ‘fillrule’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘evenodd’, ‘nonzero’]
- Returns
- Return type
Any
-
property
label
¶ The ‘label’ property is an instance of Label that may be specified as:
An instance of
plotly.graph_objects.layout.shape.Label
A dict of string/value properties that will be passed to the Label constructor
Supported dict properties:
- font
Sets the shape label text font.
- padding
Sets padding (in px) between edge of label and edge of shape.
- text
Sets the text to display with shape. It is also used for legend item if
name
is not provided.- textangle
Sets the angle at which the label text is drawn with respect to the horizontal. For lines, angle “auto” is the same angle as the line. For all other shapes, angle “auto” is horizontal.
- textposition
Sets the position of the label text relative to the shape. Supported values for rectangles, circles and paths are top left, top center, top right, middle left, middle center, middle right, bottom left, bottom center, and bottom right. Supported values for lines are “start”, “middle”, and “end”. Default: middle center for rectangles, circles, and paths; “middle” for lines.
- texttemplate
Template string used for rendering the shape’s label. Note that this will override
text
. Variables are inserted using %{variable}, for example “x0: %{x0}”. Numbers are formatted using d3-format’s syntax %{variable:d3-format}, for example “Price: %{x0:$.2f}”. See https://gi thub.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format’s syntax %{variable|d3-time-format}, for example “Day: %{x0|%m %b %Y}”. See https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format for details on the date formatting syntax. A single multiplication or division operation may be applied to numeric variables, and combined with d3 number formatting, for example “Length in cm: %{x0*2.54}”, “%{slope*60:.1f} meters per second.” For log axes, variable values are given in log units. For date axes, x/y coordinate variables and center variables use datetimes, while all other variable values use values in ms. Finally, the template string has access to variablesx0
,x1
,y0
,y1
,slope
,dx
,dy
,width
,height
,length
,xcenter
andycenter
.- xanchor
Sets the label’s horizontal position anchor This anchor binds the specified
textposition
to the “left”, “center” or “right” of the label text. For example, iftextposition
is set to top right andxanchor
to “right” then the right-most portion of the label text lines up with the right-most edge of the shape.- yanchor
Sets the label’s vertical position anchor This anchor binds the specified
textposition
to the “top”, “middle” or “bottom” of the label text. For example, iftextposition
is set to top right andyanchor
to “top” then the top-most portion of the label text lines up with the top-most edge of the shape.
- Returns
- Return type
-
property
layer
¶ Specifies whether shapes are drawn below gridlines (“below”), between gridlines and traces (“between”) or above traces (“above”).
- The ‘layer’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘below’, ‘above’, ‘between’]
- Returns
- Return type
Any
-
property
legend
¶ Sets the reference to a legend to show this shape in. References to these legends are “legend”, “legend2”, “legend3”, etc. Settings for these legends are set in the layout, under
layout.legend
,layout.legend2
, etc.The ‘legend’ property is an identifier of a particular subplot, of type ‘legend’, that may be specified as the string ‘legend’ optionally followed by an integer >= 1 (e.g. ‘legend’, ‘legend1’, ‘legend2’, ‘legend3’, etc.)
- Returns
- Return type
-
property
legendgroup
¶ Sets the legend group for this shape. Traces and shapes part of the same legend group hide/show at the same time when toggling legend items.
- The ‘legendgroup’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
legendgrouptitle
¶ The ‘legendgrouptitle’ property is an instance of Legendgrouptitle that may be specified as:
An instance of
plotly.graph_objects.layout.shape.Legendgrouptitle
A dict of string/value properties that will be passed to the Legendgrouptitle constructor
Supported dict properties:
- font
Sets this legend group’s title font.
- text
Sets the title of the legend group.
- Returns
- Return type
-
property
legendrank
¶ Sets the legend rank for this shape. Items and groups with smaller ranks are presented on top/left side while with “reversed”
legend.traceorder
they are on bottom/right side. The default legendrank is 1000, so that you can use ranks less than 1000 to place certain items before all unranked items, and ranks greater than 1000 to go after all unranked items. When having unranked or equal rank items shapes would be displayed after traces i.e. according to their order in data and layout.- The ‘legendrank’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
legendwidth
¶ Sets the width (in px or fraction) of the legend for this shape.
- The ‘legendwidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
line
¶ The ‘line’ property is an instance of Line that may be specified as:
An instance of
plotly.graph_objects.layout.shape.Line
A dict of string/value properties that will be passed to the Line constructor
Supported dict properties:
- color
Sets the line color.
- dash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- width
Sets the line width (in px).
- Returns
- Return type
-
property
name
¶ When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- The ‘name’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
opacity
¶ Sets the opacity of the shape.
- The ‘opacity’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
path
¶ For
type
“path” - a valid SVG path with the pixel values replaced by data values inxsizemode
/ysizemode
being “scaled” and taken unmodified as pixels relative toxanchor
andyanchor
in case of “pixel” size mode. There are a few restrictions / quirks only absolute instructions, not relative. So the allowed segments are: M, L, H, V, Q, C, T, S, and Z arcs (A) are not allowed because radius rx and ry are relative. In the future we could consider supporting relative commands, but we would have to decide on how to handle date and log axes. Note that even as is, Q and C Bezier paths that are smooth on linear axes may not be smooth on log, and vice versa. no chained “polybezier” commands - specify the segment type for each one. On category axes, values are numbers scaled to the serial numbers of categories because using the categories themselves there would be no way to describe fractional positions On data axes: because space and T are both normal components of path strings, we can’t use either to separate date from time parts. Therefore we’ll use underscore for this purpose: 2015-02-21_13:45:56.789- The ‘path’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
showlegend
¶ Determines whether or not this shape is shown in the legend.
The ‘showlegend’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
templateitemname
¶ Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- The ‘templateitemname’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
type
¶ Specifies the shape type to be drawn. If “line”, a line is drawn from (
x0
,`y0`) to (x1
,`y1`) with respect to the axes’ sizing mode. If “circle”, a circle is drawn from ((x0`+`x1
)/2, (y0`+`y1
)/2)) with radius (|(`x0`+`x1`)/2 - `x0`|, |(`y0`+`y1`)/2 -`y0`)|) with respect to the axes’ sizing mode. If “rect”, a rectangle is drawn linking (x0
,`y0`), (x1
,`y0`), (x1
,`y1`), (x0
,`y1`), (x0
,`y0`) with respect to the axes’ sizing mode. If “path”, draw a custom SVG path usingpath
. with respect to the axes’ sizing mode.- The ‘type’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘circle’, ‘rect’, ‘path’, ‘line’]
- Returns
- Return type
Any
-
property
visible
¶ Determines whether or not this shape is visible. If “legendonly”, the shape is not drawn, but can appear as a legend item (provided that the legend itself is visible).
- The ‘visible’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[True, False, ‘legendonly’]
- Returns
- Return type
Any
-
property
x0
¶ Sets the shape’s starting x position. See
type
andxsizemode
for more info.The ‘x0’ property accepts values of any type
- Returns
- Return type
Any
-
property
x0shift
¶ Shifts
x0
away from the center of the category whenxref
is a “category” or “multicategory” axis. -0.5 corresponds to the start of the category and 0.5 corresponds to the end of the category.- The ‘x0shift’ property is a number and may be specified as:
An int or float in the interval [-1, 1]
- Returns
- Return type
int|float
-
property
x1
¶ Sets the shape’s end x position. See
type
andxsizemode
for more info.The ‘x1’ property accepts values of any type
- Returns
- Return type
Any
-
property
x1shift
¶ Shifts
x1
away from the center of the category whenxref
is a “category” or “multicategory” axis. -0.5 corresponds to the start of the category and 0.5 corresponds to the end of the category.- The ‘x1shift’ property is a number and may be specified as:
An int or float in the interval [-1, 1]
- Returns
- Return type
int|float
-
property
xanchor
¶ Only relevant in conjunction with
xsizemode
set to “pixel”. Specifies the anchor point on the x axis to whichx0
,x1
and x coordinates withinpath
are relative to. E.g. useful to attach a pixel sized shape to a certain data value. No effect whenxsizemode
not set to “pixel”.The ‘xanchor’ property accepts values of any type
- Returns
- Return type
Any
-
property
xref
¶ Sets the shape’s x coordinate axis. If set to a x axis id (e.g. “x” or “x2”), the
x
position refers to a x coordinate. If set to “paper”, thex
position refers to the distance from the left of the plotting area in normalized coordinates where 0 (1) corresponds to the left (right). If set to a x axis ID followed by “domain” (separated by a space), the position behaves like for “paper”, but refers to the distance in fractions of the domain length from the left of the domain of that axis: e.g., x2 domain refers to the domain of the second x axis and a x position of 0.5 refers to the point between the left and the right of the domain of the second x axis.- The ‘xref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘paper’]
- A string that matches one of the following regular expressions:
[‘^x([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
xsizemode
¶ Sets the shapes’s sizing mode along the x axis. If set to “scaled”,
x0
,x1
and x coordinates withinpath
refer to data values on the x axis or a fraction of the plot area’s width (xref
set to “paper”). If set to “pixel”,xanchor
specifies the x position in terms of data or plot fraction butx0
,x1
and x coordinates withinpath
are pixels relative toxanchor
. This way, the shape can have a fixed width while maintaining a position relative to data or plot fraction.- The ‘xsizemode’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘scaled’, ‘pixel’]
- Returns
- Return type
Any
-
property
y0
¶ Sets the shape’s starting y position. See
type
andysizemode
for more info.The ‘y0’ property accepts values of any type
- Returns
- Return type
Any
-
property
y0shift
¶ Shifts
y0
away from the center of the category whenyref
is a “category” or “multicategory” axis. -0.5 corresponds to the start of the category and 0.5 corresponds to the end of the category.- The ‘y0shift’ property is a number and may be specified as:
An int or float in the interval [-1, 1]
- Returns
- Return type
int|float
-
property
y1
¶ Sets the shape’s end y position. See
type
andysizemode
for more info.The ‘y1’ property accepts values of any type
- Returns
- Return type
Any
-
property
y1shift
¶ Shifts
y1
away from the center of the category whenyref
is a “category” or “multicategory” axis. -0.5 corresponds to the start of the category and 0.5 corresponds to the end of the category.- The ‘y1shift’ property is a number and may be specified as:
An int or float in the interval [-1, 1]
- Returns
- Return type
int|float
-
property
yanchor
¶ Only relevant in conjunction with
ysizemode
set to “pixel”. Specifies the anchor point on the y axis to whichy0
,y1
and y coordinates withinpath
are relative to. E.g. useful to attach a pixel sized shape to a certain data value. No effect whenysizemode
not set to “pixel”.The ‘yanchor’ property accepts values of any type
- Returns
- Return type
Any
-
property
yref
¶ Sets the shape’s y coordinate axis. If set to a y axis id (e.g. “y” or “y2”), the
y
position refers to a y coordinate. If set to “paper”, they
position refers to the distance from the bottom of the plotting area in normalized coordinates where 0 (1) corresponds to the bottom (top). If set to a y axis ID followed by “domain” (separated by a space), the position behaves like for “paper”, but refers to the distance in fractions of the domain length from the bottom of the domain of that axis: e.g., y2 domain refers to the domain of the second y axis and a y position of 0.5 refers to the point between the bottom and the top of the domain of the second y axis.- The ‘yref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘paper’]
- A string that matches one of the following regular expressions:
[‘^y([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
ysizemode
¶ Sets the shapes’s sizing mode along the y axis. If set to “scaled”,
y0
,y1
and y coordinates withinpath
refer to data values on the y axis or a fraction of the plot area’s height (yref
set to “paper”). If set to “pixel”,yanchor
specifies the y position in terms of data or plot fraction buty0
,y1
and y coordinates withinpath
are pixels relative toyanchor
. This way, the shape can have a fixed height while maintaining a position relative to data or plot fraction.- The ‘ysizemode’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘scaled’, ‘pixel’]
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Slider
(arg=None, active=None, activebgcolor=None, bgcolor=None, bordercolor=None, borderwidth=None, currentvalue=None, font=None, len=None, lenmode=None, minorticklen=None, name=None, pad=None, steps=None, stepdefaults=None, templateitemname=None, tickcolor=None, ticklen=None, tickwidth=None, transition=None, visible=None, x=None, xanchor=None, y=None, yanchor=None, **kwargs)¶ -
property
active
¶ Determines which button (by index starting from 0) is considered active.
- The ‘active’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
activebgcolor
¶ Sets the background color of the slider grip while dragging.
- The ‘activebgcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
bgcolor
¶ Sets the background color of the slider.
- The ‘bgcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
bordercolor
¶ Sets the color of the border enclosing the slider.
- The ‘bordercolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
borderwidth
¶ Sets the width (in px) of the border enclosing the slider.
- The ‘borderwidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
currentvalue
¶ The ‘currentvalue’ property is an instance of Currentvalue that may be specified as:
An instance of
plotly.graph_objects.layout.slider.Currentvalue
A dict of string/value properties that will be passed to the Currentvalue constructor
Supported dict properties:
- font
Sets the font of the current value label text.
- offset
The amount of space, in pixels, between the current value label and the slider.
- prefix
When currentvalue.visible is true, this sets the prefix of the label.
- suffix
When currentvalue.visible is true, this sets the suffix of the label.
- visible
Shows the currently-selected value above the slider.
- xanchor
The alignment of the value readout relative to the length of the slider.
- Returns
- Return type
-
property
font
¶ Sets the font of the slider step labels.
The ‘font’ property is an instance of Font that may be specified as:
An instance of
plotly.graph_objects.layout.slider.Font
A dict of string/value properties that will be passed to the Font constructor
Supported dict properties:
color
- family
HTML 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 which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren’t available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include “Arial”, “Balto”, “Courier New”, “Droid Sans”, “Droid Serif”, “Droid Sans Mono”, “Gravitas One”, “Old Standard TT”, “Open Sans”, “Overpass”, “PT Sans Narrow”, “Raleway”, “Times New Roman”.
- lineposition
Sets the kind of decoration line(s) with text, such as an “under”, “over” or “through” as well as combinations e.g. “under+over”, etc.
- shadow
Sets the shape and color of the shadow behind text. “auto” places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en- US/docs/Web/CSS/text-shadow for additional options.
size
- style
Sets whether a font should be styled with a normal or italic face from its family.
- textcase
Sets capitalization of text. It can be used to make text appear in all-uppercase or all- lowercase, or with each word capitalized.
- variant
Sets the variant of the font.
- weight
Sets the weight (or boldness) of the font.
- Returns
- Return type
-
property
len
¶ Sets the length of the slider This measure excludes the padding of both ends. That is, the slider’s length is this length minus the padding on both ends.
- The ‘len’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
lenmode
¶ Determines whether this slider length is set in units of plot “fraction” or in *pixels. Use
len
to set the value.- The ‘lenmode’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘fraction’, ‘pixels’]
- Returns
- Return type
Any
-
property
minorticklen
¶ Sets the length in pixels of minor step tick marks
- The ‘minorticklen’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
name
¶ When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- The ‘name’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
pad
¶ Set the padding of the slider component along each side.
The ‘pad’ property is an instance of Pad that may be specified as:
An instance of
plotly.graph_objects.layout.slider.Pad
A dict of string/value properties that will be passed to the Pad constructor
Supported dict properties:
- b
The amount of padding (in px) along the bottom of the component.
- l
The amount of padding (in px) on the left side of the component.
- r
The amount of padding (in px) on the right side of the component.
- t
The amount of padding (in px) along the top of the component.
- Returns
- Return type
-
property
stepdefaults
¶ When used in a template (as layout.template.layout.slider.stepdefaults), sets the default property values to use for elements of layout.slider.steps
The ‘stepdefaults’ property is an instance of Step that may be specified as:
An instance of
plotly.graph_objects.layout.slider.Step
A dict of string/value properties that will be passed to the Step constructor
Supported dict properties:
- Returns
- Return type
-
property
steps
¶ The ‘steps’ property is a tuple of instances of Step that may be specified as:
A list or tuple of instances of plotly.graph_objects.layout.slider.Step
A list or tuple of dicts of string/value properties that will be passed to the Step constructor
Supported dict properties:
- args
Sets the arguments values to be passed to the Plotly method set in
method
on slide.- execute
When true, the API method is executed. When false, all other behaviors are the same and command execution is skipped. This may be useful when hooking into, for example, the
plotly_sliderchange
method and executing the API command manually without losing the benefit of the slider automatically binding to the state of the plot through the specification ofmethod
andargs
.- label
Sets the text label to appear on the slider
- method
Sets the Plotly method to be called when the slider value is changed. If the
skip
method is used, the API slider will function as normal but will perform no API calls and will not bind automatically to state updates. This may be used to create a component interface and attach to slider events manually via JavaScript.- name
When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- templateitemname
Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- value
Sets the value of the slider step, used to refer to the step programatically. Defaults to the slider label if not provided.
- visible
Determines whether or not this step is included in the slider.
- Returns
- Return type
-
property
templateitemname
¶ Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- The ‘templateitemname’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
tickcolor
¶ Sets the color of the border enclosing the slider.
- The ‘tickcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
ticklen
¶ Sets the length in pixels of step tick marks
- The ‘ticklen’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
tickwidth
¶ Sets the tick width (in px).
- The ‘tickwidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
transition
¶ The ‘transition’ property is an instance of Transition that may be specified as:
An instance of
plotly.graph_objects.layout.slider.Transition
A dict of string/value properties that will be passed to the Transition constructor
Supported dict properties:
- duration
Sets the duration of the slider transition
- easing
Sets the easing function of the slider transition
- Returns
- Return type
-
property
visible
¶ Determines whether or not the slider is visible.
The ‘visible’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
x
¶ Sets the x position (in normalized coordinates) of the slider.
- The ‘x’ property is a number and may be specified as:
An int or float in the interval [-2, 3]
- Returns
- Return type
int|float
-
property
xanchor
¶ Sets the slider’s horizontal position anchor. This anchor binds the
x
position to the “left”, “center” or “right” of the range selector.- The ‘xanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘auto’, ‘left’, ‘center’, ‘right’]
- Returns
- Return type
Any
-
property
y
¶ Sets the y position (in normalized coordinates) of the slider.
- The ‘y’ property is a number and may be specified as:
An int or float in the interval [-2, 3]
- Returns
- Return type
int|float
-
property
yanchor
¶ Sets the slider’s vertical position anchor This anchor binds the
y
position to the “top”, “middle” or “bottom” of the range selector.- The ‘yanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘auto’, ‘top’, ‘middle’, ‘bottom’]
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Smith
(arg=None, bgcolor=None, domain=None, imaginaryaxis=None, realaxis=None, **kwargs)¶ -
property
bgcolor
¶ Set the background color of the subplot
- The ‘bgcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
domain
¶ The ‘domain’ property is an instance of Domain that may be specified as:
An instance of
plotly.graph_objects.layout.smith.Domain
A dict of string/value properties that will be passed to the Domain constructor
Supported dict properties:
- column
If there is a layout grid, use the domain for this column in the grid for this smith subplot .
- row
If there is a layout grid, use the domain for this row in the grid for this smith subplot .
- x
Sets the horizontal domain of this smith subplot (in plot fraction).
- y
Sets the vertical domain of this smith subplot (in plot fraction).
- Returns
- Return type
-
property
imaginaryaxis
¶ The ‘imaginaryaxis’ property is an instance of Imaginaryaxis that may be specified as:
An instance of
plotly.graph_objects.layout.smith.Imaginaryaxis
A dict of string/value properties that will be passed to the Imaginaryaxis constructor
Supported dict properties:
- color
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
- gridcolor
Sets the color of the grid lines.
- griddash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- gridwidth
Sets the width (in px) of the grid lines.
- hoverformat
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- labelalias
Replacement text for specific tick or hover labels. For example using {US: ‘USA’, CA: ‘Canada’} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
- layer
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot’s traces If below traces, this axis is displayed below all the subplot’s traces, but above the grid lines. Useful when used together with scatter-like traces with
cliponaxis
set to False to show markers and/or text nodes above this axis.- linecolor
Sets the axis line color.
- linewidth
Sets the width (in px) of the axis line.
- showgrid
Determines whether or not grid lines are drawn. If True, the grid lines are drawn at every tick mark.
- showline
Determines whether or not a line bounding this axis is drawn.
- showticklabels
Determines whether or not the tick labels are drawn.
- showtickprefix
If “all”, all tick labels are displayed with a prefix. If “first”, only the first tick is displayed with a prefix. If “last”, only the last tick is displayed with a suffix. If “none”, tick prefixes are hidden.
- showticksuffix
Same as
showtickprefix
but for tick suffixes.- tickcolor
Sets the tick color.
- tickfont
Sets the tick font.
- tickformat
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- ticklen
Sets the tick length (in px).
- tickprefix
Sets a tick label prefix.
- ticks
Determines whether ticks are drawn or not. If “”, this axis’ ticks are not drawn. If “outside” (“inside”), this axis’ are drawn outside (inside) the axis lines.
- ticksuffix
Sets a tick label suffix.
- tickvals
Sets the values at which ticks on this axis appear. Defaults to
realaxis.tickvals
plus the same as negatives and zero.- tickvalssrc
Sets the source reference on Chart Studio Cloud for
tickvals
.- tickwidth
Sets the tick width (in px).
- visible
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
- Returns
- Return type
-
property
realaxis
¶ The ‘realaxis’ property is an instance of Realaxis that may be specified as:
An instance of
plotly.graph_objects.layout.smith.Realaxis
A dict of string/value properties that will be passed to the Realaxis constructor
Supported dict properties:
- color
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
- gridcolor
Sets the color of the grid lines.
- griddash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- gridwidth
Sets the width (in px) of the grid lines.
- hoverformat
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- labelalias
Replacement text for specific tick or hover labels. For example using {US: ‘USA’, CA: ‘Canada’} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
- layer
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot’s traces If below traces, this axis is displayed below all the subplot’s traces, but above the grid lines. Useful when used together with scatter-like traces with
cliponaxis
set to False to show markers and/or text nodes above this axis.- linecolor
Sets the axis line color.
- linewidth
Sets the width (in px) of the axis line.
- showgrid
Determines whether or not grid lines are drawn. If True, the grid lines are drawn at every tick mark.
- showline
Determines whether or not a line bounding this axis is drawn.
- showticklabels
Determines whether or not the tick labels are drawn.
- showtickprefix
If “all”, all tick labels are displayed with a prefix. If “first”, only the first tick is displayed with a prefix. If “last”, only the last tick is displayed with a suffix. If “none”, tick prefixes are hidden.
- showticksuffix
Same as
showtickprefix
but for tick suffixes.- side
Determines on which side of real axis line the tick and tick labels appear.
- tickangle
Sets the angle of the tick labels with respect to the horizontal. For example, a
tickangle
of -90 draws the tick labels vertically.- tickcolor
Sets the tick color.
- tickfont
Sets the tick font.
- tickformat
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- ticklen
Sets the tick length (in px).
- tickprefix
Sets a tick label prefix.
- ticks
Determines whether ticks are drawn or not. If “”, this axis’ ticks are not drawn. If “top” (“bottom”), this axis’ are drawn above (below) the axis line.
- ticksuffix
Sets a tick label suffix.
- tickvals
Sets the values at which ticks on this axis appear.
- tickvalssrc
Sets the source reference on Chart Studio Cloud for
tickvals
.- tickwidth
Sets the tick width (in px).
- visible
A single toggle to hide the axis while preserving interaction like dragging. Default is true when a cheater plot is present on the axis, otherwise false
- Returns
- Return type
-
property
-
class
plotly.graph_objects.layout.
Template
(arg=None, data=None, layout=None, **kwargs)¶ -
property
data
¶ The ‘data’ property is an instance of Data that may be specified as:
An instance of
plotly.graph_objects.layout.template.Data
A dict of string/value properties that will be passed to the Data constructor
Supported dict properties:
- barpolar
A tuple of
plotly.graph_objects.Barpolar
instances or dicts with compatible properties- bar
A tuple of
plotly.graph_objects.Bar
instances or dicts with compatible properties- box
A tuple of
plotly.graph_objects.Box
instances or dicts with compatible properties- candlestick
A tuple of
plotly.graph_objects.Candlestick
instances or dicts with compatible properties- carpet
A tuple of
plotly.graph_objects.Carpet
instances or dicts with compatible properties- choroplethmapbox
A tuple of
plotly.graph_objects.Choroplethmapbox
instances or dicts with compatible properties- choroplethmap
A tuple of
plotly.graph_objects.Choroplethmap
instances or dicts with compatible properties- choropleth
A tuple of
plotly.graph_objects.Choropleth
instances or dicts with compatible properties- cone
A tuple of
plotly.graph_objects.Cone
instances or dicts with compatible properties- contourcarpet
A tuple of
plotly.graph_objects.Contourcarpet
instances or dicts with compatible properties- contour
A tuple of
plotly.graph_objects.Contour
instances or dicts with compatible properties- densitymapbox
A tuple of
plotly.graph_objects.Densitymapbox
instances or dicts with compatible properties- densitymap
A tuple of
plotly.graph_objects.Densitymap
instances or dicts with compatible properties- funnelarea
A tuple of
plotly.graph_objects.Funnelarea
instances or dicts with compatible properties- funnel
A tuple of
plotly.graph_objects.Funnel
instances or dicts with compatible properties- heatmapgl
A tuple of
plotly.graph_objects.Heatmapgl
instances or dicts with compatible properties- heatmap
A tuple of
plotly.graph_objects.Heatmap
instances or dicts with compatible properties- histogram2dcontour
A tuple of
plotly.graph_objects.Histogr am2dContour
instances or dicts with compatible properties- histogram2d
A tuple of
plotly.graph_objects.Histogram2d
instances or dicts with compatible properties- histogram
A tuple of
plotly.graph_objects.Histogram
instances or dicts with compatible properties- icicle
A tuple of
plotly.graph_objects.Icicle
instances or dicts with compatible properties- image
A tuple of
plotly.graph_objects.Image
instances or dicts with compatible properties- indicator
A tuple of
plotly.graph_objects.Indicator
instances or dicts with compatible properties- isosurface
A tuple of
plotly.graph_objects.Isosurface
instances or dicts with compatible properties- mesh3d
A tuple of
plotly.graph_objects.Mesh3d
instances or dicts with compatible properties- ohlc
A tuple of
plotly.graph_objects.Ohlc
instances or dicts with compatible properties- parcats
A tuple of
plotly.graph_objects.Parcats
instances or dicts with compatible properties- parcoords
A tuple of
plotly.graph_objects.Parcoords
instances or dicts with compatible properties- pie
A tuple of
plotly.graph_objects.Pie
instances or dicts with compatible properties- pointcloud
A tuple of
plotly.graph_objects.Pointcloud
instances or dicts with compatible properties- sankey
A tuple of
plotly.graph_objects.Sankey
instances or dicts with compatible properties- scatter3d
A tuple of
plotly.graph_objects.Scatter3d
instances or dicts with compatible properties- scattercarpet
A tuple of
plotly.graph_objects.Scattercarpet
instances or dicts with compatible properties- scattergeo
A tuple of
plotly.graph_objects.Scattergeo
instances or dicts with compatible properties- scattergl
A tuple of
plotly.graph_objects.Scattergl
instances or dicts with compatible properties- scattermapbox
A tuple of
plotly.graph_objects.Scattermapbox
instances or dicts with compatible properties- scattermap
A tuple of
plotly.graph_objects.Scattermap
instances or dicts with compatible properties- scatterpolargl
A tuple of
plotly.graph_objects.Scatterpolargl
instances or dicts with compatible properties- scatterpolar
A tuple of
plotly.graph_objects.Scatterpolar
instances or dicts with compatible properties- scatter
A tuple of
plotly.graph_objects.Scatter
instances or dicts with compatible properties- scattersmith
A tuple of
plotly.graph_objects.Scattersmith
instances or dicts with compatible properties- scatterternary
A tuple of
plotly.graph_objects.Scatterternary
instances or dicts with compatible properties- splom
A tuple of
plotly.graph_objects.Splom
instances or dicts with compatible properties- streamtube
A tuple of
plotly.graph_objects.Streamtube
instances or dicts with compatible properties- sunburst
A tuple of
plotly.graph_objects.Sunburst
instances or dicts with compatible properties- surface
A tuple of
plotly.graph_objects.Surface
instances or dicts with compatible properties- table
A tuple of
plotly.graph_objects.Table
instances or dicts with compatible properties- treemap
A tuple of
plotly.graph_objects.Treemap
instances or dicts with compatible properties- violin
A tuple of
plotly.graph_objects.Violin
instances or dicts with compatible properties- volume
A tuple of
plotly.graph_objects.Volume
instances or dicts with compatible properties- waterfall
A tuple of
plotly.graph_objects.Waterfall
instances or dicts with compatible properties
- Returns
- Return type
-
property
layout
¶ The ‘layout’ property is an instance of Layout that may be specified as:
An instance of
plotly.graph_objects.Layout
A dict of string/value properties that will be passed to the Layout constructor
Supported dict properties:
- Returns
- Return type
-
property
-
class
plotly.graph_objects.layout.
Ternary
(arg=None, aaxis=None, baxis=None, bgcolor=None, caxis=None, domain=None, sum=None, uirevision=None, **kwargs)¶ -
property
aaxis
¶ The ‘aaxis’ property is an instance of Aaxis that may be specified as:
An instance of
plotly.graph_objects.layout.ternary.Aaxis
A dict of string/value properties that will be passed to the Aaxis constructor
Supported dict properties:
- color
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
- dtick
Sets the step in-between ticks on this axis. Use with
tick0
. Must be a positive number, or special strings available to “log” and “date” axes. If the axistype
is “log”, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, … set dtick to 1. To set tick marks at 1, 100, 10000, … set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, … set dtick to log_10(5), or 0.69897000433. “log” has several special values; “L<f>”, wheref
is a positive number, gives ticks linearly spaced in value (but not position). For exampletick0
= 0.1,dtick
= “L0.5” will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use “D1” (all digits) or “D2” (only 2 and 5).tick0
is ignored for “D1” and “D2”. If the axistype
is “date”, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, setdtick
to 86400000.0. “date” also has special values “M<n>” gives ticks spaced by a number of months.n
must be a positive integer. To set ticks on the 15th of every third month, settick0
to “2000-01-15” anddtick
to “M3”. To set ticks every 4 years, setdtick
to “M48”- exponentformat
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If “none”, it appears as 1,000,000,000. If “e”, 1e+9. If “E”, 1E+9. If “power”, 1x10^9 (with 9 in a super script). If “SI”, 1G. If “B”, 1B.
- gridcolor
Sets the color of the grid lines.
- griddash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- gridwidth
Sets the width (in px) of the grid lines.
- hoverformat
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- labelalias
Replacement text for specific tick or hover labels. For example using {US: ‘USA’, CA: ‘Canada’} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
- layer
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot’s traces If below traces, this axis is displayed below all the subplot’s traces, but above the grid lines. Useful when used together with scatter-like traces with
cliponaxis
set to False to show markers and/or text nodes above this axis.- linecolor
Sets the axis line color.
- linewidth
Sets the width (in px) of the axis line.
- min
The minimum value visible on this axis. The maximum is determined by the sum minus the minimum values of the other two axes. The full view corresponds to all the minima set to zero.
- minexponent
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when
tickformat
is “SI” or “B”.- nticks
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to
nticks
. Has an effect only iftickmode
is set to “auto”.- separatethousands
If “true”, even 4-digit integers are separated
- showexponent
If “all”, all exponents are shown besides their significands. If “first”, only the exponent of the first tick is shown. If “last”, only the exponent of the last tick is shown. If “none”, no exponents appear.
- showgrid
Determines whether or not grid lines are drawn. If True, the grid lines are drawn at every tick mark.
- showline
Determines whether or not a line bounding this axis is drawn.
- showticklabels
Determines whether or not the tick labels are drawn.
- showtickprefix
If “all”, all tick labels are displayed with a prefix. If “first”, only the first tick is displayed with a prefix. If “last”, only the last tick is displayed with a suffix. If “none”, tick prefixes are hidden.
- showticksuffix
Same as
showtickprefix
but for tick suffixes.- tick0
Sets the placement of the first tick on this axis. Use with
dtick
. If the axistype
is “log”, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set thetick0
to 2) except whendtick`=*L<f>* (see `dtick
for more info). If the axistype
is “date”, it should be a date string, like date data. If the axistype
is “category”, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.- tickangle
Sets the angle of the tick labels with respect to the horizontal. For example, a
tickangle
of -90 draws the tick labels vertically.- tickcolor
Sets the tick color.
- tickfont
Sets the tick font.
- tickformat
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- tickformatstops
A tuple of
plotly.graph_objects.layout. ternary.aaxis.Tickformatstop
instances or dicts with compatible properties- tickformatstopdefaults
When used in a template (as layout.template.lay out.ternary.aaxis.tickformatstopdefaults), sets the default property values to use for elements of layout.ternary.aaxis.tickformatstops
- ticklabelstep
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled.
tick0
determines which labels are shown. Not implemented for axes withtype
“log” or “multicategory”, or whentickmode
is “array”.- ticklen
Sets the tick length (in px).
- tickmode
Sets the tick mode for this axis. If “auto”, the number of ticks is set via
nticks
. If “linear”, the placement of the ticks is determined by a starting positiontick0
and a tick stepdtick
(“linear” is the default value iftick0
anddtick
are provided). If “array”, the placement of the ticks is set viatickvals
and the tick text isticktext
. (“array” is the default value iftickvals
is provided).- tickprefix
Sets a tick label prefix.
- ticks
Determines whether ticks are drawn or not. If “”, this axis’ ticks are not drawn. If “outside” (“inside”), this axis’ are drawn outside (inside) the axis lines.
- ticksuffix
Sets a tick label suffix.
- ticktext
Sets the text displayed at the ticks position via
tickvals
. Only has an effect iftickmode
is set to “array”. Used withtickvals
.- ticktextsrc
Sets the source reference on Chart Studio Cloud for
ticktext
.- tickvals
Sets the values at which ticks on this axis appear. Only has an effect if
tickmode
is set to “array”. Used withticktext
.- tickvalssrc
Sets the source reference on Chart Studio Cloud for
tickvals
.- tickwidth
Sets the tick width (in px).
- title
plotly.graph_objects.layout.ternary.aax is.Title
instance or dict with compatible properties- titlefont
Deprecated: Please use layout.ternary.aaxis.title.font instead. Sets this axis’ title font. Note that the title’s font used to be customized by the now deprecated
titlefont
attribute.- uirevision
Controls persistence of user-driven changes in axis
min
, andtitle
if ineditable: true
configuration. Defaults toternary<N>.uirevision
.
- Returns
- Return type
-
property
baxis
¶ The ‘baxis’ property is an instance of Baxis that may be specified as:
An instance of
plotly.graph_objects.layout.ternary.Baxis
A dict of string/value properties that will be passed to the Baxis constructor
Supported dict properties:
- color
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
- dtick
Sets the step in-between ticks on this axis. Use with
tick0
. Must be a positive number, or special strings available to “log” and “date” axes. If the axistype
is “log”, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, … set dtick to 1. To set tick marks at 1, 100, 10000, … set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, … set dtick to log_10(5), or 0.69897000433. “log” has several special values; “L<f>”, wheref
is a positive number, gives ticks linearly spaced in value (but not position). For exampletick0
= 0.1,dtick
= “L0.5” will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use “D1” (all digits) or “D2” (only 2 and 5).tick0
is ignored for “D1” and “D2”. If the axistype
is “date”, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, setdtick
to 86400000.0. “date” also has special values “M<n>” gives ticks spaced by a number of months.n
must be a positive integer. To set ticks on the 15th of every third month, settick0
to “2000-01-15” anddtick
to “M3”. To set ticks every 4 years, setdtick
to “M48”- exponentformat
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If “none”, it appears as 1,000,000,000. If “e”, 1e+9. If “E”, 1E+9. If “power”, 1x10^9 (with 9 in a super script). If “SI”, 1G. If “B”, 1B.
- gridcolor
Sets the color of the grid lines.
- griddash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- gridwidth
Sets the width (in px) of the grid lines.
- hoverformat
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- labelalias
Replacement text for specific tick or hover labels. For example using {US: ‘USA’, CA: ‘Canada’} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
- layer
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot’s traces If below traces, this axis is displayed below all the subplot’s traces, but above the grid lines. Useful when used together with scatter-like traces with
cliponaxis
set to False to show markers and/or text nodes above this axis.- linecolor
Sets the axis line color.
- linewidth
Sets the width (in px) of the axis line.
- min
The minimum value visible on this axis. The maximum is determined by the sum minus the minimum values of the other two axes. The full view corresponds to all the minima set to zero.
- minexponent
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when
tickformat
is “SI” or “B”.- nticks
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to
nticks
. Has an effect only iftickmode
is set to “auto”.- separatethousands
If “true”, even 4-digit integers are separated
- showexponent
If “all”, all exponents are shown besides their significands. If “first”, only the exponent of the first tick is shown. If “last”, only the exponent of the last tick is shown. If “none”, no exponents appear.
- showgrid
Determines whether or not grid lines are drawn. If True, the grid lines are drawn at every tick mark.
- showline
Determines whether or not a line bounding this axis is drawn.
- showticklabels
Determines whether or not the tick labels are drawn.
- showtickprefix
If “all”, all tick labels are displayed with a prefix. If “first”, only the first tick is displayed with a prefix. If “last”, only the last tick is displayed with a suffix. If “none”, tick prefixes are hidden.
- showticksuffix
Same as
showtickprefix
but for tick suffixes.- tick0
Sets the placement of the first tick on this axis. Use with
dtick
. If the axistype
is “log”, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set thetick0
to 2) except whendtick`=*L<f>* (see `dtick
for more info). If the axistype
is “date”, it should be a date string, like date data. If the axistype
is “category”, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.- tickangle
Sets the angle of the tick labels with respect to the horizontal. For example, a
tickangle
of -90 draws the tick labels vertically.- tickcolor
Sets the tick color.
- tickfont
Sets the tick font.
- tickformat
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- tickformatstops
A tuple of
plotly.graph_objects.layout. ternary.baxis.Tickformatstop
instances or dicts with compatible properties- tickformatstopdefaults
When used in a template (as layout.template.lay out.ternary.baxis.tickformatstopdefaults), sets the default property values to use for elements of layout.ternary.baxis.tickformatstops
- ticklabelstep
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled.
tick0
determines which labels are shown. Not implemented for axes withtype
“log” or “multicategory”, or whentickmode
is “array”.- ticklen
Sets the tick length (in px).
- tickmode
Sets the tick mode for this axis. If “auto”, the number of ticks is set via
nticks
. If “linear”, the placement of the ticks is determined by a starting positiontick0
and a tick stepdtick
(“linear” is the default value iftick0
anddtick
are provided). If “array”, the placement of the ticks is set viatickvals
and the tick text isticktext
. (“array” is the default value iftickvals
is provided).- tickprefix
Sets a tick label prefix.
- ticks
Determines whether ticks are drawn or not. If “”, this axis’ ticks are not drawn. If “outside” (“inside”), this axis’ are drawn outside (inside) the axis lines.
- ticksuffix
Sets a tick label suffix.
- ticktext
Sets the text displayed at the ticks position via
tickvals
. Only has an effect iftickmode
is set to “array”. Used withtickvals
.- ticktextsrc
Sets the source reference on Chart Studio Cloud for
ticktext
.- tickvals
Sets the values at which ticks on this axis appear. Only has an effect if
tickmode
is set to “array”. Used withticktext
.- tickvalssrc
Sets the source reference on Chart Studio Cloud for
tickvals
.- tickwidth
Sets the tick width (in px).
- title
plotly.graph_objects.layout.ternary.bax is.Title
instance or dict with compatible properties- titlefont
Deprecated: Please use layout.ternary.baxis.title.font instead. Sets this axis’ title font. Note that the title’s font used to be customized by the now deprecated
titlefont
attribute.- uirevision
Controls persistence of user-driven changes in axis
min
, andtitle
if ineditable: true
configuration. Defaults toternary<N>.uirevision
.
- Returns
- Return type
-
property
bgcolor
¶ Set the background color of the subplot
- The ‘bgcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
caxis
¶ The ‘caxis’ property is an instance of Caxis that may be specified as:
An instance of
plotly.graph_objects.layout.ternary.Caxis
A dict of string/value properties that will be passed to the Caxis constructor
Supported dict properties:
- color
Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
- dtick
Sets the step in-between ticks on this axis. Use with
tick0
. Must be a positive number, or special strings available to “log” and “date” axes. If the axistype
is “log”, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, … set dtick to 1. To set tick marks at 1, 100, 10000, … set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, … set dtick to log_10(5), or 0.69897000433. “log” has several special values; “L<f>”, wheref
is a positive number, gives ticks linearly spaced in value (but not position). For exampletick0
= 0.1,dtick
= “L0.5” will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use “D1” (all digits) or “D2” (only 2 and 5).tick0
is ignored for “D1” and “D2”. If the axistype
is “date”, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, setdtick
to 86400000.0. “date” also has special values “M<n>” gives ticks spaced by a number of months.n
must be a positive integer. To set ticks on the 15th of every third month, settick0
to “2000-01-15” anddtick
to “M3”. To set ticks every 4 years, setdtick
to “M48”- exponentformat
Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If “none”, it appears as 1,000,000,000. If “e”, 1e+9. If “E”, 1E+9. If “power”, 1x10^9 (with 9 in a super script). If “SI”, 1G. If “B”, 1B.
- gridcolor
Sets the color of the grid lines.
- griddash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- gridwidth
Sets the width (in px) of the grid lines.
- hoverformat
Sets the hover text formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- labelalias
Replacement text for specific tick or hover labels. For example using {US: ‘USA’, CA: ‘Canada’} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html-like tags or MathJax.
- layer
Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot’s traces If below traces, this axis is displayed below all the subplot’s traces, but above the grid lines. Useful when used together with scatter-like traces with
cliponaxis
set to False to show markers and/or text nodes above this axis.- linecolor
Sets the axis line color.
- linewidth
Sets the width (in px) of the axis line.
- min
The minimum value visible on this axis. The maximum is determined by the sum minus the minimum values of the other two axes. The full view corresponds to all the minima set to zero.
- minexponent
Hide SI prefix for 10^n if |n| is below this number. This only has an effect when
tickformat
is “SI” or “B”.- nticks
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to
nticks
. Has an effect only iftickmode
is set to “auto”.- separatethousands
If “true”, even 4-digit integers are separated
- showexponent
If “all”, all exponents are shown besides their significands. If “first”, only the exponent of the first tick is shown. If “last”, only the exponent of the last tick is shown. If “none”, no exponents appear.
- showgrid
Determines whether or not grid lines are drawn. If True, the grid lines are drawn at every tick mark.
- showline
Determines whether or not a line bounding this axis is drawn.
- showticklabels
Determines whether or not the tick labels are drawn.
- showtickprefix
If “all”, all tick labels are displayed with a prefix. If “first”, only the first tick is displayed with a prefix. If “last”, only the last tick is displayed with a suffix. If “none”, tick prefixes are hidden.
- showticksuffix
Same as
showtickprefix
but for tick suffixes.- tick0
Sets the placement of the first tick on this axis. Use with
dtick
. If the axistype
is “log”, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set thetick0
to 2) except whendtick`=*L<f>* (see `dtick
for more info). If the axistype
is “date”, it should be a date string, like date data. If the axistype
is “category”, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.- tickangle
Sets the angle of the tick labels with respect to the horizontal. For example, a
tickangle
of -90 draws the tick labels vertically.- tickcolor
Sets the tick color.
- tickfont
Sets the tick font.
- tickformat
Sets the tick label formatting rule using d3 formatting mini-languages which are very similar to those in Python. For numbers, see: h ttps://github.com/d3/d3-format/tree/v1.4.5#d3- format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- tickformatstops
A tuple of
plotly.graph_objects.layout. ternary.caxis.Tickformatstop
instances or dicts with compatible properties- tickformatstopdefaults
When used in a template (as layout.template.lay out.ternary.caxis.tickformatstopdefaults), sets the default property values to use for elements of layout.ternary.caxis.tickformatstops
- ticklabelstep
Sets the spacing between tick labels as compared to the spacing between ticks. A value of 1 (default) means each tick gets a label. A value of 2 means shows every 2nd label. A larger value n means only every nth tick is labeled.
tick0
determines which labels are shown. Not implemented for axes withtype
“log” or “multicategory”, or whentickmode
is “array”.- ticklen
Sets the tick length (in px).
- tickmode
Sets the tick mode for this axis. If “auto”, the number of ticks is set via
nticks
. If “linear”, the placement of the ticks is determined by a starting positiontick0
and a tick stepdtick
(“linear” is the default value iftick0
anddtick
are provided). If “array”, the placement of the ticks is set viatickvals
and the tick text isticktext
. (“array” is the default value iftickvals
is provided).- tickprefix
Sets a tick label prefix.
- ticks
Determines whether ticks are drawn or not. If “”, this axis’ ticks are not drawn. If “outside” (“inside”), this axis’ are drawn outside (inside) the axis lines.
- ticksuffix
Sets a tick label suffix.
- ticktext
Sets the text displayed at the ticks position via
tickvals
. Only has an effect iftickmode
is set to “array”. Used withtickvals
.- ticktextsrc
Sets the source reference on Chart Studio Cloud for
ticktext
.- tickvals
Sets the values at which ticks on this axis appear. Only has an effect if
tickmode
is set to “array”. Used withticktext
.- tickvalssrc
Sets the source reference on Chart Studio Cloud for
tickvals
.- tickwidth
Sets the tick width (in px).
- title
plotly.graph_objects.layout.ternary.cax is.Title
instance or dict with compatible properties- titlefont
Deprecated: Please use layout.ternary.caxis.title.font instead. Sets this axis’ title font. Note that the title’s font used to be customized by the now deprecated
titlefont
attribute.- uirevision
Controls persistence of user-driven changes in axis
min
, andtitle
if ineditable: true
configuration. Defaults toternary<N>.uirevision
.
- Returns
- Return type
-
property
domain
¶ The ‘domain’ property is an instance of Domain that may be specified as:
An instance of
plotly.graph_objects.layout.ternary.Domain
A dict of string/value properties that will be passed to the Domain constructor
Supported dict properties:
- column
If there is a layout grid, use the domain for this column in the grid for this ternary subplot .
- row
If there is a layout grid, use the domain for this row in the grid for this ternary subplot .
- x
Sets the horizontal domain of this ternary subplot (in plot fraction).
- y
Sets the vertical domain of this ternary subplot (in plot fraction).
- Returns
- Return type
-
property
sum
¶ The number each triplet should sum to, and the maximum range of each axis
- The ‘sum’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
uirevision
¶ Controls persistence of user-driven changes in axis
min
andtitle
, if not overridden in the individual axes. Defaults tolayout.uirevision
.The ‘uirevision’ property accepts values of any type
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Title
(arg=None, automargin=None, font=None, pad=None, subtitle=None, text=None, x=None, xanchor=None, xref=None, y=None, yanchor=None, yref=None, **kwargs)¶ -
property
automargin
¶ Determines whether the title can automatically push the figure margins. If
yref='paper'
then the margin will expand to ensure that the title doesn’t overlap with the edges of the container. Ifyref='container'
then the margins will ensure that the title doesn’t overlap with the plot area, tick labels, and axis titles. Ifautomargin=true
and the margins need to be expanded, then y will be set to a default 1 and yanchor will be set to an appropriate default to ensure that minimal margin space is needed. Note that whenyref='paper'
, only 1 or 0 are allowed y values. Invalid values will be reset to the default 1.The ‘automargin’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
font
¶ Sets the title font. Note that the title’s font used to be customized by the now deprecated
titlefont
attribute.The ‘font’ property is an instance of Font that may be specified as:
An instance of
plotly.graph_objects.layout.title.Font
A dict of string/value properties that will be passed to the Font constructor
Supported dict properties:
color
- family
HTML 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 which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren’t available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include “Arial”, “Balto”, “Courier New”, “Droid Sans”, “Droid Serif”, “Droid Sans Mono”, “Gravitas One”, “Old Standard TT”, “Open Sans”, “Overpass”, “PT Sans Narrow”, “Raleway”, “Times New Roman”.
- lineposition
Sets the kind of decoration line(s) with text, such as an “under”, “over” or “through” as well as combinations e.g. “under+over”, etc.
- shadow
Sets the shape and color of the shadow behind text. “auto” places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en- US/docs/Web/CSS/text-shadow for additional options.
size
- style
Sets whether a font should be styled with a normal or italic face from its family.
- textcase
Sets capitalization of text. It can be used to make text appear in all-uppercase or all- lowercase, or with each word capitalized.
- variant
Sets the variant of the font.
- weight
Sets the weight (or boldness) of the font.
- Returns
- Return type
-
property
pad
¶ Sets the padding of the title. Each padding value only applies when the corresponding
xanchor
/yanchor
value is set accordingly. E.g. for left padding to take effect,xanchor
must be set to “left”. The same rule applies ifxanchor
/yanchor
is determined automatically. Padding is muted if the respective anchor value is “middle*/*center”.The ‘pad’ property is an instance of Pad that may be specified as:
An instance of
plotly.graph_objects.layout.title.Pad
A dict of string/value properties that will be passed to the Pad constructor
Supported dict properties:
- b
The amount of padding (in px) along the bottom of the component.
- l
The amount of padding (in px) on the left side of the component.
- r
The amount of padding (in px) on the right side of the component.
- t
The amount of padding (in px) along the top of the component.
- Returns
- Return type
-
property
subtitle
¶ The ‘subtitle’ property is an instance of Subtitle that may be specified as:
An instance of
plotly.graph_objects.layout.title.Subtitle
A dict of string/value properties that will be passed to the Subtitle constructor
Supported dict properties:
- font
Sets the subtitle font.
- text
Sets the plot’s subtitle.
- Returns
- Return type
-
property
text
¶ Sets the plot’s title. Note that before the existence of
title.text
, the title’s contents used to be defined as thetitle
attribute itself. This behavior has been deprecated.- The ‘text’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
x
¶ Sets the x position with respect to
xref
in normalized coordinates from 0 (left) to 1 (right).- The ‘x’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
xanchor
¶ Sets the title’s horizontal alignment with respect to its x position. “left” means that the title starts at x, “right” means that the title ends at x and “center” means that the title’s center is at x. “auto” divides
xref
by three and calculates thexanchor
value automatically based on the value ofx
.- The ‘xanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘auto’, ‘left’, ‘center’, ‘right’]
- Returns
- Return type
Any
-
property
xref
¶ Sets the container
x
refers to. “container” spans the entirewidth
of the plot. “paper” refers to the width of the plotting area only.- The ‘xref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘container’, ‘paper’]
- Returns
- Return type
Any
-
property
y
¶ Sets the y position with respect to
yref
in normalized coordinates from 0 (bottom) to 1 (top). “auto” places the baseline of the title onto the vertical center of the top margin.- The ‘y’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
yanchor
¶ Sets the title’s vertical alignment with respect to its y position. “top” means that the title’s cap line is at y, “bottom” means that the title’s baseline is at y and “middle” means that the title’s midline is at y. “auto” divides
yref
by three and calculates theyanchor
value automatically based on the value ofy
.- The ‘yanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘auto’, ‘top’, ‘middle’, ‘bottom’]
- Returns
- Return type
Any
-
property
yref
¶ Sets the container
y
refers to. “container” spans the entireheight
of the plot. “paper” refers to the height of the plotting area only.- The ‘yref’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘container’, ‘paper’]
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Transition
(arg=None, duration=None, easing=None, ordering=None, **kwargs)¶ -
property
duration
¶ The duration of the transition, in milliseconds. If equal to zero, updates are synchronous.
- The ‘duration’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
easing
¶ The easing function used for the transition
- The ‘easing’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘linear’, ‘quad’, ‘cubic’, ‘sin’, ‘exp’, ‘circle’, ‘elastic’, ‘back’, ‘bounce’, ‘linear-in’, ‘quad-in’, ‘cubic-in’, ‘sin-in’, ‘exp-in’, ‘circle-in’, ‘elastic-in’, ‘back-in’, ‘bounce-in’, ‘linear-out’, ‘quad-out’, ‘cubic-out’, ‘sin-out’, ‘exp-out’, ‘circle-out’, ‘elastic-out’, ‘back-out’, ‘bounce-out’, ‘linear-in-out’, ‘quad-in-out’, ‘cubic-in-out’, ‘sin-in-out’, ‘exp-in-out’, ‘circle-in-out’, ‘elastic-in-out’, ‘back-in-out’, ‘bounce-in-out’]
- Returns
- Return type
Any
-
property
ordering
¶ Determines whether the figure’s layout or traces smoothly transitions during updates that make both traces and layout change.
- The ‘ordering’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘layout first’, ‘traces first’]
- Returns
- Return type
Any
-
property
-
class
plotly.graph_objects.layout.
Uniformtext
(arg=None, minsize=None, mode=None, **kwargs)¶ -
property
minsize
¶ Sets the minimum text size between traces of the same type.
- The ‘minsize’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
mode
¶ Determines how the font size for various text elements are uniformed between each trace type. If the computed text sizes were smaller than the minimum size defined by
uniformtext.minsize
using “hide” option hides the text; and using “show” option shows the text without further downscaling. Please note that if the size defined byminsize
is greater than the font size defined by trace, then theminsize
is used.- The ‘mode’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[False, ‘hide’, ‘show’]
- Returns
- Return type
Any
-
property
Determines which button (by index starting from 0) is considered active.
- The ‘active’ property is a integer and may be specified as:
An int (or float that will be cast to an int) in the interval [-1, 9223372036854775807]
- Returns
- Return type
Sets the background color of the update menu buttons.
- The ‘bgcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
Sets the color of the border enclosing the update menu.
- The ‘bordercolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
Sets the width (in px) of the border enclosing the update menu.
- The ‘borderwidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
When used in a template (as layout.template.layout.updatemenu.buttondefaults), sets the default property values to use for elements of layout.updatemenu.buttons
The ‘buttondefaults’ property is an instance of Button that may be specified as:
An instance of
plotly.graph_objects.layout.updatemenu.Button
A dict of string/value properties that will be passed to the Button constructor
Supported dict properties:
- Returns
- Return type
The ‘buttons’ property is a tuple of instances of Button that may be specified as:
A list or tuple of instances of plotly.graph_objects.layout.updatemenu.Button
A list or tuple of dicts of string/value properties that will be passed to the Button constructor
Supported dict properties:
- args
Sets the arguments values to be passed to the Plotly method set in
method
on click.- args2
Sets a 2nd set of
args
, these arguments values are passed to the Plotly method set inmethod
when clicking this button while in the active state. Use this to create toggle buttons.- execute
When true, the API method is executed. When false, all other behaviors are the same and command execution is skipped. This may be useful when hooking into, for example, the
plotly_buttonclicked
method and executing the API command manually without losing the benefit of the updatemenu automatically binding to the state of the plot through the specification ofmethod
andargs
.- label
Sets the text label to appear on the button.
- method
Sets the Plotly method to be called on click. If the
skip
method is used, the API updatemenu will function as normal but will perform no API calls and will not bind automatically to state updates. This may be used to create a component interface and attach to updatemenu events manually via JavaScript.- name
When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- templateitemname
Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- visible
Determines whether or not this button is visible.
- Returns
- Return type
Determines the direction in which the buttons are laid out, whether in a dropdown menu or a row/column of buttons. For
left
andup
, the buttons will still appear in left-to-right or top-to-bottom order respectively.- The ‘direction’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘left’, ‘right’, ‘up’, ‘down’]
- Returns
- Return type
Any
Sets the font of the update menu button text.
The ‘font’ property is an instance of Font that may be specified as:
An instance of
plotly.graph_objects.layout.updatemenu.Font
A dict of string/value properties that will be passed to the Font constructor
Supported dict properties:
color
- family
HTML 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 which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren’t available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include “Arial”, “Balto”, “Courier New”, “Droid Sans”, “Droid Serif”, “Droid Sans Mono”, “Gravitas One”, “Old Standard TT”, “Open Sans”, “Overpass”, “PT Sans Narrow”, “Raleway”, “Times New Roman”.
- lineposition
Sets the kind of decoration line(s) with text, such as an “under”, “over” or “through” as well as combinations e.g. “under+over”, etc.
- shadow
Sets the shape and color of the shadow behind text. “auto” places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en- US/docs/Web/CSS/text-shadow for additional options.
size
- style
Sets whether a font should be styled with a normal or italic face from its family.
- textcase
Sets capitalization of text. It can be used to make text appear in all-uppercase or all- lowercase, or with each word capitalized.
- variant
Sets the variant of the font.
- weight
Sets the weight (or boldness) of the font.
- Returns
- Return type
When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- The ‘name’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
Sets the padding around the buttons or dropdown menu.
The ‘pad’ property is an instance of Pad that may be specified as:
An instance of
plotly.graph_objects.layout.updatemenu.Pad
A dict of string/value properties that will be passed to the Pad constructor
Supported dict properties:
- b
The amount of padding (in px) along the bottom of the component.
- l
The amount of padding (in px) on the left side of the component.
- r
The amount of padding (in px) on the right side of the component.
- t
The amount of padding (in px) along the top of the component.
- Returns
- Return type
Highlights active dropdown item or active button if true.
The ‘showactive’ property must be specified as a bool (either True, or False)
- Returns
- Return type
Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- The ‘templateitemname’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
Determines whether the buttons are accessible via a dropdown menu or whether the buttons are stacked horizontally or vertically
- The ‘type’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘dropdown’, ‘buttons’]
- Returns
- Return type
Any
Determines whether or not the update menu is visible.
The ‘visible’ property must be specified as a bool (either True, or False)
- Returns
- Return type
Sets the x position (in normalized coordinates) of the update menu.
- The ‘x’ property is a number and may be specified as:
An int or float in the interval [-2, 3]
- Returns
- Return type
int|float
Sets the update menu’s horizontal position anchor. This anchor binds the
x
position to the “left”, “center” or “right” of the range selector.- The ‘xanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘auto’, ‘left’, ‘center’, ‘right’]
- Returns
- Return type
Any
Sets the y position (in normalized coordinates) of the update menu.
- The ‘y’ property is a number and may be specified as:
An int or float in the interval [-2, 3]
- Returns
- Return type
int|float
Sets the update menu’s vertical position anchor This anchor binds the
y
position to the “top”, “middle” or “bottom” of the range selector.- The ‘yanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘auto’, ‘top’, ‘middle’, ‘bottom’]
- Returns
- Return type
Any
-
class
plotly.graph_objects.layout.
XAxis
(arg=None, anchor=None, automargin=None, autorange=None, autorangeoptions=None, autotickangles=None, autotypenumbers=None, calendar=None, categoryarray=None, categoryarraysrc=None, categoryorder=None, color=None, constrain=None, constraintoward=None, dividercolor=None, dividerwidth=None, domain=None, dtick=None, exponentformat=None, fixedrange=None, gridcolor=None, griddash=None, gridwidth=None, hoverformat=None, insiderange=None, labelalias=None, layer=None, linecolor=None, linewidth=None, matches=None, maxallowed=None, minallowed=None, minexponent=None, minor=None, mirror=None, nticks=None, overlaying=None, position=None, range=None, rangebreaks=None, rangebreakdefaults=None, rangemode=None, rangeselector=None, rangeslider=None, scaleanchor=None, scaleratio=None, separatethousands=None, showdividers=None, showexponent=None, showgrid=None, showline=None, showspikes=None, showticklabels=None, showtickprefix=None, showticksuffix=None, side=None, spikecolor=None, spikedash=None, spikemode=None, spikesnap=None, spikethickness=None, tick0=None, tickangle=None, tickcolor=None, tickfont=None, tickformat=None, tickformatstops=None, tickformatstopdefaults=None, ticklabelindex=None, ticklabelindexsrc=None, ticklabelmode=None, ticklabeloverflow=None, ticklabelposition=None, ticklabelshift=None, ticklabelstandoff=None, ticklabelstep=None, ticklen=None, tickmode=None, tickprefix=None, ticks=None, tickson=None, ticksuffix=None, ticktext=None, ticktextsrc=None, tickvals=None, tickvalssrc=None, tickwidth=None, title=None, titlefont=None, type=None, uirevision=None, visible=None, zeroline=None, zerolinecolor=None, zerolinewidth=None, **kwargs)¶ -
property
anchor
¶ If set to an opposite-letter axis id (e.g.
x2
,y
), this axis is bound to the corresponding opposite-letter axis. If set to “free”, this axis’ position is determined byposition
.- The ‘anchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘free’]
- A string that matches one of the following regular expressions:
[‘^x([2-9]|[1-9][0-9]+)?( domain)?$’, ‘^y([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
automargin
¶ Determines whether long tick labels automatically grow the figure margins.
The ‘automargin’ property is a flaglist and may be specified as a string containing:
Any combination of [‘height’, ‘width’, ‘left’, ‘right’, ‘top’, ‘bottom’] joined with ‘+’ characters (e.g. ‘height+width’) OR exactly one of [True, False] (e.g. ‘False’)
- Returns
- Return type
Any
-
property
autorange
¶ Determines whether or not the range of this axis is computed in relation to the input data. See
rangemode
for more info. Ifrange
is provided and it has a value for both the lower and upper bound,autorange
is set to False. Using “min” applies autorange only to set the minimum. Using “max” applies autorange only to set the maximum. Using min reversed applies autorange only to set the minimum on a reversed axis. Using max reversed applies autorange only to set the maximum on a reversed axis. Using “reversed” applies autorange on both ends and reverses the axis direction.- The ‘autorange’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[True, False, ‘reversed’, ‘min reversed’, ‘max reversed’, ‘min’, ‘max’]
- Returns
- Return type
Any
-
property
autorangeoptions
¶ The ‘autorangeoptions’ property is an instance of Autorangeoptions that may be specified as:
An instance of
plotly.graph_objects.layout.xaxis.Autorangeoptions
A dict of string/value properties that will be passed to the Autorangeoptions constructor
Supported dict properties:
- clipmax
Clip autorange maximum if it goes beyond this value. Has no effect when
autorangeoptions.maxallowed
is provided.- clipmin
Clip autorange minimum if it goes beyond this value. Has no effect when
autorangeoptions.minallowed
is provided.- include
Ensure this value is included in autorange.
- includesrc
Sets the source reference on Chart Studio Cloud for
include
.- maxallowed
Use this value exactly as autorange maximum.
- minallowed
Use this value exactly as autorange minimum.
- Returns
- Return type
-
property
autotickangles
¶ When
tickangle
is set to “auto”, it will be set to the first angle in this array that is large enough to prevent label overlap.The ‘autotickangles’ property is an info array that may be specified as: * a list of elements where:
The ‘autotickangles[i]’ property is a angle (in degrees) that may be
specified as a number between -180 and 180. Numeric values outside this range are converted to the equivalent value (e.g. 270 is converted to -90).
- Returns
- Return type
-
property
autotypenumbers
¶ Using “strict” a numeric string in trace data is not converted to a number. Using convert types a numeric string in trace data may be treated as a number during automatic axis
type
detection. Defaults to layout.autotypenumbers.- The ‘autotypenumbers’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘convert types’, ‘strict’]
- Returns
- Return type
Any
-
property
calendar
¶ Sets the calendar system to use for
range
andtick0
if this is a date axis. This does not set the calendar for interpreting data on this axis, that’s specified in the trace or via the globallayout.calendar
- The ‘calendar’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘chinese’, ‘coptic’, ‘discworld’, ‘ethiopian’, ‘gregorian’, ‘hebrew’, ‘islamic’, ‘jalali’, ‘julian’, ‘mayan’, ‘nanakshahi’, ‘nepali’, ‘persian’, ‘taiwan’, ‘thai’, ‘ummalqura’]
- Returns
- Return type
Any
-
property
categoryarray
¶ Sets the order in which categories on this axis appear. Only has an effect if
categoryorder
is set to “array”. Used withcategoryorder
.The ‘categoryarray’ property is an array that may be specified as a tuple, list, numpy array, or pandas Series
- Returns
- Return type
numpy.ndarray
-
property
categoryarraysrc
¶ Sets the source reference on Chart Studio Cloud for
categoryarray
.The ‘categoryarraysrc’ property must be specified as a string or as a plotly.grid_objs.Column object
- Returns
- Return type
-
property
categoryorder
¶ Specifies the ordering logic for the case of categorical variables. By default, plotly uses “trace”, which specifies the order that is present in the data supplied. Set
categoryorder
to category ascending or category descending if order should be determined by the alphanumerical order of the category names. Setcategoryorder
to “array” to derive the ordering from the attributecategoryarray
. If a category is not found in thecategoryarray
array, the sorting behavior for that attribute will be identical to the “trace” mode. The unspecified categories will follow the categories incategoryarray
. Setcategoryorder
to total ascending or total descending if order should be determined by the numerical order of the values. Similarly, the order can be determined by the min, max, sum, mean, geometric mean or median of all the values.- The ‘categoryorder’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘trace’, ‘category ascending’, ‘category descending’, ‘array’, ‘total ascending’, ‘total descending’, ‘min ascending’, ‘min descending’, ‘max ascending’, ‘max descending’, ‘sum ascending’, ‘sum descending’, ‘mean ascending’, ‘mean descending’, ‘geometric mean ascending’, ‘geometric mean descending’, ‘median ascending’, ‘median descending’]
- Returns
- Return type
Any
-
property
color
¶ Sets default for all colors associated with this axis all at once: line, font, tick, and grid colors. Grid color is lightened by blending this with the plot background Individual pieces can override this.
- The ‘color’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
constrain
¶ If this axis needs to be compressed (either due to its own
scaleanchor
andscaleratio
or those of the other axis), determines how that happens: by increasing the “range”, or by decreasing the “domain”. Default is “domain” for axes containing image traces, “range” otherwise.- The ‘constrain’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘range’, ‘domain’]
- Returns
- Return type
Any
-
property
constraintoward
¶ If this axis needs to be compressed (either due to its own
scaleanchor
andscaleratio
or those of the other axis), determines which direction we push the originally specified plot area. Options are “left”, “center” (default), and “right” for x axes, and “top”, “middle” (default), and “bottom” for y axes.- The ‘constraintoward’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘left’, ‘center’, ‘right’, ‘top’, ‘middle’, ‘bottom’]
- Returns
- Return type
Any
-
property
dividercolor
¶ Sets the color of the dividers Only has an effect on “multicategory” axes.
- The ‘dividercolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
dividerwidth
¶ Sets the width (in px) of the dividers Only has an effect on “multicategory” axes.
- The ‘dividerwidth’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
domain
¶ Sets the domain of this axis (in plot fraction).
The ‘domain’ property is an info array that may be specified as:
a list or tuple of 2 elements where:
- The ‘domain[0]’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- The ‘domain[1]’ property is a number and may be specified as:
An int or float in the interval [0, 1]
list
-
property
dtick
¶ Sets the step in-between ticks on this axis. Use with
tick0
. Must be a positive number, or special strings available to “log” and “date” axes. If the axistype
is “log”, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, … set dtick to 1. To set tick marks at 1, 100, 10000, … set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, … set dtick to log_10(5), or 0.69897000433. “log” has several special values; “L<f>”, wheref
is a positive number, gives ticks linearly spaced in value (but not position). For exampletick0
= 0.1,dtick
= “L0.5” will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use “D1” (all digits) or “D2” (only 2 and 5).tick0
is ignored for “D1” and “D2”. If the axistype
is “date”, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, setdtick
to 86400000.0. “date” also has special values “M<n>” gives ticks spaced by a number of months.n
must be a positive integer. To set ticks on the 15th of every third month, settick0
to “2000-01-15” anddtick
to “M3”. To set ticks every 4 years, setdtick
to “M48”The ‘dtick’ property accepts values of any type
- Returns
- Return type
Any
-
property
exponentformat
¶ Determines a formatting rule for the tick exponents. For example, consider the number 1,000,000,000. If “none”, it appears as 1,000,000,000. If “e”, 1e+9. If “E”, 1E+9. If “power”, 1x10^9 (with 9 in a super script). If “SI”, 1G. If “B”, 1B.
- The ‘exponentformat’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘none’, ‘e’, ‘E’, ‘power’, ‘SI’, ‘B’]
- Returns
- Return type
Any
-
property
fixedrange
¶ Determines whether or not this axis is zoom-able. If true, then zoom is disabled.
The ‘fixedrange’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
gridcolor
¶ Sets the color of the grid lines.
- The ‘gridcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
griddash
¶ Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- The ‘griddash’ property is an enumeration that may be specified as:
- One of the following dash styles:
[‘solid’, ‘dot’, ‘dash’, ‘longdash’, ‘dashdot’, ‘longdashdot’]
- A string containing a dash length list in pixels or percentages
(e.g. ‘5px 10px 2px 2px’, ‘5, 10, 2, 2’, ‘10% 20% 40%’, etc.)
- Returns
- Return type
-
property
gridwidth
¶ Sets the width (in px) of the grid lines.
- The ‘gridwidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
hoverformat
¶ Sets the hover text formatting rule using d3 formatting mini- languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- The ‘hoverformat’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
insiderange
¶ - Could be used to set the desired inside range of this axis
(excluding the labels) when
ticklabelposition
of the anchored axis has “inside”. Not implemented for axes withtype
“log”. This would be ignored whenrange
is provided.The ‘insiderange’ property is an info array that may be specified as:
a list or tuple of 2 elements where:
The ‘insiderange[0]’ property accepts values of any type
The ‘insiderange[1]’ property accepts values of any type
list
-
property
labelalias
¶ Replacement text for specific tick or hover labels. For example using {US: ‘USA’, CA: ‘Canada’} changes US to USA and CA to Canada. The labels we would have shown must match the keys exactly, after adding any tickprefix or ticksuffix. For negative numbers the minus sign symbol used (U+2212) is wider than the regular ascii dash. That means you need to use −1 instead of -1. labelalias can be used with any axis type, and both keys (if needed) and values (if desired) can include html- like tags or MathJax.
The ‘labelalias’ property accepts values of any type
- Returns
- Return type
Any
-
property
layer
¶ Sets the layer on which this axis is displayed. If above traces, this axis is displayed above all the subplot’s traces If below traces, this axis is displayed below all the subplot’s traces, but above the grid lines. Useful when used together with scatter-like traces with
cliponaxis
set to False to show markers and/or text nodes above this axis.- The ‘layer’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘above traces’, ‘below traces’]
- Returns
- Return type
Any
-
property
linecolor
¶ Sets the axis line color.
- The ‘linecolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
linewidth
¶ Sets the width (in px) of the axis line.
- The ‘linewidth’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
matches
¶ If set to another axis id (e.g.
x2
,y
), the range of this axis will match the range of the corresponding axis in data- coordinates space. Moreover, matching axes share auto-range values, category lists and histogram auto-bins. Note that setting axes simultaneously in both ascaleanchor
and amatches
constraint is currently forbidden. Moreover, note that matching axes must have the sametype
.- The ‘matches’ property is an enumeration that may be specified as:
- A string that matches one of the following regular expressions:
[‘^x([2-9]|[1-9][0-9]+)?( domain)?$’, ‘^y([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
maxallowed
¶ Determines the maximum range of this axis.
The ‘maxallowed’ property accepts values of any type
- Returns
- Return type
Any
-
property
minallowed
¶ Determines the minimum range of this axis.
The ‘minallowed’ property accepts values of any type
- Returns
- Return type
Any
-
property
minexponent
¶ Hide SI prefix for 10^n if |n| is below this number. This only has an effect when
tickformat
is “SI” or “B”.- The ‘minexponent’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
minor
¶ The ‘minor’ property is an instance of Minor that may be specified as:
An instance of
plotly.graph_objects.layout.xaxis.Minor
A dict of string/value properties that will be passed to the Minor constructor
Supported dict properties:
- dtick
Sets the step in-between ticks on this axis. Use with
tick0
. Must be a positive number, or special strings available to “log” and “date” axes. If the axistype
is “log”, then ticks are set every 10^(n*dtick) where n is the tick number. For example, to set a tick mark at 1, 10, 100, 1000, … set dtick to 1. To set tick marks at 1, 100, 10000, … set dtick to 2. To set tick marks at 1, 5, 25, 125, 625, 3125, … set dtick to log_10(5), or 0.69897000433. “log” has several special values; “L<f>”, wheref
is a positive number, gives ticks linearly spaced in value (but not position). For exampletick0
= 0.1,dtick
= “L0.5” will put ticks at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10 plus small digits between, use “D1” (all digits) or “D2” (only 2 and 5).tick0
is ignored for “D1” and “D2”. If the axistype
is “date”, then you must convert the time to milliseconds. For example, to set the interval between ticks to one day, setdtick
to 86400000.0. “date” also has special values “M<n>” gives ticks spaced by a number of months.n
must be a positive integer. To set ticks on the 15th of every third month, settick0
to “2000-01-15” anddtick
to “M3”. To set ticks every 4 years, setdtick
to “M48”- gridcolor
Sets the color of the grid lines.
- griddash
Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- gridwidth
Sets the width (in px) of the grid lines.
- nticks
Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to
nticks
. Has an effect only iftickmode
is set to “auto”.- showgrid
Determines whether or not grid lines are drawn. If True, the grid lines are drawn at every tick mark.
- tick0
Sets the placement of the first tick on this axis. Use with
dtick
. If the axistype
is “log”, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set thetick0
to 2) except whendtick`=*L<f>* (see `dtick
for more info). If the axistype
is “date”, it should be a date string, like date data. If the axistype
is “category”, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.- tickcolor
Sets the tick color.
- ticklen
Sets the tick length (in px).
- tickmode
Sets the tick mode for this axis. If “auto”, the number of ticks is set via
nticks
. If “linear”, the placement of the ticks is determined by a starting positiontick0
and a tick stepdtick
(“linear” is the default value iftick0
anddtick
are provided). If “array”, the placement of the ticks is set viatickvals
and the tick text isticktext
. (“array” is the default value iftickvals
is provided).- ticks
Determines whether ticks are drawn or not. If “”, this axis’ ticks are not drawn. If “outside” (“inside”), this axis’ are drawn outside (inside) the axis lines.
- tickvals
Sets the values at which ticks on this axis appear. Only has an effect if
tickmode
is set to “array”. Used withticktext
.- tickvalssrc
Sets the source reference on Chart Studio Cloud for
tickvals
.- tickwidth
Sets the tick width (in px).
- Returns
- Return type
-
property
mirror
¶ Determines if the axis lines or/and ticks are mirrored to the opposite side of the plotting area. If True, the axis lines are mirrored. If “ticks”, the axis lines and ticks are mirrored. If False, mirroring is disable. If “all”, axis lines are mirrored on all shared-axes subplots. If “allticks”, axis lines and ticks are mirrored on all shared-axes subplots.
- The ‘mirror’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[True, ‘ticks’, False, ‘all’, ‘allticks’]
- Returns
- Return type
Any
-
property
nticks
¶ Specifies the maximum number of ticks for the particular axis. The actual number of ticks will be chosen automatically to be less than or equal to
nticks
. Has an effect only iftickmode
is set to “auto”.- The ‘nticks’ property is a integer and may be specified as:
An int (or float that will be cast to an int) in the interval [0, 9223372036854775807]
- Returns
- Return type
-
property
overlaying
¶ If set a same-letter axis id, this axis is overlaid on top of the corresponding same-letter axis, with traces and axes visible for both axes. If False, this axis does not overlay any same-letter axes. In this case, for axes with overlapping domains only the highest-numbered axis will be visible.
- The ‘overlaying’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘free’]
- A string that matches one of the following regular expressions:
[‘^x([2-9]|[1-9][0-9]+)?( domain)?$’, ‘^y([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
position
¶ Sets the position of this axis in the plotting space (in normalized coordinates). Only has an effect if
anchor
is set to “free”.- The ‘position’ property is a number and may be specified as:
An int or float in the interval [0, 1]
- Returns
- Return type
int|float
-
property
range
¶ - Sets the range of this axis. If the axis
type
is “log”, then you must take the log of your desired range (e.g. to set the range from 1 to 100, set the range from 0 to 2). If the axis
type
is “date”, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axistype
is “category”, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears. Leaving either or both elementsnull
impacts the defaultautorange
.The ‘range’ property is an info array that may be specified as:
a list or tuple of 2 elements where:
The ‘range[0]’ property accepts values of any type
The ‘range[1]’ property accepts values of any type
list
- Sets the range of this axis. If the axis
-
property
rangebreakdefaults
¶ When used in a template (as layout.template.layout.xaxis.rangebreakdefaults), sets the default property values to use for elements of layout.xaxis.rangebreaks
The ‘rangebreakdefaults’ property is an instance of Rangebreak that may be specified as:
An instance of
plotly.graph_objects.layout.xaxis.Rangebreak
A dict of string/value properties that will be passed to the Rangebreak constructor
Supported dict properties:
- Returns
- Return type
-
property
rangebreaks
¶ The ‘rangebreaks’ property is a tuple of instances of Rangebreak that may be specified as:
A list or tuple of instances of plotly.graph_objects.layout.xaxis.Rangebreak
A list or tuple of dicts of string/value properties that will be passed to the Rangebreak constructor
Supported dict properties:
- bounds
Sets the lower and upper bounds of this axis rangebreak. Can be used with
pattern
.- dvalue
Sets the size of each
values
item. The default is one day in milliseconds.- enabled
Determines whether this axis rangebreak is enabled or disabled. Please note that
rangebreaks
only work for “date” axis type.- name
When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- pattern
Determines a pattern on the time line that generates breaks. If day of week - days of the week in English e.g. ‘Sunday’ or
sun
(matching is case-insensitive and considers only the first three characters), as well as Sunday-based integers between 0 and 6. If “hour” - hour (24-hour clock) as decimal numbers between 0 and 24. for more info. Examples: - { pattern: ‘day of week’, bounds: [6, 1] } or simply { bounds: [‘sat’, ‘mon’] } breaks from Saturday to Monday (i.e. skips the weekends). - { pattern: ‘hour’, bounds: [17, 8] } breaks from 5pm to 8am (i.e. skips non-work hours).- templateitemname
Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- values
Sets the coordinate values corresponding to the rangebreaks. An alternative to
bounds
. Usedvalue
to set the size of the values along the axis.
- Returns
- Return type
-
property
rangemode
¶ If “normal”, the range is computed in relation to the extrema of the input data. If *tozero*`, the range extends to 0, regardless of the input data If “nonnegative”, the range is non-negative, regardless of the input data. Applies only to linear axes.
- The ‘rangemode’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘normal’, ‘tozero’, ‘nonnegative’]
- Returns
- Return type
Any
-
property
rangeselector
¶ The ‘rangeselector’ property is an instance of Rangeselector that may be specified as:
An instance of
plotly.graph_objects.layout.xaxis.Rangeselector
A dict of string/value properties that will be passed to the Rangeselector constructor
Supported dict properties:
- activecolor
Sets the background color of the active range selector button.
- bgcolor
Sets the background color of the range selector buttons.
- bordercolor
Sets the color of the border enclosing the range selector.
- borderwidth
Sets the width (in px) of the border enclosing the range selector.
- buttons
Sets the specifications for each buttons. By default, a range selector comes with no buttons.
- buttondefaults
When used in a template (as layout.template.lay out.xaxis.rangeselector.buttondefaults), sets the default property values to use for elements of layout.xaxis.rangeselector.buttons
- font
Sets the font of the range selector button text.
- visible
Determines whether or not this range selector is visible. Note that range selectors are only available for x axes of
type
set to or auto- typed to “date”.- x
Sets the x position (in normalized coordinates) of the range selector.
- xanchor
Sets the range selector’s horizontal position anchor. This anchor binds the
x
position to the “left”, “center” or “right” of the range selector.- y
Sets the y position (in normalized coordinates) of the range selector.
- yanchor
Sets the range selector’s vertical position anchor This anchor binds the
y
position to the “top”, “middle” or “bottom” of the range selector.
- Returns
- Return type
-
property
rangeslider
¶ The ‘rangeslider’ property is an instance of Rangeslider that may be specified as:
An instance of
plotly.graph_objects.layout.xaxis.Rangeslider
A dict of string/value properties that will be passed to the Rangeslider constructor
Supported dict properties:
- autorange
Determines whether or not the range slider range is computed in relation to the input data. If
range
is provided, thenautorange
is set to False.- bgcolor
Sets the background color of the range slider.
- bordercolor
Sets the border color of the range slider.
- borderwidth
Sets the border width of the range slider.
- range
Sets the range of the range slider. If not set, defaults to the full xaxis range. If the axis
type
is “log”, then you must take the log of your desired range. If the axistype
is “date”, it should be date strings, like date data, though Date objects and unix milliseconds will be accepted and converted to strings. If the axistype
is “category”, it should be numbers, using the scale where each category is assigned a serial number from zero in the order it appears.- thickness
The height of the range slider as a fraction of the total plot area height.
- visible
Determines whether or not the range slider will be visible. If visible, perpendicular axes will be set to
fixedrange
- yaxis
plotly.graph_objects.layout.xaxis.range slider.YAxis
instance or dict with compatible properties
- Returns
- Return type
-
property
scaleanchor
¶ If set to another axis id (e.g.
x2
,y
), the range of this axis changes together with the range of the corresponding axis such that the scale of pixels per unit is in a constant ratio. Both axes are still zoomable, but when you zoom one, the other will zoom the same amount, keeping a fixed midpoint.constrain
andconstraintoward
determine how we enforce the constraint. You can chain these, ieyaxis: {scaleanchor: *x*}, xaxis2: {scaleanchor: *y*}
but you can only link axes of the sametype
. The linked axis can have the opposite letter (to constrain the aspect ratio) or the same letter (to match scales across subplots). Loops (yaxis: {scaleanchor: *x*}, xaxis: {scaleanchor: *y*}
or longer) are redundant and the last constraint encountered will be ignored to avoid possible inconsistent constraints viascaleratio
. Note that setting axes simultaneously in both ascaleanchor
and amatches
constraint is currently forbidden. Settingfalse
allows to remove a default constraint (occasionally, you may need to prevent a defaultscaleanchor
constraint from being applied, eg. when having an image traceyaxis: {scaleanchor: "x"}
is set automatically in order for pixels to be rendered as squares, settingyaxis: {scaleanchor: false}
allows to remove the constraint).- The ‘scaleanchor’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[False]
- A string that matches one of the following regular expressions:
[‘^x([2-9]|[1-9][0-9]+)?( domain)?$’, ‘^y([2-9]|[1-9][0-9]+)?( domain)?$’]
- Returns
- Return type
Any
-
property
scaleratio
¶ If this axis is linked to another by
scaleanchor
, this determines the pixel to unit scale ratio. For example, if this value is 10, then every unit on this axis spans 10 times the number of pixels as a unit on the linked axis. Use this for example to create an elevation profile where the vertical scale is exaggerated a fixed amount with respect to the horizontal.- The ‘scaleratio’ property is a number and may be specified as:
An int or float in the interval [0, inf]
- Returns
- Return type
int|float
-
property
separatethousands
¶ If “true”, even 4-digit integers are separated
The ‘separatethousands’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showdividers
¶ Determines whether or not a dividers are drawn between the category levels of this axis. Only has an effect on “multicategory” axes.
The ‘showdividers’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showexponent
¶ If “all”, all exponents are shown besides their significands. If “first”, only the exponent of the first tick is shown. If “last”, only the exponent of the last tick is shown. If “none”, no exponents appear.
- The ‘showexponent’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘all’, ‘first’, ‘last’, ‘none’]
- Returns
- Return type
Any
-
property
showgrid
¶ Determines whether or not grid lines are drawn. If True, the grid lines are drawn at every tick mark.
The ‘showgrid’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showline
¶ Determines whether or not a line bounding this axis is drawn.
The ‘showline’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showspikes
¶ Determines whether or not spikes (aka droplines) are drawn for this axis. Note: This only takes affect when hovermode = closest
The ‘showspikes’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showticklabels
¶ Determines whether or not the tick labels are drawn.
The ‘showticklabels’ property must be specified as a bool (either True, or False)
- Returns
- Return type
-
property
showtickprefix
¶ If “all”, all tick labels are displayed with a prefix. If “first”, only the first tick is displayed with a prefix. If “last”, only the last tick is displayed with a suffix. If “none”, tick prefixes are hidden.
- The ‘showtickprefix’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘all’, ‘first’, ‘last’, ‘none’]
- Returns
- Return type
Any
-
property
showticksuffix
¶ Same as
showtickprefix
but for tick suffixes.- The ‘showticksuffix’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘all’, ‘first’, ‘last’, ‘none’]
- Returns
- Return type
Any
-
property
side
¶ Determines whether a x (y) axis is positioned at the “bottom” (“left”) or “top” (“right”) of the plotting area.
- The ‘side’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘top’, ‘bottom’, ‘left’, ‘right’]
- Returns
- Return type
Any
-
property
spikecolor
¶ Sets the spike color. If undefined, will use the series color
- The ‘spikecolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
spikedash
¶ Sets the dash style of lines. Set to a dash type string (“solid”, “dot”, “dash”, “longdash”, “dashdot”, or “longdashdot”) or a dash length list in px (eg “5px,10px,2px,2px”).
- The ‘spikedash’ property is an enumeration that may be specified as:
- One of the following dash styles:
[‘solid’, ‘dot’, ‘dash’, ‘longdash’, ‘dashdot’, ‘longdashdot’]
- A string containing a dash length list in pixels or percentages
(e.g. ‘5px 10px 2px 2px’, ‘5, 10, 2, 2’, ‘10% 20% 40%’, etc.)
- Returns
- Return type
-
property
spikemode
¶ Determines the drawing mode for the spike line If “toaxis”, the line is drawn from the data point to the axis the series is plotted on. If “across”, the line is drawn across the entire plot area, and supercedes “toaxis”. If “marker”, then a marker dot is drawn on the axis the series is plotted on
The ‘spikemode’ property is a flaglist and may be specified as a string containing:
Any combination of [‘toaxis’, ‘across’, ‘marker’] joined with ‘+’ characters (e.g. ‘toaxis+across’)
- Returns
- Return type
Any
-
property
spikesnap
¶ Determines whether spikelines are stuck to the cursor or to the closest datapoints.
- The ‘spikesnap’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘data’, ‘cursor’, ‘hovered data’]
- Returns
- Return type
Any
-
property
spikethickness
¶ Sets the width (in px) of the zero line.
- The ‘spikethickness’ property is a number and may be specified as:
An int or float
- Returns
- Return type
int|float
-
property
tick0
¶ Sets the placement of the first tick on this axis. Use with
dtick
. If the axistype
is “log”, then you must take the log of your starting tick (e.g. to set the starting tick to 100, set thetick0
to 2) except whendtick`=*L<f>* (see `dtick
for more info). If the axistype
is “date”, it should be a date string, like date data. If the axistype
is “category”, it should be a number, using the scale where each category is assigned a serial number from zero in the order it appears.The ‘tick0’ property accepts values of any type
- Returns
- Return type
Any
-
property
tickangle
¶ Sets the angle of the tick labels with respect to the horizontal. For example, a
tickangle
of -90 draws the tick labels vertically.The ‘tickangle’ property is a angle (in degrees) that may be specified as a number between -180 and 180. Numeric values outside this range are converted to the equivalent value (e.g. 270 is converted to -90).
- Returns
- Return type
int|float
-
property
tickcolor
¶ Sets the tick color.
- The ‘tickcolor’ property is a color and may be specified as:
A hex string (e.g. ‘#ff0000’)
An rgb/rgba string (e.g. ‘rgb(255,0,0)’)
An hsl/hsla string (e.g. ‘hsl(0,100%,50%)’)
An hsv/hsva string (e.g. ‘hsv(0,100%,100%)’)
- A named CSS color:
aliceblue, antiquewhite, aqua, aquamarine, azure, beige, bisque, black, blanchedalmond, blue, blueviolet, brown, burlywood, cadetblue, chartreuse, chocolate, coral, cornflowerblue, cornsilk, crimson, cyan, darkblue, darkcyan, darkgoldenrod, darkgray, darkgrey, darkgreen, darkkhaki, darkmagenta, darkolivegreen, darkorange, darkorchid, darkred, darksalmon, darkseagreen, darkslateblue, darkslategray, darkslategrey, darkturquoise, darkviolet, deeppink, deepskyblue, dimgray, dimgrey, dodgerblue, firebrick, floralwhite, forestgreen, fuchsia, gainsboro, ghostwhite, gold, goldenrod, gray, grey, green, greenyellow, honeydew, hotpink, indianred, indigo, ivory, khaki, lavender, lavenderblush, lawngreen, lemonchiffon, lightblue, lightcoral, lightcyan, lightgoldenrodyellow, lightgray, lightgrey, lightgreen, lightpink, lightsalmon, lightseagreen, lightskyblue, lightslategray, lightslategrey, lightsteelblue, lightyellow, lime, limegreen, linen, magenta, maroon, mediumaquamarine, mediumblue, mediumorchid, mediumpurple, mediumseagreen, mediumslateblue, mediumspringgreen, mediumturquoise, mediumvioletred, midnightblue, mintcream, mistyrose, moccasin, navajowhite, navy, oldlace, olive, olivedrab, orange, orangered, orchid, palegoldenrod, palegreen, paleturquoise, palevioletred, papayawhip, peachpuff, peru, pink, plum, powderblue, purple, red, rosybrown, royalblue, rebeccapurple, saddlebrown, salmon, sandybrown, seagreen, seashell, sienna, silver, skyblue, slateblue, slategray, slategrey, snow, springgreen, steelblue, tan, teal, thistle, tomato, turquoise, violet, wheat, white, whitesmoke, yellow, yellowgreen
- Returns
- Return type
-
property
tickfont
¶ Sets the tick font.
The ‘tickfont’ property is an instance of Tickfont that may be specified as:
An instance of
plotly.graph_objects.layout.xaxis.Tickfont
A dict of string/value properties that will be passed to the Tickfont constructor
Supported dict properties:
color
- family
HTML 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 which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren’t available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include “Arial”, “Balto”, “Courier New”, “Droid Sans”, “Droid Serif”, “Droid Sans Mono”, “Gravitas One”, “Old Standard TT”, “Open Sans”, “Overpass”, “PT Sans Narrow”, “Raleway”, “Times New Roman”.
- lineposition
Sets the kind of decoration line(s) with text, such as an “under”, “over” or “through” as well as combinations e.g. “under+over”, etc.
- shadow
Sets the shape and color of the shadow behind text. “auto” places minimal shadow and applies contrast text font color. See https://developer.mozilla.org/en- US/docs/Web/CSS/text-shadow for additional options.
size
- style
Sets whether a font should be styled with a normal or italic face from its family.
- textcase
Sets capitalization of text. It can be used to make text appear in all-uppercase or all- lowercase, or with each word capitalized.
- variant
Sets the variant of the font.
- weight
Sets the weight (or boldness) of the font.
- Returns
- Return type
-
property
tickformat
¶ Sets the tick label formatting rule using d3 formatting mini- languages which are very similar to those in Python. For numbers, see: https://github.com/d3/d3-format/tree/v1.4.5#d3-format. And for dates see: https://github.com/d3/d3-time- format/tree/v2.2.3#locale_format. We add two items to d3’s date formatter: “%h” for half of the year as a decimal number as well as “%{n}f” for fractional seconds with n digits. For example, 2016-10-13 09:15:23.456 with tickformat “%H~%M~%S.%2f” would display “09~15~23.46”
- The ‘tickformat’ property is a string and must be specified as:
A string
A number that will be converted to a string
- Returns
- Return type
-
property
tickformatstopdefaults
¶ When used in a template (as layout.template.layout.xaxis.tickformatstopdefaults), sets the default property values to use for elements of layout.xaxis.tickformatstops
The ‘tickformatstopdefaults’ property is an instance of Tickformatstop that may be specified as:
An instance of
plotly.graph_objects.layout.xaxis.Tickformatstop
A dict of string/value properties that will be passed to the Tickformatstop constructor
Supported dict properties:
- Returns
- Return type
-
property
tickformatstops
¶ The ‘tickformatstops’ property is a tuple of instances of Tickformatstop that may be specified as:
A list or tuple of instances of plotly.graph_objects.layout.xaxis.Tickformatstop
A list or tuple of dicts of string/value properties that will be passed to the Tickformatstop constructor
Supported dict properties:
- dtickrange
range [min, max], where “min”, “max” - dtick values which describe some zoom level, it is possible to omit “min” or “max” value by passing “null”
- enabled
Determines whether or not this stop is used. If
false
, this stop is ignored even within itsdtickrange
.- name
When used in a template, named items are created in the output figure in addition to any items the figure already has in this array. You can modify these items in the output figure by making your own item with
templateitemname
matching thisname
alongside your modifications (includingvisible: false
orenabled: false
to hide it). Has no effect outside of a template.- templateitemname
Used to refer to a named item in this array in the template. Named items from the template will be created even without a matching item in the input figure, but you can modify one by making an item with
templateitemname
matching itsname
, alongside your modifications (includingvisible: false
orenabled: false
to hide it). If there is no template or no matching item, this item will be hidden unless you explicitly show it withvisible: true
.- value
string - dtickformat for described zoom level, the same as “tickformat”
- Returns
- Return type
-
property
ticklabelindex
¶ Only for axes with
type
“date” or “linear”. Instead of drawing the major tick label, draw the label for the minor tick that is n positions away from the major tick. E.g. to always draw the label for the minor tick before each major tick, chooseticklabelindex
-1. This is useful for date axes withticklabelmode
“period” if you want to label the period that ends with each major tick instead of the period that begins there.- The ‘ticklabelindex’ property is a integer and may be specified as:
An int (or float that will be cast to an int)
A tuple, list, or one-dimensional numpy array of the above
- Returns
- Return type
int|numpy.ndarray
-
property
ticklabelindexsrc
¶ Sets the source reference on Chart Studio Cloud for
ticklabelindex
.The ‘ticklabelindexsrc’ property must be specified as a string or as a plotly.grid_objs.Column object
- Returns
- Return type
-
property
ticklabelmode
¶ Determines where tick labels are drawn with respect to their corresponding ticks and grid lines. Only has an effect for axes of
type
“date” When set to “period”, tick labels are drawn in the middle of the period between ticks.- The ‘ticklabelmode’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘instant’, ‘period’]
- Returns
- Return type
Any
-
property
ticklabeloverflow
¶ Determines how we handle tick labels that would overflow either the graph div or the domain of the axis. The default value for inside tick labels is hide past domain. Otherwise on “category” and “multicategory” axes the default is “allow”. In other cases the default is hide past div.
- The ‘ticklabeloverflow’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘allow’, ‘hide past div’, ‘hide past domain’]
- Returns
- Return type
Any
-
property
ticklabelposition
¶ Determines where tick labels are drawn with respect to the axis Please note that top or bottom has no effect on x axes or when
ticklabelmode
is set to “period”. Similarly left or right has no effect on y axes or whenticklabelmode
is set to “period”. Has no effect on “multicategory” axes or whentickson
is set to “boundaries”. When used on axes linked bymatches
orscaleanchor
, no extra padding for inside labels would be added by autorange, so that the scales could match.- The ‘ticklabelposition’ property is an enumeration that may be specified as:
- One of the following enumeration values:
[‘outside’, ‘inside’, ‘outside top’, ‘inside top’, ‘outside left’, ‘inside left’, ‘outside right’, ‘inside right’, ‘outside bottom’, ‘inside bottom’]
- Returns
- Return type
Any
-
property
ticklabelshift
¶ Shifts the tick labels by the specified number of pixels in parallel to the axis. Positive values move the labels in the positive direction of the axis.
- The ‘ticklabelshift’ property is a integer and may be specified as:
An int (or float that will be cast to an int)
- Returns
- Return type
-
property
ticklabelstandoff
¶ Sets the standoff distance (in px) between the axis tick labels and their default position. A positive
ticklabelstandoff
moves the labels farther away from the plot area ifticklabelposition
is “outside”, and deeper into the plot area ifticklabelposition
is “inside”. A negativeticklabelstandoff
works in the opposite direction, moving outside ticks towards the plot area and inside ticks towards the outside. If the negative value is large enough, inside ticks can even end up outside and vice versa.- The ‘ticklabelstandoff’ property is a integer and may be specified as:
An int (or float that will be cast to an int)
-
property