1778 lines
62 KiB
Python
1778 lines
62 KiB
Python
|
# --- THIS FILE IS AUTO-GENERATED ---
|
||
|
# Modifications will be overwitten the next time code generation run.
|
||
|
|
||
|
from plotly.basedatatypes import BaseTraceType as _BaseTraceType
|
||
|
import copy as _copy
|
||
|
import warnings
|
||
|
|
||
|
|
||
|
class Choroplethmapbox(_BaseTraceType):
|
||
|
_parent_path_str = ""
|
||
|
_path_str = "choroplethmapbox"
|
||
|
_valid_props = {
|
||
|
"autocolorscale",
|
||
|
"below",
|
||
|
"coloraxis",
|
||
|
"colorbar",
|
||
|
"colorscale",
|
||
|
"customdata",
|
||
|
"customdatasrc",
|
||
|
"featureidkey",
|
||
|
"geojson",
|
||
|
"hoverinfo",
|
||
|
"hoverinfosrc",
|
||
|
"hoverlabel",
|
||
|
"hovertemplate",
|
||
|
"hovertemplatesrc",
|
||
|
"hovertext",
|
||
|
"hovertextsrc",
|
||
|
"ids",
|
||
|
"idssrc",
|
||
|
"legend",
|
||
|
"legendgroup",
|
||
|
"legendgrouptitle",
|
||
|
"legendrank",
|
||
|
"legendwidth",
|
||
|
"locations",
|
||
|
"locationssrc",
|
||
|
"marker",
|
||
|
"meta",
|
||
|
"metasrc",
|
||
|
"name",
|
||
|
"reversescale",
|
||
|
"selected",
|
||
|
"selectedpoints",
|
||
|
"showlegend",
|
||
|
"showscale",
|
||
|
"stream",
|
||
|
"subplot",
|
||
|
"text",
|
||
|
"textsrc",
|
||
|
"type",
|
||
|
"uid",
|
||
|
"uirevision",
|
||
|
"unselected",
|
||
|
"visible",
|
||
|
"z",
|
||
|
"zauto",
|
||
|
"zmax",
|
||
|
"zmid",
|
||
|
"zmin",
|
||
|
"zsrc",
|
||
|
}
|
||
|
|
||
|
@property
|
||
|
def autocolorscale(self):
|
||
|
"""
|
||
|
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.
|
||
|
|
||
|
The 'autocolorscale' property must be specified as a bool
|
||
|
(either True, or False)
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
bool
|
||
|
"""
|
||
|
return self["autocolorscale"]
|
||
|
|
||
|
@autocolorscale.setter
|
||
|
def autocolorscale(self, val):
|
||
|
self["autocolorscale"] = val
|
||
|
|
||
|
@property
|
||
|
def below(self):
|
||
|
"""
|
||
|
Determines if the choropleth polygons will be inserted before
|
||
|
the layer with the specified ID. By default, choroplethmapbox
|
||
|
traces are placed above the water layers. If set to '', the
|
||
|
layer will be inserted above every existing layer.
|
||
|
|
||
|
The 'below' property is a string and must be specified as:
|
||
|
- A string
|
||
|
- A number that will be converted to a string
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["below"]
|
||
|
|
||
|
@below.setter
|
||
|
def below(self, val):
|
||
|
self["below"] = val
|
||
|
|
||
|
@property
|
||
|
def coloraxis(self):
|
||
|
"""
|
||
|
Sets a reference to a shared color axis. References to these
|
||
|
shared color axes are "coloraxis", "coloraxis2", "coloraxis3",
|
||
|
etc. Settings for these shared color axes are set in the
|
||
|
layout, under `layout.coloraxis`, `layout.coloraxis2`, etc.
|
||
|
Note that multiple color scales can be linked to the same color
|
||
|
axis.
|
||
|
|
||
|
The 'coloraxis' property is an identifier of a particular
|
||
|
subplot, of type 'coloraxis', that may be specified as the string 'coloraxis'
|
||
|
optionally followed by an integer >= 1
|
||
|
(e.g. 'coloraxis', 'coloraxis1', 'coloraxis2', 'coloraxis3', etc.)
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["coloraxis"]
|
||
|
|
||
|
@coloraxis.setter
|
||
|
def coloraxis(self, val):
|
||
|
self["coloraxis"] = val
|
||
|
|
||
|
@property
|
||
|
def colorbar(self):
|
||
|
"""
|
||
|
The 'colorbar' property is an instance of ColorBar
|
||
|
that may be specified as:
|
||
|
- An instance of :class:`plotly.graph_objs.choroplethmapbox.ColorBar`
|
||
|
- A dict of string/value properties that will be passed
|
||
|
to the ColorBar constructor
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
plotly.graph_objs.choroplethmapbox.ColorBar
|
||
|
"""
|
||
|
return self["colorbar"]
|
||
|
|
||
|
@colorbar.setter
|
||
|
def colorbar(self, val):
|
||
|
self["colorbar"] = val
|
||
|
|
||
|
@property
|
||
|
def colorscale(self):
|
||
|
"""
|
||
|
Sets the colorscale. The colorscale must be an array containing
|
||
|
arrays mapping a normalized value to an rgb, rgba, hex, hsl,
|
||
|
hsv, or named color string. At minimum, a mapping for the
|
||
|
lowest (0) and highest (1) values are required. For example,
|
||
|
`[[0, 'rgb(0,0,255)'], [1, 'rgb(255,0,0)']]`. To control the
|
||
|
bounds of the colorscale in color space, use `zmin` and `zmax`.
|
||
|
Alternatively, `colorscale` may be a palette name string of the
|
||
|
following list: Blackbody,Bluered,Blues,Cividis,Earth,Electric,
|
||
|
Greens,Greys,Hot,Jet,Picnic,Portland,Rainbow,RdBu,Reds,Viridis,
|
||
|
YlGnBu,YlOrRd.
|
||
|
|
||
|
The 'colorscale' property is a colorscale and may be
|
||
|
specified as:
|
||
|
- A list of colors that will be spaced evenly to create the colorscale.
|
||
|
Many predefined colorscale lists are included in the sequential, diverging,
|
||
|
and cyclical modules in the plotly.colors package.
|
||
|
- A list of 2-element lists where the first element is the
|
||
|
normalized color level value (starting at 0 and ending at 1),
|
||
|
and the second item is a valid color string.
|
||
|
(e.g. [[0, 'green'], [0.5, 'red'], [1.0, 'rgb(0, 0, 255)']])
|
||
|
- One of the following named colorscales:
|
||
|
['aggrnyl', 'agsunset', 'algae', 'amp', 'armyrose', 'balance',
|
||
|
'blackbody', 'bluered', 'blues', 'blugrn', 'bluyl', 'brbg',
|
||
|
'brwnyl', 'bugn', 'bupu', 'burg', 'burgyl', 'cividis', 'curl',
|
||
|
'darkmint', 'deep', 'delta', 'dense', 'earth', 'edge', 'electric',
|
||
|
'emrld', 'fall', 'geyser', 'gnbu', 'gray', 'greens', 'greys',
|
||
|
'haline', 'hot', 'hsv', 'ice', 'icefire', 'inferno', 'jet',
|
||
|
'magenta', 'magma', 'matter', 'mint', 'mrybm', 'mygbm', 'oranges',
|
||
|
'orrd', 'oryel', 'oxy', 'peach', 'phase', 'picnic', 'pinkyl',
|
||
|
'piyg', 'plasma', 'plotly3', 'portland', 'prgn', 'pubu', 'pubugn',
|
||
|
'puor', 'purd', 'purp', 'purples', 'purpor', 'rainbow', 'rdbu',
|
||
|
'rdgy', 'rdpu', 'rdylbu', 'rdylgn', 'redor', 'reds', 'solar',
|
||
|
'spectral', 'speed', 'sunset', 'sunsetdark', 'teal', 'tealgrn',
|
||
|
'tealrose', 'tempo', 'temps', 'thermal', 'tropic', 'turbid',
|
||
|
'turbo', 'twilight', 'viridis', 'ylgn', 'ylgnbu', 'ylorbr',
|
||
|
'ylorrd'].
|
||
|
Appending '_r' to a named colorscale reverses it.
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["colorscale"]
|
||
|
|
||
|
@colorscale.setter
|
||
|
def colorscale(self, val):
|
||
|
self["colorscale"] = val
|
||
|
|
||
|
@property
|
||
|
def customdata(self):
|
||
|
"""
|
||
|
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
|
||
|
"""
|
||
|
return self["customdata"]
|
||
|
|
||
|
@customdata.setter
|
||
|
def customdata(self, val):
|
||
|
self["customdata"] = val
|
||
|
|
||
|
@property
|
||
|
def customdatasrc(self):
|
||
|
"""
|
||
|
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
|
||
|
"""
|
||
|
return self["customdatasrc"]
|
||
|
|
||
|
@customdatasrc.setter
|
||
|
def customdatasrc(self, val):
|
||
|
self["customdatasrc"] = val
|
||
|
|
||
|
@property
|
||
|
def featureidkey(self):
|
||
|
"""
|
||
|
Sets the key in GeoJSON features which is used as id to match
|
||
|
the items included in the `locations` array. Support nested
|
||
|
property, for example "properties.name".
|
||
|
|
||
|
The 'featureidkey' property is a string and must be specified as:
|
||
|
- A string
|
||
|
- A number that will be converted to a string
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["featureidkey"]
|
||
|
|
||
|
@featureidkey.setter
|
||
|
def featureidkey(self, val):
|
||
|
self["featureidkey"] = val
|
||
|
|
||
|
@property
|
||
|
def geojson(self):
|
||
|
"""
|
||
|
Sets the GeoJSON data associated with this trace. It can be set
|
||
|
as a valid GeoJSON object or as a URL string. Note that we only
|
||
|
accept GeoJSONs of type "FeatureCollection" or "Feature" with
|
||
|
geometries of type "Polygon" or "MultiPolygon".
|
||
|
|
||
|
The 'geojson' property accepts values of any type
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
Any
|
||
|
"""
|
||
|
return self["geojson"]
|
||
|
|
||
|
@geojson.setter
|
||
|
def geojson(self, val):
|
||
|
self["geojson"] = val
|
||
|
|
||
|
@property
|
||
|
def hoverinfo(self):
|
||
|
"""
|
||
|
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.
|
||
|
|
||
|
The 'hoverinfo' property is a flaglist and may be specified
|
||
|
as a string containing:
|
||
|
- Any combination of ['location', 'z', 'text', 'name'] joined with '+' characters
|
||
|
(e.g. 'location+z')
|
||
|
OR exactly one of ['all', 'none', 'skip'] (e.g. 'skip')
|
||
|
- A list or array of the above
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
Any|numpy.ndarray
|
||
|
"""
|
||
|
return self["hoverinfo"]
|
||
|
|
||
|
@hoverinfo.setter
|
||
|
def hoverinfo(self, val):
|
||
|
self["hoverinfo"] = val
|
||
|
|
||
|
@property
|
||
|
def hoverinfosrc(self):
|
||
|
"""
|
||
|
Sets the source reference on Chart Studio Cloud for
|
||
|
`hoverinfo`.
|
||
|
|
||
|
The 'hoverinfosrc' property must be specified as a string or
|
||
|
as a plotly.grid_objs.Column object
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["hoverinfosrc"]
|
||
|
|
||
|
@hoverinfosrc.setter
|
||
|
def hoverinfosrc(self, val):
|
||
|
self["hoverinfosrc"] = val
|
||
|
|
||
|
@property
|
||
|
def hoverlabel(self):
|
||
|
"""
|
||
|
The 'hoverlabel' property is an instance of Hoverlabel
|
||
|
that may be specified as:
|
||
|
- An instance of :class:`plotly.graph_objs.choroplethmapbox.Hoverlabel`
|
||
|
- A dict of string/value properties that will be passed
|
||
|
to the Hoverlabel constructor
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
plotly.graph_objs.choroplethmapbox.Hoverlabel
|
||
|
"""
|
||
|
return self["hoverlabel"]
|
||
|
|
||
|
@hoverlabel.setter
|
||
|
def hoverlabel(self, val):
|
||
|
self["hoverlabel"] = val
|
||
|
|
||
|
@property
|
||
|
def hovertemplate(self):
|
||
|
"""
|
||
|
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}"
|
||
|
as well as %{xother}, {%_xother}, {%_xother_}, {%xother_}. When
|
||
|
showing info for several points, "xother" will be added to
|
||
|
those with different x positions from the first point. An
|
||
|
underscore before or after "(x|y)other" will add a space on
|
||
|
that side, only when this field is shown. Numbers are formatted
|
||
|
using d3-format's syntax %{variable:d3-format}, for example
|
||
|
"Price: %{y:$.2f}".
|
||
|
https://github.com/d3/d3-format/tree/v1.4.5#d3-format for
|
||
|
details on the formatting syntax. Dates are formatted using
|
||
|
d3-time-format's syntax %{variable|d3-time-format}, for example
|
||
|
"Day: %{2019-01-01|%A}". https://github.com/d3/d3-time-
|
||
|
format/tree/v2.2.3#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. Finally, the
|
||
|
template string has access to variable `properties` Anything
|
||
|
contained in tag `<extra>` is displayed in the secondary box,
|
||
|
for example `<extra>%{fullData.name}</extra>`. To hide the
|
||
|
secondary box completely, use an empty tag `<extra></extra>`.
|
||
|
|
||
|
The 'hovertemplate' property is a string and must be specified as:
|
||
|
- A string
|
||
|
- A number that will be converted to a string
|
||
|
- A tuple, list, or one-dimensional numpy array of the above
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str|numpy.ndarray
|
||
|
"""
|
||
|
return self["hovertemplate"]
|
||
|
|
||
|
@hovertemplate.setter
|
||
|
def hovertemplate(self, val):
|
||
|
self["hovertemplate"] = val
|
||
|
|
||
|
@property
|
||
|
def hovertemplatesrc(self):
|
||
|
"""
|
||
|
Sets the source reference on Chart Studio Cloud for
|
||
|
`hovertemplate`.
|
||
|
|
||
|
The 'hovertemplatesrc' property must be specified as a string or
|
||
|
as a plotly.grid_objs.Column object
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["hovertemplatesrc"]
|
||
|
|
||
|
@hovertemplatesrc.setter
|
||
|
def hovertemplatesrc(self, val):
|
||
|
self["hovertemplatesrc"] = val
|
||
|
|
||
|
@property
|
||
|
def hovertext(self):
|
||
|
"""
|
||
|
Same as `text`.
|
||
|
|
||
|
The 'hovertext' property is a string and must be specified as:
|
||
|
- A string
|
||
|
- A number that will be converted to a string
|
||
|
- A tuple, list, or one-dimensional numpy array of the above
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str|numpy.ndarray
|
||
|
"""
|
||
|
return self["hovertext"]
|
||
|
|
||
|
@hovertext.setter
|
||
|
def hovertext(self, val):
|
||
|
self["hovertext"] = val
|
||
|
|
||
|
@property
|
||
|
def hovertextsrc(self):
|
||
|
"""
|
||
|
Sets the source reference on Chart Studio Cloud for
|
||
|
`hovertext`.
|
||
|
|
||
|
The 'hovertextsrc' property must be specified as a string or
|
||
|
as a plotly.grid_objs.Column object
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["hovertextsrc"]
|
||
|
|
||
|
@hovertextsrc.setter
|
||
|
def hovertextsrc(self, val):
|
||
|
self["hovertextsrc"] = val
|
||
|
|
||
|
@property
|
||
|
def ids(self):
|
||
|
"""
|
||
|
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
|
||
|
"""
|
||
|
return self["ids"]
|
||
|
|
||
|
@ids.setter
|
||
|
def ids(self, val):
|
||
|
self["ids"] = val
|
||
|
|
||
|
@property
|
||
|
def idssrc(self):
|
||
|
"""
|
||
|
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
|
||
|
"""
|
||
|
return self["idssrc"]
|
||
|
|
||
|
@idssrc.setter
|
||
|
def idssrc(self, val):
|
||
|
self["idssrc"] = val
|
||
|
|
||
|
@property
|
||
|
def legend(self):
|
||
|
"""
|
||
|
Sets the reference to a legend to show this trace in.
|
||
|
References to these legends are "legend", "legend2", "legend3",
|
||
|
etc. Settings for these legends are set in the layout, under
|
||
|
`layout.legend`, `layout.legend2`, etc.
|
||
|
|
||
|
The 'legend' property is an identifier of a particular
|
||
|
subplot, of type 'legend', that may be specified as the string 'legend'
|
||
|
optionally followed by an integer >= 1
|
||
|
(e.g. 'legend', 'legend1', 'legend2', 'legend3', etc.)
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["legend"]
|
||
|
|
||
|
@legend.setter
|
||
|
def legend(self, val):
|
||
|
self["legend"] = val
|
||
|
|
||
|
@property
|
||
|
def legendgroup(self):
|
||
|
"""
|
||
|
Sets the legend group for this trace. Traces and shapes part of
|
||
|
the same legend group hide/show at the same time when toggling
|
||
|
legend items.
|
||
|
|
||
|
The 'legendgroup' property is a string and must be specified as:
|
||
|
- A string
|
||
|
- A number that will be converted to a string
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["legendgroup"]
|
||
|
|
||
|
@legendgroup.setter
|
||
|
def legendgroup(self, val):
|
||
|
self["legendgroup"] = val
|
||
|
|
||
|
@property
|
||
|
def legendgrouptitle(self):
|
||
|
"""
|
||
|
The 'legendgrouptitle' property is an instance of Legendgrouptitle
|
||
|
that may be specified as:
|
||
|
- An instance of :class:`plotly.graph_objs.choroplethmapbox.Legendgrouptitle`
|
||
|
- A dict of string/value properties that will be passed
|
||
|
to the Legendgrouptitle constructor
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
plotly.graph_objs.choroplethmapbox.Legendgrouptitle
|
||
|
"""
|
||
|
return self["legendgrouptitle"]
|
||
|
|
||
|
@legendgrouptitle.setter
|
||
|
def legendgrouptitle(self, val):
|
||
|
self["legendgrouptitle"] = val
|
||
|
|
||
|
@property
|
||
|
def legendrank(self):
|
||
|
"""
|
||
|
Sets the legend rank for this trace. Items and groups with
|
||
|
smaller ranks are presented on top/left side while with
|
||
|
"reversed" `legend.traceorder` they are on bottom/right side.
|
||
|
The default legendrank is 1000, so that you can use ranks less
|
||
|
than 1000 to place certain items before all unranked items, and
|
||
|
ranks greater than 1000 to go after all unranked items. When
|
||
|
having unranked or equal rank items shapes would be displayed
|
||
|
after traces i.e. according to their order in data and layout.
|
||
|
|
||
|
The 'legendrank' property is a number and may be specified as:
|
||
|
- An int or float
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
int|float
|
||
|
"""
|
||
|
return self["legendrank"]
|
||
|
|
||
|
@legendrank.setter
|
||
|
def legendrank(self, val):
|
||
|
self["legendrank"] = val
|
||
|
|
||
|
@property
|
||
|
def legendwidth(self):
|
||
|
"""
|
||
|
Sets the width (in px or fraction) of the legend for this
|
||
|
trace.
|
||
|
|
||
|
The 'legendwidth' property is a number and may be specified as:
|
||
|
- An int or float in the interval [0, inf]
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
int|float
|
||
|
"""
|
||
|
return self["legendwidth"]
|
||
|
|
||
|
@legendwidth.setter
|
||
|
def legendwidth(self, val):
|
||
|
self["legendwidth"] = val
|
||
|
|
||
|
@property
|
||
|
def locations(self):
|
||
|
"""
|
||
|
Sets which features found in "geojson" to plot using their
|
||
|
feature `id` field.
|
||
|
|
||
|
The 'locations' property is an array that may be specified as a tuple,
|
||
|
list, numpy array, or pandas Series
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
numpy.ndarray
|
||
|
"""
|
||
|
return self["locations"]
|
||
|
|
||
|
@locations.setter
|
||
|
def locations(self, val):
|
||
|
self["locations"] = val
|
||
|
|
||
|
@property
|
||
|
def locationssrc(self):
|
||
|
"""
|
||
|
Sets the source reference on Chart Studio Cloud for
|
||
|
`locations`.
|
||
|
|
||
|
The 'locationssrc' property must be specified as a string or
|
||
|
as a plotly.grid_objs.Column object
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["locationssrc"]
|
||
|
|
||
|
@locationssrc.setter
|
||
|
def locationssrc(self, val):
|
||
|
self["locationssrc"] = val
|
||
|
|
||
|
@property
|
||
|
def marker(self):
|
||
|
"""
|
||
|
The 'marker' property is an instance of Marker
|
||
|
that may be specified as:
|
||
|
- An instance of :class:`plotly.graph_objs.choroplethmapbox.Marker`
|
||
|
- A dict of string/value properties that will be passed
|
||
|
to the Marker constructor
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
plotly.graph_objs.choroplethmapbox.Marker
|
||
|
"""
|
||
|
return self["marker"]
|
||
|
|
||
|
@marker.setter
|
||
|
def marker(self, val):
|
||
|
self["marker"] = val
|
||
|
|
||
|
@property
|
||
|
def meta(self):
|
||
|
"""
|
||
|
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
|
||
|
"""
|
||
|
return self["meta"]
|
||
|
|
||
|
@meta.setter
|
||
|
def meta(self, val):
|
||
|
self["meta"] = val
|
||
|
|
||
|
@property
|
||
|
def metasrc(self):
|
||
|
"""
|
||
|
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
|
||
|
"""
|
||
|
return self["metasrc"]
|
||
|
|
||
|
@metasrc.setter
|
||
|
def metasrc(self, val):
|
||
|
self["metasrc"] = val
|
||
|
|
||
|
@property
|
||
|
def name(self):
|
||
|
"""
|
||
|
Sets the trace name. The trace name appears 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
|
||
|
"""
|
||
|
return self["name"]
|
||
|
|
||
|
@name.setter
|
||
|
def name(self, val):
|
||
|
self["name"] = val
|
||
|
|
||
|
@property
|
||
|
def reversescale(self):
|
||
|
"""
|
||
|
Reverses the color mapping if true. If true, `zmin` will
|
||
|
correspond to the last color in the array and `zmax` will
|
||
|
correspond to the first color.
|
||
|
|
||
|
The 'reversescale' property must be specified as a bool
|
||
|
(either True, or False)
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
bool
|
||
|
"""
|
||
|
return self["reversescale"]
|
||
|
|
||
|
@reversescale.setter
|
||
|
def reversescale(self, val):
|
||
|
self["reversescale"] = val
|
||
|
|
||
|
@property
|
||
|
def selected(self):
|
||
|
"""
|
||
|
The 'selected' property is an instance of Selected
|
||
|
that may be specified as:
|
||
|
- An instance of :class:`plotly.graph_objs.choroplethmapbox.Selected`
|
||
|
- A dict of string/value properties that will be passed
|
||
|
to the Selected constructor
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
plotly.graph_objs.choroplethmapbox.Selected
|
||
|
"""
|
||
|
return self["selected"]
|
||
|
|
||
|
@selected.setter
|
||
|
def selected(self, val):
|
||
|
self["selected"] = val
|
||
|
|
||
|
@property
|
||
|
def selectedpoints(self):
|
||
|
"""
|
||
|
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
|
||
|
"""
|
||
|
return self["selectedpoints"]
|
||
|
|
||
|
@selectedpoints.setter
|
||
|
def selectedpoints(self, val):
|
||
|
self["selectedpoints"] = val
|
||
|
|
||
|
@property
|
||
|
def showlegend(self):
|
||
|
"""
|
||
|
Determines whether or not an item corresponding to this trace
|
||
|
is shown in the legend.
|
||
|
|
||
|
The 'showlegend' property must be specified as a bool
|
||
|
(either True, or False)
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
bool
|
||
|
"""
|
||
|
return self["showlegend"]
|
||
|
|
||
|
@showlegend.setter
|
||
|
def showlegend(self, val):
|
||
|
self["showlegend"] = val
|
||
|
|
||
|
@property
|
||
|
def showscale(self):
|
||
|
"""
|
||
|
Determines whether or not a colorbar is displayed for this
|
||
|
trace.
|
||
|
|
||
|
The 'showscale' property must be specified as a bool
|
||
|
(either True, or False)
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
bool
|
||
|
"""
|
||
|
return self["showscale"]
|
||
|
|
||
|
@showscale.setter
|
||
|
def showscale(self, val):
|
||
|
self["showscale"] = val
|
||
|
|
||
|
@property
|
||
|
def stream(self):
|
||
|
"""
|
||
|
The 'stream' property is an instance of Stream
|
||
|
that may be specified as:
|
||
|
- An instance of :class:`plotly.graph_objs.choroplethmapbox.Stream`
|
||
|
- A dict of string/value properties that will be passed
|
||
|
to the Stream constructor
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
plotly.graph_objs.choroplethmapbox.Stream
|
||
|
"""
|
||
|
return self["stream"]
|
||
|
|
||
|
@stream.setter
|
||
|
def stream(self, val):
|
||
|
self["stream"] = val
|
||
|
|
||
|
@property
|
||
|
def subplot(self):
|
||
|
"""
|
||
|
mapbox subplots and traces are deprecated! Please consider
|
||
|
switching to `map` subplots and traces. Learn more at:
|
||
|
https://plotly.com/python/maplibre-migration/ as well as
|
||
|
https://plotly.com/javascript/maplibre-migration/ 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.
|
||
|
|
||
|
The 'subplot' property is an identifier of a particular
|
||
|
subplot, of type 'mapbox', that may be specified as the string 'mapbox'
|
||
|
optionally followed by an integer >= 1
|
||
|
(e.g. 'mapbox', 'mapbox1', 'mapbox2', 'mapbox3', etc.)
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["subplot"]
|
||
|
|
||
|
@subplot.setter
|
||
|
def subplot(self, val):
|
||
|
self["subplot"] = val
|
||
|
|
||
|
@property
|
||
|
def text(self):
|
||
|
"""
|
||
|
Sets the text elements associated with each location.
|
||
|
|
||
|
The 'text' property is a string and must be specified as:
|
||
|
- A string
|
||
|
- A number that will be converted to a string
|
||
|
- A tuple, list, or one-dimensional numpy array of the above
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str|numpy.ndarray
|
||
|
"""
|
||
|
return self["text"]
|
||
|
|
||
|
@text.setter
|
||
|
def text(self, val):
|
||
|
self["text"] = val
|
||
|
|
||
|
@property
|
||
|
def textsrc(self):
|
||
|
"""
|
||
|
Sets the source reference on Chart Studio Cloud for `text`.
|
||
|
|
||
|
The 'textsrc' property must be specified as a string or
|
||
|
as a plotly.grid_objs.Column object
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["textsrc"]
|
||
|
|
||
|
@textsrc.setter
|
||
|
def textsrc(self, val):
|
||
|
self["textsrc"] = val
|
||
|
|
||
|
@property
|
||
|
def uid(self):
|
||
|
"""
|
||
|
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
|
||
|
"""
|
||
|
return self["uid"]
|
||
|
|
||
|
@uid.setter
|
||
|
def uid(self, val):
|
||
|
self["uid"] = val
|
||
|
|
||
|
@property
|
||
|
def uirevision(self):
|
||
|
"""
|
||
|
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
|
||
|
"""
|
||
|
return self["uirevision"]
|
||
|
|
||
|
@uirevision.setter
|
||
|
def uirevision(self, val):
|
||
|
self["uirevision"] = val
|
||
|
|
||
|
@property
|
||
|
def unselected(self):
|
||
|
"""
|
||
|
The 'unselected' property is an instance of Unselected
|
||
|
that may be specified as:
|
||
|
- An instance of :class:`plotly.graph_objs.choroplethmapbox.Unselected`
|
||
|
- A dict of string/value properties that will be passed
|
||
|
to the Unselected constructor
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
plotly.graph_objs.choroplethmapbox.Unselected
|
||
|
"""
|
||
|
return self["unselected"]
|
||
|
|
||
|
@unselected.setter
|
||
|
def unselected(self, val):
|
||
|
self["unselected"] = val
|
||
|
|
||
|
@property
|
||
|
def visible(self):
|
||
|
"""
|
||
|
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
|
||
|
"""
|
||
|
return self["visible"]
|
||
|
|
||
|
@visible.setter
|
||
|
def visible(self, val):
|
||
|
self["visible"] = val
|
||
|
|
||
|
@property
|
||
|
def z(self):
|
||
|
"""
|
||
|
Sets the color values.
|
||
|
|
||
|
The 'z' property is an array that may be specified as a tuple,
|
||
|
list, numpy array, or pandas Series
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
numpy.ndarray
|
||
|
"""
|
||
|
return self["z"]
|
||
|
|
||
|
@z.setter
|
||
|
def z(self, val):
|
||
|
self["z"] = val
|
||
|
|
||
|
@property
|
||
|
def zauto(self):
|
||
|
"""
|
||
|
Determines whether or not the color domain is computed with
|
||
|
respect to the input data (here in `z`) or the bounds set in
|
||
|
`zmin` and `zmax` Defaults to `false` when `zmin` and `zmax`
|
||
|
are set by the user.
|
||
|
|
||
|
The 'zauto' property must be specified as a bool
|
||
|
(either True, or False)
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
bool
|
||
|
"""
|
||
|
return self["zauto"]
|
||
|
|
||
|
@zauto.setter
|
||
|
def zauto(self, val):
|
||
|
self["zauto"] = val
|
||
|
|
||
|
@property
|
||
|
def zmax(self):
|
||
|
"""
|
||
|
Sets the upper bound of the color domain. Value should have the
|
||
|
same units as in `z` and if set, `zmin` must be set as well.
|
||
|
|
||
|
The 'zmax' property is a number and may be specified as:
|
||
|
- An int or float
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
int|float
|
||
|
"""
|
||
|
return self["zmax"]
|
||
|
|
||
|
@zmax.setter
|
||
|
def zmax(self, val):
|
||
|
self["zmax"] = val
|
||
|
|
||
|
@property
|
||
|
def zmid(self):
|
||
|
"""
|
||
|
Sets the mid-point of the color domain by scaling `zmin` and/or
|
||
|
`zmax` to be equidistant to this point. Value should have the
|
||
|
same units as in `z`. Has no effect when `zauto` is `false`.
|
||
|
|
||
|
The 'zmid' property is a number and may be specified as:
|
||
|
- An int or float
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
int|float
|
||
|
"""
|
||
|
return self["zmid"]
|
||
|
|
||
|
@zmid.setter
|
||
|
def zmid(self, val):
|
||
|
self["zmid"] = val
|
||
|
|
||
|
@property
|
||
|
def zmin(self):
|
||
|
"""
|
||
|
Sets the lower bound of the color domain. Value should have the
|
||
|
same units as in `z` and if set, `zmax` must be set as well.
|
||
|
|
||
|
The 'zmin' property is a number and may be specified as:
|
||
|
- An int or float
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
int|float
|
||
|
"""
|
||
|
return self["zmin"]
|
||
|
|
||
|
@zmin.setter
|
||
|
def zmin(self, val):
|
||
|
self["zmin"] = val
|
||
|
|
||
|
@property
|
||
|
def zsrc(self):
|
||
|
"""
|
||
|
Sets the source reference on Chart Studio Cloud for `z`.
|
||
|
|
||
|
The 'zsrc' property must be specified as a string or
|
||
|
as a plotly.grid_objs.Column object
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
str
|
||
|
"""
|
||
|
return self["zsrc"]
|
||
|
|
||
|
@zsrc.setter
|
||
|
def zsrc(self, val):
|
||
|
self["zsrc"] = val
|
||
|
|
||
|
@property
|
||
|
def type(self):
|
||
|
return self._props["type"]
|
||
|
|
||
|
@property
|
||
|
def _prop_descriptions(self):
|
||
|
return """\
|
||
|
autocolorscale
|
||
|
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.
|
||
|
below
|
||
|
Determines if the choropleth polygons will be inserted
|
||
|
before the layer with the specified ID. By default,
|
||
|
choroplethmapbox traces are placed above the water
|
||
|
layers. If set to '', the layer will be inserted above
|
||
|
every existing layer.
|
||
|
coloraxis
|
||
|
Sets a reference to a shared color axis. References to
|
||
|
these shared color axes are "coloraxis", "coloraxis2",
|
||
|
"coloraxis3", etc. Settings for these shared color axes
|
||
|
are set in the layout, under `layout.coloraxis`,
|
||
|
`layout.coloraxis2`, etc. Note that multiple color
|
||
|
scales can be linked to the same color axis.
|
||
|
colorbar
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.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 color space, use `zmin` and `zmax`.
|
||
|
Alternatively, `colorscale` may be a palette name
|
||
|
string of the following list: Blackbody,Bluered,Blues,C
|
||
|
ividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portl
|
||
|
and,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
|
||
|
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`.
|
||
|
featureidkey
|
||
|
Sets the key in GeoJSON features which is used as id to
|
||
|
match the items included in the `locations` array.
|
||
|
Support nested property, for example "properties.name".
|
||
|
geojson
|
||
|
Sets the GeoJSON data associated with this trace. It
|
||
|
can be set as a valid GeoJSON object or as a URL
|
||
|
string. Note that we only accept GeoJSONs of type
|
||
|
"FeatureCollection" or "Feature" with geometries of
|
||
|
type "Polygon" or "MultiPolygon".
|
||
|
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 Chart Studio Cloud for
|
||
|
`hoverinfo`.
|
||
|
hoverlabel
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.Hoverlabe
|
||
|
l` 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}" as well as %{xother}, {%_xother},
|
||
|
{%_xother_}, {%xother_}. When showing info for several
|
||
|
points, "xother" will be added to those with different
|
||
|
x positions from the first point. An underscore before
|
||
|
or after "(x|y)other" will add a space on that side,
|
||
|
only when this field is shown. Numbers are formatted
|
||
|
using d3-format's syntax %{variable:d3-format}, for
|
||
|
example "Price: %{y:$.2f}".
|
||
|
https://github.com/d3/d3-format/tree/v1.4.5#d3-format
|
||
|
for details on the formatting syntax. Dates are
|
||
|
formatted using d3-time-format's syntax
|
||
|
%{variable|d3-time-format}, for example "Day:
|
||
|
%{2019-01-01|%A}". https://github.com/d3/d3-time-
|
||
|
format/tree/v2.2.3#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. Finally, the template string has access
|
||
|
to variable `properties` Anything contained in tag
|
||
|
`<extra>` is displayed in the secondary box, for
|
||
|
example `<extra>%{fullData.name}</extra>`. To hide the
|
||
|
secondary box completely, use an empty tag
|
||
|
`<extra></extra>`.
|
||
|
hovertemplatesrc
|
||
|
Sets the source reference on Chart Studio Cloud for
|
||
|
`hovertemplate`.
|
||
|
hovertext
|
||
|
Same as `text`.
|
||
|
hovertextsrc
|
||
|
Sets the source reference on Chart Studio Cloud 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 Chart Studio Cloud for
|
||
|
`ids`.
|
||
|
legend
|
||
|
Sets the reference to a legend to show this trace in.
|
||
|
References to these legends are "legend", "legend2",
|
||
|
"legend3", etc. Settings for these legends are set in
|
||
|
the layout, under `layout.legend`, `layout.legend2`,
|
||
|
etc.
|
||
|
legendgroup
|
||
|
Sets the legend group for this trace. Traces and shapes
|
||
|
part of the same legend group hide/show at the same
|
||
|
time when toggling legend items.
|
||
|
legendgrouptitle
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.Legendgro
|
||
|
uptitle` instance or dict with compatible properties
|
||
|
legendrank
|
||
|
Sets the legend rank for this trace. Items and groups
|
||
|
with smaller ranks are presented on top/left side while
|
||
|
with "reversed" `legend.traceorder` they are on
|
||
|
bottom/right side. The default legendrank is 1000, so
|
||
|
that you can use ranks less than 1000 to place certain
|
||
|
items before all unranked items, and ranks greater than
|
||
|
1000 to go after all unranked items. When having
|
||
|
unranked or equal rank items shapes would be displayed
|
||
|
after traces i.e. according to their order in data and
|
||
|
layout.
|
||
|
legendwidth
|
||
|
Sets the width (in px or fraction) of the legend for
|
||
|
this trace.
|
||
|
locations
|
||
|
Sets which features found in "geojson" to plot using
|
||
|
their feature `id` field.
|
||
|
locationssrc
|
||
|
Sets the source reference on Chart Studio Cloud for
|
||
|
`locations`.
|
||
|
marker
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.Marker`
|
||
|
instance or dict with compatible properties
|
||
|
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 appears as the
|
||
|
legend item and on hover.
|
||
|
reversescale
|
||
|
Reverses the color mapping if true. If true, `zmin`
|
||
|
will correspond to the last color in the array and
|
||
|
`zmax` will correspond to the first color.
|
||
|
selected
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.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
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.Stream`
|
||
|
instance or dict with compatible properties
|
||
|
subplot
|
||
|
mapbox subplots and traces are deprecated! Please
|
||
|
consider switching to `map` subplots and traces. Learn
|
||
|
more at: https://plotly.com/python/maplibre-migration/
|
||
|
as well as https://plotly.com/javascript/maplibre-
|
||
|
migration/ 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 the text elements associated with each location.
|
||
|
textsrc
|
||
|
Sets the source reference on Chart Studio Cloud for
|
||
|
`text`.
|
||
|
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.
|
||
|
unselected
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.Unselecte
|
||
|
d` 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 whether or not the color domain is computed
|
||
|
with respect to the input data (here in `z`) or the
|
||
|
bounds set in `zmin` and `zmax` Defaults to `false`
|
||
|
when `zmin` and `zmax` are set by the user.
|
||
|
zmax
|
||
|
Sets the upper bound of the color domain. Value should
|
||
|
have the same units as in `z` and if set, `zmin` must
|
||
|
be set as well.
|
||
|
zmid
|
||
|
Sets the mid-point of the color domain by scaling
|
||
|
`zmin` and/or `zmax` to be equidistant to this point.
|
||
|
Value should have the same units as in `z`. Has no
|
||
|
effect when `zauto` is `false`.
|
||
|
zmin
|
||
|
Sets the lower bound of the color domain. Value should
|
||
|
have the same units as in `z` and if set, `zmax` must
|
||
|
be set as well.
|
||
|
zsrc
|
||
|
Sets the source reference on Chart Studio Cloud for
|
||
|
`z`.
|
||
|
"""
|
||
|
|
||
|
def __init__(
|
||
|
self,
|
||
|
arg=None,
|
||
|
autocolorscale=None,
|
||
|
below=None,
|
||
|
coloraxis=None,
|
||
|
colorbar=None,
|
||
|
colorscale=None,
|
||
|
customdata=None,
|
||
|
customdatasrc=None,
|
||
|
featureidkey=None,
|
||
|
geojson=None,
|
||
|
hoverinfo=None,
|
||
|
hoverinfosrc=None,
|
||
|
hoverlabel=None,
|
||
|
hovertemplate=None,
|
||
|
hovertemplatesrc=None,
|
||
|
hovertext=None,
|
||
|
hovertextsrc=None,
|
||
|
ids=None,
|
||
|
idssrc=None,
|
||
|
legend=None,
|
||
|
legendgroup=None,
|
||
|
legendgrouptitle=None,
|
||
|
legendrank=None,
|
||
|
legendwidth=None,
|
||
|
locations=None,
|
||
|
locationssrc=None,
|
||
|
marker=None,
|
||
|
meta=None,
|
||
|
metasrc=None,
|
||
|
name=None,
|
||
|
reversescale=None,
|
||
|
selected=None,
|
||
|
selectedpoints=None,
|
||
|
showlegend=None,
|
||
|
showscale=None,
|
||
|
stream=None,
|
||
|
subplot=None,
|
||
|
text=None,
|
||
|
textsrc=None,
|
||
|
uid=None,
|
||
|
uirevision=None,
|
||
|
unselected=None,
|
||
|
visible=None,
|
||
|
z=None,
|
||
|
zauto=None,
|
||
|
zmax=None,
|
||
|
zmid=None,
|
||
|
zmin=None,
|
||
|
zsrc=None,
|
||
|
**kwargs,
|
||
|
):
|
||
|
"""
|
||
|
Construct a new Choroplethmapbox object
|
||
|
|
||
|
"choroplethmapbox" trace is deprecated! Please consider
|
||
|
switching to the "choroplethmap" trace type and `map` subplots.
|
||
|
Learn more at: https://plotly.com/python/maplibre-migration/ as
|
||
|
well as https://plotly.com/javascript/maplibre-migration/
|
||
|
GeoJSON features to be filled are set in `geojson` The data
|
||
|
that describes the choropleth value-to-color mapping is set in
|
||
|
`locations` and `z`.
|
||
|
|
||
|
Parameters
|
||
|
----------
|
||
|
arg
|
||
|
dict of properties compatible with this constructor or
|
||
|
an instance of
|
||
|
:class:`plotly.graph_objs.Choroplethmapbox`
|
||
|
autocolorscale
|
||
|
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.
|
||
|
below
|
||
|
Determines if the choropleth polygons will be inserted
|
||
|
before the layer with the specified ID. By default,
|
||
|
choroplethmapbox traces are placed above the water
|
||
|
layers. If set to '', the layer will be inserted above
|
||
|
every existing layer.
|
||
|
coloraxis
|
||
|
Sets a reference to a shared color axis. References to
|
||
|
these shared color axes are "coloraxis", "coloraxis2",
|
||
|
"coloraxis3", etc. Settings for these shared color axes
|
||
|
are set in the layout, under `layout.coloraxis`,
|
||
|
`layout.coloraxis2`, etc. Note that multiple color
|
||
|
scales can be linked to the same color axis.
|
||
|
colorbar
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.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 color space, use `zmin` and `zmax`.
|
||
|
Alternatively, `colorscale` may be a palette name
|
||
|
string of the following list: Blackbody,Bluered,Blues,C
|
||
|
ividis,Earth,Electric,Greens,Greys,Hot,Jet,Picnic,Portl
|
||
|
and,Rainbow,RdBu,Reds,Viridis,YlGnBu,YlOrRd.
|
||
|
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`.
|
||
|
featureidkey
|
||
|
Sets the key in GeoJSON features which is used as id to
|
||
|
match the items included in the `locations` array.
|
||
|
Support nested property, for example "properties.name".
|
||
|
geojson
|
||
|
Sets the GeoJSON data associated with this trace. It
|
||
|
can be set as a valid GeoJSON object or as a URL
|
||
|
string. Note that we only accept GeoJSONs of type
|
||
|
"FeatureCollection" or "Feature" with geometries of
|
||
|
type "Polygon" or "MultiPolygon".
|
||
|
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 Chart Studio Cloud for
|
||
|
`hoverinfo`.
|
||
|
hoverlabel
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.Hoverlabe
|
||
|
l` 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}" as well as %{xother}, {%_xother},
|
||
|
{%_xother_}, {%xother_}. When showing info for several
|
||
|
points, "xother" will be added to those with different
|
||
|
x positions from the first point. An underscore before
|
||
|
or after "(x|y)other" will add a space on that side,
|
||
|
only when this field is shown. Numbers are formatted
|
||
|
using d3-format's syntax %{variable:d3-format}, for
|
||
|
example "Price: %{y:$.2f}".
|
||
|
https://github.com/d3/d3-format/tree/v1.4.5#d3-format
|
||
|
for details on the formatting syntax. Dates are
|
||
|
formatted using d3-time-format's syntax
|
||
|
%{variable|d3-time-format}, for example "Day:
|
||
|
%{2019-01-01|%A}". https://github.com/d3/d3-time-
|
||
|
format/tree/v2.2.3#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. Finally, the template string has access
|
||
|
to variable `properties` Anything contained in tag
|
||
|
`<extra>` is displayed in the secondary box, for
|
||
|
example `<extra>%{fullData.name}</extra>`. To hide the
|
||
|
secondary box completely, use an empty tag
|
||
|
`<extra></extra>`.
|
||
|
hovertemplatesrc
|
||
|
Sets the source reference on Chart Studio Cloud for
|
||
|
`hovertemplate`.
|
||
|
hovertext
|
||
|
Same as `text`.
|
||
|
hovertextsrc
|
||
|
Sets the source reference on Chart Studio Cloud 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 Chart Studio Cloud for
|
||
|
`ids`.
|
||
|
legend
|
||
|
Sets the reference to a legend to show this trace in.
|
||
|
References to these legends are "legend", "legend2",
|
||
|
"legend3", etc. Settings for these legends are set in
|
||
|
the layout, under `layout.legend`, `layout.legend2`,
|
||
|
etc.
|
||
|
legendgroup
|
||
|
Sets the legend group for this trace. Traces and shapes
|
||
|
part of the same legend group hide/show at the same
|
||
|
time when toggling legend items.
|
||
|
legendgrouptitle
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.Legendgro
|
||
|
uptitle` instance or dict with compatible properties
|
||
|
legendrank
|
||
|
Sets the legend rank for this trace. Items and groups
|
||
|
with smaller ranks are presented on top/left side while
|
||
|
with "reversed" `legend.traceorder` they are on
|
||
|
bottom/right side. The default legendrank is 1000, so
|
||
|
that you can use ranks less than 1000 to place certain
|
||
|
items before all unranked items, and ranks greater than
|
||
|
1000 to go after all unranked items. When having
|
||
|
unranked or equal rank items shapes would be displayed
|
||
|
after traces i.e. according to their order in data and
|
||
|
layout.
|
||
|
legendwidth
|
||
|
Sets the width (in px or fraction) of the legend for
|
||
|
this trace.
|
||
|
locations
|
||
|
Sets which features found in "geojson" to plot using
|
||
|
their feature `id` field.
|
||
|
locationssrc
|
||
|
Sets the source reference on Chart Studio Cloud for
|
||
|
`locations`.
|
||
|
marker
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.Marker`
|
||
|
instance or dict with compatible properties
|
||
|
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 appears as the
|
||
|
legend item and on hover.
|
||
|
reversescale
|
||
|
Reverses the color mapping if true. If true, `zmin`
|
||
|
will correspond to the last color in the array and
|
||
|
`zmax` will correspond to the first color.
|
||
|
selected
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.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
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.Stream`
|
||
|
instance or dict with compatible properties
|
||
|
subplot
|
||
|
mapbox subplots and traces are deprecated! Please
|
||
|
consider switching to `map` subplots and traces. Learn
|
||
|
more at: https://plotly.com/python/maplibre-migration/
|
||
|
as well as https://plotly.com/javascript/maplibre-
|
||
|
migration/ 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 the text elements associated with each location.
|
||
|
textsrc
|
||
|
Sets the source reference on Chart Studio Cloud for
|
||
|
`text`.
|
||
|
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.
|
||
|
unselected
|
||
|
:class:`plotly.graph_objects.choroplethmapbox.Unselecte
|
||
|
d` 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 whether or not the color domain is computed
|
||
|
with respect to the input data (here in `z`) or the
|
||
|
bounds set in `zmin` and `zmax` Defaults to `false`
|
||
|
when `zmin` and `zmax` are set by the user.
|
||
|
zmax
|
||
|
Sets the upper bound of the color domain. Value should
|
||
|
have the same units as in `z` and if set, `zmin` must
|
||
|
be set as well.
|
||
|
zmid
|
||
|
Sets the mid-point of the color domain by scaling
|
||
|
`zmin` and/or `zmax` to be equidistant to this point.
|
||
|
Value should have the same units as in `z`. Has no
|
||
|
effect when `zauto` is `false`.
|
||
|
zmin
|
||
|
Sets the lower bound of the color domain. Value should
|
||
|
have the same units as in `z` and if set, `zmax` must
|
||
|
be set as well.
|
||
|
zsrc
|
||
|
Sets the source reference on Chart Studio Cloud for
|
||
|
`z`.
|
||
|
|
||
|
Returns
|
||
|
-------
|
||
|
Choroplethmapbox
|
||
|
"""
|
||
|
super().__init__("choroplethmapbox")
|
||
|
if "_parent" in kwargs:
|
||
|
self._parent = kwargs["_parent"]
|
||
|
return
|
||
|
|
||
|
if arg is None:
|
||
|
arg = {}
|
||
|
elif isinstance(arg, self.__class__):
|
||
|
arg = arg.to_plotly_json()
|
||
|
elif isinstance(arg, dict):
|
||
|
arg = _copy.copy(arg)
|
||
|
else:
|
||
|
raise ValueError("""\
|
||
|
The first argument to the plotly.graph_objs.Choroplethmapbox
|
||
|
constructor must be a dict or
|
||
|
an instance of :class:`plotly.graph_objs.Choroplethmapbox`""")
|
||
|
|
||
|
self._skip_invalid = kwargs.pop("skip_invalid", False)
|
||
|
self._validate = kwargs.pop("_validate", True)
|
||
|
|
||
|
self._set_property("autocolorscale", arg, autocolorscale)
|
||
|
self._set_property("below", arg, below)
|
||
|
self._set_property("coloraxis", arg, coloraxis)
|
||
|
self._set_property("colorbar", arg, colorbar)
|
||
|
self._set_property("colorscale", arg, colorscale)
|
||
|
self._set_property("customdata", arg, customdata)
|
||
|
self._set_property("customdatasrc", arg, customdatasrc)
|
||
|
self._set_property("featureidkey", arg, featureidkey)
|
||
|
self._set_property("geojson", arg, geojson)
|
||
|
self._set_property("hoverinfo", arg, hoverinfo)
|
||
|
self._set_property("hoverinfosrc", arg, hoverinfosrc)
|
||
|
self._set_property("hoverlabel", arg, hoverlabel)
|
||
|
self._set_property("hovertemplate", arg, hovertemplate)
|
||
|
self._set_property("hovertemplatesrc", arg, hovertemplatesrc)
|
||
|
self._set_property("hovertext", arg, hovertext)
|
||
|
self._set_property("hovertextsrc", arg, hovertextsrc)
|
||
|
self._set_property("ids", arg, ids)
|
||
|
self._set_property("idssrc", arg, idssrc)
|
||
|
self._set_property("legend", arg, legend)
|
||
|
self._set_property("legendgroup", arg, legendgroup)
|
||
|
self._set_property("legendgrouptitle", arg, legendgrouptitle)
|
||
|
self._set_property("legendrank", arg, legendrank)
|
||
|
self._set_property("legendwidth", arg, legendwidth)
|
||
|
self._set_property("locations", arg, locations)
|
||
|
self._set_property("locationssrc", arg, locationssrc)
|
||
|
self._set_property("marker", arg, marker)
|
||
|
self._set_property("meta", arg, meta)
|
||
|
self._set_property("metasrc", arg, metasrc)
|
||
|
self._set_property("name", arg, name)
|
||
|
self._set_property("reversescale", arg, reversescale)
|
||
|
self._set_property("selected", arg, selected)
|
||
|
self._set_property("selectedpoints", arg, selectedpoints)
|
||
|
self._set_property("showlegend", arg, showlegend)
|
||
|
self._set_property("showscale", arg, showscale)
|
||
|
self._set_property("stream", arg, stream)
|
||
|
self._set_property("subplot", arg, subplot)
|
||
|
self._set_property("text", arg, text)
|
||
|
self._set_property("textsrc", arg, textsrc)
|
||
|
self._set_property("uid", arg, uid)
|
||
|
self._set_property("uirevision", arg, uirevision)
|
||
|
self._set_property("unselected", arg, unselected)
|
||
|
self._set_property("visible", arg, visible)
|
||
|
self._set_property("z", arg, z)
|
||
|
self._set_property("zauto", arg, zauto)
|
||
|
self._set_property("zmax", arg, zmax)
|
||
|
self._set_property("zmid", arg, zmid)
|
||
|
self._set_property("zmin", arg, zmin)
|
||
|
self._set_property("zsrc", arg, zsrc)
|
||
|
|
||
|
self._props["type"] = "choroplethmapbox"
|
||
|
arg.pop("type", None)
|
||
|
self._process_kwargs(**dict(arg, **kwargs))
|
||
|
self._skip_invalid = False
|
||
|
|
||
|
warnings.warn(
|
||
|
"*choroplethmapbox* is deprecated!"
|
||
|
+ " Use *choroplethmap* instead."
|
||
|
+ " Learn more at: https://plotly.com/python/mapbox-to-maplibre/",
|
||
|
stacklevel=2,
|
||
|
category=DeprecationWarning,
|
||
|
)
|