Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit 5b66591

Browse filesBrowse files
timhoffmtimhoffm
committed
In docs remove 'optional' if 'default' can be given
1 parent eb0917b commit 5b66591
Copy full SHA for 5b66591

File tree

Expand file treeCollapse file tree

18 files changed

+67
-67
lines changed
Filter options
Expand file treeCollapse file tree

18 files changed

+67
-67
lines changed

‎examples/lines_bars_and_markers/filled_step.py

Copy file name to clipboardExpand all lines: examples/lines_bars_and_markers/filled_step.py
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -92,7 +92,7 @@ def stack_hist(ax, stacked_data, sty_cycle, bottoms=None,
9292
sty_cycle : Cycler or operable of dict
9393
Style to apply to each set
9494
95-
bottoms : array, optional, default: 0
95+
bottoms : array, default: 0
9696
The initial positions of the bottoms.
9797
9898
hist_func : callable, optional

‎lib/matplotlib/animation.py

Copy file name to clipboardExpand all lines: lib/matplotlib/animation.py
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -208,7 +208,7 @@ def setup(self, fig, outfile, dpi=None):
208208
The figure object that contains the information for frames.
209209
outfile : str
210210
The filename of the resulting movie file.
211-
dpi : float, optional, default: ``fig.dpi``
211+
dpi : float, default: ``fig.dpi``
212212
The DPI (or resolution) for the file. This controls the size
213213
in pixels of the resulting movie file.
214214
"""
@@ -989,7 +989,7 @@ class to use, such as 'ffmpeg'.
989989
Controls the dots per inch for the movie frames. Together with
990990
the figure's size in inches, this controls the size of the movie.
991991
992-
codec : str, optional, default: :rc:`animation.codec`.
992+
codec : str, default: :rc:`animation.codec`.
993993
The video codec to use. Not all codecs are supported by a given
994994
`MovieWriter`.
995995

‎lib/matplotlib/axes/_axes.py

Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_axes.py
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6833,12 +6833,12 @@ def hist2d(self, x, y, bins=10, range=None, density=False, weights=None,
68336833
weights : array-like, shape (n, ), optional
68346834
An array of values w_i weighing each sample (x_i, y_i).
68356835
6836-
cmin : scalar, optional, default: None
6836+
cmin : scalar, default: None
68376837
All bins that has count less than cmin will not be displayed (set
68386838
to NaN before passing to imshow) and these count values in the
68396839
return value count histogram will also be set to nan upon return.
68406840
6841-
cmax : scalar, optional, default: None
6841+
cmax : scalar, default: None
68426842
All bins that has count more than cmax will not be displayed (set
68436843
to NaN before passing to imshow) and these count values in the
68446844
return value count histogram will also be set to nan upon return.

‎lib/matplotlib/axes/_base.py

Copy file name to clipboardExpand all lines: lib/matplotlib/axes/_base.py
+3-3Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -455,8 +455,8 @@ def __init__(self, fig, rect,
455455
The x or y `~.matplotlib.axis` is shared with the x or
456456
y axis in the input `~.axes.Axes`.
457457
458-
frameon : bool, optional
459-
True means that the axes frame is visible.
458+
frameon : bool, default: True
459+
Whether the axes frame is visible.
460460
461461
box_aspect : None, or a number, optional
462462
Sets the aspect of the axes box. See `~.axes.Axes.set_box_aspect`
@@ -906,7 +906,7 @@ def set_position(self, pos, which='both'):
906906
pos : [left, bottom, width, height] or `~matplotlib.transforms.Bbox`
907907
The new position of the in `.Figure` coordinates.
908908
909-
which : {'both', 'active', 'original'}, optional
909+
which : {'both', 'active', 'original'}, default: 'both'
910910
Determines which position variables to change.
911911
912912
"""

‎lib/matplotlib/backend_bases.py

Copy file name to clipboardExpand all lines: lib/matplotlib/backend_bases.py
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2315,11 +2315,11 @@ def key_press_handler(event, canvas=None, toolbar=None):
23152315
----------
23162316
event : `KeyEvent`
23172317
A key press/release event.
2318-
canvas : `FigureCanvasBase`, optional, default: ``event.canvas``
2318+
canvas : `FigureCanvasBase`, default: ``event.canvas``
23192319
The backend-specific canvas instance. This parameter is kept for
23202320
back-compatibility, but, if set, should always be equal to
23212321
``event.canvas``.
2322-
toolbar : `NavigationToolbar2`, optional, default: ``event.canvas.toolbar``
2322+
toolbar : `NavigationToolbar2`, default: ``event.canvas.toolbar``
23232323
The navigation cursor toolbar. This parameter is kept for
23242324
back-compatibility, but, if set, should always be equal to
23252325
``event.canvas.toolbar``.

‎lib/matplotlib/backends/backend_pgf.py

Copy file name to clipboardExpand all lines: lib/matplotlib/backends/backend_pgf.py
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1004,7 +1004,7 @@ def __init__(self, filename, *, keep_empty=True, metadata=None):
10041004
filename : str or path-like
10051005
Plots using `PdfPages.savefig` will be written to a file at this
10061006
location. Any older file with the same name is overwritten.
1007-
keep_empty : bool, optional
1007+
keep_empty : bool, default: True
10081008
If set to False, then empty pdf files will be deleted automatically
10091009
when closed.
10101010
metadata : dict, optional

‎lib/matplotlib/backends/qt_editor/_formlayout.py

Copy file name to clipboardExpand all lines: lib/matplotlib/backends/qt_editor/_formlayout.py
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -218,7 +218,7 @@ def __init__(self, data, comment="", with_margin=False, parent=None):
218218
The data to be edited in the form.
219219
comment : str, optional
220220
221-
with_margin : bool, optional, default: False
221+
with_margin : bool, default: False
222222
If False, the form elements reach to the border of the widget.
223223
This is the desired behavior if the FormWidget is used as a widget
224224
alongside with other widgets such as a QComboBox, which also do

‎lib/matplotlib/collections.py

Copy file name to clipboardExpand all lines: lib/matplotlib/collections.py
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1299,7 +1299,7 @@ def __init__(self, segments, # Can be None.
12991299
antialiaseds : sequence, optional
13001300
A sequence of ones or zeros.
13011301
1302-
linestyles : str or tuple, optional
1302+
linestyles : str or tuple, default: 'solid'
13031303
Either one of {'solid', 'dashed', 'dashdot', 'dotted'}, or
13041304
a dash tuple. The dash tuple is::
13051305

‎lib/matplotlib/colors.py

Copy file name to clipboardExpand all lines: lib/matplotlib/colors.py
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1955,7 +1955,7 @@ def blend_hsv(self, rgb, intensity, hsv_max_sat=None, hsv_max_val=None,
19551955
An MxNx3 RGB array of floats ranging from 0 to 1 (color image).
19561956
intensity : ndarray
19571957
An MxNx1 array of floats ranging from 0 to 1 (grayscale image).
1958-
hsv_max_sat : number, optional, default: 1
1958+
hsv_max_sat : number, default: 1
19591959
The maximum saturation value that the *intensity* map can shift the
19601960
output image to. Defaults to 1.
19611961
hsv_min_sat : number, optional

‎lib/matplotlib/markers.py

Copy file name to clipboardExpand all lines: lib/matplotlib/markers.py
+3-3Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -213,11 +213,11 @@ def __init__(self, marker=None, fillstyle=None):
213213
214214
Parameters
215215
----------
216-
marker : str or array-like, optional, default: None
216+
marker : str or array-like, default: None
217217
See the descriptions of possible markers in the module docstring.
218218
219-
fillstyle : str, optional, default: 'full'
220-
'full', 'left", 'right', 'bottom', 'top', 'none'
219+
fillstyle : str, default: 'full'
220+
One of 'full', 'left", 'right', 'bottom', 'top', 'none'.
221221
"""
222222
self._marker_function = None
223223
self.set_fillstyle(fillstyle)

‎lib/matplotlib/mlab.py

Copy file name to clipboardExpand all lines: lib/matplotlib/mlab.py
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -640,7 +640,7 @@ def _single_spectrum_helper(
640640
choose one of the functions: 'none' calls `.detrend_none`. 'mean' calls
641641
`.detrend_mean`. 'linear' calls `.detrend_linear`.
642642
643-
scale_by_freq : bool, optional, default: True
643+
scale_by_freq : bool, default: True
644644
Whether the resulting density values should be scaled by the scaling
645645
frequency, which gives density in units of Hz^-1. This allows for
646646
integration over the returned frequency values. The default is True for
@@ -850,7 +850,7 @@ def specgram(x, NFFT=None, Fs=None, detrend=None, window=None,
850850
noverlap : int, optional
851851
The number of points of overlap between blocks. The default
852852
value is 128.
853-
mode : str, optional, default: 'psd'
853+
mode : str, default: 'psd'
854854
What sort of spectrum to use:
855855
'psd'
856856
Returns the power spectral density.

‎lib/matplotlib/patches.py

Copy file name to clipboardExpand all lines: lib/matplotlib/patches.py
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1386,7 +1386,7 @@ def __init__(self, xy, width, height, angle=0, **kwargs):
13861386
Total length (diameter) of horizontal axis.
13871387
height : float
13881388
Total length (diameter) of vertical axis.
1389-
angle : scalar, optional
1389+
angle : float, default: 0
13901390
Rotation in degrees anti-clockwise.
13911391
13921392
Notes
@@ -1579,7 +1579,7 @@ def __init__(self, xy, width, height, angle=0.0,
15791579
angle : float
15801580
Rotation of the ellipse in degrees (counterclockwise).
15811581
1582-
theta1, theta2 : float, optional
1582+
theta1, theta2 : float, default: 0, 360
15831583
Starting and ending angles of the arc in degrees. These values
15841584
are relative to *angle*, e.g. if *angle* = 45 and *theta1* = 90
15851585
the absolute starting angle is 135.

‎lib/matplotlib/projections/polar.py

Copy file name to clipboardExpand all lines: lib/matplotlib/projections/polar.py
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1069,7 +1069,7 @@ def set_theta_zero_location(self, loc, offset=0.0):
10691069
loc : str
10701070
May be one of "N", "NW", "W", "SW", "S", "SE", "E", or "NE".
10711071
1072-
offset : float, optional
1072+
offset : float, default: 0
10731073
An offset in degrees to apply from the specified *loc*. **Note:**
10741074
this offset is *always* applied counter-clockwise regardless of
10751075
the direction setting.

‎lib/matplotlib/transforms.py

Copy file name to clipboardExpand all lines: lib/matplotlib/transforms.py
+2-2Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -858,7 +858,7 @@ def update_from_path(self, path, ignore=None, updatex=True, updatey=True):
858858
- when ``False``, include the existing bounds of the `Bbox`.
859859
- when ``None``, use the last value passed to :meth:`ignore`.
860860
861-
updatex, updatey : bool, optional
861+
updatex, updatey : bool, default: True
862862
When ``True``, update the x/y values.
863863
"""
864864
if ignore is None:
@@ -895,7 +895,7 @@ def update_from_data_xy(self, xy, ignore=None, updatex=True, updatey=True):
895895
- When ``False``, include the existing bounds of the `Bbox`.
896896
- When ``None``, use the last value passed to :meth:`ignore`.
897897
898-
updatex, updatey : bool, optional
898+
updatex, updatey : bool, default: True
899899
When ``True``, update the x/y values.
900900
"""
901901
if len(xy) == 0:

‎lib/matplotlib/widgets.py

Copy file name to clipboardExpand all lines: lib/matplotlib/widgets.py
+1-1Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2482,7 +2482,7 @@ class PolygonSelector(_SelectorWidget):
24822482
When a polygon is completed or modified after completion,
24832483
the *onselect* function is called and passed a list of the vertices as
24842484
``(xdata, ydata)`` tuples.
2485-
useblit : bool, optional
2485+
useblit : bool, default: False
24862486
lineprops : dict, default: \
24872487
``dict(color='k', linestyle='-', linewidth=2, alpha=0.5)``.
24882488
Artist properties for the line representing the edges of the polygon.

‎lib/mpl_toolkits/axes_grid1/anchored_artists.py

Copy file name to clipboardExpand all lines: lib/mpl_toolkits/axes_grid1/anchored_artists.py
+30-30Lines changed: 30 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -42,16 +42,16 @@ def __init__(self, width, height, xdescent, ydescent,
4242
'upper center' : 9,
4343
'center' : 10
4444
45-
pad : float, optional, default: 0.4
45+
pad : float, default: 0.4
4646
Padding around the child objects, in fraction of the font size.
4747
48-
borderpad : float, optional, default: 0.5
48+
borderpad : float, default: 0.5
4949
Border padding, in fraction of the font size.
5050
5151
prop : `matplotlib.font_manager.FontProperties`, optional
5252
Font property used as a reference for paddings.
5353
54-
frameon : bool, optional, default: True
54+
frameon : bool, default: True
5555
If True, draw a box around this artists.
5656
5757
**kwargs
@@ -113,16 +113,16 @@ def __init__(self, transform, loc,
113113
'upper center' : 9,
114114
'center' : 10
115115
116-
pad : float, optional, default: 0.4
116+
pad : float, default: 0.4
117117
Padding around the child objects, in fraction of the font size.
118118
119-
borderpad : float, optional, default: 0.5
119+
borderpad : float, default: 0.5
120120
Border padding, in fraction of the font size.
121121
122122
prop : `matplotlib.font_manager.FontProperties`, optional
123123
Font property used as a reference for paddings.
124124
125-
frameon : bool, optional, default: True
125+
frameon : bool, default: True
126126
If True, draw a box around this artists.
127127
128128
**kwargs
@@ -190,10 +190,10 @@ def __init__(self, transform, width, height, angle, loc,
190190
Padding around the ellipse, in fraction of the font size. Defaults
191191
to 0.1.
192192
193-
borderpad : float, optional, default: 0.1
193+
borderpad : float, default: 0.1
194194
Border padding, in fraction of the font size.
195195
196-
frameon : bool, optional, default: True
196+
frameon : bool, default: True
197197
If True, draw a box around the ellipse.
198198
199199
prop : `matplotlib.font_manager.FontProperties`, optional
@@ -254,27 +254,27 @@ def __init__(self, transform, size, label, loc,
254254
'upper center' : 9,
255255
'center' : 10
256256
257-
pad : float, optional, default: 0.1
257+
pad : float, default: 0.1
258258
Padding around the label and size bar, in fraction of the font
259259
size.
260260
261-
borderpad : float, optional, default: 0.1
261+
borderpad : float, default: 0.1
262262
Border padding, in fraction of the font size.
263263
264-
sep : float, optional, default: 2
264+
sep : float, default: 2
265265
Separation between the label and the size bar, in points.
266266
267-
frameon : bool, optional, default: True
267+
frameon : bool, default: True
268268
If True, draw a box around the horizontal bar and label.
269269
270-
size_vertical : float, optional, default: 0
270+
size_vertical : float, default: 0
271271
Vertical length of the size bar, given in coordinates of
272272
*transform*.
273273
274-
color : str, optional, default: 'black'
274+
color : str, default: 'black'
275275
Color for the size bar and label.
276276
277-
label_top : bool, optional, default: False
277+
label_top : bool, default: False
278278
If True, the label will be over the size bar.
279279
280280
fontproperties : `matplotlib.font_manager.FontProperties`, optional
@@ -381,13 +381,13 @@ def __init__(self, transform, label_x, label_y, length=0.15,
381381
label_x, label_y : str
382382
Label text for the x and y arrows
383383
384-
length : float, optional, default: 0.15
384+
length : float, default: 0.15
385385
Length of the arrow, given in coordinates of *transform*.
386386
387-
fontsize : float, optional, default: 0.08
387+
fontsize : float, default: 0.08
388388
Size of label strings, given in coordinates of *transform*.
389389
390-
loc : int, optional, default: 2
390+
loc : int, default: 2
391391
Location of the direction arrows. Valid location codes are::
392392
393393
'upper right' : 1,
@@ -401,45 +401,45 @@ def __init__(self, transform, label_x, label_y, length=0.15,
401401
'upper center' : 9,
402402
'center' : 10
403403
404-
angle : float, optional, default: 0
404+
angle : float, default: 0
405405
The angle of the arrows in degrees.
406406
407-
aspect_ratio : float, optional, default: 1
407+
aspect_ratio : float, default: 1
408408
The ratio of the length of arrow_x and arrow_y.
409409
Negative numbers can be used to change the direction.
410410
411-
pad : float, optional, default: 0.4
411+
pad : float, default: 0.4
412412
Padding around the labels and arrows, in fraction of the font size.
413413
414-
borderpad : float, optional, default: 0.4
414+
borderpad : float, default: 0.4
415415
Border padding, in fraction of the font size.
416416
417-
frameon : bool, optional, default: False
417+
frameon : bool, default: False
418418
If True, draw a box around the arrows and labels.
419419
420-
color : str, optional, default: 'white'
420+
color : str, default: 'white'
421421
Color for the arrows and labels.
422422
423-
alpha : float, optional, default: 1
423+
alpha : float, default: 1
424424
Alpha values of the arrows and labels
425425
426-
sep_x, sep_y : float, optional, default: 0.01 and 0 respectively
426+
sep_x, sep_y : float, default: 0.01 and 0 respectively
427427
Separation between the arrows and labels in coordinates of
428428
*transform*.
429429
430430
fontproperties : `matplotlib.font_manager.FontProperties`, optional
431431
Font properties for the label text.
432432
433-
back_length : float, optional, default: 0.15
433+
back_length : float, default: 0.15
434434
Fraction of the arrow behind the arrow crossing.
435435
436-
head_width : float, optional, default: 10
436+
head_width : float, default: 10
437437
Width of arrow head, sent to ArrowStyle.
438438
439-
head_length : float, optional, default: 15
439+
head_length : float, default: 15
440440
Length of arrow head, sent to ArrowStyle.
441441
442-
tail_width : float, optional, default: 2
442+
tail_width : float, default: 2
443443
Width of arrow tail, sent to ArrowStyle.
444444
445445
text_props, arrow_props : dict

‎lib/mpl_toolkits/axes_grid1/inset_locator.py

Copy file name to clipboardExpand all lines: lib/mpl_toolkits/axes_grid1/inset_locator.py
+4-4Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -408,7 +408,7 @@ def inset_axes(parent_axes, width, height, loc='upper right',
408408
are relative to the parent_axes. Otherwise they are to be understood
409409
relative to the bounding box provided via *bbox_to_anchor*.
410410
411-
loc : int or str, optional, default: 1
411+
loc : int or str, default: 1
412412
Location to place the inset axes. The valid locations are::
413413
414414
'upper right' : 1,
@@ -455,7 +455,7 @@ def inset_axes(parent_axes, width, height, loc='upper right',
455455
456456
%(Axes)s
457457
458-
borderpad : float, optional, default: 0.5
458+
borderpad : float, default: 0.5
459459
Padding between inset axes and the bbox_to_anchor.
460460
The units are axes font size, i.e. for a default font size of 10 points
461461
*borderpad = 0.5* is equivalent to a padding of 5 points.
@@ -527,7 +527,7 @@ def zoomed_inset_axes(parent_axes, zoom, loc='upper right',
527527
coordinates (i.e., "zoomed in"), while *zoom* < 1 will shrink the
528528
coordinates (i.e., "zoomed out").
529529
530-
loc : int or str, optional, default: 'upper right'
530+
loc : int or str, default: 'upper right'
531531
Location to place the inset axes. The valid locations are::
532532
533533
'upper right' : 1,
@@ -573,7 +573,7 @@ def zoomed_inset_axes(parent_axes, zoom, loc='upper right',
573573
574574
%(Axes)s
575575
576-
borderpad : float, optional, default: 0.5
576+
borderpad : float, default: 0.5
577577
Padding between inset axes and the bbox_to_anchor.
578578
The units are axes font size, i.e. for a default font size of 10 points
579579
*borderpad = 0.5* is equivalent to a padding of 5 points.

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.