Merge remote-tracking branch 'upstream/master' into doc-histogram-categoryorder

Author: hweecat

.circleci/config.yml

@@ -440,6 +440,15 @@ jobs:
               git push --force [email protected]:plotly/plotly.py-docs.git master:built
               rm -rf .git
               cd ../..
+              cd build/ipynb
+              git init
+              git config user.name plotlydocbot
+              git config user.email [email protected]
+              git add *
+              git commit -m "build of https://github.com/plotly/plotly.py/commit/${CIRCLE_SHA1}"
+              git push --force [email protected]:plotly/plotly.py-docs.git master:built_ipynb
+              rm -rf .git
+              cd ../..
             fi
             tar -zcf build/html.tgz build/html
             rm -rf build/html build/ipynb

.gitattributes

@@ -1 +1 @@
-plotly/_version.py export-subst
+packages/python/plotly/plotly/_version.py export-subst

.github/FUNDING.yml

@@ -1 +1,2 @@
+github: plotly
 custom: https://plot.ly/products/consulting-and-oem/

.github/pull_request_template.md

@@ -33,5 +33,6 @@ below :-).
 - [ ] For a new feature, I have added documentation examples in an existing or
   new tutorial notebook (please see the doc checklist as well).
 - [ ] I have added a CHANGELOG entry if fixing/changing/adding anything substantial.
+- [ ] For a new feature or a change in behaviour, I have updated the relevant docstrings in the code to describe the feature or behaviour (please see the doc checklist as well).
 
 -->

.gitignore

@@ -31,7 +31,7 @@ node_modules/
 
 # virtual envs
 vv
-venv
+venv*
 
 # dist files
 build
@@ -46,4 +46,5 @@ temp-plot.html
 doc/python/.ipynb_checkpoints
 doc/python/.mapbox_token
 doc/.ipynb_checkpoints
+tags
 doc/check-or-enforce-order.py

CHANGELOG.md

@@ -2,6 +2,108 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [4.15.0] - UNRELEASED
+
+### Added
+
+### Fixed
+
+### Updated
+
+
+## [4.14.2] - UNRELEASED
+
+### Added
+
+### Fixed
+
+### Updated
+
+
+## [4.14.1] - 2020-12-09
+
+### Updated
+
+- Updated Plotly.js to version 1.58.2. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/v1.58.0/CHANGELOG.md) for more information. These changes are reflected in the auto-generated `plotly.graph_objects` module. Notable changes include:
+  - fixes for new `ticklabelposition` attribute
+  - fixes for a regression related to treemaps in the previous version
+
+
+## [4.14.0] - 2020-12-07
+
+### Added
+
+- `px.imshow` now supports `facet_col` and `animation_frame` arguments for visualizing 3-d and 4-d images [2746](https://github.com/plotly/plotly.py/pull/2746)
+- `px.defaults` now supports `color_discrete_map`, `symbol_map`, `line_dash_map`, `labels` and `category_orders` as well as a `.reset()` method [2957](https://github.com/plotly/plotly.py/pull/2957)
+
+### Fixed
+
+- axes will now auto-type numeric strings as categorical data rather than linear in the default templates [2951](https://github.com/plotly/plotly.py/pull/2951)
+
+### Updated
+
+- Updated Plotly.js to version 1.58.1. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/v1.58.0/CHANGELOG.md) for more information. These changes are reflected in the auto-generated `plotly.graph_objects` module. Notable changes include:
+  - a new `ticklabelposition` attribute to enable positioning tick labels inside the plotting area
+  - better support for `scaleanchor` and `matches` on cartesian axes for matched square subplots
+  - a new `autotypenumbers` attribute which is now set to `strict` in the default templates
+  - various fixes relating to `automargins` for small figures
+
+
+## [4.13.0] - 2020-11-23
+
+### Added
+- `px.choropleth`, `px.scatter_geo` and `px.line_geo` now support faceting as well as `fitbounds` and `basemap_visible` [2923](https://github.com/plotly/plotly.py/pull/2923)
+- `px.scatter_geo` and `px.line_geo` now support `geojson`/`featureidkey` input [2923](https://github.com/plotly/plotly.py/pull/2923)
+- `px.scatter_geo` now supports `symbol` [2923](https://github.com/plotly/plotly.py/pull/2923)
+- `go.Figure` now has a `set_subplots` method to set subplots on an already
+  existing figure. [2866](https://github.com/plotly/plotly.py/pull/2866)
+- Added `Turbo` colorscale and fancier swatch display functions
+  [2882](https://github.com/plotly/plotly.py/pull/2882)
+- A utility function `image_array_to_data_uri` has been added in
+  `plotly.utils`, in order to transform NumPy arrays to data b64 URIs (which
+  can be passed to the source parameter of `go.Image`, or to layout images).
+  [2879](https://github.com/plotly/plotly.py/pull/2879)
+- the `selector` argument to updater/selector functions now accepts `int`s and `str`s
+  [2894](https://github.com/plotly/plotly.py/pull/2894)
+
+
+### Updated
+
+- the JSON serialization of plotly figures has been accelerated thanks to a
+  different handling of Infinity and NaN values. For example, a figure with a
+  1000x1000 Heatmap should now serialize 2x faster. [2880](https://github.com/plotly/plotly.py/pull/2880)
+- Coding mistakes with "magic underscores" now return significantly more ergonomic error
+  messages [2843](https://github.com/plotly/plotly.py/pull/2843)
+- Error messages related to impossible subplot geometries are now much more helpful
+  [2897](https://github.com/plotly/plotly.py/pull/2897)
+
+
+### Fixed
+
+- `px.scatter_geo` support for `text` is fixed [2923](https://github.com/plotly/plotly.py/pull/2923)
+- the `x` and `y` parameters of `px.imshow` are now used also in the case where
+  an Image trace is used (for RGB data or with `binary_string=True`). However,
+  only numerical values are accepted (while the Heatmap trace allows date or
+  string values for `x` and `y`). [2761](https://github.com/plotly/plotly.py/pull/2761)
+
+
+## [4.12.0] - 2020-10-23
+
+### Added
+
+- For `add_trace`, `add_shape`, `add_annotation` and `add_layout_image`, the `row` and/or `col` argument now also accept the string `"all"`. `row="all"` adds the object to all the subplot rows and `col="all"` adds the object to all the subplot columns. ([#2840](https://github.com/plotly/plotly.py/pull/2840))
+- Shapes that reference the plot axes in one dimension and the data in another dimension can be added with the new `add_hline`, `add_vline`, `add_hrect`, `add_vrect` functions, which also support the `row="all"` and `col="all"` arguments. ([#2840](https://github.com/plotly/plotly.py/pull/2840))
+- The `add_trace`, `add_shape`, `add_annotation`, `add_layout_image`, `add_hline`, `add_vline`, `add_hrect`, `add_vrect` functions accept an argument `exclude_empty_subplots` which if `True`, only adds the object to subplots already containing traces or layout objects. This is useful in conjunction with the `row="all"` and `col="all"` arguments. ([#2840](https://github.com/plotly/plotly.py/pull/2840))
+- For all `go.Figure` functions accepting a selector argument (e.g., `select_traces`), this argument can now also be a function which is passed each relevant graph object (in the case of `select_traces`, it is passed every trace in the figure). For graph objects where this function returns true, the graph object is included in the selection. ([#2844](https://github.com/plotly/plotly.py/pull/2844))
+
+### Added
+
+- Better magic underscore error messages. For example, `some_fig.update_layout(geo_ltaxis_showgrid=True)` shows `Bad property path:\ngeo_ltaxis_showgrid\n   ^` and lists the valid properties for `geo`.
+
+### Updated
+
+- Updated Plotly.js to version 1.57.1. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/v1.57.1/CHANGELOG.md) for more information. These changes are reflected in the auto-generated `plotly.graph_objects` module.
+
 ## [4.11.0] - 2020-10-01
 
 ### Updated
@@ -16,6 +118,11 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ### Updated
 
+- The JSON serialization of plotly figures had been accelerated by handling
+  differently figures with and without NaN and Inf values ([#2880](https://github.com/plotly/plotly.py/pull/2880)).
+
+### Updated
+
 - Updated Plotly.js to version 1.55.2. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/v1.55.2/CHANGELOG.md) for more information. These changes are reflected in the auto-generated `plotly.graph_objects` module.
 - `px.imshow` has a new `binary_string` boolean argument, which passes the
   image data as a b64 binary string when True. Using binary strings allow for

README.md

@@ -31,9 +31,13 @@
     </tr>
 </table>
 
+## Data Science Workspaces
+
+Our recommended IDE for Plotly’s Python graphing library is Dash Enterprise’s [Data Science Workspaces](https://plotly.com/dash/workspaces/), which has both Jupyter notebook and Python code file support.
+
 ## Quickstart
 
-`pip install plotly==4.11.0`
+`pip install plotly==4.14.1`
 
 Inside [Jupyter notebook](https://jupyter.org/install) (installable with `pip install "notebook>=5.3" "ipywidgets>=7.2"`):
 
@@ -82,13 +86,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==4.11.0
+pip install plotly==4.14.1
 ```
 
 or conda.
 
 ```
-conda install -c plotly plotly=4.11.0
+conda install -c plotly plotly=4.14.1
 ```
 
 ### Jupyter Notebook Support
@@ -125,18 +129,18 @@ Then run the following commands to install the required JupyterLab extensions (n
 
 ```
 # Basic JupyterLab renderer support
-jupyter labextension install jupyterlab-plotly@4.11.0
+jupyter labextension install jupyterlab-plotly@4.14.1
 
 # OPTIONAL: Jupyter widgets extension for FigureWidget support
-jupyter labextension install @jupyter-widgets/jupyterlab-manager plotlywidget@4.11.0
+jupyter labextension install @jupyter-widgets/jupyterlab-manager plotlywidget@4.14.1
 ```
 
 Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab.
 
 ### Static Image Export
 
 plotly.py supports [static image export](https://plotly.com/python/static-image-export/),
-using the either the [`kaleido`](https://github.com/plotly/Kaleido)
+using either the [`kaleido`](https://github.com/plotly/Kaleido)
 package (recommended, supported as of `plotly` version 4.9) or the [orca](https://github.com/plotly/orca)
 command line utility (legacy as of `plotly` version 4.9).
 
@@ -152,7 +156,7 @@ $ pip install -U kaleido
 or conda.
 
 ```
-$ conda install -c plotly python-kaleido
+$ conda install -c conda-forge python-kaleido
 ```
 
 #### Orca
@@ -200,13 +204,13 @@ The `chart-studio` package can be used to upload plotly figures to Plotly's Char
 Studio Cloud or On-Prem service. This package can be installed using pip...
 
 ```
-pip install chart-studio==1.0.0
+pip install chart-studio==1.1.0
 ```
 
 or conda
 
 ```
-conda install -c plotly chart-studio=1.0.0
+conda install -c plotly chart-studio=1.1.0
 ```
 
 ## Migration

binder/requirements.txt

@@ -1,5 +1,5 @@
 jupytext
-plotly==4.11.0
+plotly==4.14.1
 jupyter
 notebook
 pandas==1.0.3
@@ -18,3 +18,4 @@ cufflinks==0.17.3
 kaleido
 scikit-learn
 umap-learn
+wget

contributing.md

@@ -280,7 +280,7 @@ pytest  packages/python/plotly/plotly/tests/test_core/
 pytest plotly/tests/test_plotly/test_plot.py
 ```
 
-or for a specfic test function
+or for a specific test function
 
 ```bash
 pytest plotly/tests/test_plotly/test_plot.py::test_function

doc/Makefile

@@ -23,15 +23,15 @@ all: $(HTML_FILES) $(V3_REDIR_FILES) $(NEXT_REDIR_FILES)
 
 $(IPYNB_DIR)/.mapbox_token: $(MD_DIR)/.mapbox_token
 	@mkdir -p $(IPYNB_DIR)
-	cd $(IPYNB_DIR) && ln -s ../../$<
+	@echo "[symlink]    .mapbox_token"
+	@cd $(IPYNB_DIR) && ln -s ../../$<
 
 $(IPYNB_FILES): $(IPYNB_DIR)/.mapbox_token
 
 $(IPYNB_DIR)/%.ipynb: $(MD_DIR)/%.md
 	@mkdir -p $(IPYNB_DIR)
 	@echo "[jupytext]   $<"
-	@cat what_about_dash.md >> $<
-	@jupytext $< --to notebook --quiet --output $@
+	@cat $< what_about_dash.md | jupytext  --to notebook --quiet --output $@
 
 $(HTML_DIR)/2019-07-03-%.html: $(IPYNB_DIR)/%.ipynb
 	@mkdir -p $(HTML_DIR)