diff --git a/.circleci/config.yml b/.circleci/config.yml index e77a402dc67..9c59b013df8 100644 --- a/.circleci/config.yml +++ b/.circleci/config.yml @@ -1,5 +1,8 @@ version: 2.1 +orbs: + browser-tools: circleci/browser-tools@1.4.1 + commands: test_core: parameters: @@ -8,12 +11,22 @@ commands: type: string steps: - checkout + - browser-tools/install-chrome + - browser-tools/install-chromedriver - run: name: Install dependencies - command: "cd packages/python; sudo pip install -r ./plotly/test_requirements/requirements_<>_core.txt" + command: | + cd packages/python/plotly + python -m venv venv + . venv/bin/activate + pip install --upgrade pip wheel + pip install -r ./test_requirements/requirements_<>_core.txt - run: name: Test core - command: "cd packages/python/plotly; pytest plotly/tests/test_core" + command: | + cd packages/python/plotly + . venv/bin/activate + pytest plotly/tests/test_core no_output_timeout: 20m test_optional: @@ -23,35 +36,62 @@ commands: type: string steps: - checkout + - browser-tools/install-chrome + - browser-tools/install-chromedriver - run: name: Install dependencies - command: "cd packages/python; sudo pip install -r ./plotly/test_requirements/requirements_<>_optional.txt" + command: | + cd packages/python/plotly + python -m venv venv + . venv/bin/activate + pip install --upgrade pip wheel + pip install -r ./test_requirements/requirements_<>_optional.txt - run: name: Install plotly-geo - command: "cd packages/python/plotly-geo; sudo pip install -e ." + command: | + cd packages/python/plotly-geo + . ../plotly/venv/bin/activate + pip install -e . - run: name: Test core - command: "cd packages/python/plotly; pytest plotly/tests/test_core" + command: | + cd packages/python/plotly + . venv/bin/activate + pytest plotly/tests/test_core no_output_timeout: 20m - run: name: Test optional - command: "cd packages/python/plotly; pytest plotly/tests/test_optional" + command: | + cd packages/python/plotly + . venv/bin/activate + pytest plotly/tests/test_optional no_output_timeout: 40m - run: name: Test utils - command: "cd packages/python/plotly; pytest _plotly_utils/tests/" + command: | + cd packages/python/plotly + . venv/bin/activate + pytest _plotly_utils/tests/ no_output_timeout: 20m - run: name: Test io - command: "cd packages/python/plotly; pytest plotly/tests/test_io" + command: | + cd packages/python/plotly + . venv/bin/activate + pytest plotly/tests/test_io no_output_timeout: 20m - run: name: Test dependencdies not imported - command: "cd packages/python/plotly; pytest -x test_init/test_dependencies_not_imported.py" + command: | + cd packages/python/plotly + . venv/bin/activate + pytest -x test_init/test_dependencies_not_imported.py - run: name: Test lazy imports - command: "cd packages/python/plotly; pytest -x test_init/test_lazy_imports.py" - + command: | + cd packages/python/plotly + . venv/bin/activate + pytest -x test_init/test_lazy_imports.py test_orca: parameters: py: @@ -59,21 +99,36 @@ commands: type: string steps: - checkout + - browser-tools/install-chrome + - browser-tools/install-chromedriver - run: name: Install dependencies - command: "cd packages/python; sudo pip install -r ./plotly/test_requirements/requirements_<>_optional.txt" + command: | + cd packages/python/plotly + python -m venv venv + . venv/bin/activate + pip install --upgrade pip wheel + pip install -r ./test_requirements/requirements_<>_optional.txt - run: name: Install plotly-geo - command: "cd packages/python/plotly-geo; sudo pip install -e ." + command: | + cd packages/python/plotly-geo + . ../plotly/venv/bin/activate + pip install -e . - run: name: Install orca command: | - sudo npm install electron@1.8.4 sudo npm install orca + npm install electron@1.8.4 + npm install orca + sudo apt-get update sudo apt-get install -y poppler-utils libxtst6 xvfb libgtk2.0-0 libgconf-2-4 libnss3 libasound2 rename echo 'export PATH="/home/circleci/project/node_modules/.bin:$PATH"' >> $BASH_ENV - run: name: Test orca - command: "cd packages/python/plotly; pytest plotly/tests/test_orca" + command: | + cd packages/python/plotly + . venv/bin/activate + pytest plotly/tests/test_orca no_output_timeout: 20m - store_artifacts: path: packages/python/plotly/plotly/tests/test_orca/images/linux/failed @@ -81,42 +136,47 @@ commands: jobs: check-code-formatting: docker: - - image: circleci/python:3.7-stretch-node-browsers + - image: cimg/python:3.7 steps: - checkout - run: name: Install black - command: "sudo pip install black==22.3.0" + command: | + python -m venv venv + . venv/bin/activate + pip install black==22.3.0 - run: name: Check formatting with black - command: "black --check ." + command: | + . venv/bin/activate + black --check . --exclude venv # Core python_36_core: docker: - - image: circleci/python:3.6-stretch-node-browsers + - image: cimg/python:3.6-browsers steps: - test_core: py: "36" python_37_core: docker: - - image: circleci/python:3.7-stretch-node-browsers + - image: cimg/python:3.7-browsers steps: - test_core: py: "37" python_38_core: docker: - - image: circleci/python:3.8-buster-node-browsers + - image: cimg/python:3.8-browsers steps: - test_core: py: "38" python_39_core: docker: - - image: circleci/python:3.9-buster-node-browsers + - image: cimg/python:3.9-browsers steps: - test_core: py: "39" @@ -124,28 +184,28 @@ jobs: # Optional python_36_optional: docker: - - image: circleci/python:3.6-stretch-node-browsers + - image: cimg/python:3.6-browsers steps: - test_optional: py: "36" python_37_optional: docker: - - image: circleci/python:3.7-stretch-node-browsers + - image: cimg/python:3.7-browsers steps: - test_optional: py: "37" python_38_optional: docker: - - image: circleci/python:3.8-buster-node-browsers + - image: cimg/python:3.8-browsers steps: - test_optional: py: "38" python_39_optional: docker: - - image: circleci/python:3.9-buster-node-browsers + - image: cimg/python:3.9-browsers steps: - test_optional: py: "39" @@ -154,7 +214,7 @@ jobs: python_39_pandas_2_optional: docker: - - image: circleci/python:3.9-buster-node-browsers + - image: cimg/python:3.9-browsers steps: - test_optional: py: "39_pandas_2" @@ -162,7 +222,7 @@ jobs: # Orca python_38_orca: docker: - - image: circleci/python:3.8-buster-node-browsers + - image: cimg/python:3.8-browsers steps: - test_orca: py: "38" @@ -170,7 +230,7 @@ jobs: # Percy python_37_percy: docker: - - image: circleci/python:3.7-stretch-node-browsers + - image: cimg/python:3.9-browsers environment: PERCY_ENABLED: True PERCY_PROJECT: plotly/plotly.py @@ -178,6 +238,8 @@ jobs: steps: - checkout + - browser-tools/install-chrome + - browser-tools/install-chromedriver - run: name: Inject Percy Environment variables command: | @@ -185,43 +247,62 @@ jobs: - run: name: Install requirements command: | - sudo pip install --upgrade virtualenv - python -m venv venv || virtualenv venv + python -m venv venv . venv/bin/activate + pip install --upgrade pip wheel pip install -e ./packages/python/plotly pip install -e ./packages/python/plotly-geo - pip install -r ./packages/python/plotly/test_requirements/requirements_37_optional.txt + pip install -r ./packages/python/plotly/test_requirements/requirements_39_pandas_2_optional.txt + - run: + name: Build html figures (Pandas 2) + command: | + . venv/bin/activate + python test/percy/plotly-express.py - run: - name: Build html figures + name: Build html figures (Pandas 1) and compare command: | . venv/bin/activate + mkdir test/percy/pandas2 + mv test/percy/*.html test/percy/pandas2/ + # 1.1 is the earliest minor with Py3.9 wheels + pip install "pandas==1.1.5" python test/percy/plotly-express.py + python test/percy/compare-pandas.py + rm -rf test/percy/pandas2 - run: name: Run percy snapshots command: | npm i @percy/cli - npx percy snapshot test/percy/ + npx percy snapshot -c test/percy/snapshots.yml test/percy/ rm test/percy/*.html # Chart studio python_37_chart_studio: docker: - - image: circleci/python:3.7-stretch-node-browsers + - image: cimg/python:3.7 resource_class: large steps: - checkout - run: name: Install dependencies - command: "cd packages/python; sudo pip install -r ./chart-studio/test_requirements/requirements_37.txt" + command: | + cd packages/python/chart-studio + python -m venv venv + . venv/bin/activate + pip install --upgrade pip wheel + pip install -r ./test_requirements/requirements_37.txt - run: name: Tests - command: "cd packages/python/chart-studio; pytest -x chart_studio/tests/" + command: | + cd packages/python/chart-studio + . venv/bin/activate + pytest -x chart_studio/tests/ no_output_timeout: 20m plotlyjs_dev_build: docker: - - image: circleci/python:3.7-stretch-node-browsers + - image: cimg/python:3.7-node environment: LANG: en_US.UTF-8 resource_class: large @@ -230,16 +311,32 @@ jobs: - checkout - run: name: Install dependencies - command: "cd packages/python; sudo pip install -r ./plotly/test_requirements/requirements_37_core.txt black inflect; sudo pip install jupyterlab~=3.0" + command: | + cd packages/python/plotly + python -m venv venv + . venv/bin/activate + pip install --upgrade pip wheel + pip install -r ./test_requirements/requirements_37_core.txt black inflect + pip install jupyterlab~=3.0 - run: name: Update jupyterlab-plotly version - command: "cd packages/python/plotly; python setup.py updateplotlywidgetversion" + command: | + cd packages/python/plotly + . venv/bin/activate + python setup.py updateplotlywidgetversion - run: name: Update plotly.js to dev - command: "cd packages/python/plotly; python setup.py updateplotlyjsdev" + command: | + cd packages/python/plotly + . venv/bin/activate + python setup.py updateplotlyjsdev - run: name: Test core - command: "cd packages/python/plotly; locale; pytest -k 'not nodev' plotly/tests/test_core" + command: | + cd packages/python/plotly + . venv/bin/activate + locale + pytest -k 'not nodev' plotly/tests/test_core no_output_timeout: 20m - run: name: Commit @@ -254,6 +351,7 @@ jobs: name: Build source distribution packages command: | cd packages/python/plotly + . venv/bin/activate python setup.py sdist when: always - store_artifacts: @@ -273,7 +371,7 @@ jobs: name: Create conda environment command: | conda create -n env --yes python=3.9 conda-build conda-verify - conda install -n env -c conda-forge jupyterlab nodejs=18 + conda install -n env -c conda-forge jupyterlab=3 nodejs=16 conda init bash mkdir output @@ -334,8 +432,8 @@ jobs: resource_class: xlarge docker: # specify the version you desire here - # use `-browsers` prefix for selenium tests, e.g. `3.6.1-browsers` - - image: circleci/python:3.7-stretch-node-browsers + # use `-browsers` prefix for selenium tests, for example, `3.6.1-browsers` + - image: cimg/python:3.7-browsers steps: - add_ssh_keys: @@ -346,37 +444,38 @@ jobs: # Download and cache dependencies - restore_cache: - keys: - - v1-dependencies-{{ checksum "doc/requirements.txt" }} - # fallback to using the latest cache if no exact match is found - - v1-dependencies- + key: v1-dependencies-{{ checksum "doc/requirements.txt" }}-{{ checksum ".circleci/config.yml" }} + - browser-tools/install-chrome + - browser-tools/install-chromedriver - run: name: install dependencies command: | cd doc - python3 -m venv venv + python -m venv venv . venv/bin/activate - npm install electron@1.8.4 - npm install orca - pip install -U pip + pip install --upgrade pip wheel pip uninstall -y plotly pip install -r requirements.txt if [ "${CIRCLE_BRANCH}" != "doc-prod" ]; then pip uninstall -y plotly - cd ../packages/python/plotly - pip install -e . - cd ../../../doc + pip install -e ../packages/python/plotly fi - echo 'export PATH="/home/circleci/project/doc/node_modules/.bin:$PATH"' >> $BASH_ENV - sudo apt-get install -y poppler-utils libxtst6 xvfb libgtk2.0-0 libgconf-2-4 libnss3 libasound2 rename cd .. + - run: + name: Install orca + command: | + npm install electron@1.8.4 + npm install orca + sudo apt-get update + sudo apt-get install -y poppler-utils libxtst6 xvfb libgtk2.0-0 libgconf-2-4 libnss3 libasound2 rename + echo 'export PATH="/home/circleci/project/node_modules/.bin:$PATH"' >> $BASH_ENV - save_cache: paths: - ./doc/venv - ./doc/node_modules - key: v1-dependencies-{{ checksum "doc/requirements.txt" }} + key: v1-dependencies-{{ checksum "doc/requirements.txt" }}-{{ checksum ".circleci/config.yml" }} - run: name: make html diff --git a/.gitignore b/.gitignore index 96e2fdf38d7..ccfd2b4e518 100644 --- a/.gitignore +++ b/.gitignore @@ -52,3 +52,6 @@ doc/check-or-enforce-order.py packages/javascript/jupyterlab-plotly/lib/ packages/python/plotly/jupyterlab_plotly/labextension/ packages/python/plotly/jupyterlab_plotly/nbextension/index.js* + +test/percy/*.html +test/percy/pandas2/*.html diff --git a/CHANGELOG.md b/CHANGELOG.md index 0019b2ccc65..67cdd158bb2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,34 @@ All notable changes to this project will be documented in this file. This project adheres to [Semantic Versioning](http://semver.org/). +## [5.15.0] - 2023-06-08 + +### Updated + - Updated Plotly.js from version 2.20.0 to version 2.24.1. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/master/CHANGELOG.md#2241----2023-06-07) for more information. Notable changes include: + - Add pattern to pie, funnelarea, sunburst, icicle and treemap traces [[#6601](https://github.com/plotly/plotly.js/pull/6601), [#6619](https://github.com/plotly/plotly.js/pull/6619), [#6622](https://github.com/plotly/plotly.js/pull/6622), [#6626](https://github.com/plotly/plotly.js/pull/6626), [#6627](https://github.com/plotly/plotly.js/pull/6627), [#6628](https://github.com/plotly/plotly.js/pull/6628), [#6629](https://github.com/plotly/plotly.js/pull/6629)], with thanks to @thierryVergult for the contribution! + - Add `texttemplate` to shape.label for parametric shapes i.e. line, rect and circle [[#6527](https://github.com/plotly/plotly.js/pull/6527)], + with thanks to the [Volkswagen](https://www.volkswagenag.com) Center of Excellence for Battery Systems for sponsoring development! + - Add strict option to custom bundle command [[#6557](https://github.com/plotly/plotly.js/pull/6557)], + with thanks to @CallumNZ for the contribution! + - Add `legend` references to traces and `legend2`, `legend3`, etc. to layout, + also add `visible` to legend i.e. to allow positioning multiple legends on a graph [[#6535](https://github.com/plotly/plotly.js/pull/6535)], + this feature was anonymously sponsored: thank you to our sponsor! + - Add `legend.xref` and `legend.yref` to enable container-referenced positioning of legends [[#6589](https://github.com/plotly/plotly.js/pull/6589)], with thanks to [Gamma Technologies](https://www.gtisoft.com/) for sponsoring the related development. + - Add `colorbar.xref` and `colorbar.yref` to enable container-referenced positioning of colorbars [[#6593](https://github.com/plotly/plotly.js/pull/6593)], with thanks to [Gamma Technologies](https://www.gtisoft.com/) for sponsoring the related development. + - `px` methods now accept data-frame-like objects that support a `to_pandas()` method, such as polars, cudf, vaex etc + +### Fixed + - Fixed another compatibility issue with Pandas 2.0, just affecting `px.*(line_close=True)` [[#4190](https://github.com/plotly/plotly.py/pull/4190)] + - Empty pandas dataframe with facet row/column set no longer fails [[#4038](https://github.com/plotly/plotly.py/pull/4038)] + - Added some rounding to the `make_subplots` function to handle situations where the user-input specs cause the domain to exceed 1 by small amounts [[#4153](https://github.com/plotly/plotly.py/pull/4153)] + - Sanitize JSON output to prevent an XSS vector when graphs are inserted directly into HTML [[#4196](https://github.com/plotly/plotly.py/pull/4196)] + - Fixed issue with shapes and annotations plotting on the wrong y axis when supplied with a specific axis in the `yref` parameter [[#4177](https://github.com/plotly/plotly.py/pull/4177)] + - Remove `use_2to3` setuptools arg, which is invalid in the latest Python and setuptools versions [[#4206](https://github.com/plotly/plotly.py/pull/4206)] + - Fix [#4066](https://github.com/plotly/plotly.py/issues/4066) JupyterLab v4 giving tiny default graph height [[#4227](https://github.com/plotly/plotly.py/pull/4227)] + - Fixed issue with `colors.n_colors` where generated RGB color values were not being constrained to stay between 0 and 255 [[#4110](https://github.com/plotly/plotly.py/pull/4110)] + - Fix streamline figure factory with recent versions of Numpy + - Fix issue with shapes and annotations not drawing on correct axis [[#4177](https://github.com/plotly/plotly.py/pull/4177)] + ## [5.14.1] - 2023-04-05 ### Fixed @@ -10,7 +38,7 @@ This project adheres to [Semantic Versioning](http://semver.org/). ## [5.14.0] - 2023-03-29 ### Updated - - Updated Plotly.js to from version 2.18.2 to version 2.20.0. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/master/CHANGELOG.md#2200----2023-03-15) for more information. Notable changes include: + - Updated Plotly.js from version 2.18.2 to version 2.20.0. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/master/CHANGELOG.md#2200----2023-03-15) for more information. Notable changes include: - Add `title.automargin` to enable automatic top and bottom margining for both container and paper referenced titles [[#6428](https://github.com/plotly/plotly.js/pull/6428)], with thanks to [Gamma Technologies](https://www.gtisoft.com/) for sponsoring the related development. - Add `label` attribute to shapes [[#6454](https://github.com/plotly/plotly.js/pull/6454)], with thanks to the [Volkswagen](https://www.volkswagenag.com) Center of Excellence for Battery Systems for sponsoring development! diff --git a/README.md b/README.md index b0a96b037eb..6eb74df70d5 100644 --- a/README.md +++ b/README.md @@ -33,7 +33,7 @@ ## Quickstart -`pip install plotly==5.14.1` +`pip install plotly==5.15.0` Inside [Jupyter](https://jupyter.org/install) (installable with `pip install "jupyterlab>=3" "ipywidgets>=7.6"`): @@ -78,13 +78,13 @@ Built on top of [plotly.js](https://github.com/plotly/plotly.js), `plotly.py` is plotly.py may be installed using pip... ``` -pip install plotly==5.14.1 +pip install plotly==5.15.0 ``` or conda. ``` -conda install -c plotly plotly=5.14.1 +conda install -c plotly plotly=5.15.0 ``` ### JupyterLab Support @@ -106,7 +106,7 @@ The instructions above apply to JupyterLab 3.x. **For JupyterLab 2 or earlier**, ``` # JupyterLab 2.x renderer support -jupyter labextension install jupyterlab-plotly@5.14.1 @jupyter-widgets/jupyterlab-manager +jupyter labextension install jupyterlab-plotly@5.15.0 @jupyter-widgets/jupyterlab-manager ``` Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab. diff --git a/binder/requirements.txt b/binder/requirements.txt index 5e41a8749fb..814d0417bc3 100644 --- a/binder/requirements.txt +++ b/binder/requirements.txt @@ -1,5 +1,5 @@ jupytext -plotly==5.14.1 +plotly==5.15.0 jupyter notebook pandas==1.0.3 diff --git a/doc/apidoc/conf.py b/doc/apidoc/conf.py index 2057b92e39a..6793413bcb7 100644 --- a/doc/apidoc/conf.py +++ b/doc/apidoc/conf.py @@ -28,7 +28,7 @@ # The short X.Y version version = "" # The full version, including alpha/beta/rc tags -release = "5.14.1" +release = "5.15.0" # -- General configuration --------------------------------------------------- diff --git a/doc/python/colorscales.md b/doc/python/colorscales.md index 7eb05ccc421..fe2ac574227 100644 --- a/doc/python/colorscales.md +++ b/doc/python/colorscales.md @@ -20,7 +20,7 @@ jupyter: name: python nbconvert_exporter: python pygments_lexer: ipython3 - version: 3.10.9 + version: 3.10.11 plotly: description: How to set, create and control continuous color scales and color bars in scatter, bar, map and heatmap figures. @@ -632,6 +632,36 @@ fig = go.Figure(go.Heatmap( fig.show() ``` +### Positioning Colorbars + +Colorbars can be positioned by specifying x and y coordinates. By default, the x and y values are "paper" coordinates, which refer to the plot area. You can also use coordinates based on the "container" by setting `xref="container"` or `yref="container"`. The following example uses a container reference for the x position. + +See the positioning section of [the figure data structure page](/python/figure-structure/#positioning-with-paper-container-coordinates-or-axis-domain-coordinates) for more details on "paper" vs "container" coordinates. + +```python +import plotly.graph_objects as go + +import urllib +import json + +# Load heatmap data +response = urllib.request.urlopen( + "https://raw.githubusercontent.com/plotly/datasets/master/custom_heatmap_colorscale.json") +dataset = json.load(response) + +# Create and show figure +fig = go.Figure(go.Heatmap( + z=dataset["z"], + colorbar=dict( + x=0.2, + xref="container", + title="Surface Heat" + ) +)) + +fig.show() +``` + ### Reference See https://plotly.com/python/reference/ for more information and chart attribute options! diff --git a/doc/python/funnel-charts.md b/doc/python/funnel-charts.md index bb769ed965a..f22067be3cf 100644 --- a/doc/python/funnel-charts.md +++ b/doc/python/funnel-charts.md @@ -5,10 +5,10 @@ jupyter: text_representation: extension: .md format_name: markdown - format_version: '1.2' - jupytext_version: 1.3.0 + format_version: '1.3' + jupytext_version: 1.14.6 kernelspec: - display_name: Python 3 + display_name: Python 3 (ipykernel) language: python name: python3 plotly: @@ -200,6 +200,28 @@ fig.update_layout( fig.show() ``` +### Pattern Fills + +*New in 5.15* + +Funnel area charts support [patterns](/python/pattern-hatching-texture/) (also known as hatching or texture) in addition to color. In this example, we add a pattern to the second stage of the funnel. + +```python +from plotly import graph_objects as go + +colors = ["gold", "gold", "lightgreen", "lavender"] + +fig = go.Figure( + go.Funnelarea( + labels=["Interview 1", "Interview 2", "Test", "Final Stage"], + values=[100, 70, 40, 20], + textfont_size=20, + marker=dict(colors=colors, pattern=dict(shape=["", "/", "", ""])), + ) +) +fig.show() +``` + #### Reference See [function reference for `px.(funnel)`](https://plotly.com/python-api-reference/generated/plotly.express.funnel) or https://plotly.com/python/reference/funnel/ and https://plotly.com/python/reference/funnelarea/ for more information and chart attribute options! diff --git a/doc/python/getting-started.md b/doc/python/getting-started.md index 1a971bc46fb..24fecf41317 100644 --- a/doc/python/getting-started.md +++ b/doc/python/getting-started.md @@ -58,13 +58,13 @@ We also encourage you to join the [Plotly Community Forum](http://community.plot `plotly` may be installed using `pip`: ``` -$ pip install plotly==5.14.1 +$ pip install plotly==5.15.0 ``` or `conda`: ``` -$ conda install -c plotly plotly=5.14.1 +$ conda install -c plotly plotly=5.15.0 ``` This package contains everything you need to write figures to standalone HTML files. @@ -152,7 +152,7 @@ The instructions above apply to JupyterLab 3.x. **For JupyterLab 2 or earlier**, ``` # JupyterLab 2.x renderer support -jupyter labextension install jupyterlab-plotly@5.14.1 @jupyter-widgets/jupyterlab-manager +jupyter labextension install jupyterlab-plotly@5.15.0 @jupyter-widgets/jupyterlab-manager ``` Please check out our [Troubleshooting guide](/python/troubleshooting/) if you run into any problems with JupyterLab, particularly if you are using multiple python environments inside Jupyter. diff --git a/doc/python/icicle-charts.md b/doc/python/icicle-charts.md index 8ff9688ca06..ea6eeb0653c 100644 --- a/doc/python/icicle-charts.md +++ b/doc/python/icicle-charts.md @@ -5,10 +5,10 @@ jupyter: text_representation: extension: .md format_name: markdown - format_version: '1.2' - jupytext_version: 1.4.2 + format_version: '1.3' + jupytext_version: 1.14.6 kernelspec: - display_name: Python 3 + display_name: Python 3 (ipykernel) language: python name: python3 language_info: @@ -20,7 +20,7 @@ jupyter: name: python nbconvert_exporter: python pygments_lexer: ipython3 - version: 3.7.7 + version: 3.10.11 plotly: description: How to make Icicle Charts. display_as: basic @@ -418,6 +418,30 @@ fig.update_layout(margin = dict(t=50, l=25, r=25, b=25)) fig.show() ``` +### Pattern Fills + +*New in 5.15* + +Icicle charts support [patterns](/python/pattern-hatching-texture/) (also known as hatching or texture) in addition to color. In this example, we apply a pattern to all chart sections. We also configure the `size` and `solidity` of the pattern. + +```python +import plotly.graph_objects as go + +fig = go.Figure( + go.Icicle( + labels=["Eve", "Cain", "Seth", "Enos", "Noam", "Abel", "Awan", "Enoch", "Azura"], + parents=["", "Eve", "Eve", "Seth", "Seth", "Eve", "Eve", "Awan", "Eve"], + values=[10, 14, 12, 10, 2, 6, 6, 4, 4], + root_color="lightgrey", + textfont_size=20, + marker=dict(pattern=dict(shape="|", size=5, solidity=0.9)), + ) +) + +fig.update_layout(margin=dict(t=50, l=25, r=25, b=25)) +fig.show() +``` + ### Set the Direction of Icicle charts As mentioned above, Icicle charts can grow in one of four directions. Icicle charts have a `tiling` attribute and this has two attributes: `orientation` and `flip`. `orientation` takes either `h` (horiztonal) or `v` (vertical) and `flip` takes either `x` or `y`. You can use these two attributes in combination to create each of the four cardinal directions: left, right, top, bottom. diff --git a/doc/python/legend.md b/doc/python/legend.md index f18225a9526..9ca47748be1 100644 --- a/doc/python/legend.md +++ b/doc/python/legend.md @@ -6,7 +6,7 @@ jupyter: extension: .md format_name: markdown format_version: '1.3' - jupytext_version: 1.14.1 + jupytext_version: 1.14.5 kernelspec: display_name: Python 3 (ipykernel) language: python @@ -20,7 +20,7 @@ jupyter: name: python nbconvert_exporter: python pygments_lexer: ipython3 - version: 3.8.0 + version: 3.10.11 plotly: description: How to configure and style the legend in Plotly with Python. display_as: file_settings @@ -574,6 +574,107 @@ fig.update_layout(width=600, title_text='Exploration of a vector field using sev fig.show() ``` +### Adding Multiple Legends + +*New in 5.15* + +By default, all traces appear on one legend. To have multiple legends, specify an alternative legend for a trace using the `legend` property. For a second legend, set `legend="legend2"`. Specify more legends with `legend="legend3"`, `legend="legend4"` and so on. + +In this example, the last two scatter traces display on the second legend, "legend2". On the figure's layout, we then position and style this legend to display on the right of the graph below the first legend. + + +```python +import plotly.graph_objects as go +from plotly import data + +df = data.gapminder() + +df_germany = df.loc[(df.country.isin(["Germany"]))] +df_france = df.loc[(df.country.isin(["France"]))] +df_uk = df.loc[(df.country.isin(["United Kingdom"]))] + + +df_averages_europe = ( + df.loc[(df.continent.isin(["Europe"]))].groupby(by="year").mean(numeric_only=True) +) +df_averages_americas = ( + df.loc[(df.continent.isin(["Americas"]))].groupby(by="year").mean(numeric_only=True) +) + + +fig = go.Figure( + data=[ + go.Scatter(x=df_germany.year, y=df_germany.gdpPercap, name="Germany"), + go.Scatter(x=df_france.year, y=df_france.gdpPercap, name="France"), + go.Scatter(x=df_uk.year, y=df_uk.gdpPercap, name="UK"), + go.Scatter( + x=df_averages_europe.index, + y=df_averages_europe.gdpPercap, + name="Europe", + legend="legend2", + ), + go.Scatter( + x=df_averages_americas.index, + y=df_averages_americas.gdpPercap, + name="Americas", + legend="legend2", + ), + ], + layout=dict( + title="GDP Per Capita", + legend={"title": "By country", "bgcolor": "Orange",}, + legend2={ + "x": 1.155, + "y": 0.55, + "xanchor": "right", + "yanchor": "middle", + "bgcolor": "Gold", + "title": {"text": "By continent"}, + }, + ), +) + +fig.show() + +``` + +### Positioning Legends + +In the previous example, we position the second legend by specifying x and y values. By default, these values are based on the width and height of the plot area. It is also possible to specify values that reference the container width and height by setting "xref=container" and "yref="container" (the default values are "xref=paper" and "yref="paper"). When set to "container", the margin grows so the legend and plot don't overlap. + +```python +import plotly.graph_objects as go +from plotly import data + +df = data.gapminder() + +df_germany = df.loc[(df.country.isin(["Germany"]))] +df_france = df.loc[(df.country.isin(["France"]))] +df_uk = df.loc[(df.country.isin(["United Kingdom"]))] + +fig = go.Figure( + data=[ + go.Scatter(x=df_germany.year, y=df_germany.gdpPercap, name="Germany"), + go.Scatter(x=df_france.year, y=df_france.gdpPercap, name="France"), + go.Scatter(x=df_uk.year, y=df_uk.gdpPercap, name="UK"), + ], + layout=dict( + title="GDP Per Capita", + legend={ + "x": 0.9, + "y": 0.9, + "xref": "container", + "yref": "container", + "bgcolor": "Gold", + "title": {"text": "By continent"}, + }, + ), +) + +fig.show() + +``` + #### Reference See https://plotly.com/python/reference/layout/#layout-legend for more information! diff --git a/doc/python/pattern-hatching-texture.md b/doc/python/pattern-hatching-texture.md index f9bc0270365..25d77571631 100644 --- a/doc/python/pattern-hatching-texture.md +++ b/doc/python/pattern-hatching-texture.md @@ -6,7 +6,7 @@ jupyter: extension: .md format_name: markdown format_version: '1.3' - jupytext_version: 1.13.7 + jupytext_version: 1.14.6 kernelspec: display_name: Python 3 (ipykernel) language: python @@ -20,7 +20,7 @@ jupyter: name: python nbconvert_exporter: python pygments_lexer: ipython3 - version: 3.9.7 + version: 3.10.11 plotly: description: How to use patterns (also known as hatching or texture) with bar charts. @@ -34,9 +34,9 @@ jupyter: thumbnail: thumbnail/pattern.png --- -*New in v5.0* +*New in 5.0, with support for pie, sunburst, icicle, funnelarea, and treemap charts in 5.15* -[Bar charts](/python/bar-charts/), [histograms](/python/histograms/), [polar bar charts](/python/wind-rose-charts/) and [area charts](/python/filled-area-plots/) have large markers or areas which support not only a fill color, but also an optional **pattern** (also known as "hatching" or "texture"). This can be used for a variety of reasons: +[Bar charts](/python/bar-charts/), [histograms](/python/histograms/), [polar bar charts](/python/wind-rose-charts/), [area charts](/python/filled-area-plots/), [pie charts](/python/pie-charts), [sunburst charts](/python/sunburst-charts), [funnelarea charts](/python/funnel-charts), [icicle charts](/python/icicle-charts/), and [treemap charts](/python/treemaps), have large markers or areas which support not only a fill color, but also an optional **pattern** (also known as "hatching" or "texture"). This can be used for a variety of reasons: * to double-encode variables (i.e. using both color and pattern) to improve accessibility for visually-impaired end-users * to encode an additional variable beyond just using color @@ -79,7 +79,7 @@ In the charts above, the first value of the variable assigned `pattern_shape` ge Here we use `pattern_shape_sequence` to replace the defaults and include a pattern-shape for the first variable: -```python tags=[] +```python import plotly.express as px df = px.data.medals_long() diff --git a/doc/python/pie-charts.md b/doc/python/pie-charts.md index 8564822091e..dc44c094b1f 100644 --- a/doc/python/pie-charts.md +++ b/doc/python/pie-charts.md @@ -6,9 +6,9 @@ jupyter: extension: .md format_name: markdown format_version: '1.3' - jupytext_version: 1.14.1 + jupytext_version: 1.14.6 kernelspec: - display_name: Python 3 + display_name: Python 3 (ipykernel) language: python name: python3 language_info: @@ -20,7 +20,7 @@ jupyter: name: python nbconvert_exporter: python pygments_lexer: ipython3 - version: 3.8.8 + version: 3.10.11 plotly: description: How to make Pie Charts. display_as: basic @@ -300,6 +300,33 @@ fig.update_layout(title_text='World GDP') fig.show() ``` +### Pattern Fills + +*New in 5.15* + +Pie charts support [patterns](/python/pattern-hatching-texture/) (also known as hatching or texture) in addition to color. + +```python +import plotly.graph_objects as go + +labels = ["Oxygen", "Hydrogen", "Carbon_Dioxide", "Nitrogen"] +values = [4500, 2500, 1053, 500] +colors = ["gold", "mediumturquoise", "darkorange", "lightgreen"] + +fig = go.Figure( + data=[ + go.Pie( + labels=labels, + values=values, + textfont_size=20, + marker=dict(colors=colors, pattern=dict(shape=[".", "x", "+", "-"])) + ) + ] +) + +fig.show() +``` + ### See Also: Sunburst charts For multilevel pie charts representing hierarchical data, you can use the `Sunburst` chart. A simple example is given below, for more information see the [tutorial on Sunburst charts](/python/sunburst-charts/). diff --git a/doc/python/shapes.md b/doc/python/shapes.md index 54c122dba0d..f44c6050c48 100644 --- a/doc/python/shapes.md +++ b/doc/python/shapes.md @@ -20,7 +20,7 @@ jupyter: name: python nbconvert_exporter: python pygments_lexer: ipython3 - version: 3.10.9 + version: 3.8.8 plotly: description: How to make SVG shapes in python. Examples of lines, circle, rectangle, and path. @@ -913,5 +913,91 @@ fig.add_shape( fig.show() ``` +#### Variables in Shape Label Text + +*New in 5.15* + +Use `texttemplate` to add text with variables to shapes. `texttemplate` uses d3 number and date formatting and supports raw variables, which use the raw data from the shape definition, and some calculated variables. Add a variable with "%{variable}". + +This example adds the raw variables `x0` and `y0` to a rectangle and shows the calculated variables `height`, `slope`, and `width` on three other shapes. + +For a complete list of available variables, see the [Shape Reference Docs](https://plotly.com/python/reference/layout/shapes/). + + +```python +import plotly.graph_objects as go + +fig = go.Figure() + +fig.add_shape( + type="rect", + fillcolor="MediumSlateBlue", + x0=-0.5, + y0=-0.5, + x1=1, + y1=1, + label=dict( + texttemplate="x0 is %{x0:.3f}, y0 is %{y0:.3f}", font=dict(color="DarkOrange") + ), +) + +fig.add_shape( + type="rect", + fillcolor="LightGreen", + x0=1, + y0=1.75, + x1=2.25, + y1=3, + label=dict(texttemplate="Height: %{height:.3f}", font=dict(color="DarkOrange")), +) +fig.add_shape( + type="line", + x0=3, + y0=0.5, + x1=5, + y1=0.8, + line_width=3, + label=dict(texttemplate="Slope: %{slope:.3f}", font=dict(size=20)), +) +fig.add_shape( + type="rect", + fillcolor="Lavender", + x0=2.5, + y0=2.5, + x1=5, + y1=3.5, + label=dict( + texttemplate="Width: %{width:.3f}", + font=dict(family="Courier New, monospace", size=20), + ), +) + +fig.show() + +``` + +#### Variables in Shape Label Text for New Shapes + +*New in 5.15* + +Use `texttemplate` to add text with variables to new shapes drawn on the graph. This example figure is configured to allow the user to draw lines and automatically labels each line with its slope. Select **Draw line** in the modebar to try it out. + +```python +import plotly.graph_objects as go + +fig = go.Figure( + layout=go.Layout(newshape=dict(label=dict(texttemplate="Slope: %{slope:.3f}"))) +) + +fig.show( + config={ + "modeBarButtonsToAdd": [ + "drawline", + ] + } +) + +``` + ### Reference See https://plotly.com/python/reference/layout/shapes/ for more information and chart attribute options! diff --git a/doc/python/static-image-export.md b/doc/python/static-image-export.md index 2d5795efb0b..48bb28366ae 100644 --- a/doc/python/static-image-export.md +++ b/doc/python/static-image-export.md @@ -109,42 +109,42 @@ If you are running this notebook live, click to [open the output directory](./im plotly.py can output figures to several raster image formats including **PNG**, ... -```python +~~~python fig.write_image("images/fig1.png") -``` +~~~ **JPEG**, ... -```python +~~~python fig.write_image("images/fig1.jpeg") -``` +~~~ and **WebP** -```python +~~~python fig.write_image("images/fig1.webp") -``` +~~~ #### Vector Formats: SVG and PDF... plotly.py can also output figures in several vector formats including **SVG**, ... -```python +~~~python fig.write_image("images/fig1.svg") -``` +~~~ **PDF**, ... -```python +~~~python fig.write_image("images/fig1.pdf") -``` +~~~ and **EPS** (requires the poppler library) -```python +~~~python fig.write_image("images/fig1.eps") -``` +~~~ **Note:** It is important to note that any figures containing WebGL traces (i.e. of type `scattergl`, `heatmapgl`, `contourgl`, `scatter3d`, `surface`, `mesh3d`, `scatterpolargl`, `cone`, `streamtube`, `splom`, or `parcoords`) that are exported in a vector format will include encapsulated rasters, instead of vectors, for some parts of the image. @@ -199,14 +199,14 @@ Image(img_bytes) If `kaleido` is installed, it will automatically be used to perform image export. If it is not installed, plotly.py will attempt to use `orca` instead. The `engine` argument to the `to_image` and `write_image` functions can be used to override this default behavior. Here is an example of specifying that orca should be used: -```python +~~~python fig.to_image(format="png", engine="orca") -``` +~~~ And, here is an example of specifying that Kaleido should be used: -```python +~~~python fig.to_image(format="png", engine="kaleido") -``` +~~~ diff --git a/doc/python/sunburst-charts.md b/doc/python/sunburst-charts.md index 521e6d254cb..5e589e438fe 100644 --- a/doc/python/sunburst-charts.md +++ b/doc/python/sunburst-charts.md @@ -5,10 +5,10 @@ jupyter: text_representation: extension: .md format_name: markdown - format_version: '1.2' - jupytext_version: 1.4.2 + format_version: '1.3' + jupytext_version: 1.14.6 kernelspec: - display_name: Python 3 + display_name: Python 3 (ipykernel) language: python name: python3 language_info: @@ -20,7 +20,7 @@ jupyter: name: python nbconvert_exporter: python pygments_lexer: ipython3 - version: 3.7.7 + version: 3.10.11 plotly: description: How to make Sunburst Charts. display_as: basic @@ -300,6 +300,36 @@ fig.update_layout(uniformtext=dict(minsize=10, mode='hide')) fig.show() ``` +### Pattern Fills + +*New in 5.15* + +Sunburst charts support [patterns](/python/pattern-hatching-texture/) (also known as hatching or texture) in addition to color. In this example, we add a different pattern to each level of the hierarchy. We also specify the `solidity` of the pattern. + +```python +import plotly.graph_objects as go + +fig = go.Figure( + go.Sunburst( + labels=["Eve", "Cain", "Seth", "Enos", "Noam", "Abel", "Awan", "Enoch", "Azura"], + parents=["", "Eve", "Eve", "Seth", "Seth", "Eve", "Eve", "Awan", "Eve"], + values=[65, 14, 12, 10, 2, 6, 6, 4, 4], + branchvalues="total", + textfont_size=16, + marker=dict( + pattern=dict( + shape=["", "/", "/", ".", ".", "/", "/", ".", "/"], solidity=0.9 + ) + ), + ) +) + +fig.update_layout(margin=dict(t=0, l=0, r=0, b=0)) + +fig.show() + +``` + ### Sunburst chart with a continuous colorscale The example below visualizes a breakdown of sales (corresponding to sector width) and call success rate (corresponding to sector color) by region, county and salesperson level. For example, when exploring the data you can see that although the East region is behaving poorly, the Tyler county is still above average -- however, its performance is reduced by the poor success rate of salesperson GT. diff --git a/doc/python/treemaps.md b/doc/python/treemaps.md index 94254e9b238..b86636e01df 100644 --- a/doc/python/treemaps.md +++ b/doc/python/treemaps.md @@ -6,7 +6,7 @@ jupyter: extension: .md format_name: markdown format_version: '1.3' - jupytext_version: 1.14.1 + jupytext_version: 1.14.6 kernelspec: display_name: Python 3 (ipykernel) language: python @@ -20,7 +20,7 @@ jupyter: name: python nbconvert_exporter: python pygments_lexer: ipython3 - version: 3.8.0 + version: 3.10.11 plotly: description: How to make Treemap Charts with Plotly display_as: basic @@ -423,6 +423,28 @@ fig.update_layout( fig.show() ``` +### Pattern Fills + +*New in 5.15* + +Treemap charts support [patterns](/python/pattern-hatching-texture/) (also known as hatching or texture) in addition to color. In this example, we apply a pattern to the root node. + +```python +import plotly.graph_objects as go + +fig = go.Figure( + go.Treemap( + labels = ["Eve","Cain", "Seth", "Enos", "Noam", "Abel", "Awan", "Enoch", "Azura"], + parents=["", "Eve", "Eve", "Seth", "Seth", "Eve", "Eve", "Awan", "Eve"], + root_color="lightgrey", + textfont_size=20, + marker=dict(pattern=dict(shape=["|"], solidity=0.80)), + ) +) + +fig.show() +``` + #### Reference See [function reference for `px.treemap()`](https://plotly.com/python-api-reference/generated/plotly.express.treemap) or https://plotly.com/python/reference/treemap/ for more information and chart attribute options! diff --git a/doc/requirements.txt b/doc/requirements.txt index 0d4507d0bb6..038ce54d8ed 100644 --- a/doc/requirements.txt +++ b/doc/requirements.txt @@ -1,4 +1,4 @@ -plotly==5.14.1 +plotly==5.15.0 jupytext==1.1.1 ipywidgets==7.7.2 jupyter-client<7 diff --git a/packages/javascript/jupyterlab-plotly/package-lock.json b/packages/javascript/jupyterlab-plotly/package-lock.json index aed60d423d2..149e832c077 100644 --- a/packages/javascript/jupyterlab-plotly/package-lock.json +++ b/packages/javascript/jupyterlab-plotly/package-lock.json @@ -1,12 +1,12 @@ { "name": "jupyterlab-plotly", - "version": "5.14.1", + "version": "5.15.0", "lockfileVersion": 2, "requires": true, "packages": { "": { "name": "jupyterlab-plotly", - "version": "5.14.1", + "version": "5.15.0", "license": "MIT", "dependencies": { "@jupyter-widgets/base": ">=2.0.0 <7.0.0", @@ -14,7 +14,7 @@ "@lumino/messaging": "^1.2.3", "@lumino/widgets": "^1.8.1", "lodash": "^4.17.4", - "plotly.js": "^2.20.0" + "plotly.js": "^2.24.1" }, "devDependencies": { "@jupyterlab/builder": "^3.0.0", @@ -1161,14 +1161,6 @@ "node": ">=4" } }, - "node_modules/arr-flatten": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/arr-flatten/-/arr-flatten-1.1.0.tgz", - "integrity": "sha512-L3hKV5R/p5o81R7O02IGnwpDmkp6E982XhtbuwSe3O4qOtMMMtodicASA1Cny2U+aCXcNpml+m4dPsvsJ3jatg==", - "engines": { - "node": ">=0.10.0" - } - }, "node_modules/array-bounds": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/array-bounds/-/array-bounds-1.0.1.tgz", @@ -1209,11 +1201,6 @@ "node": ">= 4.0.0" } }, - "node_modules/atob-lite": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/atob-lite/-/atob-lite-2.0.0.tgz", - "integrity": "sha512-LEeSAWeh2Gfa2FtlQE1shxQ8zi5F9GHarrGKz08TMdODD5T4eH6BMsvtnhbWZ+XQn+Gb6om/917ucvRu7l7ukw==" - }, "node_modules/backbone": { "version": "1.2.3", "resolved": "https://registry.npmjs.org/backbone/-/backbone-1.2.3.tgz", @@ -1598,18 +1585,6 @@ "integrity": "sha1-3dgA2gxmEnOTzKWVDqloo6rxJTs=", "dev": true }, - "node_modules/compute-dims": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/compute-dims/-/compute-dims-1.1.0.tgz", - "integrity": "sha512-YHMiIKjH/8Eom8zATk3g8/lH3HxGCZcVQyEfEoVrfWI7od/WRpTgRGShnei3jArYSx77mQqPxZNokjGHCdLfxg==", - "dependencies": { - "utils-copy": "^1.0.0", - "validate.io-array": "^1.0.6", - "validate.io-matrix-like": "^1.0.2", - "validate.io-ndarray-like": "^1.0.0", - "validate.io-positive-integer": "^1.0.0" - } - }, "node_modules/concat-map": { "version": "0.0.1", "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", @@ -1630,16 +1605,6 @@ "typedarray": "^0.0.6" } }, - "node_modules/const-max-uint32": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/const-max-uint32/-/const-max-uint32-1.0.2.tgz", - "integrity": "sha512-T8/9bffg5RThuejasJWrwqxs3Q0fsJvyl7/33IB6svroD8JC93E7X60AuuOnDE8RlP6Jlb5FxmlrVDpl9KiU2Q==" - }, - "node_modules/const-pinf-float64": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/const-pinf-float64/-/const-pinf-float64-1.0.0.tgz", - "integrity": "sha512-wfs+V4HdSN7C3CWJWR7hVa24yTPn3mDJthwhRIObZBh6UjTjkUMUrCP3UrNGozB/HjTpcScnGXtQUNa+yjsIJQ==" - }, "node_modules/core-util-is": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz", @@ -2612,11 +2577,6 @@ "dtype": "^2.0.0" } }, - "node_modules/flip-pixels": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/flip-pixels/-/flip-pixels-1.0.2.tgz", - "integrity": "sha512-oXbJGbjDnfJRWPC7Va38EFhd+A8JWE5/hCiKcK8qjCdbLj9DTpsq6MEudwpRTH+V4qq+Jw7d3pUgQdSr3x3mTA==" - }, "node_modules/font-atlas": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/font-atlas/-/font-atlas-2.1.0.tgz", @@ -3087,16 +3047,6 @@ } ] }, - "node_modules/image-palette": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/image-palette/-/image-palette-2.1.0.tgz", - "integrity": "sha512-3ImSEWD26+xuQFdP0RWR4WSXadZwvgrFhjGNpMEapTG1tf2XrBFS2dlKK5hNgH4UIaSQlSUFRn1NeA+zULIWbQ==", - "dependencies": { - "color-id": "^1.1.0", - "pxls": "^2.0.0", - "quantize": "^1.0.2" - } - }, "node_modules/import-local": { "version": "3.0.2", "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.0.2.tgz", @@ -3173,11 +3123,6 @@ "integrity": "sha1-d8mYQFJ6qOyxqLppe4BkWnqSap0=", "dev": true }, - "node_modules/is-base64": { - "version": "0.1.0", - "resolved": "https://registry.npmjs.org/is-base64/-/is-base64-0.1.0.tgz", - "integrity": "sha512-WRRyllsGXJM7ZN7gPTCCQ/6wNPTRDwiWdPK66l5sJzcU/oOzcIcRRf0Rux8bkpox/1yjt0F6VJRsQOIG2qz5sg==" - }, "node_modules/is-bigint": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/is-bigint/-/is-bigint-1.0.1.tgz", @@ -3187,17 +3132,6 @@ "url": "https://github.com/sponsors/ljharb" } }, - "node_modules/is-blob": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/is-blob/-/is-blob-2.1.0.tgz", - "integrity": "sha512-SZ/fTft5eUhQM6oF/ZaASFDEdbFVe89Imltn9uZr03wdKMcWNVYSMjQPFtg05QuNkt5l5c135ElvXEQG0rk4tw==", - "engines": { - "node": ">=6" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, "node_modules/is-boolean-object": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/is-boolean-object/-/is-boolean-object-1.1.0.tgz", @@ -3218,28 +3152,6 @@ "resolved": "https://registry.npmjs.org/is-browser/-/is-browser-2.1.0.tgz", "integrity": "sha512-F5rTJxDQ2sW81fcfOR1GnCXT6sVJC104fCyfj+mjpwNEwaPYSn5fte5jiHmBg3DHsIoL/l8Kvw5VN5SsTRcRFQ==" }, - "node_modules/is-buffer": { - "version": "2.0.5", - "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-2.0.5.tgz", - "integrity": "sha512-i2R6zNFDwgEHJyQUtJEk0XFi1i0dPFn/oqjK3/vPCcDeJvW5NQ83V8QbicfF1SupOaB0h8ntgBC2YiE7dfyctQ==", - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/feross" - }, - { - "type": "patreon", - "url": "https://www.patreon.com/feross" - }, - { - "type": "consulting", - "url": "https://feross.org/support" - } - ], - "engines": { - "node": ">=4" - } - }, "node_modules/is-callable": { "version": "1.2.3", "resolved": "https://registry.npmjs.org/is-callable/-/is-callable-1.2.3.tgz", @@ -3294,11 +3206,6 @@ "node": ">=0.10.0" } }, - "node_modules/is-float-array": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/is-float-array/-/is-float-array-1.0.0.tgz", - "integrity": "sha512-4ew1Sx6B6kEAl3T3NOM0yB94J3NZnBdNt4paw0e8nY73yHHTeTEhyQ3Lj7EQEnv5LD+GxNTaT4L46jcKjjpLiQ==" - }, "node_modules/is-iexplorer": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/is-iexplorer/-/is-iexplorer-1.0.0.tgz", @@ -4156,6 +4063,7 @@ "version": "1.1.1", "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz", "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==", + "dev": true, "engines": { "node": ">= 0.4" } @@ -4436,9 +4344,9 @@ } }, "node_modules/plotly.js": { - "version": "2.20.0", - "resolved": "https://registry.npmjs.org/plotly.js/-/plotly.js-2.20.0.tgz", - "integrity": "sha512-aitv9IkW9Od55oewdnnABVDxZ7SJTGFp+uISURIfN3Gn0/xi2FwJCstUyoHKHT/an+jzWFsaiqFQL9FDxn2s8A==", + "version": "2.24.1", + "resolved": "https://registry.npmjs.org/plotly.js/-/plotly.js-2.24.1.tgz", + "integrity": "sha512-qcOnO7WWXWiu9/QiFPHAJgX7GkLQ9vn+Yq5bJv7rK8ZYrhiwgopqiRNVH2oY1qDYDXJKYz/2puLMVjKMPpLtGw==", "dependencies": { "@plotly/d3": "3.8.1", "@plotly/d3-sankey": "0.7.2", @@ -4479,7 +4387,7 @@ "regl": "npm:@plotly/regl@^2.1.2", "regl-error2d": "^2.0.12", "regl-line2d": "^3.1.2", - "regl-scatter2d": "^3.2.8", + "regl-scatter2d": "^3.2.9", "regl-splom": "^1.0.14", "strongly-connected-components": "^1.0.1", "superscript-text": "^1.0.0", @@ -4673,27 +4581,6 @@ "node": ">=6" } }, - "node_modules/pxls": { - "version": "2.3.2", - "resolved": "https://registry.npmjs.org/pxls/-/pxls-2.3.2.tgz", - "integrity": "sha512-pQkwgbLqWPcuES5iEmGa10OlCf5xG0blkIF3dg7PpRZShbTYcvAdfFfGL03SMrkaSUaa/V0UpN9HWg40O2AIIw==", - "dependencies": { - "arr-flatten": "^1.1.0", - "compute-dims": "^1.1.0", - "flip-pixels": "^1.0.2", - "is-browser": "^2.1.0", - "is-buffer": "^2.0.3", - "to-uint8": "^1.4.1" - } - }, - "node_modules/quantize": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/quantize/-/quantize-1.0.2.tgz", - "integrity": "sha512-25P7wI2UoDbIQsQp50ARkt+5pwPsOq7G/BqvT5xAbapnRoNWMN8/p55H9TXd5MuENiJnm5XICB2H2aDZGwts7w==", - "engines": { - "node": ">=0.10.21" - } - }, "node_modules/querystringify": { "version": "2.1.1", "resolved": "https://registry.npmjs.org/querystringify/-/querystringify-2.1.1.tgz", @@ -4818,11 +4705,6 @@ "node": ">= 0.10" } }, - "node_modules/regex-regex": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/regex-regex/-/regex-regex-1.0.0.tgz", - "integrity": "sha512-FPbEhFTLpxKNgHKay3zMfkHzFK2ebViAlyvsz5euO4kwekH0T6fAL4Sdo2CgQ7Y1tGB5HqQm8SBq7pW5GegvVA==" - }, "node_modules/regl": { "version": "2.1.2", "resolved": "https://registry.npmjs.org/@plotly/regl/-/regl-2.1.2.tgz", @@ -4862,9 +4744,9 @@ } }, "node_modules/regl-scatter2d": { - "version": "3.2.8", - "resolved": "https://registry.npmjs.org/regl-scatter2d/-/regl-scatter2d-3.2.8.tgz", - "integrity": "sha512-bqrqJyeHkGBa9mEfuBnRd7FUtdtZ1l+gsM2C5Ugr1U3vJG5K3mdWdVWtOAllZ5FHHyWJV/vgjVvftgFUg6CDig==", + "version": "3.2.9", + "resolved": "https://registry.npmjs.org/regl-scatter2d/-/regl-scatter2d-3.2.9.tgz", + "integrity": "sha512-PNrXs+xaCClKpiB2b3HZ2j3qXQXhC5kcTh/Nfgx9rLO0EpEhab0BSQDqAsbdbpdf+pSHSJvbgitB7ulbGeQ+Fg==", "dependencies": { "@plotly/point-cluster": "^3.1.9", "array-range": "^1.0.1", @@ -4875,7 +4757,6 @@ "color-rgba": "^2.1.1", "flatten-vertex-data": "^1.0.2", "glslify": "^7.0.0", - "image-palette": "^2.1.0", "is-iexplorer": "^1.0.0", "object-assign": "^4.1.1", "parse-rect": "^1.2.0", @@ -5290,15 +5171,6 @@ "parenthesis": "^3.1.5" } }, - "node_modules/string-to-arraybuffer": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/string-to-arraybuffer/-/string-to-arraybuffer-1.0.2.tgz", - "integrity": "sha512-DaGZidzi93dwjQen5I2osxR9ERS/R7B1PFyufNMnzhj+fmlDQAc1DSDIJVJhgI8Oq221efIMbABUBdPHDRt43Q==", - "dependencies": { - "atob-lite": "^2.0.0", - "is-base64": "^0.1.0" - } - }, "node_modules/string.prototype.padend": { "version": "3.1.2", "resolved": "https://registry.npmjs.org/string.prototype.padend/-/string.prototype.padend-3.1.2.tgz", @@ -5640,16 +5512,6 @@ "resolved": "https://registry.npmjs.org/tinyqueue/-/tinyqueue-2.0.3.tgz", "integrity": "sha512-ppJZNDuKGgxzkHihX8v9v9G5f+18gzaTfrukGrq6ueg0lmH4nqVnA2IPG0AEH3jKEk2GRJCUhDoqpoiw3PHLBA==" }, - "node_modules/to-array-buffer": { - "version": "3.2.0", - "resolved": "https://registry.npmjs.org/to-array-buffer/-/to-array-buffer-3.2.0.tgz", - "integrity": "sha512-zN33mwi0gpL+7xW1ITLfJ48CEj6ZQW0ZAP0MU+2W3kEY0PAIncyuxmD4OqkUVhPAbTP7amq9j/iwvZKYS+lzSQ==", - "dependencies": { - "flatten-vertex-data": "^1.0.2", - "is-blob": "^2.0.1", - "string-to-arraybuffer": "^1.0.0" - } - }, "node_modules/to-float32": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/to-float32/-/to-float32-1.1.0.tgz", @@ -5684,18 +5546,6 @@ "loader-utils": "^1.0.0" } }, - "node_modules/to-uint8": { - "version": "1.4.1", - "resolved": "https://registry.npmjs.org/to-uint8/-/to-uint8-1.4.1.tgz", - "integrity": "sha512-o+ochsMlTZyucbww8It401FC2Rx+OP2RpDeYbA6h+y9HgedDl1UjdsJ9CmzKEG7AFP9es5PmJ4eDWeeeXihESg==", - "dependencies": { - "arr-flatten": "^1.1.0", - "clamp": "^1.0.1", - "is-base64": "^0.1.0", - "is-float-array": "^1.0.0", - "to-array-buffer": "^3.0.0" - } - }, "node_modules/topojson-client": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/topojson-client/-/topojson-client-3.1.0.tgz", @@ -5828,11 +5678,6 @@ "node": ">= 0.8.0" } }, - "node_modules/type-name": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/type-name/-/type-name-2.0.2.tgz", - "integrity": "sha512-kkgkuqR/jKdKO5oh/I2SMu2dGbLXoJq0zkdgbxaqYK+hr9S9edwVVGf+tMUFTx2gH9TN2+Zu9JZ/Njonb3cjhA==" - }, "node_modules/typedarray": { "version": "0.0.6", "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz", @@ -6004,49 +5849,6 @@ "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", "integrity": "sha1-RQ1Nyfpw3nMnYvvS1KKJgUGaDM8=" }, - "node_modules/utils-copy": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/utils-copy/-/utils-copy-1.1.1.tgz", - "integrity": "sha512-+NhJVV+PcxjdpkMrVTqXhQHPldlFGca5XR9YnGyNn7kQ0fMi+DqNLzdnhJ4TJ1HNy/HzB7c+FPg3y+4icY99ZA==", - "dependencies": { - "const-pinf-float64": "^1.0.0", - "object-keys": "^1.0.9", - "type-name": "^2.0.0", - "utils-copy-error": "^1.0.0", - "utils-indexof": "^1.0.0", - "utils-regex-from-string": "^1.0.0", - "validate.io-array": "^1.0.3", - "validate.io-buffer": "^1.0.1", - "validate.io-nonnegative-integer": "^1.0.0" - } - }, - "node_modules/utils-copy-error": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/utils-copy-error/-/utils-copy-error-1.0.1.tgz", - "integrity": "sha512-RbJcGPZ6Ru2HQk9SWkvbdWNPX58pt4MO5uXsOQRu4LEGWB3LglkRrmnE/Ph1qWg6ywQ0qj95wTz1OeqQ2l8DCA==", - "dependencies": { - "object-keys": "^1.0.9", - "utils-copy": "^1.1.0" - } - }, - "node_modules/utils-indexof": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/utils-indexof/-/utils-indexof-1.0.0.tgz", - "integrity": "sha512-76QBfRJpn4A0P5uTO1x00x+Yog36w2Pab0n+aT9UfUvVa4l+e8k3p7YwNpDvfQ6+aKGZdxZpxcNotNS4YjFcyg==", - "dependencies": { - "validate.io-array-like": "^1.0.1", - "validate.io-integer-primitive": "^1.0.0" - } - }, - "node_modules/utils-regex-from-string": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/utils-regex-from-string/-/utils-regex-from-string-1.0.0.tgz", - "integrity": "sha512-xKfdmEF19iUu9TKxFiohQUlQTuqYdV80/CxHiudVI37iEV/OA4HHlXZoc4qvuO1B74EcBVpErBreRO/dpdLeYA==", - "dependencies": { - "regex-regex": "^1.0.0", - "validate.io-string-primitive": "^1.0.0" - } - }, "node_modules/v8-compile-cache": { "version": "2.3.0", "resolved": "https://registry.npmjs.org/v8-compile-cache/-/v8-compile-cache-2.3.0.tgz", @@ -6063,82 +5865,6 @@ "spdx-expression-parse": "^3.0.0" } }, - "node_modules/validate.io-array": { - "version": "1.0.6", - "resolved": "https://registry.npmjs.org/validate.io-array/-/validate.io-array-1.0.6.tgz", - "integrity": "sha512-DeOy7CnPEziggrOO5CZhVKJw6S3Yi7e9e65R1Nl/RTN1vTQKnzjfvks0/8kQ40FP/dsjRAOd4hxmJ7uLa6vxkg==" - }, - "node_modules/validate.io-array-like": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/validate.io-array-like/-/validate.io-array-like-1.0.2.tgz", - "integrity": "sha512-rGLiN0cvY9OWzQcWP+RtqZR/MK9RUz3gKDTCcRLtEQ/BvlanMF5PyqtVIN+CgrIBCv/ypfme9v7r4yMJPYpbNA==", - "dependencies": { - "const-max-uint32": "^1.0.2", - "validate.io-integer-primitive": "^1.0.0" - } - }, - "node_modules/validate.io-buffer": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/validate.io-buffer/-/validate.io-buffer-1.0.2.tgz", - "integrity": "sha512-6Tad+/QYOxWEXsesKYak1mHOzGdPYS4QeHFImWn7ECi4GR0x3vh7+6+1yoLKNXiklKuTFOxHLG3kZy9tPX0GvQ==" - }, - "node_modules/validate.io-integer": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/validate.io-integer/-/validate.io-integer-1.0.5.tgz", - "integrity": "sha512-22izsYSLojN/P6bppBqhgUDjCkr5RY2jd+N2a3DCAUey8ydvrZ/OkGvFPR7qfOpwR2LC5p4Ngzxz36g5Vgr/hQ==", - "dependencies": { - "validate.io-number": "^1.0.3" - } - }, - "node_modules/validate.io-integer-primitive": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/validate.io-integer-primitive/-/validate.io-integer-primitive-1.0.0.tgz", - "integrity": "sha512-4ARGKA4FImVWJgrgttLYsYJmDGwxlhLfDCdq09gyVgohLKKRUfD3VAo1L2vTRCLt6hDhDtFKdZiuYUTWyBggwg==", - "dependencies": { - "validate.io-number-primitive": "^1.0.0" - } - }, - "node_modules/validate.io-matrix-like": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/validate.io-matrix-like/-/validate.io-matrix-like-1.0.2.tgz", - "integrity": "sha512-86mqLUIkZCRAOVKZvpCB7sDCw1dKBjBkY+C6WO/wLo/jQx0sOqQZz3LLtDw0DCfuAKxRuhSmIpX3nzr0nWrbdw==" - }, - "node_modules/validate.io-ndarray-like": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/validate.io-ndarray-like/-/validate.io-ndarray-like-1.0.0.tgz", - "integrity": "sha512-OV85AosxraPFSXJwzv/d7Cu5/dLiyLtsHmxtHTJcHW1N0uscd0eJ2df1Zk+HdID0eUctUllW/1YuQPUJFv1pTA==" - }, - "node_modules/validate.io-nonnegative-integer": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/validate.io-nonnegative-integer/-/validate.io-nonnegative-integer-1.0.0.tgz", - "integrity": "sha512-uOMekPwcl84yg8NR7zgIZCZ9pHCtd9CK1Ri51N+ZJLTe1HyLbmdFdy7ZmfkiHkMvB1pOxeQmd1/LBjKhUD1L3A==", - "dependencies": { - "validate.io-integer": "^1.0.5" - } - }, - "node_modules/validate.io-number": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/validate.io-number/-/validate.io-number-1.0.3.tgz", - "integrity": "sha512-kRAyotcbNaSYoDnXvb4MHg/0a1egJdLwS6oJ38TJY7aw9n93Fl/3blIXdyYvPOp55CNxywooG/3BcrwNrBpcSg==" - }, - "node_modules/validate.io-number-primitive": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/validate.io-number-primitive/-/validate.io-number-primitive-1.0.0.tgz", - "integrity": "sha512-8rlCe7N0TRTd50dwk4WNoMXNbX/4+RdtqE3TO6Bk0GJvAgbQlfL5DGr/Pl9ZLbWR6CutMjE2cu+yOoCnFWk+Qw==" - }, - "node_modules/validate.io-positive-integer": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/validate.io-positive-integer/-/validate.io-positive-integer-1.0.0.tgz", - "integrity": "sha512-eg4LSdyqjICNUZWRilcQ5l+YayRlu6yi+GQsWw1bCmtG9yayOPmLa1fPymEHPPhbvWPAv3w0LLbCsf03pBHZkg==", - "dependencies": { - "validate.io-integer": "^1.0.5" - } - }, - "node_modules/validate.io-string-primitive": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/validate.io-string-primitive/-/validate.io-string-primitive-1.0.1.tgz", - "integrity": "sha512-TORbkLMdOFkEbPtfdx76FSVQGSAzyUEMxI+pBq5pfFm1ZzIesP+XiGc6eIK75aKu7RA7a8EcqUv5OrY5wfog5w==" - }, "node_modules/vt-pbf": { "version": "3.1.3", "resolved": "https://registry.npmjs.org/vt-pbf/-/vt-pbf-3.1.3.tgz", @@ -7596,11 +7322,6 @@ "color-convert": "^1.9.0" } }, - "arr-flatten": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/arr-flatten/-/arr-flatten-1.1.0.tgz", - "integrity": "sha512-L3hKV5R/p5o81R7O02IGnwpDmkp6E982XhtbuwSe3O4qOtMMMtodicASA1Cny2U+aCXcNpml+m4dPsvsJ3jatg==" - }, "array-bounds": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/array-bounds/-/array-bounds-1.0.1.tgz", @@ -7635,11 +7356,6 @@ "integrity": "sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==", "dev": true }, - "atob-lite": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/atob-lite/-/atob-lite-2.0.0.tgz", - "integrity": "sha512-LEeSAWeh2Gfa2FtlQE1shxQ8zi5F9GHarrGKz08TMdODD5T4eH6BMsvtnhbWZ+XQn+Gb6om/917ucvRu7l7ukw==" - }, "backbone": { "version": "1.2.3", "resolved": "https://registry.npmjs.org/backbone/-/backbone-1.2.3.tgz", @@ -7959,18 +7675,6 @@ "integrity": "sha1-3dgA2gxmEnOTzKWVDqloo6rxJTs=", "dev": true }, - "compute-dims": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/compute-dims/-/compute-dims-1.1.0.tgz", - "integrity": "sha512-YHMiIKjH/8Eom8zATk3g8/lH3HxGCZcVQyEfEoVrfWI7od/WRpTgRGShnei3jArYSx77mQqPxZNokjGHCdLfxg==", - "requires": { - "utils-copy": "^1.0.0", - "validate.io-array": "^1.0.6", - "validate.io-matrix-like": "^1.0.2", - "validate.io-ndarray-like": "^1.0.0", - "validate.io-positive-integer": "^1.0.0" - } - }, "concat-map": { "version": "0.0.1", "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", @@ -7988,16 +7692,6 @@ "typedarray": "^0.0.6" } }, - "const-max-uint32": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/const-max-uint32/-/const-max-uint32-1.0.2.tgz", - "integrity": "sha512-T8/9bffg5RThuejasJWrwqxs3Q0fsJvyl7/33IB6svroD8JC93E7X60AuuOnDE8RlP6Jlb5FxmlrVDpl9KiU2Q==" - }, - "const-pinf-float64": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/const-pinf-float64/-/const-pinf-float64-1.0.0.tgz", - "integrity": "sha512-wfs+V4HdSN7C3CWJWR7hVa24yTPn3mDJthwhRIObZBh6UjTjkUMUrCP3UrNGozB/HjTpcScnGXtQUNa+yjsIJQ==" - }, "core-util-is": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.2.tgz", @@ -8782,11 +8476,6 @@ "dtype": "^2.0.0" } }, - "flip-pixels": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/flip-pixels/-/flip-pixels-1.0.2.tgz", - "integrity": "sha512-oXbJGbjDnfJRWPC7Va38EFhd+A8JWE5/hCiKcK8qjCdbLj9DTpsq6MEudwpRTH+V4qq+Jw7d3pUgQdSr3x3mTA==" - }, "font-atlas": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/font-atlas/-/font-atlas-2.1.0.tgz", @@ -9200,16 +8889,6 @@ "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz", "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==" }, - "image-palette": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/image-palette/-/image-palette-2.1.0.tgz", - "integrity": "sha512-3ImSEWD26+xuQFdP0RWR4WSXadZwvgrFhjGNpMEapTG1tf2XrBFS2dlKK5hNgH4UIaSQlSUFRn1NeA+zULIWbQ==", - "requires": { - "color-id": "^1.1.0", - "pxls": "^2.0.0", - "quantize": "^1.0.2" - } - }, "import-local": { "version": "3.0.2", "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.0.2.tgz", @@ -9271,22 +8950,12 @@ "integrity": "sha1-d8mYQFJ6qOyxqLppe4BkWnqSap0=", "dev": true }, - "is-base64": { - "version": "0.1.0", - "resolved": "https://registry.npmjs.org/is-base64/-/is-base64-0.1.0.tgz", - "integrity": "sha512-WRRyllsGXJM7ZN7gPTCCQ/6wNPTRDwiWdPK66l5sJzcU/oOzcIcRRf0Rux8bkpox/1yjt0F6VJRsQOIG2qz5sg==" - }, "is-bigint": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/is-bigint/-/is-bigint-1.0.1.tgz", "integrity": "sha512-J0ELF4yHFxHy0cmSxZuheDOz2luOdVvqjwmEcj8H/L1JHeuEDSDbeRP+Dk9kFVk5RTFzbucJ2Kb9F7ixY2QaCg==", "dev": true }, - "is-blob": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/is-blob/-/is-blob-2.1.0.tgz", - "integrity": "sha512-SZ/fTft5eUhQM6oF/ZaASFDEdbFVe89Imltn9uZr03wdKMcWNVYSMjQPFtg05QuNkt5l5c135ElvXEQG0rk4tw==" - }, "is-boolean-object": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/is-boolean-object/-/is-boolean-object-1.1.0.tgz", @@ -9301,11 +8970,6 @@ "resolved": "https://registry.npmjs.org/is-browser/-/is-browser-2.1.0.tgz", "integrity": "sha512-F5rTJxDQ2sW81fcfOR1GnCXT6sVJC104fCyfj+mjpwNEwaPYSn5fte5jiHmBg3DHsIoL/l8Kvw5VN5SsTRcRFQ==" }, - "is-buffer": { - "version": "2.0.5", - "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-2.0.5.tgz", - "integrity": "sha512-i2R6zNFDwgEHJyQUtJEk0XFi1i0dPFn/oqjK3/vPCcDeJvW5NQ83V8QbicfF1SupOaB0h8ntgBC2YiE7dfyctQ==" - }, "is-callable": { "version": "1.2.3", "resolved": "https://registry.npmjs.org/is-callable/-/is-callable-1.2.3.tgz", @@ -9336,11 +9000,6 @@ "resolved": "https://registry.npmjs.org/is-firefox/-/is-firefox-1.0.3.tgz", "integrity": "sha512-6Q9ITjvWIm0Xdqv+5U12wgOKEM2KoBw4Y926m0OFkvlCxnbG94HKAsVz8w3fWcfAS5YA2fJORXX1dLrkprCCxA==" }, - "is-float-array": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/is-float-array/-/is-float-array-1.0.0.tgz", - "integrity": "sha512-4ew1Sx6B6kEAl3T3NOM0yB94J3NZnBdNt4paw0e8nY73yHHTeTEhyQ3Lj7EQEnv5LD+GxNTaT4L46jcKjjpLiQ==" - }, "is-iexplorer": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/is-iexplorer/-/is-iexplorer-1.0.0.tgz", @@ -9994,7 +9653,8 @@ "object-keys": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/object-keys/-/object-keys-1.1.1.tgz", - "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==" + "integrity": "sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==", + "dev": true }, "object.assign": { "version": "4.1.2", @@ -10199,9 +9859,9 @@ } }, "plotly.js": { - "version": "2.20.0", - "resolved": "https://registry.npmjs.org/plotly.js/-/plotly.js-2.20.0.tgz", - "integrity": "sha512-aitv9IkW9Od55oewdnnABVDxZ7SJTGFp+uISURIfN3Gn0/xi2FwJCstUyoHKHT/an+jzWFsaiqFQL9FDxn2s8A==", + "version": "2.24.1", + "resolved": "https://registry.npmjs.org/plotly.js/-/plotly.js-2.24.1.tgz", + "integrity": "sha512-qcOnO7WWXWiu9/QiFPHAJgX7GkLQ9vn+Yq5bJv7rK8ZYrhiwgopqiRNVH2oY1qDYDXJKYz/2puLMVjKMPpLtGw==", "requires": { "@plotly/d3": "3.8.1", "@plotly/d3-sankey": "0.7.2", @@ -10242,7 +9902,7 @@ "regl": "npm:@plotly/regl@^2.1.2", "regl-error2d": "^2.0.12", "regl-line2d": "^3.1.2", - "regl-scatter2d": "^3.2.8", + "regl-scatter2d": "^3.2.9", "regl-splom": "^1.0.14", "strongly-connected-components": "^1.0.1", "superscript-text": "^1.0.0", @@ -10388,24 +10048,6 @@ "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.1.1.tgz", "integrity": "sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A==" }, - "pxls": { - "version": "2.3.2", - "resolved": "https://registry.npmjs.org/pxls/-/pxls-2.3.2.tgz", - "integrity": "sha512-pQkwgbLqWPcuES5iEmGa10OlCf5xG0blkIF3dg7PpRZShbTYcvAdfFfGL03SMrkaSUaa/V0UpN9HWg40O2AIIw==", - "requires": { - "arr-flatten": "^1.1.0", - "compute-dims": "^1.1.0", - "flip-pixels": "^1.0.2", - "is-browser": "^2.1.0", - "is-buffer": "^2.0.3", - "to-uint8": "^1.4.1" - } - }, - "quantize": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/quantize/-/quantize-1.0.2.tgz", - "integrity": "sha512-25P7wI2UoDbIQsQp50ARkt+5pwPsOq7G/BqvT5xAbapnRoNWMN8/p55H9TXd5MuENiJnm5XICB2H2aDZGwts7w==" - }, "querystringify": { "version": "2.1.1", "resolved": "https://registry.npmjs.org/querystringify/-/querystringify-2.1.1.tgz", @@ -10508,11 +10150,6 @@ "resolve": "^1.9.0" } }, - "regex-regex": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/regex-regex/-/regex-regex-1.0.0.tgz", - "integrity": "sha512-FPbEhFTLpxKNgHKay3zMfkHzFK2ebViAlyvsz5euO4kwekH0T6fAL4Sdo2CgQ7Y1tGB5HqQm8SBq7pW5GegvVA==" - }, "regl": { "version": "2.1.2", "resolved": "https://registry.npmjs.org/@plotly/regl/-/regl-2.1.2.tgz", @@ -10552,9 +10189,9 @@ } }, "regl-scatter2d": { - "version": "3.2.8", - "resolved": "https://registry.npmjs.org/regl-scatter2d/-/regl-scatter2d-3.2.8.tgz", - "integrity": "sha512-bqrqJyeHkGBa9mEfuBnRd7FUtdtZ1l+gsM2C5Ugr1U3vJG5K3mdWdVWtOAllZ5FHHyWJV/vgjVvftgFUg6CDig==", + "version": "3.2.9", + "resolved": "https://registry.npmjs.org/regl-scatter2d/-/regl-scatter2d-3.2.9.tgz", + "integrity": "sha512-PNrXs+xaCClKpiB2b3HZ2j3qXQXhC5kcTh/Nfgx9rLO0EpEhab0BSQDqAsbdbpdf+pSHSJvbgitB7ulbGeQ+Fg==", "requires": { "@plotly/point-cluster": "^3.1.9", "array-range": "^1.0.1", @@ -10565,7 +10202,6 @@ "color-rgba": "^2.1.1", "flatten-vertex-data": "^1.0.2", "glslify": "^7.0.0", - "image-palette": "^2.1.0", "is-iexplorer": "^1.0.0", "object-assign": "^4.1.1", "parse-rect": "^1.2.0", @@ -10903,15 +10539,6 @@ "parenthesis": "^3.1.5" } }, - "string-to-arraybuffer": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/string-to-arraybuffer/-/string-to-arraybuffer-1.0.2.tgz", - "integrity": "sha512-DaGZidzi93dwjQen5I2osxR9ERS/R7B1PFyufNMnzhj+fmlDQAc1DSDIJVJhgI8Oq221efIMbABUBdPHDRt43Q==", - "requires": { - "atob-lite": "^2.0.0", - "is-base64": "^0.1.0" - } - }, "string.prototype.padend": { "version": "3.1.2", "resolved": "https://registry.npmjs.org/string.prototype.padend/-/string.prototype.padend-3.1.2.tgz", @@ -11178,16 +10805,6 @@ "resolved": "https://registry.npmjs.org/tinyqueue/-/tinyqueue-2.0.3.tgz", "integrity": "sha512-ppJZNDuKGgxzkHihX8v9v9G5f+18gzaTfrukGrq6ueg0lmH4nqVnA2IPG0AEH3jKEk2GRJCUhDoqpoiw3PHLBA==" }, - "to-array-buffer": { - "version": "3.2.0", - "resolved": "https://registry.npmjs.org/to-array-buffer/-/to-array-buffer-3.2.0.tgz", - "integrity": "sha512-zN33mwi0gpL+7xW1ITLfJ48CEj6ZQW0ZAP0MU+2W3kEY0PAIncyuxmD4OqkUVhPAbTP7amq9j/iwvZKYS+lzSQ==", - "requires": { - "flatten-vertex-data": "^1.0.2", - "is-blob": "^2.0.1", - "string-to-arraybuffer": "^1.0.0" - } - }, "to-float32": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/to-float32/-/to-float32-1.1.0.tgz", @@ -11219,18 +10836,6 @@ "loader-utils": "^1.0.0" } }, - "to-uint8": { - "version": "1.4.1", - "resolved": "https://registry.npmjs.org/to-uint8/-/to-uint8-1.4.1.tgz", - "integrity": "sha512-o+ochsMlTZyucbww8It401FC2Rx+OP2RpDeYbA6h+y9HgedDl1UjdsJ9CmzKEG7AFP9es5PmJ4eDWeeeXihESg==", - "requires": { - "arr-flatten": "^1.1.0", - "clamp": "^1.0.1", - "is-base64": "^0.1.0", - "is-float-array": "^1.0.0", - "to-array-buffer": "^3.0.0" - } - }, "topojson-client": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/topojson-client/-/topojson-client-3.1.0.tgz", @@ -11326,11 +10931,6 @@ "prelude-ls": "~1.1.2" } }, - "type-name": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/type-name/-/type-name-2.0.2.tgz", - "integrity": "sha512-kkgkuqR/jKdKO5oh/I2SMu2dGbLXoJq0zkdgbxaqYK+hr9S9edwVVGf+tMUFTx2gH9TN2+Zu9JZ/Njonb3cjhA==" - }, "typedarray": { "version": "0.0.6", "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz", @@ -11465,49 +11065,6 @@ "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", "integrity": "sha1-RQ1Nyfpw3nMnYvvS1KKJgUGaDM8=" }, - "utils-copy": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/utils-copy/-/utils-copy-1.1.1.tgz", - "integrity": "sha512-+NhJVV+PcxjdpkMrVTqXhQHPldlFGca5XR9YnGyNn7kQ0fMi+DqNLzdnhJ4TJ1HNy/HzB7c+FPg3y+4icY99ZA==", - "requires": { - "const-pinf-float64": "^1.0.0", - "object-keys": "^1.0.9", - "type-name": "^2.0.0", - "utils-copy-error": "^1.0.0", - "utils-indexof": "^1.0.0", - "utils-regex-from-string": "^1.0.0", - "validate.io-array": "^1.0.3", - "validate.io-buffer": "^1.0.1", - "validate.io-nonnegative-integer": "^1.0.0" - } - }, - "utils-copy-error": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/utils-copy-error/-/utils-copy-error-1.0.1.tgz", - "integrity": "sha512-RbJcGPZ6Ru2HQk9SWkvbdWNPX58pt4MO5uXsOQRu4LEGWB3LglkRrmnE/Ph1qWg6ywQ0qj95wTz1OeqQ2l8DCA==", - "requires": { - "object-keys": "^1.0.9", - "utils-copy": "^1.1.0" - } - }, - "utils-indexof": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/utils-indexof/-/utils-indexof-1.0.0.tgz", - "integrity": "sha512-76QBfRJpn4A0P5uTO1x00x+Yog36w2Pab0n+aT9UfUvVa4l+e8k3p7YwNpDvfQ6+aKGZdxZpxcNotNS4YjFcyg==", - "requires": { - "validate.io-array-like": "^1.0.1", - "validate.io-integer-primitive": "^1.0.0" - } - }, - "utils-regex-from-string": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/utils-regex-from-string/-/utils-regex-from-string-1.0.0.tgz", - "integrity": "sha512-xKfdmEF19iUu9TKxFiohQUlQTuqYdV80/CxHiudVI37iEV/OA4HHlXZoc4qvuO1B74EcBVpErBreRO/dpdLeYA==", - "requires": { - "regex-regex": "^1.0.0", - "validate.io-string-primitive": "^1.0.0" - } - }, "v8-compile-cache": { "version": "2.3.0", "resolved": "https://registry.npmjs.org/v8-compile-cache/-/v8-compile-cache-2.3.0.tgz", @@ -11524,82 +11081,6 @@ "spdx-expression-parse": "^3.0.0" } }, - "validate.io-array": { - "version": "1.0.6", - "resolved": "https://registry.npmjs.org/validate.io-array/-/validate.io-array-1.0.6.tgz", - "integrity": "sha512-DeOy7CnPEziggrOO5CZhVKJw6S3Yi7e9e65R1Nl/RTN1vTQKnzjfvks0/8kQ40FP/dsjRAOd4hxmJ7uLa6vxkg==" - }, - "validate.io-array-like": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/validate.io-array-like/-/validate.io-array-like-1.0.2.tgz", - "integrity": "sha512-rGLiN0cvY9OWzQcWP+RtqZR/MK9RUz3gKDTCcRLtEQ/BvlanMF5PyqtVIN+CgrIBCv/ypfme9v7r4yMJPYpbNA==", - "requires": { - "const-max-uint32": "^1.0.2", - "validate.io-integer-primitive": "^1.0.0" - } - }, - "validate.io-buffer": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/validate.io-buffer/-/validate.io-buffer-1.0.2.tgz", - "integrity": "sha512-6Tad+/QYOxWEXsesKYak1mHOzGdPYS4QeHFImWn7ECi4GR0x3vh7+6+1yoLKNXiklKuTFOxHLG3kZy9tPX0GvQ==" - }, - "validate.io-integer": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/validate.io-integer/-/validate.io-integer-1.0.5.tgz", - "integrity": "sha512-22izsYSLojN/P6bppBqhgUDjCkr5RY2jd+N2a3DCAUey8ydvrZ/OkGvFPR7qfOpwR2LC5p4Ngzxz36g5Vgr/hQ==", - "requires": { - "validate.io-number": "^1.0.3" - } - }, - "validate.io-integer-primitive": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/validate.io-integer-primitive/-/validate.io-integer-primitive-1.0.0.tgz", - "integrity": "sha512-4ARGKA4FImVWJgrgttLYsYJmDGwxlhLfDCdq09gyVgohLKKRUfD3VAo1L2vTRCLt6hDhDtFKdZiuYUTWyBggwg==", - "requires": { - "validate.io-number-primitive": "^1.0.0" - } - }, - "validate.io-matrix-like": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/validate.io-matrix-like/-/validate.io-matrix-like-1.0.2.tgz", - "integrity": "sha512-86mqLUIkZCRAOVKZvpCB7sDCw1dKBjBkY+C6WO/wLo/jQx0sOqQZz3LLtDw0DCfuAKxRuhSmIpX3nzr0nWrbdw==" - }, - "validate.io-ndarray-like": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/validate.io-ndarray-like/-/validate.io-ndarray-like-1.0.0.tgz", - "integrity": "sha512-OV85AosxraPFSXJwzv/d7Cu5/dLiyLtsHmxtHTJcHW1N0uscd0eJ2df1Zk+HdID0eUctUllW/1YuQPUJFv1pTA==" - }, - "validate.io-nonnegative-integer": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/validate.io-nonnegative-integer/-/validate.io-nonnegative-integer-1.0.0.tgz", - "integrity": "sha512-uOMekPwcl84yg8NR7zgIZCZ9pHCtd9CK1Ri51N+ZJLTe1HyLbmdFdy7ZmfkiHkMvB1pOxeQmd1/LBjKhUD1L3A==", - "requires": { - "validate.io-integer": "^1.0.5" - } - }, - "validate.io-number": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/validate.io-number/-/validate.io-number-1.0.3.tgz", - "integrity": "sha512-kRAyotcbNaSYoDnXvb4MHg/0a1egJdLwS6oJ38TJY7aw9n93Fl/3blIXdyYvPOp55CNxywooG/3BcrwNrBpcSg==" - }, - "validate.io-number-primitive": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/validate.io-number-primitive/-/validate.io-number-primitive-1.0.0.tgz", - "integrity": "sha512-8rlCe7N0TRTd50dwk4WNoMXNbX/4+RdtqE3TO6Bk0GJvAgbQlfL5DGr/Pl9ZLbWR6CutMjE2cu+yOoCnFWk+Qw==" - }, - "validate.io-positive-integer": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/validate.io-positive-integer/-/validate.io-positive-integer-1.0.0.tgz", - "integrity": "sha512-eg4LSdyqjICNUZWRilcQ5l+YayRlu6yi+GQsWw1bCmtG9yayOPmLa1fPymEHPPhbvWPAv3w0LLbCsf03pBHZkg==", - "requires": { - "validate.io-integer": "^1.0.5" - } - }, - "validate.io-string-primitive": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/validate.io-string-primitive/-/validate.io-string-primitive-1.0.1.tgz", - "integrity": "sha512-TORbkLMdOFkEbPtfdx76FSVQGSAzyUEMxI+pBq5pfFm1ZzIesP+XiGc6eIK75aKu7RA7a8EcqUv5OrY5wfog5w==" - }, "vt-pbf": { "version": "3.1.3", "resolved": "https://registry.npmjs.org/vt-pbf/-/vt-pbf-3.1.3.tgz", diff --git a/packages/javascript/jupyterlab-plotly/package.json b/packages/javascript/jupyterlab-plotly/package.json index 56201ab6cfa..26130caeea9 100644 --- a/packages/javascript/jupyterlab-plotly/package.json +++ b/packages/javascript/jupyterlab-plotly/package.json @@ -1,6 +1,6 @@ { "name": "jupyterlab-plotly", - "version": "5.14.1", + "version": "5.15.0", "description": "The plotly Jupyter extension", "author": "The plotly.py team", "license": "MIT", @@ -65,7 +65,7 @@ "@lumino/messaging": "^1.2.3", "@lumino/widgets": "^1.8.1", "lodash": "^4.17.4", - "plotly.js": "^2.20.0" + "plotly.js": "^2.24.1" }, "jupyterlab": { "extension": "lib/jupyterlab-plugin", diff --git a/packages/javascript/jupyterlab-plotly/src/Figure.ts b/packages/javascript/jupyterlab-plotly/src/Figure.ts index 29bf94bb417..3174ea34a6a 100644 --- a/packages/javascript/jupyterlab-plotly/src/Figure.ts +++ b/packages/javascript/jupyterlab-plotly/src/Figure.ts @@ -849,6 +849,9 @@ export class FigureView extends DOMWidgetView { // the model is not directly mutated by the Plotly.js library. var initialTraces = _.cloneDeep(this.model.get("_data")); var initialLayout = _.cloneDeep(this.model.get("_layout")); + if (!initialLayout.height) { + initialLayout.height = 360; + } var config = this.model.get("_config"); config.editSelection = false; diff --git a/packages/javascript/jupyterlab-plotly/src/plotly-renderer.ts b/packages/javascript/jupyterlab-plotly/src/plotly-renderer.ts index dcd32041d67..22d26aacda5 100644 --- a/packages/javascript/jupyterlab-plotly/src/plotly-renderer.ts +++ b/packages/javascript/jupyterlab-plotly/src/plotly-renderer.ts @@ -126,12 +126,16 @@ export class RenderedPlotly extends Widget implements IRenderMime.IRenderer { | any | IPlotlySpec; + if (!layout.height) { + layout.height = 360; + } + // Load plotly asynchronously const loadPlotly = async (): Promise => { if (RenderedPlotly.Plotly === null) { RenderedPlotly.Plotly = await import("plotly.js/dist/plotly"); RenderedPlotly._resolveLoadingPlotly(); - } + } return RenderedPlotly.loadingPlotly; }; diff --git a/packages/javascript/jupyterlab-plotly/style/index.css b/packages/javascript/jupyterlab-plotly/style/index.css index 15cdf2f9ad4..d5bd8eea6dd 100644 --- a/packages/javascript/jupyterlab-plotly/style/index.css +++ b/packages/javascript/jupyterlab-plotly/style/index.css @@ -21,12 +21,7 @@ overflow: hidden; } -/* Output styles */ -.jp-OutputArea .jp-RenderedPlotly { - min-height: 360px; -} - /* Document icon */ .jp-PlotlyIcon { background-image: var(--jp-icon-plotly); -} \ No newline at end of file +} diff --git a/packages/python/plotly/_plotly_utils/basevalidators.py b/packages/python/plotly/_plotly_utils/basevalidators.py index 2b799c474cb..e0c93699e72 100644 --- a/packages/python/plotly/_plotly_utils/basevalidators.py +++ b/packages/python/plotly/_plotly_utils/basevalidators.py @@ -7,7 +7,6 @@ from importlib import import_module import copy import io -from copy import deepcopy import re import sys @@ -2662,24 +2661,20 @@ def validate_coerce(self, v, skip_invalid=False, _validate=True): for v_el in v: if isinstance(v_el, BaseTraceType): - # Clone input traces - v_el = v_el.to_plotly_json() + if isinstance(v_el, Histogram2dcontour): + v_el = dict(type="histogram2dcontour", **v_el._props) + else: + v_el = v_el._props if isinstance(v_el, dict): - v_copy = deepcopy(v_el) - - if "type" in v_copy: - trace_type = v_copy.pop("type") - elif isinstance(v_el, Histogram2dcontour): - trace_type = "histogram2dcontour" - else: - trace_type = "scatter" + type_in_v_el = "type" in v_el + trace_type = v_el.pop("type", "scatter") if trace_type not in self.class_strs_map: if skip_invalid: # Treat as scatter trace trace = self.get_trace_class("scatter")( - skip_invalid=skip_invalid, _validate=_validate, **v_copy + skip_invalid=skip_invalid, _validate=_validate, **v_el ) res.append(trace) else: @@ -2687,9 +2682,13 @@ def validate_coerce(self, v, skip_invalid=False, _validate=True): invalid_els.append(v_el) else: trace = self.get_trace_class(trace_type)( - skip_invalid=skip_invalid, _validate=_validate, **v_copy + skip_invalid=skip_invalid, _validate=_validate, **v_el ) res.append(trace) + + if type_in_v_el: + # Restore type in v_el + v_el["type"] = trace_type else: if skip_invalid: # Add empty scatter trace diff --git a/packages/python/plotly/_plotly_utils/colors/__init__.py b/packages/python/plotly/_plotly_utils/colors/__init__.py index 06c0ff42a0b..20c432094e3 100644 --- a/packages/python/plotly/_plotly_utils/colors/__init__.py +++ b/packages/python/plotly/_plotly_utils/colors/__init__.py @@ -694,11 +694,19 @@ def n_colors(lowcolor, highcolor, n_colors, colortype="tuple"): incr_2 = diff_2 / (n_colors - 1) list_of_colors = [] + def _constrain_color(c): + if c > 255.0: + return 255.0 + elif c < 0.0: + return 0.0 + else: + return c + for index in range(n_colors): new_tuple = ( - lowcolor[0] + (index * incr_0), - lowcolor[1] + (index * incr_1), - lowcolor[2] + (index * incr_2), + _constrain_color(lowcolor[0] + (index * incr_0)), + _constrain_color(lowcolor[1] + (index * incr_1)), + _constrain_color(lowcolor[2] + (index * incr_2)), ) list_of_colors.append(new_tuple) diff --git a/packages/python/plotly/_plotly_utils/tests/validators/test_integer_validator.py b/packages/python/plotly/_plotly_utils/tests/validators/test_integer_validator.py index 07f61155a56..8b7cb1dbf48 100644 --- a/packages/python/plotly/_plotly_utils/tests/validators/test_integer_validator.py +++ b/packages/python/plotly/_plotly_utils/tests/validators/test_integer_validator.py @@ -74,7 +74,7 @@ def test_acceptance_min(val, validator_min): assert validator_min.validate_coerce(val) == approx(val) -@pytest.mark.parametrize("val", [-2, -123, np.iinfo(np.int).min]) +@pytest.mark.parametrize("val", [-2, -123, np.iinfo(int).min]) def test_rejection_min(val, validator_min): with pytest.raises(ValueError) as validation_failure: validator_min.validate_coerce(val) diff --git a/packages/python/plotly/codegen/resources/plot-schema.json b/packages/python/plotly/codegen/resources/plot-schema.json index 411afae1354..ab6817cf377 100644 --- a/packages/python/plotly/codegen/resources/plot-schema.json +++ b/packages/python/plotly/codegen/resources/plot-schema.json @@ -1563,10 +1563,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -1586,11 +1584,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -1609,6 +1615,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -2743,6 +2759,7 @@ "role": "object" }, "legend": { + "_isSubplotObj": true, "bgcolor": { "description": "Sets the legend background color. Defaults to `layout.paper_bgcolor`.", "editType": "legend", @@ -2956,11 +2973,15 @@ "bottom" ] }, + "visible": { + "description": "Determines whether or not this legend is visible.", + "dflt": true, + "editType": "legend", + "valType": "boolean" + }, "x": { - "description": "Sets the x position (in normalized coordinates) of the legend. Defaults to *1.02* for vertical legends and defaults to *0* for horizontal legends.", + "description": "Sets the x position with respect to `xref` (in normalized coordinates) of the legend. When `xref` is *paper*, defaults to *1.02* for vertical legends and defaults to *0* for horizontal legends. When `xref` is *container*, defaults to *1* for vertical legends and defaults to *0* for horizontal legends. Must be between *0* and *1* if `xref` is *container*. and between *-2* and *3* if `xref` is *paper*.", "editType": "legend", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -2975,11 +2996,19 @@ "right" ] }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "layoutstyle", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position (in normalized coordinates) of the legend. Defaults to *1* for vertical legends, defaults to *-0.1* for horizontal legends on graphs w/o range sliders and defaults to *1.1* for horizontal legends on graph with one or multiple range sliders.", + "description": "Sets the y position with respect to `yref` (in normalized coordinates) of the legend. When `yref` is *paper*, defaults to *1* for vertical legends, defaults to *-0.1* for horizontal legends on graphs w/o range sliders and defaults to *1.1* for horizontal legends on graph with one or multiple range sliders. When `yref` is *container*, defaults to *1*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "legend", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -2992,6 +3021,16 @@ "middle", "bottom" ] + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "layoutstyle", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "mapbox": { @@ -3641,6 +3680,12 @@ "end" ] }, + "texttemplate": { + "description": "Template string used for rendering the new shape's label. Note that this will override `text`. Variables are inserted using %{variable}, for example \"x0: %{x0}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{x0:$.2f}\". See https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example \"Day: %{x0|%m %b %Y}\". See https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. A single multiplication or division operation may be applied to numeric variables, and combined with d3 number formatting, for example \"Length in cm: %{x0*2.54}\", \"%{slope*60:.1f} meters per second.\" For log axes, variable values are given in log units. For date axes, x/y coordinate variables and center variables use datetimes, while all other variable values use values in ms. Finally, the template string has access to variables `x0`, `x1`, `y0`, `y1`, `slope`, `dx`, `dy`, `width`, `height`, `length`, `xcenter` and `ycenter`.", + "dflt": "", + "editType": "none", + "valType": "string" + }, "xanchor": { "description": "Sets the label's horizontal position anchor This anchor binds the specified `textposition` to the *left*, *center* or *right* of the label text. For example, if `textposition` is set to *top right* and `xanchor` to *right* then the right-most portion of the label text lines up with the right-most edge of the new shape.", "dflt": "auto", @@ -7292,6 +7337,12 @@ "end" ] }, + "texttemplate": { + "description": "Template string used for rendering the shape's label. Note that this will override `text`. Variables are inserted using %{variable}, for example \"x0: %{x0}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{x0:$.2f}\". See https://github.com/d3/d3-format/tree/v1.4.5#d3-format for details on the formatting syntax. Dates are formatted using d3-time-format's syntax %{variable|d3-time-format}, for example \"Day: %{x0|%m %b %Y}\". See https://github.com/d3/d3-time-format/tree/v2.2.3#locale_format for details on the date formatting syntax. A single multiplication or division operation may be applied to numeric variables, and combined with d3 number formatting, for example \"Length in cm: %{x0*2.54}\", \"%{slope*60:.1f} meters per second.\" For log axes, variable values are given in log units. For date axes, x/y coordinate variables and center variables use datetimes, while all other variable values use values in ms. Finally, the template string has access to variables `x0`, `x1`, `y0`, `y1`, `slope`, `dx`, `dy`, `width`, `height`, `length`, `xcenter` and `ycenter`.", + "dflt": "", + "editType": "arraydraw", + "valType": "string" + }, "xanchor": { "description": "Sets the label's horizontal position anchor This anchor binds the specified `textposition` to the *left*, *center* or *right* of the label text. For example, if `textposition` is set to *top right* and `xanchor` to *right* then the right-most portion of the label text lines up with the right-most edge of the shape.", "dflt": "auto", @@ -12811,7 +12862,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variables `value` and `label`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 variables `value` and `label`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -12894,6 +12945,12 @@ "valType": "string" } }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -13440,10 +13497,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -13463,11 +13518,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -13486,6 +13549,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -13940,7 +14013,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `value` and `label`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `value` and `label`.", "dflt": "", "editType": "plot", "valType": "string" @@ -14229,7 +14302,7 @@ } }, "meta": { - "description": "The data visualized by the span of the bars is set in `y` if `orientation` is set th *v* (the default) and the labels are set in `x`. By setting `orientation` to *h*, the roles are interchanged." + "description": "The data visualized by the span of the bars is set in `y` if `orientation` is set to *v* (the default) and the labels are set in `x`. By setting `orientation` to *h*, the roles are interchanged." }, "type": "bar" }, @@ -14421,6 +14494,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -14967,10 +15046,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -14990,11 +15067,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -15013,6 +15098,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -15727,6 +15822,12 @@ "min": 0, "valType": "number" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -17071,6 +17172,12 @@ }, "role": "object" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -18591,6 +18698,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgrouptitle": { "editType": "style", "font": { @@ -19209,10 +19322,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -19232,11 +19343,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -19255,6 +19374,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -19445,6 +19574,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -20214,10 +20349,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -20237,11 +20370,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -20260,6 +20401,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -20412,7 +20563,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variable `properties` Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -20444,6 +20595,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -21248,10 +21405,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -21271,11 +21426,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -21294,6 +21457,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -21440,7 +21613,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variable `norm` Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 `norm` Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "calc", "valType": "string" @@ -21472,6 +21645,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -22300,10 +22479,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -22323,11 +22500,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -22346,6 +22531,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -22676,6 +22871,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -22864,7 +23065,7 @@ "valType": "string" }, "texttemplate": { - "description": "For this trace it only has an effect if `coloring` is set to *heatmap*. Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `x`, `y`, `z` and `text`.", + "description": "For this trace it only has an effect if `coloring` is set to *heatmap*. Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `x`, `y`, `z` and `text`.", "dflt": "", "editType": "plot", "valType": "string" @@ -23693,10 +23894,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -23716,11 +23915,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -23739,6 +23946,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -23926,6 +24143,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -24657,10 +24880,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -24680,11 +24901,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -24703,6 +24932,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -24887,6 +25126,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -25342,7 +25587,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variables `percentInitial`, `percentPrevious` and `percentTotal`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 variables `percentInitial`, `percentPrevious` and `percentTotal`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -25424,6 +25669,12 @@ "valType": "string" } }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -25970,10 +26221,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -25993,11 +26242,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -26016,6 +26273,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -26359,7 +26626,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `percentInitial`, `percentPrevious`, `percentTotal`, `label` and `value`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `percentInitial`, `percentPrevious`, `percentTotal`, `label` and `value`.", "dflt": "", "editType": "plot", "valType": "string" @@ -26770,7 +27037,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variables `label`, `color`, `value`, `text` and `percent`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 variables `label`, `color`, `value`, `text` and `percent`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -26857,6 +27124,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -26947,6 +27220,99 @@ "valType": "string" } }, + "pattern": { + "bgcolor": { + "arrayOk": true, + "description": "When there is no colorscale sets the color of background pattern fill. Defaults to a `marker.color` background when `fillmode` is *overlay*. Otherwise, defaults to a transparent background.", + "editType": "style", + "valType": "color" + }, + "bgcolorsrc": { + "description": "Sets the source reference on Chart Studio Cloud for `bgcolor`.", + "editType": "none", + "valType": "string" + }, + "description": "Sets the pattern within the marker.", + "editType": "style", + "fgcolor": { + "arrayOk": true, + "description": "When there is no colorscale sets the color of foreground pattern fill. Defaults to a `marker.color` background when `fillmode` is *replace*. Otherwise, defaults to dark grey or white to increase contrast with the `bgcolor`.", + "editType": "style", + "valType": "color" + }, + "fgcolorsrc": { + "description": "Sets the source reference on Chart Studio Cloud for `fgcolor`.", + "editType": "none", + "valType": "string" + }, + "fgopacity": { + "description": "Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when `fillmode` is *overlay*. Otherwise, defaults to 1.", + "editType": "style", + "max": 1, + "min": 0, + "valType": "number" + }, + "fillmode": { + "description": "Determines whether `marker.color` should be used as a default to `bgcolor` or a `fgcolor`.", + "dflt": "replace", + "editType": "style", + "valType": "enumerated", + "values": [ + "replace", + "overlay" + ] + }, + "role": "object", + "shape": { + "arrayOk": true, + "description": "Sets the shape of the pattern fill. By default, no pattern is used for filling the area.", + "dflt": "", + "editType": "style", + "valType": "enumerated", + "values": [ + "", + "/", + "\\", + "x", + "-", + "|", + "+", + "." + ] + }, + "shapesrc": { + "description": "Sets the source reference on Chart Studio Cloud for `shape`.", + "editType": "none", + "valType": "string" + }, + "size": { + "arrayOk": true, + "description": "Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.", + "dflt": 8, + "editType": "style", + "min": 0, + "valType": "number" + }, + "sizesrc": { + "description": "Sets the source reference on Chart Studio Cloud for `size`.", + "editType": "none", + "valType": "string" + }, + "solidity": { + "arrayOk": true, + "description": "Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.", + "dflt": 0.3, + "editType": "style", + "max": 1, + "min": 0, + "valType": "number" + }, + "soliditysrc": { + "description": "Sets the source reference on Chart Studio Cloud for `solidity`.", + "editType": "none", + "valType": "string" + } + }, "role": "object" }, "meta": { @@ -27085,7 +27451,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `label`, `color`, `value`, `text` and `percent`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `label`, `color`, `value`, `text` and `percent`.", "dflt": "", "editType": "plot", "valType": "string" @@ -27692,10 +28058,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -27715,11 +28079,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -27738,6 +28110,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -27939,6 +28321,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -28083,7 +28471,7 @@ "valType": "string" }, "texttemplate": { - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `x`, `y`, `z` and `text`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `x`, `y`, `z` and `text`.", "dflt": "", "editType": "plot", "valType": "string" @@ -28868,10 +29256,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -28891,11 +29277,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -28914,6 +29308,16 @@ "editType": "calc", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -29082,6 +29486,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgrouptitle": { "editType": "style", "font": { @@ -29805,7 +30215,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variable `binNumber` Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 `binNumber` Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -29869,6 +30279,12 @@ "valType": "number" } }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -30415,10 +30831,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -30438,11 +30852,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -30461,6 +30883,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -30874,7 +31306,7 @@ "valType": "string" }, "texttemplate": { - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `label` and `value`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `label` and `value`.", "dflt": "", "editType": "plot", "valType": "string" @@ -31605,10 +32037,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -31628,11 +32058,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -31651,6 +32089,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -31819,7 +32267,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variable `z` Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 `z` Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -31839,6 +32287,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -32001,7 +32455,7 @@ } }, "texttemplate": { - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variable `z`", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variable `z`", "dflt": "", "editType": "plot", "valType": "string" @@ -32753,10 +33207,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -32776,11 +33228,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -32799,6 +33259,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -33091,7 +33561,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variable `z` Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 `z` Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -33111,6 +33581,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -33318,7 +33794,7 @@ } }, "texttemplate": { - "description": "For this trace it only has an effect if `coloring` is set to *heatmap*. Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `x`, `y`, `z` and `text`.", + "description": "For this trace it only has an effect if `coloring` is set to *heatmap*. Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `x`, `y`, `z` and `text`.", "dflt": "", "editType": "plot", "valType": "string" @@ -33781,7 +34257,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry` and `percentParent`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry` and `percentParent`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -33874,6 +34350,12 @@ }, "role": "object" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgrouptitle": { "editType": "style", "font": { @@ -34414,10 +34896,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -34437,11 +34917,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -34460,6 +34948,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colors": { @@ -34511,6 +35009,99 @@ "valType": "string" } }, + "pattern": { + "bgcolor": { + "arrayOk": true, + "description": "When there is no colorscale sets the color of background pattern fill. Defaults to a `marker.color` background when `fillmode` is *overlay*. Otherwise, defaults to a transparent background.", + "editType": "style", + "valType": "color" + }, + "bgcolorsrc": { + "description": "Sets the source reference on Chart Studio Cloud for `bgcolor`.", + "editType": "none", + "valType": "string" + }, + "description": "Sets the pattern within the marker.", + "editType": "style", + "fgcolor": { + "arrayOk": true, + "description": "When there is no colorscale sets the color of foreground pattern fill. Defaults to a `marker.color` background when `fillmode` is *replace*. Otherwise, defaults to dark grey or white to increase contrast with the `bgcolor`.", + "editType": "style", + "valType": "color" + }, + "fgcolorsrc": { + "description": "Sets the source reference on Chart Studio Cloud for `fgcolor`.", + "editType": "none", + "valType": "string" + }, + "fgopacity": { + "description": "Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when `fillmode` is *overlay*. Otherwise, defaults to 1.", + "editType": "style", + "max": 1, + "min": 0, + "valType": "number" + }, + "fillmode": { + "description": "Determines whether `marker.color` should be used as a default to `bgcolor` or a `fgcolor`.", + "dflt": "replace", + "editType": "style", + "valType": "enumerated", + "values": [ + "replace", + "overlay" + ] + }, + "role": "object", + "shape": { + "arrayOk": true, + "description": "Sets the shape of the pattern fill. By default, no pattern is used for filling the area.", + "dflt": "", + "editType": "style", + "valType": "enumerated", + "values": [ + "", + "/", + "\\", + "x", + "-", + "|", + "+", + "." + ] + }, + "shapesrc": { + "description": "Sets the source reference on Chart Studio Cloud for `shape`.", + "editType": "none", + "valType": "string" + }, + "size": { + "arrayOk": true, + "description": "Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.", + "dflt": 8, + "editType": "style", + "min": 0, + "valType": "number" + }, + "sizesrc": { + "description": "Sets the source reference on Chart Studio Cloud for `size`.", + "editType": "none", + "valType": "string" + }, + "solidity": { + "arrayOk": true, + "description": "Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.", + "dflt": 0.3, + "editType": "style", + "max": 1, + "min": 0, + "valType": "number" + }, + "soliditysrc": { + "description": "Sets the source reference on Chart Studio Cloud for `solidity`.", + "editType": "none", + "valType": "string" + } + }, "reversescale": { "description": "Reverses the color mapping if true. Has an effect only if colors is set to a numerical array. If true, `marker.cmin` will correspond to the last color in the array and `marker.cmax` will correspond to the first color.", "dflt": false, @@ -34802,7 +35393,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry`, `percentParent`, `label` and `value`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry`, `percentParent`, `label` and `value`.", "dflt": "", "editType": "plot", "valType": "string" @@ -35065,7 +35656,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variables `z`, `color` and `colormodel`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 variables `z`, `color` and `colormodel`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -35095,6 +35686,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgrouptitle": { "editType": "style", "font": { @@ -35219,7 +35816,7 @@ ] }, "x0": { - "description": "Set the image's x position.", + "description": "Set the image's x position. The left edge of the image (or the right edge if the x axis is reversed or dx is negative) will be found at xmin=x0-dx/2", "dflt": 0, "editType": "calc+clearAxisTypes", "valType": "any" @@ -35231,7 +35828,7 @@ "valType": "subplotid" }, "y0": { - "description": "Set the image's y position.", + "description": "Set the image's y position. The top edge of the image (or the bottom edge if the y axis is NOT reversed or if dy is negative) will be found at ymin=y0-dy/2. By default when an image trace is included, the y axis will be reversed so that the image is right-side-up, but you can disable this by setting yaxis.autorange=true or by providing an explicit y axis range.", "dflt": 0, "editType": "calc+clearAxisTypes", "valType": "any" @@ -35966,6 +36563,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgrouptitle": { "editType": "style", "font": { @@ -36739,10 +37342,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -36762,11 +37363,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -36785,6 +37394,16 @@ "editType": "calc", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -36999,6 +37618,12 @@ "editType": "calc", "valType": "number" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -37967,10 +38592,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -37990,11 +38613,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -38013,6 +38644,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -38288,6 +38929,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -38916,6 +39563,12 @@ }, "role": "object" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -39401,7 +40054,7 @@ ] }, "hovertemplate": { - "description": "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. variables `count`, `probability`, `category`, `categorycount`, `colorcount` and `bandcolorcount`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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. This value here applies when hovering over dimensions. Note that `*categorycount`, *colorcount* and *bandcolorcount* are only available when `hoveron` contains the *color* flagFinally, the template string has access to variables `count`, `probability`, `category`, `categorycount`, `colorcount` and `bandcolorcount`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "plot", "valType": "string" @@ -39961,10 +40614,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -39984,11 +40635,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -40007,6 +40666,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -40025,7 +40694,7 @@ }, "editType": "calc", "hovertemplate": { - "description": "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. variables `count` and `probability`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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. This value here applies when hovering over lines.Finally, the template string has access to variables `count` and `probability`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "plot", "valType": "string" @@ -40390,6 +41059,12 @@ "bottom" ] }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgrouptitle": { "editType": "style", "font": { @@ -40930,10 +41605,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -40953,11 +41626,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -40976,6 +41657,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -41492,7 +42183,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variables `label`, `color`, `value`, `percent` and `text`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 variables `label`, `color`, `value`, `percent` and `text`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -41591,6 +42282,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -41681,6 +42378,99 @@ "valType": "string" } }, + "pattern": { + "bgcolor": { + "arrayOk": true, + "description": "When there is no colorscale sets the color of background pattern fill. Defaults to a `marker.color` background when `fillmode` is *overlay*. Otherwise, defaults to a transparent background.", + "editType": "style", + "valType": "color" + }, + "bgcolorsrc": { + "description": "Sets the source reference on Chart Studio Cloud for `bgcolor`.", + "editType": "none", + "valType": "string" + }, + "description": "Sets the pattern within the marker.", + "editType": "style", + "fgcolor": { + "arrayOk": true, + "description": "When there is no colorscale sets the color of foreground pattern fill. Defaults to a `marker.color` background when `fillmode` is *replace*. Otherwise, defaults to dark grey or white to increase contrast with the `bgcolor`.", + "editType": "style", + "valType": "color" + }, + "fgcolorsrc": { + "description": "Sets the source reference on Chart Studio Cloud for `fgcolor`.", + "editType": "none", + "valType": "string" + }, + "fgopacity": { + "description": "Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when `fillmode` is *overlay*. Otherwise, defaults to 1.", + "editType": "style", + "max": 1, + "min": 0, + "valType": "number" + }, + "fillmode": { + "description": "Determines whether `marker.color` should be used as a default to `bgcolor` or a `fgcolor`.", + "dflt": "replace", + "editType": "style", + "valType": "enumerated", + "values": [ + "replace", + "overlay" + ] + }, + "role": "object", + "shape": { + "arrayOk": true, + "description": "Sets the shape of the pattern fill. By default, no pattern is used for filling the area.", + "dflt": "", + "editType": "style", + "valType": "enumerated", + "values": [ + "", + "/", + "\\", + "x", + "-", + "|", + "+", + "." + ] + }, + "shapesrc": { + "description": "Sets the source reference on Chart Studio Cloud for `shape`.", + "editType": "none", + "valType": "string" + }, + "size": { + "arrayOk": true, + "description": "Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.", + "dflt": 8, + "editType": "style", + "min": 0, + "valType": "number" + }, + "sizesrc": { + "description": "Sets the source reference on Chart Studio Cloud for `size`.", + "editType": "none", + "valType": "string" + }, + "solidity": { + "arrayOk": true, + "description": "Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.", + "dflt": 0.3, + "editType": "style", + "max": 1, + "min": 0, + "valType": "number" + }, + "soliditysrc": { + "description": "Sets the source reference on Chart Studio Cloud for `solidity`.", + "editType": "none", + "valType": "string" + } + }, "role": "object" }, "meta": { @@ -41886,7 +42676,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `label`, `color`, `value`, `percent` and `text`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `label`, `color`, `value`, `percent` and `text`.", "dflt": "", "editType": "plot", "valType": "string" @@ -42187,6 +42977,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -42657,6 +43453,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgrouptitle": { "editType": "style", "font": { @@ -42894,7 +43696,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variables `value` and `label`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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. Variables `source` and `target` are node objects.Finally, the template string has access to variables `value` and `label`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "calc", "valType": "string" @@ -43143,7 +43945,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variables `value` and `label`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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. Variables `sourceLinks` and `targetLinks` are arrays of link objects.Finally, the template string has access to variables `value` and `label`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "calc", "valType": "string" @@ -43859,6 +44661,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -44503,10 +45311,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -44526,11 +45332,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -44549,6 +45363,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -46216,6 +47040,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -46762,10 +47592,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -46785,11 +47613,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -46808,6 +47644,16 @@ "editType": "calc", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -47357,10 +48203,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -47380,11 +48224,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -47403,6 +48255,16 @@ "editType": "calc", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -48217,6 +49079,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -48846,10 +49714,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -48869,11 +49735,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -48892,6 +49766,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -49792,7 +50676,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `a`, `b` and `text`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `a`, `b` and `text`.", "dflt": "", "editType": "plot", "valType": "string" @@ -50110,6 +50994,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -50741,10 +51631,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -50764,11 +51652,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -50787,6 +51683,16 @@ "editType": "calc", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -51680,7 +52586,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `lat`, `lon`, `location` and `text`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `lat`, `lon`, `location` and `text`.", "dflt": "", "editType": "calc", "valType": "string" @@ -52170,6 +53076,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -52771,10 +53683,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -52794,11 +53704,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -52817,6 +53735,16 @@ "editType": "calc", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -54173,6 +55101,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -54763,10 +55697,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -54786,11 +55718,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -54809,6 +55749,16 @@ "editType": "calc", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -55055,7 +56005,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `lat`, `lon` and `text`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `lat`, `lon` and `text`.", "dflt": "", "editType": "calc", "valType": "string" @@ -55350,6 +56300,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -55979,10 +56935,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -56002,11 +56956,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -56025,6 +56987,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -56946,7 +57918,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `r`, `theta` and `text`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `r`, `theta` and `text`.", "dflt": "", "editType": "plot", "valType": "string" @@ -57265,6 +58237,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -57866,10 +58844,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -57889,11 +58865,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -57912,6 +58896,16 @@ "editType": "calc", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -58780,7 +59774,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `r`, `theta` and `text`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `r`, `theta` and `text`.", "dflt": "", "editType": "plot", "valType": "string" @@ -59111,6 +60105,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -59740,10 +60740,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -59763,11 +60761,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -59786,6 +60792,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -60701,7 +61717,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `real`, `imag` and `text`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `real`, `imag` and `text`.", "dflt": "", "editType": "plot", "valType": "string" @@ -61024,6 +62040,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -61653,10 +62675,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -61676,11 +62696,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -61699,6 +62727,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -62612,7 +63650,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `a`, `b`, `c` and `text`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `a`, `b`, `c` and `text`.", "dflt": "", "editType": "plot", "valType": "string" @@ -62939,6 +63977,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -63497,10 +64541,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -63520,11 +64562,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -63543,6 +64593,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -64914,10 +65974,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -64937,11 +65995,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -64960,6 +66026,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -65107,7 +66183,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variables `tubex`, `tubey`, `tubez`, `tubeu`, `tubev`, `tubew`, `norm` and `divergence`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 variables `tubex`, `tubey`, `tubez`, `tubeu`, `tubev`, `tubew`, `norm` and `divergence`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "calc", "valType": "string" @@ -65133,6 +66209,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -65740,7 +66822,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry` and `percentParent`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry` and `percentParent`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -65845,6 +66927,12 @@ }, "role": "object" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgrouptitle": { "editType": "style", "font": { @@ -66385,10 +67473,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -66408,11 +67494,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -66431,6 +67525,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colors": { @@ -66482,6 +67586,99 @@ "valType": "string" } }, + "pattern": { + "bgcolor": { + "arrayOk": true, + "description": "When there is no colorscale sets the color of background pattern fill. Defaults to a `marker.color` background when `fillmode` is *overlay*. Otherwise, defaults to a transparent background.", + "editType": "style", + "valType": "color" + }, + "bgcolorsrc": { + "description": "Sets the source reference on Chart Studio Cloud for `bgcolor`.", + "editType": "none", + "valType": "string" + }, + "description": "Sets the pattern within the marker.", + "editType": "style", + "fgcolor": { + "arrayOk": true, + "description": "When there is no colorscale sets the color of foreground pattern fill. Defaults to a `marker.color` background when `fillmode` is *replace*. Otherwise, defaults to dark grey or white to increase contrast with the `bgcolor`.", + "editType": "style", + "valType": "color" + }, + "fgcolorsrc": { + "description": "Sets the source reference on Chart Studio Cloud for `fgcolor`.", + "editType": "none", + "valType": "string" + }, + "fgopacity": { + "description": "Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when `fillmode` is *overlay*. Otherwise, defaults to 1.", + "editType": "style", + "max": 1, + "min": 0, + "valType": "number" + }, + "fillmode": { + "description": "Determines whether `marker.color` should be used as a default to `bgcolor` or a `fgcolor`.", + "dflt": "replace", + "editType": "style", + "valType": "enumerated", + "values": [ + "replace", + "overlay" + ] + }, + "role": "object", + "shape": { + "arrayOk": true, + "description": "Sets the shape of the pattern fill. By default, no pattern is used for filling the area.", + "dflt": "", + "editType": "style", + "valType": "enumerated", + "values": [ + "", + "/", + "\\", + "x", + "-", + "|", + "+", + "." + ] + }, + "shapesrc": { + "description": "Sets the source reference on Chart Studio Cloud for `shape`.", + "editType": "none", + "valType": "string" + }, + "size": { + "arrayOk": true, + "description": "Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.", + "dflt": 8, + "editType": "style", + "min": 0, + "valType": "number" + }, + "sizesrc": { + "description": "Sets the source reference on Chart Studio Cloud for `size`.", + "editType": "none", + "valType": "string" + }, + "solidity": { + "arrayOk": true, + "description": "Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.", + "dflt": 0.3, + "editType": "style", + "max": 1, + "min": 0, + "valType": "number" + }, + "soliditysrc": { + "description": "Sets the source reference on Chart Studio Cloud for `solidity`.", + "editType": "none", + "valType": "string" + } + }, "reversescale": { "description": "Reverses the color mapping if true. Has an effect only if colors is set to a numerical array. If true, `marker.cmin` will correspond to the last color in the array and `marker.cmax` will correspond to the first color.", "dflt": false, @@ -66684,7 +67881,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry`, `percentParent`, `label` and `value`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry`, `percentParent`, `label` and `value`.", "dflt": "", "editType": "plot", "valType": "string" @@ -67264,10 +68461,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -67287,11 +68482,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -67310,6 +68513,16 @@ "editType": "calc", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -67773,6 +68986,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -68678,6 +69897,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgrouptitle": { "editType": "style", "font": { @@ -69008,7 +70233,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry` and `percentParent`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry` and `percentParent`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -69090,6 +70315,12 @@ "editType": "none", "valType": "string" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgrouptitle": { "editType": "style", "font": { @@ -69630,10 +70861,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -69653,11 +70882,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "colorbars", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -69676,6 +70913,16 @@ "editType": "colorbars", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "colorbars", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colors": { @@ -69772,6 +71019,99 @@ "valType": "number" } }, + "pattern": { + "bgcolor": { + "arrayOk": true, + "description": "When there is no colorscale sets the color of background pattern fill. Defaults to a `marker.color` background when `fillmode` is *overlay*. Otherwise, defaults to a transparent background.", + "editType": "style", + "valType": "color" + }, + "bgcolorsrc": { + "description": "Sets the source reference on Chart Studio Cloud for `bgcolor`.", + "editType": "none", + "valType": "string" + }, + "description": "Sets the pattern within the marker.", + "editType": "style", + "fgcolor": { + "arrayOk": true, + "description": "When there is no colorscale sets the color of foreground pattern fill. Defaults to a `marker.color` background when `fillmode` is *replace*. Otherwise, defaults to dark grey or white to increase contrast with the `bgcolor`.", + "editType": "style", + "valType": "color" + }, + "fgcolorsrc": { + "description": "Sets the source reference on Chart Studio Cloud for `fgcolor`.", + "editType": "none", + "valType": "string" + }, + "fgopacity": { + "description": "Sets the opacity of the foreground pattern fill. Defaults to a 0.5 when `fillmode` is *overlay*. Otherwise, defaults to 1.", + "editType": "style", + "max": 1, + "min": 0, + "valType": "number" + }, + "fillmode": { + "description": "Determines whether `marker.color` should be used as a default to `bgcolor` or a `fgcolor`.", + "dflt": "replace", + "editType": "style", + "valType": "enumerated", + "values": [ + "replace", + "overlay" + ] + }, + "role": "object", + "shape": { + "arrayOk": true, + "description": "Sets the shape of the pattern fill. By default, no pattern is used for filling the area.", + "dflt": "", + "editType": "style", + "valType": "enumerated", + "values": [ + "", + "/", + "\\", + "x", + "-", + "|", + "+", + "." + ] + }, + "shapesrc": { + "description": "Sets the source reference on Chart Studio Cloud for `shape`.", + "editType": "none", + "valType": "string" + }, + "size": { + "arrayOk": true, + "description": "Sets the size of unit squares of the pattern fill in pixels, which corresponds to the interval of repetition of the pattern.", + "dflt": 8, + "editType": "style", + "min": 0, + "valType": "number" + }, + "sizesrc": { + "description": "Sets the source reference on Chart Studio Cloud for `size`.", + "editType": "none", + "valType": "string" + }, + "solidity": { + "arrayOk": true, + "description": "Sets the solidity of the pattern fill. Solidity is roughly the fraction of the area filled by the pattern. Solidity of 0 shows only the background color without pattern and solidty of 1 shows only the foreground color without pattern.", + "dflt": 0.3, + "editType": "style", + "max": 1, + "min": 0, + "valType": "number" + }, + "soliditysrc": { + "description": "Sets the source reference on Chart Studio Cloud for `solidity`.", + "editType": "none", + "valType": "string" + } + }, "reversescale": { "description": "Reverses the color mapping if true. Has an effect only if colors is set to a numerical array. If true, `marker.cmin` will correspond to the last color in the array and `marker.cmax` will correspond to the first color.", "dflt": false, @@ -70063,7 +71403,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry`, `percentParent`, `label` and `value`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry`, `percentParent`, `label` and `value`.", "dflt": "", "editType": "plot", "valType": "string" @@ -70420,6 +71760,12 @@ "min": 0, "valType": "number" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -71975,10 +73321,8 @@ } }, "x": { - "description": "Sets the x position of the color bar (in plot fraction). Defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*.", + "description": "Sets the x position with respect to `xref` of the color bar (in plot fraction). When `xref` is *paper*, defaults to 1.02 when `orientation` is *v* and 0.5 when `orientation` is *h*. When `xref` is *container*, defaults to *1* when `orientation` is *v* and 0.5 when `orientation` is *h*. Must be between *0* and *1* if `xref` is *container* and between *-2* and *3* if `xref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "xanchor": { @@ -71998,11 +73342,19 @@ "min": 0, "valType": "number" }, + "xref": { + "description": "Sets the container `x` refers to. *container* spans the entire `width` of the plot. *paper* refers to the width of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] + }, "y": { - "description": "Sets the y position of the color bar (in plot fraction). Defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*.", + "description": "Sets the y position with respect to `yref` of the color bar (in plot fraction). When `yref` is *paper*, defaults to 0.5 when `orientation` is *v* and 1.02 when `orientation` is *h*. When `yref` is *container*, defaults to 0.5 when `orientation` is *v* and 1 when `orientation` is *h*. Must be between *0* and *1* if `yref` is *container* and between *-2* and *3* if `yref` is *paper*.", "editType": "calc", - "max": 3, - "min": -2, "valType": "number" }, "yanchor": { @@ -72021,6 +73373,16 @@ "editType": "calc", "min": 0, "valType": "number" + }, + "yref": { + "description": "Sets the container `y` refers to. *container* spans the entire `height` of the plot. *paper* refers to the height of the plotting area only.", + "dflt": "paper", + "editType": "calc", + "valType": "enumerated", + "values": [ + "container", + "paper" + ] } }, "colorscale": { @@ -72235,6 +73597,12 @@ "editType": "calc", "valType": "number" }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -72966,7 +74334,7 @@ }, "hovertemplate": { "arrayOk": true, - "description": "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. variables `initial`, `delta` and `final`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", + "description": "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 variables `initial`, `delta` and `final`. Anything contained in tag `` is displayed in the secondary box, for example \"{fullData.name}\". To hide the secondary box completely, use an empty tag ``.", "dflt": "", "editType": "none", "valType": "string" @@ -73080,6 +74448,12 @@ "valType": "string" } }, + "legend": { + "description": "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.", + "dflt": "legend", + "editType": "style", + "valType": "subplotid" + }, "legendgroup": { "description": "Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.", "dflt": "", @@ -73353,7 +74727,7 @@ }, "texttemplate": { "arrayOk": true, - "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. variables `initial`, `delta`, `final` and `label`.", + "description": "Template string used for rendering the information text that appear on points. Note that this will override `textinfo`. Variables are inserted using %{variable}, for example \"y: %{y}\". Numbers are formatted using d3-format's syntax %{variable:d3-format}, for example \"Price: %{y:$.2f}\". https://github.com/d3/d3-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. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. Finally, the template string has access to variables `initial`, `delta`, `final` and `label`.", "dflt": "", "editType": "plot", "valType": "string" @@ -73577,7 +74951,7 @@ } }, "meta": { - "description": "Draws waterfall trace which is useful graph to displays the contribution of various elements (either positive or negative) in a bar chart. The data visualized by the span of the bars is set in `y` if `orientation` is set th *v* (the default) and the labels are set in `x`. By setting `orientation` to *h*, the roles are interchanged." + "description": "Draws waterfall trace which is useful graph to displays the contribution of various elements (either positive or negative) in a bar chart. The data visualized by the span of the bars is set in `y` if `orientation` is set to *v* (the default) and the labels are set in `x`. By setting `orientation` to *h*, the roles are interchanged." }, "type": "waterfall" } diff --git a/packages/python/plotly/plotly/_subplots.py b/packages/python/plotly/plotly/_subplots.py index 24ec630e01d..f2606f49e45 100644 --- a/packages/python/plotly/plotly/_subplots.py +++ b/packages/python/plotly/plotly/_subplots.py @@ -671,7 +671,6 @@ def _check_hv_spacing(dimsize, spacing, name, dimvarname, dimname): # Loop through specs -- (r, c) <-> (row, col) for r, spec_row in enumerate(specs): for c, spec in enumerate(spec_row): - if spec is None: # skip over None cells continue @@ -702,6 +701,46 @@ def _check_hv_spacing(dimsize, spacing, name, dimvarname, dimname): else: y_s = grid[r_spanned][c][1] + spec["b"] y_e = grid[r][c][1] + heights[-1 - r] - spec["t"] + + if y_s < 0.0: + # round for values very close to one + # handles some floating point errors + if y_s > -0.01: + y_s = 0.0 + else: + raise Exception( + "A combination of the 'b' values, heights, and " + "number of subplots too large for this subplot grid." + ) + if y_s > 1.0: + # round for values very close to one + # handles some floating point errors + if y_s < 1.01: + y_s = 1.0 + else: + raise Exception( + "A combination of the 'b' values, heights, and " + "number of subplots too large for this subplot grid." + ) + + if y_e < 0.0: + if y_e > -0.01: + y_e = 0.0 + else: + raise Exception( + "A combination of the 't' values, heights, and " + "number of subplots too large for this subplot grid." + ) + + if y_e > 1.0: + if y_e < 1.01: + y_e = 1.0 + else: + raise Exception( + "A combination of the 't' values, heights, and " + "number of subplots too large for this subplot grid." + ) + y_domain = [y_s, y_e] list_of_domains.append(x_domain) @@ -726,7 +765,6 @@ def _check_hv_spacing(dimsize, spacing, name, dimvarname, dimname): insets_ref = [None for inset in range(len(insets))] if insets else None if insets: for i_inset, inset in enumerate(insets): - r = inset["cell"][0] - 1 c = inset["cell"][1] - 1 @@ -1052,7 +1090,6 @@ def _subplot_type_for_trace_type(trace_type): def _validate_coerce_subplot_type(subplot_type): - # Lowercase subplot_type orig_subplot_type = subplot_type subplot_type = subplot_type.lower() @@ -1200,7 +1237,6 @@ def _build_subplot_title_annotations( def _build_grid_str(specs, grid_ref, insets, insets_ref, row_seq): - # Compute rows and columns rows = len(specs) cols = len(specs[0]) @@ -1257,7 +1293,6 @@ def _pad(s, cell_len=cell_len): # Loop through specs, fill in _tmp for r, spec_row in enumerate(specs): for c, spec in enumerate(spec_row): - ref = grid_ref[r][c] if ref is None: if _tmp[r][c] == "": @@ -1339,7 +1374,6 @@ def _pad(s, cell_len=cell_len): def _set_trace_grid_reference(trace, layout, grid_ref, row, col, secondary_y=False): - if row <= 0: raise Exception( "Row value is out of range. " "Note: the starting cell is (1, 1)" @@ -1461,7 +1495,6 @@ def _get_grid_subplot(fig, row, col, secondary_y=False): def _get_subplot_ref_for_trace(trace): - if "domain" in trace: return SubplotRef( subplot_type="domain", diff --git a/packages/python/plotly/plotly/_widget_version.py b/packages/python/plotly/plotly/_widget_version.py index 99ed389a0b4..6bd26c202ff 100644 --- a/packages/python/plotly/plotly/_widget_version.py +++ b/packages/python/plotly/plotly/_widget_version.py @@ -2,4 +2,4 @@ # for automated dev builds # # It is edited by hand prior to official releases -__frontend_version__ = "^5.14.1" +__frontend_version__ = "^5.15.0" diff --git a/packages/python/plotly/plotly/basedatatypes.py b/packages/python/plotly/plotly/basedatatypes.py index bf5eac3dfab..8fa70e0adaa 100644 --- a/packages/python/plotly/plotly/basedatatypes.py +++ b/packages/python/plotly/plotly/basedatatypes.py @@ -1559,17 +1559,31 @@ def _add_annotation_like( subplot_type=refs[0].subplot_type, ) ) - if len(refs) == 1 and secondary_y: - raise ValueError( - """ -Cannot add {prop_singular} to secondary y-axis of subplot at position ({r}, {c}) -because subplot does not have a secondary y-axis""" - ) - if secondary_y: - xaxis, yaxis = refs[1].layout_keys + + # If the new_object was created with a yref specified that did not include paper or domain, the specified yref should be used otherwise assign the xref and yref from the layout_keys + if ( + new_obj.yref is None + or new_obj.yref == "y" + or "paper" in new_obj.yref + or "domain" in new_obj.yref + ): + if len(refs) == 1 and secondary_y: + raise ValueError( + """ + Cannot add {prop_singular} to secondary y-axis of subplot at position ({r}, {c}) + because subplot does not have a secondary y-axis""".format( + prop_singular=prop_singular, r=row, c=col + ) + ) + if secondary_y: + xaxis, yaxis = refs[1].layout_keys + else: + xaxis, yaxis = refs[0].layout_keys + xref, yref = xaxis.replace("axis", ""), yaxis.replace("axis", "") else: - xaxis, yaxis = refs[0].layout_keys - xref, yref = xaxis.replace("axis", ""), yaxis.replace("axis", "") + yref = new_obj.yref + xaxis = refs[0].layout_keys[0] + xref = xaxis.replace("axis", "") # if exclude_empty_subplots is True, check to see if subplot is # empty and return if it is if exclude_empty_subplots and ( @@ -1591,6 +1605,11 @@ def _add_domain(ax_letter, new_axref): new_obj.update(xref=xref, yref=yref) self.layout[prop_plural] += (new_obj,) + # The 'new_obj.xref' and 'new_obj.yref' parameters need to be reset otherwise it + # will appear as if user supplied yref params when looping through subplots and + # will force annotation to be on the axis of the last drawn annotation + # i.e. they all end up on the same axis. + new_obj.update(xref=None, yref=None) return self @@ -4034,6 +4053,7 @@ def _process_multiple_axis_spanning_shapes( row=row, col=col, exclude_empty_subplots=exclude_empty_subplots, + yref=shape_kwargs.get("yref", "y"), ) # update xref and yref for the new shapes and annotations for layout_obj, n_layout_objs_before in zip( @@ -4045,10 +4065,13 @@ def _process_multiple_axis_spanning_shapes( ): # this was called intending to add to a single plot (and # self.add_{layout_obj} succeeded) - # however, in the case of a single plot, xref and yref are not - # specified, so we specify them here so the following routines can work - # (they need to append " domain" to xref or yref) - self.layout[layout_obj][-1].update(xref="x", yref="y") + # however, in the case of a single plot, xref and yref MAY not be + # specified, IF they are not specified we specify them here so the following routines can work + # (they need to append " domain" to xref or yref). If they are specified, we leave them alone. + if self.layout[layout_obj][-1].xref is None: + self.layout[layout_obj][-1].update(xref="x") + if self.layout[layout_obj][-1].yref is None: + self.layout[layout_obj][-1].update(yref="y") new_layout_objs = tuple( filter( lambda x: x is not None, diff --git a/packages/python/plotly/plotly/express/_core.py b/packages/python/plotly/plotly/express/_core.py index 39dabba6351..cd51b86e150 100644 --- a/packages/python/plotly/plotly/express/_core.py +++ b/packages/python/plotly/plotly/express/_core.py @@ -268,7 +268,7 @@ def make_trace_kwargs(args, trace_spec, trace_data, mapping_labels, sizeref): fit information to be used for trendlines """ if "line_close" in args and args["line_close"]: - trace_data = trace_data.append(trace_data.iloc[0]) + trace_data = pd.concat([trace_data, trace_data.iloc[:1]]) trace_patch = trace_spec.trace_patch.copy() or {} fit_results = None hover_header = "" @@ -1307,7 +1307,10 @@ def build_dataframe(args, constructor): # Cast data_frame argument to DataFrame (it could be a numpy array, dict etc.) df_provided = args["data_frame"] is not None if df_provided and not isinstance(args["data_frame"], pd.DataFrame): - args["data_frame"] = pd.DataFrame(args["data_frame"]) + if hasattr(args["data_frame"], "to_pandas"): + args["data_frame"] = args["data_frame"].to_pandas() + else: + args["data_frame"] = pd.DataFrame(args["data_frame"]) df_input = args["data_frame"] # now we handle special cases like wide-mode or x-xor-y specification @@ -1880,6 +1883,10 @@ def infer_config(args, constructor, trace_patch, layout_patch): args[position] = args["marginal"] args[other_position] = None + # Ignore facet rows and columns when data frame is empty so as to prevent nrows/ncols equaling 0 + if len(args["data_frame"]) == 0: + args["facet_row"] = args["facet_col"] = None + # If both marginals and faceting are specified, faceting wins if args.get("facet_col") is not None and args.get("marginal_y") is not None: args["marginal_y"] = None diff --git a/packages/python/plotly/plotly/figure_factory/_streamline.py b/packages/python/plotly/plotly/figure_factory/_streamline.py index 108b20c5d3a..e2eac0af0c8 100644 --- a/packages/python/plotly/plotly/figure_factory/_streamline.py +++ b/packages/python/plotly/plotly/figure_factory/_streamline.py @@ -381,15 +381,13 @@ def get_streamline_arrows(self): space = np.empty((len(point1_x))) space[:] = np.nan - # Combine arrays into matrix - arrows_x = np.matrix([point1_x, arrow_end_x, point2_x, space]) - arrows_x = np.array(arrows_x) + # Combine arrays into array + arrows_x = np.array([point1_x, arrow_end_x, point2_x, space]) arrows_x = arrows_x.flatten("F") arrows_x = arrows_x.tolist() - # Combine arrays into matrix - arrows_y = np.matrix([point1_y, arrow_end_y, point2_y, space]) - arrows_y = np.array(arrows_y) + # Combine arrays into array + arrows_y = np.array([point1_y, arrow_end_y, point2_y, space]) arrows_y = arrows_y.flatten("F") arrows_y = arrows_y.tolist() diff --git a/packages/python/plotly/plotly/graph_objs/_bar.py b/packages/python/plotly/plotly/graph_objs/_bar.py index 2f8561ff52b..d7e86b30893 100644 --- a/packages/python/plotly/plotly/graph_objs/_bar.py +++ b/packages/python/plotly/plotly/graph_objs/_bar.py @@ -31,6 +31,7 @@ class Bar(_BaseTraceType): "idssrc", "insidetextanchor", "insidetextfont", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -567,11 +568,12 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `value` and `label`. Anything contained in tag `` is - displayed in the secondary box, for example - "{fullData.name}". To hide the secondary box - completely, use an empty tag ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variables `value` and `label`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To + hide the secondary box completely, use an empty tag + ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -776,6 +778,31 @@ def insidetextfont(self): def insidetextfont(self, val): self["insidetextfont"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1531,7 +1558,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `value` and `label`. + Finally, the template string has access to variables `value` + and `label`. The 'texttemplate' property is a string and must be specified as: - A string @@ -2221,11 +2249,12 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `value` and `label`. Anything - contained in tag `` is displayed in the - secondary box, for example - "{fullData.name}". To hide the secondary - box completely, use an empty tag ``. + are available. Finally, the template string has access + to variables `value` and `label`. Anything contained in + tag `` is displayed in the secondary box, for + example "{fullData.name}". To hide the + secondary box completely, use an empty tag + ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -2251,6 +2280,12 @@ def _prop_descriptions(self): points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -2374,7 +2409,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `value` and `label`. + are available. Finally, the template string has access + to variables `value` and `label`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2530,6 +2566,7 @@ def __init__( idssrc=None, insidetextanchor=None, insidetextfont=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2586,7 +2623,7 @@ def __init__( Construct a new Bar object The data visualized by the span of the bars is set in `y` if - `orientation` is set th "v" (the default) and the labels are + `orientation` is set to "v" (the default) and the labels are set in `x`. By setting `orientation` to "h", the roles are interchanged. @@ -2669,11 +2706,12 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `value` and `label`. Anything - contained in tag `` is displayed in the - secondary box, for example - "{fullData.name}". To hide the secondary - box completely, use an empty tag ``. + are available. Finally, the template string has access + to variables `value` and `label`. Anything contained in + tag `` is displayed in the secondary box, for + example "{fullData.name}". To hide the + secondary box completely, use an empty tag + ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -2699,6 +2737,12 @@ def __init__( points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -2822,7 +2866,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `value` and `label`. + are available. Finally, the template string has access + to variables `value` and `label`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -3073,6 +3118,10 @@ def __init__( _v = insidetextfont if insidetextfont is not None else _v if _v is not None: self["insidetextfont"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_barpolar.py b/packages/python/plotly/plotly/graph_objs/_barpolar.py index a837f40a30b..bb4fc04a89f 100644 --- a/packages/python/plotly/plotly/graph_objs/_barpolar.py +++ b/packages/python/plotly/plotly/graph_objs/_barpolar.py @@ -24,6 +24,7 @@ class Barpolar(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -441,6 +442,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1352,6 +1378,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -1505,6 +1537,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1624,6 +1657,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -1851,6 +1890,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_box.py b/packages/python/plotly/plotly/graph_objs/_box.py index cc062566d29..1847f9d2f52 100644 --- a/packages/python/plotly/plotly/graph_objs/_box.py +++ b/packages/python/plotly/plotly/graph_objs/_box.py @@ -28,6 +28,7 @@ class Box(_BaseTraceType): "ids", "idssrc", "jitter", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -618,6 +619,31 @@ def jitter(self): def jitter(self, val): self["jitter"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -2212,6 +2238,12 @@ def _prop_descriptions(self): If 0, the sample points align along the distribution axis. If 1, the sample points are drawn in a random jitter of width equal to the width of the box(es). + 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 part of the same legend group hide/show at the same time when @@ -2551,6 +2583,7 @@ def __init__( ids=None, idssrc=None, jitter=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2750,6 +2783,12 @@ def __init__( If 0, the sample points align along the distribution axis. If 1, the sample points are drawn in a random jitter of width equal to the width of the box(es). + 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 part of the same legend group hide/show at the same time when @@ -3175,6 +3214,10 @@ def __init__( _v = jitter if jitter is not None else _v if _v is not None: self["jitter"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_candlestick.py b/packages/python/plotly/plotly/graph_objs/_candlestick.py index 84d4b8e7d97..96126cd6441 100644 --- a/packages/python/plotly/plotly/graph_objs/_candlestick.py +++ b/packages/python/plotly/plotly/graph_objs/_candlestick.py @@ -24,6 +24,7 @@ class Candlestick(_BaseTraceType): "ids", "idssrc", "increasing", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -443,6 +444,31 @@ def increasing(self): def increasing(self, val): self["increasing"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1264,6 +1290,12 @@ def _prop_descriptions(self): increasing :class:`plotly.graph_objects.candlestick.Increasing` instance or dict with compatible properties + 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 part of the same legend group hide/show at the same time when @@ -1448,6 +1480,7 @@ def __init__( ids=None, idssrc=None, increasing=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1546,6 +1579,12 @@ def __init__( increasing :class:`plotly.graph_objects.candlestick.Increasing` instance or dict with compatible properties + 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 part of the same legend group hide/show at the same time when @@ -1804,6 +1843,10 @@ def __init__( _v = increasing if increasing is not None else _v if _v is not None: self["increasing"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_carpet.py b/packages/python/plotly/plotly/graph_objs/_carpet.py index acc4303590e..b45d261a7b3 100644 --- a/packages/python/plotly/plotly/graph_objs/_carpet.py +++ b/packages/python/plotly/plotly/graph_objs/_carpet.py @@ -27,6 +27,7 @@ class Carpet(_BaseTraceType): "font", "ids", "idssrc", + "legend", "legendgrouptitle", "legendrank", "legendwidth", @@ -985,6 +986,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgrouptitle # ---------------- @property @@ -1463,6 +1489,12 @@ def _prop_descriptions(self): 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. legendgrouptitle :class:`plotly.graph_objects.carpet.Legendgrouptitle` instance or dict with compatible properties @@ -1574,6 +1606,7 @@ def __init__( font=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -1668,6 +1701,12 @@ def __init__( 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. legendgrouptitle :class:`plotly.graph_objects.carpet.Legendgrouptitle` instance or dict with compatible properties @@ -1862,6 +1901,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgrouptitle", None) _v = legendgrouptitle if legendgrouptitle is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_choropleth.py b/packages/python/plotly/plotly/graph_objs/_choropleth.py index 63a99370905..fc18bac7435 100644 --- a/packages/python/plotly/plotly/graph_objs/_choropleth.py +++ b/packages/python/plotly/plotly/graph_objs/_choropleth.py @@ -27,6 +27,7 @@ class Choropleth(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -354,9 +355,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -366,10 +373,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -379,6 +396,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -815,6 +836,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1626,6 +1672,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -1783,6 +1835,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1935,6 +1988,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2175,6 +2234,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_choroplethmapbox.py b/packages/python/plotly/plotly/graph_objs/_choroplethmapbox.py index 6cff9fba79d..07452cf6b00 100644 --- a/packages/python/plotly/plotly/graph_objs/_choroplethmapbox.py +++ b/packages/python/plotly/plotly/graph_objs/_choroplethmapbox.py @@ -27,6 +27,7 @@ class Choroplethmapbox(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -379,9 +380,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -391,10 +398,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -404,6 +421,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -687,11 +708,11 @@ def hovertemplate(self): 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. variable - `properties` Anything contained in tag `` is displayed - in the secondary box, for example - "{fullData.name}". To hide the secondary box - completely, use an empty tag ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variable `properties` Anything + contained in tag `` is displayed in the secondary box, + for example "{fullData.name}". To hide the + secondary box completely, use an empty tag ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -814,6 +835,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1604,8 +1650,9 @@ def _prop_descriptions(self): 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. variable `properties` Anything contained - in tag `` is displayed in the secondary box, for + are available. Finally, the template string has access + to variable `properties` Anything contained in tag + `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -1624,6 +1671,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -1779,6 +1832,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1911,8 +1965,9 @@ def __init__( 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. variable `properties` Anything contained - in tag `` is displayed in the secondary box, for + are available. Finally, the template string has access + to variable `properties` Anything contained in tag + `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -1931,6 +1986,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2169,6 +2230,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_cone.py b/packages/python/plotly/plotly/graph_objs/_cone.py index 0a053419ef9..bd45bb5917e 100644 --- a/packages/python/plotly/plotly/graph_objs/_cone.py +++ b/packages/python/plotly/plotly/graph_objs/_cone.py @@ -29,6 +29,7 @@ class Cone(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -477,9 +478,15 @@ def colorbar(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -489,10 +496,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -502,6 +519,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -740,11 +761,11 @@ def hovertemplate(self): 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. variable - `norm` Anything contained in tag `` is displayed in the - secondary box, for example "{fullData.name}". To - hide the secondary box completely, use an empty tag - ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variable `norm` Anything + contained in tag `` is displayed in the secondary box, + for example "{fullData.name}". To hide the + secondary box completely, use an empty tag ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -867,6 +888,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1953,11 +1999,11 @@ def _prop_descriptions(self): 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. variable `norm` Anything contained in - tag `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variable `norm` Anything contained in tag `` + is displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -1973,6 +2019,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -2210,6 +2262,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2359,11 +2412,11 @@ def __init__( 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. variable `norm` Anything contained in - tag `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variable `norm` Anything contained in tag `` + is displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -2379,6 +2432,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2705,6 +2764,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_contour.py b/packages/python/plotly/plotly/graph_objs/_contour.py index a3a7a8a538f..9c9481d3fe8 100644 --- a/packages/python/plotly/plotly/graph_objs/_contour.py +++ b/packages/python/plotly/plotly/graph_objs/_contour.py @@ -31,6 +31,7 @@ class Contour(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -401,9 +402,15 @@ def colorbar(self): title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -413,10 +420,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -426,6 +443,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -1021,6 +1042,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1475,7 +1521,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `x`, `y`, `z` and `text`. + Finally, the template string has access to variables `x`, `y`, + `z` and `text`. The 'texttemplate' property is a string and must be specified as: - A string @@ -2333,6 +2380,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -2418,7 +2471,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `x`, `y`, `z` and `text`. + are available. Finally, the template string has access + to variables `x`, `y`, `z` and `text`. transpose Transposes the z data. uid @@ -2606,6 +2660,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2790,6 +2845,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2875,7 +2936,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `x`, `y`, `z` and `text`. + are available. Finally, the template string has access + to variables `x`, `y`, `z` and `text`. transpose Transposes the z data. uid @@ -3158,6 +3220,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_contourcarpet.py b/packages/python/plotly/plotly/graph_objs/_contourcarpet.py index c75daed7ed4..d16a44163d3 100644 --- a/packages/python/plotly/plotly/graph_objs/_contourcarpet.py +++ b/packages/python/plotly/plotly/graph_objs/_contourcarpet.py @@ -33,6 +33,7 @@ class Contourcarpet(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -575,9 +576,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -587,10 +594,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -600,6 +617,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -979,6 +1000,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1753,6 +1799,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -1910,6 +1962,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2051,6 +2104,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2309,6 +2368,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_densitymapbox.py b/packages/python/plotly/plotly/graph_objs/_densitymapbox.py index dee9a665e7b..a46f42cb48d 100644 --- a/packages/python/plotly/plotly/graph_objs/_densitymapbox.py +++ b/packages/python/plotly/plotly/graph_objs/_densitymapbox.py @@ -27,6 +27,7 @@ class Densitymapbox(_BaseTraceType): "idssrc", "lat", "latsrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -378,9 +379,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -390,10 +397,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -403,6 +420,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -811,6 +832,31 @@ def latsrc(self): def latsrc(self, val): self["latsrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1574,6 +1620,12 @@ def _prop_descriptions(self): latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the same time when @@ -1729,6 +1781,7 @@ def __init__( idssrc=None, lat=None, latsrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1878,6 +1931,12 @@ def __init__( latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the same time when @@ -2116,6 +2175,10 @@ def __init__( _v = latsrc if latsrc is not None else _v if _v is not None: self["latsrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_figure.py b/packages/python/plotly/plotly/graph_objs/_figure.py index 1457f8079f3..1d42fc214d4 100644 --- a/packages/python/plotly/plotly/graph_objs/_figure.py +++ b/packages/python/plotly/plotly/graph_objs/_figure.py @@ -1231,6 +1231,7 @@ def add_bar( idssrc=None, insidetextanchor=None, insidetextfont=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1290,7 +1291,7 @@ def add_bar( Add a new Bar trace The data visualized by the span of the bars is set in `y` if - `orientation` is set th "v" (the default) and the labels are + `orientation` is set to "v" (the default) and the labels are set in `x`. By setting `orientation` to "h", the roles are interchanged. @@ -1370,11 +1371,12 @@ def add_bar( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `value` and `label`. Anything - contained in tag `` is displayed in the - secondary box, for example - "{fullData.name}". To hide the secondary - box completely, use an empty tag ``. + are available. Finally, the template string has access + to variables `value` and `label`. Anything contained in + tag `` is displayed in the secondary box, for + example "{fullData.name}". To hide the + secondary box completely, use an empty tag + ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -1400,6 +1402,12 @@ def add_bar( points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -1523,7 +1531,8 @@ def add_bar( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `value` and `label`. + are available. Finally, the template string has access + to variables `value` and `label`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1702,6 +1711,7 @@ def add_bar( idssrc=idssrc, insidetextanchor=insidetextanchor, insidetextfont=insidetextfont, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -1773,6 +1783,7 @@ def add_barpolar( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1891,6 +1902,12 @@ def add_barpolar( 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 part of the same legend group hide/show at the same time when @@ -2057,6 +2074,7 @@ def add_barpolar( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -2113,6 +2131,7 @@ def add_box( ids=None, idssrc=None, jitter=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2312,6 +2331,12 @@ def add_box( If 0, the sample points align along the distribution axis. If 1, the sample points are drawn in a random jitter of width equal to the width of the box(es). + 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 part of the same legend group hide/show at the same time when @@ -2674,6 +2699,7 @@ def add_box( ids=ids, idssrc=idssrc, jitter=jitter, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -2757,6 +2783,7 @@ def add_candlestick( ids=None, idssrc=None, increasing=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2855,6 +2882,12 @@ def add_candlestick( increasing :class:`plotly.graph_objects.candlestick.Increasing` instance or dict with compatible properties + 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 part of the same legend group hide/show at the same time when @@ -3062,6 +3095,7 @@ def add_candlestick( ids=ids, idssrc=idssrc, increasing=increasing, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -3118,6 +3152,7 @@ def add_carpet( font=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -3212,6 +3247,12 @@ def add_carpet( 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. legendgrouptitle :class:`plotly.graph_objects.carpet.Legendgrouptitle` instance or dict with compatible properties @@ -3346,6 +3387,7 @@ def add_carpet( font=font, ids=ids, idssrc=idssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -3387,6 +3429,7 @@ def add_choropleth( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -3538,6 +3581,12 @@ def add_choropleth( 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 part of the same legend group hide/show at the same time when @@ -3708,6 +3757,7 @@ def add_choropleth( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -3761,6 +3811,7 @@ def add_choroplethmapbox( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -3891,8 +3942,9 @@ def add_choroplethmapbox( 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. variable `properties` Anything contained - in tag `` is displayed in the secondary box, for + are available. Finally, the template string has access + to variable `properties` Anything contained in tag + `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -3911,6 +3963,12 @@ def add_choroplethmapbox( 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 part of the same legend group hide/show at the same time when @@ -4079,6 +4137,7 @@ def add_choroplethmapbox( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -4134,6 +4193,7 @@ def add_cone( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -4282,11 +4342,11 @@ def add_cone( 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. variable `norm` Anything contained in - tag `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variable `norm` Anything contained in tag `` + is displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -4302,6 +4362,12 @@ def add_cone( 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 part of the same legend group hide/show at the same time when @@ -4552,6 +4618,7 @@ def add_cone( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -4620,6 +4687,7 @@ def add_contour( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -4804,6 +4872,12 @@ def add_contour( 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 part of the same legend group hide/show at the same time when @@ -4889,7 +4963,8 @@ def add_contour( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `x`, `y`, `z` and `text`. + are available. Finally, the template string has access + to variables `x`, `y`, `z` and `text`. transpose Transposes the z data. uid @@ -5100,6 +5175,7 @@ def add_contour( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -5179,6 +5255,7 @@ def add_contourcarpet( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -5320,6 +5397,12 @@ def add_contourcarpet( 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 part of the same legend group hide/show at the same time when @@ -5500,6 +5583,7 @@ def add_contourcarpet( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -5552,6 +5636,7 @@ def add_densitymapbox( idssrc=None, lat=None, latsrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -5700,6 +5785,12 @@ def add_densitymapbox( latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the same time when @@ -5868,6 +5959,7 @@ def add_densitymapbox( idssrc=idssrc, lat=lat, latsrc=latsrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -5921,6 +6013,7 @@ def add_funnel( idssrc=None, insidetextanchor=None, insidetextfont=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -6046,10 +6139,10 @@ def add_funnel( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `percentInitial`, - `percentPrevious` and `percentTotal`. Anything - contained in tag `` is displayed in the - secondary box, for example + are available. Finally, the template string has access + to variables `percentInitial`, `percentPrevious` and + `percentTotal`. Anything contained in tag `` is + displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -6077,6 +6170,12 @@ def add_funnel( points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -6202,8 +6301,9 @@ def add_funnel( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `percentInitial`, - `percentPrevious`, `percentTotal`, `label` and `value`. + are available. Finally, the template string has access + to variables `percentInitial`, `percentPrevious`, + `percentTotal`, `label` and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -6369,6 +6469,7 @@ def add_funnel( idssrc=idssrc, insidetextanchor=insidetextanchor, insidetextfont=insidetextfont, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -6439,6 +6540,7 @@ def add_funnelarea( label0=None, labels=None, labelssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -6533,12 +6635,12 @@ def add_funnelarea( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `text` and `percent`. Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `text` and + `percent`. Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -6574,6 +6676,12 @@ def add_funnelarea( labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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 part of the same legend group hide/show at the same time when @@ -6660,8 +6768,9 @@ def add_funnelarea( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `text` and `percent`. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `text` and + `percent`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -6738,6 +6847,7 @@ def add_funnelarea( label0=label0, labels=labels, labelssrc=labelssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -6789,6 +6899,7 @@ def add_heatmap( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -6971,6 +7082,12 @@ def add_heatmap( 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 part of the same legend group hide/show at the same time when @@ -7045,7 +7162,8 @@ def add_heatmap( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `x`, `y`, `z` and `text`. + are available. Finally, the template string has access + to variables `x`, `y`, `z` and `text`. transpose Transposes the z data. uid @@ -7259,6 +7377,7 @@ def add_heatmap( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -7328,6 +7447,7 @@ def add_heatmapgl( hoverlabel=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -7436,6 +7556,12 @@ def add_heatmapgl( 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. legendgrouptitle :class:`plotly.graph_objects.heatmapgl.Legendgrouptitle ` instance or dict with compatible properties @@ -7621,6 +7747,7 @@ def add_heatmapgl( hoverlabel=hoverlabel, ids=ids, idssrc=idssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -7684,6 +7811,7 @@ def add_histogram( idssrc=None, insidetextanchor=None, insidetextfont=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -7851,8 +7979,9 @@ def add_histogram( 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. variable `binNumber` Anything contained - in tag `` is displayed in the secondary box, for + are available. Finally, the template string has access + to variable `binNumber` Anything contained in tag + `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -7876,6 +8005,12 @@ def add_histogram( points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -7997,7 +8132,8 @@ def add_histogram( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label` and `value`. + are available. Finally, the template string has access + to variables `label` and `value`. uid Assign an id to this trace, Use this to provide object constancy between traces during animations and @@ -8136,6 +8272,7 @@ def add_histogram( idssrc=idssrc, insidetextanchor=insidetextanchor, insidetextfont=insidetextfont, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -8200,6 +8337,7 @@ def add_histogram2d( hovertemplatesrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -8375,11 +8513,11 @@ def add_histogram2d( 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. variable `z` Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variable `z` Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -8390,6 +8528,12 @@ def add_histogram2d( 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 part of the same legend group hide/show at the same time when @@ -8474,7 +8618,8 @@ def add_histogram2d( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variable `z` + are available. Finally, the template string has access + to variable `z` uid Assign an id to this trace, Use this to provide object constancy between traces during animations and @@ -8653,6 +8798,7 @@ def add_histogram2d( hovertemplatesrc=hovertemplatesrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -8723,6 +8869,7 @@ def add_histogram2dcontour( hovertemplatesrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -8905,11 +9052,11 @@ def add_histogram2dcontour( 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. variable `z` Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variable `z` Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -8920,6 +9067,12 @@ def add_histogram2dcontour( 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 part of the same legend group hide/show at the same time when @@ -9015,7 +9168,8 @@ def add_histogram2dcontour( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `x`, `y`, `z` and `text`. + are available. Finally, the template string has access + to variables `x`, `y`, `z` and `text`. uid Assign an id to this trace, Use this to provide object constancy between traces during animations and @@ -9190,6 +9344,7 @@ def add_histogram2dcontour( hovertemplatesrc=hovertemplatesrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -9257,6 +9412,7 @@ def add_icicle( labels=None, labelssrc=None, leaf=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -9357,10 +9513,11 @@ def add_icicle( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry` and - `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -9393,6 +9550,12 @@ def add_icicle( leaf :class:`plotly.graph_objects.icicle.Leaf` instance or dict with compatible properties + 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. legendgrouptitle :class:`plotly.graph_objects.icicle.Legendgrouptitle` instance or dict with compatible properties @@ -9500,9 +9663,10 @@ def add_icicle( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry`, - `percentParent`, `label` and `value`. + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry`, `percentParent`, `label` + and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -9579,6 +9743,7 @@ def add_icicle( labels=labels, labelssrc=labelssrc, leaf=leaf, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -9629,6 +9794,7 @@ def add_image( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -9721,8 +9887,9 @@ def add_image( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `z`, `color` and `colormodel`. - Anything contained in tag `` is displayed in the + are available. Finally, the template string has access + to variables `z`, `color` and `colormodel`. Anything + contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -9741,6 +9908,12 @@ def add_image( 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. legendgrouptitle :class:`plotly.graph_objects.image.Legendgrouptitle` instance or dict with compatible properties @@ -9816,14 +9989,23 @@ def add_image( a legend item (provided that the legend itself is visible). x0 - Set the image's x position. + Set the image's x position. The left edge of the image + (or the right edge if the x axis is reversed or dx is + negative) will be found at xmin=x0-dx/2 xaxis Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on. y0 - Set the image's y position. + Set the image's y position. The top edge of the image + (or the bottom edge if the y axis is NOT reversed or if + dy is negative) will be found at ymin=y0-dy/2. By + default when an image trace is included, the y axis + will be reversed so that the image is right-side-up, + but you can disable this by setting + yaxis.autorange=true or by providing an explicit y axis + range. yaxis Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the @@ -9898,6 +10080,7 @@ def add_image( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -9935,6 +10118,7 @@ def add_indicator( gauge=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -9993,6 +10177,12 @@ def add_indicator( 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. legendgrouptitle :class:`plotly.graph_objects.indicator.Legendgrouptitle ` instance or dict with compatible properties @@ -10096,6 +10286,7 @@ def add_indicator( gauge=gauge, ids=ids, idssrc=idssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -10140,6 +10331,7 @@ def add_isosurface( idssrc=None, isomax=None, isomin=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -10314,6 +10506,12 @@ def add_isosurface( Sets the maximum boundary for iso-surface plot. isomin Sets the minimum boundary for iso-surface plot. + 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 part of the same legend group hide/show at the same time when @@ -10535,6 +10733,7 @@ def add_isosurface( idssrc=idssrc, isomax=isomax, isomin=isomin, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -10611,6 +10810,7 @@ def add_mesh3d( jsrc=None, k=None, ksrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -10853,6 +11053,12 @@ def add_mesh3d( ksrc Sets the source reference on Chart Studio Cloud for `k`. + 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 part of the same legend group hide/show at the same time when @@ -11086,6 +11292,7 @@ def add_mesh3d( jsrc=jsrc, k=k, ksrc=ksrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -11141,6 +11348,7 @@ def add_ohlc( ids=None, idssrc=None, increasing=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -11239,6 +11447,12 @@ def add_ohlc( increasing :class:`plotly.graph_objects.ohlc.Increasing` instance or dict with compatible properties + 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 part of the same legend group hide/show at the same time when @@ -11445,6 +11659,7 @@ def add_ohlc( ids=ids, idssrc=idssrc, increasing=increasing, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -11582,12 +11797,17 @@ def add_parcats( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `count`, `probability`, - `category`, `categorycount`, `colorcount` and - `bandcolorcount`. Anything contained in tag `` - is displayed in the secondary box, for example - "{fullData.name}". To hide the secondary - box completely, use an empty tag ``. + are available. This value here applies when hovering + over dimensions. Note that `*categorycount`, + "colorcount" and "bandcolorcount" are only available + when `hoveron` contains the "color" flagFinally, the + template string has access to variables `count`, + `probability`, `category`, `categorycount`, + `colorcount` and `bandcolorcount`. Anything contained + in tag `` is displayed in the secondary box, for + example "{fullData.name}". To hide the + secondary box completely, use an empty tag + ``. labelfont Sets the font for the `dimension` labels. legendgrouptitle @@ -11712,6 +11932,7 @@ def add_parcoords( labelangle=None, labelfont=None, labelside=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -11779,6 +12000,12 @@ def add_parcoords( labels below the graph Tilted labels with "labelangle" may be positioned better inside margins when `labelposition` is set to "bottom". + 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. legendgrouptitle :class:`plotly.graph_objects.parcoords.Legendgrouptitle ` instance or dict with compatible properties @@ -11880,6 +12107,7 @@ def add_parcoords( labelangle=labelangle, labelfont=labelfont, labelside=labelside, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -11921,6 +12149,7 @@ def add_pie( label0=None, labels=None, labelssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -12024,12 +12253,12 @@ def add_pie( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `percent` and `text`. Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `percent` and + `text`. Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -12075,6 +12304,12 @@ def add_pie( labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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 part of the same legend group hide/show at the same time when @@ -12178,8 +12413,9 @@ def add_pie( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `percent` and `text`. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `percent` and + `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -12267,6 +12503,7 @@ def add_pie( label0=label0, labels=labels, labelssrc=labelssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -12315,6 +12552,7 @@ def add_pointcloud( idssrc=None, indices=None, indicessrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -12395,6 +12633,12 @@ def add_pointcloud( indicessrc Sets the source reference on Chart Studio Cloud for `indices`. + 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 part of the same legend group hide/show at the same time when @@ -12562,6 +12806,7 @@ def add_pointcloud( idssrc=idssrc, indices=indices, indicessrc=indicessrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -12604,6 +12849,7 @@ def add_sankey( hoverlabel=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -12671,6 +12917,12 @@ def add_sankey( 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. legendgrouptitle :class:`plotly.graph_objects.sankey.Legendgrouptitle` instance or dict with compatible properties @@ -12784,6 +13036,7 @@ def add_sankey( hoverlabel=hoverlabel, ids=ids, idssrc=idssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -12830,6 +13083,7 @@ def add_scatter( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -13032,6 +13286,12 @@ def add_scatter( 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 part of the same legend group hide/show at the same time when @@ -13346,6 +13606,7 @@ def add_scatter( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -13415,6 +13676,7 @@ def add_scatter3d( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -13549,6 +13811,12 @@ def add_scatter3d( 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 part of the same legend group hide/show at the same time when @@ -13781,6 +14049,7 @@ def add_scatter3d( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -13846,6 +14115,7 @@ def add_scattercarpet( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -13991,6 +14261,12 @@ def add_scattercarpet( 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 part of the same legend group hide/show at the same time when @@ -14093,7 +14369,8 @@ def add_scattercarpet( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `a`, `b` and `text`. + are available. Finally, the template string has access + to variables `a`, `b` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -14185,6 +14462,7 @@ def add_scattercarpet( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -14238,6 +14516,7 @@ def add_scattergeo( idssrc=None, lat=None, latsrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -14386,6 +14665,12 @@ def add_scattergeo( latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the same time when @@ -14508,8 +14793,8 @@ def add_scattergeo( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `lat`, `lon`, `location` and - `text`. + are available. Finally, the template string has access + to variables `lat`, `lon`, `location` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -14580,6 +14865,7 @@ def add_scattergeo( idssrc=idssrc, lat=lat, latsrc=latsrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -14635,6 +14921,7 @@ def add_scattergl( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -14801,6 +15088,12 @@ def add_scattergl( 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 part of the same legend group hide/show at the same time when @@ -15068,6 +15361,7 @@ def add_scattergl( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -15136,6 +15430,7 @@ def add_scattermapbox( idssrc=None, lat=None, latsrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -15270,6 +15565,12 @@ def add_scattermapbox( latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the same time when @@ -15379,7 +15680,8 @@ def add_scattermapbox( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `lat`, `lon` and `text`. + are available. Finally, the template string has access + to variables `lat`, `lon` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -15449,6 +15751,7 @@ def add_scattermapbox( idssrc=idssrc, lat=lat, latsrc=latsrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -15501,6 +15804,7 @@ def add_scatterpolar( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -15655,6 +15959,12 @@ def add_scatterpolar( 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 part of the same legend group hide/show at the same time when @@ -15771,7 +16081,8 @@ def add_scatterpolar( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `r`, `theta` and `text`. + are available. Finally, the template string has access + to variables `r`, `theta` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -15853,6 +16164,7 @@ def add_scatterpolar( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -15909,6 +16221,7 @@ def add_scatterpolargl( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -16062,6 +16375,12 @@ def add_scatterpolargl( 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 part of the same legend group hide/show at the same time when @@ -16178,7 +16497,8 @@ def add_scatterpolargl( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `r`, `theta` and `text`. + are available. Finally, the template string has access + to variables `r`, `theta` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -16258,6 +16578,7 @@ def add_scatterpolargl( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -16316,6 +16637,7 @@ def add_scattersmith( idssrc=None, imag=None, imagsrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -16466,6 +16788,12 @@ def add_scattersmith( imagsrc Sets the source reference on Chart Studio Cloud for `imag`. + 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 part of the same legend group hide/show at the same time when @@ -16580,7 +16908,8 @@ def add_scattersmith( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `real`, `imag` and `text`. + are available. Finally, the template string has access + to variables `real`, `imag` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -16650,6 +16979,7 @@ def add_scattersmith( idssrc=idssrc, imag=imag, imagsrc=imagsrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -16707,6 +17037,7 @@ def add_scatterternary( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -16872,6 +17203,12 @@ def add_scatterternary( 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 part of the same legend group hide/show at the same time when @@ -16986,7 +17323,8 @@ def add_scatterternary( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `a`, `b`, `c` and `text`. + are available. Finally, the template string has access + to variables `a`, `b`, `c` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -17060,6 +17398,7 @@ def add_scatterternary( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -17108,6 +17447,7 @@ def add_splom( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -17224,6 +17564,12 @@ def add_splom( 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 part of the same legend group hide/show at the same time when @@ -17401,6 +17747,7 @@ def add_splom( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -17450,6 +17797,7 @@ def add_streamtube( hovertext=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -17599,9 +17947,10 @@ def add_streamtube( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `tubex`, `tubey`, `tubez`, - `tubeu`, `tubev`, `tubew`, `norm` and `divergence`. - Anything contained in tag `` is displayed in the + are available. Finally, the template string has access + to variables `tubex`, `tubey`, `tubez`, `tubeu`, + `tubev`, `tubew`, `norm` and `divergence`. Anything + contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -17617,6 +17966,12 @@ def add_streamtube( 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 part of the same legend group hide/show at the same time when @@ -17852,6 +18207,7 @@ def add_streamtube( hovertext=hovertext, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -17917,6 +18273,7 @@ def add_sunburst( labels=None, labelssrc=None, leaf=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -18015,10 +18372,11 @@ def add_sunburst( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry` and - `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -18061,6 +18419,12 @@ def add_sunburst( leaf :class:`plotly.graph_objects.sunburst.Leaf` instance or dict with compatible properties + 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. legendgrouptitle :class:`plotly.graph_objects.sunburst.Legendgrouptitle` instance or dict with compatible properties @@ -18166,9 +18530,10 @@ def add_sunburst( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry`, - `percentParent`, `label` and `value`. + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry`, `percentParent`, `label` + and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -18243,6 +18608,7 @@ def add_sunburst( labels=labels, labelssrc=labelssrc, leaf=leaf, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -18299,6 +18665,7 @@ def add_surface( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -18473,6 +18840,12 @@ def add_surface( 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 part of the same legend group hide/show at the same time when @@ -18695,6 +19068,7 @@ def add_surface( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -18750,6 +19124,7 @@ def add_table( hoverlabel=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -18825,6 +19200,12 @@ def add_table( 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. legendgrouptitle :class:`plotly.graph_objects.table.Legendgrouptitle` instance or dict with compatible properties @@ -18920,6 +19301,7 @@ def add_table( hoverlabel=hoverlabel, ids=ids, idssrc=idssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -18953,6 +19335,7 @@ def add_treemap( insidetextfont=None, labels=None, labelssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -19054,10 +19437,11 @@ def add_treemap( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry` and - `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -19087,6 +19471,12 @@ def add_treemap( labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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. legendgrouptitle :class:`plotly.graph_objects.treemap.Legendgrouptitle` instance or dict with compatible properties @@ -19194,9 +19584,10 @@ def add_treemap( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry`, - `percentParent`, `label` and `value`. + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry`, `percentParent`, `label` + and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -19272,6 +19663,7 @@ def add_treemap( insidetextfont=insidetextfont, labels=labels, labelssrc=labelssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -19325,6 +19717,7 @@ def add_violin( ids=None, idssrc=None, jitter=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -19471,6 +19864,12 @@ def add_violin( If 0, the sample points align along the distribution axis. If 1, the sample points are drawn in a random jitter of width equal to the width of the violins. + 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 part of the same legend group hide/show at the same time when @@ -19758,6 +20157,7 @@ def add_violin( ids=ids, idssrc=idssrc, jitter=jitter, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -19830,6 +20230,7 @@ def add_volume( idssrc=None, isomax=None, isomin=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -20005,6 +20406,12 @@ def add_volume( Sets the maximum boundary for iso-surface plot. isomin Sets the minimum boundary for iso-surface plot. + 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 part of the same legend group hide/show at the same time when @@ -20237,6 +20644,7 @@ def add_volume( idssrc=idssrc, isomax=isomax, isomin=isomin, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -20301,6 +20709,7 @@ def add_waterfall( increasing=None, insidetextanchor=None, insidetextfont=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -20361,7 +20770,7 @@ def add_waterfall( Draws waterfall trace which is useful graph to displays the contribution of various elements (either positive or negative) in a bar chart. The data visualized by the span of the bars is - set in `y` if `orientation` is set th "v" (the default) and the + set in `y` if `orientation` is set to "v" (the default) and the labels are set in `x`. By setting `orientation` to "h", the roles are interchanged. @@ -20436,9 +20845,10 @@ def add_waterfall( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `initial`, `delta` and - `final`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `initial`, `delta` and `final`. Anything + contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -20469,6 +20879,12 @@ def add_waterfall( points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -20599,8 +21015,8 @@ def add_waterfall( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `initial`, `delta`, `final` - and `label`. + are available. Finally, the template string has access + to variables `initial`, `delta`, `final` and `label`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -20775,6 +21191,7 @@ def add_waterfall( increasing=increasing, insidetextanchor=insidetextanchor, insidetextfont=insidetextfont, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -21052,6 +21469,118 @@ def update_geos( return self + def select_legends(self, selector=None, row=None, col=None): + """ + Select legend subplot objects from a particular subplot cell + and/or legend subplot objects that satisfy custom selection + criteria. + + Parameters + ---------- + selector: dict, function, or None (default None) + Dict to use as selection criteria. + legend objects will be selected if they contain + properties corresponding to all of the dictionary's keys, with + values that exactly match the supplied values. If None + (the default), all legend objects are selected. If a + function, it must be a function accepting a single argument and + returning a boolean. The function will be called on each + legend and those for which the function returned True will + be in the selection. + row, col: int or None (default None) + Subplot row and column index of legend objects to select. + To select legend objects by row and column, the Figure + must have been created using plotly.subplots.make_subplots. + If None (the default), all legend objects are selected. + Returns + ------- + generator + Generator that iterates through all of the legend + objects that satisfy all of the specified selection criteria + """ + + return self._select_layout_subplots_by_prefix("legend", selector, row, col) + + def for_each_legend(self, fn, selector=None, row=None, col=None) -> "Figure": + """ + Apply a function to all legend objects that satisfy the + specified selection criteria + + Parameters + ---------- + fn: + Function that inputs a single legend object. + selector: dict, function, or None (default None) + Dict to use as selection criteria. + legend objects will be selected if they contain + properties corresponding to all of the dictionary's keys, with + values that exactly match the supplied values. If None + (the default), all legend objects are selected. If a + function, it must be a function accepting a single argument and + returning a boolean. The function will be called on each + legend and those for which the function returned True will + be in the selection. + row, col: int or None (default None) + Subplot row and column index of legend objects to select. + To select legend objects by row and column, the Figure + must have been created using plotly.subplots.make_subplots. + If None (the default), all legend objects are selected. + Returns + ------- + self + Returns the Figure object that the method was called on + """ + for obj in self.select_legends(selector=selector, row=row, col=col): + fn(obj) + + return self + + def update_legends( + self, patch=None, selector=None, overwrite=False, row=None, col=None, **kwargs + ) -> "Figure": + """ + Perform a property update operation on all legend objects + that satisfy the specified selection criteria + + Parameters + ---------- + patch: dict + Dictionary of property updates to be applied to all + legend objects that satisfy the selection criteria. + selector: dict, function, or None (default None) + Dict to use as selection criteria. + legend objects will be selected if they contain + properties corresponding to all of the dictionary's keys, with + values that exactly match the supplied values. If None + (the default), all legend objects are selected. If a + function, it must be a function accepting a single argument and + returning a boolean. The function will be called on each + legend and those for which the function returned True will + be in the selection. + overwrite: bool + If True, overwrite existing properties. If False, apply updates + to existing properties recursively, preserving existing + properties that are not specified in the update operation. + row, col: int or None (default None) + Subplot row and column index of legend objects to select. + To select legend objects by row and column, the Figure + must have been created using plotly.subplots.make_subplots. + If None (the default), all legend objects are selected. + **kwargs + Additional property updates to apply to each selected + legend object. If a property is specified in + both patch and in **kwargs then the one in **kwargs + takes precedence. + Returns + ------- + self + Returns the Figure object that the method was called on + """ + for obj in self.select_legends(selector=selector, row=row, col=col): + obj.update(patch, overwrite=overwrite, **kwargs) + + return self + def select_mapboxes(self, selector=None, row=None, col=None): """ Select mapbox subplot objects from a particular subplot cell diff --git a/packages/python/plotly/plotly/graph_objs/_figurewidget.py b/packages/python/plotly/plotly/graph_objs/_figurewidget.py index 0db222459da..620567670bb 100644 --- a/packages/python/plotly/plotly/graph_objs/_figurewidget.py +++ b/packages/python/plotly/plotly/graph_objs/_figurewidget.py @@ -1235,6 +1235,7 @@ def add_bar( idssrc=None, insidetextanchor=None, insidetextfont=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1294,7 +1295,7 @@ def add_bar( Add a new Bar trace The data visualized by the span of the bars is set in `y` if - `orientation` is set th "v" (the default) and the labels are + `orientation` is set to "v" (the default) and the labels are set in `x`. By setting `orientation` to "h", the roles are interchanged. @@ -1374,11 +1375,12 @@ def add_bar( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `value` and `label`. Anything - contained in tag `` is displayed in the - secondary box, for example - "{fullData.name}". To hide the secondary - box completely, use an empty tag ``. + are available. Finally, the template string has access + to variables `value` and `label`. Anything contained in + tag `` is displayed in the secondary box, for + example "{fullData.name}". To hide the + secondary box completely, use an empty tag + ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -1404,6 +1406,12 @@ def add_bar( points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -1527,7 +1535,8 @@ def add_bar( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `value` and `label`. + are available. Finally, the template string has access + to variables `value` and `label`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1706,6 +1715,7 @@ def add_bar( idssrc=idssrc, insidetextanchor=insidetextanchor, insidetextfont=insidetextfont, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -1777,6 +1787,7 @@ def add_barpolar( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1895,6 +1906,12 @@ def add_barpolar( 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 part of the same legend group hide/show at the same time when @@ -2061,6 +2078,7 @@ def add_barpolar( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -2117,6 +2135,7 @@ def add_box( ids=None, idssrc=None, jitter=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2316,6 +2335,12 @@ def add_box( If 0, the sample points align along the distribution axis. If 1, the sample points are drawn in a random jitter of width equal to the width of the box(es). + 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 part of the same legend group hide/show at the same time when @@ -2678,6 +2703,7 @@ def add_box( ids=ids, idssrc=idssrc, jitter=jitter, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -2761,6 +2787,7 @@ def add_candlestick( ids=None, idssrc=None, increasing=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2859,6 +2886,12 @@ def add_candlestick( increasing :class:`plotly.graph_objects.candlestick.Increasing` instance or dict with compatible properties + 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 part of the same legend group hide/show at the same time when @@ -3066,6 +3099,7 @@ def add_candlestick( ids=ids, idssrc=idssrc, increasing=increasing, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -3122,6 +3156,7 @@ def add_carpet( font=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -3216,6 +3251,12 @@ def add_carpet( 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. legendgrouptitle :class:`plotly.graph_objects.carpet.Legendgrouptitle` instance or dict with compatible properties @@ -3350,6 +3391,7 @@ def add_carpet( font=font, ids=ids, idssrc=idssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -3391,6 +3433,7 @@ def add_choropleth( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -3542,6 +3585,12 @@ def add_choropleth( 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 part of the same legend group hide/show at the same time when @@ -3712,6 +3761,7 @@ def add_choropleth( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -3765,6 +3815,7 @@ def add_choroplethmapbox( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -3895,8 +3946,9 @@ def add_choroplethmapbox( 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. variable `properties` Anything contained - in tag `` is displayed in the secondary box, for + are available. Finally, the template string has access + to variable `properties` Anything contained in tag + `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -3915,6 +3967,12 @@ def add_choroplethmapbox( 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 part of the same legend group hide/show at the same time when @@ -4083,6 +4141,7 @@ def add_choroplethmapbox( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -4138,6 +4197,7 @@ def add_cone( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -4286,11 +4346,11 @@ def add_cone( 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. variable `norm` Anything contained in - tag `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variable `norm` Anything contained in tag `` + is displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -4306,6 +4366,12 @@ def add_cone( 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 part of the same legend group hide/show at the same time when @@ -4556,6 +4622,7 @@ def add_cone( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -4624,6 +4691,7 @@ def add_contour( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -4808,6 +4876,12 @@ def add_contour( 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 part of the same legend group hide/show at the same time when @@ -4893,7 +4967,8 @@ def add_contour( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `x`, `y`, `z` and `text`. + are available. Finally, the template string has access + to variables `x`, `y`, `z` and `text`. transpose Transposes the z data. uid @@ -5104,6 +5179,7 @@ def add_contour( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -5183,6 +5259,7 @@ def add_contourcarpet( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -5324,6 +5401,12 @@ def add_contourcarpet( 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 part of the same legend group hide/show at the same time when @@ -5504,6 +5587,7 @@ def add_contourcarpet( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -5556,6 +5640,7 @@ def add_densitymapbox( idssrc=None, lat=None, latsrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -5704,6 +5789,12 @@ def add_densitymapbox( latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the same time when @@ -5872,6 +5963,7 @@ def add_densitymapbox( idssrc=idssrc, lat=lat, latsrc=latsrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -5925,6 +6017,7 @@ def add_funnel( idssrc=None, insidetextanchor=None, insidetextfont=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -6050,10 +6143,10 @@ def add_funnel( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `percentInitial`, - `percentPrevious` and `percentTotal`. Anything - contained in tag `` is displayed in the - secondary box, for example + are available. Finally, the template string has access + to variables `percentInitial`, `percentPrevious` and + `percentTotal`. Anything contained in tag `` is + displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -6081,6 +6174,12 @@ def add_funnel( points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -6206,8 +6305,9 @@ def add_funnel( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `percentInitial`, - `percentPrevious`, `percentTotal`, `label` and `value`. + are available. Finally, the template string has access + to variables `percentInitial`, `percentPrevious`, + `percentTotal`, `label` and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -6373,6 +6473,7 @@ def add_funnel( idssrc=idssrc, insidetextanchor=insidetextanchor, insidetextfont=insidetextfont, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -6443,6 +6544,7 @@ def add_funnelarea( label0=None, labels=None, labelssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -6537,12 +6639,12 @@ def add_funnelarea( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `text` and `percent`. Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `text` and + `percent`. Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -6578,6 +6680,12 @@ def add_funnelarea( labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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 part of the same legend group hide/show at the same time when @@ -6664,8 +6772,9 @@ def add_funnelarea( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `text` and `percent`. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `text` and + `percent`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -6742,6 +6851,7 @@ def add_funnelarea( label0=label0, labels=labels, labelssrc=labelssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -6793,6 +6903,7 @@ def add_heatmap( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -6975,6 +7086,12 @@ def add_heatmap( 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 part of the same legend group hide/show at the same time when @@ -7049,7 +7166,8 @@ def add_heatmap( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `x`, `y`, `z` and `text`. + are available. Finally, the template string has access + to variables `x`, `y`, `z` and `text`. transpose Transposes the z data. uid @@ -7263,6 +7381,7 @@ def add_heatmap( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -7332,6 +7451,7 @@ def add_heatmapgl( hoverlabel=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -7440,6 +7560,12 @@ def add_heatmapgl( 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. legendgrouptitle :class:`plotly.graph_objects.heatmapgl.Legendgrouptitle ` instance or dict with compatible properties @@ -7625,6 +7751,7 @@ def add_heatmapgl( hoverlabel=hoverlabel, ids=ids, idssrc=idssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -7688,6 +7815,7 @@ def add_histogram( idssrc=None, insidetextanchor=None, insidetextfont=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -7855,8 +7983,9 @@ def add_histogram( 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. variable `binNumber` Anything contained - in tag `` is displayed in the secondary box, for + are available. Finally, the template string has access + to variable `binNumber` Anything contained in tag + `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -7880,6 +8009,12 @@ def add_histogram( points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -8001,7 +8136,8 @@ def add_histogram( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label` and `value`. + are available. Finally, the template string has access + to variables `label` and `value`. uid Assign an id to this trace, Use this to provide object constancy between traces during animations and @@ -8140,6 +8276,7 @@ def add_histogram( idssrc=idssrc, insidetextanchor=insidetextanchor, insidetextfont=insidetextfont, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -8204,6 +8341,7 @@ def add_histogram2d( hovertemplatesrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -8379,11 +8517,11 @@ def add_histogram2d( 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. variable `z` Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variable `z` Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -8394,6 +8532,12 @@ def add_histogram2d( 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 part of the same legend group hide/show at the same time when @@ -8478,7 +8622,8 @@ def add_histogram2d( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variable `z` + are available. Finally, the template string has access + to variable `z` uid Assign an id to this trace, Use this to provide object constancy between traces during animations and @@ -8657,6 +8802,7 @@ def add_histogram2d( hovertemplatesrc=hovertemplatesrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -8727,6 +8873,7 @@ def add_histogram2dcontour( hovertemplatesrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -8909,11 +9056,11 @@ def add_histogram2dcontour( 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. variable `z` Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variable `z` Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -8924,6 +9071,12 @@ def add_histogram2dcontour( 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 part of the same legend group hide/show at the same time when @@ -9019,7 +9172,8 @@ def add_histogram2dcontour( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `x`, `y`, `z` and `text`. + are available. Finally, the template string has access + to variables `x`, `y`, `z` and `text`. uid Assign an id to this trace, Use this to provide object constancy between traces during animations and @@ -9194,6 +9348,7 @@ def add_histogram2dcontour( hovertemplatesrc=hovertemplatesrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -9261,6 +9416,7 @@ def add_icicle( labels=None, labelssrc=None, leaf=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -9361,10 +9517,11 @@ def add_icicle( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry` and - `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -9397,6 +9554,12 @@ def add_icicle( leaf :class:`plotly.graph_objects.icicle.Leaf` instance or dict with compatible properties + 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. legendgrouptitle :class:`plotly.graph_objects.icicle.Legendgrouptitle` instance or dict with compatible properties @@ -9504,9 +9667,10 @@ def add_icicle( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry`, - `percentParent`, `label` and `value`. + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry`, `percentParent`, `label` + and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -9583,6 +9747,7 @@ def add_icicle( labels=labels, labelssrc=labelssrc, leaf=leaf, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -9633,6 +9798,7 @@ def add_image( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -9725,8 +9891,9 @@ def add_image( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `z`, `color` and `colormodel`. - Anything contained in tag `` is displayed in the + are available. Finally, the template string has access + to variables `z`, `color` and `colormodel`. Anything + contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -9745,6 +9912,12 @@ def add_image( 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. legendgrouptitle :class:`plotly.graph_objects.image.Legendgrouptitle` instance or dict with compatible properties @@ -9820,14 +9993,23 @@ def add_image( a legend item (provided that the legend itself is visible). x0 - Set the image's x position. + Set the image's x position. The left edge of the image + (or the right edge if the x axis is reversed or dx is + negative) will be found at xmin=x0-dx/2 xaxis Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on. y0 - Set the image's y position. + Set the image's y position. The top edge of the image + (or the bottom edge if the y axis is NOT reversed or if + dy is negative) will be found at ymin=y0-dy/2. By + default when an image trace is included, the y axis + will be reversed so that the image is right-side-up, + but you can disable this by setting + yaxis.autorange=true or by providing an explicit y axis + range. yaxis Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the @@ -9902,6 +10084,7 @@ def add_image( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -9939,6 +10122,7 @@ def add_indicator( gauge=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -9997,6 +10181,12 @@ def add_indicator( 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. legendgrouptitle :class:`plotly.graph_objects.indicator.Legendgrouptitle ` instance or dict with compatible properties @@ -10100,6 +10290,7 @@ def add_indicator( gauge=gauge, ids=ids, idssrc=idssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -10144,6 +10335,7 @@ def add_isosurface( idssrc=None, isomax=None, isomin=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -10318,6 +10510,12 @@ def add_isosurface( Sets the maximum boundary for iso-surface plot. isomin Sets the minimum boundary for iso-surface plot. + 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 part of the same legend group hide/show at the same time when @@ -10539,6 +10737,7 @@ def add_isosurface( idssrc=idssrc, isomax=isomax, isomin=isomin, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -10615,6 +10814,7 @@ def add_mesh3d( jsrc=None, k=None, ksrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -10857,6 +11057,12 @@ def add_mesh3d( ksrc Sets the source reference on Chart Studio Cloud for `k`. + 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 part of the same legend group hide/show at the same time when @@ -11090,6 +11296,7 @@ def add_mesh3d( jsrc=jsrc, k=k, ksrc=ksrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -11145,6 +11352,7 @@ def add_ohlc( ids=None, idssrc=None, increasing=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -11243,6 +11451,12 @@ def add_ohlc( increasing :class:`plotly.graph_objects.ohlc.Increasing` instance or dict with compatible properties + 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 part of the same legend group hide/show at the same time when @@ -11449,6 +11663,7 @@ def add_ohlc( ids=ids, idssrc=idssrc, increasing=increasing, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -11586,12 +11801,17 @@ def add_parcats( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `count`, `probability`, - `category`, `categorycount`, `colorcount` and - `bandcolorcount`. Anything contained in tag `` - is displayed in the secondary box, for example - "{fullData.name}". To hide the secondary - box completely, use an empty tag ``. + are available. This value here applies when hovering + over dimensions. Note that `*categorycount`, + "colorcount" and "bandcolorcount" are only available + when `hoveron` contains the "color" flagFinally, the + template string has access to variables `count`, + `probability`, `category`, `categorycount`, + `colorcount` and `bandcolorcount`. Anything contained + in tag `` is displayed in the secondary box, for + example "{fullData.name}". To hide the + secondary box completely, use an empty tag + ``. labelfont Sets the font for the `dimension` labels. legendgrouptitle @@ -11716,6 +11936,7 @@ def add_parcoords( labelangle=None, labelfont=None, labelside=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -11783,6 +12004,12 @@ def add_parcoords( labels below the graph Tilted labels with "labelangle" may be positioned better inside margins when `labelposition` is set to "bottom". + 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. legendgrouptitle :class:`plotly.graph_objects.parcoords.Legendgrouptitle ` instance or dict with compatible properties @@ -11884,6 +12111,7 @@ def add_parcoords( labelangle=labelangle, labelfont=labelfont, labelside=labelside, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -11925,6 +12153,7 @@ def add_pie( label0=None, labels=None, labelssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -12028,12 +12257,12 @@ def add_pie( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `percent` and `text`. Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `percent` and + `text`. Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -12079,6 +12308,12 @@ def add_pie( labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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 part of the same legend group hide/show at the same time when @@ -12182,8 +12417,9 @@ def add_pie( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `percent` and `text`. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `percent` and + `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -12271,6 +12507,7 @@ def add_pie( label0=label0, labels=labels, labelssrc=labelssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -12319,6 +12556,7 @@ def add_pointcloud( idssrc=None, indices=None, indicessrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -12399,6 +12637,12 @@ def add_pointcloud( indicessrc Sets the source reference on Chart Studio Cloud for `indices`. + 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 part of the same legend group hide/show at the same time when @@ -12566,6 +12810,7 @@ def add_pointcloud( idssrc=idssrc, indices=indices, indicessrc=indicessrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -12608,6 +12853,7 @@ def add_sankey( hoverlabel=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -12675,6 +12921,12 @@ def add_sankey( 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. legendgrouptitle :class:`plotly.graph_objects.sankey.Legendgrouptitle` instance or dict with compatible properties @@ -12788,6 +13040,7 @@ def add_sankey( hoverlabel=hoverlabel, ids=ids, idssrc=idssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -12834,6 +13087,7 @@ def add_scatter( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -13036,6 +13290,12 @@ def add_scatter( 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 part of the same legend group hide/show at the same time when @@ -13350,6 +13610,7 @@ def add_scatter( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -13419,6 +13680,7 @@ def add_scatter3d( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -13553,6 +13815,12 @@ def add_scatter3d( 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 part of the same legend group hide/show at the same time when @@ -13785,6 +14053,7 @@ def add_scatter3d( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -13850,6 +14119,7 @@ def add_scattercarpet( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -13995,6 +14265,12 @@ def add_scattercarpet( 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 part of the same legend group hide/show at the same time when @@ -14097,7 +14373,8 @@ def add_scattercarpet( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `a`, `b` and `text`. + are available. Finally, the template string has access + to variables `a`, `b` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -14189,6 +14466,7 @@ def add_scattercarpet( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -14242,6 +14520,7 @@ def add_scattergeo( idssrc=None, lat=None, latsrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -14390,6 +14669,12 @@ def add_scattergeo( latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the same time when @@ -14512,8 +14797,8 @@ def add_scattergeo( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `lat`, `lon`, `location` and - `text`. + are available. Finally, the template string has access + to variables `lat`, `lon`, `location` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -14584,6 +14869,7 @@ def add_scattergeo( idssrc=idssrc, lat=lat, latsrc=latsrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -14639,6 +14925,7 @@ def add_scattergl( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -14805,6 +15092,12 @@ def add_scattergl( 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 part of the same legend group hide/show at the same time when @@ -15072,6 +15365,7 @@ def add_scattergl( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -15140,6 +15434,7 @@ def add_scattermapbox( idssrc=None, lat=None, latsrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -15274,6 +15569,12 @@ def add_scattermapbox( latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the same time when @@ -15383,7 +15684,8 @@ def add_scattermapbox( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `lat`, `lon` and `text`. + are available. Finally, the template string has access + to variables `lat`, `lon` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -15453,6 +15755,7 @@ def add_scattermapbox( idssrc=idssrc, lat=lat, latsrc=latsrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -15505,6 +15808,7 @@ def add_scatterpolar( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -15659,6 +15963,12 @@ def add_scatterpolar( 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 part of the same legend group hide/show at the same time when @@ -15775,7 +16085,8 @@ def add_scatterpolar( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `r`, `theta` and `text`. + are available. Finally, the template string has access + to variables `r`, `theta` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -15857,6 +16168,7 @@ def add_scatterpolar( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -15913,6 +16225,7 @@ def add_scatterpolargl( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -16066,6 +16379,12 @@ def add_scatterpolargl( 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 part of the same legend group hide/show at the same time when @@ -16182,7 +16501,8 @@ def add_scatterpolargl( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `r`, `theta` and `text`. + are available. Finally, the template string has access + to variables `r`, `theta` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -16262,6 +16582,7 @@ def add_scatterpolargl( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -16320,6 +16641,7 @@ def add_scattersmith( idssrc=None, imag=None, imagsrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -16470,6 +16792,12 @@ def add_scattersmith( imagsrc Sets the source reference on Chart Studio Cloud for `imag`. + 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 part of the same legend group hide/show at the same time when @@ -16584,7 +16912,8 @@ def add_scattersmith( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `real`, `imag` and `text`. + are available. Finally, the template string has access + to variables `real`, `imag` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -16654,6 +16983,7 @@ def add_scattersmith( idssrc=idssrc, imag=imag, imagsrc=imagsrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -16711,6 +17041,7 @@ def add_scatterternary( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -16876,6 +17207,12 @@ def add_scatterternary( 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 part of the same legend group hide/show at the same time when @@ -16990,7 +17327,8 @@ def add_scatterternary( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `a`, `b`, `c` and `text`. + are available. Finally, the template string has access + to variables `a`, `b`, `c` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -17064,6 +17402,7 @@ def add_scatterternary( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -17112,6 +17451,7 @@ def add_splom( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -17228,6 +17568,12 @@ def add_splom( 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 part of the same legend group hide/show at the same time when @@ -17405,6 +17751,7 @@ def add_splom( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -17454,6 +17801,7 @@ def add_streamtube( hovertext=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -17603,9 +17951,10 @@ def add_streamtube( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `tubex`, `tubey`, `tubez`, - `tubeu`, `tubev`, `tubew`, `norm` and `divergence`. - Anything contained in tag `` is displayed in the + are available. Finally, the template string has access + to variables `tubex`, `tubey`, `tubez`, `tubeu`, + `tubev`, `tubew`, `norm` and `divergence`. Anything + contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -17621,6 +17970,12 @@ def add_streamtube( 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 part of the same legend group hide/show at the same time when @@ -17856,6 +18211,7 @@ def add_streamtube( hovertext=hovertext, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -17921,6 +18277,7 @@ def add_sunburst( labels=None, labelssrc=None, leaf=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -18019,10 +18376,11 @@ def add_sunburst( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry` and - `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -18065,6 +18423,12 @@ def add_sunburst( leaf :class:`plotly.graph_objects.sunburst.Leaf` instance or dict with compatible properties + 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. legendgrouptitle :class:`plotly.graph_objects.sunburst.Legendgrouptitle` instance or dict with compatible properties @@ -18170,9 +18534,10 @@ def add_sunburst( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry`, - `percentParent`, `label` and `value`. + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry`, `percentParent`, `label` + and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -18247,6 +18612,7 @@ def add_sunburst( labels=labels, labelssrc=labelssrc, leaf=leaf, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -18303,6 +18669,7 @@ def add_surface( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -18477,6 +18844,12 @@ def add_surface( 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 part of the same legend group hide/show at the same time when @@ -18699,6 +19072,7 @@ def add_surface( hovertextsrc=hovertextsrc, ids=ids, idssrc=idssrc, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -18754,6 +19128,7 @@ def add_table( hoverlabel=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -18829,6 +19204,12 @@ def add_table( 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. legendgrouptitle :class:`plotly.graph_objects.table.Legendgrouptitle` instance or dict with compatible properties @@ -18924,6 +19305,7 @@ def add_table( hoverlabel=hoverlabel, ids=ids, idssrc=idssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -18957,6 +19339,7 @@ def add_treemap( insidetextfont=None, labels=None, labelssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -19058,10 +19441,11 @@ def add_treemap( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry` and - `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -19091,6 +19475,12 @@ def add_treemap( labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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. legendgrouptitle :class:`plotly.graph_objects.treemap.Legendgrouptitle` instance or dict with compatible properties @@ -19198,9 +19588,10 @@ def add_treemap( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry`, - `percentParent`, `label` and `value`. + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry`, `percentParent`, `label` + and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -19276,6 +19667,7 @@ def add_treemap( insidetextfont=insidetextfont, labels=labels, labelssrc=labelssrc, + legend=legend, legendgrouptitle=legendgrouptitle, legendrank=legendrank, legendwidth=legendwidth, @@ -19329,6 +19721,7 @@ def add_violin( ids=None, idssrc=None, jitter=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -19475,6 +19868,12 @@ def add_violin( If 0, the sample points align along the distribution axis. If 1, the sample points are drawn in a random jitter of width equal to the width of the violins. + 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 part of the same legend group hide/show at the same time when @@ -19762,6 +20161,7 @@ def add_violin( ids=ids, idssrc=idssrc, jitter=jitter, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -19834,6 +20234,7 @@ def add_volume( idssrc=None, isomax=None, isomin=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -20009,6 +20410,12 @@ def add_volume( Sets the maximum boundary for iso-surface plot. isomin Sets the minimum boundary for iso-surface plot. + 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 part of the same legend group hide/show at the same time when @@ -20241,6 +20648,7 @@ def add_volume( idssrc=idssrc, isomax=isomax, isomin=isomin, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -20305,6 +20713,7 @@ def add_waterfall( increasing=None, insidetextanchor=None, insidetextfont=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -20365,7 +20774,7 @@ def add_waterfall( Draws waterfall trace which is useful graph to displays the contribution of various elements (either positive or negative) in a bar chart. The data visualized by the span of the bars is - set in `y` if `orientation` is set th "v" (the default) and the + set in `y` if `orientation` is set to "v" (the default) and the labels are set in `x`. By setting `orientation` to "h", the roles are interchanged. @@ -20440,9 +20849,10 @@ def add_waterfall( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `initial`, `delta` and - `final`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `initial`, `delta` and `final`. Anything + contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -20473,6 +20883,12 @@ def add_waterfall( points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -20603,8 +21019,8 @@ def add_waterfall( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `initial`, `delta`, `final` - and `label`. + are available. Finally, the template string has access + to variables `initial`, `delta`, `final` and `label`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -20779,6 +21195,7 @@ def add_waterfall( increasing=increasing, insidetextanchor=insidetextanchor, insidetextfont=insidetextfont, + legend=legend, legendgroup=legendgroup, legendgrouptitle=legendgrouptitle, legendrank=legendrank, @@ -21058,6 +21475,118 @@ def update_geos( return self + def select_legends(self, selector=None, row=None, col=None): + """ + Select legend subplot objects from a particular subplot cell + and/or legend subplot objects that satisfy custom selection + criteria. + + Parameters + ---------- + selector: dict, function, or None (default None) + Dict to use as selection criteria. + legend objects will be selected if they contain + properties corresponding to all of the dictionary's keys, with + values that exactly match the supplied values. If None + (the default), all legend objects are selected. If a + function, it must be a function accepting a single argument and + returning a boolean. The function will be called on each + legend and those for which the function returned True will + be in the selection. + row, col: int or None (default None) + Subplot row and column index of legend objects to select. + To select legend objects by row and column, the Figure + must have been created using plotly.subplots.make_subplots. + If None (the default), all legend objects are selected. + Returns + ------- + generator + Generator that iterates through all of the legend + objects that satisfy all of the specified selection criteria + """ + + return self._select_layout_subplots_by_prefix("legend", selector, row, col) + + def for_each_legend(self, fn, selector=None, row=None, col=None) -> "FigureWidget": + """ + Apply a function to all legend objects that satisfy the + specified selection criteria + + Parameters + ---------- + fn: + Function that inputs a single legend object. + selector: dict, function, or None (default None) + Dict to use as selection criteria. + legend objects will be selected if they contain + properties corresponding to all of the dictionary's keys, with + values that exactly match the supplied values. If None + (the default), all legend objects are selected. If a + function, it must be a function accepting a single argument and + returning a boolean. The function will be called on each + legend and those for which the function returned True will + be in the selection. + row, col: int or None (default None) + Subplot row and column index of legend objects to select. + To select legend objects by row and column, the Figure + must have been created using plotly.subplots.make_subplots. + If None (the default), all legend objects are selected. + Returns + ------- + self + Returns the FigureWidget object that the method was called on + """ + for obj in self.select_legends(selector=selector, row=row, col=col): + fn(obj) + + return self + + def update_legends( + self, patch=None, selector=None, overwrite=False, row=None, col=None, **kwargs + ) -> "FigureWidget": + """ + Perform a property update operation on all legend objects + that satisfy the specified selection criteria + + Parameters + ---------- + patch: dict + Dictionary of property updates to be applied to all + legend objects that satisfy the selection criteria. + selector: dict, function, or None (default None) + Dict to use as selection criteria. + legend objects will be selected if they contain + properties corresponding to all of the dictionary's keys, with + values that exactly match the supplied values. If None + (the default), all legend objects are selected. If a + function, it must be a function accepting a single argument and + returning a boolean. The function will be called on each + legend and those for which the function returned True will + be in the selection. + overwrite: bool + If True, overwrite existing properties. If False, apply updates + to existing properties recursively, preserving existing + properties that are not specified in the update operation. + row, col: int or None (default None) + Subplot row and column index of legend objects to select. + To select legend objects by row and column, the Figure + must have been created using plotly.subplots.make_subplots. + If None (the default), all legend objects are selected. + **kwargs + Additional property updates to apply to each selected + legend object. If a property is specified in + both patch and in **kwargs then the one in **kwargs + takes precedence. + Returns + ------- + self + Returns the FigureWidget object that the method was called on + """ + for obj in self.select_legends(selector=selector, row=row, col=col): + obj.update(patch, overwrite=overwrite, **kwargs) + + return self + def select_mapboxes(self, selector=None, row=None, col=None): """ Select mapbox subplot objects from a particular subplot cell diff --git a/packages/python/plotly/plotly/graph_objs/_funnel.py b/packages/python/plotly/plotly/graph_objs/_funnel.py index d8aab9b1aeb..2a0784e1e56 100644 --- a/packages/python/plotly/plotly/graph_objs/_funnel.py +++ b/packages/python/plotly/plotly/graph_objs/_funnel.py @@ -28,6 +28,7 @@ class Funnel(_BaseTraceType): "idssrc", "insidetextanchor", "insidetextfont", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -391,12 +392,12 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `percentInitial`, `percentPrevious` and `percentTotal`. - Anything contained in tag `` is displayed in the - secondary box, for example "{fullData.name}". To - hide the secondary box completely, use an empty tag - ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variables `percentInitial`, + `percentPrevious` and `percentTotal`. Anything contained in tag + `` is displayed in the secondary box, for example + "{fullData.name}". To hide the secondary box + completely, use an empty tag ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -601,6 +602,31 @@ def insidetextfont(self): def insidetextfont(self, val): self["insidetextfont"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1332,8 +1358,9 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `percentInitial`, `percentPrevious`, `percentTotal`, - `label` and `value`. + Finally, the template string has access to variables + `percentInitial`, `percentPrevious`, `percentTotal`, `label` + and `value`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1911,10 +1938,10 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `percentInitial`, - `percentPrevious` and `percentTotal`. Anything - contained in tag `` is displayed in the - secondary box, for example + are available. Finally, the template string has access + to variables `percentInitial`, `percentPrevious` and + `percentTotal`. Anything contained in tag `` is + displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -1942,6 +1969,12 @@ def _prop_descriptions(self): points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -2067,8 +2100,9 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `percentInitial`, - `percentPrevious`, `percentTotal`, `label` and `value`. + are available. Finally, the template string has access + to variables `percentInitial`, `percentPrevious`, + `percentTotal`, `label` and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2211,6 +2245,7 @@ def __init__( idssrc=None, insidetextanchor=None, insidetextfont=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2336,10 +2371,10 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `percentInitial`, - `percentPrevious` and `percentTotal`. Anything - contained in tag `` is displayed in the - secondary box, for example + are available. Finally, the template string has access + to variables `percentInitial`, `percentPrevious` and + `percentTotal`. Anything contained in tag `` is + displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -2367,6 +2402,12 @@ def __init__( points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -2492,8 +2533,9 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `percentInitial`, - `percentPrevious`, `percentTotal`, `label` and `value`. + are available. Finally, the template string has access + to variables `percentInitial`, `percentPrevious`, + `percentTotal`, `label` and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2722,6 +2764,10 @@ def __init__( _v = insidetextfont if insidetextfont is not None else _v if _v is not None: self["insidetextfont"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_funnelarea.py b/packages/python/plotly/plotly/graph_objs/_funnelarea.py index 56cc0d007fe..8a20ded400e 100644 --- a/packages/python/plotly/plotly/graph_objs/_funnelarea.py +++ b/packages/python/plotly/plotly/graph_objs/_funnelarea.py @@ -28,6 +28,7 @@ class Funnelarea(_BaseTraceType): "label0", "labels", "labelssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -329,11 +330,12 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `label`, `color`, `value`, `text` and `percent`. Anything - contained in tag `` is displayed in the secondary box, - for example "{fullData.name}". To hide the - secondary box completely, use an empty tag ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variables `label`, `color`, + `value`, `text` and `percent`. Anything contained in tag + `` is displayed in the secondary box, for example + "{fullData.name}". To hide the secondary box + completely, use an empty tag ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -582,6 +584,31 @@ def labelssrc(self): def labelssrc(self, val): self["labelssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -703,6 +730,8 @@ def marker(self): :class:`plotly.graph_objects.funnelarea.marker. Line` instance or dict with compatible properties + pattern + Sets the pattern within the marker. Returns ------- @@ -1064,7 +1093,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `label`, `color`, `value`, `text` and `percent`. + Finally, the template string has access to variables `label`, + `color`, `value`, `text` and `percent`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1323,12 +1353,12 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `text` and `percent`. Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `text` and + `percent`. Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -1364,6 +1394,12 @@ def _prop_descriptions(self): labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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 part of the same legend group hide/show at the same time when @@ -1450,8 +1486,9 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `text` and `percent`. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `text` and + `percent`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1515,6 +1552,7 @@ def __init__( label0=None, labels=None, labelssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1610,12 +1648,12 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `text` and `percent`. Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `text` and + `percent`. Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -1651,6 +1689,12 @@ def __init__( labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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 part of the same legend group hide/show at the same time when @@ -1737,8 +1781,9 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `text` and `percent`. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `text` and + `percent`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1888,6 +1933,10 @@ def __init__( _v = labelssrc if labelssrc is not None else _v if _v is not None: self["labelssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_heatmap.py b/packages/python/plotly/plotly/graph_objs/_heatmap.py index 5e732c40f43..5dd4c6c9bc7 100644 --- a/packages/python/plotly/plotly/graph_objs/_heatmap.py +++ b/packages/python/plotly/plotly/graph_objs/_heatmap.py @@ -28,6 +28,7 @@ class Heatmap(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -376,9 +377,15 @@ def colorbar(self): title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -388,10 +395,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -401,6 +418,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -847,6 +868,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1234,7 +1280,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `x`, `y`, `z` and `text`. + Finally, the template string has access to variables `x`, `y`, + `z` and `text`. The 'texttemplate' property is a string and must be specified as: - A string @@ -2140,6 +2187,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -2214,7 +2267,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `x`, `y`, `z` and `text`. + are available. Finally, the template string has access + to variables `x`, `y`, `z` and `text`. transpose Transposes the z data. uid @@ -2405,6 +2459,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2587,6 +2642,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2661,7 +2722,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `x`, `y`, `z` and `text`. + are available. Finally, the template string has access + to variables `x`, `y`, `z` and `text`. transpose Transposes the z data. uid @@ -2938,6 +3000,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_heatmapgl.py b/packages/python/plotly/plotly/graph_objs/_heatmapgl.py index e4667bd051e..350e6866763 100644 --- a/packages/python/plotly/plotly/graph_objs/_heatmapgl.py +++ b/packages/python/plotly/plotly/graph_objs/_heatmapgl.py @@ -22,6 +22,7 @@ class Heatmapgl(_BaseTraceType): "hoverlabel", "ids", "idssrc", + "legend", "legendgrouptitle", "legendrank", "legendwidth", @@ -353,9 +354,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -365,10 +372,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -378,6 +395,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -674,6 +695,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgrouptitle # ---------------- @property @@ -1490,6 +1536,12 @@ def _prop_descriptions(self): 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. legendgrouptitle :class:`plotly.graph_objects.heatmapgl.Legendgrouptitle ` instance or dict with compatible properties @@ -1652,6 +1704,7 @@ def __init__( hoverlabel=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -1760,6 +1813,12 @@ def __init__( 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. legendgrouptitle :class:`plotly.graph_objects.heatmapgl.Legendgrouptitle ` instance or dict with compatible properties @@ -1990,6 +2049,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgrouptitle", None) _v = legendgrouptitle if legendgrouptitle is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_histogram.py b/packages/python/plotly/plotly/graph_objs/_histogram.py index 0507ea0f72e..ab898acb5fd 100644 --- a/packages/python/plotly/plotly/graph_objs/_histogram.py +++ b/packages/python/plotly/plotly/graph_objs/_histogram.py @@ -33,6 +33,7 @@ class Histogram(_BaseTraceType): "idssrc", "insidetextanchor", "insidetextfont", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -661,11 +662,11 @@ def hovertemplate(self): 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. variable - `binNumber` Anything contained in tag `` is displayed in - the secondary box, for example - "{fullData.name}". To hide the secondary box - completely, use an empty tag ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variable `binNumber` Anything + contained in tag `` is displayed in the secondary box, + for example "{fullData.name}". To hide the + secondary box completely, use an empty tag ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -856,6 +857,31 @@ def insidetextfont(self): def insidetextfont(self, val): self["insidetextfont"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1575,7 +1601,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `label` and `value`. + Finally, the template string has access to variables `label` + and `value`. The 'texttemplate' property is a string and must be specified as: - A string @@ -2199,8 +2226,9 @@ def _prop_descriptions(self): 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. variable `binNumber` Anything contained - in tag `` is displayed in the secondary box, for + are available. Finally, the template string has access + to variable `binNumber` Anything contained in tag + `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -2224,6 +2252,12 @@ def _prop_descriptions(self): points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -2345,7 +2379,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label` and `value`. + are available. Finally, the template string has access + to variables `label` and `value`. uid Assign an id to this trace, Use this to provide object constancy between traces during animations and @@ -2461,6 +2496,7 @@ def __init__( idssrc=None, insidetextanchor=None, insidetextfont=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2628,8 +2664,9 @@ def __init__( 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. variable `binNumber` Anything contained - in tag `` is displayed in the secondary box, for + are available. Finally, the template string has access + to variable `binNumber` Anything contained in tag + `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -2653,6 +2690,12 @@ def __init__( points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -2774,7 +2817,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label` and `value`. + are available. Finally, the template string has access + to variables `label` and `value`. uid Assign an id to this trace, Use this to provide object constancy between traces during animations and @@ -2991,6 +3035,10 @@ def __init__( _v = insidetextfont if insidetextfont is not None else _v if _v is not None: self["insidetextfont"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_histogram2d.py b/packages/python/plotly/plotly/graph_objs/_histogram2d.py index 543222aa525..0fc46a2c114 100644 --- a/packages/python/plotly/plotly/graph_objs/_histogram2d.py +++ b/packages/python/plotly/plotly/graph_objs/_histogram2d.py @@ -27,6 +27,7 @@ class Histogram2d(_BaseTraceType): "hovertemplatesrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -439,9 +440,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -451,10 +458,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -464,6 +481,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -762,11 +783,11 @@ def hovertemplate(self): 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. variable `z` - Anything contained in tag `` is displayed in the - secondary box, for example "{fullData.name}". To - hide the secondary box completely, use an empty tag - ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variable `z` Anything contained + in tag `` is displayed in the secondary box, for example + "{fullData.name}". To hide the secondary box + completely, use an empty tag ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -846,6 +867,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1270,7 +1316,7 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variable `z` + Finally, the template string has access to variable `z` The 'texttemplate' property is a string and must be specified as: - A string @@ -2108,11 +2154,11 @@ def _prop_descriptions(self): 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. variable `z` Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variable `z` Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -2123,6 +2169,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -2207,7 +2259,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variable `z` + are available. Finally, the template string has access + to variable `z` uid Assign an id to this trace, Use this to provide object constancy between traces during animations and @@ -2363,6 +2416,7 @@ def __init__( hovertemplatesrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2538,11 +2592,11 @@ def __init__( 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. variable `z` Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variable `z` Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -2553,6 +2607,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2637,7 +2697,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variable `z` + are available. Finally, the template string has access + to variable `z` uid Assign an id to this trace, Use this to provide object constancy between traces during animations and @@ -2876,6 +2937,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_histogram2dcontour.py b/packages/python/plotly/plotly/graph_objs/_histogram2dcontour.py index ceacc62f1aa..dc89c929a62 100644 --- a/packages/python/plotly/plotly/graph_objs/_histogram2dcontour.py +++ b/packages/python/plotly/plotly/graph_objs/_histogram2dcontour.py @@ -29,6 +29,7 @@ class Histogram2dContour(_BaseTraceType): "hovertemplatesrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -463,9 +464,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -475,10 +482,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -488,6 +505,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -873,11 +894,11 @@ def hovertemplate(self): 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. variable `z` - Anything contained in tag `` is displayed in the - secondary box, for example "{fullData.name}". To - hide the secondary box completely, use an empty tag - ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variable `z` Anything contained + in tag `` is displayed in the secondary box, for example + "{fullData.name}". To hide the secondary box + completely, use an empty tag ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -957,6 +978,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1445,7 +1491,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `x`, `y`, `z` and `text`. + Finally, the template string has access to variables `x`, `y`, + `z` and `text`. The 'texttemplate' property is a string and must be specified as: - A string @@ -2230,11 +2277,11 @@ def _prop_descriptions(self): 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. variable `z` Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variable `z` Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -2245,6 +2292,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -2340,7 +2393,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `x`, `y`, `z` and `text`. + are available. Finally, the template string has access + to variables `x`, `y`, `z` and `text`. uid Assign an id to this trace, Use this to provide object constancy between traces during animations and @@ -2492,6 +2546,7 @@ def __init__( hovertemplatesrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2675,11 +2730,11 @@ def __init__( 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. variable `z` Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variable `z` Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -2690,6 +2745,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2785,7 +2846,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `x`, `y`, `z` and `text`. + are available. Finally, the template string has access + to variables `x`, `y`, `z` and `text`. uid Assign an id to this trace, Use this to provide object constancy between traces during animations and @@ -3026,6 +3088,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_icicle.py b/packages/python/plotly/plotly/graph_objs/_icicle.py index 320177b06a9..cb7219417fc 100644 --- a/packages/python/plotly/plotly/graph_objs/_icicle.py +++ b/packages/python/plotly/plotly/graph_objs/_icicle.py @@ -27,6 +27,7 @@ class Icicle(_BaseTraceType): "labels", "labelssrc", "leaf", + "legend", "legendgrouptitle", "legendrank", "legendwidth", @@ -320,12 +321,13 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry` - and `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example - "{fullData.name}". To hide the secondary box - completely, use an empty tag ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variables `currentPath`, `root`, + `entry`, `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To + hide the secondary box completely, use an empty tag + ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -576,6 +578,31 @@ def leaf(self): def leaf(self, val): self["leaf"] = val + # legend + # ------ + @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 + # legendgrouptitle # ---------------- @property @@ -761,6 +788,8 @@ def marker(self): line :class:`plotly.graph_objects.icicle.marker.Line ` instance or dict with compatible properties + pattern + Sets the pattern within the marker. reversescale Reverses the color mapping if true. Has an effect only if colors is set to a numerical @@ -1285,8 +1314,9 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `currentPath`, `root`, `entry`, `percentRoot`, - `percentEntry`, `percentParent`, `label` and `value`. + Finally, the template string has access to variables + `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry`, + `percentParent`, `label` and `value`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1552,10 +1582,11 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry` and - `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -1588,6 +1619,12 @@ def _prop_descriptions(self): leaf :class:`plotly.graph_objects.icicle.Leaf` instance or dict with compatible properties + 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. legendgrouptitle :class:`plotly.graph_objects.icicle.Legendgrouptitle` instance or dict with compatible properties @@ -1695,9 +1732,10 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry`, - `percentParent`, `label` and `value`. + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry`, `percentParent`, `label` + and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1761,6 +1799,7 @@ def __init__( labels=None, labelssrc=None, leaf=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -1862,10 +1901,11 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry` and - `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -1898,6 +1938,12 @@ def __init__( leaf :class:`plotly.graph_objects.icicle.Leaf` instance or dict with compatible properties + 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. legendgrouptitle :class:`plotly.graph_objects.icicle.Legendgrouptitle` instance or dict with compatible properties @@ -2005,9 +2051,10 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry`, - `percentParent`, `label` and `value`. + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry`, `percentParent`, `label` + and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2154,6 +2201,10 @@ def __init__( _v = leaf if leaf is not None else _v if _v is not None: self["leaf"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgrouptitle", None) _v = legendgrouptitle if legendgrouptitle is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_image.py b/packages/python/plotly/plotly/graph_objs/_image.py index f71a0fd2d73..0fdbd6030eb 100644 --- a/packages/python/plotly/plotly/graph_objs/_image.py +++ b/packages/python/plotly/plotly/graph_objs/_image.py @@ -23,6 +23,7 @@ class Image(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgrouptitle", "legendrank", "legendwidth", @@ -287,9 +288,10 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `z`, `color` and `colormodel`. Anything contained in tag - `` is displayed in the secondary box, for example + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variables `z`, `color` and + `colormodel`. Anything contained in tag `` is displayed + in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -412,6 +414,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgrouptitle # ---------------- @property @@ -754,7 +781,9 @@ def visible(self, val): @property def x0(self): """ - Set the image's x position. + Set the image's x position. The left edge of the image (or the + right edge if the x axis is reversed or dx is negative) will be + found at xmin=x0-dx/2 The 'x0' property accepts values of any type @@ -798,7 +827,12 @@ def xaxis(self, val): @property def y0(self): """ - Set the image's y position. + Set the image's y position. The top edge of the image (or the + bottom edge if the y axis is NOT reversed or if dy is negative) + will be found at ymin=y0-dy/2. By default when an image trace + is included, the y axis will be reversed so that the image is + right-side-up, but you can disable this by setting + yaxis.autorange=true or by providing an explicit y axis range. The 'y0' property accepts values of any type @@ -1032,8 +1066,9 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `z`, `color` and `colormodel`. - Anything contained in tag `` is displayed in the + are available. Finally, the template string has access + to variables `z`, `color` and `colormodel`. Anything + contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -1052,6 +1087,12 @@ def _prop_descriptions(self): 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. legendgrouptitle :class:`plotly.graph_objects.image.Legendgrouptitle` instance or dict with compatible properties @@ -1127,14 +1168,23 @@ def _prop_descriptions(self): a legend item (provided that the legend itself is visible). x0 - Set the image's x position. + Set the image's x position. The left edge of the image + (or the right edge if the x axis is reversed or dx is + negative) will be found at xmin=x0-dx/2 xaxis Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on. y0 - Set the image's y position. + Set the image's y position. The top edge of the image + (or the bottom edge if the y axis is NOT reversed or if + dy is negative) will be found at ymin=y0-dy/2. By + default when an image trace is included, the y axis + will be reversed so that the image is right-side-up, + but you can disable this by setting + yaxis.autorange=true or by providing an explicit y axis + range. yaxis Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the @@ -1186,6 +1236,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -1278,8 +1329,9 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `z`, `color` and `colormodel`. - Anything contained in tag `` is displayed in the + are available. Finally, the template string has access + to variables `z`, `color` and `colormodel`. Anything + contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -1298,6 +1350,12 @@ def __init__( 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. legendgrouptitle :class:`plotly.graph_objects.image.Legendgrouptitle` instance or dict with compatible properties @@ -1373,14 +1431,23 @@ def __init__( a legend item (provided that the legend itself is visible). x0 - Set the image's x position. + Set the image's x position. The left edge of the image + (or the right edge if the x axis is reversed or dx is + negative) will be found at xmin=x0-dx/2 xaxis Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" (the default value), the x coordinates refer to `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on. y0 - Set the image's y position. + Set the image's y position. The top edge of the image + (or the bottom edge if the y axis is NOT reversed or if + dy is negative) will be found at ymin=y0-dy/2. By + default when an image trace is included, the y axis + will be reversed so that the image is right-side-up, + but you can disable this by setting + yaxis.autorange=true or by providing an explicit y axis + range. yaxis Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" (the default value), the @@ -1503,6 +1570,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgrouptitle", None) _v = legendgrouptitle if legendgrouptitle is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_indicator.py b/packages/python/plotly/plotly/graph_objs/_indicator.py index 6f0df955de8..4ce34b2adf7 100644 --- a/packages/python/plotly/plotly/graph_objs/_indicator.py +++ b/packages/python/plotly/plotly/graph_objs/_indicator.py @@ -17,6 +17,7 @@ class Indicator(_BaseTraceType): "gauge", "ids", "idssrc", + "legend", "legendgrouptitle", "legendrank", "legendwidth", @@ -286,6 +287,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgrouptitle # ---------------- @property @@ -693,6 +719,12 @@ def _prop_descriptions(self): 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. legendgrouptitle :class:`plotly.graph_objects.indicator.Legendgrouptitle ` instance or dict with compatible properties @@ -783,6 +815,7 @@ def __init__( gauge=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -842,6 +875,12 @@ def __init__( 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. legendgrouptitle :class:`plotly.graph_objects.indicator.Legendgrouptitle ` instance or dict with compatible properties @@ -985,6 +1024,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgrouptitle", None) _v = legendgrouptitle if legendgrouptitle is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_isosurface.py b/packages/python/plotly/plotly/graph_objs/_isosurface.py index c1854573ac1..c7c6a524d4a 100644 --- a/packages/python/plotly/plotly/graph_objs/_isosurface.py +++ b/packages/python/plotly/plotly/graph_objs/_isosurface.py @@ -33,6 +33,7 @@ class Isosurface(_BaseTraceType): "idssrc", "isomax", "isomin", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -486,9 +487,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -498,10 +505,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -511,6 +528,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -968,6 +989,31 @@ def isomin(self): def isomin(self, val): self["isomin"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -2017,6 +2063,12 @@ def _prop_descriptions(self): Sets the maximum boundary for iso-surface plot. isomin Sets the minimum boundary for iso-surface plot. + 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 part of the same legend group hide/show at the same time when @@ -2225,6 +2277,7 @@ def __init__( idssrc=None, isomax=None, isomin=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2400,6 +2453,12 @@ def __init__( Sets the maximum boundary for iso-surface plot. isomin Sets the minimum boundary for iso-surface plot. + 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 part of the same legend group hide/show at the same time when @@ -2709,6 +2768,10 @@ def __init__( _v = isomin if isomin is not None else _v if _v is not None: self["isomin"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_layout.py b/packages/python/plotly/plotly/graph_objs/_layout.py index 82fbdc50090..4b3c346fc99 100644 --- a/packages/python/plotly/plotly/graph_objs/_layout.py +++ b/packages/python/plotly/plotly/graph_objs/_layout.py @@ -7,6 +7,7 @@ class Layout(_BaseLayoutType): _subplotid_prop_names = [ "coloraxis", "geo", + "legend", "mapbox", "polar", "scene", @@ -32,6 +33,7 @@ def _subplotid_validators(self): from plotly.validators.layout import ( ColoraxisValidator, GeoValidator, + LegendValidator, MapboxValidator, PolarValidator, SceneValidator, @@ -44,6 +46,7 @@ def _subplotid_validators(self): return { "coloraxis": ColoraxisValidator, "geo": GeoValidator, + "legend": LegendValidator, "mapbox": MapboxValidator, "polar": PolarValidator, "scene": SceneValidator, @@ -2041,11 +2044,19 @@ def legend(self): valign Sets the vertical alignment of the symbols with respect to their associated text. + visible + Determines whether or not this legend is + visible. x - Sets the x position (in normalized coordinates) - of the legend. Defaults to 1.02 for vertical - legends and defaults to 0 for horizontal - legends. + Sets the x position with respect to `xref` (in + normalized coordinates) of the legend. When + `xref` is "paper", defaults to 1.02 for + vertical legends and defaults to 0 for + horizontal legends. When `xref` is "container", + defaults to 1 for vertical legends and defaults + to 0 for horizontal legends. Must be between 0 + and 1 if `xref` is "container". and between + "-2" and 3 if `xref` is "paper". xanchor Sets the legend's horizontal position anchor. This anchor binds the `x` position to the @@ -2055,13 +2066,21 @@ def legend(self): anchors legends to the left for `x` values less than or equal to 1/3 and anchors legends with respect to their center otherwise. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position (in normalized coordinates) - of the legend. Defaults to 1 for vertical + Sets the y position with respect to `yref` (in + normalized coordinates) of the legend. When + `yref` is "paper", defaults to 1 for vertical legends, defaults to "-0.1" for horizontal legends on graphs w/o range sliders and defaults to 1.1 for horizontal legends on graph - with one or multiple range sliders. + with one or multiple range sliders. When `yref` + is "container", defaults to 1. Must be between + 0 and 1 if `yref` is "container" and between + "-2" and 3 if `yref` is "paper". yanchor Sets the legend's vertical position anchor This anchor binds the `y` position to the "top", @@ -2071,6 +2090,10 @@ def legend(self): legends to at their top for `y` values greater than or equal to 2/3 and anchors legends with respect to their middle otherwise. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/_mesh3d.py b/packages/python/plotly/plotly/graph_objs/_mesh3d.py index 4fcb38a127b..b7558495bef 100644 --- a/packages/python/plotly/plotly/graph_objs/_mesh3d.py +++ b/packages/python/plotly/plotly/graph_objs/_mesh3d.py @@ -44,6 +44,7 @@ class Mesh3d(_BaseTraceType): "jsrc", "k", "ksrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -562,9 +563,15 @@ def colorbar(self): title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -574,10 +581,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -587,6 +604,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -1271,6 +1292,31 @@ def ksrc(self): def ksrc(self, val): self["ksrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -2328,6 +2374,12 @@ def _prop_descriptions(self): ksrc Sets the source reference on Chart Studio Cloud for `k`. + 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 part of the same legend group hide/show at the same time when @@ -2548,6 +2600,7 @@ def __init__( jsrc=None, k=None, ksrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2791,6 +2844,12 @@ def __init__( ksrc Sets the source reference on Chart Studio Cloud for `k`. + 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 part of the same legend group hide/show at the same time when @@ -3145,6 +3204,10 @@ def __init__( _v = ksrc if ksrc is not None else _v if _v is not None: self["ksrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_ohlc.py b/packages/python/plotly/plotly/graph_objs/_ohlc.py index 741c9823eca..ea5cf970e9b 100644 --- a/packages/python/plotly/plotly/graph_objs/_ohlc.py +++ b/packages/python/plotly/plotly/graph_objs/_ohlc.py @@ -24,6 +24,7 @@ class Ohlc(_BaseTraceType): "ids", "idssrc", "increasing", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -431,6 +432,31 @@ def increasing(self): def increasing(self, val): self["increasing"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1259,6 +1285,12 @@ def _prop_descriptions(self): increasing :class:`plotly.graph_objects.ohlc.Increasing` instance or dict with compatible properties + 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 part of the same legend group hide/show at the same time when @@ -1442,6 +1474,7 @@ def __init__( ids=None, idssrc=None, increasing=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1540,6 +1573,12 @@ def __init__( increasing :class:`plotly.graph_objects.ohlc.Increasing` instance or dict with compatible properties + 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 part of the same legend group hide/show at the same time when @@ -1797,6 +1836,10 @@ def __init__( _v = increasing if increasing is not None else _v if _v is not None: self["increasing"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_parcats.py b/packages/python/plotly/plotly/graph_objs/_parcats.py index 0b63fa75506..ba8fd8be1eb 100644 --- a/packages/python/plotly/plotly/graph_objs/_parcats.py +++ b/packages/python/plotly/plotly/graph_objs/_parcats.py @@ -338,12 +338,16 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `count`, `probability`, `category`, `categorycount`, - `colorcount` and `bandcolorcount`. Anything contained in tag - `` is displayed in the secondary box, for example - "{fullData.name}". To hide the secondary box - completely, use an empty tag ``. + (the ones that are `arrayOk: true`) are available. This value + here applies when hovering over dimensions. Note that + `*categorycount`, "colorcount" and "bandcolorcount" are only + available when `hoveron` contains the "color" flagFinally, the + template string has access to variables `count`, `probability`, + `category`, `categorycount`, `colorcount` and `bandcolorcount`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To + hide the secondary box completely, use an empty tag + ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -571,9 +575,11 @@ def line(self): events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. - variables `count` and `probability`. Anything - contained in tag `` is displayed in the - secondary box, for example + This value here applies when hovering over + lines.Finally, the template string has access + to variables `count` and `probability`. + Anything contained in tag `` is + displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -927,12 +933,17 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `count`, `probability`, - `category`, `categorycount`, `colorcount` and - `bandcolorcount`. Anything contained in tag `` - is displayed in the secondary box, for example - "{fullData.name}". To hide the secondary - box completely, use an empty tag ``. + are available. This value here applies when hovering + over dimensions. Note that `*categorycount`, + "colorcount" and "bandcolorcount" are only available + when `hoveron` contains the "color" flagFinally, the + template string has access to variables `count`, + `probability`, `category`, `categorycount`, + `colorcount` and `bandcolorcount`. Anything contained + in tag `` is displayed in the secondary box, for + example "{fullData.name}". To hide the + secondary box completely, use an empty tag + ``. labelfont Sets the font for the `dimension` labels. legendgrouptitle @@ -1105,12 +1116,17 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `count`, `probability`, - `category`, `categorycount`, `colorcount` and - `bandcolorcount`. Anything contained in tag `` - is displayed in the secondary box, for example - "{fullData.name}". To hide the secondary - box completely, use an empty tag ``. + are available. This value here applies when hovering + over dimensions. Note that `*categorycount`, + "colorcount" and "bandcolorcount" are only available + when `hoveron` contains the "color" flagFinally, the + template string has access to variables `count`, + `probability`, `category`, `categorycount`, + `colorcount` and `bandcolorcount`. Anything contained + in tag `` is displayed in the secondary box, for + example "{fullData.name}". To hide the + secondary box completely, use an empty tag + ``. labelfont Sets the font for the `dimension` labels. legendgrouptitle diff --git a/packages/python/plotly/plotly/graph_objs/_parcoords.py b/packages/python/plotly/plotly/graph_objs/_parcoords.py index 0f6d2a290c9..4e29b8c5478 100644 --- a/packages/python/plotly/plotly/graph_objs/_parcoords.py +++ b/packages/python/plotly/plotly/graph_objs/_parcoords.py @@ -19,6 +19,7 @@ class Parcoords(_BaseTraceType): "labelangle", "labelfont", "labelside", + "legend", "legendgrouptitle", "legendrank", "legendwidth", @@ -386,6 +387,31 @@ def labelside(self): def labelside(self, val): self["labelside"] = val + # legend + # ------ + @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 + # legendgrouptitle # ---------------- @property @@ -922,6 +948,12 @@ def _prop_descriptions(self): labels below the graph Tilted labels with "labelangle" may be positioned better inside margins when `labelposition` is set to "bottom". + 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. legendgrouptitle :class:`plotly.graph_objects.parcoords.Legendgrouptitle ` instance or dict with compatible properties @@ -1010,6 +1042,7 @@ def __init__( labelangle=None, labelfont=None, labelside=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -1078,6 +1111,12 @@ def __init__( labels below the graph Tilted labels with "labelangle" may be positioned better inside margins when `labelposition` is set to "bottom". + 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. legendgrouptitle :class:`plotly.graph_objects.parcoords.Legendgrouptitle ` instance or dict with compatible properties @@ -1225,6 +1264,10 @@ def __init__( _v = labelside if labelside is not None else _v if _v is not None: self["labelside"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgrouptitle", None) _v = legendgrouptitle if legendgrouptitle is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_pie.py b/packages/python/plotly/plotly/graph_objs/_pie.py index f42621f652c..0e8f6be6c0b 100644 --- a/packages/python/plotly/plotly/graph_objs/_pie.py +++ b/packages/python/plotly/plotly/graph_objs/_pie.py @@ -30,6 +30,7 @@ class Pie(_BaseTraceType): "label0", "labels", "labelssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -359,11 +360,12 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `label`, `color`, `value`, `percent` and `text`. Anything - contained in tag `` is displayed in the secondary box, - for example "{fullData.name}". To hide the - secondary box completely, use an empty tag ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variables `label`, `color`, + `value`, `percent` and `text`. Anything contained in tag + `` is displayed in the secondary box, for example + "{fullData.name}". To hide the secondary box + completely, use an empty tag ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -640,6 +642,31 @@ def labelssrc(self): def labelssrc(self, val): self["labelssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -760,6 +787,8 @@ def marker(self): line :class:`plotly.graph_objects.pie.marker.Line` instance or dict with compatible properties + pattern + Sets the pattern within the marker. Returns ------- @@ -1265,7 +1294,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `label`, `color`, `value`, `percent` and `text`. + Finally, the template string has access to variables `label`, + `color`, `value`, `percent` and `text`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1610,12 +1640,12 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `percent` and `text`. Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `percent` and + `text`. Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -1661,6 +1691,12 @@ def _prop_descriptions(self): labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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 part of the same legend group hide/show at the same time when @@ -1764,8 +1800,9 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `percent` and `text`. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `percent` and + `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1845,6 +1882,7 @@ def __init__( label0=None, labels=None, labelssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1949,12 +1987,12 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `percent` and `text`. Anything contained in tag - `` is displayed in the secondary box, for - example "{fullData.name}". To hide the - secondary box completely, use an empty tag - ``. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `percent` and + `text`. Anything contained in tag `` is + displayed in the secondary box, for example + "{fullData.name}". To hide the secondary + box completely, use an empty tag ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -2000,6 +2038,12 @@ def __init__( labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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 part of the same legend group hide/show at the same time when @@ -2103,8 +2147,9 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `label`, `color`, `value`, - `percent` and `text`. + are available. Finally, the template string has access + to variables `label`, `color`, `value`, `percent` and + `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2271,6 +2316,10 @@ def __init__( _v = labelssrc if labelssrc is not None else _v if _v is not None: self["labelssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_pointcloud.py b/packages/python/plotly/plotly/graph_objs/_pointcloud.py index 6b4e4097ec1..dd8a9807c3c 100644 --- a/packages/python/plotly/plotly/graph_objs/_pointcloud.py +++ b/packages/python/plotly/plotly/graph_objs/_pointcloud.py @@ -18,6 +18,7 @@ class Pointcloud(_BaseTraceType): "idssrc", "indices", "indicessrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -287,6 +288,31 @@ def indicessrc(self): def indicessrc(self, val): self["indicessrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1015,6 +1041,12 @@ def _prop_descriptions(self): indicessrc Sets the source reference on Chart Studio Cloud for `indices`. + 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 part of the same legend group hide/show at the same time when @@ -1159,6 +1191,7 @@ def __init__( idssrc=None, indices=None, indicessrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1239,6 +1272,12 @@ def __init__( indicessrc Sets the source reference on Chart Studio Cloud for `indices`. + 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 part of the same legend group hide/show at the same time when @@ -1439,6 +1478,10 @@ def __init__( _v = indicessrc if indicessrc is not None else _v if _v is not None: self["indicessrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_sankey.py b/packages/python/plotly/plotly/graph_objs/_sankey.py index a0306d48e74..6c5fe414881 100644 --- a/packages/python/plotly/plotly/graph_objs/_sankey.py +++ b/packages/python/plotly/plotly/graph_objs/_sankey.py @@ -17,6 +17,7 @@ class Sankey(_BaseTraceType): "hoverlabel", "ids", "idssrc", + "legend", "legendgrouptitle", "legendrank", "legendwidth", @@ -272,6 +273,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgrouptitle # ---------------- @property @@ -425,7 +451,9 @@ def link(self): events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. - variables `value` and `label`. Anything + Variables `source` and `target` are node + objects.Finally, the template string has access + to variables `value` and `label`. Anything contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the @@ -614,9 +642,11 @@ def node(self): events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. - variables `value` and `label`. Anything - contained in tag `` is displayed in the - secondary box, for example + Variables `sourceLinks` and `targetLinks` are + arrays of link objects.Finally, the template + string has access to variables `value` and + `label`. Anything contained in tag `` is + displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -951,6 +981,12 @@ def _prop_descriptions(self): 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. legendgrouptitle :class:`plotly.graph_objects.sankey.Legendgrouptitle` instance or dict with compatible properties @@ -1051,6 +1087,7 @@ def __init__( hoverlabel=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -1119,6 +1156,12 @@ def __init__( 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. legendgrouptitle :class:`plotly.graph_objects.sankey.Legendgrouptitle` instance or dict with compatible properties @@ -1272,6 +1315,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgrouptitle", None) _v = legendgrouptitle if legendgrouptitle is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_scatter.py b/packages/python/plotly/plotly/graph_objs/_scatter.py index 6d63dbc6d6e..afe8da313ae 100644 --- a/packages/python/plotly/plotly/graph_objs/_scatter.py +++ b/packages/python/plotly/plotly/graph_objs/_scatter.py @@ -32,6 +32,7 @@ class Scatter(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -883,6 +884,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -2427,6 +2453,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -2718,6 +2750,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2920,6 +2953,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -3309,6 +3348,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_scatter3d.py b/packages/python/plotly/plotly/graph_objs/_scatter3d.py index 08ff42668e7..7dbbe9f048f 100644 --- a/packages/python/plotly/plotly/graph_objs/_scatter3d.py +++ b/packages/python/plotly/plotly/graph_objs/_scatter3d.py @@ -24,6 +24,7 @@ class Scatter3d(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -632,6 +633,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1954,6 +1980,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -2173,6 +2205,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2308,6 +2341,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2601,6 +2640,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_scattercarpet.py b/packages/python/plotly/plotly/graph_objs/_scattercarpet.py index 8b4a28f5534..0e7021ae5d7 100644 --- a/packages/python/plotly/plotly/graph_objs/_scattercarpet.py +++ b/packages/python/plotly/plotly/graph_objs/_scattercarpet.py @@ -29,6 +29,7 @@ class Scattercarpet(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -603,6 +604,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1321,7 +1347,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `a`, `b` and `text`. + Finally, the template string has access to variables `a`, `b` + and `text`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1634,6 +1661,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -1736,7 +1769,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `a`, `b` and `text`. + are available. Finally, the template string has access + to variables `a`, `b` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1805,6 +1839,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1950,6 +1985,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2052,7 +2093,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `a`, `b` and `text`. + are available. Finally, the template string has access + to variables `a`, `b` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2210,6 +2252,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_scattergeo.py b/packages/python/plotly/plotly/graph_objs/_scattergeo.py index 1315ca1c10b..8794c70a858 100644 --- a/packages/python/plotly/plotly/graph_objs/_scattergeo.py +++ b/packages/python/plotly/plotly/graph_objs/_scattergeo.py @@ -28,6 +28,7 @@ class Scattergeo(_BaseTraceType): "idssrc", "lat", "latsrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -585,6 +586,31 @@ def latsrc(self): def latsrc(self, val): self["latsrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1391,7 +1417,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `lat`, `lon`, `location` and `text`. + Finally, the template string has access to variables `lat`, + `lon`, `location` and `text`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1653,6 +1680,12 @@ def _prop_descriptions(self): latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the same time when @@ -1775,8 +1808,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `lat`, `lon`, `location` and - `text`. + are available. Finally, the template string has access + to variables `lat`, `lon`, `location` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1834,6 +1867,7 @@ def __init__( idssrc=None, lat=None, latsrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1983,6 +2017,12 @@ def __init__( latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the same time when @@ -2105,8 +2145,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `lat`, `lon`, `location` and - `text`. + are available. Finally, the template string has access + to variables `lat`, `lon`, `location` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2250,6 +2290,10 @@ def __init__( _v = latsrc if latsrc is not None else _v if _v is not None: self["latsrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_scattergl.py b/packages/python/plotly/plotly/graph_objs/_scattergl.py index 8022a964b0a..08ffff2b2db 100644 --- a/packages/python/plotly/plotly/graph_objs/_scattergl.py +++ b/packages/python/plotly/plotly/graph_objs/_scattergl.py @@ -27,6 +27,7 @@ class Scattergl(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -700,6 +701,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -2053,6 +2079,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -2297,6 +2329,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2463,6 +2496,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2790,6 +2829,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_scattermapbox.py b/packages/python/plotly/plotly/graph_objs/_scattermapbox.py index d5395bf275e..6250cb8b47f 100644 --- a/packages/python/plotly/plotly/graph_objs/_scattermapbox.py +++ b/packages/python/plotly/plotly/graph_objs/_scattermapbox.py @@ -27,6 +27,7 @@ class Scattermapbox(_BaseTraceType): "idssrc", "lat", "latsrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -589,6 +590,31 @@ def latsrc(self): def latsrc(self, val): self["latsrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1290,7 +1316,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `lat`, `lon` and `text`. + Finally, the template string has access to variables `lat`, + `lon` and `text`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1538,6 +1565,12 @@ def _prop_descriptions(self): latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the same time when @@ -1647,7 +1680,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `lat`, `lon` and `text`. + are available. Finally, the template string has access + to variables `lat`, `lon` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1704,6 +1738,7 @@ def __init__( idssrc=None, lat=None, latsrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1839,6 +1874,12 @@ def __init__( latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the same time when @@ -1948,7 +1989,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `lat`, `lon` and `text`. + are available. Finally, the template string has access + to variables `lat`, `lon` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2088,6 +2130,10 @@ def __init__( _v = latsrc if latsrc is not None else _v if _v is not None: self["latsrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_scatterpolar.py b/packages/python/plotly/plotly/graph_objs/_scatterpolar.py index 5958fb57041..fef4731b801 100644 --- a/packages/python/plotly/plotly/graph_objs/_scatterpolar.py +++ b/packages/python/plotly/plotly/graph_objs/_scatterpolar.py @@ -27,6 +27,7 @@ class Scatterpolar(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -569,6 +570,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1373,7 +1399,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `r`, `theta` and `text`. + Finally, the template string has access to variables `r`, + `theta` and `text`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1718,6 +1745,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -1834,7 +1867,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `r`, `theta` and `text`. + are available. Finally, the template string has access + to variables `r`, `theta` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1903,6 +1937,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2058,6 +2093,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2174,7 +2215,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `r`, `theta` and `text`. + are available. Finally, the template string has access + to variables `r`, `theta` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2326,6 +2368,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_scatterpolargl.py b/packages/python/plotly/plotly/graph_objs/_scatterpolargl.py index 56dd91c6b09..ff2ef30086b 100644 --- a/packages/python/plotly/plotly/graph_objs/_scatterpolargl.py +++ b/packages/python/plotly/plotly/graph_objs/_scatterpolargl.py @@ -25,6 +25,7 @@ class Scatterpolargl(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -530,6 +531,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1293,7 +1319,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `r`, `theta` and `text`. + Finally, the template string has access to variables `r`, + `theta` and `text`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1638,6 +1665,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -1754,7 +1787,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `r`, `theta` and `text`. + are available. Finally, the template string has access + to variables `r`, `theta` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1821,6 +1855,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1976,6 +2011,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2092,7 +2133,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `r`, `theta` and `text`. + are available. Finally, the template string has access + to variables `r`, `theta` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2236,6 +2278,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_scattersmith.py b/packages/python/plotly/plotly/graph_objs/_scattersmith.py index 45e6c96eb20..da06c989e9e 100644 --- a/packages/python/plotly/plotly/graph_objs/_scattersmith.py +++ b/packages/python/plotly/plotly/graph_objs/_scattersmith.py @@ -27,6 +27,7 @@ class Scattersmith(_BaseTraceType): "idssrc", "imag", "imagsrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -564,6 +565,31 @@ def imagsrc(self): def imagsrc(self, val): self["imagsrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1348,7 +1374,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `real`, `imag` and `text`. + Finally, the template string has access to variables `real`, + `imag` and `text`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1611,6 +1638,12 @@ def _prop_descriptions(self): imagsrc Sets the source reference on Chart Studio Cloud for `imag`. + 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 part of the same legend group hide/show at the same time when @@ -1725,7 +1758,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `real`, `imag` and `text`. + are available. Finally, the template string has access + to variables `real`, `imag` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1782,6 +1816,7 @@ def __init__( idssrc=None, imag=None, imagsrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1933,6 +1968,12 @@ def __init__( imagsrc Sets the source reference on Chart Studio Cloud for `imag`. + 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 part of the same legend group hide/show at the same time when @@ -2047,7 +2088,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `real`, `imag` and `text`. + are available. Finally, the template string has access + to variables `real`, `imag` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2187,6 +2229,10 @@ def __init__( _v = imagsrc if imagsrc is not None else _v if _v is not None: self["imagsrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_scatterternary.py b/packages/python/plotly/plotly/graph_objs/_scatterternary.py index 1f395f18404..929871d190e 100644 --- a/packages/python/plotly/plotly/graph_objs/_scatterternary.py +++ b/packages/python/plotly/plotly/graph_objs/_scatterternary.py @@ -31,6 +31,7 @@ class Scatterternary(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -654,6 +655,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1421,7 +1447,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `a`, `b`, `c` and `text`. + Finally, the template string has access to variables `a`, `b`, + `c` and `text`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1704,6 +1731,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -1818,7 +1851,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `a`, `b`, `c` and `text`. + are available. Finally, the template string has access + to variables `a`, `b`, `c` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1879,6 +1913,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2046,6 +2081,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2160,7 +2201,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `a`, `b`, `c` and `text`. + are available. Finally, the template string has access + to variables `a`, `b`, `c` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2316,6 +2358,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_splom.py b/packages/python/plotly/plotly/graph_objs/_splom.py index b2d64303df5..9e483a5c6d4 100644 --- a/packages/python/plotly/plotly/graph_objs/_splom.py +++ b/packages/python/plotly/plotly/graph_objs/_splom.py @@ -23,6 +23,7 @@ class Splom(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -466,6 +467,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1309,6 +1335,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -1473,6 +1505,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -1590,6 +1623,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -1825,6 +1864,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_streamtube.py b/packages/python/plotly/plotly/graph_objs/_streamtube.py index 28b2101d713..6da475e7b32 100644 --- a/packages/python/plotly/plotly/graph_objs/_streamtube.py +++ b/packages/python/plotly/plotly/graph_objs/_streamtube.py @@ -27,6 +27,7 @@ class Streamtube(_BaseTraceType): "hovertext", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -455,9 +456,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -467,10 +474,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -480,6 +497,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -718,12 +739,13 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `tubex`, `tubey`, `tubez`, `tubeu`, `tubev`, `tubew`, `norm` - and `divergence`. Anything contained in tag `` is - displayed in the secondary box, for example - "{fullData.name}". To hide the secondary box - completely, use an empty tag ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variables `tubex`, `tubey`, + `tubez`, `tubeu`, `tubev`, `tubew`, `norm` and `divergence`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To + hide the secondary box completely, use an empty tag + ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -824,6 +846,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1915,9 +1962,10 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `tubex`, `tubey`, `tubez`, - `tubeu`, `tubev`, `tubew`, `norm` and `divergence`. - Anything contained in tag `` is displayed in the + are available. Finally, the template string has access + to variables `tubex`, `tubey`, `tubez`, `tubeu`, + `tubev`, `tubew`, `norm` and `divergence`. Anything + contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -1933,6 +1981,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -2155,6 +2209,7 @@ def __init__( hovertext=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2305,9 +2360,10 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `tubex`, `tubey`, `tubez`, - `tubeu`, `tubev`, `tubew`, `norm` and `divergence`. - Anything contained in tag `` is displayed in the + are available. Finally, the template string has access + to variables `tubex`, `tubey`, `tubez`, `tubeu`, + `tubev`, `tubew`, `norm` and `divergence`. Anything + contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -2323,6 +2379,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2628,6 +2690,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_sunburst.py b/packages/python/plotly/plotly/graph_objs/_sunburst.py index e0a6e980c0b..6100916c77a 100644 --- a/packages/python/plotly/plotly/graph_objs/_sunburst.py +++ b/packages/python/plotly/plotly/graph_objs/_sunburst.py @@ -28,6 +28,7 @@ class Sunburst(_BaseTraceType): "labels", "labelssrc", "leaf", + "legend", "legendgrouptitle", "legendrank", "legendwidth", @@ -320,12 +321,13 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry` - and `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example - "{fullData.name}". To hide the secondary box - completely, use an empty tag ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variables `currentPath`, `root`, + `entry`, `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To + hide the secondary box completely, use an empty tag + ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -604,6 +606,31 @@ def leaf(self): def leaf(self, val): self["leaf"] = val + # legend + # ------ + @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 + # legendgrouptitle # ---------------- @property @@ -789,6 +816,8 @@ def marker(self): line :class:`plotly.graph_objects.sunburst.marker.Li ne` instance or dict with compatible properties + pattern + Sets the pattern within the marker. reversescale Reverses the color mapping if true. Has an effect only if colors is set to a numerical @@ -1273,8 +1302,9 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `currentPath`, `root`, `entry`, `percentRoot`, - `percentEntry`, `percentParent`, `label` and `value`. + Finally, the template string has access to variables + `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry`, + `percentParent`, `label` and `value`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1499,10 +1529,11 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry` and - `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -1545,6 +1576,12 @@ def _prop_descriptions(self): leaf :class:`plotly.graph_objects.sunburst.Leaf` instance or dict with compatible properties + 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. legendgrouptitle :class:`plotly.graph_objects.sunburst.Legendgrouptitle` instance or dict with compatible properties @@ -1650,9 +1687,10 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry`, - `percentParent`, `label` and `value`. + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry`, `percentParent`, `label` + and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1714,6 +1752,7 @@ def __init__( labels=None, labelssrc=None, leaf=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -1813,10 +1852,11 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry` and - `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -1859,6 +1899,12 @@ def __init__( leaf :class:`plotly.graph_objects.sunburst.Leaf` instance or dict with compatible properties + 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. legendgrouptitle :class:`plotly.graph_objects.sunburst.Legendgrouptitle` instance or dict with compatible properties @@ -1964,9 +2010,10 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry`, - `percentParent`, `label` and `value`. + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry`, `percentParent`, `label` + and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2114,6 +2161,10 @@ def __init__( _v = leaf if leaf is not None else _v if _v is not None: self["leaf"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgrouptitle", None) _v = legendgrouptitle if legendgrouptitle is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_surface.py b/packages/python/plotly/plotly/graph_objs/_surface.py index 402ad06b1ef..6fa7bb5749c 100644 --- a/packages/python/plotly/plotly/graph_objs/_surface.py +++ b/packages/python/plotly/plotly/graph_objs/_surface.py @@ -31,6 +31,7 @@ class Surface(_BaseTraceType): "hovertextsrc", "ids", "idssrc", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -454,9 +455,15 @@ def colorbar(self): title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -466,10 +473,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -479,6 +496,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -919,6 +940,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1915,6 +1961,12 @@ def _prop_descriptions(self): 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 part of the same legend group hide/show at the same time when @@ -2124,6 +2176,7 @@ def __init__( hovertextsrc=None, ids=None, idssrc=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2299,6 +2352,12 @@ def __init__( 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 part of the same legend group hide/show at the same time when @@ -2603,6 +2662,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_table.py b/packages/python/plotly/plotly/graph_objs/_table.py index 02ab94a6d43..9b4d9171f05 100644 --- a/packages/python/plotly/plotly/graph_objs/_table.py +++ b/packages/python/plotly/plotly/graph_objs/_table.py @@ -23,6 +23,7 @@ class Table(_BaseTraceType): "hoverlabel", "ids", "idssrc", + "legend", "legendgrouptitle", "legendrank", "legendwidth", @@ -497,6 +498,31 @@ def idssrc(self): def idssrc(self, val): self["idssrc"] = val + # legend + # ------ + @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 + # legendgrouptitle # ---------------- @property @@ -813,6 +839,12 @@ def _prop_descriptions(self): 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. legendgrouptitle :class:`plotly.graph_objects.table.Legendgrouptitle` instance or dict with compatible properties @@ -895,6 +927,7 @@ def __init__( hoverlabel=None, ids=None, idssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -971,6 +1004,12 @@ def __init__( 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. legendgrouptitle :class:`plotly.graph_objects.table.Legendgrouptitle` instance or dict with compatible properties @@ -1124,6 +1163,10 @@ def __init__( _v = idssrc if idssrc is not None else _v if _v is not None: self["idssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgrouptitle", None) _v = legendgrouptitle if legendgrouptitle is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_treemap.py b/packages/python/plotly/plotly/graph_objs/_treemap.py index 45fe870ec01..a1620417d88 100644 --- a/packages/python/plotly/plotly/graph_objs/_treemap.py +++ b/packages/python/plotly/plotly/graph_objs/_treemap.py @@ -26,6 +26,7 @@ class Treemap(_BaseTraceType): "insidetextfont", "labels", "labelssrc", + "legend", "legendgrouptitle", "legendrank", "legendwidth", @@ -320,12 +321,13 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry` - and `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example - "{fullData.name}". To hide the secondary box - completely, use an empty tag ``. + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variables `currentPath`, `root`, + `entry`, `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To + hide the secondary box completely, use an empty tag + ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -548,6 +550,31 @@ def labelssrc(self): def labelssrc(self, val): self["labelssrc"] = val + # legend + # ------ + @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 + # legendgrouptitle # ---------------- @property @@ -749,6 +776,8 @@ def marker(self): pad :class:`plotly.graph_objects.treemap.marker.Pad ` instance or dict with compatible properties + pattern + Sets the pattern within the marker. reversescale Reverses the color mapping if true. Has an effect only if colors is set to a numerical @@ -1273,8 +1302,9 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `currentPath`, `root`, `entry`, `percentRoot`, - `percentEntry`, `percentParent`, `label` and `value`. + Finally, the template string has access to variables + `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry`, + `percentParent`, `label` and `value`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1548,10 +1578,11 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry` and - `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -1581,6 +1612,12 @@ def _prop_descriptions(self): labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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. legendgrouptitle :class:`plotly.graph_objects.treemap.Legendgrouptitle` instance or dict with compatible properties @@ -1688,9 +1725,10 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry`, - `percentParent`, `label` and `value`. + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry`, `percentParent`, `label` + and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -1753,6 +1791,7 @@ def __init__( insidetextfont=None, labels=None, labelssrc=None, + legend=None, legendgrouptitle=None, legendrank=None, legendwidth=None, @@ -1855,10 +1894,11 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry` and - `percentParent`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry` and `percentParent`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -1888,6 +1928,12 @@ def __init__( labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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. legendgrouptitle :class:`plotly.graph_objects.treemap.Legendgrouptitle` instance or dict with compatible properties @@ -1995,9 +2041,10 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `currentPath`, `root`, - `entry`, `percentRoot`, `percentEntry`, - `percentParent`, `label` and `value`. + are available. Finally, the template string has access + to variables `currentPath`, `root`, `entry`, + `percentRoot`, `percentEntry`, `percentParent`, `label` + and `value`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2140,6 +2187,10 @@ def __init__( _v = labelssrc if labelssrc is not None else _v if _v is not None: self["labelssrc"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgrouptitle", None) _v = legendgrouptitle if legendgrouptitle is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_violin.py b/packages/python/plotly/plotly/graph_objs/_violin.py index 7dccc6f3a7e..09ef7e81a1c 100644 --- a/packages/python/plotly/plotly/graph_objs/_violin.py +++ b/packages/python/plotly/plotly/graph_objs/_violin.py @@ -26,6 +26,7 @@ class Violin(_BaseTraceType): "ids", "idssrc", "jitter", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -561,6 +562,31 @@ def jitter(self): def jitter(self, val): self["jitter"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1734,6 +1760,12 @@ def _prop_descriptions(self): If 0, the sample points align along the distribution axis. If 1, the sample points are drawn in a random jitter of width equal to the width of the violins. + 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 part of the same legend group hide/show at the same time when @@ -1998,6 +2030,7 @@ def __init__( ids=None, idssrc=None, jitter=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2144,6 +2177,12 @@ def __init__( If 0, the sample points align along the distribution axis. If 1, the sample points are drawn in a random jitter of width equal to the width of the violins. + 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 part of the same legend group hide/show at the same time when @@ -2488,6 +2527,10 @@ def __init__( _v = jitter if jitter is not None else _v if _v is not None: self["jitter"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_volume.py b/packages/python/plotly/plotly/graph_objs/_volume.py index 399b26735f1..3fce73d638d 100644 --- a/packages/python/plotly/plotly/graph_objs/_volume.py +++ b/packages/python/plotly/plotly/graph_objs/_volume.py @@ -33,6 +33,7 @@ class Volume(_BaseTraceType): "idssrc", "isomax", "isomin", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -487,9 +488,15 @@ def colorbar(self): title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -499,10 +506,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -512,6 +529,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -969,6 +990,31 @@ def isomin(self): def isomin(self, val): self["isomin"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -2043,6 +2089,12 @@ def _prop_descriptions(self): Sets the maximum boundary for iso-surface plot. isomin Sets the minimum boundary for iso-surface plot. + 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 part of the same legend group hide/show at the same time when @@ -2262,6 +2314,7 @@ def __init__( idssrc=None, isomax=None, isomin=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2438,6 +2491,12 @@ def __init__( Sets the maximum boundary for iso-surface plot. isomin Sets the minimum boundary for iso-surface plot. + 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 part of the same legend group hide/show at the same time when @@ -2758,6 +2817,10 @@ def __init__( _v = isomin if isomin is not None else _v if _v is not None: self["isomin"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/_waterfall.py b/packages/python/plotly/plotly/graph_objs/_waterfall.py index 0e1742f8a12..71952dea4da 100644 --- a/packages/python/plotly/plotly/graph_objs/_waterfall.py +++ b/packages/python/plotly/plotly/graph_objs/_waterfall.py @@ -31,6 +31,7 @@ class Waterfall(_BaseTraceType): "increasing", "insidetextanchor", "insidetextfont", + "legend", "legendgroup", "legendgrouptitle", "legendrank", @@ -445,9 +446,10 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `initial`, `delta` and `final`. Anything contained in tag - `` is displayed in the secondary box, for example + (the ones that are `arrayOk: true`) are available. Finally, the + template string has access to variables `initial`, `delta` and + `final`. Anything contained in tag `` is displayed in + the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. @@ -682,6 +684,31 @@ def insidetextfont(self): def insidetextfont(self, val): self["insidetextfont"] = val + # legend + # ------ + @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 + # legendgroup # ----------- @property @@ -1355,7 +1382,8 @@ def texttemplate(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per- point (the ones that are `arrayOk: true`) are available. - variables `initial`, `delta`, `final` and `label`. + Finally, the template string has access to variables `initial`, + `delta`, `final` and `label`. The 'texttemplate' property is a string and must be specified as: - A string @@ -1988,9 +2016,10 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `initial`, `delta` and - `final`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `initial`, `delta` and `final`. Anything + contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -2021,6 +2050,12 @@ def _prop_descriptions(self): points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -2151,8 +2186,8 @@ def _prop_descriptions(self): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `initial`, `delta`, `final` - and `label`. + are available. Finally, the template string has access + to variables `initial`, `delta`, `final` and `label`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2304,6 +2339,7 @@ def __init__( increasing=None, insidetextanchor=None, insidetextfont=None, + legend=None, legendgroup=None, legendgrouptitle=None, legendrank=None, @@ -2361,7 +2397,7 @@ def __init__( Draws waterfall trace which is useful graph to displays the contribution of various elements (either positive or negative) in a bar chart. The data visualized by the span of the bars is - set in `y` if `orientation` is set th "v" (the default) and the + set in `y` if `orientation` is set to "v" (the default) and the labels are set in `x`. By setting `orientation` to "h", the roles are interchanged. @@ -2439,9 +2475,10 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `initial`, `delta` and - `final`. Anything contained in tag `` is - displayed in the secondary box, for example + are available. Finally, the template string has access + to variables `initial`, `delta` and `final`. Anything + contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -2472,6 +2509,12 @@ def __init__( points in `textposition` "inside" mode. insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the same time when @@ -2602,8 +2645,8 @@ def __init__( format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `initial`, `delta`, `final` - and `label`. + are available. Finally, the template string has access + to variables `initial`, `delta`, `final` and `label`. texttemplatesrc Sets the source reference on Chart Studio Cloud for `texttemplate`. @@ -2850,6 +2893,10 @@ def __init__( _v = insidetextfont if insidetextfont is not None else _v if _v is not None: self["insidetextfont"] = _v + _v = arg.pop("legend", None) + _v = legend if legend is not None else _v + if _v is not None: + self["legend"] = _v _v = arg.pop("legendgroup", None) _v = legendgroup if legendgroup is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/bar/_marker.py b/packages/python/plotly/plotly/graph_objs/bar/_marker.py index fc7cb043a24..700e69ba468 100644 --- a/packages/python/plotly/plotly/graph_objs/bar/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/bar/_marker.py @@ -483,9 +483,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -495,10 +501,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -508,6 +524,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/bar/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/bar/marker/_colorbar.py index 08b26e83f9e..53f513edbcf 100644 --- a/packages/python/plotly/plotly/graph_objs/bar/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/bar/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1308,12 +1310,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1369,17 +1375,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1435,6 +1468,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1645,9 +1701,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1657,10 +1718,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1670,6 +1740,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1726,9 +1800,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1945,9 +2021,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1957,10 +2038,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1970,6 +2060,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2188,6 +2282,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2200,6 +2298,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/barpolar/_marker.py b/packages/python/plotly/plotly/graph_objs/barpolar/_marker.py index 9114acb628d..66ff6fc725d 100644 --- a/packages/python/plotly/plotly/graph_objs/barpolar/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/barpolar/_marker.py @@ -484,9 +484,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -496,10 +502,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -509,6 +525,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/barpolar/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/barpolar/marker/_colorbar.py index a0b7f6861aa..9c752845e12 100644 --- a/packages/python/plotly/plotly/graph_objs/barpolar/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/barpolar/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1647,9 +1703,14 @@ def _prop_descriptions(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1659,10 +1720,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1672,6 +1742,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1728,9 +1802,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1947,9 +2023,14 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1959,10 +2040,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1972,6 +2062,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2190,6 +2284,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2202,6 +2300,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/choropleth/_colorbar.py b/packages/python/plotly/plotly/graph_objs/choropleth/_colorbar.py index 76219170397..7d18a8a27e5 100644 --- a/packages/python/plotly/plotly/graph_objs/choropleth/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/choropleth/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1308,12 +1310,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1369,17 +1375,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1435,6 +1468,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1645,9 +1701,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1657,10 +1718,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1670,6 +1740,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1726,9 +1800,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1945,9 +2021,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1957,10 +2038,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1970,6 +2060,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2188,6 +2282,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2200,6 +2298,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/choroplethmapbox/_colorbar.py b/packages/python/plotly/plotly/graph_objs/choroplethmapbox/_colorbar.py index 5bc7e081fbb..89c0c63dc9c 100644 --- a/packages/python/plotly/plotly/graph_objs/choroplethmapbox/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/choroplethmapbox/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1648,9 +1704,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1660,10 +1721,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1673,6 +1743,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1729,9 +1803,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1949,9 +2025,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1961,10 +2042,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1974,6 +2064,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2192,6 +2286,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2204,6 +2302,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/cone/_colorbar.py b/packages/python/plotly/plotly/graph_objs/cone/_colorbar.py index 0961f42bf82..d6b15f40b93 100644 --- a/packages/python/plotly/plotly/graph_objs/cone/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/cone/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1309,12 +1311,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1370,17 +1376,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1436,6 +1469,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1646,9 +1702,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1658,10 +1719,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1671,6 +1741,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1727,9 +1801,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1945,9 +2021,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1957,10 +2038,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1970,6 +2060,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2188,6 +2282,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2200,6 +2298,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/contour/_colorbar.py b/packages/python/plotly/plotly/graph_objs/contour/_colorbar.py index b183820781c..33ba0671ad1 100644 --- a/packages/python/plotly/plotly/graph_objs/contour/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/contour/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1309,12 +1311,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1370,17 +1376,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1436,6 +1469,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1646,9 +1702,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1658,10 +1719,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1671,6 +1741,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1727,9 +1801,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1946,9 +2022,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1958,10 +2039,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1971,6 +2061,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2189,6 +2283,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2201,6 +2299,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/contourcarpet/_colorbar.py b/packages/python/plotly/plotly/graph_objs/contourcarpet/_colorbar.py index f43e4c6ec4d..5e617b7adfd 100644 --- a/packages/python/plotly/plotly/graph_objs/contourcarpet/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/contourcarpet/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1647,9 +1703,14 @@ def _prop_descriptions(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1659,10 +1720,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1672,6 +1742,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1728,9 +1802,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1947,9 +2023,14 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1959,10 +2040,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1972,6 +2062,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2190,6 +2284,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2202,6 +2300,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/densitymapbox/_colorbar.py b/packages/python/plotly/plotly/graph_objs/densitymapbox/_colorbar.py index bc1e14a6443..dd988990466 100644 --- a/packages/python/plotly/plotly/graph_objs/densitymapbox/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/densitymapbox/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1647,9 +1703,14 @@ def _prop_descriptions(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1659,10 +1720,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1672,6 +1742,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1728,9 +1802,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1947,9 +2023,14 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1959,10 +2040,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1972,6 +2062,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2190,6 +2284,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2202,6 +2300,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/funnel/_marker.py b/packages/python/plotly/plotly/graph_objs/funnel/_marker.py index 7874d678a4e..b4e3799f2a0 100644 --- a/packages/python/plotly/plotly/graph_objs/funnel/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/funnel/_marker.py @@ -483,9 +483,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -495,10 +501,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -508,6 +524,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/funnel/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/funnel/marker/_colorbar.py index 03b4fc48dc8..9ca40d997cf 100644 --- a/packages/python/plotly/plotly/graph_objs/funnel/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/funnel/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1647,9 +1703,14 @@ def _prop_descriptions(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1659,10 +1720,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1672,6 +1742,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1728,9 +1802,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1947,9 +2023,14 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1959,10 +2040,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1972,6 +2062,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2190,6 +2284,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2202,6 +2300,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/funnelarea/_marker.py b/packages/python/plotly/plotly/graph_objs/funnelarea/_marker.py index 10a0a96ee41..bcd9f7c595f 100644 --- a/packages/python/plotly/plotly/graph_objs/funnelarea/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/funnelarea/_marker.py @@ -8,7 +8,7 @@ class Marker(_BaseTraceHierarchyType): # -------------------- _parent_path_str = "funnelarea" _path_str = "funnelarea.marker" - _valid_props = {"colors", "colorssrc", "line"} + _valid_props = {"colors", "colorssrc", "line", "pattern"} # colors # ------ @@ -87,6 +87,80 @@ def line(self): def line(self, val): self["line"] = val + # pattern + # ------- + @property + def pattern(self): + """ + Sets the pattern within the marker. + + The 'pattern' property is an instance of Pattern + that may be specified as: + - An instance of :class:`plotly.graph_objs.funnelarea.marker.Pattern` + - A dict of string/value properties that will be passed + to the Pattern constructor + + Supported dict properties: + + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "overlay". Otherwise, defaults to a transparent + background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud + for `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud + for `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern + fill. Defaults to a 0.5 when `fillmode` is + "overlay". Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be + used as a default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, + no pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud + for `shape`. + size + Sets the size of unit squares of the pattern + fill in pixels, which corresponds to the + interval of repetition of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud + for `size`. + solidity + Sets the solidity of the pattern fill. Solidity + is roughly the fraction of the area filled by + the pattern. Solidity of 0 shows only the + background color without pattern and solidty of + 1 shows only the foreground color without + pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud + for `solidity`. + + Returns + ------- + plotly.graph_objs.funnelarea.marker.Pattern + """ + return self["pattern"] + + @pattern.setter + def pattern(self, val): + self["pattern"] = val + # Self properties description # --------------------------- @property @@ -102,9 +176,13 @@ def _prop_descriptions(self): line :class:`plotly.graph_objects.funnelarea.marker.Line` instance or dict with compatible properties + pattern + Sets the pattern within the marker. """ - def __init__(self, arg=None, colors=None, colorssrc=None, line=None, **kwargs): + def __init__( + self, arg=None, colors=None, colorssrc=None, line=None, pattern=None, **kwargs + ): """ Construct a new Marker object @@ -124,6 +202,8 @@ def __init__(self, arg=None, colors=None, colorssrc=None, line=None, **kwargs): line :class:`plotly.graph_objects.funnelarea.marker.Line` instance or dict with compatible properties + pattern + Sets the pattern within the marker. Returns ------- @@ -170,6 +250,10 @@ def __init__(self, arg=None, colors=None, colorssrc=None, line=None, **kwargs): _v = line if line is not None else _v if _v is not None: self["line"] = _v + _v = arg.pop("pattern", None) + _v = pattern if pattern is not None else _v + if _v is not None: + self["pattern"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/funnelarea/marker/__init__.py b/packages/python/plotly/plotly/graph_objs/funnelarea/marker/__init__.py index 8722c15a2b8..9f8ac2640cb 100644 --- a/packages/python/plotly/plotly/graph_objs/funnelarea/marker/__init__.py +++ b/packages/python/plotly/plotly/graph_objs/funnelarea/marker/__init__.py @@ -3,7 +3,10 @@ if sys.version_info < (3, 7) or TYPE_CHECKING: from ._line import Line + from ._pattern import Pattern else: from _plotly_utils.importers import relative_import - __all__, __getattr__, __dir__ = relative_import(__name__, [], ["._line.Line"]) + __all__, __getattr__, __dir__ = relative_import( + __name__, [], ["._line.Line", "._pattern.Pattern"] + ) diff --git a/packages/python/plotly/plotly/graph_objs/funnelarea/marker/_pattern.py b/packages/python/plotly/plotly/graph_objs/funnelarea/marker/_pattern.py new file mode 100644 index 00000000000..fc694d431ab --- /dev/null +++ b/packages/python/plotly/plotly/graph_objs/funnelarea/marker/_pattern.py @@ -0,0 +1,580 @@ +from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType +import copy as _copy + + +class Pattern(_BaseTraceHierarchyType): + + # class properties + # -------------------- + _parent_path_str = "funnelarea.marker" + _path_str = "funnelarea.marker.pattern" + _valid_props = { + "bgcolor", + "bgcolorsrc", + "fgcolor", + "fgcolorsrc", + "fgopacity", + "fillmode", + "shape", + "shapesrc", + "size", + "sizesrc", + "solidity", + "soliditysrc", + } + + # bgcolor + # ------- + @property + def bgcolor(self): + """ + When there is no colorscale sets the color of background + pattern fill. Defaults to a `marker.color` background when + `fillmode` is "overlay". Otherwise, defaults to a transparent + background. + + 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 + - A list or array of any of the above + + Returns + ------- + str|numpy.ndarray + """ + return self["bgcolor"] + + @bgcolor.setter + def bgcolor(self, val): + self["bgcolor"] = val + + # bgcolorsrc + # ---------- + @property + def bgcolorsrc(self): + """ + Sets the source reference on Chart Studio Cloud for `bgcolor`. + + The 'bgcolorsrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["bgcolorsrc"] + + @bgcolorsrc.setter + def bgcolorsrc(self, val): + self["bgcolorsrc"] = val + + # fgcolor + # ------- + @property + def fgcolor(self): + """ + When there is no colorscale sets the color of foreground + pattern fill. Defaults to a `marker.color` background when + `fillmode` is "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + + The 'fgcolor' 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 + - A list or array of any of the above + + Returns + ------- + str|numpy.ndarray + """ + return self["fgcolor"] + + @fgcolor.setter + def fgcolor(self, val): + self["fgcolor"] = val + + # fgcolorsrc + # ---------- + @property + def fgcolorsrc(self): + """ + Sets the source reference on Chart Studio Cloud for `fgcolor`. + + The 'fgcolorsrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["fgcolorsrc"] + + @fgcolorsrc.setter + def fgcolorsrc(self, val): + self["fgcolorsrc"] = val + + # fgopacity + # --------- + @property + def fgopacity(self): + """ + Sets the opacity of the foreground pattern fill. Defaults to a + 0.5 when `fillmode` is "overlay". Otherwise, defaults to 1. + + The 'fgopacity' property is a number and may be specified as: + - An int or float in the interval [0, 1] + + Returns + ------- + int|float + """ + return self["fgopacity"] + + @fgopacity.setter + def fgopacity(self, val): + self["fgopacity"] = val + + # fillmode + # -------- + @property + def fillmode(self): + """ + Determines whether `marker.color` should be used as a default + to `bgcolor` or a `fgcolor`. + + The 'fillmode' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['replace', 'overlay'] + + Returns + ------- + Any + """ + return self["fillmode"] + + @fillmode.setter + def fillmode(self, val): + self["fillmode"] = val + + # shape + # ----- + @property + def shape(self): + """ + Sets the shape of the pattern fill. By default, no pattern is + used for filling the area. + + The 'shape' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['', '/', '\\', 'x', '-', '|', '+', '.'] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + Any|numpy.ndarray + """ + return self["shape"] + + @shape.setter + def shape(self, val): + self["shape"] = val + + # shapesrc + # -------- + @property + def shapesrc(self): + """ + Sets the source reference on Chart Studio Cloud for `shape`. + + The 'shapesrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["shapesrc"] + + @shapesrc.setter + def shapesrc(self, val): + self["shapesrc"] = val + + # size + # ---- + @property + def size(self): + """ + Sets the size of unit squares of the pattern fill in pixels, + which corresponds to the interval of repetition of the pattern. + + The 'size' property is a number and may be specified as: + - An int or float in the interval [0, inf] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + int|float|numpy.ndarray + """ + return self["size"] + + @size.setter + def size(self, val): + self["size"] = val + + # sizesrc + # ------- + @property + def sizesrc(self): + """ + Sets the source reference on Chart Studio Cloud for `size`. + + The 'sizesrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["sizesrc"] + + @sizesrc.setter + def sizesrc(self, val): + self["sizesrc"] = val + + # solidity + # -------- + @property + def solidity(self): + """ + Sets the solidity of the pattern fill. Solidity is roughly the + fraction of the area filled by the pattern. Solidity of 0 shows + only the background color without pattern and solidty of 1 + shows only the foreground color without pattern. + + The 'solidity' property is a number and may be specified as: + - An int or float in the interval [0, 1] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + int|float|numpy.ndarray + """ + return self["solidity"] + + @solidity.setter + def solidity(self, val): + self["solidity"] = val + + # soliditysrc + # ----------- + @property + def soliditysrc(self): + """ + Sets the source reference on Chart Studio Cloud for `solidity`. + + The 'soliditysrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["soliditysrc"] + + @soliditysrc.setter + def soliditysrc(self, val): + self["soliditysrc"] = val + + # Self properties description + # --------------------------- + @property + def _prop_descriptions(self): + return """\ + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a `marker.color` + background when `fillmode` is "overlay". Otherwise, + defaults to a transparent background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud for + `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a `marker.color` + background when `fillmode` is "replace". Otherwise, + defaults to dark grey or white to increase contrast + with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud for + `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern fill. + Defaults to a 0.5 when `fillmode` is "overlay". + Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be used as a + default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, no + pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud for + `shape`. + size + Sets the size of unit squares of the pattern fill in + pixels, which corresponds to the interval of repetition + of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud for + `size`. + solidity + Sets the solidity of the pattern fill. Solidity is + roughly the fraction of the area filled by the pattern. + Solidity of 0 shows only the background color without + pattern and solidty of 1 shows only the foreground + color without pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud for + `solidity`. + """ + + def __init__( + self, + arg=None, + bgcolor=None, + bgcolorsrc=None, + fgcolor=None, + fgcolorsrc=None, + fgopacity=None, + fillmode=None, + shape=None, + shapesrc=None, + size=None, + sizesrc=None, + solidity=None, + soliditysrc=None, + **kwargs, + ): + """ + Construct a new Pattern object + + Sets the pattern within the marker. + + Parameters + ---------- + arg + dict of properties compatible with this constructor or + an instance of + :class:`plotly.graph_objs.funnelarea.marker.Pattern` + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a `marker.color` + background when `fillmode` is "overlay". Otherwise, + defaults to a transparent background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud for + `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a `marker.color` + background when `fillmode` is "replace". Otherwise, + defaults to dark grey or white to increase contrast + with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud for + `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern fill. + Defaults to a 0.5 when `fillmode` is "overlay". + Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be used as a + default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, no + pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud for + `shape`. + size + Sets the size of unit squares of the pattern fill in + pixels, which corresponds to the interval of repetition + of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud for + `size`. + solidity + Sets the solidity of the pattern fill. Solidity is + roughly the fraction of the area filled by the pattern. + Solidity of 0 shows only the background color without + pattern and solidty of 1 shows only the foreground + color without pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud for + `solidity`. + + Returns + ------- + Pattern + """ + super(Pattern, self).__init__("pattern") + + 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.funnelarea.marker.Pattern +constructor must be a dict or +an instance of :class:`plotly.graph_objs.funnelarea.marker.Pattern`""" + ) + + # 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("bgcolor", None) + _v = bgcolor if bgcolor is not None else _v + if _v is not None: + self["bgcolor"] = _v + _v = arg.pop("bgcolorsrc", None) + _v = bgcolorsrc if bgcolorsrc is not None else _v + if _v is not None: + self["bgcolorsrc"] = _v + _v = arg.pop("fgcolor", None) + _v = fgcolor if fgcolor is not None else _v + if _v is not None: + self["fgcolor"] = _v + _v = arg.pop("fgcolorsrc", None) + _v = fgcolorsrc if fgcolorsrc is not None else _v + if _v is not None: + self["fgcolorsrc"] = _v + _v = arg.pop("fgopacity", None) + _v = fgopacity if fgopacity is not None else _v + if _v is not None: + self["fgopacity"] = _v + _v = arg.pop("fillmode", None) + _v = fillmode if fillmode is not None else _v + if _v is not None: + self["fillmode"] = _v + _v = arg.pop("shape", None) + _v = shape if shape is not None else _v + if _v is not None: + self["shape"] = _v + _v = arg.pop("shapesrc", None) + _v = shapesrc if shapesrc is not None else _v + if _v is not None: + self["shapesrc"] = _v + _v = arg.pop("size", None) + _v = size if size is not None else _v + if _v is not None: + self["size"] = _v + _v = arg.pop("sizesrc", None) + _v = sizesrc if sizesrc is not None else _v + if _v is not None: + self["sizesrc"] = _v + _v = arg.pop("solidity", None) + _v = solidity if solidity is not None else _v + if _v is not None: + self["solidity"] = _v + _v = arg.pop("soliditysrc", None) + _v = soliditysrc if soliditysrc is not None else _v + if _v is not None: + self["soliditysrc"] = _v + + # Process unknown kwargs + # ---------------------- + self._process_kwargs(**dict(arg, **kwargs)) + + # Reset skip_invalid + # ------------------ + self._skip_invalid = False diff --git a/packages/python/plotly/plotly/graph_objs/heatmap/_colorbar.py b/packages/python/plotly/plotly/graph_objs/heatmap/_colorbar.py index e8cb2ee5625..9bbca94cc47 100644 --- a/packages/python/plotly/plotly/graph_objs/heatmap/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/heatmap/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1309,12 +1311,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1370,17 +1376,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1436,6 +1469,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1646,9 +1702,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1658,10 +1719,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1671,6 +1741,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1727,9 +1801,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1946,9 +2022,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1958,10 +2039,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1971,6 +2061,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2189,6 +2283,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2201,6 +2299,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/heatmapgl/_colorbar.py b/packages/python/plotly/plotly/graph_objs/heatmapgl/_colorbar.py index 56615137322..8ac6e7aa7b0 100644 --- a/packages/python/plotly/plotly/graph_objs/heatmapgl/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/heatmapgl/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1308,12 +1310,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1369,17 +1375,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1435,6 +1468,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1645,9 +1701,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1657,10 +1718,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1670,6 +1740,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1726,9 +1800,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1945,9 +2021,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1957,10 +2038,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1970,6 +2060,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2188,6 +2282,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2200,6 +2298,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/histogram/_marker.py b/packages/python/plotly/plotly/graph_objs/histogram/_marker.py index 29fc05c2509..6e06fefce49 100644 --- a/packages/python/plotly/plotly/graph_objs/histogram/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/histogram/_marker.py @@ -484,9 +484,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -496,10 +502,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -509,6 +525,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/histogram/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/histogram/marker/_colorbar.py index de0bf149cc0..415a01fae0d 100644 --- a/packages/python/plotly/plotly/graph_objs/histogram/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/histogram/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1648,9 +1704,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1660,10 +1721,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1673,6 +1743,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1729,9 +1803,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1949,9 +2025,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1961,10 +2042,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1974,6 +2064,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2192,6 +2286,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2204,6 +2302,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/histogram2d/_colorbar.py b/packages/python/plotly/plotly/graph_objs/histogram2d/_colorbar.py index 98150cbb1bd..020896f4197 100644 --- a/packages/python/plotly/plotly/graph_objs/histogram2d/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/histogram2d/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1309,12 +1311,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1370,17 +1376,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1436,6 +1469,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1646,9 +1702,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1658,10 +1719,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1671,6 +1741,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1727,9 +1801,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1946,9 +2022,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1958,10 +2039,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1971,6 +2061,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2189,6 +2283,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2201,6 +2299,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/histogram2dcontour/_colorbar.py b/packages/python/plotly/plotly/graph_objs/histogram2dcontour/_colorbar.py index 50f66d606c7..50d4003299c 100644 --- a/packages/python/plotly/plotly/graph_objs/histogram2dcontour/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/histogram2dcontour/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1649,9 +1705,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1661,10 +1722,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1674,6 +1744,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1730,9 +1804,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1951,9 +2027,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1963,10 +2044,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1976,6 +2066,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2194,6 +2288,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2206,6 +2304,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/icicle/_marker.py b/packages/python/plotly/plotly/graph_objs/icicle/_marker.py index 3b3cd6169ba..95772e2d9af 100644 --- a/packages/python/plotly/plotly/graph_objs/icicle/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/icicle/_marker.py @@ -20,6 +20,7 @@ class Marker(_BaseTraceHierarchyType): "colorscale", "colorssrc", "line", + "pattern", "reversescale", "showscale", } @@ -413,9 +414,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -425,10 +432,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -438,6 +455,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -580,6 +601,80 @@ def line(self): def line(self, val): self["line"] = val + # pattern + # ------- + @property + def pattern(self): + """ + Sets the pattern within the marker. + + The 'pattern' property is an instance of Pattern + that may be specified as: + - An instance of :class:`plotly.graph_objs.icicle.marker.Pattern` + - A dict of string/value properties that will be passed + to the Pattern constructor + + Supported dict properties: + + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "overlay". Otherwise, defaults to a transparent + background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud + for `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud + for `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern + fill. Defaults to a 0.5 when `fillmode` is + "overlay". Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be + used as a default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, + no pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud + for `shape`. + size + Sets the size of unit squares of the pattern + fill in pixels, which corresponds to the + interval of repetition of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud + for `size`. + solidity + Sets the solidity of the pattern fill. Solidity + is roughly the fraction of the area filled by + the pattern. Solidity of 0 shows only the + background color without pattern and solidty of + 1 shows only the foreground color without + pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud + for `solidity`. + + Returns + ------- + plotly.graph_objs.icicle.marker.Pattern + """ + return self["pattern"] + + @pattern.setter + def pattern(self, val): + self["pattern"] = val + # reversescale # ------------ @property @@ -696,6 +791,8 @@ def _prop_descriptions(self): line :class:`plotly.graph_objects.icicle.marker.Line` instance or dict with compatible properties + pattern + Sets the pattern within the marker. reversescale Reverses the color mapping if true. Has an effect only if colors is set to a numerical array. If true, @@ -722,6 +819,7 @@ def __init__( colorscale=None, colorssrc=None, line=None, + pattern=None, reversescale=None, showscale=None, **kwargs, @@ -800,6 +898,8 @@ def __init__( line :class:`plotly.graph_objects.icicle.marker.Line` instance or dict with compatible properties + pattern + Sets the pattern within the marker. reversescale Reverses the color mapping if true. Has an effect only if colors is set to a numerical array. If true, @@ -888,6 +988,10 @@ def __init__( _v = line if line is not None else _v if _v is not None: self["line"] = _v + _v = arg.pop("pattern", None) + _v = pattern if pattern is not None else _v + if _v is not None: + self["pattern"] = _v _v = arg.pop("reversescale", None) _v = reversescale if reversescale is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/icicle/marker/__init__.py b/packages/python/plotly/plotly/graph_objs/icicle/marker/__init__.py index 8481520e3c9..ce0279c5444 100644 --- a/packages/python/plotly/plotly/graph_objs/icicle/marker/__init__.py +++ b/packages/python/plotly/plotly/graph_objs/icicle/marker/__init__.py @@ -4,10 +4,13 @@ if sys.version_info < (3, 7) or TYPE_CHECKING: from ._colorbar import ColorBar from ._line import Line + from ._pattern import Pattern from . import colorbar else: from _plotly_utils.importers import relative_import __all__, __getattr__, __dir__ = relative_import( - __name__, [".colorbar"], ["._colorbar.ColorBar", "._line.Line"] + __name__, + [".colorbar"], + ["._colorbar.ColorBar", "._line.Line", "._pattern.Pattern"], ) diff --git a/packages/python/plotly/plotly/graph_objs/icicle/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/icicle/marker/_colorbar.py index d37fc0f971d..127dedc344d 100644 --- a/packages/python/plotly/plotly/graph_objs/icicle/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/icicle/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1647,9 +1703,14 @@ def _prop_descriptions(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1659,10 +1720,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1672,6 +1742,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1728,9 +1802,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1947,9 +2023,14 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1959,10 +2040,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1972,6 +2062,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2190,6 +2284,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2202,6 +2300,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/icicle/marker/_pattern.py b/packages/python/plotly/plotly/graph_objs/icicle/marker/_pattern.py new file mode 100644 index 00000000000..c98945bff6f --- /dev/null +++ b/packages/python/plotly/plotly/graph_objs/icicle/marker/_pattern.py @@ -0,0 +1,580 @@ +from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType +import copy as _copy + + +class Pattern(_BaseTraceHierarchyType): + + # class properties + # -------------------- + _parent_path_str = "icicle.marker" + _path_str = "icicle.marker.pattern" + _valid_props = { + "bgcolor", + "bgcolorsrc", + "fgcolor", + "fgcolorsrc", + "fgopacity", + "fillmode", + "shape", + "shapesrc", + "size", + "sizesrc", + "solidity", + "soliditysrc", + } + + # bgcolor + # ------- + @property + def bgcolor(self): + """ + When there is no colorscale sets the color of background + pattern fill. Defaults to a `marker.color` background when + `fillmode` is "overlay". Otherwise, defaults to a transparent + background. + + 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 + - A list or array of any of the above + + Returns + ------- + str|numpy.ndarray + """ + return self["bgcolor"] + + @bgcolor.setter + def bgcolor(self, val): + self["bgcolor"] = val + + # bgcolorsrc + # ---------- + @property + def bgcolorsrc(self): + """ + Sets the source reference on Chart Studio Cloud for `bgcolor`. + + The 'bgcolorsrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["bgcolorsrc"] + + @bgcolorsrc.setter + def bgcolorsrc(self, val): + self["bgcolorsrc"] = val + + # fgcolor + # ------- + @property + def fgcolor(self): + """ + When there is no colorscale sets the color of foreground + pattern fill. Defaults to a `marker.color` background when + `fillmode` is "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + + The 'fgcolor' 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 + - A list or array of any of the above + + Returns + ------- + str|numpy.ndarray + """ + return self["fgcolor"] + + @fgcolor.setter + def fgcolor(self, val): + self["fgcolor"] = val + + # fgcolorsrc + # ---------- + @property + def fgcolorsrc(self): + """ + Sets the source reference on Chart Studio Cloud for `fgcolor`. + + The 'fgcolorsrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["fgcolorsrc"] + + @fgcolorsrc.setter + def fgcolorsrc(self, val): + self["fgcolorsrc"] = val + + # fgopacity + # --------- + @property + def fgopacity(self): + """ + Sets the opacity of the foreground pattern fill. Defaults to a + 0.5 when `fillmode` is "overlay". Otherwise, defaults to 1. + + The 'fgopacity' property is a number and may be specified as: + - An int or float in the interval [0, 1] + + Returns + ------- + int|float + """ + return self["fgopacity"] + + @fgopacity.setter + def fgopacity(self, val): + self["fgopacity"] = val + + # fillmode + # -------- + @property + def fillmode(self): + """ + Determines whether `marker.color` should be used as a default + to `bgcolor` or a `fgcolor`. + + The 'fillmode' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['replace', 'overlay'] + + Returns + ------- + Any + """ + return self["fillmode"] + + @fillmode.setter + def fillmode(self, val): + self["fillmode"] = val + + # shape + # ----- + @property + def shape(self): + """ + Sets the shape of the pattern fill. By default, no pattern is + used for filling the area. + + The 'shape' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['', '/', '\\', 'x', '-', '|', '+', '.'] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + Any|numpy.ndarray + """ + return self["shape"] + + @shape.setter + def shape(self, val): + self["shape"] = val + + # shapesrc + # -------- + @property + def shapesrc(self): + """ + Sets the source reference on Chart Studio Cloud for `shape`. + + The 'shapesrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["shapesrc"] + + @shapesrc.setter + def shapesrc(self, val): + self["shapesrc"] = val + + # size + # ---- + @property + def size(self): + """ + Sets the size of unit squares of the pattern fill in pixels, + which corresponds to the interval of repetition of the pattern. + + The 'size' property is a number and may be specified as: + - An int or float in the interval [0, inf] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + int|float|numpy.ndarray + """ + return self["size"] + + @size.setter + def size(self, val): + self["size"] = val + + # sizesrc + # ------- + @property + def sizesrc(self): + """ + Sets the source reference on Chart Studio Cloud for `size`. + + The 'sizesrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["sizesrc"] + + @sizesrc.setter + def sizesrc(self, val): + self["sizesrc"] = val + + # solidity + # -------- + @property + def solidity(self): + """ + Sets the solidity of the pattern fill. Solidity is roughly the + fraction of the area filled by the pattern. Solidity of 0 shows + only the background color without pattern and solidty of 1 + shows only the foreground color without pattern. + + The 'solidity' property is a number and may be specified as: + - An int or float in the interval [0, 1] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + int|float|numpy.ndarray + """ + return self["solidity"] + + @solidity.setter + def solidity(self, val): + self["solidity"] = val + + # soliditysrc + # ----------- + @property + def soliditysrc(self): + """ + Sets the source reference on Chart Studio Cloud for `solidity`. + + The 'soliditysrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["soliditysrc"] + + @soliditysrc.setter + def soliditysrc(self, val): + self["soliditysrc"] = val + + # Self properties description + # --------------------------- + @property + def _prop_descriptions(self): + return """\ + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a `marker.color` + background when `fillmode` is "overlay". Otherwise, + defaults to a transparent background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud for + `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a `marker.color` + background when `fillmode` is "replace". Otherwise, + defaults to dark grey or white to increase contrast + with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud for + `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern fill. + Defaults to a 0.5 when `fillmode` is "overlay". + Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be used as a + default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, no + pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud for + `shape`. + size + Sets the size of unit squares of the pattern fill in + pixels, which corresponds to the interval of repetition + of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud for + `size`. + solidity + Sets the solidity of the pattern fill. Solidity is + roughly the fraction of the area filled by the pattern. + Solidity of 0 shows only the background color without + pattern and solidty of 1 shows only the foreground + color without pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud for + `solidity`. + """ + + def __init__( + self, + arg=None, + bgcolor=None, + bgcolorsrc=None, + fgcolor=None, + fgcolorsrc=None, + fgopacity=None, + fillmode=None, + shape=None, + shapesrc=None, + size=None, + sizesrc=None, + solidity=None, + soliditysrc=None, + **kwargs, + ): + """ + Construct a new Pattern object + + Sets the pattern within the marker. + + Parameters + ---------- + arg + dict of properties compatible with this constructor or + an instance of + :class:`plotly.graph_objs.icicle.marker.Pattern` + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a `marker.color` + background when `fillmode` is "overlay". Otherwise, + defaults to a transparent background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud for + `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a `marker.color` + background when `fillmode` is "replace". Otherwise, + defaults to dark grey or white to increase contrast + with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud for + `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern fill. + Defaults to a 0.5 when `fillmode` is "overlay". + Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be used as a + default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, no + pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud for + `shape`. + size + Sets the size of unit squares of the pattern fill in + pixels, which corresponds to the interval of repetition + of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud for + `size`. + solidity + Sets the solidity of the pattern fill. Solidity is + roughly the fraction of the area filled by the pattern. + Solidity of 0 shows only the background color without + pattern and solidty of 1 shows only the foreground + color without pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud for + `solidity`. + + Returns + ------- + Pattern + """ + super(Pattern, self).__init__("pattern") + + 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.icicle.marker.Pattern +constructor must be a dict or +an instance of :class:`plotly.graph_objs.icicle.marker.Pattern`""" + ) + + # 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("bgcolor", None) + _v = bgcolor if bgcolor is not None else _v + if _v is not None: + self["bgcolor"] = _v + _v = arg.pop("bgcolorsrc", None) + _v = bgcolorsrc if bgcolorsrc is not None else _v + if _v is not None: + self["bgcolorsrc"] = _v + _v = arg.pop("fgcolor", None) + _v = fgcolor if fgcolor is not None else _v + if _v is not None: + self["fgcolor"] = _v + _v = arg.pop("fgcolorsrc", None) + _v = fgcolorsrc if fgcolorsrc is not None else _v + if _v is not None: + self["fgcolorsrc"] = _v + _v = arg.pop("fgopacity", None) + _v = fgopacity if fgopacity is not None else _v + if _v is not None: + self["fgopacity"] = _v + _v = arg.pop("fillmode", None) + _v = fillmode if fillmode is not None else _v + if _v is not None: + self["fillmode"] = _v + _v = arg.pop("shape", None) + _v = shape if shape is not None else _v + if _v is not None: + self["shape"] = _v + _v = arg.pop("shapesrc", None) + _v = shapesrc if shapesrc is not None else _v + if _v is not None: + self["shapesrc"] = _v + _v = arg.pop("size", None) + _v = size if size is not None else _v + if _v is not None: + self["size"] = _v + _v = arg.pop("sizesrc", None) + _v = sizesrc if sizesrc is not None else _v + if _v is not None: + self["sizesrc"] = _v + _v = arg.pop("solidity", None) + _v = solidity if solidity is not None else _v + if _v is not None: + self["solidity"] = _v + _v = arg.pop("soliditysrc", None) + _v = soliditysrc if soliditysrc is not None else _v + if _v is not None: + self["soliditysrc"] = _v + + # Process unknown kwargs + # ---------------------- + self._process_kwargs(**dict(arg, **kwargs)) + + # Reset skip_invalid + # ------------------ + self._skip_invalid = False diff --git a/packages/python/plotly/plotly/graph_objs/isosurface/_colorbar.py b/packages/python/plotly/plotly/graph_objs/isosurface/_colorbar.py index 63ce7ada867..40757842930 100644 --- a/packages/python/plotly/plotly/graph_objs/isosurface/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/isosurface/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1308,12 +1310,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1369,17 +1375,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1435,6 +1468,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1645,9 +1701,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1657,10 +1718,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1670,6 +1740,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1726,9 +1800,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1945,9 +2021,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1957,10 +2038,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1970,6 +2060,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2188,6 +2282,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2200,6 +2298,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/layout/_coloraxis.py b/packages/python/plotly/plotly/graph_objs/layout/_coloraxis.py index f4a8ff387a2..00aba5f5a84 100644 --- a/packages/python/plotly/plotly/graph_objs/layout/_coloraxis.py +++ b/packages/python/plotly/plotly/graph_objs/layout/_coloraxis.py @@ -379,9 +379,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -391,10 +397,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -404,6 +420,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/layout/_legend.py b/packages/python/plotly/plotly/graph_objs/layout/_legend.py index 17fe613c8fc..7bc0b42690c 100644 --- a/packages/python/plotly/plotly/graph_objs/layout/_legend.py +++ b/packages/python/plotly/plotly/graph_objs/layout/_legend.py @@ -27,10 +27,13 @@ class Legend(_BaseLayoutHierarchyType): "traceorder", "uirevision", "valign", + "visible", "x", "xanchor", + "xref", "y", "yanchor", + "yref", } # bgcolor @@ -576,17 +579,41 @@ def valign(self): def valign(self, val): self["valign"] = val + # visible + # ------- + @property + def visible(self): + """ + Determines whether or not this legend is visible. + + The 'visible' property must be specified as a bool + (either True, or False) + + Returns + ------- + bool + """ + return self["visible"] + + @visible.setter + def visible(self, val): + self["visible"] = val + # x # - @property def x(self): """ - Sets the x position (in normalized coordinates) of the legend. - Defaults to 1.02 for vertical legends and defaults to 0 for - horizontal legends. + Sets the x position with respect to `xref` (in normalized + coordinates) of the legend. When `xref` is "paper", defaults to + 1.02 for vertical legends and defaults to 0 for horizontal + legends. When `xref` is "container", defaults to 1 for vertical + legends and defaults to 0 for horizontal legends. Must be + between 0 and 1 if `xref` is "container". and between "-2" and + 3 if `xref` is "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -624,19 +651,45 @@ def xanchor(self): def xanchor(self, val): self["xanchor"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position (in normalized coordinates) of the legend. - Defaults to 1 for vertical legends, defaults to "-0.1" for - horizontal legends on graphs w/o range sliders and defaults to - 1.1 for horizontal legends on graph with one or multiple range - sliders. + Sets the y position with respect to `yref` (in normalized + coordinates) of the legend. When `yref` is "paper", defaults to + 1 for vertical legends, defaults to "-0.1" for horizontal + legends on graphs w/o range sliders and defaults to 1.1 for + horizontal legends on graph with one or multiple range sliders. + When `yref` is "container", defaults to 1. Must be between 0 + and 1 if `yref` is "container" and between "-2" and 3 if `yref` + is "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -674,6 +727,29 @@ def yanchor(self): def yanchor(self, val): self["yanchor"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -747,10 +823,17 @@ def _prop_descriptions(self): valign Sets the vertical alignment of the symbols with respect to their associated text. + visible + Determines whether or not this legend is visible. x - Sets the x position (in normalized coordinates) of the - legend. Defaults to 1.02 for vertical legends and - defaults to 0 for horizontal legends. + Sets the x position with respect to `xref` (in + normalized coordinates) of the legend. When `xref` is + "paper", defaults to 1.02 for vertical legends and + defaults to 0 for horizontal legends. When `xref` is + "container", defaults to 1 for vertical legends and + defaults to 0 for horizontal legends. Must be between 0 + and 1 if `xref` is "container". and between "-2" and 3 + if `xref` is "paper". xanchor Sets the legend's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -759,12 +842,20 @@ def _prop_descriptions(self): 2/3, anchors legends to the left for `x` values less than or equal to 1/3 and anchors legends with respect to their center otherwise. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position (in normalized coordinates) of the - legend. Defaults to 1 for vertical legends, defaults to - "-0.1" for horizontal legends on graphs w/o range + Sets the y position with respect to `yref` (in + normalized coordinates) of the legend. When `yref` is + "paper", defaults to 1 for vertical legends, defaults + to "-0.1" for horizontal legends on graphs w/o range sliders and defaults to 1.1 for horizontal legends on - graph with one or multiple range sliders. + graph with one or multiple range sliders. When `yref` + is "container", defaults to 1. Must be between 0 and 1 + if `yref` is "container" and between "-2" and 3 if + `yref` is "paper". yanchor Sets the legend's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -773,6 +864,10 @@ def _prop_descriptions(self): anchors legends to at their top for `y` values greater than or equal to 2/3 and anchors legends with respect to their middle otherwise. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ def __init__( @@ -796,10 +891,13 @@ def __init__( traceorder=None, uirevision=None, valign=None, + visible=None, x=None, xanchor=None, + xref=None, y=None, yanchor=None, + yref=None, **kwargs, ): """ @@ -878,10 +976,17 @@ def __init__( valign Sets the vertical alignment of the symbols with respect to their associated text. + visible + Determines whether or not this legend is visible. x - Sets the x position (in normalized coordinates) of the - legend. Defaults to 1.02 for vertical legends and - defaults to 0 for horizontal legends. + Sets the x position with respect to `xref` (in + normalized coordinates) of the legend. When `xref` is + "paper", defaults to 1.02 for vertical legends and + defaults to 0 for horizontal legends. When `xref` is + "container", defaults to 1 for vertical legends and + defaults to 0 for horizontal legends. Must be between 0 + and 1 if `xref` is "container". and between "-2" and 3 + if `xref` is "paper". xanchor Sets the legend's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -890,12 +995,20 @@ def __init__( 2/3, anchors legends to the left for `x` values less than or equal to 1/3 and anchors legends with respect to their center otherwise. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position (in normalized coordinates) of the - legend. Defaults to 1 for vertical legends, defaults to - "-0.1" for horizontal legends on graphs w/o range + Sets the y position with respect to `yref` (in + normalized coordinates) of the legend. When `yref` is + "paper", defaults to 1 for vertical legends, defaults + to "-0.1" for horizontal legends on graphs w/o range sliders and defaults to 1.1 for horizontal legends on - graph with one or multiple range sliders. + graph with one or multiple range sliders. When `yref` + is "container", defaults to 1. Must be between 0 and 1 + if `yref` is "container" and between "-2" and 3 if + `yref` is "paper". yanchor Sets the legend's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -904,6 +1017,10 @@ def __init__( anchors legends to at their top for `y` values greater than or equal to 2/3 and anchors legends with respect to their middle otherwise. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -1010,6 +1127,10 @@ def __init__( _v = valign if valign is not None else _v if _v is not None: self["valign"] = _v + _v = arg.pop("visible", None) + _v = visible if visible is not None else _v + if _v is not None: + self["visible"] = _v _v = arg.pop("x", None) _v = x if x is not None else _v if _v is not None: @@ -1018,6 +1139,10 @@ def __init__( _v = xanchor if xanchor is not None else _v if _v is not None: self["xanchor"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -1026,6 +1151,10 @@ def __init__( _v = yanchor if yanchor is not None else _v if _v is not None: self["yanchor"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/layout/_newshape.py b/packages/python/plotly/plotly/graph_objs/layout/_newshape.py index 7c477022348..460812388c1 100644 --- a/packages/python/plotly/plotly/graph_objs/layout/_newshape.py +++ b/packages/python/plotly/plotly/graph_objs/layout/_newshape.py @@ -164,6 +164,33 @@ def label(self): are "start", "middle", and "end". Default: *middle center* for rectangles, circles, and paths; "middle" for lines. + texttemplate + Template string used for rendering the new + shape's label. Note that this will override + `text`. Variables are inserted using + %{variable}, for example "x0: %{x0}". Numbers + are formatted using d3-format's syntax + %{variable:d3-format}, for example "Price: + %{x0:$.2f}". See https://github.com/d3/d3- + format/tree/v1.4.5#d3-format for details on the + formatting syntax. Dates are formatted using + d3-time-format's syntax %{variable|d3-time- + format}, for example "Day: %{x0|%m %b %Y}". See + https://github.com/d3/d3-time- + format/tree/v2.2.3#locale_format for details on + the date formatting syntax. A single + multiplication or division operation may be + applied to numeric variables, and combined with + d3 number formatting, for example "Length in + cm: %{x0*2.54}", "%{slope*60:.1f} meters per + second." For log axes, variable values are + given in log units. For date axes, x/y + coordinate variables and center variables use + datetimes, while all other variable values use + values in ms. Finally, the template string has + access to variables `x0`, `x1`, `y0`, `y1`, + `slope`, `dx`, `dy`, `width`, `height`, + `length`, `xcenter` and `ycenter`. xanchor Sets the label's horizontal position anchor This anchor binds the specified `textposition` diff --git a/packages/python/plotly/plotly/graph_objs/layout/_shape.py b/packages/python/plotly/plotly/graph_objs/layout/_shape.py index a1b63c1c60a..e936000a8f2 100644 --- a/packages/python/plotly/plotly/graph_objs/layout/_shape.py +++ b/packages/python/plotly/plotly/graph_objs/layout/_shape.py @@ -174,6 +174,33 @@ def label(self): are "start", "middle", and "end". Default: *middle center* for rectangles, circles, and paths; "middle" for lines. + texttemplate + Template string used for rendering the shape's + label. Note that this will override `text`. + Variables are inserted using %{variable}, for + example "x0: %{x0}". Numbers are formatted + using d3-format's syntax %{variable:d3-format}, + for example "Price: %{x0:$.2f}". See https://gi + thub.com/d3/d3-format/tree/v1.4.5#d3-format for + details on the formatting syntax. Dates are + formatted using d3-time-format's syntax + %{variable|d3-time-format}, for example "Day: + %{x0|%m %b %Y}". See + https://github.com/d3/d3-time- + format/tree/v2.2.3#locale_format for details on + the date formatting syntax. A single + multiplication or division operation may be + applied to numeric variables, and combined with + d3 number formatting, for example "Length in + cm: %{x0*2.54}", "%{slope*60:.1f} meters per + second." For log axes, variable values are + given in log units. For date axes, x/y + coordinate variables and center variables use + datetimes, while all other variable values use + values in ms. Finally, the template string has + access to variables `x0`, `x1`, `y0`, `y1`, + `slope`, `dx`, `dy`, `width`, `height`, + `length`, `xcenter` and `ycenter`. xanchor Sets the label's horizontal position anchor This anchor binds the specified `textposition` diff --git a/packages/python/plotly/plotly/graph_objs/layout/coloraxis/_colorbar.py b/packages/python/plotly/plotly/graph_objs/layout/coloraxis/_colorbar.py index 23f780c87b9..60cd139e688 100644 --- a/packages/python/plotly/plotly/graph_objs/layout/coloraxis/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/layout/coloraxis/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseLayoutHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1648,9 +1704,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1660,10 +1721,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1673,6 +1743,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1729,9 +1803,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1949,9 +2025,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1961,10 +2042,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1974,6 +2064,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2192,6 +2286,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2204,6 +2302,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/layout/newshape/_label.py b/packages/python/plotly/plotly/graph_objs/layout/newshape/_label.py index b570d6fe6f0..d32de271290 100644 --- a/packages/python/plotly/plotly/graph_objs/layout/newshape/_label.py +++ b/packages/python/plotly/plotly/graph_objs/layout/newshape/_label.py @@ -14,6 +14,7 @@ class Label(_BaseLayoutHierarchyType): "text", "textangle", "textposition", + "texttemplate", "xanchor", "yanchor", } @@ -159,6 +160,46 @@ def textposition(self): def textposition(self, val): self["textposition"] = val + # texttemplate + # ------------ + @property + def texttemplate(self): + """ + Template string used for rendering the new shape's label. Note + that this will override `text`. Variables are inserted using + %{variable}, for example "x0: %{x0}". Numbers are formatted + using d3-format's syntax %{variable:d3-format}, for example + "Price: %{x0:$.2f}". See + https://github.com/d3/d3-format/tree/v1.4.5#d3-format for + details on the formatting syntax. Dates are formatted using + d3-time-format's syntax %{variable|d3-time-format}, for example + "Day: %{x0|%m %b %Y}". See https://github.com/d3/d3-time- + format/tree/v2.2.3#locale_format for details on the date + formatting syntax. A single multiplication or division + operation may be applied to numeric variables, and combined + with d3 number formatting, for example "Length in cm: + %{x0*2.54}", "%{slope*60:.1f} meters per second." For log axes, + variable values are given in log units. For date axes, x/y + coordinate variables and center variables use datetimes, while + all other variable values use values in ms. Finally, the + template string has access to variables `x0`, `x1`, `y0`, `y1`, + `slope`, `dx`, `dy`, `width`, `height`, `length`, `xcenter` and + `ycenter`. + + The 'texttemplate' property is a string and must be specified as: + - A string + - A number that will be converted to a string + + Returns + ------- + str + """ + return self["texttemplate"] + + @texttemplate.setter + def texttemplate(self, val): + self["texttemplate"] = val + # xanchor # ------- @property @@ -236,6 +277,30 @@ def _prop_descriptions(self): values for lines are "start", "middle", and "end". Default: *middle center* for rectangles, circles, and paths; "middle" for lines. + texttemplate + Template string used for rendering the new shape's + label. Note that this will override `text`. Variables + are inserted using %{variable}, for example "x0: + %{x0}". Numbers are formatted using d3-format's syntax + %{variable:d3-format}, for example "Price: %{x0:$.2f}". + See + https://github.com/d3/d3-format/tree/v1.4.5#d3-format + for details on the formatting syntax. Dates are + formatted using d3-time-format's syntax + %{variable|d3-time-format}, for example "Day: %{x0|%m + %b %Y}". See https://github.com/d3/d3-time- + format/tree/v2.2.3#locale_format for details on the + date formatting syntax. A single multiplication or + division operation may be applied to numeric variables, + and combined with d3 number formatting, for example + "Length in cm: %{x0*2.54}", "%{slope*60:.1f} meters per + second." For log axes, variable values are given in log + units. For date axes, x/y coordinate variables and + center variables use datetimes, while all other + variable values use values in ms. Finally, the template + string has access to variables `x0`, `x1`, `y0`, `y1`, + `slope`, `dx`, `dy`, `width`, `height`, `length`, + `xcenter` and `ycenter`. xanchor Sets the label's horizontal position anchor This anchor binds the specified `textposition` to the "left", @@ -260,6 +325,7 @@ def __init__( text=None, textangle=None, textposition=None, + texttemplate=None, xanchor=None, yanchor=None, **kwargs, @@ -294,6 +360,30 @@ def __init__( values for lines are "start", "middle", and "end". Default: *middle center* for rectangles, circles, and paths; "middle" for lines. + texttemplate + Template string used for rendering the new shape's + label. Note that this will override `text`. Variables + are inserted using %{variable}, for example "x0: + %{x0}". Numbers are formatted using d3-format's syntax + %{variable:d3-format}, for example "Price: %{x0:$.2f}". + See + https://github.com/d3/d3-format/tree/v1.4.5#d3-format + for details on the formatting syntax. Dates are + formatted using d3-time-format's syntax + %{variable|d3-time-format}, for example "Day: %{x0|%m + %b %Y}". See https://github.com/d3/d3-time- + format/tree/v2.2.3#locale_format for details on the + date formatting syntax. A single multiplication or + division operation may be applied to numeric variables, + and combined with d3 number formatting, for example + "Length in cm: %{x0*2.54}", "%{slope*60:.1f} meters per + second." For log axes, variable values are given in log + units. For date axes, x/y coordinate variables and + center variables use datetimes, while all other + variable values use values in ms. Finally, the template + string has access to variables `x0`, `x1`, `y0`, `y1`, + `slope`, `dx`, `dy`, `width`, `height`, `length`, + `xcenter` and `ycenter`. xanchor Sets the label's horizontal position anchor This anchor binds the specified `textposition` to the "left", @@ -362,6 +452,10 @@ def __init__( _v = textposition if textposition is not None else _v if _v is not None: self["textposition"] = _v + _v = arg.pop("texttemplate", None) + _v = texttemplate if texttemplate is not None else _v + if _v is not None: + self["texttemplate"] = _v _v = arg.pop("xanchor", None) _v = xanchor if xanchor is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/layout/shape/_label.py b/packages/python/plotly/plotly/graph_objs/layout/shape/_label.py index 455c809f162..d8d85ba15c0 100644 --- a/packages/python/plotly/plotly/graph_objs/layout/shape/_label.py +++ b/packages/python/plotly/plotly/graph_objs/layout/shape/_label.py @@ -14,6 +14,7 @@ class Label(_BaseLayoutHierarchyType): "text", "textangle", "textposition", + "texttemplate", "xanchor", "yanchor", } @@ -158,6 +159,46 @@ def textposition(self): def textposition(self, val): self["textposition"] = val + # texttemplate + # ------------ + @property + def texttemplate(self): + """ + Template string used for rendering the shape's label. Note that + this will override `text`. Variables are inserted using + %{variable}, for example "x0: %{x0}". Numbers are formatted + using d3-format's syntax %{variable:d3-format}, for example + "Price: %{x0:$.2f}". See + https://github.com/d3/d3-format/tree/v1.4.5#d3-format for + details on the formatting syntax. Dates are formatted using + d3-time-format's syntax %{variable|d3-time-format}, for example + "Day: %{x0|%m %b %Y}". See https://github.com/d3/d3-time- + format/tree/v2.2.3#locale_format for details on the date + formatting syntax. A single multiplication or division + operation may be applied to numeric variables, and combined + with d3 number formatting, for example "Length in cm: + %{x0*2.54}", "%{slope*60:.1f} meters per second." For log axes, + variable values are given in log units. For date axes, x/y + coordinate variables and center variables use datetimes, while + all other variable values use values in ms. Finally, the + template string has access to variables `x0`, `x1`, `y0`, `y1`, + `slope`, `dx`, `dy`, `width`, `height`, `length`, `xcenter` and + `ycenter`. + + The 'texttemplate' property is a string and must be specified as: + - A string + - A number that will be converted to a string + + Returns + ------- + str + """ + return self["texttemplate"] + + @texttemplate.setter + def texttemplate(self, val): + self["texttemplate"] = val + # xanchor # ------- @property @@ -235,6 +276,30 @@ def _prop_descriptions(self): values for lines are "start", "middle", and "end". Default: *middle center* for rectangles, circles, and paths; "middle" for lines. + texttemplate + Template string used for rendering the shape's label. + Note that this will override `text`. Variables are + inserted using %{variable}, for example "x0: %{x0}". + Numbers are formatted using d3-format's syntax + %{variable:d3-format}, for example "Price: %{x0:$.2f}". + See + https://github.com/d3/d3-format/tree/v1.4.5#d3-format + for details on the formatting syntax. Dates are + formatted using d3-time-format's syntax + %{variable|d3-time-format}, for example "Day: %{x0|%m + %b %Y}". See https://github.com/d3/d3-time- + format/tree/v2.2.3#locale_format for details on the + date formatting syntax. A single multiplication or + division operation may be applied to numeric variables, + and combined with d3 number formatting, for example + "Length in cm: %{x0*2.54}", "%{slope*60:.1f} meters per + second." For log axes, variable values are given in log + units. For date axes, x/y coordinate variables and + center variables use datetimes, while all other + variable values use values in ms. Finally, the template + string has access to variables `x0`, `x1`, `y0`, `y1`, + `slope`, `dx`, `dy`, `width`, `height`, `length`, + `xcenter` and `ycenter`. xanchor Sets the label's horizontal position anchor This anchor binds the specified `textposition` to the "left", @@ -259,6 +324,7 @@ def __init__( text=None, textangle=None, textposition=None, + texttemplate=None, xanchor=None, yanchor=None, **kwargs, @@ -293,6 +359,30 @@ def __init__( values for lines are "start", "middle", and "end". Default: *middle center* for rectangles, circles, and paths; "middle" for lines. + texttemplate + Template string used for rendering the shape's label. + Note that this will override `text`. Variables are + inserted using %{variable}, for example "x0: %{x0}". + Numbers are formatted using d3-format's syntax + %{variable:d3-format}, for example "Price: %{x0:$.2f}". + See + https://github.com/d3/d3-format/tree/v1.4.5#d3-format + for details on the formatting syntax. Dates are + formatted using d3-time-format's syntax + %{variable|d3-time-format}, for example "Day: %{x0|%m + %b %Y}". See https://github.com/d3/d3-time- + format/tree/v2.2.3#locale_format for details on the + date formatting syntax. A single multiplication or + division operation may be applied to numeric variables, + and combined with d3 number formatting, for example + "Length in cm: %{x0*2.54}", "%{slope*60:.1f} meters per + second." For log axes, variable values are given in log + units. For date axes, x/y coordinate variables and + center variables use datetimes, while all other + variable values use values in ms. Finally, the template + string has access to variables `x0`, `x1`, `y0`, `y1`, + `slope`, `dx`, `dy`, `width`, `height`, `length`, + `xcenter` and `ycenter`. xanchor Sets the label's horizontal position anchor This anchor binds the specified `textposition` to the "left", @@ -361,6 +451,10 @@ def __init__( _v = textposition if textposition is not None else _v if _v is not None: self["textposition"] = _v + _v = arg.pop("texttemplate", None) + _v = texttemplate if texttemplate is not None else _v + if _v is not None: + self["texttemplate"] = _v _v = arg.pop("xanchor", None) _v = xanchor if xanchor is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/mesh3d/_colorbar.py b/packages/python/plotly/plotly/graph_objs/mesh3d/_colorbar.py index c872eb6ae52..4253fa9957c 100644 --- a/packages/python/plotly/plotly/graph_objs/mesh3d/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/mesh3d/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1309,12 +1311,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1370,17 +1376,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1436,6 +1469,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1646,9 +1702,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1658,10 +1719,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1671,6 +1741,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1727,9 +1801,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1946,9 +2022,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1958,10 +2039,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1971,6 +2061,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2189,6 +2283,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2201,6 +2299,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/parcats/_line.py b/packages/python/plotly/plotly/graph_objs/parcats/_line.py index 290a648a834..6f239df39b1 100644 --- a/packages/python/plotly/plotly/graph_objs/parcats/_line.py +++ b/packages/python/plotly/plotly/graph_objs/parcats/_line.py @@ -481,9 +481,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -493,10 +499,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -506,6 +522,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -615,11 +635,13 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `count` and `probability`. Anything contained in tag `` - is displayed in the secondary box, for example - "{fullData.name}". To hide the secondary box - completely, use an empty tag ``. + (the ones that are `arrayOk: true`) are available. This value + here applies when hovering over lines.Finally, the template + string has access to variables `count` and `probability`. + Anything contained in tag `` is displayed in the + secondary box, for example "{fullData.name}". To + hide the secondary box completely, use an empty tag + ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -798,11 +820,13 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `count` and `probability`. - Anything contained in tag `` is displayed in the - secondary box, for example - "{fullData.name}". To hide the secondary - box completely, use an empty tag ``. + are available. This value here applies when hovering + over lines.Finally, the template string has access to + variables `count` and `probability`. Anything contained + in tag `` is displayed in the secondary box, for + example "{fullData.name}". To hide the + secondary box completely, use an empty tag + ``. reversescale Reverses the color mapping if true. Has an effect only if in `line.color` is set to a numerical array. If @@ -936,11 +960,13 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `count` and `probability`. - Anything contained in tag `` is displayed in the - secondary box, for example - "{fullData.name}". To hide the secondary - box completely, use an empty tag ``. + are available. This value here applies when hovering + over lines.Finally, the template string has access to + variables `count` and `probability`. Anything contained + in tag `` is displayed in the secondary box, for + example "{fullData.name}". To hide the + secondary box completely, use an empty tag + ``. reversescale Reverses the color mapping if true. Has an effect only if in `line.color` is set to a numerical array. If diff --git a/packages/python/plotly/plotly/graph_objs/parcats/line/_colorbar.py b/packages/python/plotly/plotly/graph_objs/parcats/line/_colorbar.py index b637cbee0fc..7c0bcafb0b1 100644 --- a/packages/python/plotly/plotly/graph_objs/parcats/line/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/parcats/line/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1647,9 +1703,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1659,10 +1720,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1672,6 +1742,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1728,9 +1802,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1947,9 +2023,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1959,10 +2040,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1972,6 +2062,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2190,6 +2284,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2202,6 +2300,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/parcoords/_line.py b/packages/python/plotly/plotly/graph_objs/parcoords/_line.py index 619784c25ff..f1d8c08f631 100644 --- a/packages/python/plotly/plotly/graph_objs/parcoords/_line.py +++ b/packages/python/plotly/plotly/graph_objs/parcoords/_line.py @@ -479,9 +479,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -491,10 +497,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -504,6 +520,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/parcoords/line/_colorbar.py b/packages/python/plotly/plotly/graph_objs/parcoords/line/_colorbar.py index b732ad301fe..a7fa05baf64 100644 --- a/packages/python/plotly/plotly/graph_objs/parcoords/line/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/parcoords/line/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1647,9 +1703,14 @@ def _prop_descriptions(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1659,10 +1720,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1672,6 +1742,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1728,9 +1802,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1947,9 +2023,14 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1959,10 +2040,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1972,6 +2062,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2190,6 +2284,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2202,6 +2300,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/pie/_marker.py b/packages/python/plotly/plotly/graph_objs/pie/_marker.py index 1cca49625f0..5dc68dd8e2a 100644 --- a/packages/python/plotly/plotly/graph_objs/pie/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/pie/_marker.py @@ -8,7 +8,7 @@ class Marker(_BaseTraceHierarchyType): # -------------------- _parent_path_str = "pie" _path_str = "pie.marker" - _valid_props = {"colors", "colorssrc", "line"} + _valid_props = {"colors", "colorssrc", "line", "pattern"} # colors # ------ @@ -87,6 +87,80 @@ def line(self): def line(self, val): self["line"] = val + # pattern + # ------- + @property + def pattern(self): + """ + Sets the pattern within the marker. + + The 'pattern' property is an instance of Pattern + that may be specified as: + - An instance of :class:`plotly.graph_objs.pie.marker.Pattern` + - A dict of string/value properties that will be passed + to the Pattern constructor + + Supported dict properties: + + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "overlay". Otherwise, defaults to a transparent + background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud + for `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud + for `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern + fill. Defaults to a 0.5 when `fillmode` is + "overlay". Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be + used as a default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, + no pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud + for `shape`. + size + Sets the size of unit squares of the pattern + fill in pixels, which corresponds to the + interval of repetition of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud + for `size`. + solidity + Sets the solidity of the pattern fill. Solidity + is roughly the fraction of the area filled by + the pattern. Solidity of 0 shows only the + background color without pattern and solidty of + 1 shows only the foreground color without + pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud + for `solidity`. + + Returns + ------- + plotly.graph_objs.pie.marker.Pattern + """ + return self["pattern"] + + @pattern.setter + def pattern(self, val): + self["pattern"] = val + # Self properties description # --------------------------- @property @@ -102,9 +176,13 @@ def _prop_descriptions(self): line :class:`plotly.graph_objects.pie.marker.Line` instance or dict with compatible properties + pattern + Sets the pattern within the marker. """ - def __init__(self, arg=None, colors=None, colorssrc=None, line=None, **kwargs): + def __init__( + self, arg=None, colors=None, colorssrc=None, line=None, pattern=None, **kwargs + ): """ Construct a new Marker object @@ -123,6 +201,8 @@ def __init__(self, arg=None, colors=None, colorssrc=None, line=None, **kwargs): line :class:`plotly.graph_objects.pie.marker.Line` instance or dict with compatible properties + pattern + Sets the pattern within the marker. Returns ------- @@ -169,6 +249,10 @@ def __init__(self, arg=None, colors=None, colorssrc=None, line=None, **kwargs): _v = line if line is not None else _v if _v is not None: self["line"] = _v + _v = arg.pop("pattern", None) + _v = pattern if pattern is not None else _v + if _v is not None: + self["pattern"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/pie/marker/__init__.py b/packages/python/plotly/plotly/graph_objs/pie/marker/__init__.py index 8722c15a2b8..9f8ac2640cb 100644 --- a/packages/python/plotly/plotly/graph_objs/pie/marker/__init__.py +++ b/packages/python/plotly/plotly/graph_objs/pie/marker/__init__.py @@ -3,7 +3,10 @@ if sys.version_info < (3, 7) or TYPE_CHECKING: from ._line import Line + from ._pattern import Pattern else: from _plotly_utils.importers import relative_import - __all__, __getattr__, __dir__ = relative_import(__name__, [], ["._line.Line"]) + __all__, __getattr__, __dir__ = relative_import( + __name__, [], ["._line.Line", "._pattern.Pattern"] + ) diff --git a/packages/python/plotly/plotly/graph_objs/pie/marker/_pattern.py b/packages/python/plotly/plotly/graph_objs/pie/marker/_pattern.py new file mode 100644 index 00000000000..9f9e0d31db6 --- /dev/null +++ b/packages/python/plotly/plotly/graph_objs/pie/marker/_pattern.py @@ -0,0 +1,580 @@ +from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType +import copy as _copy + + +class Pattern(_BaseTraceHierarchyType): + + # class properties + # -------------------- + _parent_path_str = "pie.marker" + _path_str = "pie.marker.pattern" + _valid_props = { + "bgcolor", + "bgcolorsrc", + "fgcolor", + "fgcolorsrc", + "fgopacity", + "fillmode", + "shape", + "shapesrc", + "size", + "sizesrc", + "solidity", + "soliditysrc", + } + + # bgcolor + # ------- + @property + def bgcolor(self): + """ + When there is no colorscale sets the color of background + pattern fill. Defaults to a `marker.color` background when + `fillmode` is "overlay". Otherwise, defaults to a transparent + background. + + 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 + - A list or array of any of the above + + Returns + ------- + str|numpy.ndarray + """ + return self["bgcolor"] + + @bgcolor.setter + def bgcolor(self, val): + self["bgcolor"] = val + + # bgcolorsrc + # ---------- + @property + def bgcolorsrc(self): + """ + Sets the source reference on Chart Studio Cloud for `bgcolor`. + + The 'bgcolorsrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["bgcolorsrc"] + + @bgcolorsrc.setter + def bgcolorsrc(self, val): + self["bgcolorsrc"] = val + + # fgcolor + # ------- + @property + def fgcolor(self): + """ + When there is no colorscale sets the color of foreground + pattern fill. Defaults to a `marker.color` background when + `fillmode` is "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + + The 'fgcolor' 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 + - A list or array of any of the above + + Returns + ------- + str|numpy.ndarray + """ + return self["fgcolor"] + + @fgcolor.setter + def fgcolor(self, val): + self["fgcolor"] = val + + # fgcolorsrc + # ---------- + @property + def fgcolorsrc(self): + """ + Sets the source reference on Chart Studio Cloud for `fgcolor`. + + The 'fgcolorsrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["fgcolorsrc"] + + @fgcolorsrc.setter + def fgcolorsrc(self, val): + self["fgcolorsrc"] = val + + # fgopacity + # --------- + @property + def fgopacity(self): + """ + Sets the opacity of the foreground pattern fill. Defaults to a + 0.5 when `fillmode` is "overlay". Otherwise, defaults to 1. + + The 'fgopacity' property is a number and may be specified as: + - An int or float in the interval [0, 1] + + Returns + ------- + int|float + """ + return self["fgopacity"] + + @fgopacity.setter + def fgopacity(self, val): + self["fgopacity"] = val + + # fillmode + # -------- + @property + def fillmode(self): + """ + Determines whether `marker.color` should be used as a default + to `bgcolor` or a `fgcolor`. + + The 'fillmode' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['replace', 'overlay'] + + Returns + ------- + Any + """ + return self["fillmode"] + + @fillmode.setter + def fillmode(self, val): + self["fillmode"] = val + + # shape + # ----- + @property + def shape(self): + """ + Sets the shape of the pattern fill. By default, no pattern is + used for filling the area. + + The 'shape' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['', '/', '\\', 'x', '-', '|', '+', '.'] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + Any|numpy.ndarray + """ + return self["shape"] + + @shape.setter + def shape(self, val): + self["shape"] = val + + # shapesrc + # -------- + @property + def shapesrc(self): + """ + Sets the source reference on Chart Studio Cloud for `shape`. + + The 'shapesrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["shapesrc"] + + @shapesrc.setter + def shapesrc(self, val): + self["shapesrc"] = val + + # size + # ---- + @property + def size(self): + """ + Sets the size of unit squares of the pattern fill in pixels, + which corresponds to the interval of repetition of the pattern. + + The 'size' property is a number and may be specified as: + - An int or float in the interval [0, inf] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + int|float|numpy.ndarray + """ + return self["size"] + + @size.setter + def size(self, val): + self["size"] = val + + # sizesrc + # ------- + @property + def sizesrc(self): + """ + Sets the source reference on Chart Studio Cloud for `size`. + + The 'sizesrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["sizesrc"] + + @sizesrc.setter + def sizesrc(self, val): + self["sizesrc"] = val + + # solidity + # -------- + @property + def solidity(self): + """ + Sets the solidity of the pattern fill. Solidity is roughly the + fraction of the area filled by the pattern. Solidity of 0 shows + only the background color without pattern and solidty of 1 + shows only the foreground color without pattern. + + The 'solidity' property is a number and may be specified as: + - An int or float in the interval [0, 1] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + int|float|numpy.ndarray + """ + return self["solidity"] + + @solidity.setter + def solidity(self, val): + self["solidity"] = val + + # soliditysrc + # ----------- + @property + def soliditysrc(self): + """ + Sets the source reference on Chart Studio Cloud for `solidity`. + + The 'soliditysrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["soliditysrc"] + + @soliditysrc.setter + def soliditysrc(self, val): + self["soliditysrc"] = val + + # Self properties description + # --------------------------- + @property + def _prop_descriptions(self): + return """\ + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a `marker.color` + background when `fillmode` is "overlay". Otherwise, + defaults to a transparent background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud for + `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a `marker.color` + background when `fillmode` is "replace". Otherwise, + defaults to dark grey or white to increase contrast + with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud for + `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern fill. + Defaults to a 0.5 when `fillmode` is "overlay". + Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be used as a + default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, no + pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud for + `shape`. + size + Sets the size of unit squares of the pattern fill in + pixels, which corresponds to the interval of repetition + of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud for + `size`. + solidity + Sets the solidity of the pattern fill. Solidity is + roughly the fraction of the area filled by the pattern. + Solidity of 0 shows only the background color without + pattern and solidty of 1 shows only the foreground + color without pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud for + `solidity`. + """ + + def __init__( + self, + arg=None, + bgcolor=None, + bgcolorsrc=None, + fgcolor=None, + fgcolorsrc=None, + fgopacity=None, + fillmode=None, + shape=None, + shapesrc=None, + size=None, + sizesrc=None, + solidity=None, + soliditysrc=None, + **kwargs, + ): + """ + Construct a new Pattern object + + Sets the pattern within the marker. + + Parameters + ---------- + arg + dict of properties compatible with this constructor or + an instance of + :class:`plotly.graph_objs.pie.marker.Pattern` + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a `marker.color` + background when `fillmode` is "overlay". Otherwise, + defaults to a transparent background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud for + `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a `marker.color` + background when `fillmode` is "replace". Otherwise, + defaults to dark grey or white to increase contrast + with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud for + `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern fill. + Defaults to a 0.5 when `fillmode` is "overlay". + Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be used as a + default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, no + pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud for + `shape`. + size + Sets the size of unit squares of the pattern fill in + pixels, which corresponds to the interval of repetition + of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud for + `size`. + solidity + Sets the solidity of the pattern fill. Solidity is + roughly the fraction of the area filled by the pattern. + Solidity of 0 shows only the background color without + pattern and solidty of 1 shows only the foreground + color without pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud for + `solidity`. + + Returns + ------- + Pattern + """ + super(Pattern, self).__init__("pattern") + + 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.pie.marker.Pattern +constructor must be a dict or +an instance of :class:`plotly.graph_objs.pie.marker.Pattern`""" + ) + + # 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("bgcolor", None) + _v = bgcolor if bgcolor is not None else _v + if _v is not None: + self["bgcolor"] = _v + _v = arg.pop("bgcolorsrc", None) + _v = bgcolorsrc if bgcolorsrc is not None else _v + if _v is not None: + self["bgcolorsrc"] = _v + _v = arg.pop("fgcolor", None) + _v = fgcolor if fgcolor is not None else _v + if _v is not None: + self["fgcolor"] = _v + _v = arg.pop("fgcolorsrc", None) + _v = fgcolorsrc if fgcolorsrc is not None else _v + if _v is not None: + self["fgcolorsrc"] = _v + _v = arg.pop("fgopacity", None) + _v = fgopacity if fgopacity is not None else _v + if _v is not None: + self["fgopacity"] = _v + _v = arg.pop("fillmode", None) + _v = fillmode if fillmode is not None else _v + if _v is not None: + self["fillmode"] = _v + _v = arg.pop("shape", None) + _v = shape if shape is not None else _v + if _v is not None: + self["shape"] = _v + _v = arg.pop("shapesrc", None) + _v = shapesrc if shapesrc is not None else _v + if _v is not None: + self["shapesrc"] = _v + _v = arg.pop("size", None) + _v = size if size is not None else _v + if _v is not None: + self["size"] = _v + _v = arg.pop("sizesrc", None) + _v = sizesrc if sizesrc is not None else _v + if _v is not None: + self["sizesrc"] = _v + _v = arg.pop("solidity", None) + _v = solidity if solidity is not None else _v + if _v is not None: + self["solidity"] = _v + _v = arg.pop("soliditysrc", None) + _v = soliditysrc if soliditysrc is not None else _v + if _v is not None: + self["soliditysrc"] = _v + + # Process unknown kwargs + # ---------------------- + self._process_kwargs(**dict(arg, **kwargs)) + + # Reset skip_invalid + # ------------------ + self._skip_invalid = False diff --git a/packages/python/plotly/plotly/graph_objs/sankey/_link.py b/packages/python/plotly/plotly/graph_objs/sankey/_link.py index 7007c62dcef..20c6e7f31a9 100644 --- a/packages/python/plotly/plotly/graph_objs/sankey/_link.py +++ b/packages/python/plotly/plotly/graph_objs/sankey/_link.py @@ -376,11 +376,12 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables - `value` and `label`. Anything contained in tag `` is - displayed in the secondary box, for example - "{fullData.name}". To hide the secondary box - completely, use an empty tag ``. + (the ones that are `arrayOk: true`) are available. Variables + `source` and `target` are node objects.Finally, the template + string has access to variables `value` and `label`. Anything + contained in tag `` is displayed in the secondary box, + for example "{fullData.name}". To hide the + secondary box completely, use an empty tag ``. The 'hovertemplate' property is a string and must be specified as: - A string @@ -678,11 +679,13 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `value` and `label`. Anything - contained in tag `` is displayed in the - secondary box, for example - "{fullData.name}". To hide the secondary - box completely, use an empty tag ``. + are available. Variables `source` and `target` are + node objects.Finally, the template string has access to + variables `value` and `label`. Anything contained in + tag `` is displayed in the secondary box, for + example "{fullData.name}". To hide the + secondary box completely, use an empty tag + ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. @@ -805,11 +808,13 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `value` and `label`. Anything - contained in tag `` is displayed in the - secondary box, for example - "{fullData.name}". To hide the secondary - box completely, use an empty tag ``. + are available. Variables `source` and `target` are + node objects.Finally, the template string has access to + variables `value` and `label`. Anything contained in + tag `` is displayed in the secondary box, for + example "{fullData.name}". To hide the + secondary box completely, use an empty tag + ``. hovertemplatesrc Sets the source reference on Chart Studio Cloud for `hovertemplate`. diff --git a/packages/python/plotly/plotly/graph_objs/sankey/_node.py b/packages/python/plotly/plotly/graph_objs/sankey/_node.py index 883f05d817e..5b9683ebba3 100644 --- a/packages/python/plotly/plotly/graph_objs/sankey/_node.py +++ b/packages/python/plotly/plotly/graph_objs/sankey/_node.py @@ -286,7 +286,9 @@ def hovertemplate(self): are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point - (the ones that are `arrayOk: true`) are available. variables + (the ones that are `arrayOk: true`) are available. Variables + `sourceLinks` and `targetLinks` are arrays of link + objects.Finally, the template string has access to variables `value` and `label`. Anything contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the secondary box @@ -580,9 +582,11 @@ def _prop_descriptions(self): https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `value` and `label`. Anything - contained in tag `` is displayed in the - secondary box, for example + are available. Variables `sourceLinks` and + `targetLinks` are arrays of link objects.Finally, the + template string has access to variables `value` and + `label`. Anything contained in tag `` is + displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc @@ -696,9 +700,11 @@ def __init__( https://plotly.com/javascript/plotlyjs-events/#event- data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) - are available. variables `value` and `label`. Anything - contained in tag `` is displayed in the - secondary box, for example + are available. Variables `sourceLinks` and + `targetLinks` are arrays of link objects.Finally, the + template string has access to variables `value` and + `label`. Anything contained in tag `` is + displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. hovertemplatesrc diff --git a/packages/python/plotly/plotly/graph_objs/scatter/_marker.py b/packages/python/plotly/plotly/graph_objs/scatter/_marker.py index 3fbe48809f8..9e79e6192f8 100644 --- a/packages/python/plotly/plotly/graph_objs/scatter/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/scatter/_marker.py @@ -562,9 +562,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -574,10 +580,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -587,6 +603,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/scatter/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/scatter/marker/_colorbar.py index 0b99f988218..a8014f9db4a 100644 --- a/packages/python/plotly/plotly/graph_objs/scatter/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/scatter/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1647,9 +1703,14 @@ def _prop_descriptions(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1659,10 +1720,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1672,6 +1742,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1728,9 +1802,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1947,9 +2023,14 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1959,10 +2040,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1972,6 +2062,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2190,6 +2284,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2202,6 +2300,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/scatter3d/_line.py b/packages/python/plotly/plotly/graph_objs/scatter3d/_line.py index ec72c8e51e2..e6ca07d18fe 100644 --- a/packages/python/plotly/plotly/graph_objs/scatter3d/_line.py +++ b/packages/python/plotly/plotly/graph_objs/scatter3d/_line.py @@ -481,9 +481,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -493,10 +499,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -506,6 +522,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/scatter3d/_marker.py b/packages/python/plotly/plotly/graph_objs/scatter3d/_marker.py index e67065ffc33..03fc9eae425 100644 --- a/packages/python/plotly/plotly/graph_objs/scatter3d/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/scatter3d/_marker.py @@ -489,9 +489,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -501,10 +507,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -514,6 +530,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/scatter3d/line/_colorbar.py b/packages/python/plotly/plotly/graph_objs/scatter3d/line/_colorbar.py index 7ff212ba530..51bd2df7b77 100644 --- a/packages/python/plotly/plotly/graph_objs/scatter3d/line/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/scatter3d/line/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1647,9 +1703,14 @@ def _prop_descriptions(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1659,10 +1720,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1672,6 +1742,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1728,9 +1802,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1947,9 +2023,14 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1959,10 +2040,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1972,6 +2062,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2190,6 +2284,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2202,6 +2300,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/scatter3d/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/scatter3d/marker/_colorbar.py index b355a86519f..4e815eee79e 100644 --- a/packages/python/plotly/plotly/graph_objs/scatter3d/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/scatter3d/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1648,9 +1704,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1660,10 +1721,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1673,6 +1743,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1729,9 +1803,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1949,9 +2025,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1961,10 +2042,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1974,6 +2064,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2192,6 +2286,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2204,6 +2302,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/scattercarpet/_marker.py b/packages/python/plotly/plotly/graph_objs/scattercarpet/_marker.py index 2370925db32..ba5eac50af7 100644 --- a/packages/python/plotly/plotly/graph_objs/scattercarpet/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/scattercarpet/_marker.py @@ -562,9 +562,15 @@ def colorbar(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -574,10 +580,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -587,6 +603,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/scattercarpet/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/scattercarpet/marker/_colorbar.py index 284d833fde2..2b3d755ab2e 100644 --- a/packages/python/plotly/plotly/graph_objs/scattercarpet/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/scattercarpet/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1649,9 +1705,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1661,10 +1722,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1674,6 +1744,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1730,9 +1804,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1951,9 +2027,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1963,10 +2044,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1976,6 +2066,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2194,6 +2288,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2206,6 +2304,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/scattergeo/_marker.py b/packages/python/plotly/plotly/graph_objs/scattergeo/_marker.py index c0e7e75ff0a..b5e9e8a1c26 100644 --- a/packages/python/plotly/plotly/graph_objs/scattergeo/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/scattergeo/_marker.py @@ -563,9 +563,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -575,10 +581,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -588,6 +604,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/scattergeo/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/scattergeo/marker/_colorbar.py index 60525e8b323..c019ddb46e3 100644 --- a/packages/python/plotly/plotly/graph_objs/scattergeo/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/scattergeo/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1649,9 +1705,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1661,10 +1722,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1674,6 +1744,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1730,9 +1804,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1951,9 +2027,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1963,10 +2044,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1976,6 +2066,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2194,6 +2288,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2206,6 +2304,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/scattergl/_marker.py b/packages/python/plotly/plotly/graph_objs/scattergl/_marker.py index a530706c5b2..d48e6dcec78 100644 --- a/packages/python/plotly/plotly/graph_objs/scattergl/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/scattergl/_marker.py @@ -534,9 +534,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -546,10 +552,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -559,6 +575,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/scattergl/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/scattergl/marker/_colorbar.py index dd3b3f83d5b..ec29740fc58 100644 --- a/packages/python/plotly/plotly/graph_objs/scattergl/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/scattergl/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1648,9 +1704,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1660,10 +1721,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1673,6 +1743,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1729,9 +1803,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1949,9 +2025,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1961,10 +2042,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1974,6 +2064,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2192,6 +2286,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2204,6 +2302,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/scattermapbox/_marker.py b/packages/python/plotly/plotly/graph_objs/scattermapbox/_marker.py index 8c159a5e915..6e81a075e0d 100644 --- a/packages/python/plotly/plotly/graph_objs/scattermapbox/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/scattermapbox/_marker.py @@ -556,9 +556,15 @@ def colorbar(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -568,10 +574,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -581,6 +597,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/scattermapbox/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/scattermapbox/marker/_colorbar.py index fa12bd7725b..c99ac78fd27 100644 --- a/packages/python/plotly/plotly/graph_objs/scattermapbox/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/scattermapbox/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1649,9 +1705,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1661,10 +1722,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1674,6 +1744,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1730,9 +1804,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1951,9 +2027,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1963,10 +2044,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1976,6 +2066,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2194,6 +2288,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2206,6 +2304,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/scatterpolar/_marker.py b/packages/python/plotly/plotly/graph_objs/scatterpolar/_marker.py index 380fe6e21cb..c1de0f6014e 100644 --- a/packages/python/plotly/plotly/graph_objs/scatterpolar/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/scatterpolar/_marker.py @@ -562,9 +562,15 @@ def colorbar(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -574,10 +580,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -587,6 +603,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/scatterpolar/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/scatterpolar/marker/_colorbar.py index b75548cfe4d..dcc304f6064 100644 --- a/packages/python/plotly/plotly/graph_objs/scatterpolar/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/scatterpolar/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1649,9 +1705,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1661,10 +1722,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1674,6 +1744,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1730,9 +1804,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1951,9 +2027,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1963,10 +2044,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1976,6 +2066,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2194,6 +2288,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2206,6 +2304,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/scatterpolargl/_marker.py b/packages/python/plotly/plotly/graph_objs/scatterpolargl/_marker.py index 5b6fe69805a..44e6dc82206 100644 --- a/packages/python/plotly/plotly/graph_objs/scatterpolargl/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/scatterpolargl/_marker.py @@ -534,9 +534,15 @@ def colorbar(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -546,10 +552,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -559,6 +575,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/scatterpolargl/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/scatterpolargl/marker/_colorbar.py index 3fcaabfad74..875c35988f0 100644 --- a/packages/python/plotly/plotly/graph_objs/scatterpolargl/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/scatterpolargl/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1311,12 +1313,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1372,17 +1378,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1438,6 +1471,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1650,9 +1706,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1662,10 +1723,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1675,6 +1745,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1731,9 +1805,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1952,9 +2028,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1964,10 +2045,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1977,6 +2067,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2195,6 +2289,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2207,6 +2305,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/scattersmith/_marker.py b/packages/python/plotly/plotly/graph_objs/scattersmith/_marker.py index d6db6d480b1..b51a8530e0c 100644 --- a/packages/python/plotly/plotly/graph_objs/scattersmith/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/scattersmith/_marker.py @@ -562,9 +562,15 @@ def colorbar(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -574,10 +580,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -587,6 +603,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/scattersmith/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/scattersmith/marker/_colorbar.py index df87dcccb4c..ff62f532862 100644 --- a/packages/python/plotly/plotly/graph_objs/scattersmith/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/scattersmith/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1649,9 +1705,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1661,10 +1722,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1674,6 +1744,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1730,9 +1804,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1951,9 +2027,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1963,10 +2044,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1976,6 +2066,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2194,6 +2288,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2206,6 +2304,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/scatterternary/_marker.py b/packages/python/plotly/plotly/graph_objs/scatterternary/_marker.py index d3c05b186f0..52ea19e3fb0 100644 --- a/packages/python/plotly/plotly/graph_objs/scatterternary/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/scatterternary/_marker.py @@ -562,9 +562,15 @@ def colorbar(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -574,10 +580,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -587,6 +603,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/scatterternary/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/scatterternary/marker/_colorbar.py index 1f2646175ff..0bd2ff82c75 100644 --- a/packages/python/plotly/plotly/graph_objs/scatterternary/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/scatterternary/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1311,12 +1313,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1372,17 +1378,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1438,6 +1471,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1650,9 +1706,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1662,10 +1723,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1675,6 +1745,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1731,9 +1805,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1952,9 +2028,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1964,10 +2045,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1977,6 +2067,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2195,6 +2289,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2207,6 +2305,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/splom/_marker.py b/packages/python/plotly/plotly/graph_objs/splom/_marker.py index 7f38cbb4084..0d8aa11ffac 100644 --- a/packages/python/plotly/plotly/graph_objs/splom/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/splom/_marker.py @@ -534,9 +534,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -546,10 +552,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -559,6 +575,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- diff --git a/packages/python/plotly/plotly/graph_objs/splom/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/splom/marker/_colorbar.py index 0df97fcc1a8..0d096adedd0 100644 --- a/packages/python/plotly/plotly/graph_objs/splom/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/splom/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1647,9 +1703,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1659,10 +1720,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1672,6 +1742,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1728,9 +1802,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1947,9 +2023,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1959,10 +2040,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1972,6 +2062,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2190,6 +2284,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2202,6 +2300,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/streamtube/_colorbar.py b/packages/python/plotly/plotly/graph_objs/streamtube/_colorbar.py index 2c68bb29cf7..8c782a55070 100644 --- a/packages/python/plotly/plotly/graph_objs/streamtube/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/streamtube/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1308,12 +1310,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1369,17 +1375,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1435,6 +1468,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1645,9 +1701,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1657,10 +1718,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1670,6 +1740,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1726,9 +1800,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1945,9 +2021,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1957,10 +2038,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1970,6 +2060,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2188,6 +2282,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2200,6 +2298,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/sunburst/_marker.py b/packages/python/plotly/plotly/graph_objs/sunburst/_marker.py index cadfe2e126b..f1bcd201ef7 100644 --- a/packages/python/plotly/plotly/graph_objs/sunburst/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/sunburst/_marker.py @@ -20,6 +20,7 @@ class Marker(_BaseTraceHierarchyType): "colorscale", "colorssrc", "line", + "pattern", "reversescale", "showscale", } @@ -413,9 +414,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -425,10 +432,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -438,6 +455,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -580,6 +601,80 @@ def line(self): def line(self, val): self["line"] = val + # pattern + # ------- + @property + def pattern(self): + """ + Sets the pattern within the marker. + + The 'pattern' property is an instance of Pattern + that may be specified as: + - An instance of :class:`plotly.graph_objs.sunburst.marker.Pattern` + - A dict of string/value properties that will be passed + to the Pattern constructor + + Supported dict properties: + + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "overlay". Otherwise, defaults to a transparent + background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud + for `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud + for `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern + fill. Defaults to a 0.5 when `fillmode` is + "overlay". Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be + used as a default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, + no pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud + for `shape`. + size + Sets the size of unit squares of the pattern + fill in pixels, which corresponds to the + interval of repetition of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud + for `size`. + solidity + Sets the solidity of the pattern fill. Solidity + is roughly the fraction of the area filled by + the pattern. Solidity of 0 shows only the + background color without pattern and solidty of + 1 shows only the foreground color without + pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud + for `solidity`. + + Returns + ------- + plotly.graph_objs.sunburst.marker.Pattern + """ + return self["pattern"] + + @pattern.setter + def pattern(self, val): + self["pattern"] = val + # reversescale # ------------ @property @@ -696,6 +791,8 @@ def _prop_descriptions(self): line :class:`plotly.graph_objects.sunburst.marker.Line` instance or dict with compatible properties + pattern + Sets the pattern within the marker. reversescale Reverses the color mapping if true. Has an effect only if colors is set to a numerical array. If true, @@ -722,6 +819,7 @@ def __init__( colorscale=None, colorssrc=None, line=None, + pattern=None, reversescale=None, showscale=None, **kwargs, @@ -801,6 +899,8 @@ def __init__( line :class:`plotly.graph_objects.sunburst.marker.Line` instance or dict with compatible properties + pattern + Sets the pattern within the marker. reversescale Reverses the color mapping if true. Has an effect only if colors is set to a numerical array. If true, @@ -889,6 +989,10 @@ def __init__( _v = line if line is not None else _v if _v is not None: self["line"] = _v + _v = arg.pop("pattern", None) + _v = pattern if pattern is not None else _v + if _v is not None: + self["pattern"] = _v _v = arg.pop("reversescale", None) _v = reversescale if reversescale is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/sunburst/marker/__init__.py b/packages/python/plotly/plotly/graph_objs/sunburst/marker/__init__.py index 8481520e3c9..ce0279c5444 100644 --- a/packages/python/plotly/plotly/graph_objs/sunburst/marker/__init__.py +++ b/packages/python/plotly/plotly/graph_objs/sunburst/marker/__init__.py @@ -4,10 +4,13 @@ if sys.version_info < (3, 7) or TYPE_CHECKING: from ._colorbar import ColorBar from ._line import Line + from ._pattern import Pattern from . import colorbar else: from _plotly_utils.importers import relative_import __all__, __getattr__, __dir__ = relative_import( - __name__, [".colorbar"], ["._colorbar.ColorBar", "._line.Line"] + __name__, + [".colorbar"], + ["._colorbar.ColorBar", "._line.Line", "._pattern.Pattern"], ) diff --git a/packages/python/plotly/plotly/graph_objs/sunburst/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/sunburst/marker/_colorbar.py index 15a6a107f80..0596e211ef4 100644 --- a/packages/python/plotly/plotly/graph_objs/sunburst/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/sunburst/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1647,9 +1703,14 @@ def _prop_descriptions(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1659,10 +1720,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1672,6 +1742,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1728,9 +1802,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1947,9 +2023,14 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1959,10 +2040,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1972,6 +2062,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2190,6 +2284,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2202,6 +2300,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/sunburst/marker/_pattern.py b/packages/python/plotly/plotly/graph_objs/sunburst/marker/_pattern.py new file mode 100644 index 00000000000..802761107d8 --- /dev/null +++ b/packages/python/plotly/plotly/graph_objs/sunburst/marker/_pattern.py @@ -0,0 +1,580 @@ +from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType +import copy as _copy + + +class Pattern(_BaseTraceHierarchyType): + + # class properties + # -------------------- + _parent_path_str = "sunburst.marker" + _path_str = "sunburst.marker.pattern" + _valid_props = { + "bgcolor", + "bgcolorsrc", + "fgcolor", + "fgcolorsrc", + "fgopacity", + "fillmode", + "shape", + "shapesrc", + "size", + "sizesrc", + "solidity", + "soliditysrc", + } + + # bgcolor + # ------- + @property + def bgcolor(self): + """ + When there is no colorscale sets the color of background + pattern fill. Defaults to a `marker.color` background when + `fillmode` is "overlay". Otherwise, defaults to a transparent + background. + + 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 + - A list or array of any of the above + + Returns + ------- + str|numpy.ndarray + """ + return self["bgcolor"] + + @bgcolor.setter + def bgcolor(self, val): + self["bgcolor"] = val + + # bgcolorsrc + # ---------- + @property + def bgcolorsrc(self): + """ + Sets the source reference on Chart Studio Cloud for `bgcolor`. + + The 'bgcolorsrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["bgcolorsrc"] + + @bgcolorsrc.setter + def bgcolorsrc(self, val): + self["bgcolorsrc"] = val + + # fgcolor + # ------- + @property + def fgcolor(self): + """ + When there is no colorscale sets the color of foreground + pattern fill. Defaults to a `marker.color` background when + `fillmode` is "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + + The 'fgcolor' 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 + - A list or array of any of the above + + Returns + ------- + str|numpy.ndarray + """ + return self["fgcolor"] + + @fgcolor.setter + def fgcolor(self, val): + self["fgcolor"] = val + + # fgcolorsrc + # ---------- + @property + def fgcolorsrc(self): + """ + Sets the source reference on Chart Studio Cloud for `fgcolor`. + + The 'fgcolorsrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["fgcolorsrc"] + + @fgcolorsrc.setter + def fgcolorsrc(self, val): + self["fgcolorsrc"] = val + + # fgopacity + # --------- + @property + def fgopacity(self): + """ + Sets the opacity of the foreground pattern fill. Defaults to a + 0.5 when `fillmode` is "overlay". Otherwise, defaults to 1. + + The 'fgopacity' property is a number and may be specified as: + - An int or float in the interval [0, 1] + + Returns + ------- + int|float + """ + return self["fgopacity"] + + @fgopacity.setter + def fgopacity(self, val): + self["fgopacity"] = val + + # fillmode + # -------- + @property + def fillmode(self): + """ + Determines whether `marker.color` should be used as a default + to `bgcolor` or a `fgcolor`. + + The 'fillmode' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['replace', 'overlay'] + + Returns + ------- + Any + """ + return self["fillmode"] + + @fillmode.setter + def fillmode(self, val): + self["fillmode"] = val + + # shape + # ----- + @property + def shape(self): + """ + Sets the shape of the pattern fill. By default, no pattern is + used for filling the area. + + The 'shape' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['', '/', '\\', 'x', '-', '|', '+', '.'] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + Any|numpy.ndarray + """ + return self["shape"] + + @shape.setter + def shape(self, val): + self["shape"] = val + + # shapesrc + # -------- + @property + def shapesrc(self): + """ + Sets the source reference on Chart Studio Cloud for `shape`. + + The 'shapesrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["shapesrc"] + + @shapesrc.setter + def shapesrc(self, val): + self["shapesrc"] = val + + # size + # ---- + @property + def size(self): + """ + Sets the size of unit squares of the pattern fill in pixels, + which corresponds to the interval of repetition of the pattern. + + The 'size' property is a number and may be specified as: + - An int or float in the interval [0, inf] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + int|float|numpy.ndarray + """ + return self["size"] + + @size.setter + def size(self, val): + self["size"] = val + + # sizesrc + # ------- + @property + def sizesrc(self): + """ + Sets the source reference on Chart Studio Cloud for `size`. + + The 'sizesrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["sizesrc"] + + @sizesrc.setter + def sizesrc(self, val): + self["sizesrc"] = val + + # solidity + # -------- + @property + def solidity(self): + """ + Sets the solidity of the pattern fill. Solidity is roughly the + fraction of the area filled by the pattern. Solidity of 0 shows + only the background color without pattern and solidty of 1 + shows only the foreground color without pattern. + + The 'solidity' property is a number and may be specified as: + - An int or float in the interval [0, 1] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + int|float|numpy.ndarray + """ + return self["solidity"] + + @solidity.setter + def solidity(self, val): + self["solidity"] = val + + # soliditysrc + # ----------- + @property + def soliditysrc(self): + """ + Sets the source reference on Chart Studio Cloud for `solidity`. + + The 'soliditysrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["soliditysrc"] + + @soliditysrc.setter + def soliditysrc(self, val): + self["soliditysrc"] = val + + # Self properties description + # --------------------------- + @property + def _prop_descriptions(self): + return """\ + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a `marker.color` + background when `fillmode` is "overlay". Otherwise, + defaults to a transparent background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud for + `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a `marker.color` + background when `fillmode` is "replace". Otherwise, + defaults to dark grey or white to increase contrast + with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud for + `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern fill. + Defaults to a 0.5 when `fillmode` is "overlay". + Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be used as a + default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, no + pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud for + `shape`. + size + Sets the size of unit squares of the pattern fill in + pixels, which corresponds to the interval of repetition + of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud for + `size`. + solidity + Sets the solidity of the pattern fill. Solidity is + roughly the fraction of the area filled by the pattern. + Solidity of 0 shows only the background color without + pattern and solidty of 1 shows only the foreground + color without pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud for + `solidity`. + """ + + def __init__( + self, + arg=None, + bgcolor=None, + bgcolorsrc=None, + fgcolor=None, + fgcolorsrc=None, + fgopacity=None, + fillmode=None, + shape=None, + shapesrc=None, + size=None, + sizesrc=None, + solidity=None, + soliditysrc=None, + **kwargs, + ): + """ + Construct a new Pattern object + + Sets the pattern within the marker. + + Parameters + ---------- + arg + dict of properties compatible with this constructor or + an instance of + :class:`plotly.graph_objs.sunburst.marker.Pattern` + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a `marker.color` + background when `fillmode` is "overlay". Otherwise, + defaults to a transparent background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud for + `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a `marker.color` + background when `fillmode` is "replace". Otherwise, + defaults to dark grey or white to increase contrast + with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud for + `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern fill. + Defaults to a 0.5 when `fillmode` is "overlay". + Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be used as a + default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, no + pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud for + `shape`. + size + Sets the size of unit squares of the pattern fill in + pixels, which corresponds to the interval of repetition + of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud for + `size`. + solidity + Sets the solidity of the pattern fill. Solidity is + roughly the fraction of the area filled by the pattern. + Solidity of 0 shows only the background color without + pattern and solidty of 1 shows only the foreground + color without pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud for + `solidity`. + + Returns + ------- + Pattern + """ + super(Pattern, self).__init__("pattern") + + 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.sunburst.marker.Pattern +constructor must be a dict or +an instance of :class:`plotly.graph_objs.sunburst.marker.Pattern`""" + ) + + # 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("bgcolor", None) + _v = bgcolor if bgcolor is not None else _v + if _v is not None: + self["bgcolor"] = _v + _v = arg.pop("bgcolorsrc", None) + _v = bgcolorsrc if bgcolorsrc is not None else _v + if _v is not None: + self["bgcolorsrc"] = _v + _v = arg.pop("fgcolor", None) + _v = fgcolor if fgcolor is not None else _v + if _v is not None: + self["fgcolor"] = _v + _v = arg.pop("fgcolorsrc", None) + _v = fgcolorsrc if fgcolorsrc is not None else _v + if _v is not None: + self["fgcolorsrc"] = _v + _v = arg.pop("fgopacity", None) + _v = fgopacity if fgopacity is not None else _v + if _v is not None: + self["fgopacity"] = _v + _v = arg.pop("fillmode", None) + _v = fillmode if fillmode is not None else _v + if _v is not None: + self["fillmode"] = _v + _v = arg.pop("shape", None) + _v = shape if shape is not None else _v + if _v is not None: + self["shape"] = _v + _v = arg.pop("shapesrc", None) + _v = shapesrc if shapesrc is not None else _v + if _v is not None: + self["shapesrc"] = _v + _v = arg.pop("size", None) + _v = size if size is not None else _v + if _v is not None: + self["size"] = _v + _v = arg.pop("sizesrc", None) + _v = sizesrc if sizesrc is not None else _v + if _v is not None: + self["sizesrc"] = _v + _v = arg.pop("solidity", None) + _v = solidity if solidity is not None else _v + if _v is not None: + self["solidity"] = _v + _v = arg.pop("soliditysrc", None) + _v = soliditysrc if soliditysrc is not None else _v + if _v is not None: + self["soliditysrc"] = _v + + # Process unknown kwargs + # ---------------------- + self._process_kwargs(**dict(arg, **kwargs)) + + # Reset skip_invalid + # ------------------ + self._skip_invalid = False diff --git a/packages/python/plotly/plotly/graph_objs/surface/_colorbar.py b/packages/python/plotly/plotly/graph_objs/surface/_colorbar.py index ab42bc3b38a..05f0e89d07d 100644 --- a/packages/python/plotly/plotly/graph_objs/surface/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/surface/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1309,12 +1311,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1370,17 +1376,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1436,6 +1469,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1646,9 +1702,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1658,10 +1719,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1671,6 +1741,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1727,9 +1801,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1946,9 +2022,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1958,10 +2039,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1971,6 +2061,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2189,6 +2283,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2201,6 +2299,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/treemap/_marker.py b/packages/python/plotly/plotly/graph_objs/treemap/_marker.py index 6a2683be9ec..ebc8d64de94 100644 --- a/packages/python/plotly/plotly/graph_objs/treemap/_marker.py +++ b/packages/python/plotly/plotly/graph_objs/treemap/_marker.py @@ -23,6 +23,7 @@ class Marker(_BaseTraceHierarchyType): "depthfade", "line", "pad", + "pattern", "reversescale", "showscale", } @@ -416,9 +417,15 @@ def colorbar(self): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -428,10 +435,20 @@ def colorbar(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -441,6 +458,10 @@ def colorbar(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. Returns ------- @@ -663,6 +684,80 @@ def pad(self): def pad(self, val): self["pad"] = val + # pattern + # ------- + @property + def pattern(self): + """ + Sets the pattern within the marker. + + The 'pattern' property is an instance of Pattern + that may be specified as: + - An instance of :class:`plotly.graph_objs.treemap.marker.Pattern` + - A dict of string/value properties that will be passed + to the Pattern constructor + + Supported dict properties: + + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "overlay". Otherwise, defaults to a transparent + background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud + for `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud + for `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern + fill. Defaults to a 0.5 when `fillmode` is + "overlay". Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be + used as a default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, + no pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud + for `shape`. + size + Sets the size of unit squares of the pattern + fill in pixels, which corresponds to the + interval of repetition of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud + for `size`. + solidity + Sets the solidity of the pattern fill. Solidity + is roughly the fraction of the area filled by + the pattern. Solidity of 0 shows only the + background color without pattern and solidty of + 1 shows only the foreground color without + pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud + for `solidity`. + + Returns + ------- + plotly.graph_objs.treemap.marker.Pattern + """ + return self["pattern"] + + @pattern.setter + def pattern(self, val): + self["pattern"] = val + # reversescale # ------------ @property @@ -794,6 +889,8 @@ def _prop_descriptions(self): pad :class:`plotly.graph_objects.treemap.marker.Pad` instance or dict with compatible properties + pattern + Sets the pattern within the marker. reversescale Reverses the color mapping if true. Has an effect only if colors is set to a numerical array. If true, @@ -823,6 +920,7 @@ def __init__( depthfade=None, line=None, pad=None, + pattern=None, reversescale=None, showscale=None, **kwargs, @@ -917,6 +1015,8 @@ def __init__( pad :class:`plotly.graph_objects.treemap.marker.Pad` instance or dict with compatible properties + pattern + Sets the pattern within the marker. reversescale Reverses the color mapping if true. Has an effect only if colors is set to a numerical array. If true, @@ -1017,6 +1117,10 @@ def __init__( _v = pad if pad is not None else _v if _v is not None: self["pad"] = _v + _v = arg.pop("pattern", None) + _v = pattern if pattern is not None else _v + if _v is not None: + self["pattern"] = _v _v = arg.pop("reversescale", None) _v = reversescale if reversescale is not None else _v if _v is not None: diff --git a/packages/python/plotly/plotly/graph_objs/treemap/marker/__init__.py b/packages/python/plotly/plotly/graph_objs/treemap/marker/__init__.py index 8b73e6ddbd3..a8a98bb5ff6 100644 --- a/packages/python/plotly/plotly/graph_objs/treemap/marker/__init__.py +++ b/packages/python/plotly/plotly/graph_objs/treemap/marker/__init__.py @@ -5,10 +5,13 @@ from ._colorbar import ColorBar from ._line import Line from ._pad import Pad + from ._pattern import Pattern from . import colorbar else: from _plotly_utils.importers import relative_import __all__, __getattr__, __dir__ = relative_import( - __name__, [".colorbar"], ["._colorbar.ColorBar", "._line.Line", "._pad.Pad"] + __name__, + [".colorbar"], + ["._colorbar.ColorBar", "._line.Line", "._pad.Pad", "._pattern.Pattern"], ) diff --git a/packages/python/plotly/plotly/graph_objs/treemap/marker/_colorbar.py b/packages/python/plotly/plotly/graph_objs/treemap/marker/_colorbar.py index fcee9254d69..4c58b928d3d 100644 --- a/packages/python/plotly/plotly/graph_objs/treemap/marker/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/treemap/marker/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1310,12 +1312,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1371,17 +1377,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1437,6 +1470,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1647,9 +1703,14 @@ def _prop_descriptions(self): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1659,10 +1720,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1672,6 +1742,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1728,9 +1802,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1947,9 +2023,14 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1959,10 +2040,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1972,6 +2062,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2190,6 +2284,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2202,6 +2300,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/graph_objs/treemap/marker/_pattern.py b/packages/python/plotly/plotly/graph_objs/treemap/marker/_pattern.py new file mode 100644 index 00000000000..a5f40d53878 --- /dev/null +++ b/packages/python/plotly/plotly/graph_objs/treemap/marker/_pattern.py @@ -0,0 +1,580 @@ +from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType +import copy as _copy + + +class Pattern(_BaseTraceHierarchyType): + + # class properties + # -------------------- + _parent_path_str = "treemap.marker" + _path_str = "treemap.marker.pattern" + _valid_props = { + "bgcolor", + "bgcolorsrc", + "fgcolor", + "fgcolorsrc", + "fgopacity", + "fillmode", + "shape", + "shapesrc", + "size", + "sizesrc", + "solidity", + "soliditysrc", + } + + # bgcolor + # ------- + @property + def bgcolor(self): + """ + When there is no colorscale sets the color of background + pattern fill. Defaults to a `marker.color` background when + `fillmode` is "overlay". Otherwise, defaults to a transparent + background. + + 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 + - A list or array of any of the above + + Returns + ------- + str|numpy.ndarray + """ + return self["bgcolor"] + + @bgcolor.setter + def bgcolor(self, val): + self["bgcolor"] = val + + # bgcolorsrc + # ---------- + @property + def bgcolorsrc(self): + """ + Sets the source reference on Chart Studio Cloud for `bgcolor`. + + The 'bgcolorsrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["bgcolorsrc"] + + @bgcolorsrc.setter + def bgcolorsrc(self, val): + self["bgcolorsrc"] = val + + # fgcolor + # ------- + @property + def fgcolor(self): + """ + When there is no colorscale sets the color of foreground + pattern fill. Defaults to a `marker.color` background when + `fillmode` is "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + + The 'fgcolor' 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 + - A list or array of any of the above + + Returns + ------- + str|numpy.ndarray + """ + return self["fgcolor"] + + @fgcolor.setter + def fgcolor(self, val): + self["fgcolor"] = val + + # fgcolorsrc + # ---------- + @property + def fgcolorsrc(self): + """ + Sets the source reference on Chart Studio Cloud for `fgcolor`. + + The 'fgcolorsrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["fgcolorsrc"] + + @fgcolorsrc.setter + def fgcolorsrc(self, val): + self["fgcolorsrc"] = val + + # fgopacity + # --------- + @property + def fgopacity(self): + """ + Sets the opacity of the foreground pattern fill. Defaults to a + 0.5 when `fillmode` is "overlay". Otherwise, defaults to 1. + + The 'fgopacity' property is a number and may be specified as: + - An int or float in the interval [0, 1] + + Returns + ------- + int|float + """ + return self["fgopacity"] + + @fgopacity.setter + def fgopacity(self, val): + self["fgopacity"] = val + + # fillmode + # -------- + @property + def fillmode(self): + """ + Determines whether `marker.color` should be used as a default + to `bgcolor` or a `fgcolor`. + + The 'fillmode' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['replace', 'overlay'] + + Returns + ------- + Any + """ + return self["fillmode"] + + @fillmode.setter + def fillmode(self, val): + self["fillmode"] = val + + # shape + # ----- + @property + def shape(self): + """ + Sets the shape of the pattern fill. By default, no pattern is + used for filling the area. + + The 'shape' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['', '/', '\\', 'x', '-', '|', '+', '.'] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + Any|numpy.ndarray + """ + return self["shape"] + + @shape.setter + def shape(self, val): + self["shape"] = val + + # shapesrc + # -------- + @property + def shapesrc(self): + """ + Sets the source reference on Chart Studio Cloud for `shape`. + + The 'shapesrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["shapesrc"] + + @shapesrc.setter + def shapesrc(self, val): + self["shapesrc"] = val + + # size + # ---- + @property + def size(self): + """ + Sets the size of unit squares of the pattern fill in pixels, + which corresponds to the interval of repetition of the pattern. + + The 'size' property is a number and may be specified as: + - An int or float in the interval [0, inf] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + int|float|numpy.ndarray + """ + return self["size"] + + @size.setter + def size(self, val): + self["size"] = val + + # sizesrc + # ------- + @property + def sizesrc(self): + """ + Sets the source reference on Chart Studio Cloud for `size`. + + The 'sizesrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["sizesrc"] + + @sizesrc.setter + def sizesrc(self, val): + self["sizesrc"] = val + + # solidity + # -------- + @property + def solidity(self): + """ + Sets the solidity of the pattern fill. Solidity is roughly the + fraction of the area filled by the pattern. Solidity of 0 shows + only the background color without pattern and solidty of 1 + shows only the foreground color without pattern. + + The 'solidity' property is a number and may be specified as: + - An int or float in the interval [0, 1] + - A tuple, list, or one-dimensional numpy array of the above + + Returns + ------- + int|float|numpy.ndarray + """ + return self["solidity"] + + @solidity.setter + def solidity(self, val): + self["solidity"] = val + + # soliditysrc + # ----------- + @property + def soliditysrc(self): + """ + Sets the source reference on Chart Studio Cloud for `solidity`. + + The 'soliditysrc' property must be specified as a string or + as a plotly.grid_objs.Column object + + Returns + ------- + str + """ + return self["soliditysrc"] + + @soliditysrc.setter + def soliditysrc(self, val): + self["soliditysrc"] = val + + # Self properties description + # --------------------------- + @property + def _prop_descriptions(self): + return """\ + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a `marker.color` + background when `fillmode` is "overlay". Otherwise, + defaults to a transparent background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud for + `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a `marker.color` + background when `fillmode` is "replace". Otherwise, + defaults to dark grey or white to increase contrast + with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud for + `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern fill. + Defaults to a 0.5 when `fillmode` is "overlay". + Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be used as a + default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, no + pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud for + `shape`. + size + Sets the size of unit squares of the pattern fill in + pixels, which corresponds to the interval of repetition + of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud for + `size`. + solidity + Sets the solidity of the pattern fill. Solidity is + roughly the fraction of the area filled by the pattern. + Solidity of 0 shows only the background color without + pattern and solidty of 1 shows only the foreground + color without pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud for + `solidity`. + """ + + def __init__( + self, + arg=None, + bgcolor=None, + bgcolorsrc=None, + fgcolor=None, + fgcolorsrc=None, + fgopacity=None, + fillmode=None, + shape=None, + shapesrc=None, + size=None, + sizesrc=None, + solidity=None, + soliditysrc=None, + **kwargs, + ): + """ + Construct a new Pattern object + + Sets the pattern within the marker. + + Parameters + ---------- + arg + dict of properties compatible with this constructor or + an instance of + :class:`plotly.graph_objs.treemap.marker.Pattern` + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a `marker.color` + background when `fillmode` is "overlay". Otherwise, + defaults to a transparent background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud for + `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a `marker.color` + background when `fillmode` is "replace". Otherwise, + defaults to dark grey or white to increase contrast + with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud for + `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern fill. + Defaults to a 0.5 when `fillmode` is "overlay". + Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be used as a + default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, no + pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud for + `shape`. + size + Sets the size of unit squares of the pattern fill in + pixels, which corresponds to the interval of repetition + of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud for + `size`. + solidity + Sets the solidity of the pattern fill. Solidity is + roughly the fraction of the area filled by the pattern. + Solidity of 0 shows only the background color without + pattern and solidty of 1 shows only the foreground + color without pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud for + `solidity`. + + Returns + ------- + Pattern + """ + super(Pattern, self).__init__("pattern") + + 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.treemap.marker.Pattern +constructor must be a dict or +an instance of :class:`plotly.graph_objs.treemap.marker.Pattern`""" + ) + + # 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("bgcolor", None) + _v = bgcolor if bgcolor is not None else _v + if _v is not None: + self["bgcolor"] = _v + _v = arg.pop("bgcolorsrc", None) + _v = bgcolorsrc if bgcolorsrc is not None else _v + if _v is not None: + self["bgcolorsrc"] = _v + _v = arg.pop("fgcolor", None) + _v = fgcolor if fgcolor is not None else _v + if _v is not None: + self["fgcolor"] = _v + _v = arg.pop("fgcolorsrc", None) + _v = fgcolorsrc if fgcolorsrc is not None else _v + if _v is not None: + self["fgcolorsrc"] = _v + _v = arg.pop("fgopacity", None) + _v = fgopacity if fgopacity is not None else _v + if _v is not None: + self["fgopacity"] = _v + _v = arg.pop("fillmode", None) + _v = fillmode if fillmode is not None else _v + if _v is not None: + self["fillmode"] = _v + _v = arg.pop("shape", None) + _v = shape if shape is not None else _v + if _v is not None: + self["shape"] = _v + _v = arg.pop("shapesrc", None) + _v = shapesrc if shapesrc is not None else _v + if _v is not None: + self["shapesrc"] = _v + _v = arg.pop("size", None) + _v = size if size is not None else _v + if _v is not None: + self["size"] = _v + _v = arg.pop("sizesrc", None) + _v = sizesrc if sizesrc is not None else _v + if _v is not None: + self["sizesrc"] = _v + _v = arg.pop("solidity", None) + _v = solidity if solidity is not None else _v + if _v is not None: + self["solidity"] = _v + _v = arg.pop("soliditysrc", None) + _v = soliditysrc if soliditysrc is not None else _v + if _v is not None: + self["soliditysrc"] = _v + + # Process unknown kwargs + # ---------------------- + self._process_kwargs(**dict(arg, **kwargs)) + + # Reset skip_invalid + # ------------------ + self._skip_invalid = False diff --git a/packages/python/plotly/plotly/graph_objs/volume/_colorbar.py b/packages/python/plotly/plotly/graph_objs/volume/_colorbar.py index f753cfe3648..faf2a983cd4 100644 --- a/packages/python/plotly/plotly/graph_objs/volume/_colorbar.py +++ b/packages/python/plotly/plotly/graph_objs/volume/_colorbar.py @@ -55,9 +55,11 @@ class ColorBar(_BaseTraceHierarchyType): "x", "xanchor", "xpad", + "xref", "y", "yanchor", "ypad", + "yref", } # bgcolor @@ -1309,12 +1311,16 @@ def titleside(self, val): @property def x(self): """ - Sets the x position of the color bar (in plot fraction). - Defaults to 1.02 when `orientation` is "v" and 0.5 when - `orientation` is "h". + Sets the x position with respect to `xref` of the color bar (in + plot fraction). When `xref` is "paper", defaults to 1.02 when + `orientation` is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when `orientation` is "v" + and 0.5 when `orientation` is "h". Must be between 0 and 1 if + `xref` is "container" and between "-2" and 3 if `xref` is + "paper". The 'x' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1370,17 +1376,44 @@ def xpad(self): def xpad(self, val): self["xpad"] = val + # xref + # ---- + @property + def xref(self): + """ + Sets the container `x` refers to. "container" spans the entire + `width` of the plot. "paper" refers to the width of the + plotting area only. + + The 'xref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["xref"] + + @xref.setter + def xref(self, val): + self["xref"] = val + # y # - @property def y(self): """ - Sets the y position of the color bar (in plot fraction). - Defaults to 0.5 when `orientation` is "v" and 1.02 when - `orientation` is "h". + Sets the y position with respect to `yref` of the color bar (in + plot fraction). When `yref` is "paper", defaults to 0.5 when + `orientation` is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when `orientation` is + "v" and 1 when `orientation` is "h". Must be between 0 and 1 if + `yref` is "container" and between "-2" and 3 if `yref` is + "paper". The 'y' property is a number and may be specified as: - - An int or float in the interval [-2, 3] + - An int or float Returns ------- @@ -1436,6 +1469,29 @@ def ypad(self): def ypad(self, val): self["ypad"] = val + # yref + # ---- + @property + def yref(self): + """ + Sets the container `y` refers to. "container" spans the entire + `height` of the plot. "paper" refers to the height of the + plotting area only. + + The 'yref' property is an enumeration that may be specified as: + - One of the following enumeration values: + ['container', 'paper'] + + Returns + ------- + Any + """ + return self["yref"] + + @yref.setter + def yref(self, val): + self["yref"] = val + # Self properties description # --------------------------- @property @@ -1646,9 +1702,14 @@ def _prop_descriptions(self): used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1658,10 +1719,19 @@ def _prop_descriptions(self): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1671,6 +1741,10 @@ def _prop_descriptions(self): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. """ _mapped_properties = { @@ -1727,9 +1801,11 @@ def __init__( x=None, xanchor=None, xpad=None, + xref=None, y=None, yanchor=None, ypad=None, + yref=None, **kwargs, ): """ @@ -1946,9 +2022,14 @@ def __init__( used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` is "v" - and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of the color + bar (in plot fraction). When `xref` is "paper", + defaults to 1.02 when `orientation` is "v" and 0.5 when + `orientation` is "h". When `xref` is "container", + defaults to 1 when `orientation` is "v" and 0.5 when + `orientation` is "h". Must be between 0 and 1 if `xref` + is "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to the "left", "center" @@ -1958,10 +2039,19 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" spans the + entire `width` of the plot. "paper" refers to the width + of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` is "v" - and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of the color + bar (in plot fraction). When `yref` is "paper", + defaults to 0.5 when `orientation` is "v" and 1.02 when + `orientation` is "h". When `yref` is "container", + defaults to 0.5 when `orientation` is "v" and 1 when + `orientation` is "h". Must be between 0 and 1 if `yref` + is "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the "top", "middle" or @@ -1971,6 +2061,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" spans the + entire `height` of the plot. "paper" refers to the + height of the plotting area only. Returns ------- @@ -2189,6 +2283,10 @@ def __init__( _v = xpad if xpad is not None else _v if _v is not None: self["xpad"] = _v + _v = arg.pop("xref", None) + _v = xref if xref is not None else _v + if _v is not None: + self["xref"] = _v _v = arg.pop("y", None) _v = y if y is not None else _v if _v is not None: @@ -2201,6 +2299,10 @@ def __init__( _v = ypad if ypad is not None else _v if _v is not None: self["ypad"] = _v + _v = arg.pop("yref", None) + _v = yref if yref is not None else _v + if _v is not None: + self["yref"] = _v # Process unknown kwargs # ---------------------- diff --git a/packages/python/plotly/plotly/io/_json.py b/packages/python/plotly/plotly/io/_json.py index ae9935b1dda..26ea14e063e 100644 --- a/packages/python/plotly/plotly/io/_json.py +++ b/packages/python/plotly/plotly/io/_json.py @@ -57,6 +57,25 @@ def coerce_to_strict(const): return const +_swap_json = ( + ("<", "\\u003c"), + (">", "\\u003e"), + ("/", "\\u002f"), +) +_swap_orjson = _swap_json + ( + ("\u2028", "\\u2028"), + ("\u2029", "\\u2029"), +) + + +def _safe(json_str, _swap): + out = json_str + for unsafe_char, safe_char in _swap: + if unsafe_char in out: + out = out.replace(unsafe_char, safe_char) + return out + + def to_json_plotly(plotly_object, pretty=False, engine=None): """ Convert a plotly/Dash object to a JSON string representation @@ -120,7 +139,9 @@ def to_json_plotly(plotly_object, pretty=False, engine=None): from _plotly_utils.utils import PlotlyJSONEncoder - return json.dumps(plotly_object, cls=PlotlyJSONEncoder, **opts) + return _safe( + json.dumps(plotly_object, cls=PlotlyJSONEncoder, **opts), _swap_json + ) elif engine == "orjson": JsonConfig.validate_orjson() opts = orjson.OPT_NON_STR_KEYS | orjson.OPT_SERIALIZE_NUMPY @@ -136,7 +157,9 @@ def to_json_plotly(plotly_object, pretty=False, engine=None): # Try without cleaning try: - return orjson.dumps(plotly_object, option=opts).decode("utf8") + return _safe( + orjson.dumps(plotly_object, option=opts).decode("utf8"), _swap_orjson + ) except TypeError: pass @@ -146,7 +169,7 @@ def to_json_plotly(plotly_object, pretty=False, engine=None): datetime_allowed=True, modules=modules, ) - return orjson.dumps(cleaned, option=opts).decode("utf8") + return _safe(orjson.dumps(cleaned, option=opts).decode("utf8"), _swap_orjson) def to_json(fig, validate=True, pretty=False, remove_uids=True, engine=None): diff --git a/packages/python/plotly/plotly/io/_renderers.py b/packages/python/plotly/plotly/io/_renderers.py index 3d0dd979c89..cf2434036f8 100644 --- a/packages/python/plotly/plotly/io/_renderers.py +++ b/packages/python/plotly/plotly/io/_renderers.py @@ -525,13 +525,15 @@ def show(fig, renderer=None, validate=True, **kwargs): else: # If ipython isn't available, try to display figures in the default # browser - import webbrowser - try: + import webbrowser + webbrowser.get() default_renderer = "browser" - except webbrowser.Error: - # Default browser could not be loaded + except Exception: + # Many things could have gone wrong + # There could not be a webbrowser Python module, + # or the module may be a dumb placeholder pass renderers.render_on_display = True diff --git a/packages/python/plotly/plotly/matplotlylib/mplexporter/renderers/vega_renderer.py b/packages/python/plotly/plotly/matplotlylib/mplexporter/renderers/vega_renderer.py index d7dd171b4e2..eab02e1f329 100644 --- a/packages/python/plotly/plotly/matplotlylib/mplexporter/renderers/vega_renderer.py +++ b/packages/python/plotly/plotly/matplotlylib/mplexporter/renderers/vega_renderer.py @@ -23,8 +23,18 @@ def open_axes(self, ax, props): dict(type="y", scale="y", ticks=10), ] self.scales = [ - dict(name="x", domain=props["xlim"], type="linear", range="width",), - dict(name="y", domain=props["ylim"], type="linear", range="height",), + dict( + name="x", + domain=props["xlim"], + type="linear", + range="width", + ), + dict( + name="y", + domain=props["ylim"], + type="linear", + range="height", + ), ] def draw_line(self, data, coordinates, style, label, mplobj=None): @@ -103,7 +113,7 @@ def __init__(self, renderer): def html(self): """Build the HTML representation for IPython.""" - id = random.randint(0, 2 ** 16) + id = random.randint(0, 2**16) html = '
' % id html += "\u2028\u2029"}} + fig = go.Figure(layout=layout) + fig_json = pio.to_json_plotly(fig, engine=engine) + layout_2 = json.loads(fig_json)["layout"] + del layout_2["template"] + + assert layout == layout_2 + + replacements = { + "<": "\\u003c", + ">": "\\u003e", + "/": "\\u002f", + "\u2028": "\\u2028", + "\u2029": "\\u2029", + } + + for bad, good in replacements.items(): + assert bad not in fig_json + assert good in fig_json diff --git a/packages/python/plotly/plotly/tests/test_orca/images/linux/fig1.eps b/packages/python/plotly/plotly/tests/test_orca/images/linux/fig1.eps index 4759ec847a1..2fdbaa3d65c 100644 --- a/packages/python/plotly/plotly/tests/test_orca/images/linux/fig1.eps +++ b/packages/python/plotly/plotly/tests/test_orca/images/linux/fig1.eps @@ -1,5 +1,5 @@ %!PS-Adobe-3.0 EPSF-3.0 -%Produced by poppler pdftops version: 0.71.0 (http://poppler.freedesktop.org) +%Produced by poppler pdftops version: 22.02.0 (http://poppler.freedesktop.org) %%Creator: Chromium %%LanguageLevel: 2 %%DocumentSuppliedResources: (atend) @@ -517,924 +517,1036 @@ V&F?Q)R6C_nZa#f[2X+r)mR'qn\H2"`>im>*3ma.n^/@3eK&Y_*O4E@n_kNDjW8F+ nhD@E2'[-%,I0HWnj+NV73lnF,dL,inkg\g<@)Zg-*gf&nmNk#AL;G3-F.J8no6$4 FXM3T-aJ.Jnpr2EKd^tu.'eg\nrY@VPppaA.C,Knnt@NgV(-Mb.^H0+o!']#[4?:. /$ci=o"ck4`@Q&O/@*MOo$K$EeLbgp/[F1ao&22VjXtT<0!ajso'n@goe1@]0=(O0 -o)UO$"Yb!(0XD3Bo+<]5'esbI0s_lTo-#kF,q4E-*Pq^p6'<>KN"U^@(SM*ViH>b5 -rYPYI+5rY&+oWK*XrlWn*qLa:o,8\Ojr`Q`(ubH0JM&&'@L[nf&YN#Di$s#\'r'&\-Zi;s(%eNL8E5dT)bi<04u -rY6Qk+5tE^1\!dehB/Hg4s?dFi@kN.J--Jp5a2dHoK>=1&-O0U'nFCfJc@f2,t2js -*FZ?3TaO5pAOI5F5_0s[Jc6O<6m(CQ*OJs>o"l<=@NXPU#*`mooP$dG#t'7u5N1*2 -'S/k3\f"p<8JFNae?BpDRn?Yj.l=4u'U)/]_a(T:9<__CeBpuIeP1/=9si_No\iP% -j\Bp^::0C`o^P^6ohT]*:UL'ro`7lH"]0=J:pga/oat%Y'iB)k;7.EAoc[3j,uSk7 -;RJ)SoeBB&2,eWX;mebeog)P779"D$<4,G"ohe^HPHV-8#@;/R7T[BWpn -[9Ida>ID.Kotalj`E[Q->d_g]p!I&&eQm=NU/>-[UEb@AS'G,Ai=F:G&:kMEG'H5B=;qqep1p% -KkNB$BGQS@G)p=FO_K!(Bss4>p6fY2SSC'^C3H^oKmIj_f7s*[.a)609%N9lDr`)*pk:JK75qoi@Ca<`Ss5 -QP"3r'leF8=VeVbQQ^-g-#rZ,E]5FfpFUGF.s#nhF-eb*[m>*07<@'PF>lj7G>33= -;0@(YFgk@nf3*7jAS--*::/7IoBIFVhAfU>GC`d'a'Q^rF]TmCpTHFK_sf;X)j[Dqp(d\->iFj=lAe#\IE4IMAiD'b(rYFG`GnXd*@-A]k+pMKT&:cF%\CE_c -+9h@M(1I1`_;:S?H^HgCSU'%^\`'*Ijdl51SiQ&,qY4cllY2Z'`n:S_8%/Oj;f/Q+5r,Y37F[L98;/AWI#)R>7mj(&$]=PZ$RLr -]-4GK-*d=pZ8qTWd2,6frY0m^Z[4d.RfdW'!!33$X[2uaZVh^Y3CQ7,28S8l]2LmL -jrIm>YG(e7Jdrh&a0`0o30j#nRlre'iC-=`ZFc+%Rut#2Q+6^X\N?4iqjk;[S%Af%=59[JM[Wg7l6ok&R)`Hie=RW7M.[J"S[b;'0A#/iZ-'_]"@@@ ->OT.mn\9GD^Us*Pqt\#HrP1E,](#0l)3,KF'>\*E?Md)jQt@H!9FDgd_OMqpoY)du -E">877eoKVq@]+l"iPcp^jJkpS57)9;8mo_`Oo-gqLQH/iN,-'+5qe`HbW$T+q^=" -'VMNY+a+CTs2$l>+5qqdg!?3pBL`S?m'r11tmS'$,Pb+,Dr59]T2O9l2qd\.$`Td -cok%Or;kFh:";C0eU:`R>QrJnZ(V2I&AeCtZhaoSaZu=cR6]f`rG3E=F>)U?'ES1H -+G!l#('L,77Qk`bWDD(c>M<@ig3p*W]s6:^[G(SgNa63'3(t7lDkhk.f5q?3i*4S+ -IMC_JY57]CiKP">Op>,X(4CWOoIcB!]AJ%Ihn?ARh>,t-"lMQNe\/^'JasknoGmiH -iLs3YrQGgP"f,HRPBf2EJYX#a=[\d;'nF:GiTM;=7Gtlbi#YVR^/U0[8rXtlDgsck;62hf(D*N*U1gJZ"4ic$'/S@Ak;3RZ413YUII^Z\KYq%4 -JNr]h_g$`C%Di(u#qtdt7IXYUn39Y>Io#^O;6c`$"M+iFqJEV[^$O4kf:b;54+kEq -J*T_iF,PbrBF\BX5@KI=1U`GG=7opgofo#CJ"QPOU&'$&orpUC)pdn8fC@A2 -V&bjDrB;>#1c[?lV=Y?b>6CRMs0^hclcC+BT;2BMiVn>'rkIRohs#OgXTQ;a&\;?m -#b_q0rXONGTWiZ?-5d)E6K.54;uP_;ME.O?VRFirZa]3T=k9@_nnH+mYSfGj5h!JJ9tE>X(( -)]=LPipk\AL//nVa^qcGI+DpjR*TC9q:u797A\AqoU:atVcg(PC:5&:Nk].ZY&3nP -S_!7T^#*c'*$,n,M8eLpq&Gu-0:C)JF8?muQVXU2lZN(FT%@nkh=#Rc*Zl2ZalW,> -r>qS4YFsNP^XVA;LWe^?'[>V.O4WM&P8YP*\S2%/:^R,C)NSDAPT0lVr_a)A`$1]b -_En0<(Jn'e%7>*q3tF^GlY>-AD4F627+!8U'h'if;&;Z@Hs7FWEKk5U`pojE)b2XD -G99=Q"FD93ne?u#`"GJ%,tW,fRjUeuKVKtgEho`d9(Kp,/PC-F].ZhK"N)rfF!SpZ -UIY-E:*8U!'*gi7ga)ko8,5h0+6D_mJ!kunbj`+7o^778\/<)b2>T -1l"Y#1o,t$;KTT&9N-&`4&",qjZu[A2'kak<)l@[<7LHO+'2J8Kk"7dFerkXuu11HXBkJ"bU5cFsVrcRW,Vg$_QRdAq,rZ<=(\4W%f>/:%lLHJ"*;=MWL=]mB['0 -i9d=o'LIBME#?Xkr-qr&L#[GbBjFkgPq@"QHR?qBD#6]N[;C8&gUD%sL>u__L1Qujg)86lT'p2,.rF%=J]<22a+!*L*bS(D -T>pI!;LI/cjeFPS<>cuRrT>M"#rLL]"\ -IA^l8G5]I&h03R!N(UecdJjPlH$&(6fsF%]J"Ht4GbeI)q._tcLj:Nl+6GjDkBh[> -?.F'^#>t#t_D=Mm<74 -K7")PY>cL&p2E78aErahXEP-H!Yn6%jFMnJ(I9cpi7okhNKLV>6[3_n@t\oY1"&'P -=RdEle96n8ja>)4!?bneK92636V)J7,%OZ2A+).9%`obVa*?Pbi^=VP7A`A=f`)O+ -L/(>)3^:WWYE=L,/BSP3#,#GK+%+m_b4pl9j7K[D;V"%TBk]0\e@Cp/ia4^V@5):- -_jHW'@n_0111jM/Q3,]#/FZ^t*.WSA;IKih&D8=a'\]%/jEaL^j>nXG`"FaX7=nSb -jQ:"=HaI'el*cE@a?0%=>F=b.#sF5?k5nUU4'f -d+Wh5M`ED3_H9Q.^@NU&I2FC2=It)GH6l;EsM5V@*%HNXMNX5K"rf -R_oP(O86J/Y*)em='!i,HVJZ9[Fr0YDXUWLVg*+pj1L_Eo3QdkHJ4,Qp0IR-G-G!R_3cGP@([S6?Od:WQraZ( -Hng@pef2M^Jr^8#\j,]co=7c!q^5$n7>6IG`KkE5dD;l@nVI2X5fp^A@K%k]bpUE= -o]KX&JV5co'$-IG,31kGP"_`:adG(8AGi-cEgBY4,JJ#R0cWFK_#J`3q$;d!.25-g -rtf,C$,KlfFpH<0Uq1CK3K@$&'6YLl[ -U3'?/5i_c[$g[mSEBTW.!e_r!>DlT?+NY9arL_>CBH5(fko0CO;\e*hWcS0?coSX9 -C@,0)jkcodRb(bZI;uE4f"4dhm!LcIh68dKW!dlqS5K_,Z<KDoET=5[[]nMTb?401]=9cmiS91&D/OdL\p%3@h4(lt)s\V2`.0Mt>LRlQX-odN -pmVP!r-"(erP1Aj\[Qn=p+2@+QlotVM^.S9memC$G8CqP>ZYq8IOW8rZ$PCLGE6bC -6-+`nT#MrH3.K_D^N+Z'd-5$g:%f8@'d-nk -%R^4(FY"!Lqj0nBSKkaj54@=Zl[s*DE%IJ'"[$[U]PKZ&+Mmu -;qR`3A9Di%nMUrOllWOMe2hi1!^GWsQ*rj9ds%umhL/J'omWa`H;@u9I@%;6T%D^H -mS1+0JckOW`eh]$*Ah7*[j-O(CpP6S8&1&l5K!DENitkb4sb@ET3'WmIp;Vq\(^]d -8*U!P_>&Krj8>O6k.N2o-,a1=pSlA>Ahi!uDp2U"^CuBA&cW,EB+!Mo^[iogmD'+t -^`2],/-/!m!Z6"Y^g%(/C^34Q#X8-c#P_;O$jo8,$EU8bYrG@,^jh*+<^?Qo_#Sts -,R4P;?_YB,\StAsF+cf9K>9Se5YN(]6lSF^)neo^6/3MIllSOk+>cDc]UMHX_j;d0 -'SXUl/:,CS#`lchD)lSt1H[$4j;^M!)T'E4_V?_0lNtG00LH7'6Q@jK.\J1\ItmH# -_b;r'RWH5YBa"J`4G5`4PF8t_1C3m$_mDKM,0LcfJ%Z6;_oc&toI`JS6ps.+6o7@j -S3fVk848D.7%?jlZ6c)Fk+ltm_E89`1>mg>%>X^c.]c7!>/rU#b641M^2rK`F8Np+ -2ahIN`(X<&XBJ'*=e?C17GM3%nU -ZA^DpFpShk]4,P?e$DQe'?:N%80!1O/9/`fJdVF+86gm?CkkQ/L^jg>L+#WKr/+%P -MM/=%`9SA.\6K-b*6A>E_PE!E.liC[=+`i#VQ1B:@E=-Q*_@gUa@)If4I\l8S4TfP -M`dD!m%6lITLoWHP=*^-U(&HnGo:[!K_r_B,bYNRN\#7BYr`pLHeh;>gW@sI8\D1I -goj?8eOmcb9,t61/@.Pd+h0UdW8`V(jD,(Ui6.!X&1k/F*'c+`M6T+W^T>#:XKY=X -^e4O?bP]1J`4jGX`(WkD9Nu[&n:/DVa2M;".0QH&H79*rT$5*E9Zr(4@$E4tbchHg -S&B/;n[D1;e4^k49J"]<@g1+6fM.=X9q9oj.HgqC1'da4*.5ncZJ^HuMM?pd_'j"l -W1u#q,/lsZ#W)ERga*4'=3`Oi9l0)h>jBRUlqY*fcBR`lm-d^In0e!I*`->LUG552 -Y,Zgh.a)6r#bsS1ZmsfDKN$sC_bEpHN6]r=:Yb<_jS_m?5u5H#:`TU6/H[*D.i2%e -OC\S:&IQeHKWIJud$Y6)jTCB]oM:_5M6ZE(Pm`t4s3V8T;&oX6'bZsp&(+)d;-ar7 -Br%1AkW(_::I'U^QpMb=qU'8^"jfHC9/*ntXA4`q(&\eD/J:r='@KT#$_8HhD'r50 --rPn)0DmmqC/E9.3RI*P/CD:3OJYg+X>tD!3rL,JnQaLJ,L]@5;cPYQ=fp.13)bes -;k5r[=TX:j19hFW;8!l'k\(,bJ(+?K;lHTX*C3X=a>BXe;<6purB_382Um^E<1PsI -PtHtZ8(>dX<8C;Kkc2opr)F*J_Mo#'MG8eT25qeB3J2S+n>jq"RN(';L*0"lqYU[( -d_M=k^eTJC9LWN&%D<7^bEkFYFb\^d -P,2Mdm9\BB?rmL2f%k@J/TXuUdh>+mf325i4_>i+ItSXH=,hLWPHe-!'\XfH#NF/TF(YJ65O"=C$YOA:LubL`-Cm6\44(,>kj#M]"[4MV*9hfPI@9J'C1Qs#E:=e#cMk^TIL`<.juTNu.9_jCXY;nPPf -%HEq4OB"u4SMlj9"!#Qh)"Q@&Q.gqXg5W++/Z2dcXBNlN3ciZ&6AhF(5?Hfb0u.!7 -S[+>2C>.>!>4nAVROk^,Zdm%&%b7O_XfC-`WS>S$>FiK4mCum&.D.'YLBqEq*Q$SS -J(6qH*,nT'!.T[[,2@Ufb&tK06d+#>GWb6TgdPI9*QjC:]NkuYh&X17,B2H:e6Pf! -?!>jJ/UrMZ=](iFKF?n?S)B_Eedce6]%B7JH3OM:@k[]5h8nM[("1r%j'GI/+hclA -Do5M]![XnuJ=r$!4N%$nX(<@,;B$mLL=qk_=%RT#'eo,oQq:0gA*-i:uVDK#T.A;k=?3iF&M? -[MrW")rSFN55#n'mN5m:+;iUB#P`9C8`Z]*&5f)fJG$sqHcKA2@U]W0]Y5cQI&YKJ -5R01Mh"E0':)r9m*+KI!it;"EmPA?:1h0*GXgsVTBUGHPlaTKVS8lSXN\q=t90Cn@ -h?7JZ/hUYE3o_PQ@idsH#"#Kt5\*VYA6q_:n8ALEQ=Pr65"%@JS&;UK7a=ImNpD7d -=iRcWl=>k%jAnWZ/j\SW6fh#hADU?uDHCCokU>q%K1LL.D:o1KqM&re5nTfZ/m&W% -\g!"\\T=qY=AIpP<+\m(k$D&"AfbO_BP*9=AsfF.$Vgs+CZ`?-emeE0qbZGH;.fe5 -k+M?<4PcNLQEt7paT)Y'XfqBg95=]a0I+]qdd5/OEck&F.NX -[O[j(!'EW+)W+q?l=Zp"pP4XtREmGq?cKVAI^s9D -a)$RTllO;cY00WcY\"Bi)lnETL*_WPYAFWElNYOr%":QjQUgoOhlaudDTH[[pdC8*+P[;^[]CPtEM".2jk\fm!*-2XL]53H -Bg@n#_JuP^gLGT]\`pUE^[Ze"EH`aLKC!Up-ut@t2gdl1fUN-O7Iljb#+/Gso9EPc --1Z77Et:#H-S9C(1il;>DVP)_'E(/GM:Q3!4+B:6cIMM`?ec4pXpYoG)*?(0X`H-M -no$g9.BR[37!)3n0-^Fq/G"P/lg`f$#%Pe<^I=KYS)?4+>8<"PjXo3,6ZaDIFUq@b -#>=_S<-:gEAe.K=rj,Pc328>%^O;%5;2V=H>%P#RoQM$QVc*106?WlI9K-1!04T/d -Ao\DC]5e>AS].oC0(XB$<+f_Yp69+tg)JkS]6lG']nU\0E-<%:p)+]jYB+nPFoRoK&'nl>EIJD-:GhYLYB9.<;O<(%UEj*n"1O+7p5s+_,c%$f(s?hT:9;J]S"chODq4V+Y6L6R$#lgp)Fj3KA9I$lPM7aZI8 -lmG56CciD=8\4$oU&:V8bfEjgd`X&.rAsYJ<7f1fVq6?s5C0CNHk^JTW%X)7G#O?.!9tXh9C;%R9 -:6>ICgi:@fc;D9sE,%Cu+]F0ZIp_=;ApAe1pj\A#$G61j7C;=Xrc-_0.2Q`KRJI0k -`QJ3V&g-=6e,91TKgR#&fRuF0N"`t]$s3>bk5UH3A't)TL.*>M8S$7p7&Es7Q:kf; -q1Qb!1R_$Mds8moFZZ0e'ZANYre!J0;.u2?*@?bgO7*) -Fh?LKGME*%#DL(TEHp8f7jjSFk&YT=`oI"/++KqM:\4WN,7a-bqp@%bJc=G2^Yb*] -qt9j3p3V5Es+eYVoD3lYce%4U6;I"EJ&m0B#bU8DIeuCW4:q_0m'A2HZB0GO#XQgr -.1*lK""\)@ZBc>"=]Q"q3;;?F< -a3jg9+NRG#M'C$h4HUo2;I#UaR0:A*9o)=8/fhO-'?)N;o$b6JM0q[S?)#hh%GpXFOk(-;e:Xf7BSOO3.#slqcFV-sf1d)RCd?K%q -8C>qP+\C,3XYEFH<4t4a`&%oh:t/Jc8Q+'g4],2/m-;]FJcp8,8ZQ+6AUADp+Ofr_/+Qq-GnMjk0Q^T1?=ER-%PCBj)R5 -@K'GjVtqj)5NG@#J'$mLicA_C5%B-$\/pp4l'd'fW9N$%TrI>2Y-G!B>/%JIZ!'W5 -Yj>R8ag19f51-b)>@-!kmEPanF._V]WO_H/U&U[J?&j9PJp&T\02^/?>sDE?oo'D?f_/UC -C"i::^N&''?/KqaiT8G_IulpfL#R>p_mPYJBRs,:4NH'Gke19rWTs?7'@))o6hco: -3lh&N8,E6*("`-95?mdXhcJ4urSMPPp3p@ukP4=l-h7-7?f1\Ys3LZE5SsY)eM-G3 -6i9a`dJbKp, -A+kW&eega+@gh7[2274L)8hhXV4gjOLX?#C6l:UhiZpsKd2d@h@:[YdfW>RC('lk( -1(W(O:hXAH,Xn*.(=",UMQqRl]WiXh(EeH;j45hPP%,!^A2oRQl8M3Mi>gm*FcK>Q -3_+qBQ_Z^0%^>WOlF0'20-Qd.:/9GrO< -js7p5diN$nR?]PiABgOk5%mY.V)7>1eXFrnCe^>*2Wj)VS'uh*:)V#1k9T/Ze"1YV -RFO@]AF5r:^3EEkjZM_%oq'XhHq]+L2o^[C)e1":Ml"Z(TT'*sU*L>3_'BHpaIikb -\9*a6o0hf='r'2aN)?$$7d/qSUXXaS;Aqtpk(r[H_DH^t^el@BE;(++]Q]AJWC\P8 -25\m[S5YiQ-pfneVj.%Le,"bpC*c-DeIJA(>*2_J3gl]mNoi^f,j!XS!A$W -8F.@,b[_&!=?hH=&K`3Y/R6K,G4+JHZ?Ak0=W>>(miCB"Q_*eTS'--H7I7]h[eO2+ -ja42-n\2KXqd5i_IdauK^K::2?i1(2DX?oo(`pt1S/$YFAd-$'56t[;-%tcb'uJU1 -$t5RI8VCdS'*/=K@LPFbKI@e9L\-!$d$?d`TY&11],&1jYD0^qaL0@UWddL\bu\fmQY4^qjf@p/RN^9,*e*+[]cNjkeGEa?RE;pZhRqHR=ei'r@ -e_8@5@L4'L5K*=hMB_+F2_hA@gt&maS"EjOS^"aT7dJmb[s2f0jgd=Ip"nH\HuGSK -^>K"c*Wu=^NICoD\.79Bp>A5QR)1-MYlE[CC$oob-,eSPg_[m+8HT[0o#7hVi,Drb -T8k>J2h(>Y]UsH>N_RZAB.N*!W]Y;cA^'tJ2uR --XZ8s^USJ/jkTa2FX68E:5"'M%(92qdDLKE&+RducUmHjhB0ZcOnLsPOI?G06pZB' -U6O+;M-?IVb]^`Yg-"8\o:CHXH6-;P]dKZKhOi;DT2cH^;#_]A<70Orj!Ups3&8qeM)[DIG#I&CJY\OM@LBs!"#geV, -9u'te]]a9Me)=C;B[7#UV[3p8$H#j(61U!H[.s*Qe)USZY)m]9Y"'%S%+'J5&:G!a -cOFjB%>WODOQ-gIk73U>%`rtD63n^N$P-$I"9Z4Ii*&BV$6nI\,7UO\nIlL%3#rIJ -g#n[l,beO?peR"f4ttk'd5)6:2\Qc`'2^h*"VVNr7hh(Y'[]\k#2C(*+;Y%KOi\aQ -bnqVmQ65(E&r-l0_pUb(;\tRB-%WoN!WEi7eAU<*#c9QqEI9an6PIk:)3LO)nY6uL -V&BEE),[RV&[NER[i:!ZfKoKT+]B?m`>gKaj&'8\c'XZmSs%LPdNtM)Z/ZdWC`i1] -&he'Y@K-%qrpb!h2USQJ&ZHmMV]_-)+L24K;>hY9(Enq\+jqDgJbC0/rp$d;g5):1 -jQmJo.5P!PdiCAG)`Nru2q)t0o6Nk^EB'/? -37EpK#^\'&U_RK*A2<0t>s3B/h<3"sUt -;q!kXeLT+h4k&:P'B;8GCCFl25/X*eZTo[q7-g'5j$B@:;s-DB:_k2-3^]ke!LOQ2 -P3I%O4`hc/'HoW(-ULc^qih=Q'Ji*U2a`9h1X/6.oKbkV_)_\;,7Q=O/Mffrpj*W9 -7F/n`o;`l4#QjTf3qP!jPTr[tF%;I78',[(uZ9U*jsB@BKFf1hLa:"8#UO';o^ -0R4?(+pR\o+ob=o`D.-Dpdd,82"K,CA0HcL961,&'.Zc+dnt6,9be[GPo_XOrDJn2 -;UmEk1pS4^VA5@T;meUn[-Yn#rY7]4+5p6/2,@4*ku/=#qlPh9c5P1'^_>6\huTr8 -'d6XY,uQUI=*8pmL;-a=LKKh"=OPD7!QbO7YS]YF:;b#7[1!bBXZG!n>12!r;ah]: -3Zmo_0/\5a'n]akJR"JX>b[?ap![2Hf3OM`JKb#2`OSIFTMETsr5(kS\%P"`Go;\&.<*q[fR!MDl1ZQbacqR=1EoICG\p -(Z$[O`I=0>Ib4!^cWb9gp1:^_:D?/\ZhYNBlX4,'%8Cb^mepI/B"p=XQ -f/XY7Fc2W,Mn!ti())Qba,HD/N5Am:i:1?D.;Y&]'u8-]R,\CP>5OL\/Ofi+!^GEZ06Q.]M[;P',o9SF,BKVQ-pK]s?l@@*!&n.#ne -UUonGM%l@XPo3Yjq3.2u`L"-)RG"31YY5t/@t\!aKQ5OhOjk*G\0(OUS%6'[)53Qp -pE"lV$BB^q1%UO1SIX>>R2OhK=l5fNaddYBT%WQr&gSRn2fj+=M).LF="K%#nXtmk -%!Vf1cYRVFs"`_AAe=-s)C(i"-([.Ij]W%e)De-deWYh^Pd0\E-^G^[2.ST7UO#\h -q.5U?f_3ao-rBN0)CMCc/Z*hCVUB+R)KVf[G8jtL'!YdV=oKS4bgJ'j%l3[QRZcCo -9b/Cr&Eoi%!.+Stj/2ZeWnOMS)JY:9Q)g@cX3cUl[([XY`N3#0H^Q0QRaWr+LTC:* -hM"O`>!l7tR^uM4"ZlUcHU4jI6aVj7Z9(ji)cG[:[>R#NLmPMEesM,A -s0d8e<#\iH%Ib,5f0h0LU`pitTg^Tpbl\nR\D'Zdqa\1c)7M\s\_E_,mq8>@VK,=J -\)i<=ON4t'1*98\\f8B8YKV5":L53#&eIjL44C_Zf=?7\Fdp4])rnY(3tW5\+8bC: -TMp[j!!4$N2'LFM)s>"2J:ec1`:XNTaNXdue\/U7_42U\_Yq8t-c2B'Ki.S%d=iF* -DB]nt(_^^&+W#CJ"iB%ef;LFAo4nMh5>]D<\8V\i*$)mYA]C6L;qt*f*-9.jB2_+! -(4lM+gk!N=hg:N>']?;=]TL;(k>o6>aj%#U0AG+\E*8s.+RBOk#ZF4_!"S`YpM\c?_jOE\V)X=4;RRe")!?h1N`GA_-q76rBs0_gQhT^2]+ogC0-Ajhh&J%Oi?3AtH#MaZkhYn&E*YL8,>A%7\ -B\(LVLQ6#]-6g%?iEe.g]+'8Epj$djB2CGmNof2*$flb0i/p+]*`M0,<[A\F42Dbb -raB,4m2n.'k/QM^*a.Z"q]D^)B<=C4Sn)fKFRFTPjIT03*foPk46M'^l.rCaV0gJ' -.L,bap2E&7iPHH2TBhJTT2Lf!cY[YHp.eBAkhaYM51/V6e*Fa&mG,T$@=F0ljfER? -Tm+%t*pN,abT,T)=(L]HBc(l+e*XgL5fh9Zhcnt -cggnkg47ZB,Nr`uk.d,Y+.<'lRYG1_rSQLi302r^Z2T7=^GP>=^LtV0C&_$LrW3*" -JO&.T=>V'2$&(_)OP"Y=+VBQ!ifR?M?83=W7cTW`oR9(LO\"Pr=Yu^I.@!NeP1aqc -aNT.79TSf?3c-jGc=`?J&5iG$-pQ5#L\jM;0;VS2PhL7DLeUesW`;Z^`.8l1Bp$2X,^u+W`>UCNtM8Nf- -(qb#N+cONQnp)4P?S.\gk49J7eosEPd:]hT*A3CIFJrsIRb`/%@BnL%p7#?rhf63_ -DYKXVpA]][iGeR^?8isgalRR=SDJHSTu2=Chs@/nrIB]RW6/&lf71KmSbW*r[5hgt -^-]TfWZI59iUQ_krh!Q,hspO@IfH%toD[L6jrs_)-EeZ4o"5+pP,"9r"R>ZWf5 -G@"@Yng8f-8,;:i=EZ,i/l6^j_!mI0!WGLjBDHj>fClVUCg/gJ[r,EYorrb5Vti"g -:]RVa6?g -*Zqq6!mCk.tqbT*LtH`,Rn@ -(WLI-FRtL-O>cdS-\TiuUT$A&qlk.R(I,.r4SM:kFF?)@e9%6_:Y#,$@k5gt4dTg8 -G.kA'gikp5GE$*e#o%m`rXXNP#@#JE7g4(,X(lp+:7'g`5*r24HG6k5DjYunE'5<( -3'60:IMr,oP%XUYG^Ad*?e9_>Dr:8;+*ZcAIXeigr-lE,n#QCooDa=P"p$tK#m"Ej -#b%\2ae%oH/_m&:9HMr[WU\rt/Y%$'ToK -#7(%M'[$o,_@p2RTsOZP&+1H*G]sX+j?JFI"s1]BJ>j]f7u7g),t,82'4Q&Z]a)KrYi^=VM[?Mg7]$LRWJh[^3@2'qCB8mM#2+Fkg/&OpX&>3Vf'="&V#Pe*9 -Og("e=SWN'lpQo_#!b^=rukneL6.Q=<6(sU,@knWOqL5U8N<.p"Su;I9R)&C&1&=O -W3Hear-+/M74BN&G94%f1q7u(L-+6)'<4m0XO -:cqo'ittBPGLJWe>sG#_#):VWJPbVh7B%"7V(!lu;egGNWYJ"&a8"C*Q!UQB -Jc7%6>iSY4+:j\JUKK*(QE$4I[8sll1Z9<"%+U_:!uHt@JCsl?!hL9(>*DhK?%&pl -rkV\%$".R$K:%q4`E9_i@r-:KZ3IO_&*@'=f*rt#[+WU2YmL]3]$De57aYC$8SMQt -`tH;h(<+A[5O?(%RFW;0=Gpm%mBs:/p=A#']6&u`28?X;#2rfKM*.:c?)usI((^8\ -=;F`S'(Uitf=Qr`DRJ*.%)qj?MY1S@ -iLsaRbM.ejAfn_]K+DE28Vlmm<5J@-'k4gYMfEc.*VW69#gr[2nZF]1Qiumlnbt)W -JH$Ep"!D+tQma\<8')Vr,p-"U.RkPB+6#s3`Q5_Djf%Ja;H"7g>Xb!"k$Q;WLG*6j -^h@apB?_].G&WK2FR5$F6JhbcH"Hk+8\8X*&Th -ec[bXC59G,L\jJainQW*;<9%0Y*@QW:LS&;LTkqKa+!m*ASf&JZZ^GO).Ii?M#^hg -p9)o*&^+(]YrE=>Yi"44Ln3=mjFh_@0Iu.QSSJGcl+6-1!O7WUkppV("(C=KbnMUs84r4qr -/!,h^`%n)Or8emdQ#Eg.b'@nUjjZANo0-m5H+,_4c:2*2OU\ENh4%(s/6rMFB@-rD -e)q`!V0';=;@!*YkO)!#4fFpqH&#J_rF`0RY-HRJ+&)#ALTu"daDn;kh&#,O[!&V$ --oc3+eDbEkVpM!j+N,2b^$!(Q\Y(d5>2ojnfN!YI'F4([T1)P*hu4n)Wq\.g@80]0BmmDVhsGZPj]'$WC6MRVh=r=6VelcrO7g] -*nT3EIrs=+8&+g@#N9U[C)o,M7VNofTF^R')i+4U)mNQt*C#>PI^dpT0h]D1]Vu^c -a+;&je)#O1!s/5SiZ>8PC)8\VXQr^uo!'g7. -\i]]&1]tNZ[lE%j5R@Jo)<6A]$'RH63AM+09FJU>og%"85hld`j93:%&A]%mVism] -qe3="-o&pDS(c5cTRX6u&j_a"_4d=2;u@itRR'UOTJR-EoFF7k%`/o%_Ah7GXdnSJLZB=`=5'ELKW/+9-?#9o<2 -66nJ+$o^L(35^D0U(f8uZoc1D4I[kd.ssOS+C@.q((UC1!.$UUo$sjF]#3#d`+2?$ -ad4tij#&nr[t,r_qs#8&3^],j`8jY2oM%aUAOLW;`?\@#0jFqhA%k!o.D^-p&=th6 -)miO41Xo@BZs1Mc*5.jhKchh=j'45LV'#>+`;EBM,\+hNAB$(r7EfA`FD&UE#H?(" -]GdrdKNFIKd"[og-UB;n/83',E5rORLBqEUEa(VeItj%b*jfHI>^&\kAOh]'a,p_L -*.,`EI)jUaS;:X-On)$?IjY;;7`1ml^cfb$KZ4^SaCL%HE88:>>f]9bWM/@Po8&*? -l,TH(P*nXr_P%(9)WWumPKB&Wae73E.0?`Kjb_Z2 -8R*4/U"`-ATZInAaUFod'Vc#ZR`\U+b%*U>fR1*ekr3^9M;UXLMUa5g],UVF8o1ZQ -oWO)i',NE.#($ZCES8Js[)sZ%8jp,2A$=&Y\BC,I^8PTGi.%ZRj2@IY9AlB\\::EP -^aH/BbG<#!1rG+eT#lnhRQMU]Pdeh@aNJ\I9SCO/oYaGAbfnOd7'K]WI*Y;D$VI/o -/qe@;A9H"!c-95RE/PpR!d,]p=R?P$.(f6>`[/%)U72+$2'[TPg;-C'K -m2+0((o2c,]mD05RTrTQSgQA11SKA4W>Oo'@AZP;.V*&ALGlB -.%cJAd\SGAZ3%mnR>IsC#PjKZapU7OVc!+;dj6cdn9L^t(njPS;dAA36*aC2.8kjZ -e"o(RYu]=24O_hDRq$Riagmn+5G5Zh197lDK8;$H5#bNN_5%_K$B7^%;S;jf":W*a -]fOW-9[q$Ue%FO:AP^h[:mb@,L:f@>dU#bKn35c+6Qf;/]+*:*=OiWIW?Z1)Zp6PV -RFL=m<:+#Bj^6QnOk$"2eg4dhHg2f?A<^b*JugFZ_^a5h0=2I(Jr#[ -2:6T6H'hVA?WR\E#_f@Rs5f4BE_ -o=cchHjP[(*]iGfadC[#K\&)8=$;:2Kn%a/LtIgHY1Qr<5ZWLg8C>ML\:A6"8N#.k -OP(;\380jbQ(3Y?Y)$Hg9%>)-nKkS^5t?k/3J2P3>#`&8;K]jX"[D*j/Z!8$[\Zc#ThZ3;+CQ3L/[+[Qo,BgO\r225AJLPTuaOp-XtNPR;` -KoM)(Jkh^pnO9S'?)?8b)@"A)66bN<90EOrh8nAoi8+XrgleF<[H$+3btk0J5!hu> -lAi87`mo$XL2^"G3*HEQE%iHrh/IjtTK*8RCf07dNhtgo2=n5&bh*j(2(^I0r$L7u -inc!??^:KFUh/FPr86"f3%/DC'J.,=GX's0L\OQ0/?qh]rE>EHKX`%rH5P$E&Oa&* -i2-jgbN`!M&HuIYY4GT=bR,-1q;E(c@3,7(.2h'P']E"rb'eZq"e]2gWZ1?"\3q$> -?5qk@:0@X:[4JRW/_1[)'B(8]iAMlh(#r`J,iVcV;=tsf('WZQn1JKoL]/c-4sf4. -/@4Z[./a]dJ4kIOJ"2H2't,@I2Bu^$,3)QFimp$JF9KSrk2"R]2(cKriuTQH2riIP -ZV'8mmE_@ds&r@S);/0Q4uM@q6f_99OZks>G"956i_$X-R3N*m#!q;jpgf+RjPpEW -Rmdu`;ROBPP-K8mAjg3"7HI9CW"r.iEg2?&=QPiOjec5C[Thk5>ijOBjlTn2p0Zqd -@-/55jsFR"2Ikl=AEHp(k%85fG%]rlB]bUpk,)nU[V:MaAM3C!818k>&1WI.@Kabt -L.G0sE-2CDCZe`@k@So#G'E,(GitBK5Z$[1L'7i-Kas70/s9p, -Pj(Z&krtEt -DRJeR\Eem[l[HG2QFgq0]BWFYlfM>]I_V/&^?cWOlmBU92T+lN`9'%)L0e`XT^i?/ -:]c/m#&mX[l5^oh=bm2TiJj.0X51\kn]kbpPlc.rP(?99Zj6ft/mUkNtG3/.@k3dugm[!/+ -NpH,1lu'8umcNp)p?cc&mdCYSmhYKZL>Z^;!,koRDdb`r7ecA+q!XOElrIrhFugV9 -H%p!4n#$*QpAaUe!:Ud*n0\;,2ZrP>"RoIrn7Msm*cqY.;?G3oKK?B>d!^S?*/B>b -L$&o!i-0r)DK'c$ml'_+2\PXMno7_EnR!"#B,C)^)"DM^nV8$&QQ#D7)tDN!ET\>3 -miCi2&`uRVng>WSlATYtAHp4\E]5?9Eu%rS>FI(@d1b2sIT:F.;"YIu]Z>*' -1m`k4TLu%PKXp+ZA2X$%=S7iU1fNP^ZVmd>Zp]Hjo`%\XmpC5C?AmE7I$FuO10ZALq(ql'J]0(G.@)f_#o@dFSA\R -1(Bq@)uYG:C7]?dpSW>9P?HrJmrGE3o!';2-\(kTJ9NQQpU>bL17$-]7(>%+<11GU -d?B9j?+X@\GX%)\Z=h;SB&EJ`hW?KspfIVq+SZb8p^`P_*<^W%Pke5;*'=;)BP%d! -Qk*hsO*(4MCH'HbQ20%&Uk!^q5jFBB`jIBUhYE`\nJum&PPI/5qIC`EkGS03W;;j[ -e(]l4Y#8c2$!"l3&;R.Z=0MJpYe4&;HRH,r2m`BLo!Muq3f?9g#ljc#KqiAVkVo*k]o)%Uhr+F%IGK7X,T=cjt##/;So'go& -]FX2DI-8EFpVb/AaF+lPr?p%l1\]\BM$NpEIS]\;AFTUPq#?]Vs/5^p>3"@"raLK[7nl2X:k1!O -Wb<(Z#6fcHiD=2u-6!>J6t-`fHr_O/MFHQ&R,h^>)ir$M&igYl6RS$h,gr)kY$ENE -94fsTPh'P-REfEnWPn4Q4ePS!;u.L=M+===BXG?>16kS4;sI?IV+.LaX%Hal]&e+K -?a*XK<]_Unc"FCeD-"8[[bYl3>]*V)V:P$X]O#MX]B/bbJ&#H2=?IoH%>Vl2EEKkc -2][t#A9(g8VH5@9b[tp!]]OE$T?q7n>!44!9rHKUF]uIj[p?2iCj'#GVUo[oghq=? -^#o'$rI-ubMWajg4TACu+6W-;0:U2KFF"3(O!)1:EAFr0R`BTThsP_NhB+,+c/SA@ -I6N-^\(U6Cr-dHULX5A\r-^e:J)BGas/#,T"TcE#/.D]t&53fB_2rIR#Jq%2,mhGM -X=Xgt&Bm!@_iX4J&&]%g71mJ#/56es&PQ0AS#,r[;[VrVT,GXDM-r1_k$^H'Rg$,o -!'datJK_eV/;5<>P!#!Tac]&_-->^oTde,^XJ7;gP/OHs`H(=Y0?b(<`A,T#/Bouq -'26q6c')u"2pN(qjZ1VMXR/*q'?p,4[3mu1J!/dLr]u.`X._o#Ne&f'TB@r'J"K6C -6S6`LeL`?$'Wj/ado>]p:XaFq4],/n*DKG^'dZhI:R,d&=4S+GAQdTLX_h:o(!Ul, -f9P`O?e?,'KjiW"/WA1$8$W%c#1PLDB=]?2/q9E=]dHe/oj+h>gK*^JDqgT^]l;bn -*R/S0(G4*WWE)1Jd)k\8;/G7VSh,s'tO5lW44cn`m*_hc.)(njOj[pj-Qf]0GAXV\KY&0Zk -):!AqkF(adTBI1'Km4QV$a#4g'LD^p$'#[Tc"4FtV3U>7NiT/EgS-PoPskW*R'!fht"Jd0AuVs+-#6)*\W`;q,577kP?6\V)LATC)LT+/edqqu?-_s54"\J5?^W5ZeHr -i'[m&:b@6YdC_]_^j:CP4@fPDr\6g/N.5d-qn]d*#@R`TKM[+0_AGiN+ClpT:p(R# -fNemDKJA3Xc5K&PD#]8Ue0!]24i'%@F9Jg.K&T>>_K\cei@IQVd4-D0\=F:BKM5;U -hC:rrXVKj6=c6-p/k+F+(ZPX,2.O"2\%pAJg^HD].*tM;!WFmo/%^#&$7Ee@lQ+uD -G`L265"E-]*hHVGOAZQT86HBFj@"ie;D(F0fc7dti;.Ta`(L3+rZ_G+4uo>C$'4VV -/0g:-O:h1`a8&:UjYWs$ZE@/!`.K;rKX$h@c<6 -8Y`"&5a61$dY_)Lfi9i)FO?Nj:1qgSV)=(q]phr&S5YGg:0(abLI+!8 -',]q&dJbK0)gMmhl>+^KWBI,sq4A>gHdCC;[jO$6TMuDQ:g+;okX>fO<%`nCH-n>. -/=;u`1e!!nr[l$truNDP\kgHJ8*KUhT@Aa[;E@ND:AkWu<3DNbg0IA9Ke]H(cC.!c -J3V$:KHKfs2)lu10EarH*J8=@dRoKjl9-Pp2(k\(g6E:"X\l)u:9%;tX]=Z*=fYP> -4H%Sl-,DGP3[4br;5uT[C1U2C-[C -k^VDT^NQg"h7kmtrEn=TJ)@*g^fV*K?sF.ln4!`#=/9O;Z2Q!LFn-X6X>(7Ugc*C; -qnlM4%H%XTL[b!\?$J"8@U)WanO=tH=K`K5C2[f?PNW[r-OeuC4,rd=3Q,%c*+Q@d -MfK"faB9#tA6b+VnjAri"3T#M4&&h10H2,/bZP*8+cgZ`4Ngk(/EP*bIe$6BbZTu^ -AmETKo1!FiQPaCnR>*$.po+YM)2Sglg(=M0-CtAh%Vlh -R/[e,d6W=e-9HjY.McGh7gad:.!6l2e,'YaCgD[ug?,Qk>;'T)h4:nGL=*36)^UR? -K1*cDIKAKm4oo),'guBLf\7'ZDI(AppDd,c>H`3fh;,^;L@O+u1ij*1(rNIDCELCf -#7f,G$H<'M%m-8&n4jG(3'RT*">>&ihAsN/LCrNN:Pq2q\1_oZ?+r[n3.l4((IP), -jBO?lEaD8X\KMIB]W[WAhHe>#LG@pa^hsP=r[U>YrtU*HHj?l1-AOR##/^-eC!KZ) -q+"$;r@asXhIk=6LJd>B:TAPDXGrT38 -^>7MEB34M,can=,mG7Z[GqjoH-OKmc)ZhjbgH048!F<2=FLZ2U*Oj#]ru'kpF_^AO -:Wdri/`loNRH1`O_=eCi..JuA"n3lD&1If:PloBM#4QU;0QdV>G\=m:(#Yl#_3,3TcN(mp!$T]! -5\M*%e-U)*$1MX5E2N@<@\cisT' -X:50-#QZLaOQ?g'k6c1l[]m@S0_Grqq%'_.&*+][+\EZ'c3hDK%ff"lE"EoFa:#gn -qbZSk0^fM!.2#E&&.pW10f9Va3>8Y[0gierJBSAZmf8:,)?@nfJQ`C(1D8)@&oh7k -Z!aRD58LM@(@cA\0m+$0_UlUj)6\q361th^-MPW -MrYgbed4W[$K2L=;FM`!7j0WY.WQg]10#W@=XC@Y\"ohtT]7#-jSP$h'!b.X1/B1D -Gpbq"-1ZU815.,sM(#B)8kj[I;6g_uj<&pK!`5$aP'ng#G:Jc&-ZY1s1:8WQ\LXtu -OT`,r@6>@!Zk'@Z*"^PX9t18MJd0H!&b<%V193$JY:cQO/+W3`1A*;@q(Js9/D+QoCOpL+^po9DFZ`B:1I3`FEh -1Y"X0ffc,FAPDY+Tu[]M/N:W\*roX*/dFBmbrh3c5P+f@F59*'#sbj,5kGUCVQA63 -p?PWh5/_%QT\p%UKF<=r5I<.1'Ji!*"$nb,6hEZ41dsfAaD:B0*$F#B'Mo&G]TZ)M -#4]5]'K&@%3C]5kfJH/i1j)<1Gt52OGYe5BNt.@PJN,ol&j]n4@4*U*Dar6I7^SiQ -e9sr2WCjP"9(Gr+:`D,b"Zq`j"#RbH0,7(NRn>NZ9^MjR'\,p"fhJj0'1\?(J>s3D -N4r5@"Ro,Z[.R--pIrU`:%\N`2$Hg!#lb.o49;_s5aqp/DV$%t$m;Y=Lep@SZd5p%;H`@9iL( -?hOM.2?^3T9+1hT)?@hdZ=uW:f+^KR-M?t;Q6fus2dge\@eMNd2Dh+!Y77/&2aB^D -:rWnWLLQPCAC`,=mMTMX=_5$IAbKMol1#=8XZOp+@5G0"(3O1h;eN75Ai>3R2MGgf -LkZ6+/6/pg;V(HtUM"auB9o(u[YnmDWG8lDC?MOjdVdN!o4sEhP)q+-If.@O:2-@,8'T#,\IQpV\F=N$Shntf$A2Vdr93TDH@Ei -2\g=V(gkGC#[l%A<$43JQjIiME7YJ=2[OP706+HaF8%tB2ag]))(&3Q"*GJJ!Pf/; -Kj*(_F-eb,m6Pi6m6U2bnhDLr)!X'YO1GkYWl2C!E)R#&\.r9Q-5oFJ]5:OLN658i'!2L6kWYB\$IeZ]il;*$,=bX@kL%f?&\4[520&OHG -4('3?^cE7hX:Z:JL\O`&.&DY8M28[$M"[^m6$*J8"a`o'*?aJK-FYuGP5-hr3Ai^t'3`nr -+*W,QEQ9aUfoim?P*o/jGrM"6=d?O'.kXUV(s3lS1HaM@iZlGIn4=.jl.Di_L_YaBJ+H@-u -28bqC_n8:Qr'eNY8]3_a`-b:u4Aj(F:W9tH`S=V8r+3l1BuV-0`dD^E]Q(u>=;7Ek -'1$^I_!s@MYjf&F#/Nb8!B\>lF32(_ao$;(4IsW"Tuqbbb.P"%S@-N;\'$nEbP]&t -4M/gb_9AFgbe2?Ir70$Hg!)Y6c$\?m4Q4S5hp/mrcJ7[0r:SAuq9L&8_]1D@Nh=Z= -$.-?pd/=R(4Vc@m):?,]A*ECVf=j(5I#sg6]^p";O)PYch%q$q.!8%OM?4#R*e\,&74b;76L"O(kf_pZ[ -*KA`8RG!"Zfj1<)]qa9ZV:rV^gARr(4g!IDajdrf!$/o&:1;o5akXSSh#5XV4k8A: -g"j?th>Qjo/X_ -e,(r;edc(pR8N]U+Ib1'EXMmSRJU:"5(fomA*CXdkl-Zoe2HZTf:u:g!'"\s*f'$0 -KrMeMlMe'S5.#HS2h\MmZ-"GHePRRg0C#$\m/G3l*k1Ncg$QN/DD_5>FYo`%e]-#[?/,R5[*U[[if9k&A'OL=OoO5Ag:@V>rr;IG(LNiCj7BW#+:giT -JUUfdWlaMU0f;Z5L;P1^(kbX+'o>AROa,Af3>dfHj71e*N^Y7UalJVA1o=D+QV++f -fo3XV24@8%F.'E#EBBdgBG8N&reEe6;M -a(+ZX*0sALQ-3b1)4]8r3M"K/oGS_cO%H1sC%WC8#c[G,Qm)kGRK -H+gF^\.q1:?\u\\E4HQ^.DTp!4p@Qkd$st4%dJ2J]meRGWkL&+eHFtM+,e83H2QNk -0<`diom;-/s-L@^nbW1_hk.sXn,<2LcVo5m5]@tV"$l?D'*U[@A/bb>n:W"m6?&_N -$UX@$1CZ]jj?!l>nH;2k6uaJF'1D@Y;\_,br*'(gcidhT(#k?*=UKh-S2#sTgT_hj -Y./-2T?@t?R80>>a$L+noUWRb&W07.8$naY:WApjC8qJo)urc9QMK&1JIC. -dksj@AD9%;o7Z-a:335s4&5Cco0#ljjSK?YEm2-\:iDb2.?[QT_L<#gP^r0lm]"o$ -KkC,6+e$;6V!sU*,m-qA[06_2;tV.u;H3?:F9F'Vji -ja1?9p'$(W=EZ!K@p&FnP@[,3I@F;@okGsWMBp$:1Q'5OndeUIKt;Vl5hV_a$dkXu -B3I5WdqE#g7Fu`h[tWL\?2'oLWS)L7o6jtijnjO7p]^hO@!F"+K4+ID'89k>AfHL` -2m+BO@W.sE1l;nW5AjtQH'g;pQS'S2A9eq`MIbBe:R,KOAl4mu(k,t_ApL7hRqDK9 -F.Hrhk'N_5q?DSGBR2"_ZXrrM=/7,hW6Qm?FDW+[>IP0Y:$Ht)Z_Zo5`jr3e]*?$T -CYIX)ZY]M.e$X%>B%se3qhF.ADL88H]5IM`5HsLDh+_UI1!mb9l?;q]9F?.7a2IG: -N0dqHCl;p!1H0dL4d_hVPX*WrW@ -_9qG5n.>*c^K8L#h,f*bGWmL+j*6#6S(%1^B:J(0reI95H@Dcml[&QNZgD@209P^& -``U)6;F+r6+!0#$Z6LBr4cdRpd6jEG0NVe/^pj\6VpJm@8KHZkWo=oHm=:uOqC#_:jh23.ts(n -(IIn*$t5AVL60t*6[3S\9'e![d.I$j5e7qqL_ClHq@#Z3H8l"?6$KR0'?'[:'Og'$ -M@i`8*11ja@anV?O`iBHpq[eW'P!)aQ89K4XVtZJ$l)/UJqp&n*rr(u8#,/.S?R)b -6?&TW;-lIWf`<#Or.:"_<\qgB&L(abMij/\7nEG!,\3.'B@7Pg5=jKU7Nc"I:f9>& -q!80Y:dTf=IR6YP#:a8sWg+4"=!^Ee/7k'PQBKg'96kM0A^n>YP4ZXaq,oCB]Fl.L ->igU+5*(H>BaN+rpe'550W'fERZgK^9dBNgVUX@iPBLk=q8#%'']Y^IQ(UiSYlf^D -=q@C43Wd.o++T$dK0_>""b?e._RP@8iA=G-M?,Tu%-aEa(4nG9bsH)D$_`eCLJ[gj -6thi!U56+-:cIg%`-[30+?j>,ETA.V,C^kXreo3N%n8!:.]"u(Q-icD9PKbJVNfZ$ -;gNFYC"+`2PkD."&Oe-]E%[pK\b@!Y&^8@=*jCCCXmd8Q1hsoqZ1(t -h/olZ]O6H/luKq]BKG142hTSm>H=$CY-qBR=aMLHX;.52Q?LSWqa"n4'r/-uK$7A2 -768?Ml4.4AecQdW12B]FRFCkn>)RB7mF@W62Xu+I>Cga2'uRPJ(?8YHO`FQ0]=5$< -g!:Q!&g4k2"CeS`$)KRtY%?@sf66<4bJ$X;6%h('*'o)E()"QM%gV*A;2T?o/&dmb(Lm2MLiFr*RDX8-"B?3?CI@/"_0e2f -d79/$(*gnFcQb&i@?PY39?ES\-Y3.KPZtRbb(ls:NcCk)Rr[QW%XI;6"b>X3$fcBt4+ -/atTk=Urd14*,%Oh8#q3B&h[9QZI%mdCOO$>2/q]S4p/W[Qs6u!ROA="VEE"[gq9P -S*thKD:cRJ(B`Tc(P?[U&DME\$RPZ7NpfHp`R;LFk+(%mF+/,SH.P,9r5Y/(2d.s=!,LdaXkEi% -PGVBb,N!lMEUeEd^%hUNjF!;X -nt&nQGi&9N_WZ'9Yno%#0u+`[%he?fQcs^#;(?t&X7`'nf6[I*ltDHXoZ;2TK`O.e -!oS;`^fIfQOS/l0E'0,SHeNjs;t;PZZMC+OkC!<'oR<$-q-AL0j3ZU0[^6i2^fq`\ -@;$BDDq4YJQeMF^7J-U]li!HbpO7Lu6aWLTY1*MF4@g_R`M&OCIo6!PKtr#e<7+[R.m%87d.i?tW- -rs)Xe.O5Cal)6k7'e2a@_E9>7gaeW],/W+f6L6?lr%LJD[)1#+LaYBe;gJZk3!%IK -_^$d#HmCN?0ghHl6``@:]KADX2a`EO"qWBhX"4:XH3Y!?!V4c.gdFM_7#G53`,%q3 -Hq6Ya8NEk@]P>t=+n@h^AAejJ"Cr$1jA87G76?H"`@OqV4B+aCK+\`T]enLRek!Z#9&6"[As5G*,%dZ(<-bt -7]^Ap]PL'[Xi?cX]4qN- -/;*iZaE3J6,`kE)L.NAJ8M$&s4HpiHO2uSm"XI24q?st,NjIf.a]t<,W09eHSOqV. -8aN'@q3]::Q4N7YW^oK;9T+q0G_`u]Y"gB[m-?qR'7tsU9m4B -%(cmabC%3#gpiMh]ZaX#9PhaCI)nW2`6=\q0X)lG5Rk2t%YI&]KZ(f&4N]p:aNY^Q -9e=af4OabWcbTlb2:Hk"l#?dse]eNV9`f.U9\`@dh+c\]9PiD,YknTS.0QI!\"Sbg -eDJPFg8/'2c>;Z=I-==aKMGM)&)fkYM[k@rm(,5gLQi_#5V,Q5[a&.K:9=%.%-^P] -ohSid:M`NrUb',?.4.a))"9;fgU2]6peNI>V@<2pr;]Y'!Dja>:[BXYY^lfW_?3=V -c4ETE2#^=1_b_Wd:ot+%]aR#O#Z!H0Kd4hESC`D_#JCMmd$5'f3VlRs'iA6P;/I+/ -9b^F_(p:);_sf_$!"7!V4b1Un"*bnN\5#n\+]0u!d=!6;4X9=qf1d0iK)J0i]R+eJEZ7A5>.MuEB\3a2< ->u`G<&C0@Gn&IiDD7kQ!VCf_8-^4_)b:F6g?k\#4fDQoZ!/6S>:A3/ -Q*1_qPHB5;>/Bh2jcWCSZs*C$>;a#s]t@Ro]aTV*a&#[AijC=CX>]%MdIE2e%^>)Qb`9iaIUAY*]QX$*">j24CNR1r?d9Rd)guO5nn3T2rB`g%? -gMK7eXeH"Z0Jqn6?*2F3mF#:bh-Jjn=M<0hYo$?6ZV1L5+!K;XOW"A1hqc!.$74Qc -IHY!skuD/9Hu)i3BO -q-OJ]h`^jD^&26]p0UPj6$YhPJ2.2lH6('&M-.e:OEs#$o@@e1lX_m%R-":1-@Ve0cmN[m79um+;+rfsE<>+:\ -.,rs6@WjD6r\.gj'OleK'g$*Ur"st'*<=0"K5_r1VD;Y@,3'G"A$.n']BA4?16T9/ -]1hWr_qrQo/S!?u(oBE+5"&pV76A4Mj4RHQ%N"#AlFCG#jDIU*Ajte+9k<*U3;uS3 -EDsIVl)LJU=\Tcj_bG)Wm;he]odZ3jE9LD._XBB'U5p`bUiNDZd+Q ->/W`.r'TWWA7o$'k4X"3IX#L`#\R1W'g3)\=;a&p2M)*qBd=Q=K?t*.TK[m` -$=uJZKe1NO;+0=B/d=!_"*7';;]oc!OW7\gl0b0Xrh(VkSS1;fWW6=V^d,##n#rrZ -!0D;TO;TBI-FL?-l?F.-*`9bSUV^CSN`[5\?s3Vf7VWshC(@Rc5.#)u)!Tnc8fa(" -]sh]5m)Dre?m'@i(a0(X.tcE/lR''G7^[%B_/(10,3HXT+]B_02$)H7jH^pSi,Jj$ -+9gCJKFYoPp;61Ac"u7^+@aQ?q.L`HAc[A#m!ctb\rNjm%g=T3lp@'*mauB:fkm/> -m;5`)/KcQ-e(bid0@1B>h77A,f2"nPlscaC'41Ie[iAq/;l$Dm&tU^AMop -rGUQlDsmXDrr@!K!H9+^E%_<456Pq$"`RfQE,Pu#IgC"S$#lLDE3BXg^C5)-%<127 -E:4*HBsXEUOuh -ruc;P:kCZ'nfK(H-R3Y-,][6:no#gpG:%?[.<:J!Eec/cT.BK9/99W"EpkRMs"8?t -067XZF!!2Z(Gp1d2"NphF)NsXIl6hY2fko5&Am -"3:q*==/]V5'1-rFDjA8In"O87s'eaFIu3JQV;M)9_?(oFRMtHs%W.s:N[0jndbB% -:K$j]FXM\6s,_L:Oa/%3GqYA,5EpFhQ$H`&Fl//RIu\f0 -Nqo$1H&nG?T:>Y[-MJ$:mYL3'019n`SGF=tH7th85GEHoUO#_5FN9^:Dgoc&p$WEk -DB33_O/r]7WVWlDmjF_$+`M@$WqtPtqTZ^#-aEPEY'XEmHT-EN8%'.?Aci;ojk"Lf -\fnJaQ@"\,6^P8da1-L-[!^0=$ci'=fr=-)]+3si2g3q>' -ICASBa5)l;#=#XRr.,qR*d$d^hL8bLrUmFE#O$VKnU>ZKrf>uuC7lSc\Uu;SK<(ec -J8YNl,6dl2dKf)8O6V1Dl$m(+s(91K:?6mhpBm![(F^P\;[WY$U*GI$>Ti?g"7Z.! -H6*2!,B3=QAh#Ek#SgK.32S%%U60,j?8WU\7O-4#q:A[0s*2VUC/f5\FY -7rc0?#7#t#ic04uIRbcNbN_=:3%'ueR"@2?j;Ht=59Oh>-`:9%995t09[I7[;ceJ1qZeMTKi?2J]@piD=rJ=q7[N1?)gK*%+B3COK_/J+0ouV1. -[iN_8h%sABS_KKZiHX3\S`tIWf=WVWh,i.[IG`ZE!IeEXrWdu3Qodle@9?hRL>gd6 -+c,,VQ4&T/(q'm4iu$W+NoO783KLLkSk5++ffi8tj]PhEOQG."@?G-sQ=H?Ffrf=` -ZT;h+[??_\$q7bIcmJGc/ -_(U,l+3F*Oh`oL\Hp7S@pALV5fD,=%P*bh?hnS^Zs',fnrr-j7pco)_!+7%pIrHG3 -5aW8fi*h7gE'=:g(^gJ>KG/s^)@"$F2$W""*GDZT&4(P."^rZ$K[>S/60M;UiFFNo -cO(<%LgpkP4>_dhef5WB?Ol&U4bqD^ksK-<%UpD:LsZt`4fEoEiabc?d631OR#_h' -Uf3/u8hiCKI?2eSl:6*l+J^9.OKo?`,T-V,jCF74dQG<9GpOYF7$WpU>"U$M+XZ:2SWh;" -9?J,..-/=CPZ!n<8bl@9j^bKSd[jQ58Rj4rUpG5"\m.mrFY;4g[['hj>0I;$0P2K3 -Q]iJ$9UV.DjrDX5;a+[8$(V[*>h,:l?>LliV`*\%h3p-KDEQ%I39MRKSB\?YcC)@, -VZc=VdI))%)scZT2^9(;OUTrAM/ -hOGT)B27]V4f1(8SdK4R;!K>qMA6>k;sKQC.TGl8eNTp3)PgX'>udl319=Jhoi15< -?)u<*X]?@D=K9VULGaOf+7`kXUV=YapuRXsM?& -f,!RTicB/.V:E0)b3.S2[]#8)0FcQ"O9?+L% -+64DZaDpW:aO`'gA.46VnlAI?R3*hg*2Ia5:0#E(>:2+`Vj?o8Nlr;i/*7hXZi -bh8S7Ah:cco3Q92H)!?3)VLRcVJOPg])H=noq(d6DpK=$46R[Nm^)>8d*tQNBK[$' -oF^-1qEIMb't^5_VM`g5154sE25]NUR+'br:ha\]V_oftbBeY8C5l5l8X?7(g:gR% -]i1shVR)Mu_d$uI9rtbb[F_u#?#1O8*&[`7f@qBO-#JFCp1<[EgF$NJr3cEOE)05 -a*B$PjP5)@nh*qbk;OgMr0NaL^0/\UUI=6,_jkcHFGb@I4m18VS+F@8ctLHakhR89 -oM11iqA2jb*@%M*)$/0sG>.:cLT,Ef[(JH7ZC(/aZe0@fogGNjOJ[=Ne9cMIQe -g\nn+pt*"4qnJcp1r%0/s']pG5D/TX#qu1*VtF5#^\Ii$nA[]%rVsaKs)7!!:\:Lp -rrCCU;_S:RO;@pm)Z^Kl!72YbE$YO=eH-:8!sIiiO>d5[3c,Ea":rTVO=LHq7T%N" -"V=R'YY>5H=TkPH"]/\(0O4mE>6`#S##K@G6q%$h1AU0Y7aRh$c!`$kUjuE6A]P -g+a/d$rGso!f7B5lKU(d%8cR)6;7s:q[^R:%oEE>0Q.Kl$Kc=3%ri6p!i$=S)\Ks; -&TJ$f;'^GW*tlj@&htaI:uN&W3toKA'/;ieO*)-+9&84>>((jN[ -&R?03XVNWm(@1]1Z$-ebEu%W&(CRtoObVIbI2F]"!g/mY=#>rM^;7tJbd2gHm*HB7COlWukh]C-# -*\m7-DIjmZqUG'0+;*i[7RnQK$NKZ%+VFjPOprRnM]jhZ+]9L4;B$g@fcfo>,"bWT -Z8TYl0d75olB4.Q:Sf;a9-Yt!,]Zf"&ksVa:F2`2,uS4HdTIo[>aBDA-O]MmZRaffM3YRK1.V' -^be\QP\-Ug@7J>O7T=FtZ%Y[>HG!4"7[/)*'R`N.QUhgO85Oq0[$JfJP=a8V-1mTt -86ne$Th;GP8p%BjPb1S?\>duc9F*LK[&m!DYtR""[$8U*<6CTXd7q[m9m"KP:=i54 -lS'%+:DDt$<:*JB(JcmJ:]iRN[0Ee!"&Do,n'q_A8HVc])c71R;0=*>PoW]O.OPrW -;[7qQeK7_GV,K68W0K;@<@JHD5ubm+<-:9%N6,&l>,;s4abDg,@WWo^Xb=]EFFe[B5C -ZWe0YEHSfs8ZQ(GVcNK2>mWf%(!B4Wdp:+!?$514c2h5Dl7O79?PW0>F(,o^r4(D;SA!T>i -<^UD`6"JP:AG/Z-(0>'J>@f^"AX6b9emiTC"B%n[\mjUWG5J7CDO*hbU -D&1T;K:. -I.r4l4EgJM$f/%K72fmS.F;I#\2a;Cc96?LrFE^Z*f2Zr0 -=*<,!Fr+;)='p,p@s42WB(mTq/$n[tf30Mg!^5GaFP;f9:KHQ[.2J -H5E&s2kPCtX*U,9H?Z]Af$OVJTr8f\2/c)2hTa?KGZe(3'W'u98&[.KQpFKfN!V@]n6#dL)=ET=D*AUCPLJ[ -LDY)f=EfOfH\^7'L_eg#G__!_MhROZLmX<\fTV/ZQ\j@[MAVh?31l(/R>Q -pBc_eWJfE,N#90c35:DSbD_h7N-Ng1f[Yru=,V=\NYpf:=Qb^3l]0WdNu7JL=SIlD -qf6r9O;QZ4=P&Y&"-C%uOP(;0)&JD1)j+4$O4SZ83@6<-fj7X/P*n*nR4jbhk2P&O -PQgB9ff`=q6^5[LP^-1k\PJKL,F"TXPtDpZ\RpbfA!YStQC2bsR;\AdH>a[DQjA80 -R>3VeK:'sAQe>f8;sftJRY?$DR5q"u)4d4M2jtVf1>/^t<5k8NZ'n@oRsDl!=hC2l -^=X=BSHnnYg".X?e"+GGSXI_i\_j!6d@NAe,$F6(7,OUSjd`/;T6^T:RJieHq\$ID -Tb(:tqA5g+6_QO^GT%$bP38PX.S0C^Tt3!\qCSJ-;5/A$UJ%5S\jf)60r34#Umb2+ -RR*bG6:b9[V?AiS\n;a]A#@e3V4)J%eENk,H90boVg)S`A+JZN%aXVutr]%1EGc`PSd -Xd\6(g:==HktsM'Y6H#LqWk>H[BDXj0A?0):I23($=7Iihn$*fQmQ2An -7GkBi'=,M;Z?n@QgD.$k3/60FZj!M9]11sF6aX_V[$s.b:;sU;>#uYA[LOgqgLgL* -4gs*GQlBbK7^oi'A$oNb\,rkCgP9+)K=K-(\%@j5#g^$XO1:[G(u(Ok7.n+fWnA>h -\/VQ])X4jQ])u9&]2LMtgLn/\_3oYj]`d0(]=59He$T#(^'uU+gZD*Ij1UQI^7.L( -g\/q)o=rJR^AH0j206P0-bl/V2#I`t6qtJp)TM[kZ+M*n)*>\T.gMRJ_GEb>gC(n] -0j!-h_ur*<]I0I:6a&UB`=*9qgf?bs;oFc'`L>i+gh3EfA&cEc`ggC:>]6^6F2uHg -a..`Ar-uaiHcTC(aIJEqr/\s]]u/W`W#V;,>a(!s+ -6Q+)Fb+S[QVqfP@&^AQ?g+^1ic3s`ug1/Djf0t)McNtiNp*O"-:[G&1_gR5+sh8ZYs_q2TDg[q8rfq$q> -g2=UUf:CaR1:>sVO5=124oO]t4n7BKJ_sUihjsmiIK.gR"lHSGi0f/ShA;\''@VCJ -i:?9ofkKFe.g"QTdp=Wc3g8SA>N9$R=^F2<^-Uduj5a?GjIT:Qjnd$[feqq6HF<`rcQ7Mt0Gipj1[&/*7imTP4b)^fLS,]RMa!9fg>V<: -dHY&AX1kWY^9QsAcg+o>l+X[_hS3C2`U#7Km$u&]hRbZ%dp5/hmKI1hgnjF&f]f!j -mJbH"hY*.>n]AN2n.2 -+"tY61\8oXo9GI0s"rQH6cS"RoRBU-?M3t5&+s1%otO&U5@7N"A+`'#`'8,3Rq;=/ -Fn]6S5bED@It."gKiXh&pMUT;gai1BJ\GKX2j\qNXeOhji9TZb^"X -m_?G7+2Rg@[JX8/r1CKrJ'V%Xe,2G`^7X6ZXkisk-2q9$b[9\MJ+)]qohf/uVC&:8 -:e2QA&I4"UTobXX/fbO[7,dZR7F;cGHNCfkmknM9?2PEpG;lZ*$X\PuRJ(EqNg@]p2 -@Bir$QX(B>jdq_[GLG!]jC/og\(RIJ\ba`Qs;Nk&W+J9nX/*T -59Z02AFc-n[U1auXO]1mI.hJCS^;'B>$VW18Z:*QFdg!eX'r-_lh4OgVVc$sgMXJ> -^%B&q_;TA.S6e,rOic^*q4-;c5G?KhFS_P7[pP94hKJd%h=#j(i9toO)JWOE9Rj6*Q:i#stkl -0+#NMZo&7ZE:c4'6]i"h"[oUP:D?5P<*'i(Z#j=i7PU->^-hE16Q8NM`-30@Z.+1C -8+I@H,"N>'LEjm?ZtUjYZ?2]e8huX/.S@"RY:N,,;Y6/,9=#&A0heo!cS<[# -1t=EWC*^2H:,A-t3_m#gmlXB%eFbapZh2p9:UCQ15u=p7%meT"2&/MN'AXa$;DaXd -8lE%(02,;#]baF@[.P;5;md'!;,jqL:JoY"1YYW([<5hY<]-.T>#r&:qc26*7IAiZ/iRQEN9;j6A> -eoREq)>89HkH@WrU1h+rO/-JN;k]lK\d"e#C-$O7W+pXe=/G4Df!het](Wm2CAOgJ -Z#%"Sca%C,2UaML)g:,KDEF0IJ*hTke\#ag^@f/-HhR<+DO_LJ_Jm.H&&^-UrqXQR -I!5V2nf3-(W:1(-=ol]R(DEB_jV5WB[$:Jj^r>\RhKCN(Km^rAt7bIZ[-Sd=gpD(2!:D9eo=Hq -_)j"an"%CKFO)u34_=!MS[7I':TnMFT7sod?RMV>=(.8P3gU`Vr[5Z"pC^pd98de$j2F!u).PI`MXe,-`q[5a@n_0/C(<8F -(ulcLW#:Z%2Fkjn'-Q@0R?I,]LrhYI.8W.!PB%^Eb7Tdajh/-j90QM$fnV7n32`+L -2J6C7]/=35fpd&+DpB6@3G1J=STD5`cPbn-M@bdrF67qt\c4s/*=8Aq2M9BQ(IVrM -'r,kGO3sC`7qitmV"D*Ydi):]l$YFeFQT4EHA>:2/O??.2PnqBP>u@G=/pCTYLV@I -p-o,]F,Gb7"YI.*QrhM9I(5gVE=mLKTme'nafm8]nm!Z(Dp>4uf -HbXLfIFl4-Sc@=>5De2Zs2Xn!-fBBeOn1bRA5/'u;^B_*M$ce/,rC(.",L_&OE1_@+2])F7RP0o?Yn__a0A,V_Xp1.+rt -5u]_ZKJp_Y3Jd;\_j!-uUcYP41dg=fSpW[gbWs(a6,S(86l\Q^6/0;a5t"C6`+0Cr -oLQo_f>MJt`-b'(CdQ(Q916]n+r!JalqPG5:rOQJ`10cF6-Vgi;8ld]IdUE^sA._@1QWKQ]kAcUS+]a..Ls -PPE0dIE1<7a2EAF3'RIh_K#g?7TPT(uKSZ#fKug'F8>q86,`Ban -Mb)e8aAe2@gkJB4[E+SqaYAE>%$\j:Q,rTAa^gZ.*1*1KO3*?Lab6.CI$;\%SX8]5 -8[OmWq8u7PTLndMas"R?>bfFMUIn[[alKABJT=@nWQJ1%arI;$`2ZGOE(Qk-9(].+ -"K9KXZ'JXub1s>H1(m0#ZqCP196(qC9Xi2][*+k%b9X^C_-"mV\P)"i9"_j]"M2Yg -Y07TqbO!*7*5'Kp`K[IA9Q\3EXM;u4a36ZgNSMBE[)pPAbbhbe9_?Yp`6(dgc*CTr -9]XUG4OPJh\BRFmbu@A2"PCt]36cQpc*VUf1tp4(f<$=B:#+LJjP\+tg!1l&P*FkL -7,^G=[E_J(:38tMo]8i4kK]N,:,M:^_&,p`mEVdK:!E%NV!uU(kg't4:?8b,bk04Y -'i-sccSPXIr:80upJ43.:OMua]YdNMrQjF)c_UTeb9>2k!)LQ8^@^tm,m;R%]MIo! -cuB"]<cEId'X0V_ZN]B%+)ZnZNUT]"V?^-%oDX+aV>00jV6)f;G]dq;-b!9 -"VFUs)3/hV;,nE&AJA"L*RVfVd+oa?]caQh)H%k*N\)AO7387!*E#ladM2T+D(!bs -,f+=B;RJ$;UmGKSIiaZ/O[J+5#c)_Mq(-nKgZtV3)kl+<0G_Z -X\2XD8uAFT<:s%FNDAD36@RG/;q5GVQb?3qKij7%b"k<.Bi`Jr -c%TKT`GS`l-.]2=eHKpD7;l1SD:_L%f2?;5Ie=1(P"V0CO[K[n%ifCaNe -ol+!_J64)/=1s78eUlEOJ_,U!=Cm3=K#-&uKik1,_Sq11`@G&mLtK"-=7)"#"cf/- -4'<#Q=Z(NXc'6X.P1aE/&[d\QFdUiChH6>:=`'S'eWj:f)-OYEfs",>!h3_A?W*5jO=fn[WIB9F0VHW'[g9%G\"Hll0YhIX2Qpn(1 -26tt9@Tr0-cV:e$-+L#3Z.juDgK9'^7D%=)\OCqU>P-r[[D#lXLt\-0gbjLac,&/j -_l*IJgiV4SA]WY/L"n9%gf;P@Kp#]Ka]uYtgjRMmrQ\[`^"fa8h)3TTQ(qVRe_EU? -?$*a8A^fGi(gEiih3HaMc-kF-h9pGth=S!YjkO.Ik?Y4K?8^Zp/^7TbiSJ)7h>QNY -jlB`bTj?45hR2I9Q,MOElr'\D?M'dph=0"glJCXgh[l=7eam-Jo%D:VhfOZ]4o!Ss -nm@[U;-ihO[IrFULL5K/a6!9Wec:aWqHt'=?cZ/Q`WKUJ_-cm?a#4+Z4_A(K#iI*Q.Rj@J'f_NZ@$V\D]Upi\YO]js7i6,N9IXg9or"Agkh4)e*\7i.`Oe`$f)\ -.q3ZB6I%4Ch>?3/0]N?!im'?r^+s0[*9%Gc@rsb@/i)HmYN&)5^h,OcSdT%G3Fg!h -j,Q7_"mTU+6,/^Lj5pAPhE^-c79L["j>KItr^(.Zm::Z4E92g\ZK>BR"D$UP -@--3!@ieid7UhWp?Y3dnjsF`[*b"2+BMhN0k,)ps?=r?K,A+r,9%I]gp1`\$MWV?e -k3PHIhK6$"F6>ECB*NNl%-M7UGiscLk>lr77XF68>\1'aBAJa6Spb8Dc=b.KYkEW] -7.4dVK]jC[kRN++L/[:oM6NS+BXU_#?ARgY+R"9/kghb-VNA#ONTh\^kC/KUp,2(% -P3GXHBbm&=VNtq];W@\AksdsFD'%/qcH^8rdSd6pm;g25?J*nJRdHEl -5PEWDf%X@tfBqS9D6DdNmb2O'i+sIMDB@j!B&;rR^2>:[U^#:c7d!%nghkX-abJpF -_ROKLmAZDjDRSci7cSCcn`rC*mkV$5k42&dk\jMqaBn.M:AC(QoC&ETDjL-/VVuI5 -rTbNpDnc8=:AXGmU$r9cAesiS0*KuWHE,Q'6T([-D$gJN6 -nFE":h[2cd%<1JB4t`boN,JpAR+pfBr)&Hp9=@9?YFW5"874[p>%@pVf8GmDg*H8p$ZSfrgn<%FE]`[msb%5+F$D/f,'!_ -Dh4`tK6W`0pg8rS2i@Bi9R!\"G]DP`pQ,++UNjhBU:62/7&5'?Oa1J4Gn6/8D_:cD -R?WWr4u;H;\"*97S\D;!H.SYa#G:i/T6_lX]-j(o8#3WgU&$^FqIc`&0;s2@W;YkofPHT/5,5I1/V[!M&;q57_LCRTTW[Ac[?>TIs0CjUBqpbt8Vc7B<3e^J.M_AiC`k -aCKA`Nc -Hb80SC0Ah0(QFsDDu!Y0B*4^JkOX!?5*o?GfBRN?h4EeJ^"Vt"Hp.G#+3j!@A,Mq5 -+1K5Xp3]$\+/dHPo)*oc5C_;Zq#A*J$CLJ$O=UhC_%99T"i6::*='FmN$SeIOK:#A -_[+Ha!C.4O4V#CAj@'TtE=>DP`6h7O'u^bq<4G:MN+BiFZ)h:O`R2nH*Cg^sI3-HA -jFn\sEX[c-7WM1e^rZ('SKc2hCniB#;QQiJb&Y_./P?[$QS6Pr%)jsFP:Xs7bnEe$ -29h>$gl9L`N4CslF0+Ib:6W?`4O950rB7fWI0CJ6oBcQGd*tbt7F;f\'h6UcI3eU7 -FK@8g;\Y3I8^gZ+3D\+H%6[Qf&e-EkeJ1eYM"#B -H!f1S%=4OFQ7FUr=E[,u@9IbJR:k4(NLOXj<]-u%>*bGICtk93]kq!imDEklQG(Oa -h%rf9FkrC$h07]j9uVD5Q`\;ThNu4KI,C:FT6T9%^&*4cQlZ]d@(8Z:K]/75",F&3 -?6t;7Qu4F2in2O2NPmf24ceYA%RlN@R4_3ta`ur*Mrg@5?'T">DI]$?)+IJkk8BS. -RV/&6H_'?PG&<^^3X1S9ko)1 -HHmVhU3l>(`UA1m -'utKU5VpH-doSM*F\FIbLAcukmt?.\cjO(I#+4\oqE -G9'b'h02$=CYDeekCqf;^+Y9%Ga_]b=a9paPNV`_O.GNE^0e#.q]=(kmJEL?#O2.- -LVrD)T-)=s-M^=Ic&KArVl88kl9QD!J!uV!^Kadrh&N_ -JPYh?^mGs5i%etsYYGG=kUcr\]G2[\75[Ae4U.S_)2(h7ik`]1$/n9$Ki"of(oU"6 -i=%DnE5ieVQs/lcS2l=#mMa!aFM4BZ@#*,>*lM01&`P"PLbUM/7+e%Die-!B0hrr^ -8kDN/YS!@(ZRnmNA7"^-()jpj+ME4;9h3TaOqTo>^;=6 -i]XpKl@S'WJWE\950-i;+4,CgO\uZY880"e`AEC6;GKhU=Y1rHFHD\a5#+Z54Vad0 -"I!kT:tj[5#m;U/H==`#bP_%r=L\ld.dI4nf0\N(<)?;+LO -0r?3*Qq%p%bh819k![UB;_DfZ=fjRD`'Kg?8n^r0]f/p_feSb?DGF?V3TgH?S4d=5 -cABe-B8#`>;m(FB=m\B8_h=T0mWd("jZe[!q(ZsmIaD6t6)Z&HTLLhmd+T(!kWKMF -F=rGJ=tN2,_UkL28r-?U4\&*J)).;(N`'%P8a(jP0[uh\;@6W$l!\5$<6gq2>&@!n -jY!DelCLo]HUR,7H`(u^U/X15)JTS-W:^pueCp-*]5F\Ac8B!+uL -Y"#GI:oh!YZ91an`+pB-XAuF/f"t'_l\0>]@]T!MIXcItl*BIuZP -[8sFY>&.DXD2"]tp99/&qdjX3[CJKpd"C)REGTLb_)iG'i`o]IESesW\+_N:>glVk -Y'%su(Ja3^CQW^V`RMLY<<:m5]m&oKiG\I.nm/<@G83!S]XOX/?FutVYBB$B2n&N' -lc";@`VI8BIehmUl[:GhX1_U6s'QfQJ`9\]_&*sm@([I`YMKl.=AK8S*#jI5`YYbd -6O2SO4,<=Ml+$M8&E6qd8MI:r`E9;Z-[rc]V=;JAmi,c\E7o5K -6-*1>+s>*ZOn&-:[eS;sA)*W=A;3.eq(!k)9WV;N/m6A#D_;o4X-E2[?]UU2/*8D+ -RI^l+_-*ZoAo-4bZL2_X=jK,Fbh\i]7X2+]%l`\,oq19q;U?Xd98)S -kWKr[[!Mr"RM/;-*A%4I(6I!K=&%Pb)5m-3U!%ah:24'*k4G7Ce%2_]<:)KBFbZpI -1WN@.?#?_5QEo+GZX):3H*;Aq]\$0/&aVZ5XS,%Gf,HATCtjfOp4gT@9lj;$4eo<+ -[#NW5?Z'_OYdcT7iS7Xt^2;]@\[OtUfDBo:mXkhE8DVQkJmkf>VCbL*[egL`tpgaa,KO`4i_=3&EI)W -P"Ufma8%qB;OR-@o%m6ecK?2/goHf`36B9fa#W<[s-n(9IE`XR(?bViTQEN$bdnlf -ke/G3\83Z?B=VfQu^plj=u=G)k2/ -q+k>ah9WK8rls9ra*DrYe$sU.rAqK%J+&s>R!11eiVW)#Dr'a!Gi'M"HmagA*QPtk -0.l7/Dhdi^:X46nn)O?OU%D&Tb^&)=]_cWEoj3!oUlGuNrGSq67@2F!?Z#2bVmH(\ -ZeZBm;sumT]?af!iHsI7n\)ubq-P^pHs_s+od@NMhbW9.mtp^da3a]2lfNWQ^%^-F -g\bDonftoGq#72Qm9a5nIc&V%rs/)n?d1BUs3^fCpZMM4j83j-f`//Us,C:_O9kok -%&YcQ!AFTF0D,?b*<8](s6q04n.aX(%g)5T"!eBYO?!AWeH)m;!jG)Hn0J3V6NaG> -"&Mu$E*+n-;$HGaVm&GictN[mqZO-?#;BVHYZh@:I0\dE#>f1@CJ>"PKa@1(h@Es! -E1%"D;[7d-&Q(D!E%_jO,ngU,&eRDDEB`.I.hn+/'dp$qO]`F&itYEa('`S/ -;.C=QCt,^c(9qut8^eF%I2D@9(QinWm%Y#PM&>c<'[YkX&VV+-K' -<>L_!)3M:Xd;p6]WuG]l)H"HnDTa!Hbo@*,g%!H/n_"2QQQqMfD*oT^9dERX,SFH2Ea3VT9.$rQ-RK]WP'JFV -kpI*X-W4e.;Lp7%KK!pi..W!>BYc(ESLNo`.+4M47`cS^W@IJ9Q*QT(18QLrLFNqQ -/1`;%d^^k?.4CA(/MbJ;1:Jfth(;OD/i)M&'&P9]lG-9I0%/9&k$'FCpFl+1)j9A< -EsXE3"##iJ@1o[s1DqnN$STsJ0G>GE;[Y@e/@#p:1,Cb#;Y)\#4Yf?01(ul.F$N,l -0/W8sgp9X1F'-[c4#M(f1l.2L;e%\kAE.`02`#QUZY_Y-9/1L92Y1[tdO."qKfJ7V -2fk6EC2GpdSLtQb3V/@mcac$AV`OFF9@K:jF1@sNZT=;c7l,]Y1VZ!ZT/tHE4Y`'\ -Ze7L@lTJ1k4srQU1W_hejDOR'54eG2%Z`d%rBKP55EkI\e&O[p#=.`B4VSJn<"(W` -!C??#Q?4!2EOS3?.7(2c5;Y#\DeDBn4[\H[6^0;kEfiPM7muu<5HTi4'M1`JO[Kml -7O[._1g:pK/Om*e7E"^`<-(NmY=;KB819fpe;4Y,Db!cR8M,?Ye;Hm4S:bp;8i3>s -e=0(7X%;lb8b7Et<4,B+Rn@e=9IL!91s#kWYt7p<1K8WmeBq!d"&)\Q:+*GD2!FrR -cV9Yo1j%>E[.>PBj\POLG#\96DmN43#u@k5:NYDhmYOat*Dtu3;3_qf2%kF:M+djF)>+R^Kg+;>IE!eAW'h/aZ:0U?.J$H_KGZk*3(\dJ9nZVGKXas6pf3$X=bZWPL,`In=CHr/D2,Q? -L7!+cG[Nk"V?GkI-- -o8i\BO;RqX3=1dm%?O^)OLZ$dq%]%&)3O_2OuXPG=WrrR/Vc=GP;tLaGr_)!4d5\- -N`dlsGq"ug09k-]Pke=E3E_Ub?'T\BQ+:=hH"E;PA!Zq)QPjY,3I-s:&!T)*QoTkM -=7MZWZ']g!R5m-k\TO=NR@3l!RG"@()5We4WLEX\RlRU?=g=HA]plRKS!h6OH'Oo1 -c(+UWSN0!+3PV)0fq%rpSiPPsH/Y?_jds$QT)&&Ng%h7#qk&,:SQZ2iH3p7U%=d(0 -TfN4JH2jSL'qs>!U&$(03[pdA/Y[PEU:N(9g(0shbQ&PIR+arp3^':M9r.V_V)hVQ -H07fD5R/LV`JsuH?lF"IAcpmW&fX2HAST3NMu]9WB-%HHE8"c)gchXZG"7HJ,F3h6$P4 -Xub[IHKhTDmB6Hs+G$?,c_M`]RhPHtgU5D8uKna#nLbI!NcFIE28: -a?50tI#5qWNQD$[aZPj1I$r*hS]Uf'aulNCI&Y9$XigRHb<32UI(@G5^!$>ibWNkg -I*'UFc-6+5brjP$I+ccWh9GlVc9146I-JqhmEYY"cTLmHI/2+$rQkECcohQZI0n96 -%FG%cd6/5lI2UGG*RXg/dQJo)I4QUiNS+2lffbVR -I@8d%S_&IL4rH%H.3tiBA"8IMq+Y*T?u@ -i]\[JIOX9j/`Qaaj$#?\IQ?H&4lcN-j??#nIS&V7:#u:NjZZ]+ITbdH?02&ok!!A= -IVIrYDoKPe:InB:I:%\H_oflILIp)HZ?1n5+p-3-^IqeVkD>+!LpHNfpIsLe' -IJHk^&.iG -r'/0uJ'%W'c2@UhrBJj2J(ae8h>RB4r]fNDJ*HsImJd.Us$-2VJ,0,Zr#cOF'FkEQ -K0eH-QrG[U%>R=1&K$a-.2@b0it7[.DE/_u8)t:#'TPa2P=ajKR8g=l/XK,m',d%[ -Bf2ASk7a95mWgsf:ZrK2'b6'hUJ^7iRT1u.9rCqT'cN?4WE$!!lP5l=DRj&V=6p\A -'opCIZWZZ2RoQWED7S>PA<=EEm]6bB$q_ -7FQBbG@fNQ?2''5H!Y]kl[)t4`UeLbGNJ^O?hag-JRE^L$\Mj^7MCJaG\.nM@JGR% -M.1_,.uRm3`\WTaGih)KA,-T(J\Scbklaq'3`q-l^Hfk4?Du9hB_/OcL$c?r]7h`j]HtOD= -EVtS:a`;d,/'Du2a"tt]I-3T;F8Z>2d<'da9@J"]7oRr\I:ld9Fo@)*flheACYO%2 -a)g'\IHPt7GQ%i"iHTf!MrT']8!E%[IV5/5H2`Sol$@fVX6Y*2a0Y/[Icn?3HiF>g -nU,g6bO^,]8(7-ZIqRO1IK,)_q0mgklhc/2a7K7ZJ*6_/5PP6Z?k`]nO;7p`GS(!b -<""8=2?uMB+Tu2;'7uOHpPHGYnfV<%EZa[MM:* -@16S/1PV"B)aeji%UmjKLQM3O6hl3D@MD1cOVT00G``VJ<(i(12CCofTbLt#;i6]< -.n+]f(1PctMii097JO\9@h`F3Od7dmGgRF><,7JU[Pp\Ni>c?lF,lC64%FPc*b3]H -O-0-#8,30.A/'ZXOqpDUGnD62>'6]/nNPEQ]h&L9DO,mAe`.MP87Y% -H''jo<6L\n2J5_ZTepAGe!cJ$CJB)Z2J1InS!/#6:&2UbB,'BrPEp8bH-nZc<9p*= -[WbLBiB1b;o:D/sHV\qW5%iCBT9Jtu:\k)WBGCWBPSSmJH4`JW<=>Lb2MY-*+[g"/ -';C^lMc"dT7VLNRLBb_kgPa7M2H;R:K<@ao1[[0ng@8(C#1T$DfRo=WQ -:2/6?Vj-nI;u2&AC)'+7Pnp,oHBD*?cl;lZ*`X&XJNJ)PitjDAC(!QPSUdH]`>d2Wn?B -Tlb1;e%1lHlWnkBG&Gjb]9d^0?2MH_D\_b[eF,*iI#R/o=gRB -qd4^?IW*d6^R+Zo?i0qTE#&PkQkoj4HkCsLg,<$XnE;L2b]_ -_jGWY@JiEIE>Be;R$SIqHr5c@<\).V[hiNO@>o2l1WGg6)e488NcEW3a-cTCA,Ln> -EY_$`R27)YI$'S4<_LQ&2^`/6Tp0S`;p(M0.qO+5Q?(P\bF*Q-Ac0B3Eu&90R?o^A -I*nC()I1`2q@o -2b.Q[+f'4GPL>n$95/f/VKCCYe!bJVC&L>rFV^b%R[6rfI8R"e[o[>C@B=U; -ZdtSs>AJY,Y'&=-f:)G@C]/ggFr&!JRhoRNI?CgYh;\G8B5oS!O9i&-~> +o)UO$"Yb!(0XD3Bo+<]5'esbI0s_lTo-#kF,q7gJ+(>-iU"UUIiZ+Zk*b!P?iU@n> +rZAuT136/F@JV'srZ*/`+5s48_>Y;q:*8GT'*8(L@3-NLM@tL>)$)oCiLCY!rYo9l ++5uQ,dml7$:H;]krX[p-4*/"qPJ'(%"p1Lt&n#;n +iN*f93ZTCC++a)FPMn/<[)"Zu=i!MTK(+toERK%)?jRK(I8!VZTgcu<@pMP +(r?1c^pQQE4[_,@7W`K0TP,G+J.Zm)8$^2XU&-_k3CZu)7^S(Ci@Y@VN#gmW2)K_Q +o!LLlDA'=;9!jRMo=>Q"AO>uR*d")KnuNmRfGEKU9%7cP'WM`f5Terk%3b]k_8/eV +?6.P[::0C`o^P^6ohT]*:UL'ro`7lH"]0=J:pga/oat%Y'iB)k;7.EAoc[3j,uSk7 +;RJ)SoeBB&2,eWX;mebeog)P779"D$<4,G"ohe^HPHV-8#@>.(J9os%^Y +[9Ida>ID.Kotalj`E[Q->d_g]p!I&&0&`)G?+&Kop#047j^*)o?FB0,p$lBHoj;k; +?a]i>p&SPY@N>Kf*^QM9J`mrE3ZeB'%,psni*f_ecXM!,+2J']U%f58=rm^O)"n,C +p-E4I7:^R5?D0[kiBq/L;e6_EA[Y`Qp/bia?"R,GAp/$'[W,oFF_:>kB/Y$Jp3gU4 +HY@SRBU4?c[ZP7sQ"\a:Bf;GpG+EA+Tk\bCC:9sReua;KR/I#4j;^mYti!J"8SJ9VNR\.O7Y'nH&qJN+Nup`4rG +)hN;XJs[j9\1rU121jI@K/brFGWg^>6%jJIKXaI(fL^bk9#< +L:C`Jph>L#D21)rLNn6&=Fl7;K895ULq&:tpkO\cNJUc"M0PSJ\=nbHV2=uFME%Sg +pVdqWc5K"J(mB#"!WE_)Da?WH+5m>(QfX2ckr^*e4.uWU62hY8mN:E5)L)4=f^Xj/ +onrP9O-o[&\H.ce"cq=CO?!]1Gn#lr&Wq>LOgu3hfboqJ-'C8;Or5j7GqY>k0p?if +M_Sla6$#)nXqQ>A+5nGR3DVk\ac1RKI^moq_&NVErY8F`)PLW/=YlC)3Lc[Ta1a'a9:1'S[6*D!'VL`:((M0)O#kM(]/TZOd]FHR[NuDq>HsHqk/69 +TUH%W\e1V3'qj7uTfO-dH6&_@+bZ8c';>%>iVji`Z6/&D)->H)62hZ#o6oPhS^_Nh +i*%5]1I"0(=93:M)8Z`3rXeg$SGI)3RG]1G4:)&f(a0Wh+gF'(0UTEtU&'bI\ri_5 +O/ZCC(Ld:XTZA5I +e0!WV"$"Pb!?;C;ffGV6+5rnOHXWaM1_DuAXV8OZ@9L$$,<);K+5t'RiVjl! +`Zi7h9>T=$_>YE_Qc)!V`*>mPpp[/&(@$gR_fqAL)(o`Va-HVqe"%5FKRqPKQU-6jaiZ7tJf#_O7I2=Z8Vn ++5o;ZRql+L#Qje<#914cgV=p0'UG9td!ZASrGC.LCY*uSf:@'9]n+f5LX?[`8/m36 +qE$SY1WI5LdZ_SQg=`&ZHVL46bT'S4@@&q32@*akg)85]RCj)tom`1\Q9BZOrI`oH +L#$%fh*'TMIG`koiRhFm%3adPo5kU.nfQgS$$p6,*EUqCrZC*(%,q6/>YZ?iREZb2 +.o\#_TnD9Rc#k03NZ6C!RC1i+j5YRNhHiA*Sj28L60*J`jM"!LhU_Q2qom=Hl!s?I5)@urK&qFiVpJ]Oi +j#?pGPb0>o5:Q@LL%kV(pcj]3IuX7`(%T_(8^sSao//=TKFt`3N.4>bgN0S^;o,)( ++5sdJ"!Sc>n(T#b'H0VRoDLokee.sh+5qWA^(m7rP*;N!rkF`thi[q'nc++-s1e1K +"P#8r"U'Cm@1[Z_)Arj9_Vrk.r(\[UMacYr()n!Ka^qe]m1u0kJ_Jq0[?aV]_fF.Z`$%p-'Yn-J4 +h*b+iY"t,Q4&,_JG"XYlZIOp:=ij^g$X(]hB)-H_;t-3 +I3*l>S(['"qYf:nLX4lNq0fuLJ(NlZq#*q3tF^K"@EbhE?n0j7.EZD'h*+Q>8K`uKK+8uL\[`G7^9L32':np +H@M'n;cb,"Z6KuI!XJNl.A,^(`.+.BCIHSkL>+D0`[O4EHCs@4P(/eX\c,..;CmJe +JubhFdYN\SYZi44WS8t!F/8+`:@7ru"]'3hqZfo\r;AlWF;50Kd.AUr6W#[O(Iq>% +Kc?=htKk"7dFerkXi<"Lm+oTGl +gl)7<$X<^mG^kpZ3H.+BV=$Hd)7b;$J!.XnD.OA)!WHPk-i)V=AD5&0X[SUp]8,A" +#/.8,q\IA\D#5:&ZY`o9f=,V/L=s+SmRF[tDYqHF]l/8[qnI(I#6Ve]Hm]<>E:+>1 +HVP0HZs;A6r5(jT)Kp*V9a!F;*X@JrLe)U"q9j%o#GKaU=2[WrJ*0?"O34[0W,^,J +PDT:anK#Ykh'O)=Harh)T7>gE4stpAG^_l8jEZ2US)jDEA%CFlI]'74HN(skm-1&`MO#lbWjNVnZBr]%o"ruP[L^q4f*[g2]8%Zk!*_(c",ikVf.`Oo?7 +n_uR'1jb:>VAdMMBcpiCJrgTT6V(>l+XC$BO`Dd<2OO@eA<`:@P#b4IGqgXVe=2Yb +G#&^TmQ=rT`0=d0@#25mf.BtaBb*n_sG&L+N_)Q'Aj.)=!F&%#. +3_<`N*@?W=%.Qt,"!mFZi]J""p24>Eb=d"FPUd:7OsZIPW#t&aB0IKm2k#hk>RQD> +7:Q>I(I4NsBiKKkH.>Atd2e]UG&,Li[n(3:,GXmsO]#pc8a0-;UNEr2;YjfqBpCKO +Ph)=&H>m$-i;5Giobih\S1)GQTF$h@V`NcB"pb)u+6"CRO8&)p@K[$QA,JrOGUN_F +0T$!*rH50PG>;ofS#&!.PZE*3=t;IEXd-&u5I8q/Tn>,QHn5h.T:)ae[r;Vp>9*OJT,KA_mkBQgUQPt-\=V` +&n'.BeXDHYK\/U5iqPiC;0G1Se_4)JH:a0;i>m^M3_W#a5QLU^,JdnqMo/^[gfr^p +Xi7]^G2E(&HgQ9#Xo#jLo)1!Vj+)(a"2L9?"(6KgJoFY=G,(^FVUXHV"@3!Zb80(qiq=mPZ'G:-QiA"74E$4!`]M4> +?Pm;NJWOmf6cbZ3,@l1`;WtXj/\*RE%3\b:`R'$]!CI6rX3QdB?0/'si*V:^CQr`/ +kC99)?&/cm(?aHdWRAXd$o&a5f4gYp3Rq&b:lTXLUrLe66HHt4\6YLl[ +U3'Fod@)t4O0l*'LG7+1k![9$nL+ie\n*OLTF@/bn!*/oeJL.!r@BXfM6)#7F4n_Q +B^K2a1`h.tRL<Yno:7B3c9IP%b0Y^c#L +ef=&tU(M/X<[?Y5G&6=Cjb6W[ErG1F2nq02>h>A7IV<`sD`d-PpRcO+J^A]XFgI;L +IuMcACr:Zg$+ck-e?-o(`0`>PS5AKCGHI^"K+@1#3Jj(D3`.cWT_d +<`3RYF`fG2lm4r24pK<"3.HlG5&%TUXEBLW)N)B14,3j/97@i3&cVCgHfq^'?J!nX +IqS1O8$DZYpYU>tJae+)_`/EO`GO3BBZKnj'8\FkGpb3*"<\MkQTK:k9sp,'=J'2B +8'5!Y/RjG)d>^oYid1'5mCh-9rL^:fI]q`-<;5STT@`siJ+,*RmY7$W$.aJ=XU4m?-ST5%P;PpI=<[X9V^Z3'n +PS69/'>KJ?6!P-jC_X]2(dX)u6(AiZX;`o]>m:9sP"?t,b=jb@.QD\(Yg?P_Wti"/ +ItpR1]'DeniG0'60W\F"3?_l95V9;K`^.4e_+ZIIA1k]?01-.%6Q98se2'HS1daqo +6X2Mr9E,4s@jSJ_04QV"5p7W/TGdORKnqV#>NV\ZA?=-qL'#LOda81J:V\+m-8[Wh +6ncK+0gp[M7#X`+S4bHX7`4um +eq?tW"MrAKdP&SOeN%+dL!W%:Hm#O(W.nt_4\O>E"%G\CA43M0`4TYNCh?.^jMj#j +7\"3_XD:;)EIQ@0?q>1AfBWTXd`lfPq>^o4bJ&[.l80!1O.[ETcKLedj86gm?Cki>TFs-AM*.UR-]#Gke +$UoTa]1MW'F%`SBY.d!4Ws[/t&CQ.ie.#;8$g:-J&6a^bgC;'(aEn$1%%Bd5S&dFV +8_fk.l01d8TLoWd8fXQt/2\PHC'AR+b".#9Lc2S3HEUS5$mTL:LfCuo@0C,.Y2`Ts +lHKP0;?aFp4Ltii?q,]?2\Tn?%()c^,b3&*SkFa/98pGTS4cLk]M$J^9AI6Sl[O[m +?+;C@7HdR?<5PlHWJh`(&kFJufRJXc=rD%@QHT5q34TqE8K$j9"Y_Jg4CQI0^FT5m +9cUah,eHc-e4hCNbm`/tCtDC/fM.7[2WT$:E`0'F*[UHsRE;"QK+cH#Ks%3VXSaq> +:gJ_OE(?['N(PZM>!+!&;,*4YbtQU2<9hcAl;#Rh-Ih9Tm-d^In4sJ_,cklEqTCZO +j:_O+*7Wfc^sji4dkMdRY1ubp;\(["C/.X(*JpaH.rIVRnYp?l:;lPH/HSa3!ROFP +:^mV*D$Nmc#Z-Al`o6MElY&QY]E%Pcc<=6uN=*2Mm)rpW7,cn9P:-\2;hEF'V.:)> +F"NPi%a^A\crC3F2&]?*)c=iuQi.e!m2o4(+ArXl'bnG3!eDKIc)i71Oq_%cK;6"K +E/$J%8)`3q<0IK\OXuAL%=5/dS&^8n>,/qt;As(C`?!Db1f;d[dlde3,r\bN3)bes +;jaaHjX?+r.0am&Kql\bm3R]1:=J]-!\9+"_'m>sj@a1@ZBHa@\^!J%%P3G_;DJ.m +of=A#2:Tl.<8BH3m7gRM#LpFaQ>4K-a(^aIc,/oX[HE+FXC +J'b8^9ko?P!M;RS%La843^h^YV,SWB:Y&68<`MssD.YHoA(HWRaG/+L6[=^"b#&eI9B9n=[eU`ooe!VQs#E:=dupo,EK9C98*bNcf?0+V"V<+?8Fl+ +#Q)h0o.eYr[NK-_4M:V4[,>*Z6omB9^lYVW?[/jsWD +CrBH@<[ZNq8O-Ii&839kcrD7C_gm6Qdh3[(1bh)"b>T0KmBE)IX]i-K>0Xn=%Dk'# +^YDQ&>[>?SC9]O"&5`Pk=>b-Mq'8X;obpu1\N3p9SUWWj9;R#;d,R%8m,nUV.a]9W +)V)`2D8P+W_qfIfRuPtSXkR-pgg/&nWsdt()`+fV1fmu+*EoQe@jqhFXM^=,2*0h. +F";tpL,*Q9?."_hQ0V_0leS-!?H@b*V=.ahn6ZXp*QmGCCl6)poK`'BV0f8Ir!?Fm +DVF[-#)\"+43:B9KXX\GR*G&*`W'9#s535E*c:l6/d#KF"COf*Y1RKCMHY^i2AuH[ +=B,"H<%B)5/%')X7O?j&9tge">$:O*8EfbrNe7T#>g6f_9NAWBr)>b5MU>\22dA_ln("^@o/ +>QlCmfQ:KT6-EcoR%YJGDLhMg*:CI1Ke[br]9tM(E9."."GXKj,L,`aFL-f@\2Mm7< +c!]@`9Zj+u5_%!;BtZkhkrB+7:53JsRq^0&[B>s4m[n4mTLP[$,Kn=Y,D6.lk<0gY +\;I?8FZh2W@CFISM#DS*]R++>d8ZQZA.GT!#+]JJSa-KbCAYR,m^$[mZti=o/EN?M +pgL6fQ=S@X10rglQ4#]C_lA$ +aD?mYCn#rKY[%ZsFbEtS?WN2UFu0sfh&3+KTLlN;>HFAa +h"K0R`l7>Za)/i9D;8glY2=*qi,/o+1G"C(Ro*6-t="3!oMXW*EOu]? +V-`7$h1o*S>$--6@5eN"XHPKTQ;iH::2>d;Y&2-"&rFp=n6ZE?V]0WE(3,BUEShgW +l.oCV/)`0gKGhkr`m0bsf)uZ!l>=.;[CGbrRSU1q64XeRSu0J!T'#2a$$RA/Y:f@[ +067I6o%u3D0/IZ0N?uONQShjml7?tZ,E,>gWX\\I1^RGh1^S:;VeB`l+B*m:ZgPpl +:'S>d7m)W(0D&$pFB:/q-fO_"YC#'COo8.$\:fY$'9;O7gFJ,,N +.Pk#5=hK/7;!!bdC,Tu'%s9"SoOh?L?X%Vr>KB$3Fl-MJmp?O_P\gq>2*A,]R@;H; +C/f;R"[s/1[XM79?]"`m/MkjsJRqM\ZZQZ_En=UiY?Z8NDg)\Fp5a6<06;=sVCDN. +Bo;GukZC4>LJM_/l"-D0C+%RXOEWsb['RSC4<[a&BUBFiqLIub,E-9K\GYa&8 +#CUiHLj4u;#o)U)iS3%n\#"]i0$aZoJ4?A0)8#A#]-p?;J^#P_FoI1#H3 +`!Xqbb632s^OR<1LkSTT@Q+\d`u]UM_#+/^I8AE*#L*-rfR8cd10acCp/ZMdqfLcI +f_EF\F%e3*#2Vg243EAIs-2$%BYfI^f<*`U*p5 +rWNCU6"&&a6m`WVL-oCrpk2*_'8f4fdM8S$7p7&Es7Q:kf; +q1Qb!1R_$Mds8moFZZ0jB@H\\#),F=;/"I*74+9mVGh3YqLqD8;lWMq.u3u:eGi+! +TBNO+I_p[D5L89R258E2[T`(LX+U@+5_$#cn+T1Lrpk-FhJS\Wjlod^@;skH7OJq/ +QT^ncp4A_3TdO&^2Z0o[(alDRhsJDV1I\(eBlr'REgW;meS@$gh1i[UY1d]8]03Uc +EP'uoG?aIss+S;KE&cW:58TI*j`>]0rb"ThdHYiMh(H`LZe+SgH_(/nLV;^:Gl6E* +8!DKdp%j*.s*)NbC1n]b&954HUo28\*i$`3D=32BV61AK%\0g&>%]a8*;S+6VVW--T:-aU^Wj +"OR1n;`rYgc'*P236ee"iAs_4XRSBu;mc?_ca2F*5gU2bs$G(32$lXt:;"b>dF+8fjPI\3q)Iqm^5G+i.P!."Uho;b/*)P?.P._qXg?W#>G8GSKFTB)qhcL[RD +0M@16q1;$Wk=Mf+pYGZf]'h_qL#Vm!5DS=phH,j$q;-%`k'C?`Vs(k/#I3Xm?Ji<] +qqh@hnGHW8an!@4EP?pjIE*5>a+<# +clJ");;+7S_Sm6uM-E2ArZM9PRTp/4]GILS![-M@HB'D +A1<5:Xqr/#3t1)D229K7*(-*9%cQJ3LX>stN\Qb_`Z]O@+`r3jJ9qo<=G?p>8_Or2 +-4L4TZ43T,B8TRc36#)#*2>X0Nei6'j!%qe`dH-jTY*M-80NioTl7(K`\g2:k?Tg. +4=M+W$mXgdO4!A[a4UJ9j:m<01*/bQM%&t8b`.b55"J6_,p_QIQ'0R%9GHQW(PZo/ +*$ZL'^[YVK?[M=#0M2),+Fbkrpo=fJr*p%)3@8=5[5?q*e#K\P/CA8&NUTUM&+N+' +QQkQFo%IUsW=q&J>g8C05%[LqSMXrSe!e`XCe[q411oV'S'uh*:)V#1k9T/ZaDcTh +aMQ#0$rmbaaeq!V:FX4I+!9K)(6@uX'hA&C'D(pINrd?_kTpB[UTeVHnT#](Qn)B+ +Am_SNr\R&2>+jAMUeRjH2<`iKUQg4g;AqVfkli?.<0`)5MH*:5AM'b.^6hh;APCtU +p)W8E]8D-J6Y62e!Mu6WMU9LV"Zs=7o[9O7Otuk=prO1D/Z+=(,qm2e0-B3O6e&-C +8guW'V%fN*pAe4ET+.Ai`+6#-& +8sH;;hm%!i"8lC/WBDX7E8Vi-."AYIm:>I-V1<(RE"#VC-UL)u&AW/i,s`sG7EBj[ +92TA*92ppe7:rZ&[b+d\AS\EEZ*q*dgKTl$C@1,r\(:Q:>T8B9mN[E=O>'mDJc7;* +%/QT]Xnqd5iYIdb8R^Ic`Gi#DoNn0S=SfH16(P*A$4g^Ft+>XMeE,U.dSd8qc) +:odH2*SS,.)]'iS@&udP(7N#KU\mXalmsVr=OEJ-dS&KRs26Ksk`Z7)*>U%hhC&+P`-a886Q;Em>-I8ulH?E)JD +^K51k>H7?[[FX'h>\fmQY4^aCa\c[:O7>>k,D_3[DT`D9KqhkXBAlAD+)<=;qU!Bsp)UEKmS^"b?7dSr8[MA4)jh1>bp"nH\Ht+2; +5DT03+6%.7fQZk]/1NS^Z)hIBL.99T?4FUfkD20udlPMD_htpp36H4B"BepD=@6b- +:;.qI2g6S))o%VXDH"[Q="WNk1Qh8MA^'tJ2,iScQr%ROdET*\C`bbud"6G3:!Y6O)Y!\bc( +&0D3TNsTch$'!18YbMP%V[ANd$HU6@"Lq+N#cC4\+7G6o"#,u`2@+8&SZGGnn?39i +6748(X[^L&VCog%X3YhapalT%r-9,k^lTj(J=H=VKO#0[0Xt8',B`WA_.=nKERF%AB@-Kk=AgKFu?H(.mB0 +nesf6i>qJN*R[.sP!L>@69nF+,goI7&lU)Q.h/Y->cp1jc8uF\]Nbo3fl<)m$m*jf +=!rYdacH9K7\%l2Qn<3X%)KRn:7!?'73n$d.FLX7&t:@+T+Fne.akLN'!j)_G1=@R +)K<'_Te_sF>5'0AWcD]'M0ou[3u!@?/^W6&EoKF0Pf0M\+6@b_&XZ2uKe:Ik/jcBa +;ZeM5#:ad&0N/D9')s[b(GV*m1!:oO+l4230XF3#-7uh]#%21^Y'(t7&4dX?VL(&h +7R@J6nEh\X9[b+U:EWDm7)JjB9hK)_818Ni2U_sjo+ipXAFo"%42O +@fB3m20"upM1Q>T<=I94icGeZF59!CeO*:t6^0f&Bt$GD7mrS77+=t/beP(C`YF:Q ++L2@Co.l1oW@/pWlYK2k+lnS];+H6ON:8eKiDL&>fT"+P9*d7[9u@CPA:jcY +Y.>%>67$$QVQi#nhBJ2\:Xl@9FTYG4"],;*:R)Gf!`U2j(K$G:;:Qad'dHUV-W63[ +;UmF!'f/cg2cGu';q4*3'gkr#7oYaH<7OcE'iS+4=&kMi'Y@Gi++VB/$r(1HJE@1XM(8dg4K/CTt<+o7&3 +q@R+1+(6c,iU.GRefLN4&b@7donQgQf3OZr?.Ih=(#rV#k?aG>?IeLO(%Yd4.NSW% +)1h2k!9>5q'Ej!bAg.)VJasKTU)ma''GZWI14_0jGA@>!=el-,q=(M#/AQE)JQ="6)@qM$8B%CU,p1n:VG@ss'B/Y6PQ@W]" +K4pR+B\%lO(5llbO(hXaBpPB*G,&d&V.pdDC=]G$(9)(MYA8(I8BM+\2tap^t;E>/2C*_#ONp&O5ID*s#+F!U(AO1*.UE(no_*@F?1H +MfC[[Fk9uD(LqViB6KVWG1Bb:U"UOg]G]8B&]+/R^jU7dlZ40k++YI;!ULT\!I"4, +H.S[6f&LWaVeu1/H<74pQ`ka;Z[8%DHe5`RpUbeha*^t3HoKB!QdL34ds[S7IFm"u +(YaBthgSYmB_S3%J,t.#msgAZIi&-8(^#:j#Cr0LJCkB`(__I#?618k(W#GRJFRja +H67\T"TeIK@Jo[0R!W(d]"SoFi@'+3k*$Qo"lPm2MqGY#(qGT-^PmETN0qqMf[Gehf8UX#NE=G`i?Zugg( +"Eu]MQNGP!L[bl&n;><7S%7B4m(kI)rs.ng"\o]8kSHMVQ^X?>RecoN\c\T3':p*M +T\9pM%Us(SqU&^[>Ccr<;3tK!173!ArdhHjq&Q.i2C_6)\EmJ,aIaF6jV_FiBUA%U,RBn6oRVf#j +T%aX5hgnD3'/>[SYjXTm9%mXQ)I9CI@B2H!OP6&&)T/X[`i\XJ)8S_3_>Y*uLrB_' +L_[.S1t;GU4r:-trmpD:Rdqo2p+N^,(+J+uc8=R;iYLn"8/]B7]">4N\$:7mZ.g1C +qXq-u-aK3kP&>Cmfbj]3ACrO_SE]$UnP9:EKY#!Eq(0'Cq^o3BU>i_..u:/-nX2^c +Jr'rDNmXsp)^2JUGHq$j[p+0?qcC:3LU`h2H_KjK)4R&d)A\a%\Yq*dq$+%_3N[,J +/2RaEgTi:9R?f;iTtpj5Bn*J4[b=WE5$NNM)h#D(J\=.t5$PG/)rnY:k%F-mQZ<8B +"K/mnJQj!"R;dAH)8D[;285Rf-c[A>]=X6i,mWrq(R%'?;rbR(-bXmV^"b8;Hk!tu +2oD.H;COM7M.%B44pb-T/(A(-.gl(@aTNK/0.S*(r&r%dK]6g875+S*m\qVXRBoi8 +_VBXX]S"*AKtY-3aP;iu*0NRF;TkPHOX4C9:5[^=b93K^%#0jX;dRDDQ-!:B-n?G2 +]4mZP@VQ1H/9pnMS:Sb/f?IRTaI,WCguH[bkK\[,\FHFn5Lm!'4$?$9 +`#Kq^U>5(^!e/U]1)E4TAoQg_9IO)D?dB:i%oXLngtBsN2:J*P8mN+[*CJ=^7Nq.m +*i7?8jG$44CbfKN9Wk<+3H*IqB0q8oR;kBt4\=6lI'O]_dS$I%ku(QH#cWfg0qCJV +I?E!lPM)FVf6s:F*M^_Bcl/&U8+I-?]0XZ(d14QrU=,./3@CSaYT&2r$` +?K(=%2=mFqc6!_l+%,Ztk=?JU\j6NO[BJl0=>Lmd7;LbWlQk4)$1r^^,q^OM;mSQ6 +f/5;l&_a?5+$K4FL%E'7prm[MhimkCQNIX`+pbFt1QNW>9+KIopujCHcpAU92[1sE +$U:'W!bn0(oYm'=Pl%8\nq3msN?8+VrSN\7s,6kFn,,E9rnm/3:VuUnZ`QKNs.TMn +6AD,qn8oEV#)#>%:tSH)rf\6be`MYa.5q3FZ/\^%PG/""O\"Pr=Yu^I.@!NeP1ark +@540Dk*&rThJkQH:?Rhoo_sD-Thss;=u@@`8Yo>LPhL7DTi%dglB>;U\c1;g5Lee] +qBSE:LdRkL_)qU'CO`bCYP4ftX)Y[Tm[%.chKYnEWNTCHh=gr"_-aF6*%ha2M8Wlm +ptSn3)3;mMEg[?E:G8!WB(K0\c@7jIcY.Eh4Z83qV:=c&>2/CJk5TkGhXL:[:)=_/a5qS)`Nh=],UVr;TdDejFI+AsZ@o,)9!XDZ.SCD]ZS"mkoX-AGZOFT'9X?"j +1!ML2eML!AF&+(,1R.&`::%=r4ARc_pHDBZo`%0Q1_g6^:p`(ioUi&?ri=G(_8'P& +jtS?8Q"(F*5QUE"2[?$e0K=QE@3PVDL[["QJ!f<-rf>GAF^J6O23hfX +DEK$%:dffM1urcf_e,TIJ"EQTDe<.X<82(\QB^9@g,>e2CKi^![qo97e[od)pD(A^ +>W47TF'U^m^Lpi]Fl.FM2jNQP?FR?2Hs\h_pO6JYo>5dD:uj`I&Z>Fe,bO-?0Ro0L +V2'k*V/XY.R=tbDB:nA/l@5F=_>\p+fD\:'A@XToP[uAMqL5("=g^h!K[>@+Jp<._ +6"\'.Ck%fT<`Pea2c\1uBR2PfU?NR[PGW&?G*T"?\rND^C:^:GWTu-*K[[hq0G=KjQMR+`rpotIuqJ&DnZi-Km#PMk37>ESOUa#H(?qG +3OSCiG9=nH4Hm.#*p<@YF)XSQjb2+[jb-6]>BpL(S46BTH_*?lf6HFj"O@;FU+_-T.LC<'W7u7g),t,&'7`Y;2%O:mA +!iU9/`F*23K"QSo!QPipA06HOL(;3__&4I3AW7:n2+D94)ImT!G4Bl=7l]`RA$gH@ +&`u5H\G1Roru!"pe.2aKaJ@R$NRGg+9/tf\AX'WhP29J;R<^D2oXe@k^0s\q +M(rU!a-dSfAPBL:4%AH6)PY&RX4\\X,\2ptF(C(4YY%.!(fDI8kW_%(YWpIds,Zb, +F\]L#4&a5u+)u+;5/BiUjG_e9@KZuJnLj$[8=>Pq\WY/D#qosC^S'('KM]5j6YKI0 +Tp.][cmgJ5BXJYO'P<>%\iC-6;#_F8RZLDk.YWGhrt1ou774p7.0>n:'qpkAN'SRN +a#MKhnJH\8RQF;ZofoAYb&k9U:(a8!9:@UL9Z2*.tA4[uCPKI4tUqXk$ZXgo5pj\#'U +0U4Wt&jXH+:V#s>JQVpe6%/H).R(pk>"H#DMXajha`q_Uj1O!@oNo/Td4YCd^)+fb +?T[M#DmCc5"3SKU'&"piYlDJdL>FIQXKT\A1K>o$A#Vc@2/g2>_AG`*%cP.J6qgJ^ +2bkiZJ9q3b6].HP8GlepgPIXBm)8[c'On^TMfDH&`)t%t@m"IbEOIg?DmY"O!1)JG +gt%q:B*"[A6ki/dd1n,d"M^;oU9V^6ar*WrfL>ssT(@H("=egC1FLF1-:<_o-SVn[pPp8H0Ai6DG,O4dKej$^*96 +Qr>0(.c5Kt8=AL0Bg!l:no4%;3ESp8/IaSbYUjYeHuk91.X(E4Vp3qn2RjG7-!/Nuc@X\F'L8SuUTX\IX3Q7HZUdrX\f3:aZD):-e +AOQU?[EY8ndJc&Ck0u"Ea&hQNagh('inYQ?FRFCm\2SU"hAaL\Da!)BLH-@sj"sTg +JAJuBp;J3W*"NSM0sMeXru#9g!MEBo]f:3HiW[PP,Z1WoOmlDVbVb1%N!uPR.rJ@o +mtd2Kf?&5<-f(;jPB*g'b5$%]jF#"9F$=<_H*nON6f(jbWTCj.'*B`"h8&^PIT+ +\;5s/+,BW""Cm.k<";3I(pJqZL2^#)EdJtY:8.4W#P`?(EgXpH +K%(c%npDo`=HGdeL-gF&KI"IR-,\4Y6f^AIlohG_1W0tn`$@[f16)^gIt_<(KM!77 +;Pc/'k7lQA[NK%4P=W+AB>@2.`8j[o$P9FdJ#ZYc1(n@QHUbW+5=JO:7:\X%FB-;- +"qR:.ObBEa:IiPp*D:WOUtJIqn';^;cQr!)*9^0d +oZpM0\;Y1:PJXrKln6]Sb6\@moB&5@*eft@5#?;WK_A4G!1]Os#,3\CYo=:n3"bKQ +"jG33,1j8^n]s'!:o*[/XU3@YiD:6ud,bbao,7jQE(CgSL\P>3M+X#B:T1QL +P6=23VE.qYYb_lX[2YSpE!@_?a`EEZOB0A"ogYue:q\("bm[K=,>q5\SfJeKFXPUk +.&m&bXaHC">Sad((5RXd('t9M0S0F2;$D4`c\3fH2)C]d:=8-Z9,UD;dn[8KKW#7H +2(^+Q[3ehk-.CC+e(DLc76f9*5h$E0:\8Noo!pjK8Bd6E+nBQL$HUI87i:KOe/_02 +Z$Ekp6Frp6,-/kr.#Wo(F476Re)aKX,u`:[<6kG8eR_e3F]Y,(^#9[X(>YWb&@+Gom7+Fh_3(kk*.ar61e!2)`PuC[_<*"]ees1!fj^H`ZCt@-R +Q^eU<6uK_D`lqqgda3]KXJ3,tJ$#d/X5^lpj`f=-5cc7^6)^qRBLO3[Hl:"TK\.H9 +lX3:o44^6AfHl+$2/?;TL"D<5O#Q^Mj2L>q7.@tH;gEemS$3jYjio]l[r +4YAUIfd2fFq`]p(rfC%f/un6A$7?O(cSC3-fqj@)[=[)FR]e$$=ll7.oq.8:#fo +24Rl>ZDF\'gL[hJFgm4&&@'XRaDFZo*A1M`)hs#QXJDu%e8SWG^t]Lr13$@Kbkb:A +S/J[8L%%Gn'-(4VaP/l">><5pZ.dtRbhUanfPQHL5uiUhN!-GMc5jR?&hCrn*l7_' +gu[,CE:pMW,?i<.[-GZa>i(878?o;>?008cmE48hhi,P+hBh1<2%I1XJk."qK^p7q +,7`JQ/d06<(cd9*6q^&jJQ`fKhW=0d']i@WXfIg]WBK$BdhppVhd9CAhd,m3A^"KR +ptqA4b*pI>[?N$Xh&ui&2)'p(,%jFMu[':2"9$o_`$Q;H%EjUl43m<3BW6u,p?\?p$ftQq-k[.iZ:#;2E+`504U;.j.gn)%#(npO,/aE +:+M;i/UiKRgc"]>S3"('mQ0Du7#Dt!L1!g/$G!pE>FYt;d3A>FAiJej9B=Y`9nl)I +p.scP.)r3%$Z2u];Rp#QKfVYBg+62fekkI_=Gc?;(p6A>"f4'>8$r@"SLcgho&O?< +9]Y>EAgUpF5$;JeAEHe*+3XUIdO,5U0nfr+?AVBA.IWNMJ'^/hKk'*(?>o!,R6F9a +k+/:&8I:KW=G(2d`7!1J2IYct@crJke(/L$[X72SFh,Xq@V`eB'&VHe/^jW?/\5qV ++rT''I-=UbM*hiaCql*Ur2&Z +l=QpYETRL/_rfu(X@35q7=7BO"&W!H91DMakl9psYj!EH?kbLEH+k9j@0P*=X'0VG +7\si`\Eem[l9^2?(;&nP]UIk.t#aPc-:[<&.7$b%oSIk[KU8PGL`0 +.]]U]/'NmO2S*[i]'R_em)(VqB$]iKd$A_(c;f"]K29<8NKB@)1#jcnDUEn1oqqlFQka/Jj>D!oPbm`o\Ci3.%NmO$r]0fZ6Z-4tj]kruuO9r*l6CHLoZY['h< +53qGY[gMQ0`0TfWIUB+(hsV?>D][hT0lHF!o^>iRO.@do7'ncYUsj1n]WD:sP*)9H +4h9\smq2R]9qbNu78rT2G@-F2O]]"RWcMXe.oEPF,HpFVgU +-Z^(YnniZHk]&tkZmh$u470]G`*jLSr$_o$g:oCa[Y;dL?6Sr4F,n;T8r@Zp0(]Z- +oG9iX:HS2=7.)Q:`7*e7/j8WK;4(2e3^kdTB16p^P1*H<()%iiJlC`JN#]5d->,X; +2a_^P6>MWUok.=k$\m#Ge0L'@@\X?cd`Bog.a,S.FlmZ)qhF(5'c;Y$>&/dN<^ZO5 +<-D>CF\cWC=QstsB_I`gZDo(B*H5k6.IWt"<,ro%2Wj:^FAma7-6)PHm;.c0%4ahu4L'5", +Qli?/?__qeS7S@#gi,_0mC['rWOD,2Xacoea.N2E[!PlI^<`nXGIQ)9?a8$TfB%K- +Mlh=.ThS7:UYY+a8D9;Hl's'[12j= +;$BPnq[c6$cM@p-[do%l&L:lhJD3jm/!dIFl2)*G(rtP@`'6$I10uHc5qD2d8LK]oA?ra6Z;iKD +9BK.:UrI1+RndT0\\.WY5+YR6<#R%aNC0JgBb\-Y2Npq6<%6?9V,"-jXAs$nHI[2L +?`hsreggoac"47b/QR4(VV+1l>]*V)V:P$X]O#MX]B/bbJ&#H2=?IoH%>Vl2EEKkc +2][t#A9(g8VH5@9b[tp!]]OE$T?q7n>!44!9mD-%+7H\YY?L^H5M>fJ":3#>^rBdo@F)KX*WS*XfuUV#=4H!,m_AL +KImMIn>n>R_bf\U&&XM44V5Po*).#6&M-io`DLB."@`u^AJrLMXDJos&^5AVtlEITB7:>a:+WIT+67ZN,tWlC +a$%ESFB;,`eBD&idhLn$:=L!V78HmJ%80RJeP/n@eFdZY=&k@\.9Y5eX_h:o(!Ul, +f9P`O?e?,'Kj5^4ao6,n-i&cq+6?nMJ!-M9r^hj"q#h#Np<:&('4MjY=cO1*#':c] +rQ'J[kDb7>h3W!7GMX-qja#^LXmEjO8,8HGTB,L(D,Cc8U48L3dJe)%\%=q.iK]-< +=5k'7,DY8\Xso:gGg7n#@i4&cNoV&>7&46o/kqPk),=1sjdC!lQf]0G>'QRG4d'4c +L\XUoTB*4uIusa1!MR7r3'2THjf%BmRKY_O,Tl33c^AO:Y-"bj)U>aml^I.LG8qFH +4F`P]$]YU.NZB-YNT^,WAY8/5n#nD^r^W(_JY:[qlLXGI0*\'bNW67;.`/JL[.1i4:,kOropBbb:XgWXi3 +YAN%g*RAlapP_E!FDO[PDZ4a[knk'UjcJ8IS>LdHHM=@F&aAglY7p6uT#[u"qju]Y +mpjMQmg!4:Rjk0\4s(%4%nQ6+o50#($LnI08 +6h(+g"8m(r2rb"uKFrf4:'s9h/9VIq:Iuahs+hdGE=ObY5=Zl8LDQ=6L\Uch:UTc- +86krKKIqp4^)9:?Bas$k3JPoG*&mXG&)m^XLf"X+6s,E\glf`#ij^eCcr`NN80Ed% +8e4/kL*f4_9bIR+Fq):e4U5*h*i$"'`/)YUj$[U@;6Df4B&l1rnA8Raj_:i!6u^'E +%mO_"dCSqHq]XaGLU%C286H*>Ua1_X;C4k(M&dej9Poqj:.e)\/LBJrR?L$$FUaK4 +2+;i8FK'G'_O*U$3'N,IctdTOaR.7GS[1nKt1g0%)5>qp[_:7>*b +D,'963N#b_H]J4--YQ&_9EEDs,qqtVf#WJ\!^T?!Jc7=@3laq3Zu8mSX]=Z*=fYP> +,=8@n/4]K3$F0"L79O.ZB;kMEmb4"+.UcOsKl=+o]"1r]lWib`G,pnr^/s%e?gIrI +:RBoq3c54m0/F*RB>0q_0YRsVG +L\TO=&>f4`HLkGpKm0t+^=h6[Bl37F\[JS+cJ.*%DsdeF\5s)pNq'uZ7*WdpifGU] +,ebFPjc!Rr>^qY#d$P_SZQJj<0b2V15=b+Z]N:-a?)IEt(P8TJ/hY`)r'5@TOU7?A$KEip$Z'OF`)QNMVL4L!_qILa7cNp)VFO!+4N. +J+<4ua;GL1jBRD$PeJKd=YD+4gmsYYV%pg?*JC@>Q5PJQOTlY&U7]gk&;U6lM/b@_ +gmhB/1Ic*'=g'_2W8<%pps(dLL5a@3AT\-K2':iQ6P'*m:L%L&crhGWA5*H)oJVQR +)D;$Oh&W9_L69nf9Z#Wes$^Z&bS0_M1lq0-(mJ?33,f^acll'u1PhdU,Q)bG/Ldan +L9]<5bj(/G960H6M?J&GlOWNs0HH;DCRR%JBRPlFG"0F'>9@GCQsZsRL=+^Z:MO,T +/?r[^@2NH5J(f./3][2MdaL"[p3GgK/Q9h;,^;JJ0#5.T/lI"1^.Kq@t/r +Vr"uDeoks4fpiRcE*`^a\0hO?76>b`hAsN/LCoM?5[9)`VZ6<8n$2cPJ/dP25PVD[ +dd5RN)U9YNq*umq=Gk#(!Fd!DgIL:k_Gc,-s/),O5&/k+KQH!qchL:%kM6N=ClVTE +qF=-A>qM>RnbtD"QVZljl\c)t8D/D_C$73-jIG_R-;H3^VY4[D;`+J +[J)lBh0[[4kl(h'pg4QND2?#(jR`,`[r/4sX1rmMPeg]ZG:AIJqNQB$\uAammX9Y% +;$Pslpn*Wc$ZuZ*b88\J*B()f`V3Wb32(aW.S1*9S6e&4.$Wbnj,9k$\NmN\qVb!jU(U +CoLmO%oEUC#9=ET+7]FT,K +;Df\>3?tAF*/F"uXKW7HYo]!'>AP]#:q.2^RRoe"!RC0S_4`+%BdU-&-K=[miM%&> +im1)Gj)Np75q906po!['&4M?udZl$iR3M3m.<;%0VF`-JW@G3U.c_'UBgX/o\DsLl +J7/T9JO9ZNVA6DA/Fq1?1=$t4C_]fr&SI3fBpo`'rZ/hhq;m;['(m_Pq'n/u067(3 +ZILXM#r&[o1*Q40@?M>Q:FIQED..%0diommYSP8>0'rZno//=F3=sFd*s(NSNEm#i +\AgrO&B9b/Jc6Q:7SO&90G@kJZXY[FBf:$Kg%.9a1N[X\h)DZg2tMS[1PIf0M)_i$ +3:i7m1R0tAR5qUE3V/q*1Sm-RWB.Af3qKU<1UT;c\N@.247g9N1W;G,hAi6#*hdt> +Ek8hJp(H;6*s#=LZd9^d)!FV2s@($YTp(^ud).>EB@*oU93;t4-Nf4[J+@TFRd2R.%@+`"NoCY$%3p;Li+a_Va; +Cj+-@[aAr8eSVbDD>)Y#(>WAAXZDb*DYEU=.e`,CM@t&8Q%9!@!AKET`#0?`E;'ra +07_KjTV#'N0uJ=Bdj?'NUFucA2Y1]B=#G%X3HH!!VABth2aqh-W0e`odrnN-"*JVr[pH*G?Km:(`GkZrI(MS/=R`Ob8/qmTG'BL(2mn!Kg<^Db)%2V#8?0["L_P`e!Ui',AW0A#NHmJ;IJ8kQ +(YsNa_0_O9IeW?fTtK"^#(UopBWIjAC,-if)1OUTJG9\kMCWV=rY,uL%en&fbeW9c +cEQBaITS=RQfj!G1P;&OEHi.M3(8L:PqLGZ%_!M7$QKgR?Fs;kKU?2&3+T4K1)b^M +f+)8kW';].5r0dCK=HJbpk=@QM24-K,WKFn30f>93Z`#QO/scnD8cn*4H>esMYOH7 +.O)TE\D0qbgVh6"KFCCRNJtB&N7a2N37,ba[>h]PNTq^Z+km$tTYaT#'EFN_mdM8@ +c&NY>O8/d=9`W=EF:YC5RBRn,:;r0Zc]P`fOkA9K)'tF)_iQl1P5-epm,/fJ5T&H. +j9QCRlP.gqIX,"!%:PL30LLnh1R5LVQ09A#k+JB@reh8"`_B"iJW*`o-qCfmP*pfe +3@C1sJ<@BNR/)l4-mVTdB9$F"*$L?od'+J9Lh[T.ht`P,3OP>h/rf6R'GqboGb["; +n6/,GS-@3*,]/p:fpI'@R(;1HWp-"@l(5HQT)%oK3V;r[jI[nWonQ4#_'fN-#[ka5 +I\^\L=r!V)(S3Z*U$2rWH6o;3.AFC*UA?Rg:$+UseAA?]+7a!:3[(3.8YgZ,U"W>4 +=u3"$=f&]8V>=Vt.W#XX5SaZ"G`q,PWVIkLEiij'Uq0L#qLPSkKrD):VHT+]3gH[j +RAmcgQ6Y1u;AU^`juKN]mdBX/)MtCR\Z:%iW7lg%qSfO^afN(uXSU:Smn1+YXI73g +1rG81_>Y;)4rl6+4M&;.]"tRrorksu,GHTO,nT +Y'aHp4GCk(M9*>gm79""3Lgl-5YK-iJ7/jNTiP=TUcNR%1OOVkI'q-[\]"2;]iE^5L"O(D6+q-g +4dF]KRG#9DC56Dp7[0;0b +kJ?4CC$*-Hk5KA`+qW2K*:bgfJ8&O5C4n7S?0K"4kh]m!^3/[hRH_GVl2?pg9W7"P +p8J[R'cS&1&2GnFOmB`Bli*+7*hhqLam?adm/2`aHDF4[TbdSnBQ#43J>c%4PF&$. +le]PJ54S)e*UOpHn,EFX56\QB]ck4V'8('H^>>-Cb5oFKm!_tZT)%h]_=E(-0>@b` +5;i%^3V0i*I2MHe#)+nToO)qPl?uDNs"Er8=nR8M0OI!:5@sPOoOgpqMq@Ir5"2RJFUgq=nC(f*]*iYMl$@-g:CEh]M,RV>1(I +qu=A-3@XeHao&our;Y/a#A+rMkSM&CWfC]ZSfdi7i#t>$q*2jts7FB>e,R2\+:n5] +%LE;k6/`BB<%]$tLI:&5(mIcE'oPN@&X_'c3?=/Nj:W=EN_(O\8`^SQ<3B@UQV6HS +)3iE\24I>'':IAqD&j!+Ck +ncXRg89,u6,=qAnP9ie@A=Fr?:F9F'Uii +dHrcZBDHX5TB))D3^G7k":?73:dferiRrf8%cq)k:"-Pi3Gh]^$(h +EEq*AcZNMPA^P]VFku)'??`73HX?Hco6jtijnjO7p]^hO@!F"+K4+IBLiaPjq0"up +jIg9uc?;OkF,hEKQn]#GTW1IeGCA5-A9eq`OQ?3a;3PQOAlk=1=b^.Jjm;CKRqDK9 +F.Hrhk'N_5q?DSGBR2"`UM0KnPGMr*.@u$V"A/Se#WSEUXW=18=D/+pl!u7V)4&1/ +CjDVqZ#&/Aca@UOB$n))H[a_Z?5d/9]5IMco=]'hk52o3r!*>?E-s#@_f5N?&pbR2 +q4^i\jE0lY",H[R$#7gahE(lZfXb/l7%m@&P^B"`dr%<=9@WV4='O6urEj'dG$Te< +`:j/MF5;%gkBl*1rWe)7G^_#uj*:PkKR4`[q6XELj[d%6O^TmsXrjG.*deK+aiHDr +7>Rg4G(1lTo6-`rbOk`4=53Fss'Og\6_7*>qgSRcoDO/gkPP9Dp]1A&'E`lI'VVCD +r]S;QBcA;p>6eU9,=+uR.o0OY&!6Df#4QF7UC8c10jYQIX7M"*_@jU39aY;s.tmE# +'gh+e$dGaWL60t*6[3S\@FRAoOS0b`pjiuc'LO99P\2iC&3n+c6@s_IIg=mO4bM*# +*?iKAN6oQ]TaW0#:rY.U#f.;2b*T$*+P4SNfhmS7sOPF +A'sH[UNh9IK$YfpaSQL@:*u7GYR;Yj@MYY:7>cVc-t?4iN7(Ho8Qdbo,h/0EEb8'& +./,-$'VgnUQ;^D$;(?-VX-JjV="g903huJ;*J)QQO.c7OA3!hN5\t6@OImb.I$'W` +H=KP"OYLHAa-fjaAk`#dB'"EhRZgcf9mO!%B%5S)PBLk=q+R1]q"u4#kUZu_bT&pe +]8=jEIL"4E0>_\:$Gn-&9cjZ!LS;'nJme*Ymo[7%PZZK7OVRQ +%tmKq!C]_`'fE(Wb-KSZc!"mOCL!,;[oW@a>\fUGY*ISM=*jCC<=+6l_*gqU&BYe5 +W%tC#2QI=\jpX_HAd^/37S*n4=mVDgZ?I"iIhD(?%rF;fZbUbINrt +k?RnXFDdAmG=GHW$9D'F6\Od6Cf6AF+i51M"VqVM*qNW0cZ--Wlb-B.oWek(HuG;A +^6dFJ?[M?pt#rU7WoNe[K^XU5SsN<4PotgKJ.K\_O++,@4X,A +n)bS,R!0'Lr'?-Y(*gba8CLeJ4tZoHKqfeCX9,Zt*rrZBMEl3G"2U-;"%E7-3+!$Q +gjtOW(-]g*q\%t;Ocj`c9?ES\-Y3.K%F'<_Z,8+HL/H;;6);$1GBBuY5UJS1W$`Fu +Ho?m:W$A7.T#`o.+m.S=S+Dq`cB,plkBufkF4P]aRJ/pYr;`nFnAl"=Wkm^8]6BI' +:BAaS'Fd=Q'rNa#/f'i'bfl7Og9.2bLr@DB5IO?I1\YYSAGY9 +KPV;`0MU7+3KuG(B!k+(%mF+/,SH.P.@LZ(\9&LX7S;!!'"K%e/j +jrOO7dgVp\?omfVd%#+"e.Qd^81;8=s]#Ue&f?JUoli!HbpO;gXb'J<#X'rl-J_OZl#,,9hF@0XM(!dK"naK.B7$S&AuK30@Q&2"'Z +&;7D(5tiXmCa_SK.2R(E6ED\(]IZCn/OJ4t*E*[U1<"jf>(L`a0q^Z0iJW8eV?7ea +_MfkZS2Wfo3('.[_W3dG]KAR*4[\!g30DmonVmVgblKUS-Xp81@>u,^.YMT:6[VBk +PXiWe848im_sC#a]M(`;9gmc30a[M;S3X?,6FdZ1#J)@=\28eihCA_$7#Y29Cfj)i +.E(RV7BB]^]NdnL>q+b,"Y7VI#X?#>FtKaK-28jqlrcc)AAsL=7VlZEb[&5IBh"V- +7]^Ap\fr:YM1k1!K>;>V==$)*1:\)@JGTMe5WVA^A]J%g7q?a+,]#u0Gt4BN8$%&- +\\FhjE%t0UL2\l"!iLS^W@Tdl#7rfpn6uI_3B5Mh7s'MVCktT/M)=:@8?@_?]SoD* +NC_`+UmqCq?nAenI"U)Q\ItqJ83)6a^]N616u7_$N/,N&R7W8gaQ/g^]UVR;SOqV. +&"7&oX>Im875!iMVA%!AS7CiTWAXH!&h7EHI"/4:[J'Vr2.eW!Djd<:b;cG3n1;(D7+=J +T\(GHbeF."^`Mtcc32SAo^U;Q$rGa['_MT*r=Dg8&Q'P]-n=8^70Yo5fn6Wbd#-JW +)`!%f2UKtadB+AZ+3!$O<"5jJ]U!,Pg&O*-E_9@YFV'sfP.T;T] +9iWfE]f]6<4]C0#(creT]>k)lV([KjE8hBi^d>=j$n1TKG.>47)ennO@4``SoCY)j8=)E._I,]\L*NWGhX]jP`7^M'RnjU%G'$:h6`&j/` +5UlnaQWg5o>+N-+Z.)tE\QbW9>HPM(Zh#jH7C7/fd#:m'ePOgkIp7WD>A_7,Q+PgG +`EZ]g>\iCc(fE.pZ30/r:lAP`irT:8A6XK">j]gAqFTIbd9Rd@>qOMc]I&>7-\U_u +"168R8uI4dVFp?("2GI@#U*?Q_qj.p?0'Pl4lBWUiEdPa2+0A^"eu9H0nT=Rg[/E' +9S3B=R`Jka.h1@l^!L*)h[P"nhX0cA$"03V +a*SLP@b1^<)nsIq#5C*.-->(_#%8PVi@)3DVA*H6'k(Da,oi8PkY*D/4f=MB:l?7M +oWcRf[Y6%?@5\a,ld0'X+^uK:@P/lJ1o*gG't&iBZujU(',n)ZDc".j@K%ccou(<' +/RmQh@dYlh9XE!L7p"M5:#h?l"RX9$34RGMik?o%`](=!0B8WbA$.n'\Xq)80LHeS +,(_/cfP)mHkla/cj*!e"L-s*Q4ChbfA8XnJH!F*329Wd!T\(IIX^N]DOatF^!ZH@f +<]K/8;.N(,jG$TE5#c)g<>*7L>u4:MfIV[[:=+]'$K>C:!$=G..V0YtjX+<77TJR\ +@:gQiAh@=rZP5k4:t>_uV9T'lU\`ZX?fgEbAb1W<2Jd!ND._XB%TPO;F4c)H?o1;i +b4FCL'CY(dC$)jI2]cl"IX#LcH"WM1eU9*'!&VSf1=J8MU1eg5^78o_SS?rPC$qU-rh+!9TkYXCC+c8r5,;pgV.s>6 +C2TqaI]."AWG8$)C9FUP^8u(pX_Q^qC@7i##U>$5Y\P#YlQ3BJ0!oC@[;.t6lV=m( +I^a*Q[d0NpCSnXXY.SPa]kb'jCX0Z[hS3k:["T&9ZX>'^^fgf$5mKY7!K6:0V"XkXLf"l/$d;9BAC^/@**n0L/e88OBD/RkjIb&@jf56Q% +D4]L!QJ?>[h!Mi3D=67trnZuPhej4fDB@hU0'$msj_d9DmS;n^IckU/k3^HtCA*?U +Np?&Xm;CeKDXQt2rpXh9nS]K>D_CX"54ibgol"11Df5;fIe[iAq/;l$Dm&tU^AMop +nSXZVDP$jrrr-jHfEEBCK\0Mqi+iEK-ARC=!?G&Ec3=GIjf>u.<;%1Ej%!6^@ZES/TIC7n\3k6Qmi.T +C',k3\)YWXLopso2M'4aK&AG=GUJ/G0(Y\fF0@6WkBFh_S_DfZqSCA2(Y +GAh\/`])U/'et,a3>GK$j5!n"FSA:SG<,KnIt2bSJTr2Xjm'$ke&l&EDZcXJ3YAOu +L%tE:IJB.XNG!if^PmE`NDnDNYQ%<[V2I7ZmQ?:Sf[j;OT9OT(Q!Fo[q/;UFJ!a%r +K0d=h0-b?^@p>t>aF]]%pnsa09t5J0Tm@fTH7[\AB3A>]3oX^=F`QqL<OXa8copH&>_WNCd6k1)#7!6p?il-G$QLAIgVHCqYSs/p^0\U0s[7_bq] +Kb\^I6sjP=fA6W]O1+no\,6Xqqldnb5K%qC4FA!U:'/8m_KK#m>H]R"C(k\:cSQ4I=pKifWA&qg6A-&8kM>8J$7hmn*pA'rI<`(2';@E!B!QJ +JO(Dt-:*13m5g.ILX:tSr!n4KifRoU?8V(2MOGkidb(XXJghhjGV#^&/!N[Q;V?`; +AM0EFB!XM)k&EJPcY$2@jSjj!U/38f3^"7@9;PR$2#:cMSPcCdlI@B'=F_*B;`N3f)(0@j`A"=DV'6Sk4O)8?Z4Qo"pYXBdV3gWI7C,7X4D'/gAQcHA[C*-G2%GbkB4Dn +Dg0t8#7#t#ic04uIRbcNbNQYU;R/')%m]*j2[BU1]K$^YJMe`Eo/)Xe +bu7+04]BhS5s<^hq,/T(jlj'8Rfc3QG`L`.YkLc1d.dseIpefBf\fbRkYB%](i%8L)-SZ-AXf"J>)gK*.@DVNb@_/S12*Q`?W +f0.N'h,disAm,smh0?")OJk\gUH#2t%cJFA$R/K^AG7(=J9#.Xj'c=E&snm@L>eMJ +iJ?IFQ6D+EfWHrd@nO_nNoSdk6'1/1*_DOUffi8tj]PnmQK?eK@@61[RuNBdptfju +(*].lAIJZ,dPutoi:r,&FcHG,*^d_2BdN +GRhPEXu$Ihd',g$6?t`.n!r8/cLY<83R@>'%nY,>)okh*oj(p-f(IjK@G(9ZT5!$Q +h7msbpJ%PUds&M%AlOW+"Iq]G,=nARIm;?QrEipbpANluiVRKI.aFtFpine)]*'q4Z +0OWPH"G?T!O?Nn8(\n1VS.^F8?$AMh2$W""*J;^f&4.4&#iR$TK[?;)6C,^sTk"mQ +YP:I$6j"iL#ClQ6eE61^d*`DL^JKaG]j6%pb=dQ +1D&Rd:63fr5XnH&!G9ZLEpF*%l!JY7dt4"U.hL&+eofh,`l^uY)YW4uP21n.l,CldQc*/3H!:]%Yi9Y"Z +&C@T`_$#RY!d;tJs$g\`)l(nrVbbH(8EhEHUsu!#;OUTXl")HC`bpjbg-C0kfTI,g +N%_B-7XQU])'OO8K*L%Ee/FT.VDTEi<17Arl9lGboff'VoVcN\IBV3#^fVNZ +@-f1nYgsl6,WbC#lcD8QWJjO[!4X'e(c\G"E'F@+W4g'9+s`I,crf$k@kB"#[&e;d +g7))Wm:EE-f"Td@)eEjH9rGGKTtq-k\fBgF7;6.eZd>^o2a^tC(a3]WgNuG)Y%>ee +f.+@99;QauV:E0/?L1se[mb]O$[Jb$`W:_L6eCpNoB<>CR$PtPgV7uO*Tas.VY/fkj)sgW8hra6 +Bd8/*33W/n6-/h+53M*Nn#b9[pf@nk>Mk6V*[Sc"V\S4H?]6Ed*Q'6nOM2n$=Qp*4 +[\YRhi:;)Ont$N;pua5(4D1%&*bERkV`!VlhjbVaf/iAd +F2!pfH=o?*4QiYc*i7B_VcE$Mit$cU2$DP:HIB%p%tIS6"+>5N3cA3h +h7'n:Z?b"_VfhF`hn40)p"o,/DsgNP&Q\07RE2Vn%KPf9#5uId]D%f&?gN35[J'U_h,Af% +keV_ZGrl""Vc50`8t\O_B+rtp?bc+0&*:%0p\"OChu%trp&>!MbPlG>M!#$TV,dog +Idhk-9;$gUJD=dPjSf\i!Y?FT7lp[S.g"'N!t[6j:cAK2o)`kTK'3(4AQYGGK_1uq +*GB[8JA_kQ54q`<"qX!':]O7p3sO&M#7tq]:j3/)W,=Bc!ZX!$"XH? +gB\AH$g,,1OQR+8lOM;1%hS<9Yi?7GdZ^[ZgYhAFN7+Ck\k?J9%02uS&Glq,)\J)h +%oFPa;(!!=.h^5^Qa%VB#Jdu\!skjj"UYnGiTLdp50[JuS4k(0nM_'-=VFY95uB?P +;.gZ,CDP<9(C/J*nTHK6C)PsNV^@el:emqT`4h1%("&3\&U>7'_&"hu)A/__;5Y=p +Wantp)Zmfo;18np-I;;?@Q[iulb\+VGG3;AUL/I39.D.Ek1'+Om+#G6$pNL-]\a +i=@+F#pZ`>8Fd]F;F`!q9-hq],m+#j&j0s1+L49%5,Y+X&VgZEB*bDmddgHe;?nRY +_^.'f-k_.\;MQZ_ALFdD->O`E+J@WZCBWkR!t-TO8O"RXGq.6F.hBHEZF;?I].;=E +/._+s'!cRe9#lJ9*DD!W:IZOCcAr@t/99c#np;oClRpWS0,!k0:2_a_aD8sB!G--Q +cjph@51-$fc-lJD;WfcrCG0`N1(tlf;^X>[!ASWm@]^+QZHaHJj9DC-k\7?4J;ko] +!Aa7B0sK[nZWB#J>;al:2@HcI'/41"K$6O!%D[AT:eo78ncPq=q8Y3JF,)V/MR=+- +3>7T:;jTM.R\_fs2MS8i>CYipH[4]5c&rqF>lRO4%%L^6jC\!1b<'j"RF";#P3-G,co6@H5JoY +%^(p]'M1cYB"?DY7hg#7<-LisHFq[B6tS"*X5XXh:mA3.H0,;91gUZL.7c:f8.OZM +e>Gp'X%LmF9*As$'Pq6VXQ0kL8Fq'hcO:&#Qka/"96AWT/Y>ZmgJ-2T:))_`;B8JR +e7)iWJVK[&:_'Sna9Kn1:=TGAXHcP'$W,@a;&'aA6Q8j$\79911JU./7hmKALkfAC +)IU\q"\KI$)cP8kZrIoAL9]6i/DMO1MH-O!WAQTF]/NN4Q09-GdoZ["LJF-j^l +=6G%!l[Hn'IM^dKb(pnm^^ZIT"uGLblS@3mhI0LWJJ9\bp_SLK)hHW_D0Q_D7GO*j +'RGiO)q6&JTX#*\-%jXLJf$k.=@\%38mOD@Jn?;b8qM$ELA:+j0XF4b@'U=[XaTt_ +KeTKZfQW+=!j8:rJP`XUjO>Ot/`ZU\,q/N?jPLfgQ5MZdUK +3-&DkJuNYpf:=QVV'gP^eC'TL80+OLL? +"?eWa58^5Wq$+Dil&aR/OVngp6V3_=B_o1>1]mFgF0Y> +Fm[?X5oQI?c]>OtgJ.^IFuu]"i?3I&YT!\K>6c2FrN-:7F%m4i;m2,%>%^0C-\)>QCN^d$L@b^K4+WA!_ol1>I)0JZ^YI5>A(C+ +F0jV+F6[MoJ@KnJ5;X0=_Qa/u2qteF,/5MhBt[DrAbGNlS4<"p,4^ +S\VCZS"7#&V7E)1]Gnc$:A)5gN+U0m^4Duh=$+!lh^2.B#eo)=_)q^AWut(9ja[cgN1%%uLuR/TX:0WN(;QlTr'SG*EQ%d) +a;fiR9i]6HGu[UfK7UNA5a0'#J?pp?!9(-j5aW:ZSt`lU`@7A!I(.:h]?AD7b;hNr +XY,Z1RAP@C\tlER+?UR8bR/a8b6`75r9)@qld"*4c9.'`!G2[)*#i;.#i),u"4A/s +g]s7\?!Q@77n_/+)q!I`dL*D0=aUrLS.hTr$t,pY>gbdVFp3GG$R#*Kr:A?M-djj, +*SjZE?!#RI>LhP:efA8O?"_`ZCY%<[f,\qa?$FnkHe7)'fH#Us?&.('MqHjHfc?:0 +?'j68S(ZVig)ZsB?)QDIX4lC5gE!WT?+8RZ]A)/Vg`=;f?,t`kbM:q"h&Xu#?.[o' +gYL]ChAtY5?0C(8le^Idh];=G?,dR$NYFYRhu3N3*XCV0$fF2Zi1:P=h@nk>(ZF3c +iZ9&u4s/cj/)m-RidN]ChDO=72riaVj;p>B?9dM"6fah7jPEhr^/sD;=lisojrRml +?k2)n_YS]^F/Ro.Ipgro,fXW +?S1ib>RB@+)^*K6*eDQE/farO"lW>cJLC&]1\JLAp"s9Q+(t9HC\D+Pp7H9t?ZYt6 +&_d9dp`@TT?[^Z.EVSF8q#>X85F;0fS,$E^q4F;U?_dIiU&*ZEqZ!Vn+1M,S]DFh- +qk(^p^PVl\bP^8Dr?'Me?e>7Kg\p$erZC1h?bQA%li*OFr*T'pht@!kp]&)1Td-LD +:e2QA&I3lfaloVDTTK1)pd2PEgD;sJKDV-^9,Wn-JM(Nk2C +@Bir$Qjdq_[GLG!]jC/og\(RIJ\ba`Qs;Nk&W+J9nX/*T +59Z02AFc-n[U1bWc"?R8h"H4`U![QGRU%hD;5q,UM5kE)]3DJlCj)9W[a/m"ghujj +h9Q%G^u'*US3Ak>Oi?DOq-;ch5F9d\FLiJV[o]iamq%g50P<#5a)Y]Lrm684WO$::u( +0+:3%e2Ik)Yk0dR^ekdJ&k"H*7h\8[=;I.8$nAY:7XJA3V\>ZLkmc9J[C'1/,#2cSS?P +<7a$&Yf*ds92gN,3DQo>mlF5X[.?IWF7f,j:UCQ15u=p7%meT"2&+qBe9)j(;DaXd +8lE%(02,;$eMg6%ZY^LT;&'NX;H.cr79!6o94&qXB!BW28(EiN>"AqPi&ZP28AI%s +6?t^meQ*E;@T@S/LL\uF6a]]m[WS3U=uMYDC0J'RYA@Dsop'Dt2YEDSg_Tk+Ea3fG +`H5@o:![rf[q4GD>?@*QH="(gmsJJ$eb=N"\+:P_?$I+eJmK9H#D5EU5b([i@jnZd +f%?94MObuJA6B7MM,#C^GWn?Fi>ECsOlSMI?[q/t<`bSu\TV>IAiZ/h^uY;LDj'9D +[WS*QH1lTXB:9TcU$+N^ELLT&D[^E2!VJ*n&+!],e +MH7>=3.2\O#Nfjn;2+]eW-"OBLP7-qNagiK@,`J:Y +&q3\Lkt$Wkbbp^=VH$7!=W(d%UQdOJ=\BWH/1%[0QKHb!bIMmOAbq +bf?+"-=Y3-F"h3Jc^GM:Bh^JR18[I`RaYkb9t@GdB%!KDPD4'P3QX9jFPiW&EcfRj +eN7DSn""*WF&+g\4_M.rT*C0tcKY'c-fk<"e-:BFM=X#H2$]fh-'chh']$5VNk&d5tIt,/uB>GR*thB9j6@( +V\J9a;n@57l(pVAFU"=7.Y1F]1'"5[-Da\QR8[N/7>CW75"M<9gkh7C>1Yq;,JXjuRI=1\379`9+<(#Hc. +CC+Bb.p0"+-H0*!)"qc'O0Edo_q@*tAPI$$ZPI/t=h<9tXJM&d(4OY6lU`P,jeoL% +VU[I195*]%XgT"ZfimFVC@/F<[he+G>8q9p/bQHZp@`*&X,1h629/TR#3B(tR;f+l!6BMF^XU`],*Blh#"L'Aj+_X(P_Hd1KAVe2;Z"?EqNb(Q$G$*n%KUW]AC`Y +I;`Eb^6d^Fh^eMPDtX,_pZDQaN!Xs;*X6.7!sN)F)1tt=#Jq;o#iLXjK\Am*_\d"q +>)Y%dYkAgLpid9,S2Z:E2CHHLB+\Uc6]5q*/B-d>']V;iNG7f7`u)E.iuE>MEOJ*Q +)$_<&/9d4rejmck,6R!hR?MZ5iQ0\".:jKuP,o^#b8FqEA/qY7o!VlK)0[06]ZHR_ +1hOs7Il-:-eXLP"B?hC83F4i"STAstc'd\^B0?!^F7\,3)@&@f4S>Bq?@U?@-Uh.> +"eg$]NRA^_`+Zh5V0'%idQ0TaBrsCm@31cb)M_0f]fi7c/tLMGVFYGb=fZ[cqpbJ_ +@2@:S]/-?(>mpeVfb.Na1HORmbF5nFmhKX]k/&Kh]'U\DnYa? +2n&bE*!N?\c1Shr2[/.V[t/M4)8f,Q"QCCCM"$nI_mm/lisXn(n\-Zk8NfVF1u;53NVZ34U7[&1qCrD2a-CF +rq1A.RF?6O8*O;HWH=U!e%3"ilNX8docC*aHKOb`4bp:RcFqg+2eD@k)mT+Ng"T2E +BC#N6\TX8@gUjq=^`Cb2pJ1P@o*9O0*XBLt0(n1MmtU;cDo)4`)0*;ZO7<-=`5qrt +ja=O3nfCTOH(R'S4MRN\(1YYc^Er+B1Xkt[Vq#d*:[(#dXnE?beb_RF=+-.5oY0MD +;dX>/IJ2Rlrs.A-0/`4t2ojF?&*8/QM=Xb4aSHuKP+qHmn&:QM^P^A$1U +&+f2f5KTGpn)=0DT9t(7g&#B*lMWrfoRAe?qnKW7m%;c&Ih25P=kij>"9>7(r]h_, +^bc!RPQ=$K"gCr-^dJFCF&Tkb$,E9V^cVn<]F;T,GX/>?_"-eV`!sNs&@5UP_))gu +*"kNd'gWe\5suO*K+:1P)8U,-_-nY+N#][]h8-`B60oOO9HCta+ff],_DE?$6\IcO +-,O*'_E8r-KI6 +6UWlNJU9b#1..Qi1Aj,L`&som3lC#>6h:XPe3LqaB#Ess6o761/4%3R7AW[G6i9GB +3p+@k8]7;]7"e4OHq^XV9#TdcU81INN)7IpCIIem`A=7,e5=1Y".LT\YNKM"CRf0?,cGF7PQJa'P,3]I7qg8[1\*PaokF<(VJ, +afM):N1J**4\>RGan2?pN1nBnV3$A*8d)%Xr2*)N0?SsD9!"qm1o\XIXc50mSFb#>dhod&aKKPmk/+$;fgl0?jr'"BSFe$dfn>d1$bu<>*[O(!mC(;05E- +<>&/=o?ht)[[e8_`>Q&=)c>[j;:QO^"U\,o+h?,FdENfYI3MQg1K$@_dPE.H>q!*$ +-W3A_dA89i`$Nj./^etD;U$l%>qT$_0"fF_;`#??'f=AaMUO^HZ^!CH*B:`L2cHNa +;dDC^]XZFm4gNm';tW8TSN^!e!7Um/<&;3e*CR1R6I]R3/"K+.KC[N/6e$1?e;[,+ +SOq>]8udkE<:f7r;cR>]"_o2DDc\0]rmujG=1!leSU@MEGLsNSZAj97 +"-D-rJ_0KbfF9aWqD'J`JLZbMcf"^fZf7U!uP/- +OfD]Jfena9D3A%%)qdZDfaDTK?'qV1QW^/NS;iq>`?Nu`S_:'*=j)fB4_Vj.MXf&"rg@_EXXfbkA5$IodgB01b +*ON69ZeK&t;/N^FKg+7.ZJ2/(>E-7kot&n#]g9WM>P1G>S\X"8YhT,nV-Uf?'uV]+ +_d$bHgeGiE*6$]MaeZ&X>d_W_RJb +?0JE0kMAA&hNdE.Fm@i6kfT#^a_S+j7pYY'1?d8V@"o[?oEF8tPWr<%VmJ&f@"(5QM?q(CO6im'4:jtL9<0]OK7j#/W%7Pa"!1ZMLoj(:71?9$tg3Fde(j0h"*?6j%34lbZg +j7Y^u#!h5b60'@Zj>KBd7RZ<<7HA&MjE=&SL.LBk8`Za@jL._B`_>IE:#tG3jRuC2 +##OCs;<30eAMuX35!3COlZT`& +L:1lZV/$RPlaFFk`k:Wg^$Fgplh8*[#/KR@_2EKIl]/I@2T4rO`U#e.lrM/CB#j8( +aR!NUA/;B+2BH\aqs;>JV]O+Ama.IVcYXh?m0;%b2U^tjBC/19@J,WI?J(M1f'T9W +m?ZM'hV.@?h7rsED=XoJIbnrOJ*m6pUrM5.7&4]Yjck5TmM=uQ53?aG2"#PPaYrDO +_8,I[mI#WMm`t9qQKrGVn[MWhD_Wn`(A-EHoC$-!moK!siB_C"q2jb5n$I@YVYm)f +qsT:=n!rcNbWa6)el`,4].*nkUXVs!I;D+>K32Ej;G2T.I]`/+VW7En;d^"jHQ+ +0pur5o/%8)-T$b-1\2,+-.b"qKREB03V*20oLZ'-Ua9@6hD).FB:q/O9Q`j!D]`!M:KI.PF*37APa>PGFPM#J*d,M0_WP4u!B,)p>i#EfnZQBp732(\ +AWo&`p*LW"B,>`8BsW"sp9?=FVe=;YC[hXGp@ThWkAZaE;0OC)/!k6pf5LC@rc^kU +Yubu?<-3>.#Bu5R?/Kr%_$P=hFiJWQn2Gdj!rI39JWOf#pZ7Wa-N/0JKuB=2pi-C\ +B7nr_L[Ujkpp/9AVi6U"MtiN-Gh2K]kE,F&O80pFGo)Ll2j3V/PPJcbq,`pQ[sNBj +RA/l3DP*6jV?m",SW'J:H1I)Ck2lF=SCb6CqD<,9Q_D=#U[A)XH;Be%B;gbZVg9Ve +qNff\Vl[H7X8;!4H@MskqB^IUeb[n%<>Vq;5ed+K[AC(6m3f>h1_BP.\ZcUKqmX*4 +Dn9]`\9m=Pqq&TjpD"\iQ[GAq@DS6qs8bi$%>D,ftZYEkN@:fao7#!I[BB7J*Qjem!bIMrmh1# +kO=^+n+jH_IdQ*D-2`6OoollWq1&*f4B?rSr;VQKP)oG70Dg6YjT!3pJ'`]pM5k5' +&dJSn6/bXRA0r6'LI>S`3.+aQ(5bQ@;4-ER4WBI&A.gm:Q:!$_8gMiQA?K2fQqM$H +q39HE2jqs'e#C:RI5l`'BN.#=(6(h[;JB+AAN$)TW)RM33i,lZ=0,G<&@J91n +ID=]ZG[*E[(QGoUEco%.B/c+$k&^B)*iDB-e*H[R*PU-LZet1q45M&,O3Q[Jnble/ +B=H^cpj@Nt5H!-#p\]Ji?bbahb4Ipf$dSi=&0),\_%7k,"2SqM)$e")N#N)?&>UTZ +Tl99T%E":o4V,IC$q1cHOXs3?`=!Y;'uLTq>o#m!Cge4$;647H`f\2V*642sI2tAr +9SFY2Ot;S;aV%:4--;$h)EUmN8lTeP8rmDcI:#-4jNZcofl69r<5I5NdTqUd1f:i7F@?:*CnNlN86`s +PT;8@daZMr:"&\$2,@/8rC'PXep8t0,>*ck0Cr8/B]l2[B%E3>BQS"D< +gDi]F`N^oMu\ZTM5AspAU +SCdRcI@o^A%Y^V?NW*pmkB]UCV.lAnSYbTH`f$h]R]`cnlPe"cVWo)f\Zb9[%_],` +)]fBhD&Z7#[I'H#o[9nJg'j`Gn"I +*A_Y^O!Vp=S?FL;EP0U8c11_p29th6rLM.(SM*^doc6bnd<",^6e?IOIq@:+O`+7S +pDqS&h=Y'WB@qGLs+T?TSe$^tpRY0GjnYKdSG.:-O,`E!I]'%-q],X.mJELD^$j`? +^W#MdT$PUMr817Bn9ppIh=pmjMM(PMT0M`9IfHVArR1_4r;Y[X!J!^\rBOHU!T2rD +JC#VI+_V)_i.M\o:ed1i\1IcT`!q>Q?4B3L-NtXr+bW[P&f,.@$/jSfK@$V46F^8f +Te%pQ:sKtH<7_Ld`%6[?^)b+YGjM-26&8AJ,!P4=&`N(JL[cQ7`22E)@Y@U9;,/S[ +fU3K6FBOI*DCe5qD&$O`@>n'CX$t[c(8EuuNDZQ2')9Qfj+ME4;9b'>M!Z,@]PW]A +mQEi!ko\shJWNM?50''#+!`t&OV06583%\8jFiYFdOIj[R4TX/]TnIS8kqt24X\Z7 +RZp]^;Fu^>.,f9@Pu=bc9%MfJ-%r+\17hWAgjfLH[l9NkfUPm#E_]Te2s3TbSMPk@ +:9tZqVhFT3;X/I$WU2c[]_.m'P'PC,rBKKHoq,1nI*c$j5q"`YTJS9U:tVU2."ql" +1a\)PMB,.L`>PF>g5452,tI1$+IG!'P#>IWqrm\rV,X=X;CO7jl%Ljh<6V/dg/gqH +]fDt-1fXI8R%F6EX+!>3+LTKmBk%mM]/Ql!LL!J$;Vl +^0"SK@FT.EYuV@RfGbfh/4G],<_`#7gFZnd`K.>SK$%6N4_N1`Qa9_Qd99a4F"IQp +[8sEFg1s8omA\6'IC$?tlIfCRI!=ts_73PUQhbcU +DGANh(Ja'n/"^tP`S"Ji9'Y5*\Td5Mg:ULIneKoqGAfq5]iTsZhV6k5e4o8B2gY=- +47%,DL&&Jbk4rB=l[Q+N9##T]!anuaJ1sFl_,po@?u-j9mD]IKQqIco[gRjC`YlZa +dgG%r/Viih+bghP&n5&;LN,d+`Ai^Z@Vf>.nU\-fGg@+7>Zhj4N]G-Zq\islH]R^' +UW7Wj,%OU#O>6Gpa]TssjD:BNkQXT#=YD5bb;keB``^JR2_*qEWL*1a/^&F#1/)Mt +Qub`0bt.jik1ndTZX.@i)94cY>i2+D`0&?UbqL6,QC6/^Db9*90;nIG-.?%A;JJ?bW-(S/[9B%pC<]DP:Hkf0 +>0]_*%:?71G.B]gdp?hDiNBT.[b)G#?Yj#,o(F-Afin\nA1`kKp4Y?V4#^a<46CE>AEQ]WOL?jg>#nmL2G2O\$n6-gmbKj2P&=.2hpMP<^V'!?0sLnIe2DXk.kn` +rP.XCqqt]EJoAnD^c4gjPPcAOn3.^e3*-^O9EU(>mOc>$_49M4DiR=//&lhK+/'Zu +P&aR9aLMg1j;b;CEc,1+iNFZkS?&&P*b!=h_Q)b2e"1VEHpN&(60M-0Sb)i-d:qc2 +l!5l#FH2F2qDSQASPQ7KcCNI2^KG:L=0?\qPLd=c;!\cMYBF6rl2)Q3m9PK8p3tiP +d/RhIS]eSshVm;f_gLmccaEMVYMOX3JNc6o^A)%1NVjTLnP'P2G^g[mdiXM=?;<"q +D^"/R[BT4nDpC(E0B`8ZR!TludX"lfk^<]1oef[sHJ_u;rElMs?E0NAs)%/o5I:&I +e)!r?EUWl.YP3MWh0`E5n:!mL.c1orr,7u:r`@MD8h9*&n#c1nQdbh=Cngl8Z1l!9 +DYp&eng*\Ap\qqj:`l%tI%SscIu!6KJ%,9(<)NPmQh^I8g\uNVo_pNCs">SrYR(<) +q#E)\!"]i20F\&d(BH2n!\bbRO<"D,/9;@=!cTptB0cUg4RMVq!`1l[/+E`29a'L% +"HZ+WE($#];$H6L*RJ@%E+oN\D$KKL#;C9*E-V\mI0]7m#V^]A+H@-iM$VId#k4)c +0UW4YSI'8-$*^*1E2num<(,9A9 +EG62nD&2Y](GU%KEHrA*I2DF)(bp^]EJYO;N>V2J))7BoEEl/1*:_Q!dFfNpgDt:i*\cUlOm*Ub@34R] +*jPAQ1$'GGr?&:";q-8K!VEaL/u3?thL-SffZdUacR +Bd^3;-h;s=dYTA-M^WV*.5I#7EfVZTPpt.L&b:,qE-;3oXWJ1[C=9(3E,R2r]dbeR +.MB]No#E::aXm#-/MbL$EmZJ%eLe)'/!B!HEp+Oli@XWj/^j;Eo(Odmq(M=;0J`MZ +ErdtY"Xqgb0f'OlEsj_/%l*Yb1,Bq+;^!o;/MaXe16XRNnf]`.V^jPgV!q@fZUX6J +4U%$B2%rr*kiXfZ8MtQo-Z_X5DEBa4@5d^`AB<^fdrRI-b`7m82\Ug&V7SXLN8[]j +3AZ?kP>=0%SN0W?XclsLF/(e&T`&qm4"^Opo;Og5,<<*D4>XS\ce/:Pb +Kg4'0gf+eNF;it7$UN8k6PM"gF7DUS4[X'X68V*a1d=?,9gLTh7'or^$DTmd=%)[` +7NkJoFD0=V?UjZuiY5<]1jMP)Hrr3e8$m8+oB/TMN7X;L8Ml+3PN>?"SOleQ34,/I +'WFZ>7nE9VePrSA1q;M/Vb5IJ9J:0P1qQEqbtOpa9/P/J'ZEc\g7([2:F!bOFSO:kktb:Jbk0pkoa+GD92="<;)J_Co_VLf"]9Cc:s&H.FX9pC']i=, +;UmX&W3oLQ4O4a$;Y[j +20DtXB\AY\==gp_eVRA+&Q\Ra=7qHsQ$HM4P?DYF=B20>'qne'XN_KB=k0o`Y1ls! +Y?R:-bZ1QGCkl7Q[p/3c>;aZ2FjW-=j^".t?7W-_Q0?7GiEl32@9(ib2>LQT=]r0& +?e,@SFmEG:?XPc(?_u.WFpDGV*T9Q5O15.:^W?>Ll#K +G"4`^04aE(A/7aJ77h!t=(V(t_H%mn2IU0Wa^l6,^p\)l[Wq[+G@m.lB5F&JJTg-o2YD"NV.c2'EAn2, +QMY[&RrHsoEX._>pEajh+sXPbEn;+K6:#VC4LfSqEq_J:2[=F`7s*lTF#QO0f%kEA +>djB0Fa%A3[nCmg@s&PIE>NV=GA_hQ?[(m=G1VFlPaQQYLNg4fMt_@>(Q!F7"aCiV +ZhKl6G4g$fSU!/tBQ`3Z(TDa5SU*61Ynt$"G-?5Daa;XLe(;'W(YO2tYC&:eYkQt% +2qh?bc$l#BI]s]8GO^0lokl_KJ1OKGfCNR?msk*=JLH"j=:p+o$;4J)Jh#Z/p`4oR +V1A=iK/>lFQo0K*4@#8[KIY#p\4Kg_0nS%TKBK4dQrA[J<&E5rL+9B\fP+=[:PJRZ +LBA]RR!"1oEoU85Lan[FpfiQLRtg]pLY.R(GLq[2SOQ_8MCO+4pm$`@8r`VFM`#1u_MjG>tVA9!)g2j0mJ#7OBOkP5]0jF""ZI@oYppj"qZ!gP0<1K\Z8DTc +],e2f0sOq:LmnjZC!^g5IXjT\*nUN)i_DIV7KM7[!0]W\TPqq-E\e%P#U]%bcL)md$.l+ZgP]tHSAEI_S'%8Kc8V6:gtg3K)9mQuEa7qVG=g("mE_;4`#Sg&;gH\P +$ugUqd6+VYh%e:Rjj'D'dQG_"r?uU?)q*m3bZu7<$^]4G3Rd`id_/%c]g:+i1!uO< +e?jA?>uT:b7FZ`nh;)Ae9l8?bC"1]ae(nZgG(J4-Httl`fJBAFh0IXXn(-!HeWtqBH=eA[=R%; +fA5V,g>1`DM=o[flt,#9h^QJ!h9FfAgX7,@i%Fc\rWm(@p#&j!hjtG=H3rAu&)lRm +i4^IH*[0L2!T@?8j!.X`*];s.IH#]@@U;.WIH0*(8`S=ZhHg$>p;,fR>iM>Vju0p+ +*`;&o:ZYnuk:[e9rchea=m!m4k+7(ce[?*WfQEdVGOJl>nD;@T?PDmFVso0Y=J$?!C)--.)tNk4nXh9% +#Z^F[4SW8(oJK)'h`&n'rUaGi>[K_gAPr+b323$:ocIbl4rs?H>ugo-pE`Q-s)#,- +&bho)lMia9^OqhZFnk&=p`G_CIq/8gSA64Bq>Z:`?]k2](\rQVW?6WdJ%5JbU\c&N +qVT4g+2RiWs8.;Pr4'T:^XN,0=8[R+l+c'Q[%7$-e]0nhrdXCks5X-TdNAm+C75;/ +J\bb+GZ5S!$&6=Ud27O3*u0W$U60]MAiU]h7cX$l"HGnsONHRHM);)4/!il*'%r5X +AMooNk&Zrtl>\nX:M:Ea'`NkRU/C.(ROp.S9Vk[&'`+(UWDT\FlI.-ZDRj&V=6p\A +'opCIZWZZ2RoQWED7mh]3QhXu<2?gi4Yp'UnR_dRO%9NE5OM8j&q +fc4m*+dC)[Et\AAD`OB7BCm)_(6:nPbA$V&SA)1(XOV*0)Z>u6BsHCYp=l.Xmr,nq +Dmu+9-P)'Qj)Ol7Sl[S5c0'0E*?LPCWR^n@ +m.G^S*rhS=l1+WJrnj?gn*g4G]W_M@!BH4ir;Jsc6k9Gdct!do_/OK@#XWKX.g\Ph +U722$E9'(,_XRab&OR-U6P@=W1fG)WEBIG?7F>XPU-m>(CE#b5`,cqhETDHg8+He8 ++\6W!M^(dY6tI4WEJ0f-8^_.A.7u@kTdr`U]W2F^''-Y8b>SPM0hW0*__TGW1t+9U +F$/272\PcC3AY_uff.4J[.??)F2[l;:UC9)5s;QF$U[b_72&*eFCcC];=oPe8Q'I@ +rC]sD]a%50FO`HHe+D`f:J$eI9-;Y`771'SF_+KPeTH"E=B9Qj.oTL=ojq=YB]tW>$AB[X)Qkg +"k.HsG=C2-?+5OEa]u4[Z@8!3bFL*BR0$:VT(J\PW/mla#s554?1'46AuBiHrTI^$o7p#K(Mn77FuM]I+Z9 +n_?n^a`9M>\&Iq9a"tt]I-3T;/E_4Ed<'da9@J"]7oRr\I:ld9Fo@)#:l+3DBA3'M +[r^>KID:-bGMVG3iHRO6J`D!(5E"TJITN$"q>P$#kB]=iVsAY8a/eS'rn"dMHiDp? +msJIIa7F\n8'1FOs'O7KIK+NOpATPsl1oeCa7&tUhrjV1^UO.A?j$R]n.l$iBF+^s +)mOsU2?uMB+Tu2;'7uLJ[[56&:('@MD1cOVT00GV]jS<',quqBj.jSJ5Od;i1$F +.7IpL(#m_GMihI%7C^)K@g$;#:q@oAGgRF8$_NE@[Pp\Ni>c#0C6"G-+N?si*b3-8 +N3VY3a2n3%A-@OGneOM^BaGsDZQtan[qF +,kRdpP)`I5.8_O*9W*Bg>$">l@4YuRV3Os0<_I^>/nME$QP/^n9A+kL-5=4^Es?)< +=_BL#O8t]2b%FEDTepAGdo#]dCI^sW0rEI>S!.H%c+1MIB*@7ao9OAkBuqj%]^),P +[Wad3cTGi6o:6QGGu&/=4m1>jT9J8a:Un)"kS42mP:D)ZH2BoUr<]0^/r*9'+[]q& +&#)pEK$efd2(6uoUQfq_;>NO_>_ODCFHO_o>#@lU;5U-=8s<0L;bSWG0rC2\RhD/n +V(%ZkVR5o`e(T@KgdO6%Pnp,oHBD*?;MqC&2PARbKiBOe:JV]W6rc:C<@Z6tWtff[ +.@RA;.fEkXQ'/=O>1$L%X^S>s[^T<6iEU/\TWM4_]2kBh?#.E+En/DZ=/u@.C__?% +Fp>eu9)P#l22e]I2T+1j+(L+LM6`FJb?90HAn,tFZ^+50=W9Y>CIO[kp3tCmHVJ6l +%B=7\OW`A9=);`-ZaH+LP?R9lDJdq9\!H]"gIl*pXp)_Q^"S#9F:&KWqTt +_jG'"@=1@sE>Be;Pq*AR]MF<&7Oto,Pj;eK@>ck#.`RHH(EJHINcC@H`jkUZ@siih +EY_$`NO'X8gl[`i<^(!g'^'#>PERb^;p#Oo-QNVrPd8S6b?8t*AUM=]Eu&90M^pCA +I(bt(k%dQaPiHAWiL4hRCsI=82]R5*SMSiBc^E;?B70fRF;BMULt=iR]`"Q];lhi_ +Yr3N-\a)CuXL6Wd_`HOZC]/ggF=t,URdX^%H`sZ3*`:&T=!cl(\!M.7@+T[2.HFacRTI3fc+0H.k?R[7Ec-YIZ`') +;[2I!&"rRoSDQ?Q;WJ=I+\Vf?Am0V5>UQD-^XLt\(>s(TB\QuZh@U1c[/Gfm=!4=OTD*fliU;6qoDYB6ao7@kqu=i5r85Qn5PtIG$Z.kurP0ra +5V[XNZir^"#!+jL5^W[LMQOY[#XB(15cMUbA.1`9%R@Ac^haQJ$kYFG%D_TK_)Yph +U^k4/'1#gn^sj/dC`,NJm6M^26+e0pZl25h*Pn5%5(jtD$m.eT<'c0]651KX8Vk4, +-:2Mr1V>##4=NUT.ma@f_F,qA]:6Yo.RM?3_U6=hHndu.1,3l(_`TS>8Nagg0LJer +6Ym(CZo>mm2aaV/_^mo;bWRVd3^\Qa_t^j]A3`NS4%'qf_W4&%9L;-NfL+Fa7!qNW +e3cW'8]5$L`"Yg3bY(@XZc#7,7+=iJ$*H[T;FN-82rme(9M`W2]gTe>79!,QH""Y` +=N.@D7CfeE4C(D2?7B\p7?h/sHricG>XfuH#rGgT/7h:5AjWS*`dDGhME&U4C.;Fo +7N?25b\"lB>t.M)`r'Sl!ij8)E^q[%**dI'9Q!9uCe#1`7oX\pA8atkH:M4/a#n`> +b^CBDHH1to8*GlOCk,$_J\iCPa0PE6I%Q9Ou+$m(c;Rb"RJgbXBZKbfpVca3YoTfhFT`9"^lm]\:Vh%o%0':&Np.7,?-.h+YK.c6V7A +9);7=j\@Ah`,+AWN9O&YkKZK]3qV-$FR.5R/^;N-:AjL\r9;NInk;I@:=Snu,id3E +nBYY*5U?'L4S^OMo$=E79)SM2FSr9Em*FJ^che2IAH5NurB;4ucohM',m$nK!NOZK +ctrj2N:fu##uH<[37S/Ybmd3\$de8K.8:&oXV"D$G0gs9d/=WoPmu,H(.OQ%;10-J +F+)Gi'[`Vq;)K:iN?(BG(=DLk73rr$XW=U)&CM"4;B0]'V'FD'-8D&5dXZN;Ce[8mf%:l`??Iit+3H\e3NF`QI@FgubQe:Y=3Y=NPpAooN;3 +OtWqqffbQU/Wn]aP,hl9fkm*Z@B,A;1%Am=bXtUlsgAPSdNNCj)YXqj">:m3V +9s35V[P%fkgE!d;4gWlh\m(+dfS-okI3mWb^0BmZ>LgCA%(P!p^g"4a8bK`$4i(AP +%9rMG>^FTKA]?iJs>a<9429T7LbZ-79>lE#"NR$=mb$1F^>p[s_D6$r2dFjf3 +h0mp12:c'(e?j(4?*2gdC7JO'h-J9U?&dcK$BX*2gg2RI>i"CG9Z::Cj'D??]TqG^ +NThdTj^*A]?:F$`XN01/m9\$C?CgRm$9-i/lX''Z>rD1[9Qj_'o3YM!?PW?CM9TCM +qHdIo?S21_W.nX?p>>98LgBga%KRN&rEq1^?Ub!&2)!kKs57api#W/3M4rj.$;*2Z +@!2\12?mQl$s29l@/^]Tedc+.P[M3<@-i@#h@/@3g0kI-@tu,C +AfXt((h)hS(TnY7]U@`]*T@gM@Ep"T/PtF*-=U\&@SS=@efnR`,t3h>@Q#^iSgS"( +/euAU@f0J?Sh+@S`T"T_j#u_fmPSKW7cPgS7+O)&7PWSV1Lkko;&2'"c92k"4(IWl +hnD:.5dJ5ic`4j,QW?4;MG06Y),(A6qr?bcp0:9$SbSAF<#j +-;%hZ;H^_.ANj'*VG:\S04b&_AUOsJ*`_\5Tu0RdGB:*!nh@HLLiAe%pTFZsD$C1aGlAsR,mc=U\.B#NP>B'sV72JZqHE_PV5 +B0GG?hJD?`PihseB4I$9/pV)sdV";Yi3ltT?@1SLGA#KV:$-b8%Y5:jIHRulB3'Xu +9,;1.KkL<@BHDtCMeVB-MHi&mBWd*!NeV5eNbCV5B`=)I2NI"FHYC-KBg(kE-B`(4 +Hta(WBb$EmMl:>JR;$8OBi^A\c!opdSnS+ll2-raVO_H(eEGbYC*a2Nm\OQnUhUqC +f^>X%5*kILWG8N#C0muSSuCr/gLng7C:5h\`is5"=R+2r+[;.#CC,WNd +MONip\n4.:CN_Jup8;]GX6UP5lhol1Y/+\X^h`(qldisi:4R-R^$I9:llO5Yf#MTC ++_t]4Cf[P%7`k#:S*Z0]A5:D:%Ya9#bO#u8l\_G2I0gDs`kPmWiql[chU=,OS=m@J8sR +b11BQj)1_CDC4ago\T#MnmN$tml^Ga#4ugIp$W+QmoqpC0)8n@phtN/DW^Y2[W_+_ +r9s&>n"0SHGTq)K!cTdpE'FJE:Bb]E#&nJcE.8.4NsTcU2LqGYn?35h[g[65%<1bE +nG`u<#7keb&of!,E>K=/0,3q@'le.-EIS_nNu)f&(ic/eEN^@%V]Bcl*V%GsEW7,$ +%j(9`+EAhQE\A\Y5:(>/-?;m/nme01>Fs7:M"]V +!UpV4.q`I;O(i_Y@s/r0G->_*5ATuED"cb)G40BnkAb\FEVBuaG<^.m:NH2:-?c#* +GCOj]O*PkDFa$?!GHZC<^O:=8IWs+epYUIF%tJmHJ+t[JGW14q#C6)OL3RWlG^fhj +5DaV\MKhXLGb9ohYDd_`NHjoNq#?A"#EO-@/,4m`GC!j$#AO/[GtWd:kL +HG?P-c`MNNY'TQ?HN13r&$^I'Z?k]"HTIpK0=?.6[X2r%H[iPPO1BV0\pLWmHb[4? +cb4\_^3f=`HiLm/&&EW8_L+#SHp>Ps:W7]g`dD]nqa\_TO3)dAb'^D9I)!mQccpjp +c@#*,I/hQA&(,eIdX^GJ%to2ci&@NrdXD:#Qt&0"+igH +d!.r*'aoa`@F4e&7O8_*7:OYh`+CkGN^mU,q#lF@,EbW/dWn6X<@aA.A^^C-`aprp +9kMk"`9)2(Skj"Jq?7(W6_[Fke9XP1PtRuQC"3!57\s%`M&9fR-.9'oU(AES12D +7jXAAATHIO`b./uc=_4OrZ\gjVa@Q-8<2H//CS8#=]"FaDkma(Mg7mWX$6rs+=uj77JChLA%nea)pU +IGY!Za5uphI=C('a63-mrdTFDquHf5:`KcC^sG1U"Mmo>)$[q(Hm&d4:n/sA_U,qM +%)Yos3=`sRr':n4;&i.?`6g\E'ZEpS=Vf!(Hsml3;4M>=`mMG=*61q3Gok#Rr.-!3 +;B1N;aO325,frqhR3p&(I%_t2;Oj^9b0mr-/B^rH\Lu(Rr4t)2;]Nn7bgS]%1sJs( +ff%+(I,R'1;k3)5cI9Gr4O6s]q**-Rr;f11<#l93d*t2j7+"t>)+N$'I3D/0<1PI1 +daYrb9[cts3DS&QrBX90h)2@,&INaO, +=Ipt!in1t"N8n$s3KE.Pr]uY,=WU.tjOl^oPiZ%S=dJ1&IUSW+=e9>rk1RIgSEF&3 +H(O3Prdga+=rrNpkh84_V!2&hRAT6&I\E_*>+V^nlIrtWXQs'H\ZY8PrkYi*>9:nl +m+X_O[-_((fs^;&Ic7g)>Ft)jmb>JG]^K(]q7c=PrrKq)>TX9hnD$5?`:7)>)924% +Ij)o(>b$(>ouYdo\D`/eFd*S=k<9%Ipq"'?(Yibp>*K' +h"P+3H/A;Os+0,'?6>$`pte5tjS<+hRHF>%J"c*&?D"4^qVJulm/(,H\aK@Os2"4& +?Q[D\r80`do_i-(g%PC%J)U2%?_?TZrnkK\r;U-]q>UE?rW#2#"T[I+"b=r@"@/=h +!oRSuJ^?Rd5o:mNi1q*>cs@,HQo,*+j;im"ILng_70qit-%sX:'LJ0e$K5MIL![ON +6PsACiM8>cd,#a0Qurntj?8:FrZFTGKb35h7>T>4,Xe#b'&mFrM:"L872Vj8ihTS3 +d9\@mR'd^hjB[\kIP=5.`>IV\AW5$.1e*k_)WP@FNR>I"7i:>-j.pgXdG?uUR.VN\ +jF**:r]j!l"X)kOKoj_(6qE^\,339oOjZEa8Jrg"jJ8'(dU#U=R5H>PjIML_IS`WS +74@7CV3KE"<(`QY.ck3CQ.!BK9,V:ljeT;Mdb\5%R<:.DjLpo.ra8D;KeVX7`L,*q +A5&DV1?N,lRF=?59c9cak+pOrdp?ibRC+s8jP?q]5lD7L\eR#=WR^H2]j^"q; +I]uik`E;FPAZXFRZrWXG>3fa:Xjt.q_rkMVT"^p[C +Ks9,L`)rKD@dIZcZ.;+[=W8Ytm%ouQem?R'Rl+gEjdia/IaD7;7;2'7V6ngFe68>A +C@,T7[FW(E>8q-imA75!fdRrrW9jh8.Srnq$#KlHH+`OOM@jBS1>EpdM`\^s%/ +>oTV^m\SIFf3[fLS$dG-jk[Q#IdgY_`H^htjh03:oNn$;HLGG4^":!n?Q8*Sn"o]k +fA?F4S+V7!jo)sGrr?FH"b?(h"i/b4"CR`7K(*@]_:UsX@2pSHn>6r;fO#%qS2H&j +jrM@lIh6'/7>UI\-,eH.'OmS4MXb:1`RqpB@iT'=nYS1`f\[ZYS99k^jupc;rubhl +KokjP7EF.(,\3F1P4E3Zak8m,AK7P2ntoF0fj?:AS@+[Rk$?0`IkYIS`L-6DA^&i" +1hN9.Re(-.c.TikB,p$'o;6ZUg#"o)SFrKFk'bS/s$16<"ebK7L!\Nq6ti,+U@`&W +dFpfUBcSLqoVRo%g0[NfSMd;:k+0uTIo'l#7B#l+V:=4k<,.t(WqBu+e_7c?CE6uf +oqo.Jg>?.NSTV+.k.TC#s'TX`Ks:7t`RroeA8Ig%ZM%nTg"S`)D&oI[p86BogL"c6 +S[Gp"k2"eHIrK9G`OPXhjkSU_FDdZ"](]h(h:o\hD]RrPpSRW?gY[BsSb9_kk5F2l +s+#&0"i0m\"lS/XKQ*Lt_Y@aQiS6YRE?6FEpnnkdgg?"[Si+O_k8iUN"mG5Oe +G95l$qknT)h;>khT(Ut;kC)gTs1ik$"lT;+L%*q@`-@mhir!GKn_QLOGon?nr25hN +hI"KPT/Gd/kFM5$J'`K`7Hj[tV=`W:e9[`elMY@tp"mI9HQQhcrMR'shV[+8T69T# +kIpWHs588HL%,'h`VA=4jF!Sbo)<:Hq;4F#I35_uT=+ClkM?$mJ+.n/ +`VBH\jo"#.oR grestore showpage %%PageTrailer diff --git a/packages/python/plotly/plotly/tests/test_orca/images/linux/latexfig.eps b/packages/python/plotly/plotly/tests/test_orca/images/linux/latexfig.eps index 7ae095f1418..2c71047cafd 100644 --- a/packages/python/plotly/plotly/tests/test_orca/images/linux/latexfig.eps +++ b/packages/python/plotly/plotly/tests/test_orca/images/linux/latexfig.eps @@ -1,5 +1,5 @@ %!PS-Adobe-3.0 EPSF-3.0 -%Produced by poppler pdftops version: 0.71.0 (http://poppler.freedesktop.org) +%Produced by poppler pdftops version: 22.02.0 (http://poppler.freedesktop.org) %%Creator: Chromium %%LanguageLevel: 2 %%DocumentSuppliedResources: (atend) diff --git a/packages/python/plotly/plotly/tests/test_orca/images/linux/topofig.eps b/packages/python/plotly/plotly/tests/test_orca/images/linux/topofig.eps index 18fb1f034de..715d6d10f77 100644 --- a/packages/python/plotly/plotly/tests/test_orca/images/linux/topofig.eps +++ b/packages/python/plotly/plotly/tests/test_orca/images/linux/topofig.eps @@ -1,5 +1,5 @@ %!PS-Adobe-3.0 EPSF-3.0 -%Produced by poppler pdftops version: 0.71.0 (http://poppler.freedesktop.org) +%Produced by poppler pdftops version: 22.02.0 (http://poppler.freedesktop.org) %%Creator: Chromium %%LanguageLevel: 2 %%DocumentSuppliedResources: (atend) diff --git a/packages/python/plotly/plotly/validators/_bar.py b/packages/python/plotly/plotly/validators/_bar.py index 0777fb63bd3..b5cc9e73450 100644 --- a/packages/python/plotly/plotly/validators/_bar.py +++ b/packages/python/plotly/plotly/validators/_bar.py @@ -94,6 +94,7 @@ def __init__(self, plotly_name="bar", parent_name="", **kwargs): 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 variables `value` and `label`. Anything contained in tag `` is displayed in the secondary box, for example @@ -128,6 +129,12 @@ def __init__(self, plotly_name="bar", parent_name="", **kwargs): insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the @@ -261,7 +268,8 @@ def __init__(self, plotly_name="bar", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `value` and `label`. texttemplatesrc Sets the source reference on Chart Studio Cloud diff --git a/packages/python/plotly/plotly/validators/_barpolar.py b/packages/python/plotly/plotly/validators/_barpolar.py index ee4fbb89b87..7433c905ea4 100644 --- a/packages/python/plotly/plotly/validators/_barpolar.py +++ b/packages/python/plotly/plotly/validators/_barpolar.py @@ -94,6 +94,12 @@ def __init__(self, plotly_name="barpolar", parent_name="", **kwargs): 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_box.py b/packages/python/plotly/plotly/validators/_box.py index 6cb858aa803..bbf32923b25 100644 --- a/packages/python/plotly/plotly/validators/_box.py +++ b/packages/python/plotly/plotly/validators/_box.py @@ -126,6 +126,12 @@ def __init__(self, plotly_name="box", parent_name="", **kwargs): distribution axis. If 1, the sample points are drawn in a random jitter of width equal to the width of the box(es). + 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_candlestick.py b/packages/python/plotly/plotly/validators/_candlestick.py index 21f32161420..325f632b1a6 100644 --- a/packages/python/plotly/plotly/validators/_candlestick.py +++ b/packages/python/plotly/plotly/validators/_candlestick.py @@ -63,6 +63,12 @@ def __init__(self, plotly_name="candlestick", parent_name="", **kwargs): :class:`plotly.graph_objects.candlestick.Increa sing` instance or dict with compatible properties + 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_carpet.py b/packages/python/plotly/plotly/validators/_carpet.py index 951daa75d7b..19c331babab 100644 --- a/packages/python/plotly/plotly/validators/_carpet.py +++ b/packages/python/plotly/plotly/validators/_carpet.py @@ -76,6 +76,12 @@ def __init__(self, plotly_name="carpet", parent_name="", **kwargs): 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. legendgrouptitle :class:`plotly.graph_objects.carpet.Legendgroup title` instance or dict with compatible diff --git a/packages/python/plotly/plotly/validators/_choropleth.py b/packages/python/plotly/plotly/validators/_choropleth.py index 34701fa45a5..a516a267707 100644 --- a/packages/python/plotly/plotly/validators/_choropleth.py +++ b/packages/python/plotly/plotly/validators/_choropleth.py @@ -136,6 +136,12 @@ def __init__(self, plotly_name="choropleth", parent_name="", **kwargs): 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_choroplethmapbox.py b/packages/python/plotly/plotly/validators/_choroplethmapbox.py index 04e2e288bd5..b9bb114ef95 100644 --- a/packages/python/plotly/plotly/validators/_choroplethmapbox.py +++ b/packages/python/plotly/plotly/validators/_choroplethmapbox.py @@ -114,6 +114,7 @@ def __init__(self, plotly_name="choroplethmapbox", parent_name="", **kwargs): 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 `` is displayed in the secondary box, for example "{fullData.name}". @@ -135,6 +136,12 @@ def __init__(self, plotly_name="choroplethmapbox", parent_name="", **kwargs): 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_cone.py b/packages/python/plotly/plotly/validators/_cone.py index 89f66016de0..8f1ac085204 100644 --- a/packages/python/plotly/plotly/validators/_cone.py +++ b/packages/python/plotly/plotly/validators/_cone.py @@ -118,6 +118,7 @@ def __init__(self, plotly_name="cone", parent_name="", **kwargs): 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 `norm` Anything contained in tag `` is displayed in the secondary box, for example "{fullData.name}". @@ -139,6 +140,12 @@ def __init__(self, plotly_name="cone", parent_name="", **kwargs): 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_contour.py b/packages/python/plotly/plotly/validators/_contour.py index d5dcaec6770..0903bc05bce 100644 --- a/packages/python/plotly/plotly/validators/_contour.py +++ b/packages/python/plotly/plotly/validators/_contour.py @@ -144,6 +144,12 @@ def __init__(self, plotly_name="contour", parent_name="", **kwargs): 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 part of the same legend group hide/show at the @@ -239,7 +245,8 @@ def __init__(self, plotly_name="contour", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `x`, `y`, `z` and `text`. transpose Transposes the z data. diff --git a/packages/python/plotly/plotly/validators/_contourcarpet.py b/packages/python/plotly/plotly/validators/_contourcarpet.py index 1b470abe8ec..a2fd7c10096 100644 --- a/packages/python/plotly/plotly/validators/_contourcarpet.py +++ b/packages/python/plotly/plotly/validators/_contourcarpet.py @@ -121,6 +121,12 @@ def __init__(self, plotly_name="contourcarpet", parent_name="", **kwargs): 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_densitymapbox.py b/packages/python/plotly/plotly/validators/_densitymapbox.py index 475d80d4e9f..ce5710d4264 100644 --- a/packages/python/plotly/plotly/validators/_densitymapbox.py +++ b/packages/python/plotly/plotly/validators/_densitymapbox.py @@ -135,6 +135,12 @@ def __init__(self, plotly_name="densitymapbox", parent_name="", **kwargs): latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_funnel.py b/packages/python/plotly/plotly/validators/_funnel.py index 88c934ee9fa..1b4f3c182c3 100644 --- a/packages/python/plotly/plotly/validators/_funnel.py +++ b/packages/python/plotly/plotly/validators/_funnel.py @@ -83,6 +83,7 @@ def __init__(self, plotly_name="funnel", parent_name="", **kwargs): 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 variables `percentInitial`, `percentPrevious` and `percentTotal`. Anything contained in tag `` is displayed in the secondary box, @@ -117,6 +118,12 @@ def __init__(self, plotly_name="funnel", parent_name="", **kwargs): insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the @@ -255,7 +262,8 @@ def __init__(self, plotly_name="funnel", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `percentInitial`, `percentPrevious`, `percentTotal`, `label` and `value`. texttemplatesrc diff --git a/packages/python/plotly/plotly/validators/_funnelarea.py b/packages/python/plotly/plotly/validators/_funnelarea.py index 53f5f44ca38..d9d4f4b8e18 100644 --- a/packages/python/plotly/plotly/validators/_funnelarea.py +++ b/packages/python/plotly/plotly/validators/_funnelarea.py @@ -71,6 +71,7 @@ def __init__(self, plotly_name="funnelarea", parent_name="", **kwargs): 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 variables `label`, `color`, `value`, `text` and `percent`. Anything contained in tag `` is displayed in the secondary box, for example @@ -115,6 +116,12 @@ def __init__(self, plotly_name="funnelarea", parent_name="", **kwargs): labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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 part of the same legend group hide/show at the @@ -208,7 +215,8 @@ def __init__(self, plotly_name="funnelarea", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `label`, `color`, `value`, `text` and `percent`. texttemplatesrc diff --git a/packages/python/plotly/plotly/validators/_heatmap.py b/packages/python/plotly/plotly/validators/_heatmap.py index d1f8239a788..6f0af17da65 100644 --- a/packages/python/plotly/plotly/validators/_heatmap.py +++ b/packages/python/plotly/plotly/validators/_heatmap.py @@ -130,6 +130,12 @@ def __init__(self, plotly_name="heatmap", parent_name="", **kwargs): 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 part of the same legend group hide/show at the @@ -211,7 +217,8 @@ def __init__(self, plotly_name="heatmap", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `x`, `y`, `z` and `text`. transpose Transposes the z data. diff --git a/packages/python/plotly/plotly/validators/_heatmapgl.py b/packages/python/plotly/plotly/validators/_heatmapgl.py index 93656fc264d..800ddba8ae1 100644 --- a/packages/python/plotly/plotly/validators/_heatmapgl.py +++ b/packages/python/plotly/plotly/validators/_heatmapgl.py @@ -79,6 +79,12 @@ def __init__(self, plotly_name="heatmapgl", parent_name="", **kwargs): 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. legendgrouptitle :class:`plotly.graph_objects.heatmapgl.Legendgr ouptitle` instance or dict with compatible diff --git a/packages/python/plotly/plotly/validators/_histogram.py b/packages/python/plotly/plotly/validators/_histogram.py index bec610094a3..800e6761d1d 100644 --- a/packages/python/plotly/plotly/validators/_histogram.py +++ b/packages/python/plotly/plotly/validators/_histogram.py @@ -133,6 +133,7 @@ def __init__(self, plotly_name="histogram", parent_name="", **kwargs): 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 `binNumber` Anything contained in tag `` is displayed in the secondary box, for example "{fullData.name}". @@ -161,6 +162,12 @@ def __init__(self, plotly_name="histogram", parent_name="", **kwargs): insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the @@ -293,7 +300,8 @@ def __init__(self, plotly_name="histogram", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `label` and `value`. uid Assign an id to this trace, Use this to provide diff --git a/packages/python/plotly/plotly/validators/_histogram2d.py b/packages/python/plotly/plotly/validators/_histogram2d.py index 4bfa1b4f931..2f67433c553 100644 --- a/packages/python/plotly/plotly/validators/_histogram2d.py +++ b/packages/python/plotly/plotly/validators/_histogram2d.py @@ -138,6 +138,7 @@ def __init__(self, plotly_name="histogram2d", parent_name="", **kwargs): 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 `z` Anything contained in tag `` is displayed in the secondary box, for example "{fullData.name}". @@ -154,6 +155,12 @@ def __init__(self, plotly_name="histogram2d", parent_name="", **kwargs): 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 part of the same legend group hide/show at the @@ -244,8 +251,8 @@ def __init__(self, plotly_name="histogram2d", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variable - `z` + are `arrayOk: true`) are available. Finally, + the template string has access to variable `z` uid Assign an id to this trace, Use this to provide object constancy between traces during diff --git a/packages/python/plotly/plotly/validators/_histogram2dcontour.py b/packages/python/plotly/plotly/validators/_histogram2dcontour.py index 65963822424..b7857d5df71 100644 --- a/packages/python/plotly/plotly/validators/_histogram2dcontour.py +++ b/packages/python/plotly/plotly/validators/_histogram2dcontour.py @@ -149,6 +149,7 @@ def __init__(self, plotly_name="histogram2dcontour", parent_name="", **kwargs): 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 `z` Anything contained in tag `` is displayed in the secondary box, for example "{fullData.name}". @@ -165,6 +166,12 @@ def __init__(self, plotly_name="histogram2dcontour", parent_name="", **kwargs): 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 part of the same legend group hide/show at the @@ -272,7 +279,8 @@ def __init__(self, plotly_name="histogram2dcontour", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `x`, `y`, `z` and `text`. uid Assign an id to this trace, Use this to provide diff --git a/packages/python/plotly/plotly/validators/_icicle.py b/packages/python/plotly/plotly/validators/_icicle.py index 61f6675c6fd..8a2485f31ae 100644 --- a/packages/python/plotly/plotly/validators/_icicle.py +++ b/packages/python/plotly/plotly/validators/_icicle.py @@ -74,6 +74,7 @@ def __init__(self, plotly_name="icicle", parent_name="", **kwargs): 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 variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry` and `percentParent`. Anything contained in tag @@ -113,6 +114,12 @@ def __init__(self, plotly_name="icicle", parent_name="", **kwargs): leaf :class:`plotly.graph_objects.icicle.Leaf` instance or dict with compatible properties + 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. legendgrouptitle :class:`plotly.graph_objects.icicle.Legendgroup title` instance or dict with compatible @@ -228,7 +235,8 @@ def __init__(self, plotly_name="icicle", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry`, `percentParent`, `label` and `value`. diff --git a/packages/python/plotly/plotly/validators/_image.py b/packages/python/plotly/plotly/validators/_image.py index b85d599da98..7901a479621 100644 --- a/packages/python/plotly/plotly/validators/_image.py +++ b/packages/python/plotly/plotly/validators/_image.py @@ -69,6 +69,7 @@ def __init__(self, plotly_name="image", parent_name="", **kwargs): 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 variables `z`, `color` and `colormodel`. Anything contained in tag `` is displayed in the secondary box, for example @@ -91,6 +92,12 @@ def __init__(self, plotly_name="image", parent_name="", **kwargs): 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. legendgrouptitle :class:`plotly.graph_objects.image.Legendgroupt itle` instance or dict with compatible @@ -175,7 +182,10 @@ def __init__(self, plotly_name="image", parent_name="", **kwargs): drawn, but can appear as a legend item (provided that the legend itself is visible). x0 - Set the image's x position. + Set the image's x position. The left edge of + the image (or the right edge if the x axis is + reversed or dx is negative) will be found at + xmin=x0-dx/2 xaxis Sets a reference between this trace's x coordinates and a 2D cartesian x axis. If "x" @@ -183,7 +193,14 @@ def __init__(self, plotly_name="image", parent_name="", **kwargs): `layout.xaxis`. If "x2", the x coordinates refer to `layout.xaxis2`, and so on. y0 - Set the image's y position. + Set the image's y position. The top edge of the + image (or the bottom edge if the y axis is NOT + reversed or if dy is negative) will be found at + ymin=y0-dy/2. By default when an image trace is + included, the y axis will be reversed so that + the image is right-side-up, but you can disable + this by setting yaxis.autorange=true or by + providing an explicit y axis range. yaxis Sets a reference between this trace's y coordinates and a 2D cartesian y axis. If "y" diff --git a/packages/python/plotly/plotly/validators/_indicator.py b/packages/python/plotly/plotly/validators/_indicator.py index e8713280718..63da1823a7c 100644 --- a/packages/python/plotly/plotly/validators/_indicator.py +++ b/packages/python/plotly/plotly/validators/_indicator.py @@ -40,6 +40,12 @@ def __init__(self, plotly_name="indicator", parent_name="", **kwargs): 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. legendgrouptitle :class:`plotly.graph_objects.indicator.Legendgr ouptitle` instance or dict with compatible diff --git a/packages/python/plotly/plotly/validators/_isosurface.py b/packages/python/plotly/plotly/validators/_isosurface.py index 2c66eecfd69..d987087dc5d 100644 --- a/packages/python/plotly/plotly/validators/_isosurface.py +++ b/packages/python/plotly/plotly/validators/_isosurface.py @@ -149,6 +149,12 @@ def __init__(self, plotly_name="isosurface", parent_name="", **kwargs): Sets the maximum boundary for iso-surface plot. isomin Sets the minimum boundary for iso-surface plot. + 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_mesh3d.py b/packages/python/plotly/plotly/validators/_mesh3d.py index 3d7d6b99316..3260769ea33 100644 --- a/packages/python/plotly/plotly/validators/_mesh3d.py +++ b/packages/python/plotly/plotly/validators/_mesh3d.py @@ -226,6 +226,12 @@ def __init__(self, plotly_name="mesh3d", parent_name="", **kwargs): ksrc Sets the source reference on Chart Studio Cloud for `k`. + 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_ohlc.py b/packages/python/plotly/plotly/validators/_ohlc.py index 053f4a504c3..251a36bae19 100644 --- a/packages/python/plotly/plotly/validators/_ohlc.py +++ b/packages/python/plotly/plotly/validators/_ohlc.py @@ -60,6 +60,12 @@ def __init__(self, plotly_name="ohlc", parent_name="", **kwargs): increasing :class:`plotly.graph_objects.ohlc.Increasing` instance or dict with compatible properties + 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_parcats.py b/packages/python/plotly/plotly/validators/_parcats.py index 3319662d501..c9830f6fd4c 100644 --- a/packages/python/plotly/plotly/validators/_parcats.py +++ b/packages/python/plotly/plotly/validators/_parcats.py @@ -80,6 +80,11 @@ def __init__(self, plotly_name="parcats", parent_name="", **kwargs): events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. + This value here applies when hovering over + dimensions. Note that `*categorycount`, + "colorcount" and "bandcolorcount" are only + available when `hoveron` contains the "color" + flagFinally, the template string has access to variables `count`, `probability`, `category`, `categorycount`, `colorcount` and `bandcolorcount`. Anything contained in tag diff --git a/packages/python/plotly/plotly/validators/_parcoords.py b/packages/python/plotly/plotly/validators/_parcoords.py index ecbe6516b91..5f63969c4a6 100644 --- a/packages/python/plotly/plotly/validators/_parcoords.py +++ b/packages/python/plotly/plotly/validators/_parcoords.py @@ -55,6 +55,12 @@ def __init__(self, plotly_name="parcoords", parent_name="", **kwargs): Tilted labels with "labelangle" may be positioned better inside margins when `labelposition` is set to "bottom". + 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. legendgrouptitle :class:`plotly.graph_objects.parcoords.Legendgr ouptitle` instance or dict with compatible diff --git a/packages/python/plotly/plotly/validators/_pie.py b/packages/python/plotly/plotly/validators/_pie.py index defbafe8d03..3873be27b9a 100644 --- a/packages/python/plotly/plotly/validators/_pie.py +++ b/packages/python/plotly/plotly/validators/_pie.py @@ -74,6 +74,7 @@ def __init__(self, plotly_name="pie", parent_name="", **kwargs): 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 variables `label`, `color`, `value`, `percent` and `text`. Anything contained in tag `` is displayed in the secondary box, for example @@ -129,6 +130,12 @@ def __init__(self, plotly_name="pie", parent_name="", **kwargs): labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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 part of the same legend group hide/show at the @@ -239,7 +246,8 @@ def __init__(self, plotly_name="pie", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `label`, `color`, `value`, `percent` and `text`. texttemplatesrc diff --git a/packages/python/plotly/plotly/validators/_pointcloud.py b/packages/python/plotly/plotly/validators/_pointcloud.py index 0971254d113..972ef8df04f 100644 --- a/packages/python/plotly/plotly/validators/_pointcloud.py +++ b/packages/python/plotly/plotly/validators/_pointcloud.py @@ -54,6 +54,12 @@ def __init__(self, plotly_name="pointcloud", parent_name="", **kwargs): indicessrc Sets the source reference on Chart Studio Cloud for `indices`. + 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_sankey.py b/packages/python/plotly/plotly/validators/_sankey.py index 56047decd21..574b6cda6f7 100644 --- a/packages/python/plotly/plotly/validators/_sankey.py +++ b/packages/python/plotly/plotly/validators/_sankey.py @@ -51,6 +51,12 @@ def __init__(self, plotly_name="sankey", parent_name="", **kwargs): 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. legendgrouptitle :class:`plotly.graph_objects.sankey.Legendgroup title` instance or dict with compatible diff --git a/packages/python/plotly/plotly/validators/_scatter.py b/packages/python/plotly/plotly/validators/_scatter.py index 5c0eaaab3bd..9f87e32e7e7 100644 --- a/packages/python/plotly/plotly/validators/_scatter.py +++ b/packages/python/plotly/plotly/validators/_scatter.py @@ -167,6 +167,12 @@ def __init__(self, plotly_name="scatter", parent_name="", **kwargs): 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_scatter3d.py b/packages/python/plotly/plotly/validators/_scatter3d.py index 8a7b3ce64fb..6090d03d1c0 100644 --- a/packages/python/plotly/plotly/validators/_scatter3d.py +++ b/packages/python/plotly/plotly/validators/_scatter3d.py @@ -98,6 +98,12 @@ def __init__(self, plotly_name="scatter3d", parent_name="", **kwargs): 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_scattercarpet.py b/packages/python/plotly/plotly/validators/_scattercarpet.py index 25da736cab1..e2796063121 100644 --- a/packages/python/plotly/plotly/validators/_scattercarpet.py +++ b/packages/python/plotly/plotly/validators/_scattercarpet.py @@ -128,6 +128,12 @@ def __init__(self, plotly_name="scattercarpet", parent_name="", **kwargs): 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 part of the same legend group hide/show at the @@ -240,7 +246,8 @@ def __init__(self, plotly_name="scattercarpet", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `a`, `b` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud diff --git a/packages/python/plotly/plotly/validators/_scattergeo.py b/packages/python/plotly/plotly/validators/_scattergeo.py index 1c3e6a69e3f..2f5a0d184c1 100644 --- a/packages/python/plotly/plotly/validators/_scattergeo.py +++ b/packages/python/plotly/plotly/validators/_scattergeo.py @@ -130,6 +130,12 @@ def __init__(self, plotly_name="scattergeo", parent_name="", **kwargs): latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the @@ -264,7 +270,8 @@ def __init__(self, plotly_name="scattergeo", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `lat`, `lon`, `location` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud diff --git a/packages/python/plotly/plotly/validators/_scattergl.py b/packages/python/plotly/plotly/validators/_scattergl.py index 072c29ec7d5..46878cd8a59 100644 --- a/packages/python/plotly/plotly/validators/_scattergl.py +++ b/packages/python/plotly/plotly/validators/_scattergl.py @@ -132,6 +132,12 @@ def __init__(self, plotly_name="scattergl", parent_name="", **kwargs): 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_scattermapbox.py b/packages/python/plotly/plotly/validators/_scattermapbox.py index 41ed9f44d73..747a8eaadef 100644 --- a/packages/python/plotly/plotly/validators/_scattermapbox.py +++ b/packages/python/plotly/plotly/validators/_scattermapbox.py @@ -119,6 +119,12 @@ def __init__(self, plotly_name="scattermapbox", parent_name="", **kwargs): latsrc Sets the source reference on Chart Studio Cloud for `lat`. + 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 part of the same legend group hide/show at the @@ -241,7 +247,8 @@ def __init__(self, plotly_name="scattermapbox", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `lat`, `lon` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud diff --git a/packages/python/plotly/plotly/validators/_scatterpolar.py b/packages/python/plotly/plotly/validators/_scatterpolar.py index bcee6cb7e9c..c6a39cdc942 100644 --- a/packages/python/plotly/plotly/validators/_scatterpolar.py +++ b/packages/python/plotly/plotly/validators/_scatterpolar.py @@ -126,6 +126,12 @@ def __init__(self, plotly_name="scatterpolar", parent_name="", **kwargs): 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 part of the same legend group hide/show at the @@ -253,7 +259,8 @@ def __init__(self, plotly_name="scatterpolar", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `r`, `theta` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud diff --git a/packages/python/plotly/plotly/validators/_scatterpolargl.py b/packages/python/plotly/plotly/validators/_scatterpolargl.py index d0bc1571220..ac1e04a3e1c 100644 --- a/packages/python/plotly/plotly/validators/_scatterpolargl.py +++ b/packages/python/plotly/plotly/validators/_scatterpolargl.py @@ -127,6 +127,12 @@ def __init__(self, plotly_name="scatterpolargl", parent_name="", **kwargs): 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 part of the same legend group hide/show at the @@ -256,7 +262,8 @@ def __init__(self, plotly_name="scatterpolargl", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `r`, `theta` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud diff --git a/packages/python/plotly/plotly/validators/_scattersmith.py b/packages/python/plotly/plotly/validators/_scattersmith.py index 7eeb0149d09..c610699f34b 100644 --- a/packages/python/plotly/plotly/validators/_scattersmith.py +++ b/packages/python/plotly/plotly/validators/_scattersmith.py @@ -127,6 +127,12 @@ def __init__(self, plotly_name="scattersmith", parent_name="", **kwargs): imagsrc Sets the source reference on Chart Studio Cloud for `imag`. + 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 part of the same legend group hide/show at the @@ -252,7 +258,8 @@ def __init__(self, plotly_name="scattersmith", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `real`, `imag` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud diff --git a/packages/python/plotly/plotly/validators/_scatterternary.py b/packages/python/plotly/plotly/validators/_scatterternary.py index cf2a07e5a52..3899f83d102 100644 --- a/packages/python/plotly/plotly/validators/_scatterternary.py +++ b/packages/python/plotly/plotly/validators/_scatterternary.py @@ -150,6 +150,12 @@ def __init__(self, plotly_name="scatterternary", parent_name="", **kwargs): 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 part of the same legend group hide/show at the @@ -277,7 +283,8 @@ def __init__(self, plotly_name="scatterternary", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `a`, `b`, `c` and `text`. texttemplatesrc Sets the source reference on Chart Studio Cloud diff --git a/packages/python/plotly/plotly/validators/_splom.py b/packages/python/plotly/plotly/validators/_splom.py index 80731c5fd6a..69e26e98823 100644 --- a/packages/python/plotly/plotly/validators/_splom.py +++ b/packages/python/plotly/plotly/validators/_splom.py @@ -92,6 +92,12 @@ def __init__(self, plotly_name="splom", parent_name="", **kwargs): 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_streamtube.py b/packages/python/plotly/plotly/validators/_streamtube.py index f316fcd04d7..c81e9741e36 100644 --- a/packages/python/plotly/plotly/validators/_streamtube.py +++ b/packages/python/plotly/plotly/validators/_streamtube.py @@ -114,6 +114,7 @@ def __init__(self, plotly_name="streamtube", parent_name="", **kwargs): 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 variables `tubex`, `tubey`, `tubez`, `tubeu`, `tubev`, `tubew`, `norm` and `divergence`. Anything contained in tag `` is @@ -134,6 +135,12 @@ def __init__(self, plotly_name="streamtube", parent_name="", **kwargs): 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_sunburst.py b/packages/python/plotly/plotly/validators/_sunburst.py index bd422bf98cb..a4a000a787d 100644 --- a/packages/python/plotly/plotly/validators/_sunburst.py +++ b/packages/python/plotly/plotly/validators/_sunburst.py @@ -74,6 +74,7 @@ def __init__(self, plotly_name="sunburst", parent_name="", **kwargs): 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 variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry` and `percentParent`. Anything contained in tag @@ -124,6 +125,12 @@ def __init__(self, plotly_name="sunburst", parent_name="", **kwargs): leaf :class:`plotly.graph_objects.sunburst.Leaf` instance or dict with compatible properties + 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. legendgrouptitle :class:`plotly.graph_objects.sunburst.Legendgro uptitle` instance or dict with compatible @@ -238,7 +245,8 @@ def __init__(self, plotly_name="sunburst", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry`, `percentParent`, `label` and `value`. diff --git a/packages/python/plotly/plotly/validators/_surface.py b/packages/python/plotly/plotly/validators/_surface.py index 9cb7d9a253c..0f90e870e46 100644 --- a/packages/python/plotly/plotly/validators/_surface.py +++ b/packages/python/plotly/plotly/validators/_surface.py @@ -145,6 +145,12 @@ def __init__(self, plotly_name="surface", parent_name="", **kwargs): 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_table.py b/packages/python/plotly/plotly/validators/_table.py index f1e1fe73e08..ff426267396 100644 --- a/packages/python/plotly/plotly/validators/_table.py +++ b/packages/python/plotly/plotly/validators/_table.py @@ -64,6 +64,12 @@ def __init__(self, plotly_name="table", parent_name="", **kwargs): 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. legendgrouptitle :class:`plotly.graph_objects.table.Legendgroupt itle` instance or dict with compatible diff --git a/packages/python/plotly/plotly/validators/_treemap.py b/packages/python/plotly/plotly/validators/_treemap.py index afa81916578..a6e467f5650 100644 --- a/packages/python/plotly/plotly/validators/_treemap.py +++ b/packages/python/plotly/plotly/validators/_treemap.py @@ -74,6 +74,7 @@ def __init__(self, plotly_name="treemap", parent_name="", **kwargs): 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 variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry` and `percentParent`. Anything contained in tag @@ -110,6 +111,12 @@ def __init__(self, plotly_name="treemap", parent_name="", **kwargs): labelssrc Sets the source reference on Chart Studio Cloud for `labels`. + 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. legendgrouptitle :class:`plotly.graph_objects.treemap.Legendgrou ptitle` instance or dict with compatible @@ -225,7 +232,8 @@ def __init__(self, plotly_name="treemap", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `currentPath`, `root`, `entry`, `percentRoot`, `percentEntry`, `percentParent`, `label` and `value`. diff --git a/packages/python/plotly/plotly/validators/_violin.py b/packages/python/plotly/plotly/validators/_violin.py index 85b96b95b3c..3285daf62eb 100644 --- a/packages/python/plotly/plotly/validators/_violin.py +++ b/packages/python/plotly/plotly/validators/_violin.py @@ -108,6 +108,12 @@ def __init__(self, plotly_name="violin", parent_name="", **kwargs): distribution axis. If 1, the sample points are drawn in a random jitter of width equal to the width of the violins. + 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_volume.py b/packages/python/plotly/plotly/validators/_volume.py index e73aa36f3b4..0ce3613f406 100644 --- a/packages/python/plotly/plotly/validators/_volume.py +++ b/packages/python/plotly/plotly/validators/_volume.py @@ -148,6 +148,12 @@ def __init__(self, plotly_name="volume", parent_name="", **kwargs): Sets the maximum boundary for iso-surface plot. isomin Sets the minimum boundary for iso-surface plot. + 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 part of the same legend group hide/show at the diff --git a/packages/python/plotly/plotly/validators/_waterfall.py b/packages/python/plotly/plotly/validators/_waterfall.py index 1057ddb6859..f80eba85955 100644 --- a/packages/python/plotly/plotly/validators/_waterfall.py +++ b/packages/python/plotly/plotly/validators/_waterfall.py @@ -89,6 +89,7 @@ def __init__(self, plotly_name="waterfall", parent_name="", **kwargs): 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 variables `initial`, `delta` and `final`. Anything contained in tag `` is displayed in the secondary box, for example @@ -126,6 +127,12 @@ def __init__(self, plotly_name="waterfall", parent_name="", **kwargs): insidetextfont Sets the font used for `text` lying inside the bar. + 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 part of the same legend group hide/show at the @@ -269,7 +276,8 @@ def __init__(self, plotly_name="waterfall", parent_name="", **kwargs): format/tree/v2.2.3#locale_format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that - are `arrayOk: true`) are available. variables + are `arrayOk: true`) are available. Finally, + the template string has access to variables `initial`, `delta`, `final` and `label`. texttemplatesrc Sets the source reference on Chart Studio Cloud diff --git a/packages/python/plotly/plotly/validators/bar/__init__.py b/packages/python/plotly/plotly/validators/bar/__init__.py index 058b9b915c5..edb3b4032c1 100644 --- a/packages/python/plotly/plotly/validators/bar/__init__.py +++ b/packages/python/plotly/plotly/validators/bar/__init__.py @@ -52,6 +52,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._insidetextfont import InsidetextfontValidator from ._insidetextanchor import InsidetextanchorValidator from ._idssrc import IdssrcValidator @@ -131,6 +132,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._insidetextfont.InsidetextfontValidator", "._insidetextanchor.InsidetextanchorValidator", "._idssrc.IdssrcValidator", diff --git a/packages/python/plotly/plotly/validators/bar/_legend.py b/packages/python/plotly/plotly/validators/bar/_legend.py new file mode 100644 index 00000000000..81e028057cd --- /dev/null +++ b/packages/python/plotly/plotly/validators/bar/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="bar", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/bar/marker/_colorbar.py b/packages/python/plotly/plotly/validators/bar/marker/_colorbar.py index fbde242e961..eefdf0bad25 100644 --- a/packages/python/plotly/plotly/validators/bar/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/bar/marker/_colorbar.py @@ -240,9 +240,15 @@ def __init__(self, plotly_name="colorbar", parent_name="bar.marker", **kwargs): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -252,10 +258,20 @@ def __init__(self, plotly_name="colorbar", parent_name="bar.marker", **kwargs): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -265,6 +281,10 @@ def __init__(self, plotly_name="colorbar", parent_name="bar.marker", **kwargs): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/bar/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/bar/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/bar/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/bar/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/bar/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/bar/marker/colorbar/_x.py index 6d7f6c02e02..f8cc0c516d0 100644 --- a/packages/python/plotly/plotly/validators/bar/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/bar/marker/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="bar.marker.colorbar", **kwargs) plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/bar/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/bar/marker/colorbar/_xref.py new file mode 100644 index 00000000000..732ea06b732 --- /dev/null +++ b/packages/python/plotly/plotly/validators/bar/marker/colorbar/_xref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="xref", parent_name="bar.marker.colorbar", **kwargs): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/bar/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/bar/marker/colorbar/_y.py index c2783505ca5..d8b1fdf0ecb 100644 --- a/packages/python/plotly/plotly/validators/bar/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/bar/marker/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="bar.marker.colorbar", **kwargs) plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/bar/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/bar/marker/colorbar/_yref.py new file mode 100644 index 00000000000..64090824848 --- /dev/null +++ b/packages/python/plotly/plotly/validators/bar/marker/colorbar/_yref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="yref", parent_name="bar.marker.colorbar", **kwargs): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/barpolar/__init__.py b/packages/python/plotly/plotly/validators/barpolar/__init__.py index ddb5cb9990d..bb1ecd886ba 100644 --- a/packages/python/plotly/plotly/validators/barpolar/__init__.py +++ b/packages/python/plotly/plotly/validators/barpolar/__init__.py @@ -33,6 +33,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -86,6 +87,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/barpolar/_legend.py b/packages/python/plotly/plotly/validators/barpolar/_legend.py new file mode 100644 index 00000000000..3563b949283 --- /dev/null +++ b/packages/python/plotly/plotly/validators/barpolar/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="barpolar", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/barpolar/marker/_colorbar.py b/packages/python/plotly/plotly/validators/barpolar/marker/_colorbar.py index 4ca2e231589..b311d6c1dc2 100644 --- a/packages/python/plotly/plotly/validators/barpolar/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/barpolar/marker/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="barpolar.marker", **kwar the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="barpolar.marker", **kwar xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="barpolar.marker", **kwar ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_x.py index 18684abda40..722a577735d 100644 --- a/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_xref.py new file mode 100644 index 00000000000..b9a34595c61 --- /dev/null +++ b/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="barpolar.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_y.py index a225d986190..cc8f2010121 100644 --- a/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_yref.py new file mode 100644 index 00000000000..a0d8f83c021 --- /dev/null +++ b/packages/python/plotly/plotly/validators/barpolar/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="barpolar.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/box/__init__.py b/packages/python/plotly/plotly/validators/box/__init__.py index 8e322e4926a..b0a2729d513 100644 --- a/packages/python/plotly/plotly/validators/box/__init__.py +++ b/packages/python/plotly/plotly/validators/box/__init__.py @@ -64,6 +64,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._jitter import JitterValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator @@ -152,6 +153,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._jitter.JitterValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", diff --git a/packages/python/plotly/plotly/validators/box/_legend.py b/packages/python/plotly/plotly/validators/box/_legend.py new file mode 100644 index 00000000000..43533845d87 --- /dev/null +++ b/packages/python/plotly/plotly/validators/box/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="box", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/candlestick/__init__.py b/packages/python/plotly/plotly/validators/candlestick/__init__.py index 03b220fdcca..9f77961be99 100644 --- a/packages/python/plotly/plotly/validators/candlestick/__init__.py +++ b/packages/python/plotly/plotly/validators/candlestick/__init__.py @@ -34,6 +34,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._increasing import IncreasingValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator @@ -88,6 +89,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._increasing.IncreasingValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", diff --git a/packages/python/plotly/plotly/validators/candlestick/_legend.py b/packages/python/plotly/plotly/validators/candlestick/_legend.py new file mode 100644 index 00000000000..899ab2e3f74 --- /dev/null +++ b/packages/python/plotly/plotly/validators/candlestick/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="candlestick", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/carpet/__init__.py b/packages/python/plotly/plotly/validators/carpet/__init__.py index 566d1ff24ef..87b1e7d92ae 100644 --- a/packages/python/plotly/plotly/validators/carpet/__init__.py +++ b/packages/python/plotly/plotly/validators/carpet/__init__.py @@ -19,6 +19,7 @@ from ._legendwidth import LegendwidthValidator from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._font import FontValidator @@ -61,6 +62,7 @@ "._legendwidth.LegendwidthValidator", "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._font.FontValidator", diff --git a/packages/python/plotly/plotly/validators/carpet/_legend.py b/packages/python/plotly/plotly/validators/carpet/_legend.py new file mode 100644 index 00000000000..5483d3ce139 --- /dev/null +++ b/packages/python/plotly/plotly/validators/carpet/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="carpet", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/choropleth/__init__.py b/packages/python/plotly/plotly/validators/choropleth/__init__.py index 405e825a9ee..b1f72cd16e9 100644 --- a/packages/python/plotly/plotly/validators/choropleth/__init__.py +++ b/packages/python/plotly/plotly/validators/choropleth/__init__.py @@ -31,6 +31,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -85,6 +86,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/choropleth/_colorbar.py b/packages/python/plotly/plotly/validators/choropleth/_colorbar.py index c239afd00f6..958cbb3e764 100644 --- a/packages/python/plotly/plotly/validators/choropleth/_colorbar.py +++ b/packages/python/plotly/plotly/validators/choropleth/_colorbar.py @@ -240,9 +240,15 @@ def __init__(self, plotly_name="colorbar", parent_name="choropleth", **kwargs): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -252,10 +258,20 @@ def __init__(self, plotly_name="colorbar", parent_name="choropleth", **kwargs): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -265,6 +281,10 @@ def __init__(self, plotly_name="colorbar", parent_name="choropleth", **kwargs): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/choropleth/_legend.py b/packages/python/plotly/plotly/validators/choropleth/_legend.py new file mode 100644 index 00000000000..04273e21ef0 --- /dev/null +++ b/packages/python/plotly/plotly/validators/choropleth/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="choropleth", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/choropleth/colorbar/__init__.py b/packages/python/plotly/plotly/validators/choropleth/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/choropleth/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/choropleth/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/choropleth/colorbar/_x.py b/packages/python/plotly/plotly/validators/choropleth/colorbar/_x.py index 28cc2093762..38bdf123d80 100644 --- a/packages/python/plotly/plotly/validators/choropleth/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/choropleth/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="choropleth.colorbar", **kwargs) plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/choropleth/colorbar/_xref.py b/packages/python/plotly/plotly/validators/choropleth/colorbar/_xref.py new file mode 100644 index 00000000000..38dfbb2c5b0 --- /dev/null +++ b/packages/python/plotly/plotly/validators/choropleth/colorbar/_xref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="xref", parent_name="choropleth.colorbar", **kwargs): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/choropleth/colorbar/_y.py b/packages/python/plotly/plotly/validators/choropleth/colorbar/_y.py index fe97af217c7..1e75127902e 100644 --- a/packages/python/plotly/plotly/validators/choropleth/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/choropleth/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="choropleth.colorbar", **kwargs) plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/choropleth/colorbar/_yref.py b/packages/python/plotly/plotly/validators/choropleth/colorbar/_yref.py new file mode 100644 index 00000000000..fad04acf621 --- /dev/null +++ b/packages/python/plotly/plotly/validators/choropleth/colorbar/_yref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="yref", parent_name="choropleth.colorbar", **kwargs): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/choroplethmapbox/__init__.py b/packages/python/plotly/plotly/validators/choroplethmapbox/__init__.py index 6bf73df4f7e..7fe8fbdc42c 100644 --- a/packages/python/plotly/plotly/validators/choroplethmapbox/__init__.py +++ b/packages/python/plotly/plotly/validators/choroplethmapbox/__init__.py @@ -31,6 +31,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -85,6 +86,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/choroplethmapbox/_colorbar.py b/packages/python/plotly/plotly/validators/choroplethmapbox/_colorbar.py index 44120b325e4..8b4436408e8 100644 --- a/packages/python/plotly/plotly/validators/choroplethmapbox/_colorbar.py +++ b/packages/python/plotly/plotly/validators/choroplethmapbox/_colorbar.py @@ -243,9 +243,15 @@ def __init__( the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/choroplethmapbox/_legend.py b/packages/python/plotly/plotly/validators/choroplethmapbox/_legend.py new file mode 100644 index 00000000000..77edb93d07a --- /dev/null +++ b/packages/python/plotly/plotly/validators/choroplethmapbox/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="choroplethmapbox", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/__init__.py b/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_x.py b/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_x.py index aa39757da4f..7f97f64a354 100644 --- a/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_xref.py b/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_xref.py new file mode 100644 index 00000000000..68e6ce93e56 --- /dev/null +++ b/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="choroplethmapbox.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_y.py b/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_y.py index 17df20d6d42..6045065c66b 100644 --- a/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_yref.py b/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_yref.py new file mode 100644 index 00000000000..dce38598a91 --- /dev/null +++ b/packages/python/plotly/plotly/validators/choroplethmapbox/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="choroplethmapbox.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/cone/__init__.py b/packages/python/plotly/plotly/validators/cone/__init__.py index a427180db96..4d36d20a24f 100644 --- a/packages/python/plotly/plotly/validators/cone/__init__.py +++ b/packages/python/plotly/plotly/validators/cone/__init__.py @@ -42,6 +42,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -109,6 +110,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/cone/_colorbar.py b/packages/python/plotly/plotly/validators/cone/_colorbar.py index 25c70e39a72..c8ecdbaaee7 100644 --- a/packages/python/plotly/plotly/validators/cone/_colorbar.py +++ b/packages/python/plotly/plotly/validators/cone/_colorbar.py @@ -237,9 +237,15 @@ def __init__(self, plotly_name="colorbar", parent_name="cone", **kwargs): Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -249,10 +255,20 @@ def __init__(self, plotly_name="colorbar", parent_name="cone", **kwargs): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -262,6 +278,10 @@ def __init__(self, plotly_name="colorbar", parent_name="cone", **kwargs): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/cone/_legend.py b/packages/python/plotly/plotly/validators/cone/_legend.py new file mode 100644 index 00000000000..9093a9caa2f --- /dev/null +++ b/packages/python/plotly/plotly/validators/cone/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="cone", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/cone/colorbar/__init__.py b/packages/python/plotly/plotly/validators/cone/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/cone/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/cone/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/cone/colorbar/_x.py b/packages/python/plotly/plotly/validators/cone/colorbar/_x.py index bcaaf33edfd..7bbe61e2a5d 100644 --- a/packages/python/plotly/plotly/validators/cone/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/cone/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="cone.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/cone/colorbar/_xref.py b/packages/python/plotly/plotly/validators/cone/colorbar/_xref.py new file mode 100644 index 00000000000..00ba2cb1990 --- /dev/null +++ b/packages/python/plotly/plotly/validators/cone/colorbar/_xref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="xref", parent_name="cone.colorbar", **kwargs): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/cone/colorbar/_y.py b/packages/python/plotly/plotly/validators/cone/colorbar/_y.py index bd383abcb10..4a5626878b1 100644 --- a/packages/python/plotly/plotly/validators/cone/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/cone/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="cone.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/cone/colorbar/_yref.py b/packages/python/plotly/plotly/validators/cone/colorbar/_yref.py new file mode 100644 index 00000000000..27ba8d53eec --- /dev/null +++ b/packages/python/plotly/plotly/validators/cone/colorbar/_yref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="yref", parent_name="cone.colorbar", **kwargs): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/contour/__init__.py b/packages/python/plotly/plotly/validators/contour/__init__.py index d26db3c4b53..cd7631885f9 100644 --- a/packages/python/plotly/plotly/validators/contour/__init__.py +++ b/packages/python/plotly/plotly/validators/contour/__init__.py @@ -51,6 +51,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -129,6 +130,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/contour/_colorbar.py b/packages/python/plotly/plotly/validators/contour/_colorbar.py index e50943195b7..09aa0511857 100644 --- a/packages/python/plotly/plotly/validators/contour/_colorbar.py +++ b/packages/python/plotly/plotly/validators/contour/_colorbar.py @@ -240,9 +240,15 @@ def __init__(self, plotly_name="colorbar", parent_name="contour", **kwargs): title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -252,10 +258,20 @@ def __init__(self, plotly_name="colorbar", parent_name="contour", **kwargs): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -265,6 +281,10 @@ def __init__(self, plotly_name="colorbar", parent_name="contour", **kwargs): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/contour/_legend.py b/packages/python/plotly/plotly/validators/contour/_legend.py new file mode 100644 index 00000000000..83c24849617 --- /dev/null +++ b/packages/python/plotly/plotly/validators/contour/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="contour", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/contour/colorbar/__init__.py b/packages/python/plotly/plotly/validators/contour/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/contour/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/contour/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/contour/colorbar/_x.py b/packages/python/plotly/plotly/validators/contour/colorbar/_x.py index 85db81d6457..0f90f06f599 100644 --- a/packages/python/plotly/plotly/validators/contour/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/contour/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="contour.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/contour/colorbar/_xref.py b/packages/python/plotly/plotly/validators/contour/colorbar/_xref.py new file mode 100644 index 00000000000..67439b019fd --- /dev/null +++ b/packages/python/plotly/plotly/validators/contour/colorbar/_xref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="xref", parent_name="contour.colorbar", **kwargs): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/contour/colorbar/_y.py b/packages/python/plotly/plotly/validators/contour/colorbar/_y.py index e8a962e50c4..5b46f99b06c 100644 --- a/packages/python/plotly/plotly/validators/contour/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/contour/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="contour.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/contour/colorbar/_yref.py b/packages/python/plotly/plotly/validators/contour/colorbar/_yref.py new file mode 100644 index 00000000000..138459baf69 --- /dev/null +++ b/packages/python/plotly/plotly/validators/contour/colorbar/_yref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="yref", parent_name="contour.colorbar", **kwargs): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/contourcarpet/__init__.py b/packages/python/plotly/plotly/validators/contourcarpet/__init__.py index 09c50961c6d..f03ea0e0155 100644 --- a/packages/python/plotly/plotly/validators/contourcarpet/__init__.py +++ b/packages/python/plotly/plotly/validators/contourcarpet/__init__.py @@ -30,6 +30,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -89,6 +90,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/contourcarpet/_colorbar.py b/packages/python/plotly/plotly/validators/contourcarpet/_colorbar.py index f110cccb4b5..2625b04be5b 100644 --- a/packages/python/plotly/plotly/validators/contourcarpet/_colorbar.py +++ b/packages/python/plotly/plotly/validators/contourcarpet/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="contourcarpet", **kwargs the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="contourcarpet", **kwargs xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="contourcarpet", **kwargs ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/contourcarpet/_legend.py b/packages/python/plotly/plotly/validators/contourcarpet/_legend.py new file mode 100644 index 00000000000..6389d68618b --- /dev/null +++ b/packages/python/plotly/plotly/validators/contourcarpet/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="contourcarpet", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/contourcarpet/colorbar/__init__.py b/packages/python/plotly/plotly/validators/contourcarpet/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/contourcarpet/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/contourcarpet/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_x.py b/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_x.py index 4f1980368be..11beaef6fc6 100644 --- a/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="contourcarpet.colorbar", **kwar plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_xref.py b/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_xref.py new file mode 100644 index 00000000000..ce2aa8e02c5 --- /dev/null +++ b/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="contourcarpet.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_y.py b/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_y.py index d18682972c6..d602f4e7cfa 100644 --- a/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="contourcarpet.colorbar", **kwar plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_yref.py b/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_yref.py new file mode 100644 index 00000000000..a7703fd8992 --- /dev/null +++ b/packages/python/plotly/plotly/validators/contourcarpet/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="contourcarpet.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/densitymapbox/__init__.py b/packages/python/plotly/plotly/validators/densitymapbox/__init__.py index 1334e4fa74e..20b2797e60d 100644 --- a/packages/python/plotly/plotly/validators/densitymapbox/__init__.py +++ b/packages/python/plotly/plotly/validators/densitymapbox/__init__.py @@ -30,6 +30,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._latsrc import LatsrcValidator from ._lat import LatValidator from ._idssrc import IdssrcValidator @@ -83,6 +84,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._latsrc.LatsrcValidator", "._lat.LatValidator", "._idssrc.IdssrcValidator", diff --git a/packages/python/plotly/plotly/validators/densitymapbox/_colorbar.py b/packages/python/plotly/plotly/validators/densitymapbox/_colorbar.py index bc03ed949e7..ce859003b03 100644 --- a/packages/python/plotly/plotly/validators/densitymapbox/_colorbar.py +++ b/packages/python/plotly/plotly/validators/densitymapbox/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="densitymapbox", **kwargs the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="densitymapbox", **kwargs xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="densitymapbox", **kwargs ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/densitymapbox/_legend.py b/packages/python/plotly/plotly/validators/densitymapbox/_legend.py new file mode 100644 index 00000000000..16bb454f7b6 --- /dev/null +++ b/packages/python/plotly/plotly/validators/densitymapbox/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="densitymapbox", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/densitymapbox/colorbar/__init__.py b/packages/python/plotly/plotly/validators/densitymapbox/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/densitymapbox/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/densitymapbox/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_x.py b/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_x.py index 1a23cbc294b..ed1cd46aa2d 100644 --- a/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="densitymapbox.colorbar", **kwar plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_xref.py b/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_xref.py new file mode 100644 index 00000000000..faceafa65b7 --- /dev/null +++ b/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="densitymapbox.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_y.py b/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_y.py index 296063a2229..9f9c139d06c 100644 --- a/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="densitymapbox.colorbar", **kwar plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_yref.py b/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_yref.py new file mode 100644 index 00000000000..c8072680f95 --- /dev/null +++ b/packages/python/plotly/plotly/validators/densitymapbox/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="densitymapbox.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnel/__init__.py b/packages/python/plotly/plotly/validators/funnel/__init__.py index bf212d88e7f..8a450e41fb0 100644 --- a/packages/python/plotly/plotly/validators/funnel/__init__.py +++ b/packages/python/plotly/plotly/validators/funnel/__init__.py @@ -47,6 +47,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._insidetextfont import InsidetextfontValidator from ._insidetextanchor import InsidetextanchorValidator from ._idssrc import IdssrcValidator @@ -118,6 +119,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._insidetextfont.InsidetextfontValidator", "._insidetextanchor.InsidetextanchorValidator", "._idssrc.IdssrcValidator", diff --git a/packages/python/plotly/plotly/validators/funnel/_legend.py b/packages/python/plotly/plotly/validators/funnel/_legend.py new file mode 100644 index 00000000000..44b53d5a1c2 --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnel/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="funnel", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnel/marker/_colorbar.py b/packages/python/plotly/plotly/validators/funnel/marker/_colorbar.py index 775c91cccc4..b0202ab39a7 100644 --- a/packages/python/plotly/plotly/validators/funnel/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/funnel/marker/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="funnel.marker", **kwargs the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="funnel.marker", **kwargs xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="funnel.marker", **kwargs ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/funnel/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/funnel/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/funnel/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/funnel/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_x.py index 575942720c3..9b672ee07de 100644 --- a/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="funnel.marker.colorbar", **kwar plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_xref.py new file mode 100644 index 00000000000..31e43cc3d14 --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="funnel.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_y.py index f7511cc64c7..979316ea1ac 100644 --- a/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="funnel.marker.colorbar", **kwar plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_yref.py new file mode 100644 index 00000000000..7d37f1fc9ac --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnel/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="funnel.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/__init__.py b/packages/python/plotly/plotly/validators/funnelarea/__init__.py index bf969f86364..4ddd3b6c1b6 100644 --- a/packages/python/plotly/plotly/validators/funnelarea/__init__.py +++ b/packages/python/plotly/plotly/validators/funnelarea/__init__.py @@ -28,6 +28,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._labelssrc import LabelssrcValidator from ._labels import LabelsValidator from ._label0 import Label0Validator @@ -80,6 +81,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._labelssrc.LabelssrcValidator", "._labels.LabelsValidator", "._label0.Label0Validator", diff --git a/packages/python/plotly/plotly/validators/funnelarea/_legend.py b/packages/python/plotly/plotly/validators/funnelarea/_legend.py new file mode 100644 index 00000000000..37fdd828750 --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="funnelarea", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/_marker.py b/packages/python/plotly/plotly/validators/funnelarea/_marker.py index 0ef0590ac39..2b16a1057f0 100644 --- a/packages/python/plotly/plotly/validators/funnelarea/_marker.py +++ b/packages/python/plotly/plotly/validators/funnelarea/_marker.py @@ -21,6 +21,8 @@ def __init__(self, plotly_name="marker", parent_name="funnelarea", **kwargs): :class:`plotly.graph_objects.funnelarea.marker. Line` instance or dict with compatible properties + pattern + Sets the pattern within the marker. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/__init__.py b/packages/python/plotly/plotly/validators/funnelarea/marker/__init__.py index dec7223b1c0..aeae3564f66 100644 --- a/packages/python/plotly/plotly/validators/funnelarea/marker/__init__.py +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/__init__.py @@ -2,6 +2,7 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._pattern import PatternValidator from ._line import LineValidator from ._colorssrc import ColorssrcValidator from ._colors import ColorsValidator @@ -12,6 +13,7 @@ __name__, [], [ + "._pattern.PatternValidator", "._line.LineValidator", "._colorssrc.ColorssrcValidator", "._colors.ColorsValidator", diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/_pattern.py b/packages/python/plotly/plotly/validators/funnelarea/marker/_pattern.py new file mode 100644 index 00000000000..d6a29333eb5 --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/_pattern.py @@ -0,0 +1,66 @@ +import _plotly_utils.basevalidators + + +class PatternValidator(_plotly_utils.basevalidators.CompoundValidator): + def __init__( + self, plotly_name="pattern", parent_name="funnelarea.marker", **kwargs + ): + super(PatternValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + data_class_str=kwargs.pop("data_class_str", "Pattern"), + data_docs=kwargs.pop( + "data_docs", + """ + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "overlay". Otherwise, defaults to a transparent + background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud + for `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud + for `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern + fill. Defaults to a 0.5 when `fillmode` is + "overlay". Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be + used as a default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, + no pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud + for `shape`. + size + Sets the size of unit squares of the pattern + fill in pixels, which corresponds to the + interval of repetition of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud + for `size`. + solidity + Sets the solidity of the pattern fill. Solidity + is roughly the fraction of the area filled by + the pattern. Solidity of 0 shows only the + background color without pattern and solidty of + 1 shows only the foreground color without + pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud + for `solidity`. +""", + ), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/__init__.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/__init__.py new file mode 100644 index 00000000000..e190f962c46 --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/__init__.py @@ -0,0 +1,37 @@ +import sys +from typing import TYPE_CHECKING + +if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._soliditysrc import SoliditysrcValidator + from ._solidity import SolidityValidator + from ._sizesrc import SizesrcValidator + from ._size import SizeValidator + from ._shapesrc import ShapesrcValidator + from ._shape import ShapeValidator + from ._fillmode import FillmodeValidator + from ._fgopacity import FgopacityValidator + from ._fgcolorsrc import FgcolorsrcValidator + from ._fgcolor import FgcolorValidator + from ._bgcolorsrc import BgcolorsrcValidator + from ._bgcolor import BgcolorValidator +else: + from _plotly_utils.importers import relative_import + + __all__, __getattr__, __dir__ = relative_import( + __name__, + [], + [ + "._soliditysrc.SoliditysrcValidator", + "._solidity.SolidityValidator", + "._sizesrc.SizesrcValidator", + "._size.SizeValidator", + "._shapesrc.ShapesrcValidator", + "._shape.ShapeValidator", + "._fillmode.FillmodeValidator", + "._fgopacity.FgopacityValidator", + "._fgcolorsrc.FgcolorsrcValidator", + "._fgcolor.FgcolorValidator", + "._bgcolorsrc.BgcolorsrcValidator", + "._bgcolor.BgcolorValidator", + ], + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_bgcolor.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_bgcolor.py new file mode 100644 index 00000000000..547b77925ea --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_bgcolor.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class BgcolorValidator(_plotly_utils.basevalidators.ColorValidator): + def __init__( + self, plotly_name="bgcolor", parent_name="funnelarea.marker.pattern", **kwargs + ): + super(BgcolorValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_bgcolorsrc.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_bgcolorsrc.py new file mode 100644 index 00000000000..3a96862ac81 --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_bgcolorsrc.py @@ -0,0 +1,16 @@ +import _plotly_utils.basevalidators + + +class BgcolorsrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, + plotly_name="bgcolorsrc", + parent_name="funnelarea.marker.pattern", + **kwargs, + ): + super(BgcolorsrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_fgcolor.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_fgcolor.py new file mode 100644 index 00000000000..536a51eb754 --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_fgcolor.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class FgcolorValidator(_plotly_utils.basevalidators.ColorValidator): + def __init__( + self, plotly_name="fgcolor", parent_name="funnelarea.marker.pattern", **kwargs + ): + super(FgcolorValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_fgcolorsrc.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_fgcolorsrc.py new file mode 100644 index 00000000000..1a4355f4a6b --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_fgcolorsrc.py @@ -0,0 +1,16 @@ +import _plotly_utils.basevalidators + + +class FgcolorsrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, + plotly_name="fgcolorsrc", + parent_name="funnelarea.marker.pattern", + **kwargs, + ): + super(FgcolorsrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_fgopacity.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_fgopacity.py new file mode 100644 index 00000000000..b868a898492 --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_fgopacity.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class FgopacityValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="fgopacity", parent_name="funnelarea.marker.pattern", **kwargs + ): + super(FgopacityValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "style"), + max=kwargs.pop("max", 1), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_fillmode.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_fillmode.py new file mode 100644 index 00000000000..0cdbb4bea07 --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_fillmode.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class FillmodeValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="fillmode", parent_name="funnelarea.marker.pattern", **kwargs + ): + super(FillmodeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "style"), + values=kwargs.pop("values", ["replace", "overlay"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_shape.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_shape.py new file mode 100644 index 00000000000..326b04b7b3b --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_shape.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class ShapeValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="shape", parent_name="funnelarea.marker.pattern", **kwargs + ): + super(ShapeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + values=kwargs.pop("values", ["", "/", "\\", "x", "-", "|", "+", "."]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_shapesrc.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_shapesrc.py new file mode 100644 index 00000000000..f23896ab79a --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_shapesrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class ShapesrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="shapesrc", parent_name="funnelarea.marker.pattern", **kwargs + ): + super(ShapesrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_size.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_size.py new file mode 100644 index 00000000000..def633c999d --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_size.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class SizeValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="size", parent_name="funnelarea.marker.pattern", **kwargs + ): + super(SizeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_sizesrc.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_sizesrc.py new file mode 100644 index 00000000000..4320434910e --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_sizesrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class SizesrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="sizesrc", parent_name="funnelarea.marker.pattern", **kwargs + ): + super(SizesrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_solidity.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_solidity.py new file mode 100644 index 00000000000..a7fff3113c9 --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_solidity.py @@ -0,0 +1,16 @@ +import _plotly_utils.basevalidators + + +class SolidityValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="solidity", parent_name="funnelarea.marker.pattern", **kwargs + ): + super(SolidityValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + max=kwargs.pop("max", 1), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_soliditysrc.py b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_soliditysrc.py new file mode 100644 index 00000000000..9be2f5b2530 --- /dev/null +++ b/packages/python/plotly/plotly/validators/funnelarea/marker/pattern/_soliditysrc.py @@ -0,0 +1,16 @@ +import _plotly_utils.basevalidators + + +class SoliditysrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, + plotly_name="soliditysrc", + parent_name="funnelarea.marker.pattern", + **kwargs, + ): + super(SoliditysrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/heatmap/__init__.py b/packages/python/plotly/plotly/validators/heatmap/__init__.py index a07738a0421..a6f257da32f 100644 --- a/packages/python/plotly/plotly/validators/heatmap/__init__.py +++ b/packages/python/plotly/plotly/validators/heatmap/__init__.py @@ -52,6 +52,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -128,6 +129,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/heatmap/_colorbar.py b/packages/python/plotly/plotly/validators/heatmap/_colorbar.py index 4817d9effd6..e1243ed2ae7 100644 --- a/packages/python/plotly/plotly/validators/heatmap/_colorbar.py +++ b/packages/python/plotly/plotly/validators/heatmap/_colorbar.py @@ -240,9 +240,15 @@ def __init__(self, plotly_name="colorbar", parent_name="heatmap", **kwargs): title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -252,10 +258,20 @@ def __init__(self, plotly_name="colorbar", parent_name="heatmap", **kwargs): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -265,6 +281,10 @@ def __init__(self, plotly_name="colorbar", parent_name="heatmap", **kwargs): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/heatmap/_legend.py b/packages/python/plotly/plotly/validators/heatmap/_legend.py new file mode 100644 index 00000000000..0c177c920e8 --- /dev/null +++ b/packages/python/plotly/plotly/validators/heatmap/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="heatmap", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/heatmap/colorbar/__init__.py b/packages/python/plotly/plotly/validators/heatmap/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/heatmap/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/heatmap/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/heatmap/colorbar/_x.py b/packages/python/plotly/plotly/validators/heatmap/colorbar/_x.py index bc39e75c339..f2c9b03706a 100644 --- a/packages/python/plotly/plotly/validators/heatmap/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/heatmap/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="heatmap.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/heatmap/colorbar/_xref.py b/packages/python/plotly/plotly/validators/heatmap/colorbar/_xref.py new file mode 100644 index 00000000000..64f9e6079b4 --- /dev/null +++ b/packages/python/plotly/plotly/validators/heatmap/colorbar/_xref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="xref", parent_name="heatmap.colorbar", **kwargs): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/heatmap/colorbar/_y.py b/packages/python/plotly/plotly/validators/heatmap/colorbar/_y.py index 2cfe0c5f69c..673d41178c7 100644 --- a/packages/python/plotly/plotly/validators/heatmap/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/heatmap/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="heatmap.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/heatmap/colorbar/_yref.py b/packages/python/plotly/plotly/validators/heatmap/colorbar/_yref.py new file mode 100644 index 00000000000..85b51bd7db9 --- /dev/null +++ b/packages/python/plotly/plotly/validators/heatmap/colorbar/_yref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="yref", parent_name="heatmap.colorbar", **kwargs): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/heatmapgl/__init__.py b/packages/python/plotly/plotly/validators/heatmapgl/__init__.py index 11789fc98de..b325dadbf02 100644 --- a/packages/python/plotly/plotly/validators/heatmapgl/__init__.py +++ b/packages/python/plotly/plotly/validators/heatmapgl/__init__.py @@ -35,6 +35,7 @@ from ._legendwidth import LegendwidthValidator from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hoverlabel import HoverlabelValidator @@ -88,6 +89,7 @@ "._legendwidth.LegendwidthValidator", "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hoverlabel.HoverlabelValidator", diff --git a/packages/python/plotly/plotly/validators/heatmapgl/_colorbar.py b/packages/python/plotly/plotly/validators/heatmapgl/_colorbar.py index 5b958fd4cb8..7e4e2fd5ea6 100644 --- a/packages/python/plotly/plotly/validators/heatmapgl/_colorbar.py +++ b/packages/python/plotly/plotly/validators/heatmapgl/_colorbar.py @@ -240,9 +240,15 @@ def __init__(self, plotly_name="colorbar", parent_name="heatmapgl", **kwargs): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -252,10 +258,20 @@ def __init__(self, plotly_name="colorbar", parent_name="heatmapgl", **kwargs): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -265,6 +281,10 @@ def __init__(self, plotly_name="colorbar", parent_name="heatmapgl", **kwargs): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/heatmapgl/_legend.py b/packages/python/plotly/plotly/validators/heatmapgl/_legend.py new file mode 100644 index 00000000000..c6d3574fb07 --- /dev/null +++ b/packages/python/plotly/plotly/validators/heatmapgl/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="heatmapgl", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/heatmapgl/colorbar/__init__.py b/packages/python/plotly/plotly/validators/heatmapgl/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/heatmapgl/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/heatmapgl/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_x.py b/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_x.py index 9b43cb865bf..f8e64ab708d 100644 --- a/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="heatmapgl.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_xref.py b/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_xref.py new file mode 100644 index 00000000000..dae73c2ff21 --- /dev/null +++ b/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_xref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="xref", parent_name="heatmapgl.colorbar", **kwargs): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_y.py b/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_y.py index 6b6911f4695..968c026004e 100644 --- a/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="heatmapgl.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_yref.py b/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_yref.py new file mode 100644 index 00000000000..c20796f8f41 --- /dev/null +++ b/packages/python/plotly/plotly/validators/heatmapgl/colorbar/_yref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="yref", parent_name="heatmapgl.colorbar", **kwargs): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/histogram/__init__.py b/packages/python/plotly/plotly/validators/histogram/__init__.py index d810916755a..b47a0d8b8ea 100644 --- a/packages/python/plotly/plotly/validators/histogram/__init__.py +++ b/packages/python/plotly/plotly/validators/histogram/__init__.py @@ -42,6 +42,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._insidetextfont import InsidetextfontValidator from ._insidetextanchor import InsidetextanchorValidator from ._idssrc import IdssrcValidator @@ -113,6 +114,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._insidetextfont.InsidetextfontValidator", "._insidetextanchor.InsidetextanchorValidator", "._idssrc.IdssrcValidator", diff --git a/packages/python/plotly/plotly/validators/histogram/_legend.py b/packages/python/plotly/plotly/validators/histogram/_legend.py new file mode 100644 index 00000000000..557cfa633d7 --- /dev/null +++ b/packages/python/plotly/plotly/validators/histogram/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="histogram", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/histogram/marker/_colorbar.py b/packages/python/plotly/plotly/validators/histogram/marker/_colorbar.py index 0ea14aadddc..1b6794d611f 100644 --- a/packages/python/plotly/plotly/validators/histogram/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/histogram/marker/_colorbar.py @@ -243,9 +243,15 @@ def __init__( the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/histogram/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/histogram/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/histogram/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/histogram/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_x.py index 9a1f54f0421..1ae083e8067 100644 --- a/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_xref.py new file mode 100644 index 00000000000..121a6d39bcd --- /dev/null +++ b/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="histogram.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_y.py index f2ce2967d94..86cc20a14de 100644 --- a/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_yref.py new file mode 100644 index 00000000000..326e18fcf76 --- /dev/null +++ b/packages/python/plotly/plotly/validators/histogram/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="histogram.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/histogram2d/__init__.py b/packages/python/plotly/plotly/validators/histogram2d/__init__.py index 6845e2695ad..8235426b271 100644 --- a/packages/python/plotly/plotly/validators/histogram2d/__init__.py +++ b/packages/python/plotly/plotly/validators/histogram2d/__init__.py @@ -46,6 +46,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertemplatesrc import HovertemplatesrcValidator @@ -115,6 +116,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertemplatesrc.HovertemplatesrcValidator", diff --git a/packages/python/plotly/plotly/validators/histogram2d/_colorbar.py b/packages/python/plotly/plotly/validators/histogram2d/_colorbar.py index 9275ee695e3..e7fb0417197 100644 --- a/packages/python/plotly/plotly/validators/histogram2d/_colorbar.py +++ b/packages/python/plotly/plotly/validators/histogram2d/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="histogram2d", **kwargs): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="histogram2d", **kwargs): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="histogram2d", **kwargs): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/histogram2d/_legend.py b/packages/python/plotly/plotly/validators/histogram2d/_legend.py new file mode 100644 index 00000000000..cfdc64740e2 --- /dev/null +++ b/packages/python/plotly/plotly/validators/histogram2d/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="histogram2d", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/histogram2d/colorbar/__init__.py b/packages/python/plotly/plotly/validators/histogram2d/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/histogram2d/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/histogram2d/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/histogram2d/colorbar/_x.py b/packages/python/plotly/plotly/validators/histogram2d/colorbar/_x.py index f1f0765f328..6997c4cc6ac 100644 --- a/packages/python/plotly/plotly/validators/histogram2d/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/histogram2d/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="histogram2d.colorbar", **kwargs plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/histogram2d/colorbar/_xref.py b/packages/python/plotly/plotly/validators/histogram2d/colorbar/_xref.py new file mode 100644 index 00000000000..f4b00e2659b --- /dev/null +++ b/packages/python/plotly/plotly/validators/histogram2d/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="histogram2d.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/histogram2d/colorbar/_y.py b/packages/python/plotly/plotly/validators/histogram2d/colorbar/_y.py index ff7e0cacbef..83a13511fcb 100644 --- a/packages/python/plotly/plotly/validators/histogram2d/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/histogram2d/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="histogram2d.colorbar", **kwargs plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/histogram2d/colorbar/_yref.py b/packages/python/plotly/plotly/validators/histogram2d/colorbar/_yref.py new file mode 100644 index 00000000000..aee34ed34ac --- /dev/null +++ b/packages/python/plotly/plotly/validators/histogram2d/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="histogram2d.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/histogram2dcontour/__init__.py b/packages/python/plotly/plotly/validators/histogram2dcontour/__init__.py index 62020f87862..7d1e7b3dee2 100644 --- a/packages/python/plotly/plotly/validators/histogram2dcontour/__init__.py +++ b/packages/python/plotly/plotly/validators/histogram2dcontour/__init__.py @@ -45,6 +45,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertemplatesrc import HovertemplatesrcValidator @@ -115,6 +116,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertemplatesrc.HovertemplatesrcValidator", diff --git a/packages/python/plotly/plotly/validators/histogram2dcontour/_colorbar.py b/packages/python/plotly/plotly/validators/histogram2dcontour/_colorbar.py index 4d5b7884c40..5b2c2e62d67 100644 --- a/packages/python/plotly/plotly/validators/histogram2dcontour/_colorbar.py +++ b/packages/python/plotly/plotly/validators/histogram2dcontour/_colorbar.py @@ -243,9 +243,15 @@ def __init__( the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/histogram2dcontour/_legend.py b/packages/python/plotly/plotly/validators/histogram2dcontour/_legend.py new file mode 100644 index 00000000000..1e1f9f1a925 --- /dev/null +++ b/packages/python/plotly/plotly/validators/histogram2dcontour/_legend.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__( + self, plotly_name="legend", parent_name="histogram2dcontour", **kwargs + ): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/__init__.py b/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_x.py b/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_x.py index d71019c09be..32739a520ff 100644 --- a/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_xref.py b/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_xref.py new file mode 100644 index 00000000000..30126ea31fb --- /dev/null +++ b/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="histogram2dcontour.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_y.py b/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_y.py index 168b4e882eb..928b76151e1 100644 --- a/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_yref.py b/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_yref.py new file mode 100644 index 00000000000..bbba41592f4 --- /dev/null +++ b/packages/python/plotly/plotly/validators/histogram2dcontour/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="histogram2dcontour.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/__init__.py b/packages/python/plotly/plotly/validators/icicle/__init__.py index 2ce60243f6a..79272436ae9 100644 --- a/packages/python/plotly/plotly/validators/icicle/__init__.py +++ b/packages/python/plotly/plotly/validators/icicle/__init__.py @@ -32,6 +32,7 @@ from ._legendwidth import LegendwidthValidator from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator + from ._legend import LegendValidator from ._leaf import LeafValidator from ._labelssrc import LabelssrcValidator from ._labels import LabelsValidator @@ -87,6 +88,7 @@ "._legendwidth.LegendwidthValidator", "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", + "._legend.LegendValidator", "._leaf.LeafValidator", "._labelssrc.LabelssrcValidator", "._labels.LabelsValidator", diff --git a/packages/python/plotly/plotly/validators/icicle/_legend.py b/packages/python/plotly/plotly/validators/icicle/_legend.py new file mode 100644 index 00000000000..b8c5a78fc55 --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="icicle", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/_marker.py b/packages/python/plotly/plotly/validators/icicle/_marker.py index f6f830caecf..90db168ee07 100644 --- a/packages/python/plotly/plotly/validators/icicle/_marker.py +++ b/packages/python/plotly/plotly/validators/icicle/_marker.py @@ -86,6 +86,8 @@ def __init__(self, plotly_name="marker", parent_name="icicle", **kwargs): line :class:`plotly.graph_objects.icicle.marker.Line ` instance or dict with compatible properties + pattern + Sets the pattern within the marker. reversescale Reverses the color mapping if true. Has an effect only if colors is set to a numerical diff --git a/packages/python/plotly/plotly/validators/icicle/marker/__init__.py b/packages/python/plotly/plotly/validators/icicle/marker/__init__.py index e09d06a0d4d..e04f18cc550 100644 --- a/packages/python/plotly/plotly/validators/icicle/marker/__init__.py +++ b/packages/python/plotly/plotly/validators/icicle/marker/__init__.py @@ -4,6 +4,7 @@ if sys.version_info < (3, 7) or TYPE_CHECKING: from ._showscale import ShowscaleValidator from ._reversescale import ReversescaleValidator + from ._pattern import PatternValidator from ._line import LineValidator from ._colorssrc import ColorssrcValidator from ._colorscale import ColorscaleValidator @@ -24,6 +25,7 @@ [ "._showscale.ShowscaleValidator", "._reversescale.ReversescaleValidator", + "._pattern.PatternValidator", "._line.LineValidator", "._colorssrc.ColorssrcValidator", "._colorscale.ColorscaleValidator", diff --git a/packages/python/plotly/plotly/validators/icicle/marker/_colorbar.py b/packages/python/plotly/plotly/validators/icicle/marker/_colorbar.py index 0ca07ba537d..5a1ad80daa9 100644 --- a/packages/python/plotly/plotly/validators/icicle/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/icicle/marker/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="icicle.marker", **kwargs the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="icicle.marker", **kwargs xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="icicle.marker", **kwargs ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/icicle/marker/_pattern.py b/packages/python/plotly/plotly/validators/icicle/marker/_pattern.py new file mode 100644 index 00000000000..7012c43eb38 --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/_pattern.py @@ -0,0 +1,64 @@ +import _plotly_utils.basevalidators + + +class PatternValidator(_plotly_utils.basevalidators.CompoundValidator): + def __init__(self, plotly_name="pattern", parent_name="icicle.marker", **kwargs): + super(PatternValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + data_class_str=kwargs.pop("data_class_str", "Pattern"), + data_docs=kwargs.pop( + "data_docs", + """ + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "overlay". Otherwise, defaults to a transparent + background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud + for `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud + for `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern + fill. Defaults to a 0.5 when `fillmode` is + "overlay". Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be + used as a default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, + no pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud + for `shape`. + size + Sets the size of unit squares of the pattern + fill in pixels, which corresponds to the + interval of repetition of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud + for `size`. + solidity + Sets the solidity of the pattern fill. Solidity + is roughly the fraction of the area filled by + the pattern. Solidity of 0 shows only the + background color without pattern and solidty of + 1 shows only the foreground color without + pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud + for `solidity`. +""", + ), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/icicle/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/icicle/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/icicle/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_x.py index d6aa517e380..b6785a4d3a9 100644 --- a/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="icicle.marker.colorbar", **kwar plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_xref.py new file mode 100644 index 00000000000..a38099956ac --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="icicle.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_y.py index 5be8606fa91..4c0182ae494 100644 --- a/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="icicle.marker.colorbar", **kwar plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_yref.py new file mode 100644 index 00000000000..386ff0d3807 --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="icicle.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/__init__.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/__init__.py new file mode 100644 index 00000000000..e190f962c46 --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/__init__.py @@ -0,0 +1,37 @@ +import sys +from typing import TYPE_CHECKING + +if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._soliditysrc import SoliditysrcValidator + from ._solidity import SolidityValidator + from ._sizesrc import SizesrcValidator + from ._size import SizeValidator + from ._shapesrc import ShapesrcValidator + from ._shape import ShapeValidator + from ._fillmode import FillmodeValidator + from ._fgopacity import FgopacityValidator + from ._fgcolorsrc import FgcolorsrcValidator + from ._fgcolor import FgcolorValidator + from ._bgcolorsrc import BgcolorsrcValidator + from ._bgcolor import BgcolorValidator +else: + from _plotly_utils.importers import relative_import + + __all__, __getattr__, __dir__ = relative_import( + __name__, + [], + [ + "._soliditysrc.SoliditysrcValidator", + "._solidity.SolidityValidator", + "._sizesrc.SizesrcValidator", + "._size.SizeValidator", + "._shapesrc.ShapesrcValidator", + "._shape.ShapeValidator", + "._fillmode.FillmodeValidator", + "._fgopacity.FgopacityValidator", + "._fgcolorsrc.FgcolorsrcValidator", + "._fgcolor.FgcolorValidator", + "._bgcolorsrc.BgcolorsrcValidator", + "._bgcolor.BgcolorValidator", + ], + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/_bgcolor.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_bgcolor.py new file mode 100644 index 00000000000..52bf7209a5a --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_bgcolor.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class BgcolorValidator(_plotly_utils.basevalidators.ColorValidator): + def __init__( + self, plotly_name="bgcolor", parent_name="icicle.marker.pattern", **kwargs + ): + super(BgcolorValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/_bgcolorsrc.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_bgcolorsrc.py new file mode 100644 index 00000000000..fc5488453b9 --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_bgcolorsrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class BgcolorsrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="bgcolorsrc", parent_name="icicle.marker.pattern", **kwargs + ): + super(BgcolorsrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/_fgcolor.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_fgcolor.py new file mode 100644 index 00000000000..afe0c597b6e --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_fgcolor.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class FgcolorValidator(_plotly_utils.basevalidators.ColorValidator): + def __init__( + self, plotly_name="fgcolor", parent_name="icicle.marker.pattern", **kwargs + ): + super(FgcolorValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/_fgcolorsrc.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_fgcolorsrc.py new file mode 100644 index 00000000000..8a8763ab18a --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_fgcolorsrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class FgcolorsrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="fgcolorsrc", parent_name="icicle.marker.pattern", **kwargs + ): + super(FgcolorsrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/_fgopacity.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_fgopacity.py new file mode 100644 index 00000000000..c1fe3284506 --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_fgopacity.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class FgopacityValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="fgopacity", parent_name="icicle.marker.pattern", **kwargs + ): + super(FgopacityValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "style"), + max=kwargs.pop("max", 1), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/_fillmode.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_fillmode.py new file mode 100644 index 00000000000..891ad6586ae --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_fillmode.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class FillmodeValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="fillmode", parent_name="icicle.marker.pattern", **kwargs + ): + super(FillmodeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "style"), + values=kwargs.pop("values", ["replace", "overlay"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/_shape.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_shape.py new file mode 100644 index 00000000000..0a37785fe01 --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_shape.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class ShapeValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="shape", parent_name="icicle.marker.pattern", **kwargs + ): + super(ShapeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + values=kwargs.pop("values", ["", "/", "\\", "x", "-", "|", "+", "."]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/_shapesrc.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_shapesrc.py new file mode 100644 index 00000000000..708ee5a3237 --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_shapesrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class ShapesrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="shapesrc", parent_name="icicle.marker.pattern", **kwargs + ): + super(ShapesrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/_size.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_size.py new file mode 100644 index 00000000000..97d803323d3 --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_size.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class SizeValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="size", parent_name="icicle.marker.pattern", **kwargs + ): + super(SizeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/_sizesrc.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_sizesrc.py new file mode 100644 index 00000000000..ef876769108 --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_sizesrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class SizesrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="sizesrc", parent_name="icicle.marker.pattern", **kwargs + ): + super(SizesrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/_solidity.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_solidity.py new file mode 100644 index 00000000000..4b7dc624543 --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_solidity.py @@ -0,0 +1,16 @@ +import _plotly_utils.basevalidators + + +class SolidityValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="solidity", parent_name="icicle.marker.pattern", **kwargs + ): + super(SolidityValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + max=kwargs.pop("max", 1), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/icicle/marker/pattern/_soliditysrc.py b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_soliditysrc.py new file mode 100644 index 00000000000..caf94f84f91 --- /dev/null +++ b/packages/python/plotly/plotly/validators/icicle/marker/pattern/_soliditysrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class SoliditysrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="soliditysrc", parent_name="icicle.marker.pattern", **kwargs + ): + super(SoliditysrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/image/__init__.py b/packages/python/plotly/plotly/validators/image/__init__.py index 18c9ded974c..81e6da84b0f 100644 --- a/packages/python/plotly/plotly/validators/image/__init__.py +++ b/packages/python/plotly/plotly/validators/image/__init__.py @@ -25,6 +25,7 @@ from ._legendwidth import LegendwidthValidator from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -69,6 +70,7 @@ "._legendwidth.LegendwidthValidator", "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/image/_legend.py b/packages/python/plotly/plotly/validators/image/_legend.py new file mode 100644 index 00000000000..d4903e46362 --- /dev/null +++ b/packages/python/plotly/plotly/validators/image/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="image", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/indicator/__init__.py b/packages/python/plotly/plotly/validators/indicator/__init__.py index 83652739794..90a3d4d166b 100644 --- a/packages/python/plotly/plotly/validators/indicator/__init__.py +++ b/packages/python/plotly/plotly/validators/indicator/__init__.py @@ -16,6 +16,7 @@ from ._legendwidth import LegendwidthValidator from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._gauge import GaugeValidator @@ -45,6 +46,7 @@ "._legendwidth.LegendwidthValidator", "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._gauge.GaugeValidator", diff --git a/packages/python/plotly/plotly/validators/indicator/_legend.py b/packages/python/plotly/plotly/validators/indicator/_legend.py new file mode 100644 index 00000000000..a55efc9276c --- /dev/null +++ b/packages/python/plotly/plotly/validators/indicator/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="indicator", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/isosurface/__init__.py b/packages/python/plotly/plotly/validators/isosurface/__init__.py index dc5594bb51c..e65b327ed4d 100644 --- a/packages/python/plotly/plotly/validators/isosurface/__init__.py +++ b/packages/python/plotly/plotly/validators/isosurface/__init__.py @@ -37,6 +37,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._isomin import IsominValidator from ._isomax import IsomaxValidator from ._idssrc import IdssrcValidator @@ -103,6 +104,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._isomin.IsominValidator", "._isomax.IsomaxValidator", "._idssrc.IdssrcValidator", diff --git a/packages/python/plotly/plotly/validators/isosurface/_colorbar.py b/packages/python/plotly/plotly/validators/isosurface/_colorbar.py index a456b00674c..99af4bab813 100644 --- a/packages/python/plotly/plotly/validators/isosurface/_colorbar.py +++ b/packages/python/plotly/plotly/validators/isosurface/_colorbar.py @@ -240,9 +240,15 @@ def __init__(self, plotly_name="colorbar", parent_name="isosurface", **kwargs): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -252,10 +258,20 @@ def __init__(self, plotly_name="colorbar", parent_name="isosurface", **kwargs): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -265,6 +281,10 @@ def __init__(self, plotly_name="colorbar", parent_name="isosurface", **kwargs): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/isosurface/_legend.py b/packages/python/plotly/plotly/validators/isosurface/_legend.py new file mode 100644 index 00000000000..69eaf600cc2 --- /dev/null +++ b/packages/python/plotly/plotly/validators/isosurface/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="isosurface", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/isosurface/colorbar/__init__.py b/packages/python/plotly/plotly/validators/isosurface/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/isosurface/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/isosurface/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/isosurface/colorbar/_x.py b/packages/python/plotly/plotly/validators/isosurface/colorbar/_x.py index 06ecdba05ed..8b179ab3ddb 100644 --- a/packages/python/plotly/plotly/validators/isosurface/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/isosurface/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="isosurface.colorbar", **kwargs) plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/isosurface/colorbar/_xref.py b/packages/python/plotly/plotly/validators/isosurface/colorbar/_xref.py new file mode 100644 index 00000000000..50a8039549e --- /dev/null +++ b/packages/python/plotly/plotly/validators/isosurface/colorbar/_xref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="xref", parent_name="isosurface.colorbar", **kwargs): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/isosurface/colorbar/_y.py b/packages/python/plotly/plotly/validators/isosurface/colorbar/_y.py index 0fc28545e1f..89917799b87 100644 --- a/packages/python/plotly/plotly/validators/isosurface/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/isosurface/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="isosurface.colorbar", **kwargs) plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/isosurface/colorbar/_yref.py b/packages/python/plotly/plotly/validators/isosurface/colorbar/_yref.py new file mode 100644 index 00000000000..c3ac45bceaf --- /dev/null +++ b/packages/python/plotly/plotly/validators/isosurface/colorbar/_yref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="yref", parent_name="isosurface.colorbar", **kwargs): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/layout/_legend.py b/packages/python/plotly/plotly/validators/layout/_legend.py index 5621473440c..aa6bfe226ec 100644 --- a/packages/python/plotly/plotly/validators/layout/_legend.py +++ b/packages/python/plotly/plotly/validators/layout/_legend.py @@ -86,11 +86,19 @@ def __init__(self, plotly_name="legend", parent_name="layout", **kwargs): valign Sets the vertical alignment of the symbols with respect to their associated text. + visible + Determines whether or not this legend is + visible. x - Sets the x position (in normalized coordinates) - of the legend. Defaults to 1.02 for vertical - legends and defaults to 0 for horizontal - legends. + Sets the x position with respect to `xref` (in + normalized coordinates) of the legend. When + `xref` is "paper", defaults to 1.02 for + vertical legends and defaults to 0 for + horizontal legends. When `xref` is "container", + defaults to 1 for vertical legends and defaults + to 0 for horizontal legends. Must be between 0 + and 1 if `xref` is "container". and between + "-2" and 3 if `xref` is "paper". xanchor Sets the legend's horizontal position anchor. This anchor binds the `x` position to the @@ -100,13 +108,21 @@ def __init__(self, plotly_name="legend", parent_name="layout", **kwargs): anchors legends to the left for `x` values less than or equal to 1/3 and anchors legends with respect to their center otherwise. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position (in normalized coordinates) - of the legend. Defaults to 1 for vertical + Sets the y position with respect to `yref` (in + normalized coordinates) of the legend. When + `yref` is "paper", defaults to 1 for vertical legends, defaults to "-0.1" for horizontal legends on graphs w/o range sliders and defaults to 1.1 for horizontal legends on graph - with one or multiple range sliders. + with one or multiple range sliders. When `yref` + is "container", defaults to 1. Must be between + 0 and 1 if `yref` is "container" and between + "-2" and 3 if `yref` is "paper". yanchor Sets the legend's vertical position anchor This anchor binds the `y` position to the "top", @@ -116,6 +132,10 @@ def __init__(self, plotly_name="legend", parent_name="layout", **kwargs): legends to at their top for `y` values greater than or equal to 2/3 and anchors legends with respect to their middle otherwise. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/layout/coloraxis/_colorbar.py b/packages/python/plotly/plotly/validators/layout/coloraxis/_colorbar.py index 96b3a30325c..ad629bc4797 100644 --- a/packages/python/plotly/plotly/validators/layout/coloraxis/_colorbar.py +++ b/packages/python/plotly/plotly/validators/layout/coloraxis/_colorbar.py @@ -243,9 +243,15 @@ def __init__( the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/__init__.py b/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_x.py b/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_x.py index 25769598637..01a5e482e3d 100644 --- a/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_xref.py b/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_xref.py new file mode 100644 index 00000000000..20a974d4045 --- /dev/null +++ b/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="layout.coloraxis.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_y.py b/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_y.py index aceb1ae9649..dac427570ea 100644 --- a/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_yref.py b/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_yref.py new file mode 100644 index 00000000000..4658e3192a8 --- /dev/null +++ b/packages/python/plotly/plotly/validators/layout/coloraxis/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="layout.coloraxis.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/layout/legend/__init__.py b/packages/python/plotly/plotly/validators/layout/legend/__init__.py index 2ac5a6e7acd..130aa6f9d31 100644 --- a/packages/python/plotly/plotly/validators/layout/legend/__init__.py +++ b/packages/python/plotly/plotly/validators/layout/legend/__init__.py @@ -2,10 +2,13 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xanchor import XanchorValidator from ._x import XValidator + from ._visible import VisibleValidator from ._valign import ValignValidator from ._uirevision import UirevisionValidator from ._traceorder import TraceorderValidator @@ -31,10 +34,13 @@ __name__, [], [ + "._yref.YrefValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xanchor.XanchorValidator", "._x.XValidator", + "._visible.VisibleValidator", "._valign.ValignValidator", "._uirevision.UirevisionValidator", "._traceorder.TraceorderValidator", diff --git a/packages/python/plotly/plotly/validators/layout/legend/_visible.py b/packages/python/plotly/plotly/validators/layout/legend/_visible.py new file mode 100644 index 00000000000..59485f0dff4 --- /dev/null +++ b/packages/python/plotly/plotly/validators/layout/legend/_visible.py @@ -0,0 +1,11 @@ +import _plotly_utils.basevalidators + + +class VisibleValidator(_plotly_utils.basevalidators.BooleanValidator): + def __init__(self, plotly_name="visible", parent_name="layout.legend", **kwargs): + super(VisibleValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "legend"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/layout/legend/_x.py b/packages/python/plotly/plotly/validators/layout/legend/_x.py index 6bd1a2512ba..42aa1996ff8 100644 --- a/packages/python/plotly/plotly/validators/layout/legend/_x.py +++ b/packages/python/plotly/plotly/validators/layout/legend/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="layout.legend", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "legend"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/layout/legend/_xref.py b/packages/python/plotly/plotly/validators/layout/legend/_xref.py new file mode 100644 index 00000000000..5536db69b1d --- /dev/null +++ b/packages/python/plotly/plotly/validators/layout/legend/_xref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="xref", parent_name="layout.legend", **kwargs): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "layoutstyle"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/layout/legend/_y.py b/packages/python/plotly/plotly/validators/layout/legend/_y.py index 235fd82b275..4dc8d92a6fc 100644 --- a/packages/python/plotly/plotly/validators/layout/legend/_y.py +++ b/packages/python/plotly/plotly/validators/layout/legend/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="layout.legend", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "legend"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/layout/legend/_yref.py b/packages/python/plotly/plotly/validators/layout/legend/_yref.py new file mode 100644 index 00000000000..2ab188db863 --- /dev/null +++ b/packages/python/plotly/plotly/validators/layout/legend/_yref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="yref", parent_name="layout.legend", **kwargs): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "layoutstyle"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/layout/newshape/_label.py b/packages/python/plotly/plotly/validators/layout/newshape/_label.py index 44e75a47124..c440151cb20 100644 --- a/packages/python/plotly/plotly/validators/layout/newshape/_label.py +++ b/packages/python/plotly/plotly/validators/layout/newshape/_label.py @@ -32,6 +32,33 @@ def __init__(self, plotly_name="label", parent_name="layout.newshape", **kwargs) are "start", "middle", and "end". Default: *middle center* for rectangles, circles, and paths; "middle" for lines. + texttemplate + Template string used for rendering the new + shape's label. Note that this will override + `text`. Variables are inserted using + %{variable}, for example "x0: %{x0}". Numbers + are formatted using d3-format's syntax + %{variable:d3-format}, for example "Price: + %{x0:$.2f}". See https://github.com/d3/d3- + format/tree/v1.4.5#d3-format for details on the + formatting syntax. Dates are formatted using + d3-time-format's syntax %{variable|d3-time- + format}, for example "Day: %{x0|%m %b %Y}". See + https://github.com/d3/d3-time- + format/tree/v2.2.3#locale_format for details on + the date formatting syntax. A single + multiplication or division operation may be + applied to numeric variables, and combined with + d3 number formatting, for example "Length in + cm: %{x0*2.54}", "%{slope*60:.1f} meters per + second." For log axes, variable values are + given in log units. For date axes, x/y + coordinate variables and center variables use + datetimes, while all other variable values use + values in ms. Finally, the template string has + access to variables `x0`, `x1`, `y0`, `y1`, + `slope`, `dx`, `dy`, `width`, `height`, + `length`, `xcenter` and `ycenter`. xanchor Sets the label's horizontal position anchor This anchor binds the specified `textposition` diff --git a/packages/python/plotly/plotly/validators/layout/newshape/label/__init__.py b/packages/python/plotly/plotly/validators/layout/newshape/label/__init__.py index f758ea4c9b6..c6a5f99963d 100644 --- a/packages/python/plotly/plotly/validators/layout/newshape/label/__init__.py +++ b/packages/python/plotly/plotly/validators/layout/newshape/label/__init__.py @@ -4,6 +4,7 @@ if sys.version_info < (3, 7) or TYPE_CHECKING: from ._yanchor import YanchorValidator from ._xanchor import XanchorValidator + from ._texttemplate import TexttemplateValidator from ._textposition import TextpositionValidator from ._textangle import TextangleValidator from ._text import TextValidator @@ -18,6 +19,7 @@ [ "._yanchor.YanchorValidator", "._xanchor.XanchorValidator", + "._texttemplate.TexttemplateValidator", "._textposition.TextpositionValidator", "._textangle.TextangleValidator", "._text.TextValidator", diff --git a/packages/python/plotly/plotly/validators/layout/newshape/label/_texttemplate.py b/packages/python/plotly/plotly/validators/layout/newshape/label/_texttemplate.py new file mode 100644 index 00000000000..3a99adbf53d --- /dev/null +++ b/packages/python/plotly/plotly/validators/layout/newshape/label/_texttemplate.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class TexttemplateValidator(_plotly_utils.basevalidators.StringValidator): + def __init__( + self, plotly_name="texttemplate", parent_name="layout.newshape.label", **kwargs + ): + super(TexttemplateValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/layout/shape/_label.py b/packages/python/plotly/plotly/validators/layout/shape/_label.py index 98bae5412f9..669ad67cd4c 100644 --- a/packages/python/plotly/plotly/validators/layout/shape/_label.py +++ b/packages/python/plotly/plotly/validators/layout/shape/_label.py @@ -32,6 +32,33 @@ def __init__(self, plotly_name="label", parent_name="layout.shape", **kwargs): are "start", "middle", and "end". Default: *middle center* for rectangles, circles, and paths; "middle" for lines. + texttemplate + Template string used for rendering the shape's + label. Note that this will override `text`. + Variables are inserted using %{variable}, for + example "x0: %{x0}". Numbers are formatted + using d3-format's syntax %{variable:d3-format}, + for example "Price: %{x0:$.2f}". See https://gi + thub.com/d3/d3-format/tree/v1.4.5#d3-format for + details on the formatting syntax. Dates are + formatted using d3-time-format's syntax + %{variable|d3-time-format}, for example "Day: + %{x0|%m %b %Y}". See + https://github.com/d3/d3-time- + format/tree/v2.2.3#locale_format for details on + the date formatting syntax. A single + multiplication or division operation may be + applied to numeric variables, and combined with + d3 number formatting, for example "Length in + cm: %{x0*2.54}", "%{slope*60:.1f} meters per + second." For log axes, variable values are + given in log units. For date axes, x/y + coordinate variables and center variables use + datetimes, while all other variable values use + values in ms. Finally, the template string has + access to variables `x0`, `x1`, `y0`, `y1`, + `slope`, `dx`, `dy`, `width`, `height`, + `length`, `xcenter` and `ycenter`. xanchor Sets the label's horizontal position anchor This anchor binds the specified `textposition` diff --git a/packages/python/plotly/plotly/validators/layout/shape/label/__init__.py b/packages/python/plotly/plotly/validators/layout/shape/label/__init__.py index f758ea4c9b6..c6a5f99963d 100644 --- a/packages/python/plotly/plotly/validators/layout/shape/label/__init__.py +++ b/packages/python/plotly/plotly/validators/layout/shape/label/__init__.py @@ -4,6 +4,7 @@ if sys.version_info < (3, 7) or TYPE_CHECKING: from ._yanchor import YanchorValidator from ._xanchor import XanchorValidator + from ._texttemplate import TexttemplateValidator from ._textposition import TextpositionValidator from ._textangle import TextangleValidator from ._text import TextValidator @@ -18,6 +19,7 @@ [ "._yanchor.YanchorValidator", "._xanchor.XanchorValidator", + "._texttemplate.TexttemplateValidator", "._textposition.TextpositionValidator", "._textangle.TextangleValidator", "._text.TextValidator", diff --git a/packages/python/plotly/plotly/validators/layout/shape/label/_texttemplate.py b/packages/python/plotly/plotly/validators/layout/shape/label/_texttemplate.py new file mode 100644 index 00000000000..76a0eb74394 --- /dev/null +++ b/packages/python/plotly/plotly/validators/layout/shape/label/_texttemplate.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class TexttemplateValidator(_plotly_utils.basevalidators.StringValidator): + def __init__( + self, plotly_name="texttemplate", parent_name="layout.shape.label", **kwargs + ): + super(TexttemplateValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "arraydraw"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/mesh3d/__init__.py b/packages/python/plotly/plotly/validators/mesh3d/__init__.py index ca934f220d6..fc0281e8973 100644 --- a/packages/python/plotly/plotly/validators/mesh3d/__init__.py +++ b/packages/python/plotly/plotly/validators/mesh3d/__init__.py @@ -36,6 +36,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._ksrc import KsrcValidator from ._k import KValidator from ._jsrc import JsrcValidator @@ -112,6 +113,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._ksrc.KsrcValidator", "._k.KValidator", "._jsrc.JsrcValidator", diff --git a/packages/python/plotly/plotly/validators/mesh3d/_colorbar.py b/packages/python/plotly/plotly/validators/mesh3d/_colorbar.py index a0eb493c672..a2d7072a9eb 100644 --- a/packages/python/plotly/plotly/validators/mesh3d/_colorbar.py +++ b/packages/python/plotly/plotly/validators/mesh3d/_colorbar.py @@ -240,9 +240,15 @@ def __init__(self, plotly_name="colorbar", parent_name="mesh3d", **kwargs): title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -252,10 +258,20 @@ def __init__(self, plotly_name="colorbar", parent_name="mesh3d", **kwargs): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -265,6 +281,10 @@ def __init__(self, plotly_name="colorbar", parent_name="mesh3d", **kwargs): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/mesh3d/_legend.py b/packages/python/plotly/plotly/validators/mesh3d/_legend.py new file mode 100644 index 00000000000..bbef4ace315 --- /dev/null +++ b/packages/python/plotly/plotly/validators/mesh3d/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="mesh3d", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/mesh3d/colorbar/__init__.py b/packages/python/plotly/plotly/validators/mesh3d/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/mesh3d/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/mesh3d/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/mesh3d/colorbar/_x.py b/packages/python/plotly/plotly/validators/mesh3d/colorbar/_x.py index b757693fe18..44bb8c33876 100644 --- a/packages/python/plotly/plotly/validators/mesh3d/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/mesh3d/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="mesh3d.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/mesh3d/colorbar/_xref.py b/packages/python/plotly/plotly/validators/mesh3d/colorbar/_xref.py new file mode 100644 index 00000000000..4bb7015f835 --- /dev/null +++ b/packages/python/plotly/plotly/validators/mesh3d/colorbar/_xref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="xref", parent_name="mesh3d.colorbar", **kwargs): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/mesh3d/colorbar/_y.py b/packages/python/plotly/plotly/validators/mesh3d/colorbar/_y.py index b9f33404c2e..8d1d774aa77 100644 --- a/packages/python/plotly/plotly/validators/mesh3d/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/mesh3d/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="mesh3d.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/mesh3d/colorbar/_yref.py b/packages/python/plotly/plotly/validators/mesh3d/colorbar/_yref.py new file mode 100644 index 00000000000..d43f94780e8 --- /dev/null +++ b/packages/python/plotly/plotly/validators/mesh3d/colorbar/_yref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="yref", parent_name="mesh3d.colorbar", **kwargs): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/ohlc/__init__.py b/packages/python/plotly/plotly/validators/ohlc/__init__.py index f231ddadbe8..6954fc8c8ff 100644 --- a/packages/python/plotly/plotly/validators/ohlc/__init__.py +++ b/packages/python/plotly/plotly/validators/ohlc/__init__.py @@ -34,6 +34,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._increasing import IncreasingValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator @@ -88,6 +89,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._increasing.IncreasingValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", diff --git a/packages/python/plotly/plotly/validators/ohlc/_legend.py b/packages/python/plotly/plotly/validators/ohlc/_legend.py new file mode 100644 index 00000000000..9a781df3fb3 --- /dev/null +++ b/packages/python/plotly/plotly/validators/ohlc/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="ohlc", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/parcats/_line.py b/packages/python/plotly/plotly/validators/parcats/_line.py index a398209fb19..49d3faaeb38 100644 --- a/packages/python/plotly/plotly/validators/parcats/_line.py +++ b/packages/python/plotly/plotly/validators/parcats/_line.py @@ -114,9 +114,11 @@ def __init__(self, plotly_name="line", parent_name="parcats", **kwargs): events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. - variables `count` and `probability`. Anything - contained in tag `` is displayed in the - secondary box, for example + This value here applies when hovering over + lines.Finally, the template string has access + to variables `count` and `probability`. + Anything contained in tag `` is + displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. diff --git a/packages/python/plotly/plotly/validators/parcats/line/_colorbar.py b/packages/python/plotly/plotly/validators/parcats/line/_colorbar.py index 57d52c972d3..d584a1cbd74 100644 --- a/packages/python/plotly/plotly/validators/parcats/line/_colorbar.py +++ b/packages/python/plotly/plotly/validators/parcats/line/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="parcats.line", **kwargs) the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="parcats.line", **kwargs) xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="parcats.line", **kwargs) ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/parcats/line/colorbar/__init__.py b/packages/python/plotly/plotly/validators/parcats/line/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/parcats/line/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/parcats/line/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/parcats/line/colorbar/_x.py b/packages/python/plotly/plotly/validators/parcats/line/colorbar/_x.py index 9c36934ca32..e49d6edf698 100644 --- a/packages/python/plotly/plotly/validators/parcats/line/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/parcats/line/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="parcats.line.colorbar", **kwarg plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/parcats/line/colorbar/_xref.py b/packages/python/plotly/plotly/validators/parcats/line/colorbar/_xref.py new file mode 100644 index 00000000000..efc88522fbe --- /dev/null +++ b/packages/python/plotly/plotly/validators/parcats/line/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="parcats.line.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/parcats/line/colorbar/_y.py b/packages/python/plotly/plotly/validators/parcats/line/colorbar/_y.py index 060a6fa6965..82b78b6a773 100644 --- a/packages/python/plotly/plotly/validators/parcats/line/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/parcats/line/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="parcats.line.colorbar", **kwarg plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/parcats/line/colorbar/_yref.py b/packages/python/plotly/plotly/validators/parcats/line/colorbar/_yref.py new file mode 100644 index 00000000000..1d9bc92b8ae --- /dev/null +++ b/packages/python/plotly/plotly/validators/parcats/line/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="parcats.line.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/parcoords/__init__.py b/packages/python/plotly/plotly/validators/parcoords/__init__.py index a843eb79e3a..9fb0212462b 100644 --- a/packages/python/plotly/plotly/validators/parcoords/__init__.py +++ b/packages/python/plotly/plotly/validators/parcoords/__init__.py @@ -16,6 +16,7 @@ from ._legendwidth import LegendwidthValidator from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator + from ._legend import LegendValidator from ._labelside import LabelsideValidator from ._labelfont import LabelfontValidator from ._labelangle import LabelangleValidator @@ -47,6 +48,7 @@ "._legendwidth.LegendwidthValidator", "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", + "._legend.LegendValidator", "._labelside.LabelsideValidator", "._labelfont.LabelfontValidator", "._labelangle.LabelangleValidator", diff --git a/packages/python/plotly/plotly/validators/parcoords/_legend.py b/packages/python/plotly/plotly/validators/parcoords/_legend.py new file mode 100644 index 00000000000..0ae4cf20c05 --- /dev/null +++ b/packages/python/plotly/plotly/validators/parcoords/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="parcoords", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/parcoords/line/_colorbar.py b/packages/python/plotly/plotly/validators/parcoords/line/_colorbar.py index 68b692d4ad0..040f0c0dfb6 100644 --- a/packages/python/plotly/plotly/validators/parcoords/line/_colorbar.py +++ b/packages/python/plotly/plotly/validators/parcoords/line/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="parcoords.line", **kwarg the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="parcoords.line", **kwarg xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="parcoords.line", **kwarg ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/parcoords/line/colorbar/__init__.py b/packages/python/plotly/plotly/validators/parcoords/line/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/parcoords/line/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/parcoords/line/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_x.py b/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_x.py index de8cc4e97e6..1b6a9e3b55a 100644 --- a/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_xref.py b/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_xref.py new file mode 100644 index 00000000000..900ae3a9d17 --- /dev/null +++ b/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="parcoords.line.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_y.py b/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_y.py index f17da9453cb..c08ef88a134 100644 --- a/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_yref.py b/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_yref.py new file mode 100644 index 00000000000..556d1ab0282 --- /dev/null +++ b/packages/python/plotly/plotly/validators/parcoords/line/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="parcoords.line.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/__init__.py b/packages/python/plotly/plotly/validators/pie/__init__.py index 12c3fcd3212..7ee355c1cb4 100644 --- a/packages/python/plotly/plotly/validators/pie/__init__.py +++ b/packages/python/plotly/plotly/validators/pie/__init__.py @@ -33,6 +33,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._labelssrc import LabelssrcValidator from ._labels import LabelsValidator from ._label0 import Label0Validator @@ -92,6 +93,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._labelssrc.LabelssrcValidator", "._labels.LabelsValidator", "._label0.Label0Validator", diff --git a/packages/python/plotly/plotly/validators/pie/_legend.py b/packages/python/plotly/plotly/validators/pie/_legend.py new file mode 100644 index 00000000000..ea35729c43c --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="pie", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/_marker.py b/packages/python/plotly/plotly/validators/pie/_marker.py index 413864c87bb..5134bed1d81 100644 --- a/packages/python/plotly/plotly/validators/pie/_marker.py +++ b/packages/python/plotly/plotly/validators/pie/_marker.py @@ -20,6 +20,8 @@ def __init__(self, plotly_name="marker", parent_name="pie", **kwargs): line :class:`plotly.graph_objects.pie.marker.Line` instance or dict with compatible properties + pattern + Sets the pattern within the marker. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/pie/marker/__init__.py b/packages/python/plotly/plotly/validators/pie/marker/__init__.py index dec7223b1c0..aeae3564f66 100644 --- a/packages/python/plotly/plotly/validators/pie/marker/__init__.py +++ b/packages/python/plotly/plotly/validators/pie/marker/__init__.py @@ -2,6 +2,7 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._pattern import PatternValidator from ._line import LineValidator from ._colorssrc import ColorssrcValidator from ._colors import ColorsValidator @@ -12,6 +13,7 @@ __name__, [], [ + "._pattern.PatternValidator", "._line.LineValidator", "._colorssrc.ColorssrcValidator", "._colors.ColorsValidator", diff --git a/packages/python/plotly/plotly/validators/pie/marker/_pattern.py b/packages/python/plotly/plotly/validators/pie/marker/_pattern.py new file mode 100644 index 00000000000..4e0277de408 --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/_pattern.py @@ -0,0 +1,64 @@ +import _plotly_utils.basevalidators + + +class PatternValidator(_plotly_utils.basevalidators.CompoundValidator): + def __init__(self, plotly_name="pattern", parent_name="pie.marker", **kwargs): + super(PatternValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + data_class_str=kwargs.pop("data_class_str", "Pattern"), + data_docs=kwargs.pop( + "data_docs", + """ + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "overlay". Otherwise, defaults to a transparent + background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud + for `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud + for `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern + fill. Defaults to a 0.5 when `fillmode` is + "overlay". Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be + used as a default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, + no pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud + for `shape`. + size + Sets the size of unit squares of the pattern + fill in pixels, which corresponds to the + interval of repetition of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud + for `size`. + solidity + Sets the solidity of the pattern fill. Solidity + is roughly the fraction of the area filled by + the pattern. Solidity of 0 shows only the + background color without pattern and solidty of + 1 shows only the foreground color without + pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud + for `solidity`. +""", + ), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/__init__.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/__init__.py new file mode 100644 index 00000000000..e190f962c46 --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/__init__.py @@ -0,0 +1,37 @@ +import sys +from typing import TYPE_CHECKING + +if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._soliditysrc import SoliditysrcValidator + from ._solidity import SolidityValidator + from ._sizesrc import SizesrcValidator + from ._size import SizeValidator + from ._shapesrc import ShapesrcValidator + from ._shape import ShapeValidator + from ._fillmode import FillmodeValidator + from ._fgopacity import FgopacityValidator + from ._fgcolorsrc import FgcolorsrcValidator + from ._fgcolor import FgcolorValidator + from ._bgcolorsrc import BgcolorsrcValidator + from ._bgcolor import BgcolorValidator +else: + from _plotly_utils.importers import relative_import + + __all__, __getattr__, __dir__ = relative_import( + __name__, + [], + [ + "._soliditysrc.SoliditysrcValidator", + "._solidity.SolidityValidator", + "._sizesrc.SizesrcValidator", + "._size.SizeValidator", + "._shapesrc.ShapesrcValidator", + "._shape.ShapeValidator", + "._fillmode.FillmodeValidator", + "._fgopacity.FgopacityValidator", + "._fgcolorsrc.FgcolorsrcValidator", + "._fgcolor.FgcolorValidator", + "._bgcolorsrc.BgcolorsrcValidator", + "._bgcolor.BgcolorValidator", + ], + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/_bgcolor.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/_bgcolor.py new file mode 100644 index 00000000000..4dedd28ff5b --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/_bgcolor.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class BgcolorValidator(_plotly_utils.basevalidators.ColorValidator): + def __init__( + self, plotly_name="bgcolor", parent_name="pie.marker.pattern", **kwargs + ): + super(BgcolorValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/_bgcolorsrc.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/_bgcolorsrc.py new file mode 100644 index 00000000000..874028535e1 --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/_bgcolorsrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class BgcolorsrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="bgcolorsrc", parent_name="pie.marker.pattern", **kwargs + ): + super(BgcolorsrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/_fgcolor.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/_fgcolor.py new file mode 100644 index 00000000000..f21b05dc0f2 --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/_fgcolor.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class FgcolorValidator(_plotly_utils.basevalidators.ColorValidator): + def __init__( + self, plotly_name="fgcolor", parent_name="pie.marker.pattern", **kwargs + ): + super(FgcolorValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/_fgcolorsrc.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/_fgcolorsrc.py new file mode 100644 index 00000000000..74c793c646b --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/_fgcolorsrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class FgcolorsrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="fgcolorsrc", parent_name="pie.marker.pattern", **kwargs + ): + super(FgcolorsrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/_fgopacity.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/_fgopacity.py new file mode 100644 index 00000000000..0c1532e7194 --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/_fgopacity.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class FgopacityValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="fgopacity", parent_name="pie.marker.pattern", **kwargs + ): + super(FgopacityValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "style"), + max=kwargs.pop("max", 1), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/_fillmode.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/_fillmode.py new file mode 100644 index 00000000000..bf9a1e9556b --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/_fillmode.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class FillmodeValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="fillmode", parent_name="pie.marker.pattern", **kwargs + ): + super(FillmodeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "style"), + values=kwargs.pop("values", ["replace", "overlay"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/_shape.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/_shape.py new file mode 100644 index 00000000000..f87457d72ee --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/_shape.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class ShapeValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="shape", parent_name="pie.marker.pattern", **kwargs): + super(ShapeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + values=kwargs.pop("values", ["", "/", "\\", "x", "-", "|", "+", "."]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/_shapesrc.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/_shapesrc.py new file mode 100644 index 00000000000..aaff7d1bdf7 --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/_shapesrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class ShapesrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="shapesrc", parent_name="pie.marker.pattern", **kwargs + ): + super(ShapesrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/_size.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/_size.py new file mode 100644 index 00000000000..60b1369ae78 --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/_size.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class SizeValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__(self, plotly_name="size", parent_name="pie.marker.pattern", **kwargs): + super(SizeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/_sizesrc.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/_sizesrc.py new file mode 100644 index 00000000000..d461056afc2 --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/_sizesrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class SizesrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="sizesrc", parent_name="pie.marker.pattern", **kwargs + ): + super(SizesrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/_solidity.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/_solidity.py new file mode 100644 index 00000000000..5b6b873891f --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/_solidity.py @@ -0,0 +1,16 @@ +import _plotly_utils.basevalidators + + +class SolidityValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="solidity", parent_name="pie.marker.pattern", **kwargs + ): + super(SolidityValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + max=kwargs.pop("max", 1), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pie/marker/pattern/_soliditysrc.py b/packages/python/plotly/plotly/validators/pie/marker/pattern/_soliditysrc.py new file mode 100644 index 00000000000..0a5d34df316 --- /dev/null +++ b/packages/python/plotly/plotly/validators/pie/marker/pattern/_soliditysrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class SoliditysrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="soliditysrc", parent_name="pie.marker.pattern", **kwargs + ): + super(SoliditysrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/pointcloud/__init__.py b/packages/python/plotly/plotly/validators/pointcloud/__init__.py index 2a82f5ba5dd..5c53c0a9d91 100644 --- a/packages/python/plotly/plotly/validators/pointcloud/__init__.py +++ b/packages/python/plotly/plotly/validators/pointcloud/__init__.py @@ -30,6 +30,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._indicessrc import IndicessrcValidator from ._indices import IndicesValidator from ._idssrc import IdssrcValidator @@ -74,6 +75,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._indicessrc.IndicessrcValidator", "._indices.IndicesValidator", "._idssrc.IdssrcValidator", diff --git a/packages/python/plotly/plotly/validators/pointcloud/_legend.py b/packages/python/plotly/plotly/validators/pointcloud/_legend.py new file mode 100644 index 00000000000..2fa5b393dc3 --- /dev/null +++ b/packages/python/plotly/plotly/validators/pointcloud/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="pointcloud", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sankey/__init__.py b/packages/python/plotly/plotly/validators/sankey/__init__.py index 3dcf16c714f..0dd341cd80b 100644 --- a/packages/python/plotly/plotly/validators/sankey/__init__.py +++ b/packages/python/plotly/plotly/validators/sankey/__init__.py @@ -19,6 +19,7 @@ from ._legendwidth import LegendwidthValidator from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hoverlabel import HoverlabelValidator @@ -51,6 +52,7 @@ "._legendwidth.LegendwidthValidator", "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hoverlabel.HoverlabelValidator", diff --git a/packages/python/plotly/plotly/validators/sankey/_legend.py b/packages/python/plotly/plotly/validators/sankey/_legend.py new file mode 100644 index 00000000000..e67b2337e62 --- /dev/null +++ b/packages/python/plotly/plotly/validators/sankey/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="sankey", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sankey/_link.py b/packages/python/plotly/plotly/validators/sankey/_link.py index 91d43bd6cae..c394406d8eb 100644 --- a/packages/python/plotly/plotly/validators/sankey/_link.py +++ b/packages/python/plotly/plotly/validators/sankey/_link.py @@ -74,7 +74,9 @@ def __init__(self, plotly_name="link", parent_name="sankey", **kwargs): events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. - variables `value` and `label`. Anything + Variables `source` and `target` are node + objects.Finally, the template string has access + to variables `value` and `label`. Anything contained in tag `` is displayed in the secondary box, for example "{fullData.name}". To hide the diff --git a/packages/python/plotly/plotly/validators/sankey/_node.py b/packages/python/plotly/plotly/validators/sankey/_node.py index f80694a8405..0de951eaebe 100644 --- a/packages/python/plotly/plotly/validators/sankey/_node.py +++ b/packages/python/plotly/plotly/validators/sankey/_node.py @@ -68,9 +68,11 @@ def __init__(self, plotly_name="node", parent_name="sankey", **kwargs): events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are `arrayOk: true`) are available. - variables `value` and `label`. Anything - contained in tag `` is displayed in the - secondary box, for example + Variables `sourceLinks` and `targetLinks` are + arrays of link objects.Finally, the template + string has access to variables `value` and + `label`. Anything contained in tag `` is + displayed in the secondary box, for example "{fullData.name}". To hide the secondary box completely, use an empty tag ``. diff --git a/packages/python/plotly/plotly/validators/scatter/__init__.py b/packages/python/plotly/plotly/validators/scatter/__init__.py index 496ef0a256c..7bfc78b2efc 100644 --- a/packages/python/plotly/plotly/validators/scatter/__init__.py +++ b/packages/python/plotly/plotly/validators/scatter/__init__.py @@ -50,6 +50,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -128,6 +129,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/scatter/_legend.py b/packages/python/plotly/plotly/validators/scatter/_legend.py new file mode 100644 index 00000000000..d7dc121acfd --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatter/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="scatter", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatter/marker/_colorbar.py b/packages/python/plotly/plotly/validators/scatter/marker/_colorbar.py index 0f145455eea..97f1ba95237 100644 --- a/packages/python/plotly/plotly/validators/scatter/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/scatter/marker/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="scatter.marker", **kwarg the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="scatter.marker", **kwarg xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="scatter.marker", **kwarg ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/scatter/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/scatter/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/scatter/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/scatter/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_x.py index 24448a543b2..374e27f0ef7 100644 --- a/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_xref.py new file mode 100644 index 00000000000..ffceac8c474 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="scatter.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_y.py index 1fa426b3484..5a19c4bb25d 100644 --- a/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_yref.py new file mode 100644 index 00000000000..63fe32254f7 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatter/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="scatter.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatter3d/__init__.py b/packages/python/plotly/plotly/validators/scatter3d/__init__.py index 6e50c6e66d5..c9a28b14c34 100644 --- a/packages/python/plotly/plotly/validators/scatter3d/__init__.py +++ b/packages/python/plotly/plotly/validators/scatter3d/__init__.py @@ -41,6 +41,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -102,6 +103,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/scatter3d/_legend.py b/packages/python/plotly/plotly/validators/scatter3d/_legend.py new file mode 100644 index 00000000000..03291a667e4 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatter3d/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="scatter3d", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatter3d/line/_colorbar.py b/packages/python/plotly/plotly/validators/scatter3d/line/_colorbar.py index 2a00091a351..ca5b779ca80 100644 --- a/packages/python/plotly/plotly/validators/scatter3d/line/_colorbar.py +++ b/packages/python/plotly/plotly/validators/scatter3d/line/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="scatter3d.line", **kwarg the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="scatter3d.line", **kwarg xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="scatter3d.line", **kwarg ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/__init__.py b/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_x.py b/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_x.py index cb8feeb9a3f..17cf104506a 100644 --- a/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_xref.py b/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_xref.py new file mode 100644 index 00000000000..648c83b885e --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="scatter3d.line.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_y.py b/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_y.py index e07bf6089af..de686f4892e 100644 --- a/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_yref.py b/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_yref.py new file mode 100644 index 00000000000..ff66e141849 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatter3d/line/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="scatter3d.line.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatter3d/marker/_colorbar.py b/packages/python/plotly/plotly/validators/scatter3d/marker/_colorbar.py index ceeafa12c5a..af227955827 100644 --- a/packages/python/plotly/plotly/validators/scatter3d/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/scatter3d/marker/_colorbar.py @@ -243,9 +243,15 @@ def __init__( the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_x.py index 72a72b0006f..bd73c2d2147 100644 --- a/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_xref.py new file mode 100644 index 00000000000..81b315ae117 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="scatter3d.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_y.py index 22da22bdca2..cfaef8d5c03 100644 --- a/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_yref.py new file mode 100644 index 00000000000..7e6de12fbde --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatter3d/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="scatter3d.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattercarpet/__init__.py b/packages/python/plotly/plotly/validators/scattercarpet/__init__.py index 0d99016c16d..839aeb441db 100644 --- a/packages/python/plotly/plotly/validators/scattercarpet/__init__.py +++ b/packages/python/plotly/plotly/validators/scattercarpet/__init__.py @@ -30,6 +30,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -85,6 +86,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/scattercarpet/_legend.py b/packages/python/plotly/plotly/validators/scattercarpet/_legend.py new file mode 100644 index 00000000000..c018a7ae897 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattercarpet/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="scattercarpet", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattercarpet/marker/_colorbar.py b/packages/python/plotly/plotly/validators/scattercarpet/marker/_colorbar.py index 6876f8c530a..e6aeb5f20fe 100644 --- a/packages/python/plotly/plotly/validators/scattercarpet/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/scattercarpet/marker/_colorbar.py @@ -243,9 +243,15 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_x.py index dc286e1c79d..16366085ee0 100644 --- a/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_xref.py new file mode 100644 index 00000000000..eab939038ad --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="scattercarpet.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_y.py index 678292a88f1..e90c0527043 100644 --- a/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_yref.py new file mode 100644 index 00000000000..2fdab2766d0 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattercarpet/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="scattercarpet.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattergeo/__init__.py b/packages/python/plotly/plotly/validators/scattergeo/__init__.py index 8307128de1a..fd1f0586a2e 100644 --- a/packages/python/plotly/plotly/validators/scattergeo/__init__.py +++ b/packages/python/plotly/plotly/validators/scattergeo/__init__.py @@ -33,6 +33,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._latsrc import LatsrcValidator from ._lat import LatValidator from ._idssrc import IdssrcValidator @@ -90,6 +91,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._latsrc.LatsrcValidator", "._lat.LatValidator", "._idssrc.IdssrcValidator", diff --git a/packages/python/plotly/plotly/validators/scattergeo/_legend.py b/packages/python/plotly/plotly/validators/scattergeo/_legend.py new file mode 100644 index 00000000000..797123073a3 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattergeo/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="scattergeo", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattergeo/marker/_colorbar.py b/packages/python/plotly/plotly/validators/scattergeo/marker/_colorbar.py index 645928fd9a9..f0d58bf2d3d 100644 --- a/packages/python/plotly/plotly/validators/scattergeo/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/scattergeo/marker/_colorbar.py @@ -243,9 +243,15 @@ def __init__( the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_x.py index 6d8746d8fa5..1455eb2ba1b 100644 --- a/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_xref.py new file mode 100644 index 00000000000..4083c0a82d6 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="scattergeo.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_y.py index d9a3ea774f5..58d8c255ea2 100644 --- a/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_yref.py new file mode 100644 index 00000000000..9700dda52b7 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattergeo/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="scattergeo.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattergl/__init__.py b/packages/python/plotly/plotly/validators/scattergl/__init__.py index 39489f0b531..04ea09cc2c9 100644 --- a/packages/python/plotly/plotly/validators/scattergl/__init__.py +++ b/packages/python/plotly/plotly/validators/scattergl/__init__.py @@ -46,6 +46,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -115,6 +116,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/scattergl/_legend.py b/packages/python/plotly/plotly/validators/scattergl/_legend.py new file mode 100644 index 00000000000..00470557b81 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattergl/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="scattergl", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattergl/marker/_colorbar.py b/packages/python/plotly/plotly/validators/scattergl/marker/_colorbar.py index 63b69f35f10..5c95be75c9d 100644 --- a/packages/python/plotly/plotly/validators/scattergl/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/scattergl/marker/_colorbar.py @@ -243,9 +243,15 @@ def __init__( the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_x.py index 489c0ce3ee4..7ee79fbadec 100644 --- a/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_xref.py new file mode 100644 index 00000000000..e89ef2a3722 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="scattergl.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_y.py index f899125a0f7..90c433894bf 100644 --- a/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_yref.py new file mode 100644 index 00000000000..3daa43429e5 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattergl/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="scattergl.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattermapbox/__init__.py b/packages/python/plotly/plotly/validators/scattermapbox/__init__.py index 92a53841bcd..5abe04051d4 100644 --- a/packages/python/plotly/plotly/validators/scattermapbox/__init__.py +++ b/packages/python/plotly/plotly/validators/scattermapbox/__init__.py @@ -30,6 +30,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._latsrc import LatsrcValidator from ._lat import LatValidator from ._idssrc import IdssrcValidator @@ -83,6 +84,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._latsrc.LatsrcValidator", "._lat.LatValidator", "._idssrc.IdssrcValidator", diff --git a/packages/python/plotly/plotly/validators/scattermapbox/_legend.py b/packages/python/plotly/plotly/validators/scattermapbox/_legend.py new file mode 100644 index 00000000000..61eda251e71 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattermapbox/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="scattermapbox", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattermapbox/marker/_colorbar.py b/packages/python/plotly/plotly/validators/scattermapbox/marker/_colorbar.py index 14610cf2295..d9e3eff5b67 100644 --- a/packages/python/plotly/plotly/validators/scattermapbox/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/scattermapbox/marker/_colorbar.py @@ -243,9 +243,15 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_x.py index 08b8e77d8be..b69db6f0dd1 100644 --- a/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_xref.py new file mode 100644 index 00000000000..5b6cb514da1 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="scattermapbox.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_y.py index 142dc0aa1a1..c7278bb947d 100644 --- a/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_yref.py new file mode 100644 index 00000000000..57066bc9803 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattermapbox/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="scattermapbox.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatterpolar/__init__.py b/packages/python/plotly/plotly/validators/scatterpolar/__init__.py index 0bf1a836a2b..ce934b10c88 100644 --- a/packages/python/plotly/plotly/validators/scatterpolar/__init__.py +++ b/packages/python/plotly/plotly/validators/scatterpolar/__init__.py @@ -36,6 +36,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -95,6 +96,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/scatterpolar/_legend.py b/packages/python/plotly/plotly/validators/scatterpolar/_legend.py new file mode 100644 index 00000000000..7df05b2bf4b --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatterpolar/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="scatterpolar", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatterpolar/marker/_colorbar.py b/packages/python/plotly/plotly/validators/scatterpolar/marker/_colorbar.py index c36227c1c7c..60caec5d41d 100644 --- a/packages/python/plotly/plotly/validators/scatterpolar/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/scatterpolar/marker/_colorbar.py @@ -243,9 +243,15 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_x.py index e83d040ad61..0213bbf93eb 100644 --- a/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_xref.py new file mode 100644 index 00000000000..d8b81c0e7e3 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="scatterpolar.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_y.py index 8d10161edf5..c05b8f61971 100644 --- a/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_yref.py new file mode 100644 index 00000000000..65c22045562 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatterpolar/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="scatterpolar.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatterpolargl/__init__.py b/packages/python/plotly/plotly/validators/scatterpolargl/__init__.py index 3b815b178d6..69a11c033b3 100644 --- a/packages/python/plotly/plotly/validators/scatterpolargl/__init__.py +++ b/packages/python/plotly/plotly/validators/scatterpolargl/__init__.py @@ -36,6 +36,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -93,6 +94,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/scatterpolargl/_legend.py b/packages/python/plotly/plotly/validators/scatterpolargl/_legend.py new file mode 100644 index 00000000000..3ea6bb917f5 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatterpolargl/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="scatterpolargl", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatterpolargl/marker/_colorbar.py b/packages/python/plotly/plotly/validators/scatterpolargl/marker/_colorbar.py index 61139a66734..ba4fd68c07c 100644 --- a/packages/python/plotly/plotly/validators/scatterpolargl/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/scatterpolargl/marker/_colorbar.py @@ -243,9 +243,15 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_x.py index 8fe5e87d3a4..500bb0f522a 100644 --- a/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_xref.py new file mode 100644 index 00000000000..6493a71d06a --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="scatterpolargl.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_y.py index cad971f1592..1b750e94680 100644 --- a/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_yref.py new file mode 100644 index 00000000000..70992277f91 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatterpolargl/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="scatterpolargl.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattersmith/__init__.py b/packages/python/plotly/plotly/validators/scattersmith/__init__.py index c57482e899a..4dc55c20dd6 100644 --- a/packages/python/plotly/plotly/validators/scattersmith/__init__.py +++ b/packages/python/plotly/plotly/validators/scattersmith/__init__.py @@ -31,6 +31,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._imagsrc import ImagsrcValidator from ._imag import ImagValidator from ._idssrc import IdssrcValidator @@ -85,6 +86,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._imagsrc.ImagsrcValidator", "._imag.ImagValidator", "._idssrc.IdssrcValidator", diff --git a/packages/python/plotly/plotly/validators/scattersmith/_legend.py b/packages/python/plotly/plotly/validators/scattersmith/_legend.py new file mode 100644 index 00000000000..23e1c4365ad --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattersmith/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="scattersmith", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattersmith/marker/_colorbar.py b/packages/python/plotly/plotly/validators/scattersmith/marker/_colorbar.py index 5405483a6a3..7a93db33b7c 100644 --- a/packages/python/plotly/plotly/validators/scattersmith/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/scattersmith/marker/_colorbar.py @@ -243,9 +243,15 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_x.py index 20572b81cc3..af3835c7f1b 100644 --- a/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_xref.py new file mode 100644 index 00000000000..fb624aad7a7 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="scattersmith.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_y.py index 15224366cf1..95aaca685b9 100644 --- a/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_yref.py new file mode 100644 index 00000000000..03414cf3d10 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scattersmith/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="scattersmith.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatterternary/__init__.py b/packages/python/plotly/plotly/validators/scatterternary/__init__.py index 626f343bba7..e99da6064dc 100644 --- a/packages/python/plotly/plotly/validators/scatterternary/__init__.py +++ b/packages/python/plotly/plotly/validators/scatterternary/__init__.py @@ -30,6 +30,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -87,6 +88,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/scatterternary/_legend.py b/packages/python/plotly/plotly/validators/scatterternary/_legend.py new file mode 100644 index 00000000000..bcd44c345ca --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatterternary/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="scatterternary", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatterternary/marker/_colorbar.py b/packages/python/plotly/plotly/validators/scatterternary/marker/_colorbar.py index ef0532c25da..e40249c2de6 100644 --- a/packages/python/plotly/plotly/validators/scatterternary/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/scatterternary/marker/_colorbar.py @@ -243,9 +243,15 @@ def __init__( Note that the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -255,10 +261,20 @@ def __init__( xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -268,6 +284,10 @@ def __init__( ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_x.py index f06c0c4a263..fdb41ac3157 100644 --- a/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_xref.py new file mode 100644 index 00000000000..54adb56244a --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="scatterternary.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_y.py index 7eb06eebba8..c8316d54f43 100644 --- a/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_yref.py new file mode 100644 index 00000000000..924845e30e0 --- /dev/null +++ b/packages/python/plotly/plotly/validators/scatterternary/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="scatterternary.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/splom/__init__.py b/packages/python/plotly/plotly/validators/splom/__init__.py index f082eb748b7..c928a1b08d9 100644 --- a/packages/python/plotly/plotly/validators/splom/__init__.py +++ b/packages/python/plotly/plotly/validators/splom/__init__.py @@ -27,6 +27,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -73,6 +74,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/splom/_legend.py b/packages/python/plotly/plotly/validators/splom/_legend.py new file mode 100644 index 00000000000..fc4b71d1972 --- /dev/null +++ b/packages/python/plotly/plotly/validators/splom/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="splom", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/splom/marker/_colorbar.py b/packages/python/plotly/plotly/validators/splom/marker/_colorbar.py index 8c1d16b1f97..75a6039214f 100644 --- a/packages/python/plotly/plotly/validators/splom/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/splom/marker/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="splom.marker", **kwargs) the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="splom.marker", **kwargs) xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="splom.marker", **kwargs) ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/splom/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/splom/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/splom/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/splom/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/splom/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/splom/marker/colorbar/_x.py index f8a65e1c3b1..86781bea2d2 100644 --- a/packages/python/plotly/plotly/validators/splom/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/splom/marker/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="splom.marker.colorbar", **kwarg plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/splom/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/splom/marker/colorbar/_xref.py new file mode 100644 index 00000000000..85a16f86e63 --- /dev/null +++ b/packages/python/plotly/plotly/validators/splom/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="splom.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/splom/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/splom/marker/colorbar/_y.py index b87de35ea83..1ce993457d6 100644 --- a/packages/python/plotly/plotly/validators/splom/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/splom/marker/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="splom.marker.colorbar", **kwarg plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/splom/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/splom/marker/colorbar/_yref.py new file mode 100644 index 00000000000..9570dca0624 --- /dev/null +++ b/packages/python/plotly/plotly/validators/splom/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="splom.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/streamtube/__init__.py b/packages/python/plotly/plotly/validators/streamtube/__init__.py index b163edf7cf5..7d348e38db1 100644 --- a/packages/python/plotly/plotly/validators/streamtube/__init__.py +++ b/packages/python/plotly/plotly/validators/streamtube/__init__.py @@ -42,6 +42,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertext import HovertextValidator @@ -107,6 +108,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertext.HovertextValidator", diff --git a/packages/python/plotly/plotly/validators/streamtube/_colorbar.py b/packages/python/plotly/plotly/validators/streamtube/_colorbar.py index b6efdf7ddc6..09302f1af74 100644 --- a/packages/python/plotly/plotly/validators/streamtube/_colorbar.py +++ b/packages/python/plotly/plotly/validators/streamtube/_colorbar.py @@ -240,9 +240,15 @@ def __init__(self, plotly_name="colorbar", parent_name="streamtube", **kwargs): the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -252,10 +258,20 @@ def __init__(self, plotly_name="colorbar", parent_name="streamtube", **kwargs): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -265,6 +281,10 @@ def __init__(self, plotly_name="colorbar", parent_name="streamtube", **kwargs): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/streamtube/_legend.py b/packages/python/plotly/plotly/validators/streamtube/_legend.py new file mode 100644 index 00000000000..b1f936142d8 --- /dev/null +++ b/packages/python/plotly/plotly/validators/streamtube/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="streamtube", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/streamtube/colorbar/__init__.py b/packages/python/plotly/plotly/validators/streamtube/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/streamtube/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/streamtube/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/streamtube/colorbar/_x.py b/packages/python/plotly/plotly/validators/streamtube/colorbar/_x.py index 84d19db11b8..e4542c802cc 100644 --- a/packages/python/plotly/plotly/validators/streamtube/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/streamtube/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="streamtube.colorbar", **kwargs) plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/streamtube/colorbar/_xref.py b/packages/python/plotly/plotly/validators/streamtube/colorbar/_xref.py new file mode 100644 index 00000000000..cf7c2019693 --- /dev/null +++ b/packages/python/plotly/plotly/validators/streamtube/colorbar/_xref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="xref", parent_name="streamtube.colorbar", **kwargs): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/streamtube/colorbar/_y.py b/packages/python/plotly/plotly/validators/streamtube/colorbar/_y.py index 86d5b4539d8..199ce881f56 100644 --- a/packages/python/plotly/plotly/validators/streamtube/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/streamtube/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="streamtube.colorbar", **kwargs) plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/streamtube/colorbar/_yref.py b/packages/python/plotly/plotly/validators/streamtube/colorbar/_yref.py new file mode 100644 index 00000000000..f5f79c39445 --- /dev/null +++ b/packages/python/plotly/plotly/validators/streamtube/colorbar/_yref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="yref", parent_name="streamtube.colorbar", **kwargs): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/__init__.py b/packages/python/plotly/plotly/validators/sunburst/__init__.py index 7d3d24152a5..d9043d98c91 100644 --- a/packages/python/plotly/plotly/validators/sunburst/__init__.py +++ b/packages/python/plotly/plotly/validators/sunburst/__init__.py @@ -30,6 +30,7 @@ from ._legendwidth import LegendwidthValidator from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator + from ._legend import LegendValidator from ._leaf import LeafValidator from ._labelssrc import LabelssrcValidator from ._labels import LabelsValidator @@ -84,6 +85,7 @@ "._legendwidth.LegendwidthValidator", "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", + "._legend.LegendValidator", "._leaf.LeafValidator", "._labelssrc.LabelssrcValidator", "._labels.LabelsValidator", diff --git a/packages/python/plotly/plotly/validators/sunburst/_legend.py b/packages/python/plotly/plotly/validators/sunburst/_legend.py new file mode 100644 index 00000000000..69b12723c93 --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="sunburst", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/_marker.py b/packages/python/plotly/plotly/validators/sunburst/_marker.py index e345f279428..66df8a90656 100644 --- a/packages/python/plotly/plotly/validators/sunburst/_marker.py +++ b/packages/python/plotly/plotly/validators/sunburst/_marker.py @@ -86,6 +86,8 @@ def __init__(self, plotly_name="marker", parent_name="sunburst", **kwargs): line :class:`plotly.graph_objects.sunburst.marker.Li ne` instance or dict with compatible properties + pattern + Sets the pattern within the marker. reversescale Reverses the color mapping if true. Has an effect only if colors is set to a numerical diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/__init__.py b/packages/python/plotly/plotly/validators/sunburst/marker/__init__.py index e09d06a0d4d..e04f18cc550 100644 --- a/packages/python/plotly/plotly/validators/sunburst/marker/__init__.py +++ b/packages/python/plotly/plotly/validators/sunburst/marker/__init__.py @@ -4,6 +4,7 @@ if sys.version_info < (3, 7) or TYPE_CHECKING: from ._showscale import ShowscaleValidator from ._reversescale import ReversescaleValidator + from ._pattern import PatternValidator from ._line import LineValidator from ._colorssrc import ColorssrcValidator from ._colorscale import ColorscaleValidator @@ -24,6 +25,7 @@ [ "._showscale.ShowscaleValidator", "._reversescale.ReversescaleValidator", + "._pattern.PatternValidator", "._line.LineValidator", "._colorssrc.ColorssrcValidator", "._colorscale.ColorscaleValidator", diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/_colorbar.py b/packages/python/plotly/plotly/validators/sunburst/marker/_colorbar.py index d15b7ac5700..5a8bfdf8bbe 100644 --- a/packages/python/plotly/plotly/validators/sunburst/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/sunburst/marker/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="sunburst.marker", **kwar the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="sunburst.marker", **kwar xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="sunburst.marker", **kwar ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/_pattern.py b/packages/python/plotly/plotly/validators/sunburst/marker/_pattern.py new file mode 100644 index 00000000000..ed80bc7a1dc --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/_pattern.py @@ -0,0 +1,64 @@ +import _plotly_utils.basevalidators + + +class PatternValidator(_plotly_utils.basevalidators.CompoundValidator): + def __init__(self, plotly_name="pattern", parent_name="sunburst.marker", **kwargs): + super(PatternValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + data_class_str=kwargs.pop("data_class_str", "Pattern"), + data_docs=kwargs.pop( + "data_docs", + """ + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "overlay". Otherwise, defaults to a transparent + background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud + for `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud + for `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern + fill. Defaults to a 0.5 when `fillmode` is + "overlay". Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be + used as a default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, + no pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud + for `shape`. + size + Sets the size of unit squares of the pattern + fill in pixels, which corresponds to the + interval of repetition of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud + for `size`. + solidity + Sets the solidity of the pattern fill. Solidity + is roughly the fraction of the area filled by + the pattern. Solidity of 0 shows only the + background color without pattern and solidty of + 1 shows only the foreground color without + pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud + for `solidity`. +""", + ), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_x.py index 81230930b5e..e0af9666a74 100644 --- a/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_xref.py new file mode 100644 index 00000000000..36c8a292493 --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="sunburst.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_y.py index 104c661d0cd..1ef98a59b08 100644 --- a/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_yref.py new file mode 100644 index 00000000000..bb79a74d64e --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="sunburst.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/__init__.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/__init__.py new file mode 100644 index 00000000000..e190f962c46 --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/__init__.py @@ -0,0 +1,37 @@ +import sys +from typing import TYPE_CHECKING + +if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._soliditysrc import SoliditysrcValidator + from ._solidity import SolidityValidator + from ._sizesrc import SizesrcValidator + from ._size import SizeValidator + from ._shapesrc import ShapesrcValidator + from ._shape import ShapeValidator + from ._fillmode import FillmodeValidator + from ._fgopacity import FgopacityValidator + from ._fgcolorsrc import FgcolorsrcValidator + from ._fgcolor import FgcolorValidator + from ._bgcolorsrc import BgcolorsrcValidator + from ._bgcolor import BgcolorValidator +else: + from _plotly_utils.importers import relative_import + + __all__, __getattr__, __dir__ = relative_import( + __name__, + [], + [ + "._soliditysrc.SoliditysrcValidator", + "._solidity.SolidityValidator", + "._sizesrc.SizesrcValidator", + "._size.SizeValidator", + "._shapesrc.ShapesrcValidator", + "._shape.ShapeValidator", + "._fillmode.FillmodeValidator", + "._fgopacity.FgopacityValidator", + "._fgcolorsrc.FgcolorsrcValidator", + "._fgcolor.FgcolorValidator", + "._bgcolorsrc.BgcolorsrcValidator", + "._bgcolor.BgcolorValidator", + ], + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_bgcolor.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_bgcolor.py new file mode 100644 index 00000000000..f8d91e0bc56 --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_bgcolor.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class BgcolorValidator(_plotly_utils.basevalidators.ColorValidator): + def __init__( + self, plotly_name="bgcolor", parent_name="sunburst.marker.pattern", **kwargs + ): + super(BgcolorValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_bgcolorsrc.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_bgcolorsrc.py new file mode 100644 index 00000000000..6ac12524638 --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_bgcolorsrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class BgcolorsrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="bgcolorsrc", parent_name="sunburst.marker.pattern", **kwargs + ): + super(BgcolorsrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_fgcolor.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_fgcolor.py new file mode 100644 index 00000000000..061047f4114 --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_fgcolor.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class FgcolorValidator(_plotly_utils.basevalidators.ColorValidator): + def __init__( + self, plotly_name="fgcolor", parent_name="sunburst.marker.pattern", **kwargs + ): + super(FgcolorValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_fgcolorsrc.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_fgcolorsrc.py new file mode 100644 index 00000000000..86c3ff70aef --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_fgcolorsrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class FgcolorsrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="fgcolorsrc", parent_name="sunburst.marker.pattern", **kwargs + ): + super(FgcolorsrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_fgopacity.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_fgopacity.py new file mode 100644 index 00000000000..8d49e47301c --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_fgopacity.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class FgopacityValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="fgopacity", parent_name="sunburst.marker.pattern", **kwargs + ): + super(FgopacityValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "style"), + max=kwargs.pop("max", 1), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_fillmode.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_fillmode.py new file mode 100644 index 00000000000..f2fb4c7fba6 --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_fillmode.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class FillmodeValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="fillmode", parent_name="sunburst.marker.pattern", **kwargs + ): + super(FillmodeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "style"), + values=kwargs.pop("values", ["replace", "overlay"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_shape.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_shape.py new file mode 100644 index 00000000000..5780376c003 --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_shape.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class ShapeValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="shape", parent_name="sunburst.marker.pattern", **kwargs + ): + super(ShapeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + values=kwargs.pop("values", ["", "/", "\\", "x", "-", "|", "+", "."]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_shapesrc.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_shapesrc.py new file mode 100644 index 00000000000..eea033eee0a --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_shapesrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class ShapesrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="shapesrc", parent_name="sunburst.marker.pattern", **kwargs + ): + super(ShapesrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_size.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_size.py new file mode 100644 index 00000000000..1b9a310941c --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_size.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class SizeValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="size", parent_name="sunburst.marker.pattern", **kwargs + ): + super(SizeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_sizesrc.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_sizesrc.py new file mode 100644 index 00000000000..1ef91bc2cd6 --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_sizesrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class SizesrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="sizesrc", parent_name="sunburst.marker.pattern", **kwargs + ): + super(SizesrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_solidity.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_solidity.py new file mode 100644 index 00000000000..12819d300bd --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_solidity.py @@ -0,0 +1,16 @@ +import _plotly_utils.basevalidators + + +class SolidityValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="solidity", parent_name="sunburst.marker.pattern", **kwargs + ): + super(SolidityValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + max=kwargs.pop("max", 1), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_soliditysrc.py b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_soliditysrc.py new file mode 100644 index 00000000000..6d9fb3e830f --- /dev/null +++ b/packages/python/plotly/plotly/validators/sunburst/marker/pattern/_soliditysrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class SoliditysrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="soliditysrc", parent_name="sunburst.marker.pattern", **kwargs + ): + super(SoliditysrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/surface/__init__.py b/packages/python/plotly/plotly/validators/surface/__init__.py index 2fff9c45aed..40b7043b3fe 100644 --- a/packages/python/plotly/plotly/validators/surface/__init__.py +++ b/packages/python/plotly/plotly/validators/surface/__init__.py @@ -37,6 +37,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hovertextsrc import HovertextsrcValidator @@ -101,6 +102,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hovertextsrc.HovertextsrcValidator", diff --git a/packages/python/plotly/plotly/validators/surface/_colorbar.py b/packages/python/plotly/plotly/validators/surface/_colorbar.py index 761e107e92a..a5e574c83f6 100644 --- a/packages/python/plotly/plotly/validators/surface/_colorbar.py +++ b/packages/python/plotly/plotly/validators/surface/_colorbar.py @@ -240,9 +240,15 @@ def __init__(self, plotly_name="colorbar", parent_name="surface", **kwargs): title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -252,10 +258,20 @@ def __init__(self, plotly_name="colorbar", parent_name="surface", **kwargs): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -265,6 +281,10 @@ def __init__(self, plotly_name="colorbar", parent_name="surface", **kwargs): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/surface/_legend.py b/packages/python/plotly/plotly/validators/surface/_legend.py new file mode 100644 index 00000000000..a115a224a1d --- /dev/null +++ b/packages/python/plotly/plotly/validators/surface/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="surface", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/surface/colorbar/__init__.py b/packages/python/plotly/plotly/validators/surface/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/surface/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/surface/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/surface/colorbar/_x.py b/packages/python/plotly/plotly/validators/surface/colorbar/_x.py index 3a9aa87d7b4..f2433ba51f1 100644 --- a/packages/python/plotly/plotly/validators/surface/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/surface/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="surface.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/surface/colorbar/_xref.py b/packages/python/plotly/plotly/validators/surface/colorbar/_xref.py new file mode 100644 index 00000000000..37310ea18fc --- /dev/null +++ b/packages/python/plotly/plotly/validators/surface/colorbar/_xref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="xref", parent_name="surface.colorbar", **kwargs): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/surface/colorbar/_y.py b/packages/python/plotly/plotly/validators/surface/colorbar/_y.py index efd016386a0..a61e202d466 100644 --- a/packages/python/plotly/plotly/validators/surface/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/surface/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="surface.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/surface/colorbar/_yref.py b/packages/python/plotly/plotly/validators/surface/colorbar/_yref.py new file mode 100644 index 00000000000..7813d9608ae --- /dev/null +++ b/packages/python/plotly/plotly/validators/surface/colorbar/_yref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="yref", parent_name="surface.colorbar", **kwargs): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/table/__init__.py b/packages/python/plotly/plotly/validators/table/__init__.py index 0ed92804890..78898057047 100644 --- a/packages/python/plotly/plotly/validators/table/__init__.py +++ b/packages/python/plotly/plotly/validators/table/__init__.py @@ -12,6 +12,7 @@ from ._legendwidth import LegendwidthValidator from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator + from ._legend import LegendValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator from ._hoverlabel import HoverlabelValidator @@ -43,6 +44,7 @@ "._legendwidth.LegendwidthValidator", "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", + "._legend.LegendValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", "._hoverlabel.HoverlabelValidator", diff --git a/packages/python/plotly/plotly/validators/table/_legend.py b/packages/python/plotly/plotly/validators/table/_legend.py new file mode 100644 index 00000000000..4f520f8c5f9 --- /dev/null +++ b/packages/python/plotly/plotly/validators/table/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="table", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/__init__.py b/packages/python/plotly/plotly/validators/treemap/__init__.py index b30f4751a8d..2a7bd82d123 100644 --- a/packages/python/plotly/plotly/validators/treemap/__init__.py +++ b/packages/python/plotly/plotly/validators/treemap/__init__.py @@ -32,6 +32,7 @@ from ._legendwidth import LegendwidthValidator from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator + from ._legend import LegendValidator from ._labelssrc import LabelssrcValidator from ._labels import LabelsValidator from ._insidetextfont import InsidetextfontValidator @@ -86,6 +87,7 @@ "._legendwidth.LegendwidthValidator", "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", + "._legend.LegendValidator", "._labelssrc.LabelssrcValidator", "._labels.LabelsValidator", "._insidetextfont.InsidetextfontValidator", diff --git a/packages/python/plotly/plotly/validators/treemap/_legend.py b/packages/python/plotly/plotly/validators/treemap/_legend.py new file mode 100644 index 00000000000..e66137b64fb --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="treemap", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/_marker.py b/packages/python/plotly/plotly/validators/treemap/_marker.py index 04d4ee42e80..68c366d7ac5 100644 --- a/packages/python/plotly/plotly/validators/treemap/_marker.py +++ b/packages/python/plotly/plotly/validators/treemap/_marker.py @@ -102,6 +102,8 @@ def __init__(self, plotly_name="marker", parent_name="treemap", **kwargs): pad :class:`plotly.graph_objects.treemap.marker.Pad ` instance or dict with compatible properties + pattern + Sets the pattern within the marker. reversescale Reverses the color mapping if true. Has an effect only if colors is set to a numerical diff --git a/packages/python/plotly/plotly/validators/treemap/marker/__init__.py b/packages/python/plotly/plotly/validators/treemap/marker/__init__.py index 071fd37a675..a0aa062ffcf 100644 --- a/packages/python/plotly/plotly/validators/treemap/marker/__init__.py +++ b/packages/python/plotly/plotly/validators/treemap/marker/__init__.py @@ -4,6 +4,7 @@ if sys.version_info < (3, 7) or TYPE_CHECKING: from ._showscale import ShowscaleValidator from ._reversescale import ReversescaleValidator + from ._pattern import PatternValidator from ._pad import PadValidator from ._line import LineValidator from ._depthfade import DepthfadeValidator @@ -27,6 +28,7 @@ [ "._showscale.ShowscaleValidator", "._reversescale.ReversescaleValidator", + "._pattern.PatternValidator", "._pad.PadValidator", "._line.LineValidator", "._depthfade.DepthfadeValidator", diff --git a/packages/python/plotly/plotly/validators/treemap/marker/_colorbar.py b/packages/python/plotly/plotly/validators/treemap/marker/_colorbar.py index 490810566f1..81e3fe756e6 100644 --- a/packages/python/plotly/plotly/validators/treemap/marker/_colorbar.py +++ b/packages/python/plotly/plotly/validators/treemap/marker/_colorbar.py @@ -241,9 +241,15 @@ def __init__(self, plotly_name="colorbar", parent_name="treemap.marker", **kwarg the title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -253,10 +259,20 @@ def __init__(self, plotly_name="colorbar", parent_name="treemap.marker", **kwarg xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -266,6 +282,10 @@ def __init__(self, plotly_name="colorbar", parent_name="treemap.marker", **kwarg ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/treemap/marker/_pattern.py b/packages/python/plotly/plotly/validators/treemap/marker/_pattern.py new file mode 100644 index 00000000000..1aa5b1960dd --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/_pattern.py @@ -0,0 +1,64 @@ +import _plotly_utils.basevalidators + + +class PatternValidator(_plotly_utils.basevalidators.CompoundValidator): + def __init__(self, plotly_name="pattern", parent_name="treemap.marker", **kwargs): + super(PatternValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + data_class_str=kwargs.pop("data_class_str", "Pattern"), + data_docs=kwargs.pop( + "data_docs", + """ + bgcolor + When there is no colorscale sets the color of + background pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "overlay". Otherwise, defaults to a transparent + background. + bgcolorsrc + Sets the source reference on Chart Studio Cloud + for `bgcolor`. + fgcolor + When there is no colorscale sets the color of + foreground pattern fill. Defaults to a + `marker.color` background when `fillmode` is + "replace". Otherwise, defaults to dark grey or + white to increase contrast with the `bgcolor`. + fgcolorsrc + Sets the source reference on Chart Studio Cloud + for `fgcolor`. + fgopacity + Sets the opacity of the foreground pattern + fill. Defaults to a 0.5 when `fillmode` is + "overlay". Otherwise, defaults to 1. + fillmode + Determines whether `marker.color` should be + used as a default to `bgcolor` or a `fgcolor`. + shape + Sets the shape of the pattern fill. By default, + no pattern is used for filling the area. + shapesrc + Sets the source reference on Chart Studio Cloud + for `shape`. + size + Sets the size of unit squares of the pattern + fill in pixels, which corresponds to the + interval of repetition of the pattern. + sizesrc + Sets the source reference on Chart Studio Cloud + for `size`. + solidity + Sets the solidity of the pattern fill. Solidity + is roughly the fraction of the area filled by + the pattern. Solidity of 0 shows only the + background color without pattern and solidty of + 1 shows only the foreground color without + pattern. + soliditysrc + Sets the source reference on Chart Studio Cloud + for `solidity`. +""", + ), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/colorbar/__init__.py b/packages/python/plotly/plotly/validators/treemap/marker/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/treemap/marker/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/treemap/marker/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_x.py b/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_x.py index 46fb68f8192..88f3c88bfcf 100644 --- a/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_x.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_xref.py b/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_xref.py new file mode 100644 index 00000000000..9e910d89eee --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_xref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="xref", parent_name="treemap.marker.colorbar", **kwargs + ): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_y.py b/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_y.py index 57df08b487d..cf2f28bc1ef 100644 --- a/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_y.py @@ -9,7 +9,5 @@ def __init__( plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "colorbars"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_yref.py b/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_yref.py new file mode 100644 index 00000000000..023d4c991ae --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/colorbar/_yref.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="yref", parent_name="treemap.marker.colorbar", **kwargs + ): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "colorbars"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/__init__.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/__init__.py new file mode 100644 index 00000000000..e190f962c46 --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/__init__.py @@ -0,0 +1,37 @@ +import sys +from typing import TYPE_CHECKING + +if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._soliditysrc import SoliditysrcValidator + from ._solidity import SolidityValidator + from ._sizesrc import SizesrcValidator + from ._size import SizeValidator + from ._shapesrc import ShapesrcValidator + from ._shape import ShapeValidator + from ._fillmode import FillmodeValidator + from ._fgopacity import FgopacityValidator + from ._fgcolorsrc import FgcolorsrcValidator + from ._fgcolor import FgcolorValidator + from ._bgcolorsrc import BgcolorsrcValidator + from ._bgcolor import BgcolorValidator +else: + from _plotly_utils.importers import relative_import + + __all__, __getattr__, __dir__ = relative_import( + __name__, + [], + [ + "._soliditysrc.SoliditysrcValidator", + "._solidity.SolidityValidator", + "._sizesrc.SizesrcValidator", + "._size.SizeValidator", + "._shapesrc.ShapesrcValidator", + "._shape.ShapeValidator", + "._fillmode.FillmodeValidator", + "._fgopacity.FgopacityValidator", + "._fgcolorsrc.FgcolorsrcValidator", + "._fgcolor.FgcolorValidator", + "._bgcolorsrc.BgcolorsrcValidator", + "._bgcolor.BgcolorValidator", + ], + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/_bgcolor.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_bgcolor.py new file mode 100644 index 00000000000..81cbdb77db2 --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_bgcolor.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class BgcolorValidator(_plotly_utils.basevalidators.ColorValidator): + def __init__( + self, plotly_name="bgcolor", parent_name="treemap.marker.pattern", **kwargs + ): + super(BgcolorValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/_bgcolorsrc.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_bgcolorsrc.py new file mode 100644 index 00000000000..64f183a5974 --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_bgcolorsrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class BgcolorsrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="bgcolorsrc", parent_name="treemap.marker.pattern", **kwargs + ): + super(BgcolorsrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/_fgcolor.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_fgcolor.py new file mode 100644 index 00000000000..9c597f79cb6 --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_fgcolor.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class FgcolorValidator(_plotly_utils.basevalidators.ColorValidator): + def __init__( + self, plotly_name="fgcolor", parent_name="treemap.marker.pattern", **kwargs + ): + super(FgcolorValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/_fgcolorsrc.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_fgcolorsrc.py new file mode 100644 index 00000000000..f7e04ae874b --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_fgcolorsrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class FgcolorsrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="fgcolorsrc", parent_name="treemap.marker.pattern", **kwargs + ): + super(FgcolorsrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/_fgopacity.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_fgopacity.py new file mode 100644 index 00000000000..c94b1694e74 --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_fgopacity.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class FgopacityValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="fgopacity", parent_name="treemap.marker.pattern", **kwargs + ): + super(FgopacityValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "style"), + max=kwargs.pop("max", 1), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/_fillmode.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_fillmode.py new file mode 100644 index 00000000000..3889070d5ef --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_fillmode.py @@ -0,0 +1,14 @@ +import _plotly_utils.basevalidators + + +class FillmodeValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="fillmode", parent_name="treemap.marker.pattern", **kwargs + ): + super(FillmodeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "style"), + values=kwargs.pop("values", ["replace", "overlay"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/_shape.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_shape.py new file mode 100644 index 00000000000..286fb88eba5 --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_shape.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class ShapeValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__( + self, plotly_name="shape", parent_name="treemap.marker.pattern", **kwargs + ): + super(ShapeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + values=kwargs.pop("values", ["", "/", "\\", "x", "-", "|", "+", "."]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/_shapesrc.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_shapesrc.py new file mode 100644 index 00000000000..7ee5b6a9bc1 --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_shapesrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class ShapesrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="shapesrc", parent_name="treemap.marker.pattern", **kwargs + ): + super(ShapesrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/_size.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_size.py new file mode 100644 index 00000000000..a41afa64725 --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_size.py @@ -0,0 +1,15 @@ +import _plotly_utils.basevalidators + + +class SizeValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="size", parent_name="treemap.marker.pattern", **kwargs + ): + super(SizeValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/_sizesrc.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_sizesrc.py new file mode 100644 index 00000000000..5f588979bda --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_sizesrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class SizesrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="sizesrc", parent_name="treemap.marker.pattern", **kwargs + ): + super(SizesrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/_solidity.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_solidity.py new file mode 100644 index 00000000000..2874820e443 --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_solidity.py @@ -0,0 +1,16 @@ +import _plotly_utils.basevalidators + + +class SolidityValidator(_plotly_utils.basevalidators.NumberValidator): + def __init__( + self, plotly_name="solidity", parent_name="treemap.marker.pattern", **kwargs + ): + super(SolidityValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + array_ok=kwargs.pop("array_ok", True), + edit_type=kwargs.pop("edit_type", "style"), + max=kwargs.pop("max", 1), + min=kwargs.pop("min", 0), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/treemap/marker/pattern/_soliditysrc.py b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_soliditysrc.py new file mode 100644 index 00000000000..a066542abd7 --- /dev/null +++ b/packages/python/plotly/plotly/validators/treemap/marker/pattern/_soliditysrc.py @@ -0,0 +1,13 @@ +import _plotly_utils.basevalidators + + +class SoliditysrcValidator(_plotly_utils.basevalidators.SrcValidator): + def __init__( + self, plotly_name="soliditysrc", parent_name="treemap.marker.pattern", **kwargs + ): + super(SoliditysrcValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "none"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/violin/__init__.py b/packages/python/plotly/plotly/validators/violin/__init__.py index 2f29b24ccce..4d4514b8134 100644 --- a/packages/python/plotly/plotly/validators/violin/__init__.py +++ b/packages/python/plotly/plotly/validators/violin/__init__.py @@ -44,6 +44,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._jitter import JitterValidator from ._idssrc import IdssrcValidator from ._ids import IdsValidator @@ -110,6 +111,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._jitter.JitterValidator", "._idssrc.IdssrcValidator", "._ids.IdsValidator", diff --git a/packages/python/plotly/plotly/validators/violin/_legend.py b/packages/python/plotly/plotly/validators/violin/_legend.py new file mode 100644 index 00000000000..5e471d94e56 --- /dev/null +++ b/packages/python/plotly/plotly/validators/violin/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="violin", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/volume/__init__.py b/packages/python/plotly/plotly/validators/volume/__init__.py index 4e9a5b9b658..bad97b9a272 100644 --- a/packages/python/plotly/plotly/validators/volume/__init__.py +++ b/packages/python/plotly/plotly/validators/volume/__init__.py @@ -38,6 +38,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._isomin import IsominValidator from ._isomax import IsomaxValidator from ._idssrc import IdssrcValidator @@ -105,6 +106,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._isomin.IsominValidator", "._isomax.IsomaxValidator", "._idssrc.IdssrcValidator", diff --git a/packages/python/plotly/plotly/validators/volume/_colorbar.py b/packages/python/plotly/plotly/validators/volume/_colorbar.py index 012a4545d67..85adda9998e 100644 --- a/packages/python/plotly/plotly/validators/volume/_colorbar.py +++ b/packages/python/plotly/plotly/validators/volume/_colorbar.py @@ -240,9 +240,15 @@ def __init__(self, plotly_name="colorbar", parent_name="volume", **kwargs): title's location used to be set by the now deprecated `titleside` attribute. x - Sets the x position of the color bar (in plot - fraction). Defaults to 1.02 when `orientation` - is "v" and 0.5 when `orientation` is "h". + Sets the x position with respect to `xref` of + the color bar (in plot fraction). When `xref` + is "paper", defaults to 1.02 when `orientation` + is "v" and 0.5 when `orientation` is "h". When + `xref` is "container", defaults to 1 when + `orientation` is "v" and 0.5 when `orientation` + is "h". Must be between 0 and 1 if `xref` is + "container" and between "-2" and 3 if `xref` is + "paper". xanchor Sets this color bar's horizontal position anchor. This anchor binds the `x` position to @@ -252,10 +258,20 @@ def __init__(self, plotly_name="colorbar", parent_name="volume", **kwargs): xpad Sets the amount of padding (in px) along the x direction. + xref + Sets the container `x` refers to. "container" + spans the entire `width` of the plot. "paper" + refers to the width of the plotting area only. y - Sets the y position of the color bar (in plot - fraction). Defaults to 0.5 when `orientation` - is "v" and 1.02 when `orientation` is "h". + Sets the y position with respect to `yref` of + the color bar (in plot fraction). When `yref` + is "paper", defaults to 0.5 when `orientation` + is "v" and 1.02 when `orientation` is "h". When + `yref` is "container", defaults to 0.5 when + `orientation` is "v" and 1 when `orientation` + is "h". Must be between 0 and 1 if `yref` is + "container" and between "-2" and 3 if `yref` is + "paper". yanchor Sets this color bar's vertical position anchor This anchor binds the `y` position to the @@ -265,6 +281,10 @@ def __init__(self, plotly_name="colorbar", parent_name="volume", **kwargs): ypad Sets the amount of padding (in px) along the y direction. + yref + Sets the container `y` refers to. "container" + spans the entire `height` of the plot. "paper" + refers to the height of the plotting area only. """, ), **kwargs, diff --git a/packages/python/plotly/plotly/validators/volume/_legend.py b/packages/python/plotly/plotly/validators/volume/_legend.py new file mode 100644 index 00000000000..8ef46b6e9e0 --- /dev/null +++ b/packages/python/plotly/plotly/validators/volume/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="volume", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/volume/colorbar/__init__.py b/packages/python/plotly/plotly/validators/volume/colorbar/__init__.py index c1add8f7ff0..84963a2c1b3 100644 --- a/packages/python/plotly/plotly/validators/volume/colorbar/__init__.py +++ b/packages/python/plotly/plotly/validators/volume/colorbar/__init__.py @@ -2,9 +2,11 @@ from typing import TYPE_CHECKING if sys.version_info < (3, 7) or TYPE_CHECKING: + from ._yref import YrefValidator from ._ypad import YpadValidator from ._yanchor import YanchorValidator from ._y import YValidator + from ._xref import XrefValidator from ._xpad import XpadValidator from ._xanchor import XanchorValidator from ._x import XValidator @@ -56,9 +58,11 @@ __name__, [], [ + "._yref.YrefValidator", "._ypad.YpadValidator", "._yanchor.YanchorValidator", "._y.YValidator", + "._xref.XrefValidator", "._xpad.XpadValidator", "._xanchor.XanchorValidator", "._x.XValidator", diff --git a/packages/python/plotly/plotly/validators/volume/colorbar/_x.py b/packages/python/plotly/plotly/validators/volume/colorbar/_x.py index 32d9698197a..170aed8cafa 100644 --- a/packages/python/plotly/plotly/validators/volume/colorbar/_x.py +++ b/packages/python/plotly/plotly/validators/volume/colorbar/_x.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="x", parent_name="volume.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/volume/colorbar/_xref.py b/packages/python/plotly/plotly/validators/volume/colorbar/_xref.py new file mode 100644 index 00000000000..17bf3f82aa6 --- /dev/null +++ b/packages/python/plotly/plotly/validators/volume/colorbar/_xref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class XrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="xref", parent_name="volume.colorbar", **kwargs): + super(XrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/volume/colorbar/_y.py b/packages/python/plotly/plotly/validators/volume/colorbar/_y.py index ca0dac57c58..a2f5901265d 100644 --- a/packages/python/plotly/plotly/validators/volume/colorbar/_y.py +++ b/packages/python/plotly/plotly/validators/volume/colorbar/_y.py @@ -7,7 +7,5 @@ def __init__(self, plotly_name="y", parent_name="volume.colorbar", **kwargs): plotly_name=plotly_name, parent_name=parent_name, edit_type=kwargs.pop("edit_type", "calc"), - max=kwargs.pop("max", 3), - min=kwargs.pop("min", -2), **kwargs, ) diff --git a/packages/python/plotly/plotly/validators/volume/colorbar/_yref.py b/packages/python/plotly/plotly/validators/volume/colorbar/_yref.py new file mode 100644 index 00000000000..15276d97ac1 --- /dev/null +++ b/packages/python/plotly/plotly/validators/volume/colorbar/_yref.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class YrefValidator(_plotly_utils.basevalidators.EnumeratedValidator): + def __init__(self, plotly_name="yref", parent_name="volume.colorbar", **kwargs): + super(YrefValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + edit_type=kwargs.pop("edit_type", "calc"), + values=kwargs.pop("values", ["container", "paper"]), + **kwargs, + ) diff --git a/packages/python/plotly/plotly/validators/waterfall/__init__.py b/packages/python/plotly/plotly/validators/waterfall/__init__.py index 6c977cd94a0..869065c10c8 100644 --- a/packages/python/plotly/plotly/validators/waterfall/__init__.py +++ b/packages/python/plotly/plotly/validators/waterfall/__init__.py @@ -51,6 +51,7 @@ from ._legendrank import LegendrankValidator from ._legendgrouptitle import LegendgrouptitleValidator from ._legendgroup import LegendgroupValidator + from ._legend import LegendValidator from ._insidetextfont import InsidetextfontValidator from ._insidetextanchor import InsidetextanchorValidator from ._increasing import IncreasingValidator @@ -129,6 +130,7 @@ "._legendrank.LegendrankValidator", "._legendgrouptitle.LegendgrouptitleValidator", "._legendgroup.LegendgroupValidator", + "._legend.LegendValidator", "._insidetextfont.InsidetextfontValidator", "._insidetextanchor.InsidetextanchorValidator", "._increasing.IncreasingValidator", diff --git a/packages/python/plotly/plotly/validators/waterfall/_legend.py b/packages/python/plotly/plotly/validators/waterfall/_legend.py new file mode 100644 index 00000000000..a68e4676526 --- /dev/null +++ b/packages/python/plotly/plotly/validators/waterfall/_legend.py @@ -0,0 +1,12 @@ +import _plotly_utils.basevalidators + + +class LegendValidator(_plotly_utils.basevalidators.SubplotidValidator): + def __init__(self, plotly_name="legend", parent_name="waterfall", **kwargs): + super(LegendValidator, self).__init__( + plotly_name=plotly_name, + parent_name=parent_name, + dflt=kwargs.pop("dflt", "legend"), + edit_type=kwargs.pop("edit_type", "style"), + **kwargs, + ) diff --git a/packages/python/plotly/recipe/meta.yaml b/packages/python/plotly/recipe/meta.yaml index 701dfdd89bf..775d8fe1e39 100644 --- a/packages/python/plotly/recipe/meta.yaml +++ b/packages/python/plotly/recipe/meta.yaml @@ -21,7 +21,7 @@ requirements: - python - pip - jupyterlab =3 - - nodejs + - nodejs =16 - setuptools run: - python diff --git a/packages/python/plotly/setup.cfg b/packages/python/plotly/setup.cfg index 1a82ac6f961..41917384385 100644 --- a/packages/python/plotly/setup.cfg +++ b/packages/python/plotly/setup.cfg @@ -1,6 +1,6 @@ [metadata] description_file = README.md -license_file = LICENSE.txt +license_files = LICENSE.txt [bdist_wheel] universal=1 diff --git a/packages/python/plotly/setup.py b/packages/python/plotly/setup.py index 3614cb970d6..178f176457c 100644 --- a/packages/python/plotly/setup.py +++ b/packages/python/plotly/setup.py @@ -495,7 +495,6 @@ def run(self): setup( name="plotly", version=versioneer.get_version(), - use_2to3=False, author="Chris P", author_email="chris@plot.ly", maintainer="Nicolas Kruchten", diff --git a/packages/python/plotly/test_requirements/requirements_36_core.txt b/packages/python/plotly/test_requirements/requirements_36_core.txt index c5d8fc57034..0f02fc47bd0 100644 --- a/packages/python/plotly/test_requirements/requirements_36_core.txt +++ b/packages/python/plotly/test_requirements/requirements_36_core.txt @@ -1,3 +1,4 @@ requests==2.12.4 tenacity==6.2.0 pytest==3.5.1 +packaging diff --git a/packages/python/plotly/test_requirements/requirements_37_optional.txt b/packages/python/plotly/test_requirements/requirements_37_optional.txt index 3fb4185e9c9..224fbf7db8b 100644 --- a/packages/python/plotly/test_requirements/requirements_37_optional.txt +++ b/packages/python/plotly/test_requirements/requirements_37_optional.txt @@ -19,3 +19,4 @@ matplotlib==2.2.3 scikit-image==0.14.4 psutil==5.7.0 kaleido +orjson==3.8.12 diff --git a/packages/python/plotly/test_requirements/requirements_39_optional.txt b/packages/python/plotly/test_requirements/requirements_39_optional.txt index 34b686ad024..eae8cd6d2ec 100644 --- a/packages/python/plotly/test_requirements/requirements_39_optional.txt +++ b/packages/python/plotly/test_requirements/requirements_39_optional.txt @@ -19,3 +19,4 @@ matplotlib==2.2.3 scikit-image==0.18.1 psutil==5.7.0 kaleido +orjson==3.8.12 diff --git a/packages/python/plotly/test_requirements/requirements_39_pandas_2_optional.txt b/packages/python/plotly/test_requirements/requirements_39_pandas_2_optional.txt index 7132d8a6340..acb9752ac16 100644 --- a/packages/python/plotly/test_requirements/requirements_39_pandas_2_optional.txt +++ b/packages/python/plotly/test_requirements/requirements_39_pandas_2_optional.txt @@ -1,6 +1,6 @@ requests==2.25.1 tenacity==6.2.0 -pandas==2.0.0 +pandas==2.0.1 numpy==1.20.3 xarray==0.17.0 statsmodels diff --git a/release.md b/release.md index d65f2cac0eb..7f853f0e52f 100644 --- a/release.md +++ b/release.md @@ -35,7 +35,7 @@ Manually update the versions to `X.Y.Z` in the files specified below. - `CHANGELOG.md` + update the release date - - `packages/python/plotly/README.md` + - `README.md` + this must be done at this point because the README gets baked into PyPI - `plotly/_widget_version.py`: + Update `__frontend_version__` to `^X.Y.Z` (Note the `^` prefix) diff --git a/test/percy/compare-pandas.py b/test/percy/compare-pandas.py new file mode 100644 index 00000000000..ded4e16ffef --- /dev/null +++ b/test/percy/compare-pandas.py @@ -0,0 +1,29 @@ +import difflib +import json +import os + +os.chdir(os.path.dirname(__file__)) + + +def clean_float(numstr): + # round numbers to 3 digits, to remove floating-point differences + return round(float(numstr), 3) + + +def get_fig(html): + # strip off all the rest of the html and js + fig_str = html[html.index("[{", html.rindex("Plotly.newPlot(")) :] + fig_str = fig_str[: fig_str.index("} ") + 1] + data, layout, config = json.loads(f"[{fig_str}]", parse_float=clean_float) + fig_dict = dict(data=data, layout=layout, config=config) + return json.dumps(fig_dict, indent=2).splitlines(keepends=True) + + +for filename in os.listdir("pandas2"): + with open(filename, encoding="utf-8") as f1: + with open(os.path.join("pandas2", filename)) as f2: + fig1 = get_fig(f1.read()) + fig2 = get_fig(f2.read()) + if any(l1 != l2 for l1, l2 in zip(fig1, fig2)): + print("".join(difflib.unified_diff(fig1, fig2))) + raise ValueError(f"Pandas 1/2 difference in {filename}") diff --git a/test/percy/plotly-express.py b/test/percy/plotly-express.py index 85bd910712d..49d3fdb8249 100644 --- a/test/percy/plotly-express.py +++ b/test/percy/plotly-express.py @@ -543,3 +543,6 @@ ) fig = px.timeline(df, x_start="Start", x_end="Finish", y="Task", color="Task") fig.write_html(os.path.join(dir_name, "timeline.html"), auto_play=False) + + +px.bar(pd.DataFrame(columns=["A", "B", "X"]), x="A", y="X", facet_col="B") diff --git a/test/percy/snapshots.yml b/test/percy/snapshots.yml new file mode 100644 index 00000000000..0dd23c4e394 --- /dev/null +++ b/test/percy/snapshots.yml @@ -0,0 +1,22 @@ +version: 2 +static: + options: + waitForTimeout: 6000 + execute: + beforeSnapshot: | + const stash = window._canvasStash = []; + Array.from(document.querySelectorAll('canvas')).forEach(c => { + const i = document.createElement('img'); + i.src = c.toDataURL(); + i.width = c.width; + i.height = c.height; + i.setAttribute('style', c.getAttribute('style')); + i.className = c.className; + i.setAttribute('data-canvasnum', stash.length); + stash.push(c); + c.parentElement.insertBefore(i, c); + c.parentElement.removeChild(c); + }); +snapshot: + widths: + - 1280