B &[¨_v­ã@s(ddlmZddlZGdd„deƒZdS)é)Ú BaseTraceTypeNcs¬eZdZdZdZddddddd d d d d ddddddddddddhZedd„ƒZejdd„ƒZedd„ƒZ e jdd„ƒZ ed d!„ƒZ e jd"d!„ƒZ ed#d$„ƒZ e jd%d$„ƒZ ed&d'„ƒZ e jd(d'„ƒZ ed)d*„ƒZ e jd+d*„ƒZ ed,d-„ƒZejd.d-„ƒZed/d0„ƒZejd1d0„ƒZed2d3„ƒZejd4d3„ƒZed5d6„ƒZejd7d6„ƒZed8d9„ƒZejd:d9„ƒZed;d<„ƒZejd=d<„ƒZed>d?„ƒZejd@d?„ƒZedAdB„ƒZejdCdB„ƒZedDdE„ƒZejdFdE„ƒZedGdH„ƒZejdIdH„ƒZedJdK„ƒZejdLdK„ƒZedMdN„ƒZejdOdN„ƒZedPdQ„ƒZejdRdQ„ƒZedSdT„ƒZejdUdT„ƒZedVdW„ƒZejdXdW„ƒZedYdZ„ƒZejd[dZ„ƒZed\d]„ƒZed^d_„ƒZdc‡fdadb„ Z ‡Z!S)dÚSankeyÚÚsankeyÚ arrangementÚ customdataÚ customdatasrcÚdomainÚ hoverinfoÚ hoverlabelÚidsÚidssrcÚlinkÚmetaÚmetasrcÚnameÚnodeÚ orientationÚselectedpointsÚstreamÚtextfontÚtypeÚuidÚ uirevisionÚ valueformatÚ valuesuffixÚvisiblecCs|dS)a  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. The 'arrangement' property is an enumeration that may be specified as: - One of the following enumeration values: ['snap', 'perpendicular', 'freeform', 'fixed'] Returns ------- Any r©)Úselfrrú=/tmp/pip-install-l29rncou/plotly/plotly/graph_objs/_sankey.pyr'szSankey.arrangementcCs ||d<dS)Nrr)rÚvalrrrr<scCs|dS)až 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 The 'customdata' property is an array that may be specified as a tuple, list, numpy array, or pandas Series Returns ------- numpy.ndarray rr)rrrrrBszSankey.customdatacCs ||d<dS)Nrr)rr rrrrSscCs|dS)zÿ Sets the source reference on Chart Studio Cloud for customdata . The 'customdatasrc' property must be specified as a string or as a plotly.grid_objs.Column object Returns ------- str rr)rrrrrYs zSankey.customdatasrccCs ||d<dS)Nrr)rr rrrrhscCs|dS)a The 'domain' property is an instance of Domain that may be specified as: - An instance of :class:`plotly.graph_objs.sankey.Domain` - A dict of string/value properties that will be passed to the Domain constructor Supported dict properties: column If there is a layout grid, use the domain for this column in the grid for this sankey trace . row If there is a layout grid, use the domain for this row in the grid for this sankey trace . x Sets the horizontal domain of this sankey trace (in plot fraction). y Sets the vertical domain of this sankey trace (in plot fraction). Returns ------- plotly.graph_objs.sankey.Domain r r)rrrrr nsz Sankey.domaincCs ||d<dS)Nr r)rr rrrr ŒscCs|dS)a‹ 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. Note that this attribute is superseded by `node.hoverinfo` and `node.hoverinfo` for nodes and links respectively. The 'hoverinfo' property is a flaglist and may be specified as a string containing: - Any combination of [] joined with '+' characters (e.g. '') OR exactly one of ['all', 'none', 'skip'] (e.g. 'skip') Returns ------- Any r r)rrrrr ’szSankey.hoverinfocCs ||d<dS)Nr r)rr rrrr §scCs|dS)a. The 'hoverlabel' property is an instance of Hoverlabel that may be specified as: - An instance of :class:`plotly.graph_objs.sankey.Hoverlabel` - A dict of string/value properties that will be passed to the Hoverlabel constructor Supported dict properties: align Sets the horizontal alignment of the text content within hover label box. Has an effect only if the hover label text spans more two or more lines alignsrc Sets the source reference on Chart Studio Cloud for align . bgcolor Sets the background color of the hover labels for this trace bgcolorsrc Sets the source reference on Chart Studio Cloud for bgcolor . bordercolor Sets the border color of the hover labels for this trace. bordercolorsrc Sets the source reference on Chart Studio Cloud for bordercolor . font Sets the font used in hover labels. namelength Sets the default length (in number of characters) of the trace name in the hover labels for all traces. -1 shows the whole name regardless of length. 0-3 shows the first 0-3 characters, and an integer >3 will show the whole name if it is less than that many characters, but if it is longer, will truncate to `namelength - 3` characters and add an ellipsis. namelengthsrc Sets the source reference on Chart Studio Cloud for namelength . Returns ------- plotly.graph_objs.sankey.Hoverlabel r r)rrrrr ­s3zSankey.hoverlabelcCs ||d<dS)Nr r)rr rrrr âscCs|dS)aq 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. The 'ids' property is an array that may be specified as a tuple, list, numpy array, or pandas Series Returns ------- numpy.ndarray r r)rrrrr èsz Sankey.idscCs ||d<dS)Nr r)rr rrrr øscCs|dS)zé Sets the source reference on Chart Studio Cloud for ids . The 'idssrc' property must be specified as a string or as a plotly.grid_objs.Column object Returns ------- str r r)rrrrr þs z Sankey.idssrccCs ||d<dS)Nr r)rr rrrr scCs|dS)a¨ The links of the Sankey plot. The 'link' property is an instance of Link that may be specified as: - An instance of :class:`plotly.graph_objs.sankey.Link` - A dict of string/value properties that will be passed to the Link constructor Supported dict properties: color Sets the `link` color. It can be a single value, or an array for specifying color for each `link`. If `link.color` is omitted, then by default, a translucent grey link will be used. colorscales A tuple of :class:`plotly.graph_objects.sankey. link.Colorscale` instances or dicts with compatible properties colorscaledefaults When used in a template (as layout.template.dat a.sankey.link.colorscaledefaults), sets the default property values to use for elements of sankey.link.colorscales colorsrc Sets the source reference on Chart Studio Cloud for color . customdata Assigns extra data to each link. customdatasrc Sets the source reference on Chart Studio Cloud for customdata . hoverinfo Determines which trace information appear when hovering links. If `none` or `skip` are set, no information is displayed upon hovering. But, if `none` is set, click and hover events are still fired. hoverlabel :class:`plotly.graph_objects.sankey.link.Hoverl abel` instance or dict with compatible properties hovertemplate Template string used for rendering the information that appear on hover box. Note that this will override `hoverinfo`. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-3.x-api- reference/blob/master/Formatting.md#d3_format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time- format#locale_format for details on the date formatting syntax. The variables available in `hovertemplate` are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs- events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `value` and `label`. Anything contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for hovertemplate . label The shown name of the link. labelsrc Sets the source reference on Chart Studio Cloud for label . line :class:`plotly.graph_objects.sankey.link.Line` instance or dict with compatible properties source An integer number `[0..nodes.length - 1]` that represents the source node. sourcesrc Sets the source reference on Chart Studio Cloud for source . target An integer number `[0..nodes.length - 1]` that represents the target node. targetsrc Sets the source reference on Chart Studio Cloud for target . value A numeric value representing the flow volume value. valuesrc Sets the source reference on Chart Studio Cloud for value . Returns ------- plotly.graph_objs.sankey.Link rr)rrrrrsmz Sankey.linkcCs ||d<dS)Nrr)rr rrrrscCs|dS)a  Assigns extra meta information associated with this trace that can be used in various text attributes. Attributes such as trace `name`, graph, axis and colorbar `title.text`, annotation `text` `rangeselector`, `updatemenues` and `sliders` `label` text all support `meta`. To access the trace `meta` values in an attribute in the same trace, simply use `%{meta[i]}` where `i` is the index or key of the `meta` item in question. To access trace `meta` in layout attributes, use `%{data[n[.meta[i]}` where `i` is the index or key of the `meta` and `n` is the trace index. The 'meta' property accepts values of any type Returns ------- Any|numpy.ndarray rr)rrrrr‡sz Sankey.metacCs ||d<dS)Nrr)rr rrrrscCs|dS)zë Sets the source reference on Chart Studio Cloud for meta . The 'metasrc' property must be specified as a string or as a plotly.grid_objs.Column object Returns ------- str rr)rrrrr£s zSankey.metasrccCs ||d<dS)Nrr)rr rrrr±scCs|dS)a& Sets the trace name. The trace name appear as the legend item and on hover. The 'name' property is a string and must be specified as: - A string - A number that will be converted to a string Returns ------- str rr)rrrrr·sz Sankey.namecCs ||d<dS)Nrr)rr rrrrÇscCs|dS)a‡ The nodes of the Sankey plot. The 'node' property is an instance of Node that may be specified as: - An instance of :class:`plotly.graph_objs.sankey.Node` - A dict of string/value properties that will be passed to the Node constructor Supported dict properties: color Sets the `node` color. It can be a single value, or an array for specifying color for each `node`. If `node.color` is omitted, then the default `Plotly` color palette will be cycled through to have a variety of colors. These defaults are not fully opaque, to allow some visibility of what is beneath the node. colorsrc Sets the source reference on Chart Studio Cloud for color . customdata Assigns extra data to each node. customdatasrc Sets the source reference on Chart Studio Cloud for customdata . groups Groups of nodes. Each group is defined by an array with the indices of the nodes it contains. Multiple groups can be specified. hoverinfo Determines which trace information appear when hovering nodes. If `none` or `skip` are set, no information is displayed upon hovering. But, if `none` is set, click and hover events are still fired. hoverlabel :class:`plotly.graph_objects.sankey.node.Hoverl abel` instance or dict with compatible properties hovertemplate Template string used for rendering the information that appear on hover box. Note that this will override `hoverinfo`. Variables are inserted using %{variable}, for example "y: %{y}". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example "Price: %{y:$.2f}". https://github.com/d3/d3-3.x-api- reference/blob/master/Formatting.md#d3_format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example "Day: %{2019-01-01|%A}". https://github.com/d3/d3-time- format#locale_format for details on the date formatting syntax. The variables available in `hovertemplate` are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs- events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `value` and `label`. Anything contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for hovertemplate . label The shown name of the node. labelsrc Sets the source reference on Chart Studio Cloud for label . line :class:`plotly.graph_objects.sankey.node.Line` instance or dict with compatible properties pad Sets the padding (in px) between the `nodes`. thickness Sets the thickness (in px) of the `nodes`. x The normalized horizontal position of the node. xsrc Sets the source reference on Chart Studio Cloud for x . y The normalized vertical position of the node. ysrc Sets the source reference on Chart Studio Cloud for y . Returns ------- plotly.graph_objs.sankey.Node rr)rrrrrÍsfz Sankey.nodecCs ||d<dS)Nrr)rr rrrr5scCs|dS)a Sets the orientation of the Sankey diagram. The 'orientation' property is an enumeration that may be specified as: - One of the following enumeration values: ['v', 'h'] Returns ------- Any rr)rrrrr;s zSankey.orientationcCs ||d<dS)Nrr)rr rrrrJscCs|dS)a÷ 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. The 'selectedpoints' property accepts values of any type Returns ------- Any rr)rrrrrPszSankey.selectedpointscCs ||d<dS)Nrr)rr rrrrbscCs|dS)aw The 'stream' property is an instance of Stream that may be specified as: - An instance of :class:`plotly.graph_objs.sankey.Stream` - A dict of string/value properties that will be passed to the Stream constructor Supported dict properties: maxpoints Sets the maximum number of points to keep on the plots from an incoming stream. If `maxpoints` is set to 50, only the newest 50 points will be displayed on the plot. token The stream id number links a data trace on a plot with a stream. See https://chart- studio.plotly.com/settings for more details. Returns ------- plotly.graph_objs.sankey.Stream rr)rrrrrhsz Sankey.streamcCs ||d<dS)Nrr)rr rrrrƒscCs|dS)a Sets the font for node labels The 'textfont' property is an instance of Textfont that may be specified as: - An instance of :class:`plotly.graph_objs.sankey.Textfont` - A dict of string/value properties that will be passed to the Textfont constructor Supported dict properties: color family HTML font family - the typeface that will be applied by the web browser. The web browser will only be able to apply a font if it is available on the system which it operates. Provide multiple font families, separated by commas, to indicate the preference in which to apply fonts if they aren't available on the system. The Chart Studio Cloud (at https://chart-studio.plotly.com or on-premise) generates images on a server, where only a select number of fonts are installed and supported. These include "Arial", "Balto", "Courier New", "Droid Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas One", "Old Standard TT", "Open Sans", "Overpass", "PT Sans Narrow", "Raleway", "Times New Roman". size Returns ------- plotly.graph_objs.sankey.Textfont rr)rrrrr‰s&zSankey.textfontcCs ||d<dS)Nrr)rr rrrr±scCs|dS)aL Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions. The 'uid' property is a string and must be specified as: - A string - A number that will be converted to a string Returns ------- str rr)rrrrr·sz Sankey.uidcCs ||d<dS)Nrr)rr rrrrÇscCs|dS)aR Controls persistence of some user-driven changes to the trace: `constraintrange` in `parcoords` traces, as well as some `editable: true` modifications such as `name` and `colorbar.title`. Defaults to `layout.uirevision`. Note that other user-driven trace attribute changes are controlled by `layout` attributes: `trace.visible` is controlled by `layout.legend.uirevision`, `selectedpoints` is controlled by `layout.selectionrevision`, and `colorbar.(x|y)` (accessible with `config: {editable: true}`) is controlled by `layout.editrevision`. Trace changes are tracked by `uid`, which only falls back on trace index if no `uid` is provided. So if your app can add/remove traces before the end of the `data` array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a `uid` that stays with it as it moves. The 'uirevision' property accepts values of any type Returns ------- Any rr)rrrrrÍszSankey.uirevisioncCs ||d<dS)Nrr)rr rrrrèscCs|dS)a¬ Sets the value formatting rule using d3 formatting mini- language which is similar to those of Python. See https://github.com/d3/d3-3.x-api- reference/blob/master/Formatting.md#d3_format The 'valueformat' property is a string and must be specified as: - A string - A number that will be converted to a string Returns ------- str rr)rrrrrîszSankey.valueformatcCs ||d<dS)Nrr)rr rrrrscCs|dS)aP Adds a unit to follow the value in the hover tooltip. Add a space if a separation is necessary from the value. The 'valuesuffix' property is a string and must be specified as: - A string - A number that will be converted to a string Returns ------- str rr)rrrrrszSankey.valuesuffixcCs ||d<dS)Nrr)rr rrrrscCs|dS)a§ 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). The 'visible' property is an enumeration that may be specified as: - One of the following enumeration values: [True, False, 'legendonly'] Returns ------- Any rr)rrrrrszSankey.visiblecCs ||d<dS)Nrr)rr rrrr-scCs |jdS)Nr)Ú_props)rrrrr3sz Sankey.typecCsdS)Na? 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 Chart Studio Cloud for customdata . domain :class:`plotly.graph_objects.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. Note that this attribute is superseded by `node.hoverinfo` and `node.hoverinfo` for nodes and links respectively. hoverlabel :class:`plotly.graph_objects.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 Chart Studio Cloud for ids . link The links of the Sankey plot. meta Assigns extra meta information associated with this trace that can be used in various text attributes. Attributes such as trace `name`, graph, axis and colorbar `title.text`, annotation `text` `rangeselector`, `updatemenues` and `sliders` `label` text all support `meta`. To access the trace `meta` values in an attribute in the same trace, simply use `%{meta[i]}` where `i` is the index or key of the `meta` item in question. To access trace `meta` in layout attributes, use `%{data[n[.meta[i]}` where `i` is the index or key of the `meta` and `n` is the trace index. metasrc Sets the source reference on Chart Studio Cloud for meta . name Sets the trace name. The trace name appear as the legend item and on hover. node The nodes of the Sankey plot. 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. stream :class:`plotly.graph_objects.sankey.Stream` instance or dict with compatible properties textfont Sets the font for node labels uid Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions. uirevision Controls persistence of some user-driven changes to the trace: `constraintrange` in `parcoords` traces, as well as some `editable: true` modifications such as `name` and `colorbar.title`. Defaults to `layout.uirevision`. Note that other user-driven trace attribute changes are controlled by `layout` attributes: `trace.visible` is controlled by `layout.legend.uirevision`, `selectedpoints` is controlled by `layout.selectionrevision`, and `colorbar.(x|y)` (accessible with `config: {editable: true}`) is controlled by `layout.editrevision`. Trace changes are tracked by `uid`, which only falls back on trace index if no `uid` is provided. So if your app can add/remove traces before the end of the `data` array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a `uid` that stays with it as it moves. valueformat Sets the value formatting rule using d3 formatting mini-language which is similar to those of Python. See https://github.com/d3/d3-3.x-api- reference/blob/master/Formatting.md#d3_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). r)rrrrÚ_prop_descriptions9spzSankey._prop_descriptionsNc sÎtt|ƒ d¡d|kr&|d|_dS|dkr4i}n4t||jƒrJ| ¡}nt|tƒr`t  |¡}nt dƒ‚|  dd¡|_ |  dd¡|_ |  d d¡}|dk rœ|n|}|dk r°||d <|  d d¡}|dk rÈ|n|}|dk rÜ||d <|  d d¡}|dk rô|n|}|dk r ||d <|  d d¡}|dk r$|n|}|dk r:||d <|  d d¡}|dk rT|n|}|dk rj||d <|  dd¡}|dk r„|n|}|dk rš||d<|  dd¡}|dk r´|n|}|dk rÊ||d<|  dd¡}| dk rä| n|}|dk rú||d<|  dd¡}| dk r| n|}|dk r*||d<|  dd¡}| dk rD| n|}|dk rZ||d<|  dd¡}| dk rt| n|}|dk rŠ||d<|  dd¡}| dk r¤| n|}|dk rº||d<|  dd¡}|dk rÔ|n|}|dk rê||d<|  dd¡}|dk r|n|}|dk r||d<|  dd¡}|dk r4|n|}|dk rJ||d<|  dd¡}|dk rd|n|}|dk rz||d<|  dd¡}|dk r”|n|}|dk rª||d<|  dd¡}|dk rÄ|n|}|dk rÚ||d<|  dd¡}|dk rô|n|}|dk r ||d<|  dd¡}|dk r$|n|}|dk r:||d<|  dd¡}|dk rT|n|}|dk rj||d<|  dd¡}|dk r„|n|}|dk rš||d<d|jd<|  dd¡|jft|f|ŽŽd|_ dS) aR Construct a new Sankey object 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 ---------- arg dict of properties compatible with this constructor or an instance of :class:`plotly.graph_objs.Sankey` 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 Chart Studio Cloud for customdata . domain :class:`plotly.graph_objects.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. Note that this attribute is superseded by `node.hoverinfo` and `node.hoverinfo` for nodes and links respectively. hoverlabel :class:`plotly.graph_objects.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 Chart Studio Cloud for ids . link The links of the Sankey plot. meta Assigns extra meta information associated with this trace that can be used in various text attributes. Attributes such as trace `name`, graph, axis and colorbar `title.text`, annotation `text` `rangeselector`, `updatemenues` and `sliders` `label` text all support `meta`. To access the trace `meta` values in an attribute in the same trace, simply use `%{meta[i]}` where `i` is the index or key of the `meta` item in question. To access trace `meta` in layout attributes, use `%{data[n[.meta[i]}` where `i` is the index or key of the `meta` and `n` is the trace index. metasrc Sets the source reference on Chart Studio Cloud for meta . name Sets the trace name. The trace name appear as the legend item and on hover. node The nodes of the Sankey plot. 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. stream :class:`plotly.graph_objects.sankey.Stream` instance or dict with compatible properties textfont Sets the font for node labels uid Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions. uirevision Controls persistence of some user-driven changes to the trace: `constraintrange` in `parcoords` traces, as well as some `editable: true` modifications such as `name` and `colorbar.title`. Defaults to `layout.uirevision`. Note that other user-driven trace attribute changes are controlled by `layout` attributes: `trace.visible` is controlled by `layout.legend.uirevision`, `selectedpoints` is controlled by `layout.selectionrevision`, and `colorbar.(x|y)` (accessible with `config: {editable: true}`) is controlled by `layout.editrevision`. Trace changes are tracked by `uid`, which only falls back on trace index if no `uid` is provided. So if your app can add/remove traces before the end of the `data` array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a `uid` that stays with it as it moves. valueformat Sets the value formatting rule using d3 formatting mini-language which is similar to those of Python. See https://github.com/d3/d3-3.x-api- reference/blob/master/Formatting.md#d3_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). Returns ------- Sankey rÚ_parentNzƒThe first argument to the plotly.graph_objs.Sankey constructor must be a dict or an instance of :class:`plotly.graph_objs.Sankey`Z skip_invalidFÚ _validateTrrrr r r r r rrrrrrrrrrrrrrr)ÚsuperrÚ__init__r#Ú isinstanceÚ __class__Zto_plotly_jsonÚdictÚ_copyÚcopyÚ ValueErrorÚpopZ _skip_invalidr$r!Z_process_kwargs)rÚargrrrr r r r r rrrrrrrrrrrrrrÚkwargsZ_v)r(rrr&«sÖ                                                 zSankey.__init__)NNNNNNNNNNNNNNNNNNNNNNN)"Ú__name__Ú __module__Ú __qualname__Z_parent_path_strZ _path_strZ _valid_propsÚpropertyrÚsetterrrr r r r r rrrrrrrrrrrrrrrr"r&Ú __classcell__rr)r(rrs¼      5   o    h    (       tr)Zplotly.basedatatypesrZ_BaseTraceTyper+r*rrrrrÚs