Selection Events in Python/v3
Selection Events With FigureWidget
Note: this page is part of the documentation for version 3 of Plotly.py, which is not the most recent version.
See our Version 4 Migration Guide for information about how to upgrade.
See our Version 4 Migration Guide for information about how to upgrade.
New to Plotly?¶
Plotly's Python library is free and open source! Get started by downloading the client and reading the primer.
You can set up Plotly to work in online or offline mode, or in jupyter notebooks.
We also have a quick-reference cheatsheet (new!) to help you get started!
Populate a Table Using a Plotly Mouse Selection Event¶
Create a table FigureWidget that is updated by a selection event in another FigureWidget. The rows in the table correspond to points selected in the selection event.
In [7]:
import plotly.graph_objs as go
import plotly.offline as py
import pandas as pd
import numpy as np
from ipywidgets import interactive, HBox, VBox
py.init_notebook_mode()
df = pd.read_csv('https://raw.githubusercontent.com/jonmmease/plotly_ipywidget_notebooks/master/notebooks/data/cars/cars.csv')
f = go.FigureWidget([go.Scatter(y = df['City mpg'], x = df['City mpg'], mode = 'markers')])
scatter = f.data[0]
N = len(df)
scatter.x = scatter.x + np.random.rand(N)/10 *(df['City mpg'].max() - df['City mpg'].min())
scatter.y = scatter.y + np.random.rand(N)/10 *(df['City mpg'].max() - df['City mpg'].min())
scatter.marker.opacity = 0.5
def update_axes(xaxis, yaxis):
scatter = f.data[0]
scatter.x = df[xaxis]
scatter.y = df[yaxis]
with f.batch_update():
f.layout.xaxis.title = xaxis
f.layout.yaxis.title = yaxis
scatter.x = scatter.x + np.random.rand(N)/10 *(df[xaxis].max() - df[xaxis].min())
scatter.y = scatter.y + np.random.rand(N)/10 *(df[yaxis].max() - df[yaxis].min())
axis_dropdowns = interactive(update_axes, yaxis = df.select_dtypes('int64').columns, xaxis = df.select_dtypes('int64').columns)
# Create a table FigureWidget that updates on selection from points in the scatter plot of f
t = go.FigureWidget([go.Table(
header=dict(values=['ID','Classification','Driveline','Hybrid'],
fill = dict(color='#C2D4FF'),
align = ['left'] * 5),
cells=dict(values=[df[col] for col in ['ID','Classification','Driveline','Hybrid']],
fill = dict(color='#F5F8FF'),
align = ['left'] * 5))])
def selection_fn(trace,points,selector):
t.data[0].cells.values = [df.loc[points.point_inds][col] for col in ['ID','Classification','Driveline','Hybrid']]
scatter.on_selection(selection_fn)
# Put everything together
VBox((HBox(axis_dropdowns.children),f,t))
Reference¶
See these Jupyter notebooks for even more FigureWidget examples.
In [12]:
help(go.FigureWidget)
Help on class FigureWidget in module plotly.graph_objs._figurewidget:
class FigureWidget(plotly.basewidget.BaseFigureWidget)
| Method resolution order:
| FigureWidget
| plotly.basewidget.BaseFigureWidget
| plotly.basedatatypes.BaseFigure
| ipywidgets.widgets.domwidget.DOMWidget
| ipywidgets.widgets.widget.Widget
| ipywidgets.widgets.widget.LoggingHasTraits
| traitlets.traitlets.HasTraits
| traitlets.traitlets.HasDescriptors
| __builtin__.object
|
| Methods defined here:
|
| __init__(self, data=None, layout=None, frames=None)
| Create a new FigureWidget instance
|
| Parameters
| ----------
| data
| The 'data' property is a tuple of trace instances
| that may be specified as:
| - A list or tuple of trace instances
| (e.g. [Scatter(...), Bar(...)])
| - A list or tuple of dicts of string/value properties where:
| - The 'type' property specifies the trace type
| One of: ['area', 'bar', 'box', 'candlestick', 'carpet',
| 'choropleth', 'cone', 'contour',
| 'contourcarpet', 'heatmap', 'heatmapgl',
| 'histogram', 'histogram2d',
| 'histogram2dcontour', 'mesh3d', 'ohlc',
| 'parcoords', 'pie', 'pointcloud', 'sankey',
| 'scatter', 'scatter3d', 'scattercarpet',
| 'scattergeo', 'scattergl', 'scattermapbox',
| 'scatterpolar', 'scatterpolargl',
| 'scatterternary', 'splom', 'surface', 'table',
| 'violin']
|
| - All remaining properties are passed to the constructor of
| the specified trace type
|
| (e.g. [{'type': 'scatter', ...}, {'type': 'bar, ...}])
| layout
| The 'layout' property is an instance of Layout
| that may be specified as:
| - An instance of plotly.graph_objs.Layout
| - A dict of string/value properties that will be passed
| to the Layout constructor
|
| Supported dict properties:
|
| angularaxis
| plotly.graph_objs.layout.AngularAxis instance
| or dict with compatible properties
| annotations
| plotly.graph_objs.layout.Annotation instance or
| dict with compatible properties
| 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.
| 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 an *opacity* to see
| multiple bars.
| barnorm
| Sets the normalization for bar traces on the
| graph. With *fraction*, the value of each bar
| is divide by the sum of the values at the
| location coordinate. With *percent*, the
| results form *fraction* are presented in
| percents.
| boxgap
| Sets the gap (in plot fraction) between boxes
| of adjacent location coordinates.
| boxgroupgap
| Sets the gap (in plot fraction) between boxes
| of the same location coordinate.
| 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.
| calendar
| Sets the default calendar system to use for
| interpreting and displaying dates throughout
| the plot.
| colorway
| Sets the default trace colors.
| 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.
| direction
| For polar plots only. Sets the direction
| corresponding to positive angles.
| 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.
| font
| Sets the global font. Note that fonts used in
| traces and other layout components inherit from
| the global font.
| geo
| plotly.graph_objs.layout.Geo instance or dict
| with compatible properties
| grid
| plotly.graph_objs.layout.Grid instance or dict
| with compatible properties
| height
| Sets the plot's height (in px).
| hiddenlabels
|
| hiddenlabelssrc
| Sets the source reference on plot.ly 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 plotly service (at
| https://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_objs.layout.Hoverlabel instance or
| dict with compatible properties
| hovermode
| Determines the mode of hover interactions.
| images
| plotly.graph_objs.layout.Image instance or dict
| with compatible properties
| legend
| plotly.graph_objs.layout.Legend instance or
| dict with compatible properties
| mapbox
| plotly.graph_objs.layout.Mapbox instance or
| dict with compatible properties
| margin
| plotly.graph_objs.layout.Margin instance or
| dict with compatible properties
| orientation
| For polar plots only. Rotates the entire polar
| by the given angle.
| paper_bgcolor
| Sets the color of paper where the graph is
| drawn.
| plot_bgcolor
| Sets the color of plotting area in-between x
| and y axes.
| polar
| plotly.graph_objs.layout.Polar instance or dict
| with compatible properties
| radialaxis
| plotly.graph_objs.layout.RadialAxis instance or
| dict with compatible properties
| scene
| plotly.graph_objs.layout.Scene instance or dict
| with compatible properties
| selectdirection
| 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.
| 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
| plotly.graph_objs.layout.Shape instance or dict
| with compatible properties
| showlegend
| Determines whether or not a legend is drawn.
| sliders
| plotly.graph_objs.layout.Slider instance or
| dict with compatible properties
| spikedistance
| 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.
| ternary
| plotly.graph_objs.layout.Ternary instance or
| dict with compatible properties
| title
| Sets the plot's title.
| titlefont
| Sets the title font.
| updatemenus
| plotly.graph_objs.layout.Updatemenu instance or
| dict with compatible properties
| violingap
| Sets the gap (in plot fraction) between violins
| of adjacent location coordinates.
| violingroupgap
| Sets the gap (in plot fraction) between violins
| of the same location coordinate.
| 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.
| width
| Sets the plot's width (in px).
| xaxis
| plotly.graph_objs.layout.XAxis instance or dict
| with compatible properties
| yaxis
| plotly.graph_objs.layout.YAxis instance or dict
| with compatible properties
| frames
| The 'frames' property is a tuple of instances of
| Frame that may be specified as:
| - A list or tuple of instances of plotly.graph_objs.Frame
| - A list or tuple of dicts of string/value properties that
| will be passed to the Frame constructor
|
| Supported dict properties:
|
| baseframe
| The name of the frame into which this frame's
| properties are merged before applying. This is
| used to unify properties and avoid needing to
| specify the same values for the same properties
| in multiple frames.
| data
| A list of traces this frame modifies. The
| format is identical to the normal trace
| definition.
| group
| An identifier that specifies the group to which
| the frame belongs, used by animate to select a
| subset of frames.
| layout
| Layout properties which this frame modifies.
| The format is identical to the normal layout
| definition.
| name
| A label by which to identify the frame
| traces
| A list of trace indices that identify the
| respective traces in the data attribute
|
| add_area(self, customdata=None, customdatasrc=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, marker=None, name=None, opacity=None, r=None, rsrc=None, selectedpoints=None, showlegend=None, stream=None, t=None, tsrc=None, uid=None, visible=None, row=None, col=None, **kwargs)
| Add a new Area trace
|
| Parameters
| ----------
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.area.Hoverlabel instance or dict with
| compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| marker
| plotly.graph_objs.area.Marker instance or dict with
| compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| r
| For legacy polar chart only.Please switch to
| *scatterpolar* trace type.Sets the radial coordinates.
| rsrc
| Sets the source reference on plot.ly for r .
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.area.Stream instance or dict with
| compatible properties
| t
| For legacy polar chart only.Please switch to
| *scatterpolar* trace type.Sets the angular coordinates.
| tsrc
| Sets the source reference on plot.ly for t .
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Area
|
| add_bar(self, base=None, basesrc=None, cliponaxis=None, constraintext=None, customdata=None, customdatasrc=None, dx=None, dy=None, error_x=None, error_y=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hovertext=None, hovertextsrc=None, ids=None, idssrc=None, insidetextfont=None, legendgroup=None, marker=None, name=None, offset=None, offsetsrc=None, opacity=None, orientation=None, outsidetextfont=None, r=None, rsrc=None, selected=None, selectedpoints=None, showlegend=None, stream=None, t=None, text=None, textfont=None, textposition=None, textpositionsrc=None, textsrc=None, tsrc=None, uid=None, unselected=None, visible=None, width=None, widthsrc=None, x=None, x0=None, xaxis=None, xcalendar=None, xsrc=None, y=None, y0=None, yaxis=None, ycalendar=None, ysrc=None, row=None, col=None, **kwargs)
| Add a new Bar trace
|
| The data visualized by the span of the bars is set in `y` if
| `orientation` is set th *v* (the default) and the labels are
| set in `x`. By setting `orientation` to *h*, the roles are
| interchanged.
|
| Parameters
| ----------
| base
| Sets where the bar base is drawn (in position axis
| units). In *stack* or *relative* barmode, traces that
| set *base* will be excluded and drawn in *overlay* mode
| instead.
| basesrc
| Sets the source reference on plot.ly for base .
| cliponaxis
| Determines whether the text nodes are clipped about the
| subplot axes. To show the text nodes above axis lines
| and tick labels, make sure to set `xaxis.layer` and
| `yaxis.layer` to *below traces*.
| constraintext
| Constrain the size of text inside or outside a bar to
| be no larger than the bar itself.
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| dx
| Sets the x coordinate step. See `x0` for more info.
| dy
| Sets the y coordinate step. See `y0` for more info.
| error_x
| plotly.graph_objs.bar.ErrorX instance or dict with
| compatible properties
| error_y
| plotly.graph_objs.bar.ErrorY instance or dict with
| compatible properties
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.bar.Hoverlabel instance or dict with
| compatible properties
| hovertext
| Sets hover text elements associated with each (x,y)
| pair. If a single string, the same string appears over
| all the data points. If an array of string, the items
| are mapped in order to the this trace's (x,y)
| coordinates. To be seen, trace `hoverinfo` must contain
| a *text* flag.
| hovertextsrc
| Sets the source reference on plot.ly for hovertext .
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| insidetextfont
| Sets the font used for `text` lying inside the bar.
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| marker
| plotly.graph_objs.bar.Marker instance or dict with
| compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| offset
| Shifts the position where the bar is drawn (in position
| axis units). In *group* barmode, traces that set
| *offset* will be excluded and drawn in *overlay* mode
| instead.
| offsetsrc
| Sets the source reference on plot.ly for offset .
| opacity
| Sets the opacity of the trace.
| orientation
| Sets the orientation of the bars. With *v* (*h*), the
| value of the each bar spans along the vertical
| (horizontal).
| outsidetextfont
| Sets the font used for `text` lying outside the bar.
| r
| For legacy polar chart only.Please switch to
| *scatterpolar* trace type.Sets the radial coordinates.
| rsrc
| Sets the source reference on plot.ly for r .
| selected
| plotly.graph_objs.bar.Selected instance or dict with
| compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.bar.Stream instance or dict with
| compatible properties
| t
| For legacy polar chart only.Please switch to
| *scatterpolar* trace type.Sets the angular coordinates.
| text
| Sets text elements associated with each (x,y) pair. If
| a single string, the same string appears over all the
| data points. If an array of string, the items are
| mapped in order to the this trace's (x,y) coordinates.
| If trace `hoverinfo` contains a *text* flag and
| *hovertext* is not set, these elements will be seen in
| the hover labels.
| textfont
| Sets the font used for `text`.
| textposition
| Specifies the location of the `text`. *inside*
| positions `text` inside, next to the bar end (rotated
| and scaled if needed). *outside* positions `text`
| outside, next to the bar end (scaled if needed). *auto*
| positions `text` inside or outside so that `text` size
| is maximized.
| textpositionsrc
| Sets the source reference on plot.ly for textposition
| .
| textsrc
| Sets the source reference on plot.ly for text .
| tsrc
| Sets the source reference on plot.ly for t .
| uid
|
| unselected
| plotly.graph_objs.bar.Unselected instance or dict with
| compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| width
| Sets the bar width (in position axis units).
| widthsrc
| Sets the source reference on plot.ly for width .
| x
| Sets the x coordinates.
| x0
| Alternate to `x`. Builds a linear space of x
| coordinates. Use with `dx` where `x0` is the starting
| coordinate and `dx` the step.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xcalendar
| Sets the calendar system to use with `x` date data.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| Sets the y coordinates.
| y0
| Alternate to `y`. Builds a linear space of y
| coordinates. Use with `dy` where `y0` is the starting
| coordinate and `dy` the step.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ycalendar
| Sets the calendar system to use with `y` date data.
| ysrc
| Sets the source reference on plot.ly for y .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Bar
|
| add_box(self, boxmean=None, boxpoints=None, customdata=None, customdatasrc=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hoveron=None, ids=None, idssrc=None, jitter=None, legendgroup=None, line=None, marker=None, name=None, notched=None, notchwidth=None, opacity=None, orientation=None, pointpos=None, selected=None, selectedpoints=None, showlegend=None, stream=None, text=None, textsrc=None, uid=None, unselected=None, visible=None, whiskerwidth=None, x=None, x0=None, xaxis=None, xcalendar=None, xsrc=None, y=None, y0=None, yaxis=None, ycalendar=None, ysrc=None, row=None, col=None, **kwargs)
| Add a new Box trace
|
| In vertical (horizontal) box plots, statistics are computed
| using `y` (`x`) values. By supplying an `x` (`y`) array, one
| box per distinct x (y) value is drawn If no `x` (`y`) {array}
| is provided, a single box is drawn. That box position is then
| positioned with with `name` or with `x0` (`y0`) if provided.
| Each box spans from quartile 1 (Q1) to quartile 3 (Q3). The
| second quartile (Q2) is marked by a line inside the box. By
| default, the whiskers correspond to the box' edges +/- 1.5
| times the interquartile range (IQR = Q3-Q1), see *boxpoints*
| for other options.
|
| Parameters
| ----------
| boxmean
| If *true*, the mean of the box(es)' underlying
| distribution is drawn as a dashed line inside the
| box(es). If *sd* the standard deviation is also drawn.
| boxpoints
| If *outliers*, only the sample points lying outside the
| whiskers are shown If *suspectedoutliers*, the outlier
| points are shown and points either less than 4*Q1-3*Q3
| or greater than 4*Q3-3*Q1 are highlighted (see
| `outliercolor`) If *all*, all sample points are shown
| If *false*, only the box(es) are shown with no sample
| points
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| fillcolor
| Sets the fill color. Defaults to a half-transparent
| variant of the line color, marker color, or marker line
| color, whichever is available.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.box.Hoverlabel instance or dict with
| compatible properties
| hoveron
| Do the hover effects highlight individual boxes or
| sample points or both?
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| jitter
| Sets the amount of jitter in the sample points drawn.
| If *0*, the sample points align along the distribution
| axis. If *1*, the sample points are drawn in a random
| jitter of width equal to the width of the box(es).
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.box.Line instance or dict with
| compatible properties
| marker
| plotly.graph_objs.box.Marker instance or dict with
| compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover. For box traces, the name will
| also be used for the position coordinate, if `x` and
| `x0` (`y` and `y0` if horizontal) are missing and the
| position axis is categorical
| notched
| Determines whether or not notches should be drawn.
| notchwidth
| Sets the width of the notches relative to the box'
| width. For example, with 0, the notches are as wide as
| the box(es).
| opacity
| Sets the opacity of the trace.
| orientation
| Sets the orientation of the box(es). If *v* (*h*), the
| distribution is visualized along the vertical
| (horizontal).
| pointpos
| Sets the position of the sample points in relation to
| the box(es). If *0*, the sample points are places over
| the center of the box(es). Positive (negative) values
| correspond to positions to the right (left) for
| vertical boxes and above (below) for horizontal boxes
| selected
| plotly.graph_objs.box.Selected instance or dict with
| compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.box.Stream instance or dict with
| compatible properties
| text
| Sets the text elements associated with each sample
| value. If a single string, the same string appears over
| all the data points. If an array of string, the items
| are mapped in order to the this trace's (x,y)
| coordinates. To be seen, trace `hoverinfo` must contain
| a *text* flag.
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| unselected
| plotly.graph_objs.box.Unselected instance or dict with
| compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| whiskerwidth
| Sets the width of the whiskers relative to the box'
| width. For example, with 1, the whiskers are as wide as
| the box(es).
| x
| Sets the x sample data or coordinates. See overview for
| more info.
| x0
| Sets the x coordinate of the box. See overview for more
| info.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xcalendar
| Sets the calendar system to use with `x` date data.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| Sets the y sample data or coordinates. See overview for
| more info.
| y0
| Sets the y coordinate of the box. See overview for more
| info.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ycalendar
| Sets the calendar system to use with `y` date data.
| ysrc
| Sets the source reference on plot.ly for y .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Box
|
| add_candlestick(self, close=None, closesrc=None, customdata=None, customdatasrc=None, decreasing=None, high=None, highsrc=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, increasing=None, legendgroup=None, line=None, low=None, lowsrc=None, name=None, opacity=None, open=None, opensrc=None, selectedpoints=None, showlegend=None, stream=None, text=None, textsrc=None, uid=None, visible=None, whiskerwidth=None, x=None, xaxis=None, xcalendar=None, xsrc=None, yaxis=None, row=None, col=None, **kwargs)
| Add a new Candlestick trace
|
| The candlestick is a style of financial chart describing open,
| high, low and close for a given `x` coordinate (most likely
| time). The boxes represent the spread between the `open` and
| `close` values and the lines represent the spread between the
| `low` and `high` values Sample points where the close value is
| higher (lower) then the open value are called increasing
| (decreasing). By default, increasing candles are drawn in green
| whereas decreasing are drawn in red.
|
| Parameters
| ----------
| close
| Sets the close values.
| closesrc
| Sets the source reference on plot.ly for close .
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| decreasing
| plotly.graph_objs.candlestick.Decreasing instance or
| dict with compatible properties
| high
| Sets the high values.
| highsrc
| Sets the source reference on plot.ly for high .
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.candlestick.Hoverlabel instance or
| dict with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| increasing
| plotly.graph_objs.candlestick.Increasing instance or
| dict with compatible properties
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.candlestick.Line instance or dict
| with compatible properties
| low
| Sets the low values.
| lowsrc
| Sets the source reference on plot.ly for low .
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| open
| Sets the open values.
| opensrc
| Sets the source reference on plot.ly for open .
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.candlestick.Stream instance or dict
| with compatible properties
| text
| Sets hover text elements associated with each sample
| point. If a single string, the same string appears over
| all the data points. If an array of string, the items
| are mapped in order to this trace's sample points.
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| whiskerwidth
| Sets the width of the whiskers relative to the box'
| width. For example, with 1, the whiskers are as wide as
| the box(es).
| x
| Sets the x coordinates. If absent, linear coordinate
| will be generated.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xcalendar
| Sets the calendar system to use with `x` date data.
| xsrc
| Sets the source reference on plot.ly for x .
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Candlestick
|
| add_carpet(self, a=None, a0=None, aaxis=None, asrc=None, b=None, b0=None, baxis=None, bsrc=None, carpet=None, cheaterslope=None, color=None, customdata=None, customdatasrc=None, da=None, db=None, font=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, name=None, opacity=None, selectedpoints=None, showlegend=None, stream=None, uid=None, visible=None, x=None, xaxis=None, xsrc=None, y=None, yaxis=None, ysrc=None, row=None, col=None, **kwargs)
| Add a new Carpet trace
|
| The data describing carpet axis layout is set in `y` and
| (optionally) also `x`. If only `y` is present, `x` the plot is
| interpreted as a cheater plot and is filled in using the `y`
| values. `x` and `y` may either be 2D arrays matching with each
| dimension matching that of `a` and `b`, or they may be 1D
| arrays with total length equal to that of `a` and `b`.
|
| Parameters
| ----------
| a
| An array containing values of the first parameter value
| a0
| Alternate to `a`. Builds a linear space of a
| coordinates. Use with `da` where `a0` is the starting
| coordinate and `da` the step.
| aaxis
| plotly.graph_objs.carpet.Aaxis instance or dict with
| compatible properties
| asrc
| Sets the source reference on plot.ly for a .
| b
| A two dimensional array of y coordinates at each carpet
| point.
| b0
| Alternate to `b`. Builds a linear space of a
| coordinates. Use with `db` where `b0` is the starting
| coordinate and `db` the step.
| baxis
| plotly.graph_objs.carpet.Baxis instance or dict with
| compatible properties
| bsrc
| Sets the source reference on plot.ly for b .
| carpet
| An identifier for this carpet, so that `scattercarpet`
| and `scattercontour` traces can specify a carpet plot
| on which they lie
| cheaterslope
| The shift applied to each successive row of data in
| creating a cheater plot. Only used if `x` is been
| ommitted.
| 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.
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| da
| Sets the a coordinate step. See `a0` for more info.
| db
| Sets the b coordinate step. See `b0` for more info.
| font
| The default font used for axis & tick labels on this
| carpet
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.carpet.Hoverlabel instance or dict
| with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.carpet.Stream instance or dict with
| compatible properties
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| A two dimensional array of x coordinates at each carpet
| point. If ommitted, the plot is a cheater plot and the
| xaxis is hidden by default.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| A two dimensional array of y coordinates at each carpet
| point.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ysrc
| Sets the source reference on plot.ly for y .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Carpet
|
| add_choropleth(self, autocolorscale=None, colorbar=None, colorscale=None, customdata=None, customdatasrc=None, geo=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, locationmode=None, locations=None, locationssrc=None, marker=None, name=None, opacity=None, reversescale=None, selected=None, selectedpoints=None, showlegend=None, showscale=None, stream=None, text=None, textsrc=None, uid=None, unselected=None, visible=None, z=None, zauto=None, zmax=None, zmin=None, zsrc=None, row=None, col=None, **kwargs)
| Add a new Choropleth trace
|
| The data that describes the choropleth value-to-color mapping
| is set in `z`. The geographic locations corresponding to each
| value in `z` are set in `locations`.
|
| Parameters
| ----------
| autocolorscale
| Determines whether or not the colorscale is picked
| using the sign of the input z values.
| colorbar
| plotly.graph_objs.choropleth.ColorBar instance or dict
| with compatible properties
| 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 z space, use zmin and zmax
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| geo
| Sets a reference between this trace's geospatial
| coordinates and a geographic map. If *geo* (the default
| value), the geospatial coordinates refer to
| `layout.geo`. If *geo2*, the geospatial coordinates
| refer to `layout.geo2`, and so on.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.choropleth.Hoverlabel instance or
| dict with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| locationmode
| Determines the set of locations used to match entries
| in `locations` to regions on the map.
| locations
| Sets the coordinates via location IDs or names. See
| `locationmode` for more info.
| locationssrc
| Sets the source reference on plot.ly for locations .
| marker
| plotly.graph_objs.choropleth.Marker instance or dict
| with compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| reversescale
| Reverses the colorscale.
| selected
| plotly.graph_objs.choropleth.Selected instance or dict
| with compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| showscale
| Determines whether or not a colorbar is displayed for
| this trace.
| stream
| plotly.graph_objs.choropleth.Stream instance or dict
| with compatible properties
| text
| Sets the text elements associated with each location.
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| unselected
| plotly.graph_objs.choropleth.Unselected instance or
| dict with compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| z
| Sets the color values.
| zauto
| Determines the whether or not the color domain is
| computed with respect to the input data.
| zmax
| Sets the upper bound of color domain.
| zmin
| Sets the lower bound of color domain.
| zsrc
| Sets the source reference on plot.ly for z .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Choropleth
|
| add_cone(self, anchor=None, autocolorscale=None, cauto=None, cmax=None, cmin=None, colorbar=None, colorscale=None, customdata=None, customdatasrc=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, lighting=None, lightposition=None, name=None, opacity=None, reversescale=None, scene=None, selectedpoints=None, showlegend=None, showscale=None, sizemode=None, sizeref=None, stream=None, text=None, textsrc=None, u=None, uid=None, usrc=None, v=None, visible=None, vsrc=None, w=None, wsrc=None, x=None, xsrc=None, y=None, ysrc=None, z=None, zsrc=None, row=None, col=None, **kwargs)
| Add a new Cone trace
|
| Use cone traces to visualize vector fields. Specify a vector
| field using 6 1D arrays, 3 position arrays `x`, `y` and `z` and
| 3 vector component arrays `u`, `v`, `w`. The cones are drawn
| exactly at the positions given by `x`, `y` and `z`.
|
| Parameters
| ----------
| anchor
| Sets the cones' anchor with respect to their x/y/z
| positions. Note that *cm* denote the cone's center of
| mass which corresponds to 1/4 from the tail to tip.
| autocolorscale
| Has an effect only if `color` is set to a numerical
| array. Determines whether the colorscale is a default
| palette (`autocolorscale: true`) or the palette
| determined by `colorscale`. In case `colorscale` is
| unspecified or `autocolorscale` is true, the default
| palette will be chosen according to whether numbers in
| the `color` array are all positive, all negative or
| mixed.
| cauto
| Has an effect only if `color` is set to a numerical
| array and `cmin`, `cmax` are set by the user. In this
| case, it controls whether the range of colors in
| `colorscale` is mapped to the range of values in the
| `color` array (`cauto: true`), or the `cmin`/`cmax`
| values (`cauto: false`). Defaults to `false` when
| `cmin`, `cmax` are set by the user.
| cmax
| Has an effect only if `color` is set to a numerical
| array. Sets the upper bound of the color domain. Value
| should be associated to the `color` array index, and if
| set, `cmin` must be set as well.
| cmin
| Has an effect only if `color` is set to a numerical
| array. Sets the lower bound of the color domain. Value
| should be associated to the `color` array index, and if
| set, `cmax` must be set as well.
| colorbar
| plotly.graph_objs.cone.ColorBar instance or dict with
| compatible properties
| colorscale
| Sets the colorscale and only has an effect if `color`
| is set to a numerical array. 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, use `cmin` and `cmax`.
| Alternatively, `colorscale` may be a palette name
| string of the following list: Greys, YlGnBu, Greens,
| YlOrRd, Bluered, RdBu, Reds, Blues, Picnic, Rainbow,
| Portland, Jet, Hot, Blackbody, Earth, Electric,
| Viridis, Cividis
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.cone.Hoverlabel instance or dict with
| compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| lighting
| plotly.graph_objs.cone.Lighting instance or dict with
| compatible properties
| lightposition
| plotly.graph_objs.cone.Lightposition instance or dict
| with compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the surface.
| reversescale
| Has an effect only if `color` is set to a numerical
| array. Reverses the color mapping if true (`cmin` will
| correspond to the last color in the array and `cmax`
| will correspond to the first color).
| scene
| Sets a reference between this trace's 3D coordinate
| system and a 3D scene. If *scene* (the default value),
| the (x,y,z) coordinates refer to `layout.scene`. If
| *scene2*, the (x,y,z) coordinates refer to
| `layout.scene2`, and so on.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| showscale
| Determines whether or not a colorbar is displayed for
| this trace.
| sizemode
| Determines whether `sizeref` is set as a *scaled* (i.e
| unitless) scalar (normalized by the max u/v/w norm in
| the vector field) or as *absolute* value (in the same
| units as the vector field).
| sizeref
| Adjusts the cone size scaling. The size of the cones is
| determined by their u/v/w norm multiplied a factor and
| `sizeref`. This factor (computed internally)
| corresponds to the minimum "time" to travel across two
| successive x/y/z positions at the average velocity of
| those two successive positions. All cones in a given
| trace use the same factor. With `sizemode` set to
| *scaled*, `sizeref` is unitless, its default value is
| *0.5* With `sizemode` set to *absolute*, `sizeref` has
| the same units as the u/v/w vector field, its the
| default value is half the sample's maximum vector norm.
| stream
| plotly.graph_objs.cone.Stream instance or dict with
| compatible properties
| text
| Sets the text elements associated with the cones. If
| trace `hoverinfo` contains a *text* flag and
| *hovertext* is not set, these elements will be seen in
| the hover labels.
| textsrc
| Sets the source reference on plot.ly for text .
| u
| Sets the x components of the vector field.
| uid
|
| usrc
| Sets the source reference on plot.ly for u .
| v
| Sets the y components of the vector field.
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| vsrc
| Sets the source reference on plot.ly for v .
| w
| Sets the z components of the vector field.
| wsrc
| Sets the source reference on plot.ly for w .
| x
| Sets the x coordinates of the vector field and of the
| displayed cones.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| Sets the y coordinates of the vector field and of the
| displayed cones.
| ysrc
| Sets the source reference on plot.ly for y .
| z
| Sets the z coordinates of the vector field and of the
| displayed cones.
| zsrc
| Sets the source reference on plot.ly for z .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Cone
|
| add_contour(self, autocolorscale=None, autocontour=None, colorbar=None, colorscale=None, connectgaps=None, contours=None, customdata=None, customdatasrc=None, dx=None, dy=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, line=None, name=None, ncontours=None, opacity=None, reversescale=None, selectedpoints=None, showlegend=None, showscale=None, stream=None, text=None, textsrc=None, transpose=None, uid=None, visible=None, x=None, x0=None, xaxis=None, xcalendar=None, xsrc=None, xtype=None, y=None, y0=None, yaxis=None, ycalendar=None, ysrc=None, ytype=None, z=None, zauto=None, zhoverformat=None, zmax=None, zmin=None, zsrc=None, row=None, col=None, **kwargs)
| Add a new Contour trace
|
| The data from which contour lines are computed is set in `z`.
| Data in `z` must be a {2D array} of numbers. Say that `z` has N
| rows and M columns, then by default, these N rows correspond to
| N y coordinates (set in `y` or auto-generated) and the M
| columns correspond to M x coordinates (set in `x` or auto-
| generated). By setting `transpose` to *true*, the above
| behavior is flipped.
|
| Parameters
| ----------
| autocolorscale
| Determines whether or not the colorscale is picked
| using the sign of the input z values.
| autocontour
| Determines whether or not the contour level attributes
| are picked by an algorithm. If *true*, the number of
| contour levels can be set in `ncontours`. If *false*,
| set the contour level attributes in `contours`.
| colorbar
| plotly.graph_objs.contour.ColorBar instance or dict
| with compatible properties
| 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 z space, use zmin and zmax
| connectgaps
| Determines whether or not gaps (i.e. {nan} or missing
| values) in the `z` data are filled in.
| contours
| plotly.graph_objs.contour.Contours instance or dict
| with compatible properties
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| dx
| Sets the x coordinate step. See `x0` for more info.
| dy
| Sets the y coordinate step. See `y0` for more info.
| fillcolor
| Sets the fill color if `contours.type` is *constraint*.
| Defaults to a half-transparent variant of the line
| color, marker color, or marker line color, whichever is
| available.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.contour.Hoverlabel instance or dict
| with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.contour.Line instance or dict with
| compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| ncontours
| Sets the maximum number of contour levels. The actual
| number of contours will be chosen automatically to be
| less than or equal to the value of `ncontours`. Has an
| effect only if `autocontour` is *true* or if
| `contours.size` is missing.
| opacity
| Sets the opacity of the trace.
| reversescale
| Reverses the colorscale.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| showscale
| Determines whether or not a colorbar is displayed for
| this trace.
| stream
| plotly.graph_objs.contour.Stream instance or dict with
| compatible properties
| text
| Sets the text elements associated with each z value.
| textsrc
| Sets the source reference on plot.ly for text .
| transpose
| Transposes the z data.
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the x coordinates.
| x0
| Alternate to `x`. Builds a linear space of x
| coordinates. Use with `dx` where `x0` is the starting
| coordinate and `dx` the step.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xcalendar
| Sets the calendar system to use with `x` date data.
| xsrc
| Sets the source reference on plot.ly for x .
| xtype
| If *array*, the heatmap's x coordinates are given by
| *x* (the default behavior when `x` is provided). If
| *scaled*, the heatmap's x coordinates are given by *x0*
| and *dx* (the default behavior when `x` is not
| provided).
| y
| Sets the y coordinates.
| y0
| Alternate to `y`. Builds a linear space of y
| coordinates. Use with `dy` where `y0` is the starting
| coordinate and `dy` the step.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ycalendar
| Sets the calendar system to use with `y` date data.
| ysrc
| Sets the source reference on plot.ly for y .
| ytype
| If *array*, the heatmap's y coordinates are given by
| *y* (the default behavior when `y` is provided) If
| *scaled*, the heatmap's y coordinates are given by *y0*
| and *dy* (the default behavior when `y` is not
| provided)
| z
| Sets the z data.
| zauto
| Determines the whether or not the color domain is
| computed with respect to the input data.
| zhoverformat
| Sets the hover text formatting rule using d3 formatting
| mini-languages which are very similar to those in
| Python. See: https://github.com/d3/d3-format/blob/maste
| r/README.md#locale_format
| zmax
| Sets the upper bound of color domain.
| zmin
| Sets the lower bound of color domain.
| zsrc
| Sets the source reference on plot.ly for z .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Contour
|
| add_contourcarpet(self, a=None, a0=None, asrc=None, atype=None, autocolorscale=None, autocontour=None, b=None, b0=None, bsrc=None, btype=None, carpet=None, colorbar=None, colorscale=None, contours=None, customdata=None, customdatasrc=None, da=None, db=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, line=None, name=None, ncontours=None, opacity=None, reversescale=None, selectedpoints=None, showlegend=None, showscale=None, stream=None, text=None, textsrc=None, transpose=None, uid=None, visible=None, xaxis=None, yaxis=None, z=None, zauto=None, zmax=None, zmin=None, zsrc=None, row=None, col=None, **kwargs)
| Add a new Contourcarpet trace
|
| Plots contours on either the first carpet axis or the carpet
| axis with a matching `carpet` attribute. Data `z` is
| interpreted as matching that of the corresponding carpet axis.
|
| Parameters
| ----------
| a
| Sets the x coordinates.
| a0
| Alternate to `x`. Builds a linear space of x
| coordinates. Use with `dx` where `x0` is the starting
| coordinate and `dx` the step.
| asrc
| Sets the source reference on plot.ly for a .
| atype
| If *array*, the heatmap's x coordinates are given by
| *x* (the default behavior when `x` is provided). If
| *scaled*, the heatmap's x coordinates are given by *x0*
| and *dx* (the default behavior when `x` is not
| provided).
| autocolorscale
| Determines whether or not the colorscale is picked
| using the sign of the input z values.
| autocontour
| Determines whether or not the contour level attributes
| are picked by an algorithm. If *true*, the number of
| contour levels can be set in `ncontours`. If *false*,
| set the contour level attributes in `contours`.
| b
| Sets the y coordinates.
| b0
| Alternate to `y`. Builds a linear space of y
| coordinates. Use with `dy` where `y0` is the starting
| coordinate and `dy` the step.
| bsrc
| Sets the source reference on plot.ly for b .
| btype
| If *array*, the heatmap's y coordinates are given by
| *y* (the default behavior when `y` is provided) If
| *scaled*, the heatmap's y coordinates are given by *y0*
| and *dy* (the default behavior when `y` is not
| provided)
| carpet
| The `carpet` of the carpet axes on which this contour
| trace lies
| colorbar
| plotly.graph_objs.contourcarpet.ColorBar instance or
| dict with compatible properties
| 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 z space, use zmin and zmax
| contours
| plotly.graph_objs.contourcarpet.Contours instance or
| dict with compatible properties
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| da
| Sets the x coordinate step. See `x0` for more info.
| db
| Sets the y coordinate step. See `y0` for more info.
| fillcolor
| Sets the fill color if `contours.type` is *constraint*.
| Defaults to a half-transparent variant of the line
| color, marker color, or marker line color, whichever is
| available.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.contourcarpet.Hoverlabel instance or
| dict with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.contourcarpet.Line instance or dict
| with compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| ncontours
| Sets the maximum number of contour levels. The actual
| number of contours will be chosen automatically to be
| less than or equal to the value of `ncontours`. Has an
| effect only if `autocontour` is *true* or if
| `contours.size` is missing.
| opacity
| Sets the opacity of the trace.
| reversescale
| Reverses the colorscale.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| showscale
| Determines whether or not a colorbar is displayed for
| this trace.
| stream
| plotly.graph_objs.contourcarpet.Stream instance or dict
| with compatible properties
| text
| Sets the text elements associated with each z value.
| textsrc
| Sets the source reference on plot.ly for text .
| transpose
| Transposes the z data.
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| z
| Sets the z data.
| zauto
| Determines the whether or not the color domain is
| computed with respect to the input data.
| zmax
| Sets the upper bound of color domain.
| zmin
| Sets the lower bound of color domain.
| zsrc
| Sets the source reference on plot.ly for z .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Contourcarpet
|
| add_heatmap(self, autocolorscale=None, colorbar=None, colorscale=None, connectgaps=None, customdata=None, customdatasrc=None, dx=None, dy=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, name=None, opacity=None, reversescale=None, selectedpoints=None, showlegend=None, showscale=None, stream=None, text=None, textsrc=None, transpose=None, uid=None, visible=None, x=None, x0=None, xaxis=None, xcalendar=None, xgap=None, xsrc=None, xtype=None, y=None, y0=None, yaxis=None, ycalendar=None, ygap=None, ysrc=None, ytype=None, z=None, zauto=None, zhoverformat=None, zmax=None, zmin=None, zsmooth=None, zsrc=None, row=None, col=None, **kwargs)
| Add a new Heatmap trace
|
| The data that describes the heatmap value-to-color mapping is
| set in `z`. Data in `z` can either be a {2D array} of values
| (ragged or not) or a 1D array of values. In the case where `z`
| is a {2D array}, say that `z` has N rows and M columns. Then,
| by default, the resulting heatmap will have N partitions along
| the y axis and M partitions along the x axis. In other words,
| the i-th row/ j-th column cell in `z` is mapped to the i-th
| partition of the y axis (starting from the bottom of the plot)
| and the j-th partition of the x-axis (starting from the left of
| the plot). This behavior can be flipped by using `transpose`.
| Moreover, `x` (`y`) can be provided with M or M+1 (N or N+1)
| elements. If M (N), then the coordinates correspond to the
| center of the heatmap cells and the cells have equal width. If
| M+1 (N+1), then the coordinates correspond to the edges of the
| heatmap cells. In the case where `z` is a 1D {array}, the x and
| y coordinates must be provided in `x` and `y` respectively to
| form data triplets.
|
| Parameters
| ----------
| autocolorscale
| Determines whether or not the colorscale is picked
| using the sign of the input z values.
| colorbar
| plotly.graph_objs.heatmap.ColorBar instance or dict
| with compatible properties
| 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 z space, use zmin and zmax
| connectgaps
| Determines whether or not gaps (i.e. {nan} or missing
| values) in the `z` data are filled in.
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| dx
| Sets the x coordinate step. See `x0` for more info.
| dy
| Sets the y coordinate step. See `y0` for more info.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.heatmap.Hoverlabel instance or dict
| with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| reversescale
| Reverses the colorscale.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| showscale
| Determines whether or not a colorbar is displayed for
| this trace.
| stream
| plotly.graph_objs.heatmap.Stream instance or dict with
| compatible properties
| text
| Sets the text elements associated with each z value.
| textsrc
| Sets the source reference on plot.ly for text .
| transpose
| Transposes the z data.
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the x coordinates.
| x0
| Alternate to `x`. Builds a linear space of x
| coordinates. Use with `dx` where `x0` is the starting
| coordinate and `dx` the step.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xcalendar
| Sets the calendar system to use with `x` date data.
| xgap
| Sets the horizontal gap (in pixels) between bricks.
| xsrc
| Sets the source reference on plot.ly for x .
| xtype
| If *array*, the heatmap's x coordinates are given by
| *x* (the default behavior when `x` is provided). If
| *scaled*, the heatmap's x coordinates are given by *x0*
| and *dx* (the default behavior when `x` is not
| provided).
| y
| Sets the y coordinates.
| y0
| Alternate to `y`. Builds a linear space of y
| coordinates. Use with `dy` where `y0` is the starting
| coordinate and `dy` the step.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ycalendar
| Sets the calendar system to use with `y` date data.
| ygap
| Sets the vertical gap (in pixels) between bricks.
| ysrc
| Sets the source reference on plot.ly for y .
| ytype
| If *array*, the heatmap's y coordinates are given by
| *y* (the default behavior when `y` is provided) If
| *scaled*, the heatmap's y coordinates are given by *y0*
| and *dy* (the default behavior when `y` is not
| provided)
| z
| Sets the z data.
| zauto
| Determines the whether or not the color domain is
| computed with respect to the input data.
| zhoverformat
| Sets the hover text formatting rule using d3 formatting
| mini-languages which are very similar to those in
| Python. See: https://github.com/d3/d3-format/blob/maste
| r/README.md#locale_format
| zmax
| Sets the upper bound of color domain.
| zmin
| Sets the lower bound of color domain.
| zsmooth
| Picks a smoothing algorithm use to smooth `z` data.
| zsrc
| Sets the source reference on plot.ly for z .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Heatmap
|
| add_heatmapgl(self, autocolorscale=None, colorbar=None, colorscale=None, customdata=None, customdatasrc=None, dx=None, dy=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, name=None, opacity=None, reversescale=None, selectedpoints=None, showlegend=None, showscale=None, stream=None, text=None, textsrc=None, transpose=None, uid=None, visible=None, x=None, x0=None, xaxis=None, xsrc=None, xtype=None, y=None, y0=None, yaxis=None, ysrc=None, ytype=None, z=None, zauto=None, zmax=None, zmin=None, zsrc=None, row=None, col=None, **kwargs)
| Add a new Heatmapgl trace
|
| WebGL version of the heatmap trace type.
|
| Parameters
| ----------
| autocolorscale
| Determines whether or not the colorscale is picked
| using the sign of the input z values.
| colorbar
| plotly.graph_objs.heatmapgl.ColorBar instance or dict
| with compatible properties
| 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 z space, use zmin and zmax
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| dx
| Sets the x coordinate step. See `x0` for more info.
| dy
| Sets the y coordinate step. See `y0` for more info.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.heatmapgl.Hoverlabel instance or dict
| with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| reversescale
| Reverses the colorscale.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| showscale
| Determines whether or not a colorbar is displayed for
| this trace.
| stream
| plotly.graph_objs.heatmapgl.Stream instance or dict
| with compatible properties
| text
| Sets the text elements associated with each z value.
| textsrc
| Sets the source reference on plot.ly for text .
| transpose
| Transposes the z data.
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the x coordinates.
| x0
| Alternate to `x`. Builds a linear space of x
| coordinates. Use with `dx` where `x0` is the starting
| coordinate and `dx` the step.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xsrc
| Sets the source reference on plot.ly for x .
| xtype
| If *array*, the heatmap's x coordinates are given by
| *x* (the default behavior when `x` is provided). If
| *scaled*, the heatmap's x coordinates are given by *x0*
| and *dx* (the default behavior when `x` is not
| provided).
| y
| Sets the y coordinates.
| y0
| Alternate to `y`. Builds a linear space of y
| coordinates. Use with `dy` where `y0` is the starting
| coordinate and `dy` the step.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ysrc
| Sets the source reference on plot.ly for y .
| ytype
| If *array*, the heatmap's y coordinates are given by
| *y* (the default behavior when `y` is provided) If
| *scaled*, the heatmap's y coordinates are given by *y0*
| and *dy* (the default behavior when `y` is not
| provided)
| z
| Sets the z data.
| zauto
| Determines the whether or not the color domain is
| computed with respect to the input data.
| zmax
| Sets the upper bound of color domain.
| zmin
| Sets the lower bound of color domain.
| zsrc
| Sets the source reference on plot.ly for z .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Heatmapgl
|
| add_histogram(self, autobinx=None, autobiny=None, cumulative=None, customdata=None, customdatasrc=None, error_x=None, error_y=None, histfunc=None, histnorm=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, marker=None, name=None, nbinsx=None, nbinsy=None, opacity=None, orientation=None, selected=None, selectedpoints=None, showlegend=None, stream=None, text=None, textsrc=None, uid=None, unselected=None, visible=None, x=None, xaxis=None, xbins=None, xcalendar=None, xsrc=None, y=None, yaxis=None, ybins=None, ycalendar=None, ysrc=None, row=None, col=None, **kwargs)
| Add a new Histogram trace
|
| The sample data from which statistics are computed is set in
| `x` for vertically spanning histograms and in `y` for
| horizontally spanning histograms. Binning options are set
| `xbins` and `ybins` respectively if no aggregation data is
| provided.
|
| Parameters
| ----------
| autobinx
| Determines whether or not the x axis bin attributes are
| picked by an algorithm. Note that this should be set to
| false if you want to manually set the number of bins
| using the attributes in xbins.
| autobiny
| Determines whether or not the y axis bin attributes are
| picked by an algorithm. Note that this should be set to
| false if you want to manually set the number of bins
| using the attributes in ybins.
| cumulative
| plotly.graph_objs.histogram.Cumulative instance or dict
| with compatible properties
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| error_x
| plotly.graph_objs.histogram.ErrorX instance or dict
| with compatible properties
| error_y
| plotly.graph_objs.histogram.ErrorY instance or dict
| with compatible properties
| histfunc
| Specifies the binning function used for this histogram
| trace. If *count*, the histogram values are computed by
| counting the number of values lying inside each bin. If
| *sum*, *avg*, *min*, *max*, the histogram values are
| computed using the sum, the average, the minimum or the
| maximum of the values lying inside each bin
| respectively.
| histnorm
| Specifies the type of normalization used for this
| histogram trace. If **, the span of each bar
| corresponds to the number of occurrences (i.e. the
| number of data points lying inside the bins). If
| *percent* / *probability*, the span of each bar
| corresponds to the percentage / fraction of occurrences
| with respect to the total number of sample points
| (here, the sum of all bin HEIGHTS equals 100% / 1). If
| *density*, the span of each bar corresponds to the
| number of occurrences in a bin divided by the size of
| the bin interval (here, the sum of all bin AREAS equals
| the total number of sample points). If *probability
| density*, the area of each bar corresponds to the
| probability that an event will fall into the
| corresponding bin (here, the sum of all bin AREAS
| equals 1).
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.histogram.Hoverlabel instance or dict
| with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| marker
| plotly.graph_objs.histogram.Marker instance or dict
| with compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| nbinsx
| Specifies the maximum number of desired bins. This
| value will be used in an algorithm that will decide the
| optimal bin size such that the histogram best
| visualizes the distribution of the data.
| nbinsy
| Specifies the maximum number of desired bins. This
| value will be used in an algorithm that will decide the
| optimal bin size such that the histogram best
| visualizes the distribution of the data.
| opacity
| Sets the opacity of the trace.
| orientation
| Sets the orientation of the bars. With *v* (*h*), the
| value of the each bar spans along the vertical
| (horizontal).
| selected
| plotly.graph_objs.histogram.Selected instance or dict
| with compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.histogram.Stream instance or dict
| with compatible properties
| text
| Sets text elements associated with each (x,y) pair. If
| a single string, the same string appears over all the
| data points. If an array of string, the items are
| mapped in order to the this trace's (x,y) coordinates.
| If trace `hoverinfo` contains a *text* flag and
| *hovertext* is not set, these elements will be seen in
| the hover labels.
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| unselected
| plotly.graph_objs.histogram.Unselected instance or dict
| with compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the sample data to be binned on the x axis.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xbins
| plotly.graph_objs.histogram.XBins instance or dict with
| compatible properties
| xcalendar
| Sets the calendar system to use with `x` date data.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| Sets the sample data to be binned on the y axis.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ybins
| plotly.graph_objs.histogram.YBins instance or dict with
| compatible properties
| ycalendar
| Sets the calendar system to use with `y` date data.
| ysrc
| Sets the source reference on plot.ly for y .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Histogram
|
| add_histogram2d(self, autobinx=None, autobiny=None, autocolorscale=None, colorbar=None, colorscale=None, customdata=None, customdatasrc=None, histfunc=None, histnorm=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, marker=None, name=None, nbinsx=None, nbinsy=None, opacity=None, reversescale=None, selectedpoints=None, showlegend=None, showscale=None, stream=None, uid=None, visible=None, x=None, xaxis=None, xbins=None, xcalendar=None, xgap=None, xsrc=None, y=None, yaxis=None, ybins=None, ycalendar=None, ygap=None, ysrc=None, z=None, zauto=None, zhoverformat=None, zmax=None, zmin=None, zsmooth=None, zsrc=None, row=None, col=None, **kwargs)
| Add a new Histogram2d trace
|
| The sample data from which statistics are computed is set in
| `x` and `y` (where `x` and `y` represent marginal
| distributions, binning is set in `xbins` and `ybins` in this
| case) or `z` (where `z` represent the 2D distribution and
| binning set, binning is set by `x` and `y` in this case). The
| resulting distribution is visualized as a heatmap.
|
| Parameters
| ----------
| autobinx
| Determines whether or not the x axis bin attributes are
| picked by an algorithm. Note that this should be set to
| false if you want to manually set the number of bins
| using the attributes in xbins.
| autobiny
| Determines whether or not the y axis bin attributes are
| picked by an algorithm. Note that this should be set to
| false if you want to manually set the number of bins
| using the attributes in ybins.
| autocolorscale
| Determines whether or not the colorscale is picked
| using the sign of the input z values.
| colorbar
| plotly.graph_objs.histogram2d.ColorBar instance or dict
| with compatible properties
| 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 z space, use zmin and zmax
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| histfunc
| Specifies the binning function used for this histogram
| trace. If *count*, the histogram values are computed by
| counting the number of values lying inside each bin. If
| *sum*, *avg*, *min*, *max*, the histogram values are
| computed using the sum, the average, the minimum or the
| maximum of the values lying inside each bin
| respectively.
| histnorm
| Specifies the type of normalization used for this
| histogram trace. If **, the span of each bar
| corresponds to the number of occurrences (i.e. the
| number of data points lying inside the bins). If
| *percent* / *probability*, the span of each bar
| corresponds to the percentage / fraction of occurrences
| with respect to the total number of sample points
| (here, the sum of all bin HEIGHTS equals 100% / 1). If
| *density*, the span of each bar corresponds to the
| number of occurrences in a bin divided by the size of
| the bin interval (here, the sum of all bin AREAS equals
| the total number of sample points). If *probability
| density*, the area of each bar corresponds to the
| probability that an event will fall into the
| corresponding bin (here, the sum of all bin AREAS
| equals 1).
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.histogram2d.Hoverlabel instance or
| dict with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| marker
| plotly.graph_objs.histogram2d.Marker instance or dict
| with compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| nbinsx
| Specifies the maximum number of desired bins. This
| value will be used in an algorithm that will decide the
| optimal bin size such that the histogram best
| visualizes the distribution of the data.
| nbinsy
| Specifies the maximum number of desired bins. This
| value will be used in an algorithm that will decide the
| optimal bin size such that the histogram best
| visualizes the distribution of the data.
| opacity
| Sets the opacity of the trace.
| reversescale
| Reverses the colorscale.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| showscale
| Determines whether or not a colorbar is displayed for
| this trace.
| stream
| plotly.graph_objs.histogram2d.Stream instance or dict
| with compatible properties
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the sample data to be binned on the x axis.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xbins
| plotly.graph_objs.histogram2d.XBins instance or dict
| with compatible properties
| xcalendar
| Sets the calendar system to use with `x` date data.
| xgap
| Sets the horizontal gap (in pixels) between bricks.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| Sets the sample data to be binned on the y axis.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ybins
| plotly.graph_objs.histogram2d.YBins instance or dict
| with compatible properties
| ycalendar
| Sets the calendar system to use with `y` date data.
| ygap
| Sets the vertical gap (in pixels) between bricks.
| ysrc
| Sets the source reference on plot.ly for y .
| z
| Sets the aggregation data.
| zauto
| Determines the whether or not the color domain is
| computed with respect to the input data.
| zhoverformat
| Sets the hover text formatting rule using d3 formatting
| mini-languages which are very similar to those in
| Python. See: https://github.com/d3/d3-format/blob/maste
| r/README.md#locale_format
| zmax
| Sets the upper bound of color domain.
| zmin
| Sets the lower bound of color domain.
| zsmooth
| Picks a smoothing algorithm use to smooth `z` data.
| zsrc
| Sets the source reference on plot.ly for z .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Histogram2d
|
| add_histogram2dcontour(self, autobinx=None, autobiny=None, autocolorscale=None, autocontour=None, colorbar=None, colorscale=None, contours=None, customdata=None, customdatasrc=None, histfunc=None, histnorm=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, line=None, marker=None, name=None, nbinsx=None, nbinsy=None, ncontours=None, opacity=None, reversescale=None, selectedpoints=None, showlegend=None, showscale=None, stream=None, uid=None, visible=None, x=None, xaxis=None, xbins=None, xcalendar=None, xsrc=None, y=None, yaxis=None, ybins=None, ycalendar=None, ysrc=None, z=None, zauto=None, zhoverformat=None, zmax=None, zmin=None, zsrc=None, row=None, col=None, **kwargs)
| Add a new Histogram2dContour trace
|
| The sample data from which statistics are computed is set in
| `x` and `y` (where `x` and `y` represent marginal
| distributions, binning is set in `xbins` and `ybins` in this
| case) or `z` (where `z` represent the 2D distribution and
| binning set, binning is set by `x` and `y` in this case). The
| resulting distribution is visualized as a contour plot.
|
| Parameters
| ----------
| autobinx
| Determines whether or not the x axis bin attributes are
| picked by an algorithm. Note that this should be set to
| false if you want to manually set the number of bins
| using the attributes in xbins.
| autobiny
| Determines whether or not the y axis bin attributes are
| picked by an algorithm. Note that this should be set to
| false if you want to manually set the number of bins
| using the attributes in ybins.
| autocolorscale
| Determines whether or not the colorscale is picked
| using the sign of the input z values.
| autocontour
| Determines whether or not the contour level attributes
| are picked by an algorithm. If *true*, the number of
| contour levels can be set in `ncontours`. If *false*,
| set the contour level attributes in `contours`.
| colorbar
| plotly.graph_objs.histogram2dcontour.ColorBar instance
| or dict with compatible properties
| 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 z space, use zmin and zmax
| contours
| plotly.graph_objs.histogram2dcontour.Contours instance
| or dict with compatible properties
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| histfunc
| Specifies the binning function used for this histogram
| trace. If *count*, the histogram values are computed by
| counting the number of values lying inside each bin. If
| *sum*, *avg*, *min*, *max*, the histogram values are
| computed using the sum, the average, the minimum or the
| maximum of the values lying inside each bin
| respectively.
| histnorm
| Specifies the type of normalization used for this
| histogram trace. If **, the span of each bar
| corresponds to the number of occurrences (i.e. the
| number of data points lying inside the bins). If
| *percent* / *probability*, the span of each bar
| corresponds to the percentage / fraction of occurrences
| with respect to the total number of sample points
| (here, the sum of all bin HEIGHTS equals 100% / 1). If
| *density*, the span of each bar corresponds to the
| number of occurrences in a bin divided by the size of
| the bin interval (here, the sum of all bin AREAS equals
| the total number of sample points). If *probability
| density*, the area of each bar corresponds to the
| probability that an event will fall into the
| corresponding bin (here, the sum of all bin AREAS
| equals 1).
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.histogram2dcontour.Hoverlabel
| instance or dict with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.histogram2dcontour.Line instance or
| dict with compatible properties
| marker
| plotly.graph_objs.histogram2dcontour.Marker instance or
| dict with compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| nbinsx
| Specifies the maximum number of desired bins. This
| value will be used in an algorithm that will decide the
| optimal bin size such that the histogram best
| visualizes the distribution of the data.
| nbinsy
| Specifies the maximum number of desired bins. This
| value will be used in an algorithm that will decide the
| optimal bin size such that the histogram best
| visualizes the distribution of the data.
| ncontours
| Sets the maximum number of contour levels. The actual
| number of contours will be chosen automatically to be
| less than or equal to the value of `ncontours`. Has an
| effect only if `autocontour` is *true* or if
| `contours.size` is missing.
| opacity
| Sets the opacity of the trace.
| reversescale
| Reverses the colorscale.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| showscale
| Determines whether or not a colorbar is displayed for
| this trace.
| stream
| plotly.graph_objs.histogram2dcontour.Stream instance or
| dict with compatible properties
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the sample data to be binned on the x axis.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xbins
| plotly.graph_objs.histogram2dcontour.XBins instance or
| dict with compatible properties
| xcalendar
| Sets the calendar system to use with `x` date data.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| Sets the sample data to be binned on the y axis.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ybins
| plotly.graph_objs.histogram2dcontour.YBins instance or
| dict with compatible properties
| ycalendar
| Sets the calendar system to use with `y` date data.
| ysrc
| Sets the source reference on plot.ly for y .
| z
| Sets the aggregation data.
| zauto
| Determines the whether or not the color domain is
| computed with respect to the input data.
| zhoverformat
| Sets the hover text formatting rule using d3 formatting
| mini-languages which are very similar to those in
| Python. See: https://github.com/d3/d3-format/blob/maste
| r/README.md#locale_format
| zmax
| Sets the upper bound of color domain.
| zmin
| Sets the lower bound of color domain.
| zsrc
| Sets the source reference on plot.ly for z .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Histogram2dContour
|
| add_mesh3d(self, alphahull=None, autocolorscale=None, cauto=None, cmax=None, cmin=None, color=None, colorbar=None, colorscale=None, contour=None, customdata=None, customdatasrc=None, delaunayaxis=None, facecolor=None, facecolorsrc=None, flatshading=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, i=None, ids=None, idssrc=None, intensity=None, intensitysrc=None, isrc=None, j=None, jsrc=None, k=None, ksrc=None, legendgroup=None, lighting=None, lightposition=None, name=None, opacity=None, reversescale=None, scene=None, selectedpoints=None, showlegend=None, showscale=None, stream=None, text=None, textsrc=None, uid=None, vertexcolor=None, vertexcolorsrc=None, visible=None, x=None, xcalendar=None, xsrc=None, y=None, ycalendar=None, ysrc=None, z=None, zcalendar=None, zsrc=None, row=None, col=None, **kwargs)
| Add a new Mesh3d trace
|
| Draws sets of triangles with coordinates given by three
| 1-dimensional arrays in `x`, `y`, `z` and (1) a sets of `i`,
| `j`, `k` indices (2) Delaunay triangulation or (3) the Alpha-
| shape algorithm or (4) the Convex-hull algorithm
|
| Parameters
| ----------
| alphahull
| Determines how the mesh surface triangles are derived
| from the set of vertices (points) represented by the
| `x`, `y` and `z` arrays, if the `i`, `j`, `k` arrays
| are not supplied. For general use of `mesh3d` it is
| preferred that `i`, `j`, `k` are supplied. If *-1*,
| Delaunay triangulation is used, which is mainly
| suitable if the mesh is a single, more or less layer
| surface that is perpendicular to `delaunayaxis`. In
| case the `delaunayaxis` intersects the mesh surface at
| more than one point it will result triangles that are
| very long in the dimension of `delaunayaxis`. If *>0*,
| the alpha-shape algorithm is used. In this case, the
| positive `alphahull` value signals the use of the
| alpha-shape algorithm, _and_ its value acts as the
| parameter for the mesh fitting. If *0*, the convex-
| hull algorithm is used. It is suitable for convex
| bodies or if the intention is to enclose the `x`, `y`
| and `z` point set into a convex hull.
| autocolorscale
| Has an effect only if `color` is set to a numerical
| array. Determines whether the colorscale is a default
| palette (`autocolorscale: true`) or the palette
| determined by `colorscale`. In case `colorscale` is
| unspecified or `autocolorscale` is true, the default
| palette will be chosen according to whether numbers in
| the `color` array are all positive, all negative or
| mixed.
| cauto
| Has an effect only if `color` is set to a numerical
| array and `cmin`, `cmax` are set by the user. In this
| case, it controls whether the range of colors in
| `colorscale` is mapped to the range of values in the
| `color` array (`cauto: true`), or the `cmin`/`cmax`
| values (`cauto: false`). Defaults to `false` when
| `cmin`, `cmax` are set by the user.
| cmax
| Has an effect only if `color` is set to a numerical
| array. Sets the upper bound of the color domain. Value
| should be associated to the `color` array index, and if
| set, `cmin` must be set as well.
| cmin
| Has an effect only if `color` is set to a numerical
| array. Sets the lower bound of the color domain. Value
| should be associated to the `color` array index, and if
| set, `cmax` must be set as well.
| color
| Sets the color of the whole mesh
| colorbar
| plotly.graph_objs.mesh3d.ColorBar instance or dict with
| compatible properties
| colorscale
| Sets the colorscale and only has an effect if `color`
| is set to a numerical array. 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, use `cmin` and `cmax`.
| Alternatively, `colorscale` may be a palette name
| string of the following list: Greys, YlGnBu, Greens,
| YlOrRd, Bluered, RdBu, Reds, Blues, Picnic, Rainbow,
| Portland, Jet, Hot, Blackbody, Earth, Electric,
| Viridis, Cividis
| contour
| plotly.graph_objs.mesh3d.Contour instance or dict with
| compatible properties
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| delaunayaxis
| Sets the Delaunay axis, which is the axis that is
| perpendicular to the surface of the Delaunay
| triangulation. It has an effect if `i`, `j`, `k` are
| not provided and `alphahull` is set to indicate
| Delaunay triangulation.
| facecolor
| Sets the color of each face Overrides *color* and
| *vertexcolor*.
| facecolorsrc
| Sets the source reference on plot.ly for facecolor .
| flatshading
| Determines whether or not normal smoothing is applied
| to the meshes, creating meshes with an angular, low-
| poly look via flat reflections.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.mesh3d.Hoverlabel instance or dict
| with compatible properties
| i
| A vector of vertex indices, i.e. integer values between
| 0 and the length of the vertex vectors, representing
| the *first* vertex of a triangle. For example, `{i[m],
| j[m], k[m]}` together represent face m (triangle m) in
| the mesh, where `i[m] = n` points to the triplet
| `{x[n], y[n], z[n]}` in the vertex arrays. Therefore,
| each element in `i` represents a point in space, which
| is the first vertex of a triangle.
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| intensity
| Sets the vertex intensity values, used for plotting
| fields on meshes
| intensitysrc
| Sets the source reference on plot.ly for intensity .
| isrc
| Sets the source reference on plot.ly for i .
| j
| A vector of vertex indices, i.e. integer values between
| 0 and the length of the vertex vectors, representing
| the *second* vertex of a triangle. For example, `{i[m],
| j[m], k[m]}` together represent face m (triangle m) in
| the mesh, where `j[m] = n` points to the triplet
| `{x[n], y[n], z[n]}` in the vertex arrays. Therefore,
| each element in `j` represents a point in space, which
| is the second vertex of a triangle.
| jsrc
| Sets the source reference on plot.ly for j .
| k
| A vector of vertex indices, i.e. integer values between
| 0 and the length of the vertex vectors, representing
| the *third* vertex of a triangle. For example, `{i[m],
| j[m], k[m]}` together represent face m (triangle m) in
| the mesh, where `k[m] = n` points to the triplet
| `{x[n], y[n], z[n]}` in the vertex arrays. Therefore,
| each element in `k` represents a point in space, which
| is the third vertex of a triangle.
| ksrc
| Sets the source reference on plot.ly for k .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| lighting
| plotly.graph_objs.mesh3d.Lighting instance or dict with
| compatible properties
| lightposition
| plotly.graph_objs.mesh3d.Lightposition instance or dict
| with compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the surface.
| reversescale
| Has an effect only if `color` is set to a numerical
| array. Reverses the color mapping if true (`cmin` will
| correspond to the last color in the array and `cmax`
| will correspond to the first color).
| scene
| Sets a reference between this trace's 3D coordinate
| system and a 3D scene. If *scene* (the default value),
| the (x,y,z) coordinates refer to `layout.scene`. If
| *scene2*, the (x,y,z) coordinates refer to
| `layout.scene2`, and so on.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| showscale
| Determines whether or not a colorbar is displayed for
| this trace.
| stream
| plotly.graph_objs.mesh3d.Stream instance or dict with
| compatible properties
| text
| Sets the text elements associated with the vertices. If
| trace `hoverinfo` contains a *text* flag and
| *hovertext* is not set, these elements will be seen in
| the hover labels.
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| vertexcolor
| Sets the color of each vertex Overrides *color*.
| vertexcolorsrc
| Sets the source reference on plot.ly for vertexcolor .
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the X coordinates of the vertices. The nth element
| of vectors `x`, `y` and `z` jointly represent the X, Y
| and Z coordinates of the nth vertex.
| xcalendar
| Sets the calendar system to use with `x` date data.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| Sets the Y coordinates of the vertices. The nth element
| of vectors `x`, `y` and `z` jointly represent the X, Y
| and Z coordinates of the nth vertex.
| ycalendar
| Sets the calendar system to use with `y` date data.
| ysrc
| Sets the source reference on plot.ly for y .
| z
| Sets the Z coordinates of the vertices. The nth element
| of vectors `x`, `y` and `z` jointly represent the X, Y
| and Z coordinates of the nth vertex.
| zcalendar
| Sets the calendar system to use with `z` date data.
| zsrc
| Sets the source reference on plot.ly for z .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Mesh3d
|
| add_ohlc(self, close=None, closesrc=None, customdata=None, customdatasrc=None, decreasing=None, high=None, highsrc=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, increasing=None, legendgroup=None, line=None, low=None, lowsrc=None, name=None, opacity=None, open=None, opensrc=None, selectedpoints=None, showlegend=None, stream=None, text=None, textsrc=None, tickwidth=None, uid=None, visible=None, x=None, xaxis=None, xcalendar=None, xsrc=None, yaxis=None, row=None, col=None, **kwargs)
| Add a new Ohlc trace
|
| The ohlc (short for Open-High-Low-Close) is a style of
| financial chart describing open, high, low and close for a
| given `x` coordinate (most likely time). The tip of the lines
| represent the `low` and `high` values and the horizontal
| segments represent the `open` and `close` values. Sample points
| where the close value is higher (lower) then the open value are
| called increasing (decreasing). By default, increasing items
| are drawn in green whereas decreasing are drawn in red.
|
| Parameters
| ----------
| close
| Sets the close values.
| closesrc
| Sets the source reference on plot.ly for close .
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| decreasing
| plotly.graph_objs.ohlc.Decreasing instance or dict with
| compatible properties
| high
| Sets the high values.
| highsrc
| Sets the source reference on plot.ly for high .
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.ohlc.Hoverlabel instance or dict with
| compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| increasing
| plotly.graph_objs.ohlc.Increasing instance or dict with
| compatible properties
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.ohlc.Line instance or dict with
| compatible properties
| low
| Sets the low values.
| lowsrc
| Sets the source reference on plot.ly for low .
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| open
| Sets the open values.
| opensrc
| Sets the source reference on plot.ly for open .
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.ohlc.Stream instance or dict with
| compatible properties
| text
| Sets hover text elements associated with each sample
| point. If a single string, the same string appears over
| all the data points. If an array of string, the items
| are mapped in order to this trace's sample points.
| textsrc
| Sets the source reference on plot.ly for text .
| tickwidth
| Sets the width of the open/close tick marks relative to
| the *x* minimal interval.
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the x coordinates. If absent, linear coordinate
| will be generated.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xcalendar
| Sets the calendar system to use with `x` date data.
| xsrc
| Sets the source reference on plot.ly for x .
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Ohlc
|
| add_parcoords(self, customdata=None, customdatasrc=None, dimensions=None, domain=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, labelfont=None, legendgroup=None, line=None, name=None, opacity=None, rangefont=None, selectedpoints=None, showlegend=None, stream=None, tickfont=None, uid=None, visible=None, row=None, col=None, **kwargs)
| Add a new Parcoords trace
|
| Parallel coordinates for multidimensional exploratory data
| analysis. The samples are specified in `dimensions`. The colors
| are set in `line.color`.
|
| Parameters
| ----------
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| dimensions
| The dimensions (variables) of the parallel coordinates
| chart. 2..60 dimensions are supported.
| domain
| plotly.graph_objs.parcoords.Domain instance or dict
| with compatible properties
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.parcoords.Hoverlabel instance or dict
| with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| labelfont
| Sets the font for the `dimension` labels.
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.parcoords.Line instance or dict with
| compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| rangefont
| Sets the font for the `dimension` range values.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.parcoords.Stream instance or dict
| with compatible properties
| tickfont
| Sets the font for the `dimension` tick values.
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Parcoords
|
| add_pie(self, customdata=None, customdatasrc=None, direction=None, dlabel=None, domain=None, hole=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hovertext=None, hovertextsrc=None, ids=None, idssrc=None, insidetextfont=None, label0=None, labels=None, labelssrc=None, legendgroup=None, marker=None, name=None, opacity=None, outsidetextfont=None, pull=None, pullsrc=None, rotation=None, scalegroup=None, selectedpoints=None, showlegend=None, sort=None, stream=None, text=None, textfont=None, textinfo=None, textposition=None, textpositionsrc=None, textsrc=None, uid=None, values=None, valuessrc=None, visible=None, row=None, col=None, **kwargs)
| Add a new Pie trace
|
| A data visualized by the sectors of the pie is set in `values`.
| The sector labels are set in `labels`. The sector colors are
| set in `marker.colors`
|
| Parameters
| ----------
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| direction
| Specifies the direction at which succeeding sectors
| follow one another.
| dlabel
| Sets the label step. See `label0` for more info.
| domain
| plotly.graph_objs.pie.Domain instance or dict with
| compatible properties
| hole
| Sets the fraction of the radius to cut out of the pie.
| Use this to make a donut chart.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.pie.Hoverlabel instance or dict with
| compatible properties
| hovertext
| Sets hover text elements associated with each sector.
| If a single string, the same string appears for all
| data points. If an array of string, the items are
| mapped in order of this trace's sectors. To be seen,
| trace `hoverinfo` must contain a *text* flag.
| hovertextsrc
| Sets the source reference on plot.ly for hovertext .
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| insidetextfont
| Sets the font used for `textinfo` lying inside the pie.
| label0
| Alternate to `labels`. Builds a numeric set of labels.
| Use with `dlabel` where `label0` is the starting label
| and `dlabel` the step.
| labels
| Sets the sector labels. If `labels` entries are
| duplicated, we sum associated `values` or simply count
| occurrences if `values` is not provided. For other
| array attributes (including color) we use the first
| non-empty entry among all occurrences of the label.
| labelssrc
| Sets the source reference on plot.ly for labels .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| marker
| plotly.graph_objs.pie.Marker instance or dict with
| compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| outsidetextfont
| Sets the font used for `textinfo` lying outside the
| pie.
| pull
| Sets the fraction of larger radius to pull the sectors
| out from the center. This can be a constant to pull all
| slices apart from each other equally or an array to
| highlight one or more slices.
| pullsrc
| Sets the source reference on plot.ly for pull .
| rotation
| Instead of the first slice starting at 12 o'clock,
| rotate to some other angle.
| scalegroup
| If there are multiple pies that should be sized
| according to their totals, link them by providing a
| non-empty group id here shared by every trace in the
| same group.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| sort
| Determines whether or not the sectors are reordered
| from largest to smallest.
| stream
| plotly.graph_objs.pie.Stream instance or dict with
| compatible properties
| text
| Sets text elements associated with each sector. If
| trace `textinfo` contains a *text* flag, these elements
| will seen on the chart. If trace `hoverinfo` contains a
| *text* flag and *hovertext* is not set, these elements
| will be seen in the hover labels.
| textfont
| Sets the font used for `textinfo`.
| textinfo
| Determines which trace information appear on the graph.
| textposition
| Specifies the location of the `textinfo`.
| textpositionsrc
| Sets the source reference on plot.ly for textposition
| .
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| values
| Sets the values of the sectors of this pie chart. If
| omitted, we count occurrences of each label.
| valuessrc
| Sets the source reference on plot.ly for values .
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Pie
|
| add_pointcloud(self, customdata=None, customdatasrc=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, indices=None, indicessrc=None, legendgroup=None, marker=None, name=None, opacity=None, selectedpoints=None, showlegend=None, stream=None, text=None, textsrc=None, uid=None, visible=None, x=None, xaxis=None, xbounds=None, xboundssrc=None, xsrc=None, xy=None, xysrc=None, y=None, yaxis=None, ybounds=None, yboundssrc=None, ysrc=None, row=None, col=None, **kwargs)
| Add a new Pointcloud trace
|
| The data visualized as a point cloud set in `x` and `y` using
| the WebGl plotting engine.
|
| Parameters
| ----------
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.pointcloud.Hoverlabel instance or
| dict with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| indices
| A sequential value, 0..n, supply it to avoid creating
| this array inside plotting. If specified, it must be a
| typed `Int32Array` array. Its length must be equal to
| or greater than the number of points. For the best
| performance and memory use, create one large `indices`
| typed array that is guaranteed to be at least as long
| as the largest number of points during use, and reuse
| it on each `Plotly.restyle()` call.
| indicessrc
| Sets the source reference on plot.ly for indices .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| marker
| plotly.graph_objs.pointcloud.Marker instance or dict
| with compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.pointcloud.Stream instance or dict
| with compatible properties
| text
| Sets text elements associated with each (x,y) pair. If
| a single string, the same string appears over all the
| data points. If an array of string, the items are
| mapped in order to the this trace's (x,y) coordinates.
| If trace `hoverinfo` contains a *text* flag and
| *hovertext* is not set, these elements will be seen in
| the hover labels.
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the x coordinates.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xbounds
| Specify `xbounds` in the shape of `[xMin, xMax] to
| avoid looping through the `xy` typed array. Use it in
| conjunction with `xy` and `ybounds` for the performance
| benefits.
| xboundssrc
| Sets the source reference on plot.ly for xbounds .
| xsrc
| Sets the source reference on plot.ly for x .
| xy
| Faster alternative to specifying `x` and `y`
| separately. If supplied, it must be a typed
| `Float32Array` array that represents points such that
| `xy[i * 2] = x[i]` and `xy[i * 2 + 1] = y[i]`
| xysrc
| Sets the source reference on plot.ly for xy .
| y
| Sets the y coordinates.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ybounds
| Specify `ybounds` in the shape of `[yMin, yMax] to
| avoid looping through the `xy` typed array. Use it in
| conjunction with `xy` and `xbounds` for the performance
| benefits.
| yboundssrc
| Sets the source reference on plot.ly for ybounds .
| ysrc
| Sets the source reference on plot.ly for y .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Pointcloud
|
| add_sankey(self, arrangement=None, customdata=None, customdatasrc=None, domain=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, link=None, name=None, node=None, opacity=None, orientation=None, selectedpoints=None, showlegend=None, stream=None, textfont=None, uid=None, valueformat=None, valuesuffix=None, visible=None, row=None, col=None, **kwargs)
| Add a new Sankey trace
|
| Sankey plots for network flow data analysis. The nodes are
| specified in `nodes` and the links between sources and targets
| in `links`. The colors are set in `nodes[i].color` and
| `links[i].color`; otherwise defaults are used.
|
| Parameters
| ----------
| arrangement
| If value is `snap` (the default), the node arrangement
| is assisted by automatic snapping of elements to
| preserve space between nodes specified via `nodepad`.
| If value is `perpendicular`, the nodes can only move
| along a line perpendicular to the flow. If value is
| `freeform`, the nodes can freely move on the plane. If
| value is `fixed`, the nodes are stationary.
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| domain
| plotly.graph_objs.sankey.Domain instance or dict with
| compatible properties
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.sankey.Hoverlabel instance or dict
| with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| link
| The links of the Sankey plot.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| node
| The nodes of the Sankey plot.
| opacity
| Sets the opacity of the trace.
| orientation
| Sets the orientation of the Sankey diagram.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.sankey.Stream instance or dict with
| compatible properties
| textfont
| Sets the font for node labels
| uid
|
| valueformat
| Sets the value formatting rule using d3 formatting
| mini-language which is similar to those of Python. See
| https://github.com/d3/d3-format/blob/master/README.md#l
| ocale_format
| valuesuffix
| Adds a unit to follow the value in the hover tooltip.
| Add a space if a separation is necessary from the
| value.
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Sankey
|
| add_scatter(self, cliponaxis=None, connectgaps=None, customdata=None, customdatasrc=None, dx=None, dy=None, error_x=None, error_y=None, fill=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hoveron=None, hovertext=None, hovertextsrc=None, ids=None, idssrc=None, legendgroup=None, line=None, marker=None, mode=None, name=None, opacity=None, r=None, rsrc=None, selected=None, selectedpoints=None, showlegend=None, stream=None, t=None, text=None, textfont=None, textposition=None, textpositionsrc=None, textsrc=None, tsrc=None, uid=None, unselected=None, visible=None, x=None, x0=None, xaxis=None, xcalendar=None, xsrc=None, y=None, y0=None, yaxis=None, ycalendar=None, ysrc=None, row=None, col=None, **kwargs)
| Add a new Scatter trace
|
| The scatter trace type encompasses line charts, scatter charts,
| text charts, and bubble charts. The data visualized as scatter
| point or lines is set in `x` and `y`. Text (appearing either on
| the chart or on hover only) is via `text`. Bubble charts are
| achieved by setting `marker.size` and/or `marker.color` to
| numerical arrays.
|
| Parameters
| ----------
| cliponaxis
| Determines whether or not markers and text nodes are
| clipped about the subplot axes. To show markers and
| text nodes above axis lines and tick labels, make sure
| to set `xaxis.layer` and `yaxis.layer` to *below
| traces*.
| connectgaps
| Determines whether or not gaps (i.e. {nan} or missing
| values) in the provided data arrays are connected.
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| dx
| Sets the x coordinate step. See `x0` for more info.
| dy
| Sets the y coordinate step. See `y0` for more info.
| error_x
| plotly.graph_objs.scatter.ErrorX instance or dict with
| compatible properties
| error_y
| plotly.graph_objs.scatter.ErrorY instance or dict with
| compatible properties
| fill
| Sets the area to fill with a solid color. Use with
| `fillcolor` if not *none*. *tozerox* and *tozeroy* fill
| to x=0 and y=0 respectively. *tonextx* and *tonexty*
| fill between the endpoints of this trace and the
| endpoints of the trace before it, connecting those
| endpoints with straight lines (to make a stacked area
| graph); if there is no trace before it, they behave
| like *tozerox* and *tozeroy*. *toself* connects the
| endpoints of the trace (or each segment of the trace if
| it has gaps) into a closed shape. *tonext* fills the
| space between two traces if one completely encloses the
| other (eg consecutive contour lines), and behaves like
| *toself* if there is no trace before it. *tonext*
| should not be used if one trace does not enclose the
| other.
| fillcolor
| Sets the fill color. Defaults to a half-transparent
| variant of the line color, marker color, or marker line
| color, whichever is available.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.scatter.Hoverlabel instance or dict
| with compatible properties
| hoveron
| Do the hover effects highlight individual points
| (markers or line points) or do they highlight filled
| regions? If the fill is *toself* or *tonext* and there
| are no markers or text, then the default is *fills*,
| otherwise it is *points*.
| hovertext
| Sets hover text elements associated with each (x,y)
| pair. If a single string, the same string appears over
| all the data points. If an array of string, the items
| are mapped in order to the this trace's (x,y)
| coordinates. To be seen, trace `hoverinfo` must contain
| a *text* flag.
| hovertextsrc
| Sets the source reference on plot.ly for hovertext .
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.scatter.Line instance or dict with
| compatible properties
| marker
| plotly.graph_objs.scatter.Marker instance or dict with
| compatible properties
| mode
| Determines the drawing mode for this scatter trace. If
| the provided `mode` includes *text* then the `text`
| elements appear at the coordinates. Otherwise, the
| `text` elements appear on hover. If there are less than
| 20 points, then the default is *lines+markers*.
| Otherwise, *lines*.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| r
| For legacy polar chart only.Please switch to
| *scatterpolar* trace type.Sets the radial coordinates.
| rsrc
| Sets the source reference on plot.ly for r .
| selected
| plotly.graph_objs.scatter.Selected instance or dict
| with compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.scatter.Stream instance or dict with
| compatible properties
| t
| For legacy polar chart only.Please switch to
| *scatterpolar* trace type.Sets the angular coordinates.
| text
| Sets text elements associated with each (x,y) pair. If
| a single string, the same string appears over all the
| data points. If an array of string, the items are
| mapped in order to the this trace's (x,y) coordinates.
| If trace `hoverinfo` contains a *text* flag and
| *hovertext* is not set, these elements will be seen in
| the hover labels.
| textfont
| Sets the text font.
| textposition
| Sets the positions of the `text` elements with respects
| to the (x,y) coordinates.
| textpositionsrc
| Sets the source reference on plot.ly for textposition
| .
| textsrc
| Sets the source reference on plot.ly for text .
| tsrc
| Sets the source reference on plot.ly for t .
| uid
|
| unselected
| plotly.graph_objs.scatter.Unselected instance or dict
| with compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the x coordinates.
| x0
| Alternate to `x`. Builds a linear space of x
| coordinates. Use with `dx` where `x0` is the starting
| coordinate and `dx` the step.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xcalendar
| Sets the calendar system to use with `x` date data.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| Sets the y coordinates.
| y0
| Alternate to `y`. Builds a linear space of y
| coordinates. Use with `dy` where `y0` is the starting
| coordinate and `dy` the step.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ycalendar
| Sets the calendar system to use with `y` date data.
| ysrc
| Sets the source reference on plot.ly for y .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Scatter
|
| add_scatter3d(self, connectgaps=None, customdata=None, customdatasrc=None, error_x=None, error_y=None, error_z=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hovertext=None, hovertextsrc=None, ids=None, idssrc=None, legendgroup=None, line=None, marker=None, mode=None, name=None, opacity=None, projection=None, scene=None, selectedpoints=None, showlegend=None, stream=None, surfaceaxis=None, surfacecolor=None, text=None, textfont=None, textposition=None, textpositionsrc=None, textsrc=None, uid=None, visible=None, x=None, xcalendar=None, xsrc=None, y=None, ycalendar=None, ysrc=None, z=None, zcalendar=None, zsrc=None, row=None, col=None, **kwargs)
| Add a new Scatter3d trace
|
| The data visualized as scatter point or lines in 3D dimension
| is set in `x`, `y`, `z`. Text (appearing either on the chart or
| on hover only) is via `text`. Bubble charts are achieved by
| setting `marker.size` and/or `marker.color` Projections are
| achieved via `projection`. Surface fills are achieved via
| `surfaceaxis`.
|
| Parameters
| ----------
| connectgaps
| Determines whether or not gaps (i.e. {nan} or missing
| values) in the provided data arrays are connected.
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| error_x
| plotly.graph_objs.scatter3d.ErrorX instance or dict
| with compatible properties
| error_y
| plotly.graph_objs.scatter3d.ErrorY instance or dict
| with compatible properties
| error_z
| plotly.graph_objs.scatter3d.ErrorZ instance or dict
| with compatible properties
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.scatter3d.Hoverlabel instance or dict
| with compatible properties
| hovertext
| Sets text elements associated with each (x,y,z)
| triplet. If a single string, the same string appears
| over all the data points. If an array of string, the
| items are mapped in order to the this trace's (x,y,z)
| coordinates. To be seen, trace `hoverinfo` must contain
| a *text* flag.
| hovertextsrc
| Sets the source reference on plot.ly for hovertext .
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.scatter3d.Line instance or dict with
| compatible properties
| marker
| plotly.graph_objs.scatter3d.Marker instance or dict
| with compatible properties
| mode
| Determines the drawing mode for this scatter trace. If
| the provided `mode` includes *text* then the `text`
| elements appear at the coordinates. Otherwise, the
| `text` elements appear on hover. If there are less than
| 20 points, then the default is *lines+markers*.
| Otherwise, *lines*.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| projection
| plotly.graph_objs.scatter3d.Projection instance or dict
| with compatible properties
| scene
| Sets a reference between this trace's 3D coordinate
| system and a 3D scene. If *scene* (the default value),
| the (x,y,z) coordinates refer to `layout.scene`. If
| *scene2*, the (x,y,z) coordinates refer to
| `layout.scene2`, and so on.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.scatter3d.Stream instance or dict
| with compatible properties
| surfaceaxis
| If *-1*, the scatter points are not fill with a surface
| If *0*, *1*, *2*, the scatter points are filled with a
| Delaunay surface about the x, y, z respectively.
| surfacecolor
| Sets the surface fill color.
| text
| Sets text elements associated with each (x,y,z)
| triplet. If a single string, the same string appears
| over all the data points. If an array of string, the
| items are mapped in order to the this trace's (x,y,z)
| coordinates. If trace `hoverinfo` contains a *text*
| flag and *hovertext* is not set, these elements will be
| seen in the hover labels.
| textfont
| Sets the text font.
| textposition
| Sets the positions of the `text` elements with respects
| to the (x,y) coordinates.
| textpositionsrc
| Sets the source reference on plot.ly for textposition
| .
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the x coordinates.
| xcalendar
| Sets the calendar system to use with `x` date data.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| Sets the y coordinates.
| ycalendar
| Sets the calendar system to use with `y` date data.
| ysrc
| Sets the source reference on plot.ly for y .
| z
| Sets the z coordinates.
| zcalendar
| Sets the calendar system to use with `z` date data.
| zsrc
| Sets the source reference on plot.ly for z .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Scatter3d
|
| add_scattercarpet(self, a=None, asrc=None, b=None, bsrc=None, carpet=None, connectgaps=None, customdata=None, customdatasrc=None, fill=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hoveron=None, ids=None, idssrc=None, legendgroup=None, line=None, marker=None, mode=None, name=None, opacity=None, selected=None, selectedpoints=None, showlegend=None, stream=None, text=None, textfont=None, textposition=None, textpositionsrc=None, textsrc=None, uid=None, unselected=None, visible=None, xaxis=None, yaxis=None, row=None, col=None, **kwargs)
| Add a new Scattercarpet trace
|
| Plots a scatter trace on either the first carpet axis or the
| carpet axis with a matching `carpet` attribute.
|
| Parameters
| ----------
| a
| Sets the quantity of component `a` in each data point.
| If `a`, `b`, and `c` are all provided, they need not be
| normalized, only the relative values matter. If only
| two arrays are provided they must be normalized to
| match `ternary<i>.sum`.
| asrc
| Sets the source reference on plot.ly for a .
| b
| Sets the quantity of component `a` in each data point.
| If `a`, `b`, and `c` are all provided, they need not be
| normalized, only the relative values matter. If only
| two arrays are provided they must be normalized to
| match `ternary<i>.sum`.
| bsrc
| Sets the source reference on plot.ly for b .
| carpet
| An identifier for this carpet, so that `scattercarpet`
| and `scattercontour` traces can specify a carpet plot
| on which they lie
| connectgaps
| Determines whether or not gaps (i.e. {nan} or missing
| values) in the provided data arrays are connected.
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| fill
| Sets the area to fill with a solid color. Use with
| `fillcolor` if not *none*. scatterternary has a subset
| of the options available to scatter. *toself* connects
| the endpoints of the trace (or each segment of the
| trace if it has gaps) into a closed shape. *tonext*
| fills the space between two traces if one completely
| encloses the other (eg consecutive contour lines), and
| behaves like *toself* if there is no trace before it.
| *tonext* should not be used if one trace does not
| enclose the other.
| fillcolor
| Sets the fill color. Defaults to a half-transparent
| variant of the line color, marker color, or marker line
| color, whichever is available.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.scattercarpet.Hoverlabel instance or
| dict with compatible properties
| hoveron
| Do the hover effects highlight individual points
| (markers or line points) or do they highlight filled
| regions? If the fill is *toself* or *tonext* and there
| are no markers or text, then the default is *fills*,
| otherwise it is *points*.
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.scattercarpet.Line instance or dict
| with compatible properties
| marker
| plotly.graph_objs.scattercarpet.Marker instance or dict
| with compatible properties
| mode
| Determines the drawing mode for this scatter trace. If
| the provided `mode` includes *text* then the `text`
| elements appear at the coordinates. Otherwise, the
| `text` elements appear on hover. If there are less than
| 20 points, then the default is *lines+markers*.
| Otherwise, *lines*.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| selected
| plotly.graph_objs.scattercarpet.Selected instance or
| dict with compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.scattercarpet.Stream instance or dict
| with compatible properties
| text
| Sets text elements associated with each (a,b,c) point.
| If a single string, the same string appears over all
| the data points. If an array of strings, the items are
| mapped in order to the the data points in (a,b,c).
| textfont
| Sets the text font.
| textposition
| Sets the positions of the `text` elements with respects
| to the (x,y) coordinates.
| textpositionsrc
| Sets the source reference on plot.ly for textposition
| .
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| unselected
| plotly.graph_objs.scattercarpet.Unselected instance or
| dict with compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Scattercarpet
|
| add_scattergeo(self, connectgaps=None, customdata=None, customdatasrc=None, fill=None, fillcolor=None, geo=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hovertext=None, hovertextsrc=None, ids=None, idssrc=None, lat=None, latsrc=None, legendgroup=None, line=None, locationmode=None, locations=None, locationssrc=None, lon=None, lonsrc=None, marker=None, mode=None, name=None, opacity=None, selected=None, selectedpoints=None, showlegend=None, stream=None, text=None, textfont=None, textposition=None, textpositionsrc=None, textsrc=None, uid=None, unselected=None, visible=None, row=None, col=None, **kwargs)
| Add a new Scattergeo trace
|
| The data visualized as scatter point or lines on a geographic
| map is provided either by longitude/latitude pairs in `lon` and
| `lat` respectively or by geographic location IDs or names in
| `locations`.
|
| Parameters
| ----------
| connectgaps
| Determines whether or not gaps (i.e. {nan} or missing
| values) in the provided data arrays are connected.
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| fill
| Sets the area to fill with a solid color. Use with
| `fillcolor` if not *none*. *toself* connects the
| endpoints of the trace (or each segment of the trace if
| it has gaps) into a closed shape.
| fillcolor
| Sets the fill color. Defaults to a half-transparent
| variant of the line color, marker color, or marker line
| color, whichever is available.
| geo
| Sets a reference between this trace's geospatial
| coordinates and a geographic map. If *geo* (the default
| value), the geospatial coordinates refer to
| `layout.geo`. If *geo2*, the geospatial coordinates
| refer to `layout.geo2`, and so on.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.scattergeo.Hoverlabel instance or
| dict with compatible properties
| hovertext
| Sets hover text elements associated with each (lon,lat)
| pair or item in `locations`. If a single string, the
| same string appears over all the data points. If an
| array of string, the items are mapped in order to the
| this trace's (lon,lat) or `locations` coordinates. To
| be seen, trace `hoverinfo` must contain a *text* flag.
| hovertextsrc
| Sets the source reference on plot.ly for hovertext .
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| lat
| Sets the latitude coordinates (in degrees North).
| latsrc
| Sets the source reference on plot.ly for lat .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.scattergeo.Line instance or dict with
| compatible properties
| locationmode
| Determines the set of locations used to match entries
| in `locations` to regions on the map.
| locations
| Sets the coordinates via location IDs or names.
| Coordinates correspond to the centroid of each location
| given. See `locationmode` for more info.
| locationssrc
| Sets the source reference on plot.ly for locations .
| lon
| Sets the longitude coordinates (in degrees East).
| lonsrc
| Sets the source reference on plot.ly for lon .
| marker
| plotly.graph_objs.scattergeo.Marker instance or dict
| with compatible properties
| mode
| Determines the drawing mode for this scatter trace. If
| the provided `mode` includes *text* then the `text`
| elements appear at the coordinates. Otherwise, the
| `text` elements appear on hover. If there are less than
| 20 points, then the default is *lines+markers*.
| Otherwise, *lines*.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| selected
| plotly.graph_objs.scattergeo.Selected instance or dict
| with compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.scattergeo.Stream instance or dict
| with compatible properties
| text
| Sets text elements associated with each (lon,lat) pair
| or item in `locations`. If a single string, the same
| string appears over all the data points. If an array of
| string, the items are mapped in order to the this
| trace's (lon,lat) or `locations` coordinates. If trace
| `hoverinfo` contains a *text* flag and *hovertext* is
| not set, these elements will be seen in the hover
| labels.
| textfont
| Sets the text font.
| textposition
| Sets the positions of the `text` elements with respects
| to the (x,y) coordinates.
| textpositionsrc
| Sets the source reference on plot.ly for textposition
| .
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| unselected
| plotly.graph_objs.scattergeo.Unselected instance or
| dict with compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Scattergeo
|
| add_scattergl(self, connectgaps=None, customdata=None, customdatasrc=None, dx=None, dy=None, error_x=None, error_y=None, fill=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hoveron=None, ids=None, idssrc=None, legendgroup=None, line=None, marker=None, mode=None, name=None, opacity=None, selected=None, selectedpoints=None, showlegend=None, stream=None, text=None, textsrc=None, uid=None, unselected=None, visible=None, x=None, x0=None, xaxis=None, xcalendar=None, xsrc=None, y=None, y0=None, yaxis=None, ycalendar=None, ysrc=None, row=None, col=None, **kwargs)
| Add a new Scattergl trace
|
| The data visualized as scatter point or lines is set in `x` and
| `y` using the WebGL plotting engine. Bubble charts are achieved
| by setting `marker.size` and/or `marker.color` to a numerical
| arrays.
|
| Parameters
| ----------
| connectgaps
| Determines whether or not gaps (i.e. {nan} or missing
| values) in the provided data arrays are connected.
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| dx
| Sets the x coordinate step. See `x0` for more info.
| dy
| Sets the y coordinate step. See `y0` for more info.
| error_x
| plotly.graph_objs.scattergl.ErrorX instance or dict
| with compatible properties
| error_y
| plotly.graph_objs.scattergl.ErrorY instance or dict
| with compatible properties
| fill
| Sets the area to fill with a solid color. Use with
| `fillcolor` if not *none*. *tozerox* and *tozeroy* fill
| to x=0 and y=0 respectively. *tonextx* and *tonexty*
| fill between the endpoints of this trace and the
| endpoints of the trace before it, connecting those
| endpoints with straight lines (to make a stacked area
| graph); if there is no trace before it, they behave
| like *tozerox* and *tozeroy*. *toself* connects the
| endpoints of the trace (or each segment of the trace if
| it has gaps) into a closed shape. *tonext* fills the
| space between two traces if one completely encloses the
| other (eg consecutive contour lines), and behaves like
| *toself* if there is no trace before it. *tonext*
| should not be used if one trace does not enclose the
| other.
| fillcolor
| Sets the fill color. Defaults to a half-transparent
| variant of the line color, marker color, or marker line
| color, whichever is available.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.scattergl.Hoverlabel instance or dict
| with compatible properties
| hoveron
| Do the hover effects highlight individual points
| (markers or line points) or do they highlight filled
| regions? If the fill is *toself* or *tonext* and there
| are no markers or text, then the default is *fills*,
| otherwise it is *points*.
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.scattergl.Line instance or dict with
| compatible properties
| marker
| plotly.graph_objs.scattergl.Marker instance or dict
| with compatible properties
| mode
| Determines the drawing mode for this scatter trace.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| selected
| plotly.graph_objs.scattergl.Selected instance or dict
| with compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.scattergl.Stream instance or dict
| with compatible properties
| text
| Sets text elements associated with each (x,y) pair to
| appear on hover. If a single string, the same string
| appears over all the data points. If an array of
| string, the items are mapped in order to the this
| trace's (x,y) coordinates.
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| unselected
| plotly.graph_objs.scattergl.Unselected instance or dict
| with compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the x coordinates.
| x0
| Alternate to `x`. Builds a linear space of x
| coordinates. Use with `dx` where `x0` is the starting
| coordinate and `dx` the step.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xcalendar
| Sets the calendar system to use with `x` date data.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| Sets the y coordinates.
| y0
| Alternate to `y`. Builds a linear space of y
| coordinates. Use with `dy` where `y0` is the starting
| coordinate and `dy` the step.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ycalendar
| Sets the calendar system to use with `y` date data.
| ysrc
| Sets the source reference on plot.ly for y .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Scattergl
|
| add_scattermapbox(self, connectgaps=None, customdata=None, customdatasrc=None, fill=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hovertext=None, hovertextsrc=None, ids=None, idssrc=None, lat=None, latsrc=None, legendgroup=None, line=None, lon=None, lonsrc=None, marker=None, mode=None, name=None, opacity=None, selected=None, selectedpoints=None, showlegend=None, stream=None, subplot=None, text=None, textfont=None, textposition=None, textsrc=None, uid=None, unselected=None, visible=None, row=None, col=None, **kwargs)
| Add a new Scattermapbox trace
|
| The data visualized as scatter point, lines or marker symbols
| on a Mapbox GL geographic map is provided by longitude/latitude
| pairs in `lon` and `lat`.
|
| Parameters
| ----------
| connectgaps
| Determines whether or not gaps (i.e. {nan} or missing
| values) in the provided data arrays are connected.
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| fill
| Sets the area to fill with a solid color. Use with
| `fillcolor` if not *none*. *toself* connects the
| endpoints of the trace (or each segment of the trace if
| it has gaps) into a closed shape.
| fillcolor
| Sets the fill color. Defaults to a half-transparent
| variant of the line color, marker color, or marker line
| color, whichever is available.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.scattermapbox.Hoverlabel instance or
| dict with compatible properties
| hovertext
| Sets hover text elements associated with each (lon,lat)
| pair If a single string, the same string appears over
| all the data points. If an array of string, the items
| are mapped in order to the this trace's (lon,lat)
| coordinates. To be seen, trace `hoverinfo` must contain
| a *text* flag.
| hovertextsrc
| Sets the source reference on plot.ly for hovertext .
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| lat
| Sets the latitude coordinates (in degrees North).
| latsrc
| Sets the source reference on plot.ly for lat .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.scattermapbox.Line instance or dict
| with compatible properties
| lon
| Sets the longitude coordinates (in degrees East).
| lonsrc
| Sets the source reference on plot.ly for lon .
| marker
| plotly.graph_objs.scattermapbox.Marker instance or dict
| with compatible properties
| mode
| Determines the drawing mode for this scatter trace. If
| the provided `mode` includes *text* then the `text`
| elements appear at the coordinates. Otherwise, the
| `text` elements appear on hover.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| selected
| plotly.graph_objs.scattermapbox.Selected instance or
| dict with compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.scattermapbox.Stream instance or dict
| with compatible properties
| subplot
| Sets a reference between this trace's data coordinates
| and a mapbox subplot. If *mapbox* (the default value),
| the data refer to `layout.mapbox`. If *mapbox2*, the
| data refer to `layout.mapbox2`, and so on.
| text
| Sets text elements associated with each (lon,lat) pair
| If a single string, the same string appears over all
| the data points. If an array of string, the items are
| mapped in order to the this trace's (lon,lat)
| coordinates. If trace `hoverinfo` contains a *text*
| flag and *hovertext* is not set, these elements will be
| seen in the hover labels.
| textfont
| Sets the icon text font. Has an effect only when `type`
| is set to *symbol*.
| textposition
| Sets the positions of the `text` elements with respects
| to the (x,y) coordinates.
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| unselected
| plotly.graph_objs.scattermapbox.Unselected instance or
| dict with compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Scattermapbox
|
| add_scatterpolar(self, cliponaxis=None, connectgaps=None, customdata=None, customdatasrc=None, fill=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hoveron=None, hovertext=None, hovertextsrc=None, ids=None, idssrc=None, legendgroup=None, line=None, marker=None, mode=None, name=None, opacity=None, r=None, rsrc=None, selected=None, selectedpoints=None, showlegend=None, stream=None, subplot=None, text=None, textfont=None, textposition=None, textpositionsrc=None, textsrc=None, theta=None, thetasrc=None, thetaunit=None, uid=None, unselected=None, visible=None, row=None, col=None, **kwargs)
| Add a new Scatterpolar trace
|
| The scatterpolar trace type encompasses line charts, scatter
| charts, text charts, and bubble charts in polar coordinates.
| The data visualized as scatter point or lines is set in `r`
| (radial) and `theta` (angular) coordinates Text (appearing
| either on the chart or on hover only) is via `text`. Bubble
| charts are achieved by setting `marker.size` and/or
| `marker.color` to numerical arrays.
|
| Parameters
| ----------
| cliponaxis
| Determines whether or not markers and text nodes are
| clipped about the subplot axes. To show markers and
| text nodes above axis lines and tick labels, make sure
| to set `xaxis.layer` and `yaxis.layer` to *below
| traces*.
| connectgaps
| Determines whether or not gaps (i.e. {nan} or missing
| values) in the provided data arrays are connected.
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| fill
| Sets the area to fill with a solid color. Use with
| `fillcolor` if not *none*. scatterpolar has a subset of
| the options available to scatter. *toself* connects the
| endpoints of the trace (or each segment of the trace if
| it has gaps) into a closed shape. *tonext* fills the
| space between two traces if one completely encloses the
| other (eg consecutive contour lines), and behaves like
| *toself* if there is no trace before it. *tonext*
| should not be used if one trace does not enclose the
| other.
| fillcolor
| Sets the fill color. Defaults to a half-transparent
| variant of the line color, marker color, or marker line
| color, whichever is available.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.scatterpolar.Hoverlabel instance or
| dict with compatible properties
| hoveron
| Do the hover effects highlight individual points
| (markers or line points) or do they highlight filled
| regions? If the fill is *toself* or *tonext* and there
| are no markers or text, then the default is *fills*,
| otherwise it is *points*.
| hovertext
| Sets hover text elements associated with each (x,y)
| pair. If a single string, the same string appears over
| all the data points. If an array of string, the items
| are mapped in order to the this trace's (x,y)
| coordinates. To be seen, trace `hoverinfo` must contain
| a *text* flag.
| hovertextsrc
| Sets the source reference on plot.ly for hovertext .
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.scatterpolar.Line instance or dict
| with compatible properties
| marker
| plotly.graph_objs.scatterpolar.Marker instance or dict
| with compatible properties
| mode
| Determines the drawing mode for this scatter trace. If
| the provided `mode` includes *text* then the `text`
| elements appear at the coordinates. Otherwise, the
| `text` elements appear on hover. If there are less than
| 20 points, then the default is *lines+markers*.
| Otherwise, *lines*.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| r
| Sets the radial coordinates
| rsrc
| Sets the source reference on plot.ly for r .
| selected
| plotly.graph_objs.scatterpolar.Selected instance or
| dict with compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.scatterpolar.Stream instance or dict
| with compatible properties
| subplot
| Sets a reference between this trace's data coordinates
| and a polar subplot. If *polar* (the default value),
| the data refer to `layout.polar`. If *polar2*, the data
| refer to `layout.polar2`, and so on.
| text
| Sets text elements associated with each (x,y) pair. If
| a single string, the same string appears over all the
| data points. If an array of string, the items are
| mapped in order to the this trace's (x,y) coordinates.
| If trace `hoverinfo` contains a *text* flag and
| *hovertext* is not set, these elements will be seen in
| the hover labels.
| textfont
| Sets the text font.
| textposition
| Sets the positions of the `text` elements with respects
| to the (x,y) coordinates.
| textpositionsrc
| Sets the source reference on plot.ly for textposition
| .
| textsrc
| Sets the source reference on plot.ly for text .
| theta
| Sets the angular coordinates
| thetasrc
| Sets the source reference on plot.ly for theta .
| thetaunit
| Sets the unit of input *theta* values. Has an effect
| only when on *linear* angular axes.
| uid
|
| unselected
| plotly.graph_objs.scatterpolar.Unselected instance or
| dict with compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Scatterpolar
|
| add_scatterpolargl(self, connectgaps=None, customdata=None, customdatasrc=None, fill=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hoveron=None, ids=None, idssrc=None, legendgroup=None, line=None, marker=None, mode=None, name=None, opacity=None, r=None, rsrc=None, selected=None, selectedpoints=None, showlegend=None, stream=None, subplot=None, text=None, textsrc=None, theta=None, thetasrc=None, thetaunit=None, uid=None, unselected=None, visible=None, row=None, col=None, **kwargs)
| Add a new Scatterpolargl trace
|
| The scatterpolargl trace type encompasses line charts, scatter
| charts, and bubble charts in polar coordinates using the WebGL
| plotting engine. The data visualized as scatter point or lines
| is set in `r` (radial) and `theta` (angular) coordinates Bubble
| charts are achieved by setting `marker.size` and/or
| `marker.color` to numerical arrays.
|
| Parameters
| ----------
| connectgaps
| Determines whether or not gaps (i.e. {nan} or missing
| values) in the provided data arrays are connected.
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| fill
| Sets the area to fill with a solid color. Use with
| `fillcolor` if not *none*. *tozerox* and *tozeroy* fill
| to x=0 and y=0 respectively. *tonextx* and *tonexty*
| fill between the endpoints of this trace and the
| endpoints of the trace before it, connecting those
| endpoints with straight lines (to make a stacked area
| graph); if there is no trace before it, they behave
| like *tozerox* and *tozeroy*. *toself* connects the
| endpoints of the trace (or each segment of the trace if
| it has gaps) into a closed shape. *tonext* fills the
| space between two traces if one completely encloses the
| other (eg consecutive contour lines), and behaves like
| *toself* if there is no trace before it. *tonext*
| should not be used if one trace does not enclose the
| other.
| fillcolor
| Sets the fill color. Defaults to a half-transparent
| variant of the line color, marker color, or marker line
| color, whichever is available.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.scatterpolargl.Hoverlabel instance or
| dict with compatible properties
| hoveron
| Do the hover effects highlight individual points
| (markers or line points) or do they highlight filled
| regions? If the fill is *toself* or *tonext* and there
| are no markers or text, then the default is *fills*,
| otherwise it is *points*.
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.scatterpolargl.Line instance or dict
| with compatible properties
| marker
| plotly.graph_objs.scatterpolargl.Marker instance or
| dict with compatible properties
| mode
| Determines the drawing mode for this scatter trace. If
| the provided `mode` includes *text* then the `text`
| elements appear at the coordinates. Otherwise, the
| `text` elements appear on hover. If there are less than
| 20 points, then the default is *lines+markers*.
| Otherwise, *lines*.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| r
| Sets the radial coordinates
| rsrc
| Sets the source reference on plot.ly for r .
| selected
| plotly.graph_objs.scatterpolargl.Selected instance or
| dict with compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.scatterpolargl.Stream instance or
| dict with compatible properties
| subplot
| Sets a reference between this trace's data coordinates
| and a polar subplot. If *polar* (the default value),
| the data refer to `layout.polar`. If *polar2*, the data
| refer to `layout.polar2`, and so on.
| text
| Sets text elements associated with each (x,y) pair. If
| a single string, the same string appears over all the
| data points. If an array of string, the items are
| mapped in order to the this trace's (x,y) coordinates.
| If trace `hoverinfo` contains a *text* flag and
| *hovertext* is not set, these elements will be seen in
| the hover labels.
| textsrc
| Sets the source reference on plot.ly for text .
| theta
| Sets the angular coordinates
| thetasrc
| Sets the source reference on plot.ly for theta .
| thetaunit
| Sets the unit of input *theta* values. Has an effect
| only when on *linear* angular axes.
| uid
|
| unselected
| plotly.graph_objs.scatterpolargl.Unselected instance or
| dict with compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Scatterpolargl
|
| add_scatterternary(self, a=None, asrc=None, b=None, bsrc=None, c=None, cliponaxis=None, connectgaps=None, csrc=None, customdata=None, customdatasrc=None, fill=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hoveron=None, hovertext=None, hovertextsrc=None, ids=None, idssrc=None, legendgroup=None, line=None, marker=None, mode=None, name=None, opacity=None, selected=None, selectedpoints=None, showlegend=None, stream=None, subplot=None, sum=None, text=None, textfont=None, textposition=None, textpositionsrc=None, textsrc=None, uid=None, unselected=None, visible=None, row=None, col=None, **kwargs)
| Add a new Scatterternary trace
|
| Provides similar functionality to the *scatter* type but on a
| ternary phase diagram. The data is provided by at least two
| arrays out of `a`, `b`, `c` triplets.
|
| Parameters
| ----------
| a
| Sets the quantity of component `a` in each data point.
| If `a`, `b`, and `c` are all provided, they need not be
| normalized, only the relative values matter. If only
| two arrays are provided they must be normalized to
| match `ternary<i>.sum`.
| asrc
| Sets the source reference on plot.ly for a .
| b
| Sets the quantity of component `a` in each data point.
| If `a`, `b`, and `c` are all provided, they need not be
| normalized, only the relative values matter. If only
| two arrays are provided they must be normalized to
| match `ternary<i>.sum`.
| bsrc
| Sets the source reference on plot.ly for b .
| c
| Sets the quantity of component `a` in each data point.
| If `a`, `b`, and `c` are all provided, they need not be
| normalized, only the relative values matter. If only
| two arrays are provided they must be normalized to
| match `ternary<i>.sum`.
| cliponaxis
| Determines whether or not markers and text nodes are
| clipped about the subplot axes. To show markers and
| text nodes above axis lines and tick labels, make sure
| to set `xaxis.layer` and `yaxis.layer` to *below
| traces*.
| connectgaps
| Determines whether or not gaps (i.e. {nan} or missing
| values) in the provided data arrays are connected.
| csrc
| Sets the source reference on plot.ly for c .
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| fill
| Sets the area to fill with a solid color. Use with
| `fillcolor` if not *none*. scatterternary has a subset
| of the options available to scatter. *toself* connects
| the endpoints of the trace (or each segment of the
| trace if it has gaps) into a closed shape. *tonext*
| fills the space between two traces if one completely
| encloses the other (eg consecutive contour lines), and
| behaves like *toself* if there is no trace before it.
| *tonext* should not be used if one trace does not
| enclose the other.
| fillcolor
| Sets the fill color. Defaults to a half-transparent
| variant of the line color, marker color, or marker line
| color, whichever is available.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.scatterternary.Hoverlabel instance or
| dict with compatible properties
| hoveron
| Do the hover effects highlight individual points
| (markers or line points) or do they highlight filled
| regions? If the fill is *toself* or *tonext* and there
| are no markers or text, then the default is *fills*,
| otherwise it is *points*.
| hovertext
| Sets hover text elements associated with each (a,b,c)
| point. If a single string, the same string appears over
| all the data points. If an array of strings, the items
| are mapped in order to the the data points in (a,b,c).
| To be seen, trace `hoverinfo` must contain a *text*
| flag.
| hovertextsrc
| Sets the source reference on plot.ly for hovertext .
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.scatterternary.Line instance or dict
| with compatible properties
| marker
| plotly.graph_objs.scatterternary.Marker instance or
| dict with compatible properties
| mode
| Determines the drawing mode for this scatter trace. If
| the provided `mode` includes *text* then the `text`
| elements appear at the coordinates. Otherwise, the
| `text` elements appear on hover. If there are less than
| 20 points, then the default is *lines+markers*.
| Otherwise, *lines*.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| selected
| plotly.graph_objs.scatterternary.Selected instance or
| dict with compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.scatterternary.Stream instance or
| dict with compatible properties
| subplot
| Sets a reference between this trace's data coordinates
| and a ternary subplot. If *ternary* (the default
| value), the data refer to `layout.ternary`. If
| *ternary2*, the data refer to `layout.ternary2`, and so
| on.
| sum
| The number each triplet should sum to, if only two of
| `a`, `b`, and `c` are provided. This overrides
| `ternary<i>.sum` to normalize this specific trace, but
| does not affect the values displayed on the axes. 0 (or
| missing) means to use ternary<i>.sum
| text
| Sets text elements associated with each (a,b,c) point.
| If a single string, the same string appears over all
| the data points. If an array of strings, the items are
| mapped in order to the the data points in (a,b,c). If
| trace `hoverinfo` contains a *text* flag and
| *hovertext* is not set, these elements will be seen in
| the hover labels.
| textfont
| Sets the text font.
| textposition
| Sets the positions of the `text` elements with respects
| to the (x,y) coordinates.
| textpositionsrc
| Sets the source reference on plot.ly for textposition
| .
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| unselected
| plotly.graph_objs.scatterternary.Unselected instance or
| dict with compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Scatterternary
|
| add_splom(self, customdata=None, customdatasrc=None, diagonal=None, dimensions=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, marker=None, name=None, opacity=None, selected=None, selectedpoints=None, showlegend=None, showlowerhalf=None, showupperhalf=None, stream=None, text=None, textsrc=None, uid=None, unselected=None, visible=None, xaxes=None, yaxes=None, row=None, col=None, **kwargs)
| Add a new Splom trace
|
| Splom traces generate scatter plot matrix visualizations. Each
| splom `dimensions` items correspond to a generated axis. Values
| for each of those dimensions are set in `dimensions[i].values`.
| Splom traces support all `scattergl` marker style attributes.
| Specify `layout.grid` attributes and/or layout x-axis and
| y-axis attributes for more control over the axis positioning
| and style.
|
| Parameters
| ----------
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| diagonal
| plotly.graph_objs.splom.Diagonal instance or dict with
| compatible properties
| dimensions
| plotly.graph_objs.splom.Dimension instance or dict with
| compatible properties
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.splom.Hoverlabel instance or dict
| with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| marker
| plotly.graph_objs.splom.Marker instance or dict with
| compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| selected
| plotly.graph_objs.splom.Selected instance or dict with
| compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| showlowerhalf
| Determines whether or not subplots on the lower half
| from the diagonal are displayed.
| showupperhalf
| Determines whether or not subplots on the upper half
| from the diagonal are displayed.
| stream
| plotly.graph_objs.splom.Stream instance or dict with
| compatible properties
| text
| Sets text elements associated with each (x,y) pair to
| appear on hover. If a single string, the same string
| appears over all the data points. If an array of
| string, the items are mapped in order to the this
| trace's (x,y) coordinates.
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| unselected
| plotly.graph_objs.splom.Unselected instance or dict
| with compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| xaxes
| Sets the list of x axes corresponding to this splom
| trace. By default, a splom will match the first N xaxes
| where N is the number of input dimensions.
| yaxes
| Sets the list of y axes corresponding to this splom
| trace. By default, a splom will match the first N yaxes
| where N is the number of input dimensions.
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Splom
|
| add_surface(self, autocolorscale=None, cauto=None, cmax=None, cmin=None, colorbar=None, colorscale=None, contours=None, customdata=None, customdatasrc=None, hidesurface=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, lighting=None, lightposition=None, name=None, opacity=None, reversescale=None, scene=None, selectedpoints=None, showlegend=None, showscale=None, stream=None, surfacecolor=None, surfacecolorsrc=None, text=None, textsrc=None, uid=None, visible=None, x=None, xcalendar=None, xsrc=None, y=None, ycalendar=None, ysrc=None, z=None, zcalendar=None, zsrc=None, row=None, col=None, **kwargs)
| Add a new Surface trace
|
| The data the describes the coordinates of the surface is set in
| `z`. Data in `z` should be a {2D array}. Coordinates in `x` and
| `y` can either be 1D {arrays} or {2D arrays} (e.g. to graph
| parametric surfaces). If not provided in `x` and `y`, the x and
| y coordinates are assumed to be linear starting at 0 with a
| unit step. The color scale corresponds to the `z` values by
| default. For custom color scales, use `surfacecolor` which
| should be a {2D array}, where its bounds can be controlled
| using `cmin` and `cmax`.
|
| Parameters
| ----------
| autocolorscale
| Determines whether or not the colorscale is picked
| using the sign of the input z values.
| cauto
| Determines the whether or not the color domain is
| computed with respect to the input data.
| cmax
| Sets the upper bound of color domain.
| cmin
| Sets the lower bound of color domain.
| colorbar
| plotly.graph_objs.surface.ColorBar instance or dict
| with compatible properties
| 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 z space, use zmin and zmax
| contours
| plotly.graph_objs.surface.Contours instance or dict
| with compatible properties
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| hidesurface
| Determines whether or not a surface is drawn. For
| example, set `hidesurface` to *false* `contours.x.show`
| to *true* and `contours.y.show` to *true* to draw a
| wire frame plot.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.surface.Hoverlabel instance or dict
| with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| lighting
| plotly.graph_objs.surface.Lighting instance or dict
| with compatible properties
| lightposition
| plotly.graph_objs.surface.Lightposition instance or
| dict with compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the surface.
| reversescale
| Reverses the colorscale.
| scene
| Sets a reference between this trace's 3D coordinate
| system and a 3D scene. If *scene* (the default value),
| the (x,y,z) coordinates refer to `layout.scene`. If
| *scene2*, the (x,y,z) coordinates refer to
| `layout.scene2`, and so on.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| showscale
| Determines whether or not a colorbar is displayed for
| this trace.
| stream
| plotly.graph_objs.surface.Stream instance or dict with
| compatible properties
| surfacecolor
| Sets the surface color values, used for setting a color
| scale independent of `z`.
| surfacecolorsrc
| Sets the source reference on plot.ly for surfacecolor
| .
| text
| Sets the text elements associated with each z value. If
| trace `hoverinfo` contains a *text* flag and
| *hovertext* is not set, these elements will be seen in
| the hover labels.
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the x coordinates.
| xcalendar
| Sets the calendar system to use with `x` date data.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| Sets the y coordinates.
| ycalendar
| Sets the calendar system to use with `y` date data.
| ysrc
| Sets the source reference on plot.ly for y .
| z
| Sets the z coordinates.
| zcalendar
| Sets the calendar system to use with `z` date data.
| zsrc
| Sets the source reference on plot.ly for z .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Surface
|
| add_table(self, cells=None, columnorder=None, columnordersrc=None, columnwidth=None, columnwidthsrc=None, customdata=None, customdatasrc=None, domain=None, header=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, ids=None, idssrc=None, legendgroup=None, name=None, opacity=None, selectedpoints=None, showlegend=None, stream=None, uid=None, visible=None, row=None, col=None, **kwargs)
| Add a new Table trace
|
| Table view for detailed data viewing. The data are arranged in
| a grid of rows and columns. Most styling can be specified for
| columns, rows or individual cells. Table is using a column-
| major order, ie. the grid is represented as a vector of column
| vectors.
|
| Parameters
| ----------
| cells
| plotly.graph_objs.table.Cells instance or dict with
| compatible properties
| columnorder
| Specifies the rendered order of the data columns; for
| example, a value `2` at position `0` means that column
| index `0` in the data will be rendered as the third
| column, as columns have an index base of zero.
| columnordersrc
| Sets the source reference on plot.ly for columnorder .
| columnwidth
| The width of columns expressed as a ratio. Columns fill
| the available width in proportion of their specified
| column widths.
| columnwidthsrc
| Sets the source reference on plot.ly for columnwidth .
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| domain
| plotly.graph_objs.table.Domain instance or dict with
| compatible properties
| header
| plotly.graph_objs.table.Header instance or dict with
| compatible properties
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.table.Hoverlabel instance or dict
| with compatible properties
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover.
| opacity
| Sets the opacity of the trace.
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| stream
| plotly.graph_objs.table.Stream instance or dict with
| compatible properties
| uid
|
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Table
|
| add_violin(self, bandwidth=None, box=None, customdata=None, customdatasrc=None, fillcolor=None, hoverinfo=None, hoverinfosrc=None, hoverlabel=None, hoveron=None, ids=None, idssrc=None, jitter=None, legendgroup=None, line=None, marker=None, meanline=None, name=None, opacity=None, orientation=None, pointpos=None, points=None, scalegroup=None, scalemode=None, selected=None, selectedpoints=None, showlegend=None, side=None, span=None, spanmode=None, stream=None, text=None, textsrc=None, uid=None, unselected=None, visible=None, x=None, x0=None, xaxis=None, xsrc=None, y=None, y0=None, yaxis=None, ysrc=None, row=None, col=None, **kwargs)
| Add a new Violin trace
|
| In vertical (horizontal) violin plots, statistics are computed
| using `y` (`x`) values. By supplying an `x` (`y`) array, one
| violin per distinct x (y) value is drawn If no `x` (`y`)
| {array} is provided, a single violin is drawn. That violin
| position is then positioned with with `name` or with `x0`
| (`y0`) if provided.
|
| Parameters
| ----------
| bandwidth
| Sets the bandwidth used to compute the kernel density
| estimate. By default, the bandwidth is determined by
| Silverman's rule of thumb.
| box
| plotly.graph_objs.violin.Box instance or dict with
| compatible properties
| customdata
| Assigns extra data each datum. This may be useful when
| listening to hover, click and selection events. Note
| that, *scatter* traces also appends customdata items in
| the markers DOM elements
| customdatasrc
| Sets the source reference on plot.ly for customdata .
| fillcolor
| Sets the fill color. Defaults to a half-transparent
| variant of the line color, marker color, or marker line
| color, whichever is available.
| hoverinfo
| Determines which trace information appear on hover. If
| `none` or `skip` are set, no information is displayed
| upon hovering. But, if `none` is set, click and hover
| events are still fired.
| hoverinfosrc
| Sets the source reference on plot.ly for hoverinfo .
| hoverlabel
| plotly.graph_objs.violin.Hoverlabel instance or dict
| with compatible properties
| hoveron
| Do the hover effects highlight individual violins or
| sample points or the kernel density estimate or any
| combination of them?
| ids
| Assigns id labels to each datum. These ids for object
| constancy of data points during animation. Should be an
| array of strings, not numbers or any other type.
| idssrc
| Sets the source reference on plot.ly for ids .
| jitter
| Sets the amount of jitter in the sample points drawn.
| If *0*, the sample points align along the distribution
| axis. If *1*, the sample points are drawn in a random
| jitter of width equal to the width of the violins.
| legendgroup
| Sets the legend group for this trace. Traces part of
| the same legend group hide/show at the same time when
| toggling legend items.
| line
| plotly.graph_objs.violin.Line instance or dict with
| compatible properties
| marker
| plotly.graph_objs.violin.Marker instance or dict with
| compatible properties
| meanline
| plotly.graph_objs.violin.Meanline instance or dict with
| compatible properties
| name
| Sets the trace name. The trace name appear as the
| legend item and on hover. For box traces, the name will
| also be used for the position coordinate, if `x` and
| `x0` (`y` and `y0` if horizontal) are missing and the
| position axis is categorical
| opacity
| Sets the opacity of the trace.
| orientation
| Sets the orientation of the violin(s). If *v* (*h*),
| the distribution is visualized along the vertical
| (horizontal).
| pointpos
| Sets the position of the sample points in relation to
| the violins. If *0*, the sample points are places over
| the center of the violins. Positive (negative) values
| correspond to positions to the right (left) for
| vertical violins and above (below) for horizontal
| violins.
| points
| If *outliers*, only the sample points lying outside the
| whiskers are shown If *suspectedoutliers*, the outlier
| points are shown and points either less than 4*Q1-3*Q3
| or greater than 4*Q3-3*Q1 are highlighted (see
| `outliercolor`) If *all*, all sample points are shown
| If *false*, only the violins are shown with no sample
| points
| scalegroup
| If there are multiple violins that should be sized
| according to to some metric (see `scalemode`), link
| them by providing a non-empty group id here shared by
| every trace in the same group.
| scalemode
| Sets the metric by which the width of each violin is
| determined.*width* means each violin has the same (max)
| width*count* means the violins are scaled by the number
| of sample points makingup each violin.
| selected
| plotly.graph_objs.violin.Selected instance or dict with
| compatible properties
| selectedpoints
| Array containing integer indices of selected points.
| Has an effect only for traces that support selections.
| Note that an empty array means an empty selection where
| the `unselected` are turned on for all points, whereas,
| any other non-array values means no selection all where
| the `selected` and `unselected` styles have no effect.
| showlegend
| Determines whether or not an item corresponding to this
| trace is shown in the legend.
| side
| Determines on which side of the position value the
| density function making up one half of a violin is
| plotted. Useful when comparing two violin traces under
| *overlay* mode, where one trace has `side` set to
| *positive* and the other to *negative*.
| span
| Sets the span in data space for which the density
| function will be computed. Has an effect only when
| `spanmode` is set to *manual*.
| spanmode
| Sets the method by which the span in data space where
| the density function will be computed. *soft* means the
| span goes from the sample's minimum value minus two
| bandwidths to the sample's maximum value plus two
| bandwidths. *hard* means the span goes from the
| sample's minimum to its maximum value. For custom span
| settings, use mode *manual* and fill in the `span`
| attribute.
| stream
| plotly.graph_objs.violin.Stream instance or dict with
| compatible properties
| text
| Sets the text elements associated with each sample
| value. If a single string, the same string appears over
| all the data points. If an array of string, the items
| are mapped in order to the this trace's (x,y)
| coordinates. To be seen, trace `hoverinfo` must contain
| a *text* flag.
| textsrc
| Sets the source reference on plot.ly for text .
| uid
|
| unselected
| plotly.graph_objs.violin.Unselected instance or dict
| with compatible properties
| visible
| Determines whether or not this trace is visible. If
| *legendonly*, the trace is not drawn, but can appear as
| a legend item (provided that the legend itself is
| visible).
| x
| Sets the x sample data or coordinates. See overview for
| more info.
| x0
| Sets the x coordinate of the box. See overview for more
| info.
| xaxis
| Sets a reference between this trace's x coordinates and
| a 2D cartesian x axis. If *x* (the default value), the
| x coordinates refer to `layout.xaxis`. If *x2*, the x
| coordinates refer to `layout.xaxis2`, and so on.
| xsrc
| Sets the source reference on plot.ly for x .
| y
| Sets the y sample data or coordinates. See overview for
| more info.
| y0
| Sets the y coordinate of the box. See overview for more
| info.
| yaxis
| Sets a reference between this trace's y coordinates and
| a 2D cartesian y axis. If *y* (the default value), the
| y coordinates refer to `layout.yaxis`. If *y2*, the y
| coordinates refer to `layout.yaxis2`, and so on.
| ysrc
| Sets the source reference on plot.ly for y .
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| Violin
|
| ----------------------------------------------------------------------
| Methods inherited from plotly.basewidget.BaseFigureWidget:
|
| on_edits_completed(self, fn)
| Register a function to be called after all pending trace and layout
| edit operations have completed
|
| If there are no pending edit operations then function is called
| immediately
|
| Parameters
| ----------
| fn : callable
| Function of zero arguments to be called when all pending edit
| operations have completed
|
| ----------------------------------------------------------------------
| Data descriptors inherited from plotly.basewidget.BaseFigureWidget:
|
| frames
|
| ----------------------------------------------------------------------
| Methods inherited from plotly.basedatatypes.BaseFigure:
|
| __contains__(self, prop)
|
| __eq__(self, other)
|
| __getitem__(self, prop)
|
| __iter__(self)
|
| __repr__(self)
| Customize Figure representation when displayed in the
| terminal/notebook
|
| __setattr__(self, prop, value)
| Parameters
| ----------
| prop : str
| The name of a direct child of this object
| value
| New property value
| Returns
| -------
| None
|
| __setitem__(self, prop, value)
| # Magic Methods
| # -------------
|
| add_trace(self, trace, row=None, col=None)
| Add a trace to the figure
|
| Parameters
| ----------
| trace : BaseTraceType or dict
| Either:
| - An instances of a trace classe from the plotly.graph_objs
| package (e.g plotly.graph_objs.Scatter, plotly.graph_objs.Bar)
| - or a dicts where:
|
| - The 'type' property specifies the trace type (e.g.
| 'scatter', 'bar', 'area', etc.). If the dict has no 'type'
| property then 'scatter' is assumed.
| - All remaining properties are passed to the constructor
| of the specified trace type.
|
| row : int or None (default)
| Subplot row index (starting from 1) for the trace to be added.
| Only valid if figure was created using
| `plotly.tools.make_subplots`
| col : int or None (default)
| Subplot col index (starting from 1) for the trace to be added.
| Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| BaseTraceType
| The newly added trace
|
| Examples
| --------
| >>> from plotly import tools
| >>> import plotly.graph_objs as go
|
| Add two Scatter traces to a figure
| >>> fig = go.Figure()
| >>> fig.add_trace(go.Scatter(x=[1,2,3], y=[2,1,2]))
| >>> fig.add_trace(go.Scatter(x=[1,2,3], y=[2,1,2]))
|
|
| Add two Scatter traces to vertically stacked subplots
| >>> fig = tools.make_subplots(rows=2)
| This is the format of your plot grid:
| [ (1,1) x1,y1 ]
| [ (2,1) x2,y2 ]
|
| >>> fig.add_trace(go.Scatter(x=[1,2,3], y=[2,1,2]), row=1, col=1)
| >>> fig.add_trace(go.Scatter(x=[1,2,3], y=[2,1,2]), row=2, col=1)
|
| add_traces(self, data, rows=None, cols=None)
| Add traces to the figure
|
| Parameters
| ----------
| data : list[BaseTraceType or dict]
| A list of trace specifications to be added.
| Trace specifications may be either:
|
| - Instances of trace classes from the plotly.graph_objs
| package (e.g plotly.graph_objs.Scatter, plotly.graph_objs.Bar)
| - Dicts where:
|
| - The 'type' property specifies the trace type (e.g.
| 'scatter', 'bar', 'area', etc.). If the dict has no 'type'
| property then 'scatter' is assumed.
| - All remaining properties are passed to the constructor
| of the specified trace type.
|
| rows : None or list[int] (default None)
| List of subplot row indexes (starting from 1) for the traces to be
| added. Only valid if figure was created using
| `plotly.tools.make_subplots`
| cols : None or list[int] (default None)
| List of subplot column indexes (starting from 1) for the traces
| to be added. Only valid if figure was created using
| `plotly.tools.make_subplots`
|
| Returns
| -------
| tuple[BaseTraceType]
| Tuple of the newly added traces
|
| Examples
| --------
| >>> from plotly import tools
| >>> import plotly.graph_objs as go
|
| Add two Scatter traces to a figure
| >>> fig = go.Figure()
| >>> fig.add_traces([go.Scatter(x=[1,2,3], y=[2,1,2]),
| ... go.Scatter(x=[1,2,3], y=[2,1,2])])
|
| Add two Scatter traces to vertically stacked subplots
| >>> fig = tools.make_subplots(rows=2)
| This is the format of your plot grid:
| [ (1,1) x1,y1 ]
| [ (2,1) x2,y2 ]
|
| >>> fig.add_traces([go.Scatter(x=[1,2,3], y=[2,1,2]),
| ... go.Scatter(x=[1,2,3], y=[2,1,2])],
| ... rows=[1, 2], cols=[1, 1])
|
| append_trace(self, trace, row, col)
| Add a trace to the figure bound to axes at the specified row,
| col index.
|
| A row, col index grid is generated for figures created with
| plotly.tools.make_subplots, and can be viewed with the `print_grid`
| method
|
| Parameters
| ----------
| trace
| The data trace to be bound
| row: int
| Subplot row index (see Figure.print_grid)
| col: int
| Subplot column index (see Figure.print_grid)
|
| Examples
| --------
| >>> from plotly import tools
| >>> import plotly.graph_objs as go
| # stack two subplots vertically
| >>> fig = tools.make_subplots(rows=2)
| This is the format of your plot grid:
| [ (1,1) x1,y1 ]
| [ (2,1) x2,y2 ]
|
| >>> fig.append_trace(go.Scatter(x=[1,2,3], y=[2,1,2]), row=1, col=1)
| >>> fig.append_trace(go.Scatter(x=[1,2,3], y=[2,1,2]), row=2, col=1)
|
| batch_animate(*args, **kwds)
| Context manager to animate trace / layout updates
|
| Parameters
| ----------
| duration : number
| The duration of the transition, in milliseconds.
| If equal to zero, updates are synchronous.
| easing : string
| The easing function used for the transition.
| One of:
| - 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
|
| Examples
| --------
| Suppose we have a figure widget, `fig`, with a single trace.
|
| >>> import plotly.graph_objs as go
| >>> fig = go.FigureWidget(data=[{'y': [3, 4, 2]}])
|
| 1) Animate a change in the xaxis and yaxis ranges using default
| duration and easing parameters.
|
| >>> with fig.batch_animate():
| ... fig.layout.xaxis.range = [0, 5]
| ... fig.layout.yaxis.range = [0, 10]
|
| 2) Animate a change in the size and color of the trace's markers
| over 2 seconds using the elastic-in-out easing method
| >>> with fig.batch_update(duration=2000, easing='elastic-in-out'):
| ... fig.data[0].marker.color = 'green'
| ... fig.data[0].marker.size = 20
|
| batch_update(*args, **kwds)
| A context manager that batches up trace and layout assignment
| operations into a singe plotly_update message that is executed when
| the context exits.
|
| Examples
| --------
| For example, suppose we have a figure widget, `fig`, with a single
| trace.
| >>> import plotly.graph_objs as go
| >>> fig = go.FigureWidget(data=[{'y': [3, 4, 2]}])
|
| If we want to update the xaxis range, the yaxis range, and the
| marker color, we could do so using a series of three property
| assignments as follows:
|
| >>> fig.layout.xaxis.range = [0, 5]
| >>> fig.layout.yaxis.range = [0, 10]
| >>> fig.data[0].marker.color = 'green'
|
| This will work, however it will result in three messages being
| sent to the front end (two relayout messages for the axis range
| updates followed by one restyle message for the marker color
| update). This can cause the plot to appear to stutter as the
| three updates are applied incrementally.
|
| We can avoid this problem by performing these three assignments in a
| `batch_update` context as follows:
|
| >>> with fig.batch_update():
| ... fig.layout.xaxis.range = [0, 5]
| ... fig.layout.yaxis.range = [0, 10]
| ... fig.data[0].marker.color = 'green'
|
| Now, these three property updates will be sent to the frontend in a
| single update message, and they will be applied by the front end
| simultaneously.
|
| plotly_relayout(self, relayout_data, **kwargs)
| Perform a Plotly relayout operation on the figure's layout
|
| Parameters
| ----------
| relayout_data : dict
| Dict of layout updates
|
| dict keys are strings that specify the properties to be updated.
| Nested properties are expressed by joining successive keys on
| '.' characters (e.g. 'xaxis.range')
|
| dict values are the values to use to update the layout.
|
| Returns
| -------
| None
|
| plotly_restyle(self, restyle_data, trace_indexes=None, **kwargs)
| Perform a Plotly restyle operation on the figure's traces
|
| Parameters
| ----------
| restyle_data : dict
| Dict of trace style updates.
|
| Keys are strings that specify the properties to be updated.
| Nested properties are expressed by joining successive keys on
| '.' characters (e.g. 'marker.color').
|
| Values may be scalars or lists. When values are scalars,
| that scalar value is applied to all traces specified by the
| `trace_indexes` parameter. When values are lists,
| the restyle operation will cycle through the elements
| of the list as it cycles through the traces specified by the
| `trace_indexes` parameter.
|
| Caution: To use plotly_restyle to update a list property (e.g.
| the `x` property of the scatter trace), the property value
| should be a scalar list containing the list to update with. For
| example, the following command would be used to update the 'x'
| property of the first trace to the list [1, 2, 3]
|
| >>> fig.plotly_restyle({'x': [[1, 2, 3]]}, 0)
|
| trace_indexes : int or list of int
| Trace index, or list of trace indexes, that the restyle operation
| applies to. Defaults to all trace indexes.
|
| Returns
| -------
| None
|
| plotly_update(self, restyle_data=None, relayout_data=None, trace_indexes=None, **kwargs)
| Perform a Plotly update operation on the figure.
|
| Note: This operation both mutates and returns the figure
|
| Parameters
| ----------
| restyle_data : dict
| Traces update specification. See the docstring for the
| `plotly_restyle` method for details
| relayout_data : dict
| Layout update specification. See the docstring for the
| `plotly_relayout` method for details
| trace_indexes :
| Trace index, or list of trace indexes, that the update operation
| applies to. Defaults to all trace indexes.
|
| Returns
| -------
| BaseFigure
| None
|
| print_grid(self)
| Print a visual layout of the figure's axes arrangement.
| This is only valid for figures that are created
| with plotly.tools.make_subplots.
|
| to_dict(self)
| Convert figure to a dictionary
|
| Note: the dictionary includes the properties explicitly set by the
| user, it does not include default values of unspecified properties
|
| Returns
| -------
| dict
|
| to_plotly_json(self)
| Convert figure to a JSON representation as a Python dict
|
| Returns
| -------
| dict
|
| update(self, dict1=None, **kwargs)
| Update the properties of the figure with a dict and/or with
| keyword arguments.
|
| This recursively updates the structure of the figure
| object with the values in the input dict / keyword arguments.
|
| Parameters
| ----------
| dict1 : dict
| Dictionary of properties to be updated
| kwargs :
| Keyword/value pair of properties to be updated
|
| Examples
| --------
| >>> import plotly.graph_objs as go
| >>> fig = go.Figure(data=[{'y': [1, 2, 3]}])
| >>> fig.update(data=[{'y': [4, 5, 6]}])
| >>> fig.to_plotly_json()
| {'data': [{'type': 'scatter',
| 'uid': 'e86a7c7a-346a-11e8-8aa8-a0999b0c017b',
| 'y': array([4, 5, 6], dtype=int32)}],
| 'layout': {}}
|
| >>> fig = go.Figure(layout={'xaxis':
| ... {'color': 'green',
| ... 'range': [0, 1]}})
| >>> fig.update({'layout': {'xaxis': {'color': 'pink'}}})
| >>> fig.to_plotly_json()
| {'data': [],
| 'layout': {'xaxis':
| {'color': 'pink',
| 'range': [0, 1]}}}
|
| Returns
| -------
| BaseFigure
| Updated figure
|
| ----------------------------------------------------------------------
| Data descriptors inherited from plotly.basedatatypes.BaseFigure:
|
| __dict__
| dictionary for instance variables (if defined)
|
| __weakref__
| list of weak references to the object (if defined)
|
| data
| The `data` property is a tuple of the figure's trace objects
|
| Returns
| -------
| tuple[BaseTraceType]
|
| layout
| The `layout` property of the figure
|
| Returns
| -------
| plotly.graph_objs.Layout
|
| ----------------------------------------------------------------------
| Methods inherited from ipywidgets.widgets.domwidget.DOMWidget:
|
| add_class(self, className)
| Adds a class to the top level element of the widget.
|
| Doesn't add the class if it already exists.
|
| remove_class(self, className)
| Removes a class from the top level element of the widget.
|
| Doesn't remove the class if it doesn't exist.
|
| ----------------------------------------------------------------------
| Methods inherited from ipywidgets.widgets.widget.Widget:
|
| __del__(self)
| Object disposal
|
| add_traits(self, **traits)
| Dynamically add trait attributes to the Widget.
|
| close(self)
| Close method.
|
| Closes the underlying comm.
| When the comm is closed, all of the widget views are automatically
| removed from the front-end.
|
| get_state(self, key=None, drop_defaults=False)
| Gets the widget state, or a piece of it.
|
| Parameters
| ----------
| key : unicode or iterable (optional)
| A single property's name or iterable of property names to get.
|
| Returns
| -------
| state : dict of states
| metadata : dict
| metadata for each field: {key: metadata}
|
| get_view_spec(self)
|
| hold_sync(*args, **kwds)
| Hold syncing any state until the outermost context manager exits
|
| notify_change(self, change)
| Called when a property has changed.
|
| on_displayed(self, callback, remove=False)
| (Un)Register a widget displayed callback.
|
| Parameters
| ----------
| callback: method handler
| Must have a signature of::
|
| callback(widget, **kwargs)
|
| kwargs from display are passed through without modification.
| remove: bool
| True if the callback should be unregistered.
|
| on_msg(self, callback, remove=False)
| (Un)Register a custom msg receive callback.
|
| Parameters
| ----------
| callback: callable
| callback will be passed three arguments when a message arrives::
|
| callback(widget, content, buffers)
|
| remove: bool
| True if the callback should be unregistered.
|
| open(self)
| Open a comm to the frontend if one isn't already open.
|
| send(self, content, buffers=None)
| Sends a custom msg to the widget model in the front-end.
|
| Parameters
| ----------
| content : dict
| Content of the message to send.
| buffers : list of binary buffers
| Binary buffers to send with message
|
| send_state(self, key=None)
| Sends the widget state, or a piece of it, to the front-end, if it exists.
|
| Parameters
| ----------
| key : unicode, or iterable (optional)
| A single property's name or iterable of property names to sync with the front-end.
|
| set_state(self, sync_data)
| Called when a state is received from the front-end.
|
| ----------------------------------------------------------------------
| Class methods inherited from ipywidgets.widgets.widget.Widget:
|
| close_all(cls) from traitlets.traitlets.MetaHasTraits
|
| ----------------------------------------------------------------------
| Static methods inherited from ipywidgets.widgets.widget.Widget:
|
| get_manager_state(drop_defaults=False, widgets=None)
| Returns the full state for a widget manager for embedding
|
| :param drop_defaults: when True, it will not include default value
| :param widgets: list with widgets to include in the state (or all widgets when None)
| :return:
|
| handle_comm_opened(comm, msg)
| Static method, called when a widget is constructed.
|
| on_widget_constructed(callback)
| Registers a callback to be called when a widget is constructed.
|
| The callback must have the following signature:
| callback(widget)
|
| ----------------------------------------------------------------------
| Data descriptors inherited from ipywidgets.widgets.widget.Widget:
|
| comm
| A trait whose value must be an instance of a specified class.
|
| The value can also be an instance of a subclass of the specified class.
|
| Subclasses can declare default classes by overriding the klass attribute
|
| keys
| An instance of a Python list.
|
| model_id
| Gets the model id of this widget.
|
| If a Comm doesn't exist yet, a Comm will be created automagically.
|
| ----------------------------------------------------------------------
| Data and other attributes inherited from ipywidgets.widgets.widget.Widget:
|
| widget_types = <ipywidgets.widgets.widget.WidgetRegistry object>
|
| widgets = {}
|
| ----------------------------------------------------------------------
| Data descriptors inherited from ipywidgets.widgets.widget.LoggingHasTraits:
|
| log
| A trait whose value must be an instance of a specified class.
|
| The value can also be an instance of a subclass of the specified class.
|
| Subclasses can declare default classes by overriding the klass attribute
|
| ----------------------------------------------------------------------
| Methods inherited from traitlets.traitlets.HasTraits:
|
| __getstate__(self)
|
| __setstate__(self, state)
|
| has_trait(self, name)
| Returns True if the object has a trait with the specified name.
|
| hold_trait_notifications(*args, **kwds)
| Context manager for bundling trait change notifications and cross
| validation.
|
| Use this when doing multiple trait assignments (init, config), to avoid
| race conditions in trait notifiers requesting other trait values.
| All trait notifications will fire after all values have been assigned.
|
| observe(self, handler, names=traitlets.All, type='change')
| Setup a handler to be called when a trait changes.
|
| This is used to setup dynamic notifications of trait changes.
|
| Parameters
| ----------
| handler : callable
| A callable that is called when a trait changes. Its
| signature should be ``handler(change)``, where ``change`` is a
| dictionary. The change dictionary at least holds a 'type' key.
| * ``type``: the type of notification.
| Other keys may be passed depending on the value of 'type'. In the
| case where type is 'change', we also have the following keys:
| * ``owner`` : the HasTraits instance
| * ``old`` : the old value of the modified trait attribute
| * ``new`` : the new value of the modified trait attribute
| * ``name`` : the name of the modified trait attribute.
| names : list, str, All
| If names is All, the handler will apply to all traits. If a list
| of str, handler will apply to all names in the list. If a
| str, the handler will apply just to that name.
| type : str, All (default: 'change')
| The type of notification to filter by. If equal to All, then all
| notifications are passed to the observe handler.
|
| on_trait_change(self, handler=None, name=None, remove=False)
| DEPRECATED: Setup a handler to be called when a trait changes.
|
| This is used to setup dynamic notifications of trait changes.
|
| Static handlers can be created by creating methods on a HasTraits
| subclass with the naming convention '_[traitname]_changed'. Thus,
| to create static handler for the trait 'a', create the method
| _a_changed(self, name, old, new) (fewer arguments can be used, see
| below).
|
| If `remove` is True and `handler` is not specified, all change
| handlers for the specified name are uninstalled.
|
| Parameters
| ----------
| handler : callable, None
| A callable that is called when a trait changes. Its
| signature can be handler(), handler(name), handler(name, new),
| handler(name, old, new), or handler(name, old, new, self).
| name : list, str, None
| If None, the handler will apply to all traits. If a list
| of str, handler will apply to all names in the list. If a
| str, the handler will apply just to that name.
| remove : bool
| If False (the default), then install the handler. If True
| then unintall it.
|
| set_trait(self, name, value)
| Forcibly sets trait attribute, including read-only attributes.
|
| setup_instance(self, *args, **kwargs)
|
| trait_metadata(self, traitname, key, default=None)
| Get metadata values for trait by key.
|
| trait_names(self, **metadata)
| Get a list of all the names of this class' traits.
|
| traits(self, **metadata)
| Get a ``dict`` of all the traits of this class. The dictionary
| is keyed on the name and the values are the TraitType objects.
|
| The TraitTypes returned don't know anything about the values
| that the various HasTrait's instances are holding.
|
| The metadata kwargs allow functions to be passed in which
| filter traits based on metadata values. The functions should
| take a single value as an argument and return a boolean. If
| any function returns False, then the trait is not included in
| the output. If a metadata key doesn't exist, None will be passed
| to the function.
|
| unobserve(self, handler, names=traitlets.All, type='change')
| Remove a trait change handler.
|
| This is used to unregister handlers to trait change notifications.
|
| Parameters
| ----------
| handler : callable
| The callable called when a trait attribute changes.
| names : list, str, All (default: All)
| The names of the traits for which the specified handler should be
| uninstalled. If names is All, the specified handler is uninstalled
| from the list of notifiers corresponding to all changes.
| type : str or All (default: 'change')
| The type of notification to filter by. If All, the specified handler
| is uninstalled from the list of notifiers corresponding to all types.
|
| unobserve_all(self, name=traitlets.All)
| Remove trait change handlers of any type for the specified name.
| If name is not specified, removes all trait notifiers.
|
| ----------------------------------------------------------------------
| Class methods inherited from traitlets.traitlets.HasTraits:
|
| class_own_trait_events(cls, name) from traitlets.traitlets.MetaHasTraits
| Get a dict of all event handlers defined on this class, not a parent.
|
| Works like ``event_handlers``, except for excluding traits from parents.
|
| class_own_traits(cls, **metadata) from traitlets.traitlets.MetaHasTraits
| Get a dict of all the traitlets defined on this class, not a parent.
|
| Works like `class_traits`, except for excluding traits from parents.
|
| class_trait_names(cls, **metadata) from traitlets.traitlets.MetaHasTraits
| Get a list of all the names of this class' traits.
|
| This method is just like the :meth:`trait_names` method,
| but is unbound.
|
| class_traits(cls, **metadata) from traitlets.traitlets.MetaHasTraits
| Get a ``dict`` of all the traits of this class. The dictionary
| is keyed on the name and the values are the TraitType objects.
|
| This method is just like the :meth:`traits` method, but is unbound.
|
| The TraitTypes returned don't know anything about the values
| that the various HasTrait's instances are holding.
|
| The metadata kwargs allow functions to be passed in which
| filter traits based on metadata values. The functions should
| take a single value as an argument and return a boolean. If
| any function returns False, then the trait is not included in
| the output. If a metadata key doesn't exist, None will be passed
| to the function.
|
| trait_events(cls, name=None) from traitlets.traitlets.MetaHasTraits
| Get a ``dict`` of all the event handlers of this class.
|
| Parameters
| ----------
| name: str (default: None)
| The name of a trait of this class. If name is ``None`` then all
| the event handlers of this class will be returned instead.
|
| Returns
| -------
| The event handlers associated with a trait name, or all event handlers.
|
| ----------------------------------------------------------------------
| Data descriptors inherited from traitlets.traitlets.HasTraits:
|
| cross_validation_lock
| A contextmanager for running a block with our cross validation lock set
| to True.
|
| At the end of the block, the lock's value is restored to its value
| prior to entering the block.
|
| ----------------------------------------------------------------------
| Static methods inherited from traitlets.traitlets.HasDescriptors:
|
| __new__(cls, *args, **kwargs)
