Skip to content

Commit 36076e2

Browse files
maresbmaresb
authored
Merge branch 'master' into remove-six
2 parents c3fb1a5 + efa7071 commit 36076e2

File tree

10,380 files changed

+30406
-24844
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

10,380 files changed

+30406
-24844
lines changed

‎.circleci/config.yml

+1-6
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ jobs:
8787
- checkout
8888
- run:
8989
name: Install black
90-
command: "sudo pip install black==19.10b0"
90+
command: "sudo pip install black==22.3.0"
9191
- run:
9292
name: Check formatting with black
9393
command: "black --check ."
@@ -380,12 +380,7 @@ jobs:
380380
- store_artifacts:
381381
path: doc/build
382382
destination: doc/build
383-
- store_artifacts:
384-
path: doc/apidoc/_build/
385-
destination: doc/apidoc/_build/
386-
387383
workflows:
388-
389384
code_formatting:
390385
jobs:
391386
- check-code-formatting

‎.pre-commit-config.yaml

+4-4
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
repos:
2-
- repo: https://github.com/ambv/black
3-
rev: 19.10b0
2+
- repo: https://github.com/ambv/black
3+
rev: 22.3.0
44
hooks:
5-
- id: black
6-
language_version: python
5+
- id: black
6+
language_version: python

‎CHANGELOG.md

+18
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,24 @@ All notable changes to this project will be documented in this file.
33
This project adheres to [Semantic Versioning](http://semver.org/).
44

55

6+
## [5.7.0] - 2022-04-05
7+
8+
### Added
9+
- added `pattern_shape` options to `px.area()` [#3668](https://github.com/plotly/plotly.py/issues/3668)
10+
11+
### Updated
12+
- Updated Plotly.js to from version 2.9.0 to version 2.11.1. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/master/CHANGELOG.md#2111----2022-03-15) for more information. Notable changes include:
13+
- Add `fillpattern` options to `scatter` trace
14+
- Various JS-specific improvements such as MathJax 3.0 support
15+
16+
## [5.6.0] - 2022-02-09
17+
18+
### Updated
19+
- Updated Plotly.js to from version 2.8.3 to version 2.9.0. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/master/CHANGELOG.md#290----2022-02-04) for more information. Notable changes include:
20+
- Implement `ticklabelstep` to reduce labels on cartesian axes and colorbars
21+
- Display the version of plotly.js when hovering over the modebar
22+
23+
624
## [5.5.0] - 2021-12-20
725

826
### Added

‎README.md

+19-19
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
<tr>
1212
<td>User forum</td>
1313
<td>
14-
<a href="https://community.plot.ly"/>
14+
<a href="https://community.plotly.com/"/>
1515
<img src="https://img.shields.io/badge/help_forum-discourse-blue.svg"/>
1616
</td>
1717
</tr>
@@ -33,7 +33,7 @@
3333

3434
## Quickstart
3535

36-
`pip install plotly==5.5.0`
36+
`pip install plotly==5.7.0`
3737

3838
Inside [Jupyter](https://jupyter.org/install) (installable with `pip install "jupyterlab>=3" "ipywidgets>=7.6"`):
3939

@@ -43,34 +43,34 @@ fig = px.bar(x=["a", "b", "c"], y=[1, 3, 2])
4343
fig.show()
4444
```
4545

46-
See the [Python documentation](https://plot.ly/python/) for more examples.
46+
See the [Python documentation](https://plotly.com/python/) for more examples.
4747

4848
Read about what's new in [plotly.py v4](https://medium.com/plotly/plotly-py-4-0-is-here-offline-only-express-first-displayable-anywhere-fc444e5659ee)
4949

5050
## Overview
5151

52-
[plotly.py](https://plot.ly/python) is an interactive, open-source, and browser-based graphing library for Python :sparkles:
52+
[plotly.py](https://plotly.com/python/) is an interactive, open-source, and browser-based graphing library for Python :sparkles:
5353

5454
Built on top of [plotly.js](https://github.com/plotly/plotly.js), `plotly.py` is a high-level, declarative charting library. plotly.js ships with over 30 chart types, including scientific charts, 3D graphs, statistical charts, SVG maps, financial charts, and more.
5555

56-
`plotly.py` is [MIT Licensed](packages/python/chart-studio/LICENSE.txt). Plotly graphs can be viewed in Jupyter notebooks, standalone HTML files, or hosted online using [Chart Studio Cloud](https://chart-studio.plot.ly/feed/).
56+
`plotly.py` is [MIT Licensed](https://github.com/plotly/plotly.py/blob/master/LICENSE.txt). Plotly graphs can be viewed in Jupyter notebooks, standalone HTML files, or hosted online using [Chart Studio Cloud](https://chart-studio.plotly.com/feed/).
5757

58-
[Contact us](https://plot.ly/products/consulting-and-oem/) for consulting, dashboard development, application integration, and feature additions.
58+
[Contact us](https://plotly.com/consulting-and-oem/) for consulting, dashboard development, application integration, and feature additions.
5959

6060
<p align="center">
61-
<a href="https://plot.ly/python" target="_blank">
61+
<a href="https://plotly.com/python/" target="_blank">
6262
<img src="https://raw.githubusercontent.com/cldougl/plot_images/add_r_img/plotly_2017.png">
6363
</a></p>
6464

6565
---
6666

67-
- [Online Documentation](https://plot.ly/python)
68-
- [Contributing to plotly](contributing.md)
69-
- [Changelog](CHANGELOG.md)
70-
- [Code of Conduct](CODE_OF_CONDUCT.md)
71-
- [Version 4 Migration Guide](https://plot.ly/python/next/v4-migration/)
67+
- [Online Documentation](https://plotly.com/python/)
68+
- [Contributing to plotly](https://github.com/plotly/plotly.py/blob/master/contributing.md)
69+
- [Changelog](https://github.com/plotly/plotly.py/blob/master/CHANGELOG.md)
70+
- [Code of Conduct](https://github.com/plotly/plotly.py/blob/master/CODE_OF_CONDUCT.md)
71+
- [Version 4 Migration Guide](https://plotly.com/python/v4-migration/)
7272
- [New! Announcing Dash 1.0](https://medium.com/plotly/welcoming-dash-1-0-0-f3af4b84bae)
73-
- [Community forum](https://community.plot.ly/c/api/python)
73+
- [Community forum](https://community.plotly.com)
7474

7575
---
7676

@@ -79,13 +79,13 @@ Built on top of [plotly.js](https://github.com/plotly/plotly.js), `plotly.py` is
7979
plotly.py may be installed using pip...
8080

8181
```
82-
pip install plotly==5.5.0
82+
pip install plotly==5.7.0
8383
```
8484

8585
or conda.
8686

8787
```
88-
conda install -c plotly plotly=5.5.0
88+
conda install -c plotly plotly=5.7.0
8989
```
9090

9191
### JupyterLab Support
@@ -107,7 +107,7 @@ The instructions above apply to JupyterLab 3.x. **For JupyterLab 2 or earlier**,
107107

108108
```
109109
# JupyterLab 2.x renderer support
110-
jupyter labextension install jupyterlab-plotly@5.5.0 @jupyter-widgets/jupyterlab-manager
110+
jupyter labextension install jupyterlab-plotly@5.7.0 @jupyter-widgets/jupyterlab-manager
111111
```
112112

113113
Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab.
@@ -205,14 +205,14 @@ conda install -c plotly chart-studio=1.1.0
205205

206206
## Migration
207207

208-
If you're migrating from plotly.py v3 to v4, please check out the [Version 4 migration guide](https://plot.ly/python/next/v4-migration/)
208+
If you're migrating from plotly.py v3 to v4, please check out the [Version 4 migration guide](https://plotly.com/python/v4-migration/)
209209

210-
If you're migrating from plotly.py v2 to v3, please check out the [Version 3 migration guide](migration-guide.md)
210+
If you're migrating from plotly.py v2 to v3, please check out the [Version 3 migration guide](https://github.com/plotly/plotly.py/blob/master/migration-guide.md)
211211

212212
## Copyright and Licenses
213213

214214
Code and documentation copyright 2019 Plotly, Inc.
215215

216-
Code released under the [MIT license](packages/python/chart-studio/LICENSE.txt).
216+
Code released under the [MIT license](https://github.com/plotly/plotly.py/blob/master/LICENSE.txt).
217217

218218
Docs released under the [Creative Commons license](https://github.com/plotly/documentation/blob/source/LICENSE).

‎binder/requirements.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
jupytext
2-
plotly==5.5.0
2+
plotly==5.7.0
33
jupyter
44
notebook
55
pandas==1.0.3

‎doc/apidoc/conf.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@
2828
# The short X.Y version
2929
version = ""
3030
# The full version, including alpha/beta/rc tags
31-
release = "5.5.0"
31+
release = "5.7.0"
3232

3333

3434
# -- General configuration ---------------------------------------------------

‎doc/python/3d-mesh.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -77,8 +77,8 @@ Get started with [the official Dash docs](https://dash.plotly.com/installation)
7777

7878
```python hide_code=true
7979
from IPython.display import IFrame
80-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
81-
IFrame(snippet_url + '3d-mesh', width='100%', height=630)
80+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
81+
IFrame(snippet_url + '3d-mesh', width='100%', height=1200)
8282
```
8383

8484
### Mesh Tetrahedron

‎doc/python/3d-scatter-plots.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -81,8 +81,8 @@ Get started with [the official Dash docs](https://dash.plotly.com/installation)
8181

8282
```python hide_code=true
8383
from IPython.display import IFrame
84-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
85-
IFrame(snippet_url + '3d-scatter-plots', width='100%', height=630)
84+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
85+
IFrame(snippet_url + '3d-scatter-plots', width='100%', height=1200)
8686
```
8787

8888
### 3D Scatter Plot with go.Scatter3d

‎doc/python/animations.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -56,8 +56,8 @@ Get started with [the official Dash docs](https://dash.plotly.com/installation)
5656

5757
```python hide_code=true
5858
from IPython.display import IFrame
59-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
60-
IFrame(snippet_url + 'animations', width='100%', height=630)
59+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
60+
IFrame(snippet_url + 'animations', width='100%', height=1200)
6161
```
6262

6363
#### Animated Bar Charts with Plotly Express

‎doc/python/axes.md

+20-6
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,10 @@ jupyter:
55
text_representation:
66
extension: .md
77
format_name: markdown
8-
format_version: '1.2'
9-
jupytext_version: 1.4.2
8+
format_version: '1.3'
9+
jupytext_version: 1.13.7
1010
kernelspec:
11-
display_name: Python 3
11+
display_name: Python 3 (ipykernel)
1212
language: python
1313
name: python3
1414
language_info:
@@ -20,7 +20,7 @@ jupyter:
2020
name: python
2121
nbconvert_exporter: python
2222
pygments_lexer: ipython3
23-
version: 3.7.7
23+
version: 3.9.0
2424
plotly:
2525
description: How to adjust axes properties in Python - axes titles, styling and
2626
coloring axes and grid lines, ticks, tick labels and more.
@@ -133,8 +133,8 @@ Get started with [the official Dash docs](https://dash.plotly.com/installation)
133133

134134
```python hide_code=true
135135
from IPython.display import IFrame
136-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
137-
IFrame(snippet_url + 'axes', width='100%', height=630)
136+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
137+
IFrame(snippet_url + 'axes', width='100%', height=1200)
138138
```
139139

140140
#### Moving Tick Labels Inside the Plot
@@ -291,6 +291,20 @@ fig.update_yaxes(ticks="outside", tickwidth=2, tickcolor='crimson', ticklen=10,
291291
fig.show()
292292
```
293293

294+
##### Step for tick labels
295+
296+
You can set a step for tick labels with `ticklabelstep`. In this example, we hide labels between every `2` ticks on the y axes. Similarly, this can be used with `fig.update_xaxes` for x axes: `fig.update_xaxes(ticklabelstep=2)`.
297+
298+
```python
299+
import plotly.express as px
300+
df = px.data.iris()
301+
302+
fig = px.scatter(df, x="sepal_width", y="sepal_length", facet_col="species")
303+
fig.update_yaxes(ticklabelstep=2)
304+
305+
fig.show()
306+
```
307+
294308
##### Toggling axis labels
295309

296310
The axis tick mark labels can be disabled by setting the `showticklabels` axis property to `False`.

‎doc/python/bar-charts.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -96,8 +96,8 @@ Get started with [the official Dash docs](https://dash.plotly.com/installation)
9696

9797
```python hide_code=true
9898
from IPython.display import IFrame
99-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
100-
IFrame(snippet_url + 'bar-charts', width='100%', height=630)
99+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
100+
IFrame(snippet_url + 'bar-charts', width='100%', height=1200)
101101
```
102102

103103
### Colored Bars

‎doc/python/bio-alignment-chart.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,6 @@ fig.show()
5858

5959
```python hide_code=true
6060
from IPython.display import IFrame
61-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
62-
IFrame(snippet_url + 'bio-alignmentchart', width='100%', height=630)
61+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
62+
IFrame(snippet_url + 'bio-alignmentchart', width='100%', height=1200)
6363
```

‎doc/python/bio-clustergram.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,6 @@ dash_bio.Clustergram(
102102

103103
```python hide_code=true
104104
from IPython.display import IFrame
105-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
106-
IFrame(snippet_url + 'bio-clustergram', width='100%', height=630)
105+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
106+
IFrame(snippet_url + 'bio-clustergram', width='100%', height=1200)
107107
```

‎doc/python/bio-manhattanplot.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,6 @@ dash_bio.ManhattanPlot(
7171

7272
```python hide_code=true
7373
from IPython.display import IFrame
74-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
75-
IFrame(snippet_url + 'bio-manhattanplot', width='100%', height=630)
74+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
75+
IFrame(snippet_url + 'bio-manhattanplot', width='100%', height=1200)
7676
```

‎doc/python/bio-volcano-plot.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,6 @@ dash_bio.VolcanoPlot(
7171

7272
```python hide_code=true
7373
from IPython.display import IFrame
74-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
75-
IFrame(snippet_url + 'bio-volcano', width='100%', height=630)
74+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
75+
IFrame(snippet_url + 'bio-volcano', width='100%', height=1200)
7676
```

‎doc/python/box-plots.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -73,8 +73,8 @@ Get started with [the official Dash docs](https://dash.plotly.com/installation)
7373

7474
```python hide_code=true
7575
from IPython.display import IFrame
76-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
77-
IFrame(snippet_url + 'box-plots', width='100%', height=630)
76+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
77+
IFrame(snippet_url + 'box-plots', width='100%', height=1200)
7878
```
7979

8080
### Display the underlying data

‎doc/python/builtin-colorscales.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -83,8 +83,8 @@ Get started with [the official Dash docs](https://dash.plotly.com/installation)
8383

8484
```python hide_code=true
8585
from IPython.display import IFrame
86-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
87-
IFrame(snippet_url + 'builtin-colorscales', width='100%', height=630)
86+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
87+
IFrame(snippet_url + 'builtin-colorscales', width='100%', height=1200)
8888
```
8989

9090
### Built-In Sequential Color scales

‎doc/python/candlestick-charts.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -83,8 +83,8 @@ Get started with [the official Dash docs](https://dash.plotly.com/installation)
8383

8484
```python hide_code=true
8585
from IPython.display import IFrame
86-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
87-
IFrame(snippet_url + 'candlestick-charts', width='100%', height=630)
86+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
87+
IFrame(snippet_url + 'candlestick-charts', width='100%', height=1200)
8888
```
8989

9090
#### Adding Customized Text and Annotations

‎doc/python/choropleth-maps.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -151,8 +151,8 @@ Get started with [the official Dash docs](https://dash.plotly.com/installation)
151151

152152
```python hide_code=true
153153
from IPython.display import IFrame
154-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
155-
IFrame(snippet_url + 'choropleth-maps', width='100%', height=630)
154+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
155+
IFrame(snippet_url + 'choropleth-maps', width='100%', height=1200)
156156
```
157157

158158
### Discrete Colors

‎doc/python/colorscales.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -99,8 +99,8 @@ Get started with [the official Dash docs](https://dash.plotly.com/installation)
9999

100100
```python hide_code=true
101101
from IPython.display import IFrame
102-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
103-
IFrame(snippet_url + 'colorscales', width='100%', height=630)
102+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
103+
IFrame(snippet_url + 'colorscales', width='100%', height=1200)
104104
```
105105

106106
### Color Scales in Plotly Express

‎doc/python/creating-and-updating-figures.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -136,8 +136,8 @@ Get started with [the official Dash docs](https://dash.plotly.com/installation)
136136

137137
```python hide_code=true
138138
from IPython.display import IFrame
139-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
140-
IFrame(snippet_url + 'figure-structure', width='100%', height=630)
139+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
140+
IFrame(snippet_url + 'figure-structure', width='100%', height=1200)
141141
```
142142

143143
### Creating Figures

‎doc/python/discrete-color.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -107,8 +107,8 @@ Get started with [the official Dash docs](https://dash.plotly.com/installation)
107107

108108
```python hide_code=true
109109
from IPython.display import IFrame
110-
snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
111-
IFrame(snippet_url + 'discrete-color', width='100%', height=630)
110+
snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
111+
IFrame(snippet_url + 'discrete-color', width='100%', height=1200)
112112
```
113113

114114
### Color Sequences in Plotly Express

0 commit comments

Comments
 (0)