mirror of
https://github.com/aykhans/AzSuicideDataVisualization.git
synced 2025-07-01 14:07:48 +00:00
1038 lines
47 KiB
Python
1038 lines
47 KiB
Python
from plotly.basedatatypes import BaseLayoutHierarchyType as _BaseLayoutHierarchyType
|
|
import copy as _copy
|
|
|
|
|
|
class Ternary(_BaseLayoutHierarchyType):
|
|
|
|
# class properties
|
|
# --------------------
|
|
_parent_path_str = "layout"
|
|
_path_str = "layout.ternary"
|
|
_valid_props = {"aaxis", "baxis", "bgcolor", "caxis", "domain", "sum", "uirevision"}
|
|
|
|
# aaxis
|
|
# -----
|
|
@property
|
|
def aaxis(self):
|
|
"""
|
|
The 'aaxis' property is an instance of Aaxis
|
|
that may be specified as:
|
|
- An instance of :class:`plotly.graph_objs.layout.ternary.Aaxis`
|
|
- A dict of string/value properties that will be passed
|
|
to the Aaxis constructor
|
|
|
|
Supported dict properties:
|
|
|
|
color
|
|
Sets default for all colors associated with
|
|
this axis all at once: line, font, tick, and
|
|
grid colors. Grid color is lightened by
|
|
blending this with the plot background
|
|
Individual pieces can override this.
|
|
dtick
|
|
Sets the step in-between ticks on this axis.
|
|
Use with `tick0`. Must be a positive number, or
|
|
special strings available to "log" and "date"
|
|
axes. If the axis `type` is "log", then ticks
|
|
are set every 10^(n*dtick) where n is the tick
|
|
number. For example, to set a tick mark at 1,
|
|
10, 100, 1000, ... set dtick to 1. To set tick
|
|
marks at 1, 100, 10000, ... set dtick to 2. To
|
|
set tick marks at 1, 5, 25, 125, 625, 3125, ...
|
|
set dtick to log_10(5), or 0.69897000433. "log"
|
|
has several special values; "L<f>", where `f`
|
|
is a positive number, gives ticks linearly
|
|
spaced in value (but not position). For example
|
|
`tick0` = 0.1, `dtick` = "L0.5" will put ticks
|
|
at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10
|
|
plus small digits between, use "D1" (all
|
|
digits) or "D2" (only 2 and 5). `tick0` is
|
|
ignored for "D1" and "D2". If the axis `type`
|
|
is "date", then you must convert the time to
|
|
milliseconds. For example, to set the interval
|
|
between ticks to one day, set `dtick` to
|
|
86400000.0. "date" also has special values
|
|
"M<n>" gives ticks spaced by a number of
|
|
months. `n` must be a positive integer. To set
|
|
ticks on the 15th of every third month, set
|
|
`tick0` to "2000-01-15" and `dtick` to "M3". To
|
|
set ticks every 4 years, set `dtick` to "M48"
|
|
exponentformat
|
|
Determines a formatting rule for the tick
|
|
exponents. For example, consider the number
|
|
1,000,000,000. If "none", it appears as
|
|
1,000,000,000. If "e", 1e+9. If "E", 1E+9. If
|
|
"power", 1x10^9 (with 9 in a super script). If
|
|
"SI", 1G. If "B", 1B.
|
|
gridcolor
|
|
Sets the color of the grid lines.
|
|
griddash
|
|
Sets the dash style of lines. Set to a dash
|
|
type string ("solid", "dot", "dash",
|
|
"longdash", "dashdot", or "longdashdot") or a
|
|
dash length list in px (eg "5px,10px,2px,2px").
|
|
gridwidth
|
|
Sets the width (in px) of the grid lines.
|
|
hoverformat
|
|
Sets the hover text formatting rule using d3
|
|
formatting mini-languages which are very
|
|
similar to those in Python. For numbers, see: h
|
|
ttps://github.com/d3/d3-format/tree/v1.4.5#d3-f
|
|
ormat. And for dates see:
|
|
https://github.com/d3/d3-time-
|
|
format/tree/v2.2.3#locale_format. We add two
|
|
items to d3's date formatter: "%h" for half of
|
|
the year as a decimal number as well as "%{n}f"
|
|
for fractional seconds with n digits. For
|
|
example, *2016-10-13 09:15:23.456* with
|
|
tickformat "%H~%M~%S.%2f" would display
|
|
"09~15~23.46"
|
|
layer
|
|
Sets the layer on which this axis is displayed.
|
|
If *above traces*, this axis is displayed above
|
|
all the subplot's traces If *below traces*,
|
|
this axis is displayed below all the subplot's
|
|
traces, but above the grid lines. Useful when
|
|
used together with scatter-like traces with
|
|
`cliponaxis` set to False to show markers
|
|
and/or text nodes above this axis.
|
|
linecolor
|
|
Sets the axis line color.
|
|
linewidth
|
|
Sets the width (in px) of the axis line.
|
|
min
|
|
The minimum value visible on this axis. The
|
|
maximum is determined by the sum minus the
|
|
minimum values of the other two axes. The full
|
|
view corresponds to all the minima set to zero.
|
|
minexponent
|
|
Hide SI prefix for 10^n if |n| is below this
|
|
number. This only has an effect when
|
|
`tickformat` is "SI" or "B".
|
|
nticks
|
|
Specifies the maximum number of ticks for the
|
|
particular axis. The actual number of ticks
|
|
will be chosen automatically to be less than or
|
|
equal to `nticks`. Has an effect only if
|
|
`tickmode` is set to "auto".
|
|
separatethousands
|
|
If "true", even 4-digit integers are separated
|
|
showexponent
|
|
If "all", all exponents are shown besides their
|
|
significands. If "first", only the exponent of
|
|
the first tick is shown. If "last", only the
|
|
exponent of the last tick is shown. If "none",
|
|
no exponents appear.
|
|
showgrid
|
|
Determines whether or not grid lines are drawn.
|
|
If True, the grid lines are drawn at every tick
|
|
mark.
|
|
showline
|
|
Determines whether or not a line bounding this
|
|
axis is drawn.
|
|
showticklabels
|
|
Determines whether or not the tick labels are
|
|
drawn.
|
|
showtickprefix
|
|
If "all", all tick labels are displayed with a
|
|
prefix. If "first", only the first tick is
|
|
displayed with a prefix. If "last", only the
|
|
last tick is displayed with a suffix. If
|
|
"none", tick prefixes are hidden.
|
|
showticksuffix
|
|
Same as `showtickprefix` but for tick suffixes.
|
|
tick0
|
|
Sets the placement of the first tick on this
|
|
axis. Use with `dtick`. If the axis `type` is
|
|
"log", then you must take the log of your
|
|
starting tick (e.g. to set the starting tick to
|
|
100, set the `tick0` to 2) except when
|
|
`dtick`=*L<f>* (see `dtick` for more info). If
|
|
the axis `type` is "date", it should be a date
|
|
string, like date data. If the axis `type` is
|
|
"category", it should be a number, using the
|
|
scale where each category is assigned a serial
|
|
number from zero in the order it appears.
|
|
tickangle
|
|
Sets the angle of the tick labels with respect
|
|
to the horizontal. For example, a `tickangle`
|
|
of -90 draws the tick labels vertically.
|
|
tickcolor
|
|
Sets the tick color.
|
|
tickfont
|
|
Sets the tick font.
|
|
tickformat
|
|
Sets the tick label formatting rule using d3
|
|
formatting mini-languages which are very
|
|
similar to those in Python. For numbers, see: h
|
|
ttps://github.com/d3/d3-format/tree/v1.4.5#d3-f
|
|
ormat. And for dates see:
|
|
https://github.com/d3/d3-time-
|
|
format/tree/v2.2.3#locale_format. We add two
|
|
items to d3's date formatter: "%h" for half of
|
|
the year as a decimal number as well as "%{n}f"
|
|
for fractional seconds with n digits. For
|
|
example, *2016-10-13 09:15:23.456* with
|
|
tickformat "%H~%M~%S.%2f" would display
|
|
"09~15~23.46"
|
|
tickformatstops
|
|
A tuple of :class:`plotly.graph_objects.layout.
|
|
ternary.aaxis.Tickformatstop` instances or
|
|
dicts with compatible properties
|
|
tickformatstopdefaults
|
|
When used in a template (as layout.template.lay
|
|
out.ternary.aaxis.tickformatstopdefaults), sets
|
|
the default property values to use for elements
|
|
of layout.ternary.aaxis.tickformatstops
|
|
ticklabelstep
|
|
Sets the spacing between tick labels as
|
|
compared to the spacing between ticks. A value
|
|
of 1 (default) means each tick gets a label. A
|
|
value of 2 means shows every 2nd label. A
|
|
larger value n means only every nth tick is
|
|
labeled. `tick0` determines which labels are
|
|
shown. Not implemented for axes with `type`
|
|
"log" or "multicategory", or when `tickmode` is
|
|
"array".
|
|
ticklen
|
|
Sets the tick length (in px).
|
|
tickmode
|
|
Sets the tick mode for this axis. If "auto",
|
|
the number of ticks is set via `nticks`. If
|
|
"linear", the placement of the ticks is
|
|
determined by a starting position `tick0` and a
|
|
tick step `dtick` ("linear" is the default
|
|
value if `tick0` and `dtick` are provided). If
|
|
"array", the placement of the ticks is set via
|
|
`tickvals` and the tick text is `ticktext`.
|
|
("array" is the default value if `tickvals` is
|
|
provided).
|
|
tickprefix
|
|
Sets a tick label prefix.
|
|
ticks
|
|
Determines whether ticks are drawn or not. If
|
|
"", this axis' ticks are not drawn. If
|
|
"outside" ("inside"), this axis' are drawn
|
|
outside (inside) the axis lines.
|
|
ticksuffix
|
|
Sets a tick label suffix.
|
|
ticktext
|
|
Sets the text displayed at the ticks position
|
|
via `tickvals`. Only has an effect if
|
|
`tickmode` is set to "array". Used with
|
|
`tickvals`.
|
|
ticktextsrc
|
|
Sets the source reference on Chart Studio Cloud
|
|
for `ticktext`.
|
|
tickvals
|
|
Sets the values at which ticks on this axis
|
|
appear. Only has an effect if `tickmode` is set
|
|
to "array". Used with `ticktext`.
|
|
tickvalssrc
|
|
Sets the source reference on Chart Studio Cloud
|
|
for `tickvals`.
|
|
tickwidth
|
|
Sets the tick width (in px).
|
|
title
|
|
:class:`plotly.graph_objects.layout.ternary.aax
|
|
is.Title` instance or dict with compatible
|
|
properties
|
|
titlefont
|
|
Deprecated: Please use
|
|
layout.ternary.aaxis.title.font instead. Sets
|
|
this axis' title font. Note that the title's
|
|
font used to be customized by the now
|
|
deprecated `titlefont` attribute.
|
|
uirevision
|
|
Controls persistence of user-driven changes in
|
|
axis `min`, and `title` if in `editable: true`
|
|
configuration. Defaults to
|
|
`ternary<N>.uirevision`.
|
|
|
|
Returns
|
|
-------
|
|
plotly.graph_objs.layout.ternary.Aaxis
|
|
"""
|
|
return self["aaxis"]
|
|
|
|
@aaxis.setter
|
|
def aaxis(self, val):
|
|
self["aaxis"] = val
|
|
|
|
# baxis
|
|
# -----
|
|
@property
|
|
def baxis(self):
|
|
"""
|
|
The 'baxis' property is an instance of Baxis
|
|
that may be specified as:
|
|
- An instance of :class:`plotly.graph_objs.layout.ternary.Baxis`
|
|
- A dict of string/value properties that will be passed
|
|
to the Baxis constructor
|
|
|
|
Supported dict properties:
|
|
|
|
color
|
|
Sets default for all colors associated with
|
|
this axis all at once: line, font, tick, and
|
|
grid colors. Grid color is lightened by
|
|
blending this with the plot background
|
|
Individual pieces can override this.
|
|
dtick
|
|
Sets the step in-between ticks on this axis.
|
|
Use with `tick0`. Must be a positive number, or
|
|
special strings available to "log" and "date"
|
|
axes. If the axis `type` is "log", then ticks
|
|
are set every 10^(n*dtick) where n is the tick
|
|
number. For example, to set a tick mark at 1,
|
|
10, 100, 1000, ... set dtick to 1. To set tick
|
|
marks at 1, 100, 10000, ... set dtick to 2. To
|
|
set tick marks at 1, 5, 25, 125, 625, 3125, ...
|
|
set dtick to log_10(5), or 0.69897000433. "log"
|
|
has several special values; "L<f>", where `f`
|
|
is a positive number, gives ticks linearly
|
|
spaced in value (but not position). For example
|
|
`tick0` = 0.1, `dtick` = "L0.5" will put ticks
|
|
at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10
|
|
plus small digits between, use "D1" (all
|
|
digits) or "D2" (only 2 and 5). `tick0` is
|
|
ignored for "D1" and "D2". If the axis `type`
|
|
is "date", then you must convert the time to
|
|
milliseconds. For example, to set the interval
|
|
between ticks to one day, set `dtick` to
|
|
86400000.0. "date" also has special values
|
|
"M<n>" gives ticks spaced by a number of
|
|
months. `n` must be a positive integer. To set
|
|
ticks on the 15th of every third month, set
|
|
`tick0` to "2000-01-15" and `dtick` to "M3". To
|
|
set ticks every 4 years, set `dtick` to "M48"
|
|
exponentformat
|
|
Determines a formatting rule for the tick
|
|
exponents. For example, consider the number
|
|
1,000,000,000. If "none", it appears as
|
|
1,000,000,000. If "e", 1e+9. If "E", 1E+9. If
|
|
"power", 1x10^9 (with 9 in a super script). If
|
|
"SI", 1G. If "B", 1B.
|
|
gridcolor
|
|
Sets the color of the grid lines.
|
|
griddash
|
|
Sets the dash style of lines. Set to a dash
|
|
type string ("solid", "dot", "dash",
|
|
"longdash", "dashdot", or "longdashdot") or a
|
|
dash length list in px (eg "5px,10px,2px,2px").
|
|
gridwidth
|
|
Sets the width (in px) of the grid lines.
|
|
hoverformat
|
|
Sets the hover text formatting rule using d3
|
|
formatting mini-languages which are very
|
|
similar to those in Python. For numbers, see: h
|
|
ttps://github.com/d3/d3-format/tree/v1.4.5#d3-f
|
|
ormat. And for dates see:
|
|
https://github.com/d3/d3-time-
|
|
format/tree/v2.2.3#locale_format. We add two
|
|
items to d3's date formatter: "%h" for half of
|
|
the year as a decimal number as well as "%{n}f"
|
|
for fractional seconds with n digits. For
|
|
example, *2016-10-13 09:15:23.456* with
|
|
tickformat "%H~%M~%S.%2f" would display
|
|
"09~15~23.46"
|
|
layer
|
|
Sets the layer on which this axis is displayed.
|
|
If *above traces*, this axis is displayed above
|
|
all the subplot's traces If *below traces*,
|
|
this axis is displayed below all the subplot's
|
|
traces, but above the grid lines. Useful when
|
|
used together with scatter-like traces with
|
|
`cliponaxis` set to False to show markers
|
|
and/or text nodes above this axis.
|
|
linecolor
|
|
Sets the axis line color.
|
|
linewidth
|
|
Sets the width (in px) of the axis line.
|
|
min
|
|
The minimum value visible on this axis. The
|
|
maximum is determined by the sum minus the
|
|
minimum values of the other two axes. The full
|
|
view corresponds to all the minima set to zero.
|
|
minexponent
|
|
Hide SI prefix for 10^n if |n| is below this
|
|
number. This only has an effect when
|
|
`tickformat` is "SI" or "B".
|
|
nticks
|
|
Specifies the maximum number of ticks for the
|
|
particular axis. The actual number of ticks
|
|
will be chosen automatically to be less than or
|
|
equal to `nticks`. Has an effect only if
|
|
`tickmode` is set to "auto".
|
|
separatethousands
|
|
If "true", even 4-digit integers are separated
|
|
showexponent
|
|
If "all", all exponents are shown besides their
|
|
significands. If "first", only the exponent of
|
|
the first tick is shown. If "last", only the
|
|
exponent of the last tick is shown. If "none",
|
|
no exponents appear.
|
|
showgrid
|
|
Determines whether or not grid lines are drawn.
|
|
If True, the grid lines are drawn at every tick
|
|
mark.
|
|
showline
|
|
Determines whether or not a line bounding this
|
|
axis is drawn.
|
|
showticklabels
|
|
Determines whether or not the tick labels are
|
|
drawn.
|
|
showtickprefix
|
|
If "all", all tick labels are displayed with a
|
|
prefix. If "first", only the first tick is
|
|
displayed with a prefix. If "last", only the
|
|
last tick is displayed with a suffix. If
|
|
"none", tick prefixes are hidden.
|
|
showticksuffix
|
|
Same as `showtickprefix` but for tick suffixes.
|
|
tick0
|
|
Sets the placement of the first tick on this
|
|
axis. Use with `dtick`. If the axis `type` is
|
|
"log", then you must take the log of your
|
|
starting tick (e.g. to set the starting tick to
|
|
100, set the `tick0` to 2) except when
|
|
`dtick`=*L<f>* (see `dtick` for more info). If
|
|
the axis `type` is "date", it should be a date
|
|
string, like date data. If the axis `type` is
|
|
"category", it should be a number, using the
|
|
scale where each category is assigned a serial
|
|
number from zero in the order it appears.
|
|
tickangle
|
|
Sets the angle of the tick labels with respect
|
|
to the horizontal. For example, a `tickangle`
|
|
of -90 draws the tick labels vertically.
|
|
tickcolor
|
|
Sets the tick color.
|
|
tickfont
|
|
Sets the tick font.
|
|
tickformat
|
|
Sets the tick label formatting rule using d3
|
|
formatting mini-languages which are very
|
|
similar to those in Python. For numbers, see: h
|
|
ttps://github.com/d3/d3-format/tree/v1.4.5#d3-f
|
|
ormat. And for dates see:
|
|
https://github.com/d3/d3-time-
|
|
format/tree/v2.2.3#locale_format. We add two
|
|
items to d3's date formatter: "%h" for half of
|
|
the year as a decimal number as well as "%{n}f"
|
|
for fractional seconds with n digits. For
|
|
example, *2016-10-13 09:15:23.456* with
|
|
tickformat "%H~%M~%S.%2f" would display
|
|
"09~15~23.46"
|
|
tickformatstops
|
|
A tuple of :class:`plotly.graph_objects.layout.
|
|
ternary.baxis.Tickformatstop` instances or
|
|
dicts with compatible properties
|
|
tickformatstopdefaults
|
|
When used in a template (as layout.template.lay
|
|
out.ternary.baxis.tickformatstopdefaults), sets
|
|
the default property values to use for elements
|
|
of layout.ternary.baxis.tickformatstops
|
|
ticklabelstep
|
|
Sets the spacing between tick labels as
|
|
compared to the spacing between ticks. A value
|
|
of 1 (default) means each tick gets a label. A
|
|
value of 2 means shows every 2nd label. A
|
|
larger value n means only every nth tick is
|
|
labeled. `tick0` determines which labels are
|
|
shown. Not implemented for axes with `type`
|
|
"log" or "multicategory", or when `tickmode` is
|
|
"array".
|
|
ticklen
|
|
Sets the tick length (in px).
|
|
tickmode
|
|
Sets the tick mode for this axis. If "auto",
|
|
the number of ticks is set via `nticks`. If
|
|
"linear", the placement of the ticks is
|
|
determined by a starting position `tick0` and a
|
|
tick step `dtick` ("linear" is the default
|
|
value if `tick0` and `dtick` are provided). If
|
|
"array", the placement of the ticks is set via
|
|
`tickvals` and the tick text is `ticktext`.
|
|
("array" is the default value if `tickvals` is
|
|
provided).
|
|
tickprefix
|
|
Sets a tick label prefix.
|
|
ticks
|
|
Determines whether ticks are drawn or not. If
|
|
"", this axis' ticks are not drawn. If
|
|
"outside" ("inside"), this axis' are drawn
|
|
outside (inside) the axis lines.
|
|
ticksuffix
|
|
Sets a tick label suffix.
|
|
ticktext
|
|
Sets the text displayed at the ticks position
|
|
via `tickvals`. Only has an effect if
|
|
`tickmode` is set to "array". Used with
|
|
`tickvals`.
|
|
ticktextsrc
|
|
Sets the source reference on Chart Studio Cloud
|
|
for `ticktext`.
|
|
tickvals
|
|
Sets the values at which ticks on this axis
|
|
appear. Only has an effect if `tickmode` is set
|
|
to "array". Used with `ticktext`.
|
|
tickvalssrc
|
|
Sets the source reference on Chart Studio Cloud
|
|
for `tickvals`.
|
|
tickwidth
|
|
Sets the tick width (in px).
|
|
title
|
|
:class:`plotly.graph_objects.layout.ternary.bax
|
|
is.Title` instance or dict with compatible
|
|
properties
|
|
titlefont
|
|
Deprecated: Please use
|
|
layout.ternary.baxis.title.font instead. Sets
|
|
this axis' title font. Note that the title's
|
|
font used to be customized by the now
|
|
deprecated `titlefont` attribute.
|
|
uirevision
|
|
Controls persistence of user-driven changes in
|
|
axis `min`, and `title` if in `editable: true`
|
|
configuration. Defaults to
|
|
`ternary<N>.uirevision`.
|
|
|
|
Returns
|
|
-------
|
|
plotly.graph_objs.layout.ternary.Baxis
|
|
"""
|
|
return self["baxis"]
|
|
|
|
@baxis.setter
|
|
def baxis(self, val):
|
|
self["baxis"] = val
|
|
|
|
# bgcolor
|
|
# -------
|
|
@property
|
|
def bgcolor(self):
|
|
"""
|
|
Set the background color of the subplot
|
|
|
|
The 'bgcolor' property is a color and may be specified as:
|
|
- A hex string (e.g. '#ff0000')
|
|
- An rgb/rgba string (e.g. 'rgb(255,0,0)')
|
|
- An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
|
|
- An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
|
|
- A named CSS color:
|
|
aliceblue, antiquewhite, aqua, aquamarine, azure,
|
|
beige, bisque, black, blanchedalmond, blue,
|
|
blueviolet, brown, burlywood, cadetblue,
|
|
chartreuse, chocolate, coral, cornflowerblue,
|
|
cornsilk, crimson, cyan, darkblue, darkcyan,
|
|
darkgoldenrod, darkgray, darkgrey, darkgreen,
|
|
darkkhaki, darkmagenta, darkolivegreen, darkorange,
|
|
darkorchid, darkred, darksalmon, darkseagreen,
|
|
darkslateblue, darkslategray, darkslategrey,
|
|
darkturquoise, darkviolet, deeppink, deepskyblue,
|
|
dimgray, dimgrey, dodgerblue, firebrick,
|
|
floralwhite, forestgreen, fuchsia, gainsboro,
|
|
ghostwhite, gold, goldenrod, gray, grey, green,
|
|
greenyellow, honeydew, hotpink, indianred, indigo,
|
|
ivory, khaki, lavender, lavenderblush, lawngreen,
|
|
lemonchiffon, lightblue, lightcoral, lightcyan,
|
|
lightgoldenrodyellow, lightgray, lightgrey,
|
|
lightgreen, lightpink, lightsalmon, lightseagreen,
|
|
lightskyblue, lightslategray, lightslategrey,
|
|
lightsteelblue, lightyellow, lime, limegreen,
|
|
linen, magenta, maroon, mediumaquamarine,
|
|
mediumblue, mediumorchid, mediumpurple,
|
|
mediumseagreen, mediumslateblue, mediumspringgreen,
|
|
mediumturquoise, mediumvioletred, midnightblue,
|
|
mintcream, mistyrose, moccasin, navajowhite, navy,
|
|
oldlace, olive, olivedrab, orange, orangered,
|
|
orchid, palegoldenrod, palegreen, paleturquoise,
|
|
palevioletred, papayawhip, peachpuff, peru, pink,
|
|
plum, powderblue, purple, red, rosybrown,
|
|
royalblue, rebeccapurple, saddlebrown, salmon,
|
|
sandybrown, seagreen, seashell, sienna, silver,
|
|
skyblue, slateblue, slategray, slategrey, snow,
|
|
springgreen, steelblue, tan, teal, thistle, tomato,
|
|
turquoise, violet, wheat, white, whitesmoke,
|
|
yellow, yellowgreen
|
|
|
|
Returns
|
|
-------
|
|
str
|
|
"""
|
|
return self["bgcolor"]
|
|
|
|
@bgcolor.setter
|
|
def bgcolor(self, val):
|
|
self["bgcolor"] = val
|
|
|
|
# caxis
|
|
# -----
|
|
@property
|
|
def caxis(self):
|
|
"""
|
|
The 'caxis' property is an instance of Caxis
|
|
that may be specified as:
|
|
- An instance of :class:`plotly.graph_objs.layout.ternary.Caxis`
|
|
- A dict of string/value properties that will be passed
|
|
to the Caxis constructor
|
|
|
|
Supported dict properties:
|
|
|
|
color
|
|
Sets default for all colors associated with
|
|
this axis all at once: line, font, tick, and
|
|
grid colors. Grid color is lightened by
|
|
blending this with the plot background
|
|
Individual pieces can override this.
|
|
dtick
|
|
Sets the step in-between ticks on this axis.
|
|
Use with `tick0`. Must be a positive number, or
|
|
special strings available to "log" and "date"
|
|
axes. If the axis `type` is "log", then ticks
|
|
are set every 10^(n*dtick) where n is the tick
|
|
number. For example, to set a tick mark at 1,
|
|
10, 100, 1000, ... set dtick to 1. To set tick
|
|
marks at 1, 100, 10000, ... set dtick to 2. To
|
|
set tick marks at 1, 5, 25, 125, 625, 3125, ...
|
|
set dtick to log_10(5), or 0.69897000433. "log"
|
|
has several special values; "L<f>", where `f`
|
|
is a positive number, gives ticks linearly
|
|
spaced in value (but not position). For example
|
|
`tick0` = 0.1, `dtick` = "L0.5" will put ticks
|
|
at 0.1, 0.6, 1.1, 1.6 etc. To show powers of 10
|
|
plus small digits between, use "D1" (all
|
|
digits) or "D2" (only 2 and 5). `tick0` is
|
|
ignored for "D1" and "D2". If the axis `type`
|
|
is "date", then you must convert the time to
|
|
milliseconds. For example, to set the interval
|
|
between ticks to one day, set `dtick` to
|
|
86400000.0. "date" also has special values
|
|
"M<n>" gives ticks spaced by a number of
|
|
months. `n` must be a positive integer. To set
|
|
ticks on the 15th of every third month, set
|
|
`tick0` to "2000-01-15" and `dtick` to "M3". To
|
|
set ticks every 4 years, set `dtick` to "M48"
|
|
exponentformat
|
|
Determines a formatting rule for the tick
|
|
exponents. For example, consider the number
|
|
1,000,000,000. If "none", it appears as
|
|
1,000,000,000. If "e", 1e+9. If "E", 1E+9. If
|
|
"power", 1x10^9 (with 9 in a super script). If
|
|
"SI", 1G. If "B", 1B.
|
|
gridcolor
|
|
Sets the color of the grid lines.
|
|
griddash
|
|
Sets the dash style of lines. Set to a dash
|
|
type string ("solid", "dot", "dash",
|
|
"longdash", "dashdot", or "longdashdot") or a
|
|
dash length list in px (eg "5px,10px,2px,2px").
|
|
gridwidth
|
|
Sets the width (in px) of the grid lines.
|
|
hoverformat
|
|
Sets the hover text formatting rule using d3
|
|
formatting mini-languages which are very
|
|
similar to those in Python. For numbers, see: h
|
|
ttps://github.com/d3/d3-format/tree/v1.4.5#d3-f
|
|
ormat. And for dates see:
|
|
https://github.com/d3/d3-time-
|
|
format/tree/v2.2.3#locale_format. We add two
|
|
items to d3's date formatter: "%h" for half of
|
|
the year as a decimal number as well as "%{n}f"
|
|
for fractional seconds with n digits. For
|
|
example, *2016-10-13 09:15:23.456* with
|
|
tickformat "%H~%M~%S.%2f" would display
|
|
"09~15~23.46"
|
|
layer
|
|
Sets the layer on which this axis is displayed.
|
|
If *above traces*, this axis is displayed above
|
|
all the subplot's traces If *below traces*,
|
|
this axis is displayed below all the subplot's
|
|
traces, but above the grid lines. Useful when
|
|
used together with scatter-like traces with
|
|
`cliponaxis` set to False to show markers
|
|
and/or text nodes above this axis.
|
|
linecolor
|
|
Sets the axis line color.
|
|
linewidth
|
|
Sets the width (in px) of the axis line.
|
|
min
|
|
The minimum value visible on this axis. The
|
|
maximum is determined by the sum minus the
|
|
minimum values of the other two axes. The full
|
|
view corresponds to all the minima set to zero.
|
|
minexponent
|
|
Hide SI prefix for 10^n if |n| is below this
|
|
number. This only has an effect when
|
|
`tickformat` is "SI" or "B".
|
|
nticks
|
|
Specifies the maximum number of ticks for the
|
|
particular axis. The actual number of ticks
|
|
will be chosen automatically to be less than or
|
|
equal to `nticks`. Has an effect only if
|
|
`tickmode` is set to "auto".
|
|
separatethousands
|
|
If "true", even 4-digit integers are separated
|
|
showexponent
|
|
If "all", all exponents are shown besides their
|
|
significands. If "first", only the exponent of
|
|
the first tick is shown. If "last", only the
|
|
exponent of the last tick is shown. If "none",
|
|
no exponents appear.
|
|
showgrid
|
|
Determines whether or not grid lines are drawn.
|
|
If True, the grid lines are drawn at every tick
|
|
mark.
|
|
showline
|
|
Determines whether or not a line bounding this
|
|
axis is drawn.
|
|
showticklabels
|
|
Determines whether or not the tick labels are
|
|
drawn.
|
|
showtickprefix
|
|
If "all", all tick labels are displayed with a
|
|
prefix. If "first", only the first tick is
|
|
displayed with a prefix. If "last", only the
|
|
last tick is displayed with a suffix. If
|
|
"none", tick prefixes are hidden.
|
|
showticksuffix
|
|
Same as `showtickprefix` but for tick suffixes.
|
|
tick0
|
|
Sets the placement of the first tick on this
|
|
axis. Use with `dtick`. If the axis `type` is
|
|
"log", then you must take the log of your
|
|
starting tick (e.g. to set the starting tick to
|
|
100, set the `tick0` to 2) except when
|
|
`dtick`=*L<f>* (see `dtick` for more info). If
|
|
the axis `type` is "date", it should be a date
|
|
string, like date data. If the axis `type` is
|
|
"category", it should be a number, using the
|
|
scale where each category is assigned a serial
|
|
number from zero in the order it appears.
|
|
tickangle
|
|
Sets the angle of the tick labels with respect
|
|
to the horizontal. For example, a `tickangle`
|
|
of -90 draws the tick labels vertically.
|
|
tickcolor
|
|
Sets the tick color.
|
|
tickfont
|
|
Sets the tick font.
|
|
tickformat
|
|
Sets the tick label formatting rule using d3
|
|
formatting mini-languages which are very
|
|
similar to those in Python. For numbers, see: h
|
|
ttps://github.com/d3/d3-format/tree/v1.4.5#d3-f
|
|
ormat. And for dates see:
|
|
https://github.com/d3/d3-time-
|
|
format/tree/v2.2.3#locale_format. We add two
|
|
items to d3's date formatter: "%h" for half of
|
|
the year as a decimal number as well as "%{n}f"
|
|
for fractional seconds with n digits. For
|
|
example, *2016-10-13 09:15:23.456* with
|
|
tickformat "%H~%M~%S.%2f" would display
|
|
"09~15~23.46"
|
|
tickformatstops
|
|
A tuple of :class:`plotly.graph_objects.layout.
|
|
ternary.caxis.Tickformatstop` instances or
|
|
dicts with compatible properties
|
|
tickformatstopdefaults
|
|
When used in a template (as layout.template.lay
|
|
out.ternary.caxis.tickformatstopdefaults), sets
|
|
the default property values to use for elements
|
|
of layout.ternary.caxis.tickformatstops
|
|
ticklabelstep
|
|
Sets the spacing between tick labels as
|
|
compared to the spacing between ticks. A value
|
|
of 1 (default) means each tick gets a label. A
|
|
value of 2 means shows every 2nd label. A
|
|
larger value n means only every nth tick is
|
|
labeled. `tick0` determines which labels are
|
|
shown. Not implemented for axes with `type`
|
|
"log" or "multicategory", or when `tickmode` is
|
|
"array".
|
|
ticklen
|
|
Sets the tick length (in px).
|
|
tickmode
|
|
Sets the tick mode for this axis. If "auto",
|
|
the number of ticks is set via `nticks`. If
|
|
"linear", the placement of the ticks is
|
|
determined by a starting position `tick0` and a
|
|
tick step `dtick` ("linear" is the default
|
|
value if `tick0` and `dtick` are provided). If
|
|
"array", the placement of the ticks is set via
|
|
`tickvals` and the tick text is `ticktext`.
|
|
("array" is the default value if `tickvals` is
|
|
provided).
|
|
tickprefix
|
|
Sets a tick label prefix.
|
|
ticks
|
|
Determines whether ticks are drawn or not. If
|
|
"", this axis' ticks are not drawn. If
|
|
"outside" ("inside"), this axis' are drawn
|
|
outside (inside) the axis lines.
|
|
ticksuffix
|
|
Sets a tick label suffix.
|
|
ticktext
|
|
Sets the text displayed at the ticks position
|
|
via `tickvals`. Only has an effect if
|
|
`tickmode` is set to "array". Used with
|
|
`tickvals`.
|
|
ticktextsrc
|
|
Sets the source reference on Chart Studio Cloud
|
|
for `ticktext`.
|
|
tickvals
|
|
Sets the values at which ticks on this axis
|
|
appear. Only has an effect if `tickmode` is set
|
|
to "array". Used with `ticktext`.
|
|
tickvalssrc
|
|
Sets the source reference on Chart Studio Cloud
|
|
for `tickvals`.
|
|
tickwidth
|
|
Sets the tick width (in px).
|
|
title
|
|
:class:`plotly.graph_objects.layout.ternary.cax
|
|
is.Title` instance or dict with compatible
|
|
properties
|
|
titlefont
|
|
Deprecated: Please use
|
|
layout.ternary.caxis.title.font instead. Sets
|
|
this axis' title font. Note that the title's
|
|
font used to be customized by the now
|
|
deprecated `titlefont` attribute.
|
|
uirevision
|
|
Controls persistence of user-driven changes in
|
|
axis `min`, and `title` if in `editable: true`
|
|
configuration. Defaults to
|
|
`ternary<N>.uirevision`.
|
|
|
|
Returns
|
|
-------
|
|
plotly.graph_objs.layout.ternary.Caxis
|
|
"""
|
|
return self["caxis"]
|
|
|
|
@caxis.setter
|
|
def caxis(self, val):
|
|
self["caxis"] = val
|
|
|
|
# domain
|
|
# ------
|
|
@property
|
|
def domain(self):
|
|
"""
|
|
The 'domain' property is an instance of Domain
|
|
that may be specified as:
|
|
- An instance of :class:`plotly.graph_objs.layout.ternary.Domain`
|
|
- A dict of string/value properties that will be passed
|
|
to the Domain constructor
|
|
|
|
Supported dict properties:
|
|
|
|
column
|
|
If there is a layout grid, use the domain for
|
|
this column in the grid for this ternary
|
|
subplot .
|
|
row
|
|
If there is a layout grid, use the domain for
|
|
this row in the grid for this ternary subplot .
|
|
x
|
|
Sets the horizontal domain of this ternary
|
|
subplot (in plot fraction).
|
|
y
|
|
Sets the vertical domain of this ternary
|
|
subplot (in plot fraction).
|
|
|
|
Returns
|
|
-------
|
|
plotly.graph_objs.layout.ternary.Domain
|
|
"""
|
|
return self["domain"]
|
|
|
|
@domain.setter
|
|
def domain(self, val):
|
|
self["domain"] = val
|
|
|
|
# sum
|
|
# ---
|
|
@property
|
|
def sum(self):
|
|
"""
|
|
The number each triplet should sum to, and the maximum range of
|
|
each axis
|
|
|
|
The 'sum' property is a number and may be specified as:
|
|
- An int or float in the interval [0, inf]
|
|
|
|
Returns
|
|
-------
|
|
int|float
|
|
"""
|
|
return self["sum"]
|
|
|
|
@sum.setter
|
|
def sum(self, val):
|
|
self["sum"] = val
|
|
|
|
# uirevision
|
|
# ----------
|
|
@property
|
|
def uirevision(self):
|
|
"""
|
|
Controls persistence of user-driven changes in axis `min` and
|
|
`title`, if not overridden in the individual axes. Defaults to
|
|
`layout.uirevision`.
|
|
|
|
The 'uirevision' property accepts values of any type
|
|
|
|
Returns
|
|
-------
|
|
Any
|
|
"""
|
|
return self["uirevision"]
|
|
|
|
@uirevision.setter
|
|
def uirevision(self, val):
|
|
self["uirevision"] = val
|
|
|
|
# Self properties description
|
|
# ---------------------------
|
|
@property
|
|
def _prop_descriptions(self):
|
|
return """\
|
|
aaxis
|
|
:class:`plotly.graph_objects.layout.ternary.Aaxis`
|
|
instance or dict with compatible properties
|
|
baxis
|
|
:class:`plotly.graph_objects.layout.ternary.Baxis`
|
|
instance or dict with compatible properties
|
|
bgcolor
|
|
Set the background color of the subplot
|
|
caxis
|
|
:class:`plotly.graph_objects.layout.ternary.Caxis`
|
|
instance or dict with compatible properties
|
|
domain
|
|
:class:`plotly.graph_objects.layout.ternary.Domain`
|
|
instance or dict with compatible properties
|
|
sum
|
|
The number each triplet should sum to, and the maximum
|
|
range of each axis
|
|
uirevision
|
|
Controls persistence of user-driven changes in axis
|
|
`min` and `title`, if not overridden in the individual
|
|
axes. Defaults to `layout.uirevision`.
|
|
"""
|
|
|
|
def __init__(
|
|
self,
|
|
arg=None,
|
|
aaxis=None,
|
|
baxis=None,
|
|
bgcolor=None,
|
|
caxis=None,
|
|
domain=None,
|
|
sum=None,
|
|
uirevision=None,
|
|
**kwargs,
|
|
):
|
|
"""
|
|
Construct a new Ternary object
|
|
|
|
Parameters
|
|
----------
|
|
arg
|
|
dict of properties compatible with this constructor or
|
|
an instance of
|
|
:class:`plotly.graph_objs.layout.Ternary`
|
|
aaxis
|
|
:class:`plotly.graph_objects.layout.ternary.Aaxis`
|
|
instance or dict with compatible properties
|
|
baxis
|
|
:class:`plotly.graph_objects.layout.ternary.Baxis`
|
|
instance or dict with compatible properties
|
|
bgcolor
|
|
Set the background color of the subplot
|
|
caxis
|
|
:class:`plotly.graph_objects.layout.ternary.Caxis`
|
|
instance or dict with compatible properties
|
|
domain
|
|
:class:`plotly.graph_objects.layout.ternary.Domain`
|
|
instance or dict with compatible properties
|
|
sum
|
|
The number each triplet should sum to, and the maximum
|
|
range of each axis
|
|
uirevision
|
|
Controls persistence of user-driven changes in axis
|
|
`min` and `title`, if not overridden in the individual
|
|
axes. Defaults to `layout.uirevision`.
|
|
|
|
Returns
|
|
-------
|
|
Ternary
|
|
"""
|
|
super(Ternary, self).__init__("ternary")
|
|
|
|
if "_parent" in kwargs:
|
|
self._parent = kwargs["_parent"]
|
|
return
|
|
|
|
# Validate arg
|
|
# ------------
|
|
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.layout.Ternary
|
|
constructor must be a dict or
|
|
an instance of :class:`plotly.graph_objs.layout.Ternary`"""
|
|
)
|
|
|
|
# Handle skip_invalid
|
|
# -------------------
|
|
self._skip_invalid = kwargs.pop("skip_invalid", False)
|
|
self._validate = kwargs.pop("_validate", True)
|
|
|
|
# Populate data dict with properties
|
|
# ----------------------------------
|
|
_v = arg.pop("aaxis", None)
|
|
_v = aaxis if aaxis is not None else _v
|
|
if _v is not None:
|
|
self["aaxis"] = _v
|
|
_v = arg.pop("baxis", None)
|
|
_v = baxis if baxis is not None else _v
|
|
if _v is not None:
|
|
self["baxis"] = _v
|
|
_v = arg.pop("bgcolor", None)
|
|
_v = bgcolor if bgcolor is not None else _v
|
|
if _v is not None:
|
|
self["bgcolor"] = _v
|
|
_v = arg.pop("caxis", None)
|
|
_v = caxis if caxis is not None else _v
|
|
if _v is not None:
|
|
self["caxis"] = _v
|
|
_v = arg.pop("domain", None)
|
|
_v = domain if domain is not None else _v
|
|
if _v is not None:
|
|
self["domain"] = _v
|
|
_v = arg.pop("sum", None)
|
|
_v = sum if sum is not None else _v
|
|
if _v is not None:
|
|
self["sum"] = _v
|
|
_v = arg.pop("uirevision", None)
|
|
_v = uirevision if uirevision is not None else _v
|
|
if _v is not None:
|
|
self["uirevision"] = _v
|
|
|
|
# Process unknown kwargs
|
|
# ----------------------
|
|
self._process_kwargs(**dict(arg, **kwargs))
|
|
|
|
# Reset skip_invalid
|
|
# ------------------
|
|
self._skip_invalid = False
|