units¶
-
units
(value, dest='in', axes=None, figure=None, width=True)[source]¶ Convert values and lists of values between arbitrary physical units. This is used internally all over ProPlot, permitting flexible units for various keyword arguments.
- Parameters
value (float or str or list thereof) – A size specifier or list thereof. If numeric, nothing is done. If string, it is converted to the units
dest
. The string should look like'123.456unit'
, where the number is the magnitude and'unit'
is one of the following.Key
Description
'm'
Meters
'dm'
Decimeters
'cm'
Centimeters
'mm'
Millimeters
'yd'
Yards
'ft'
Feet
'in'
Inches
'pt'
Points (1/72 inches)
'pc'
Pica (1/6 inches)
'px'
Pixels on screen, using dpi of
rc[‘figure.dpi’]
'pp'
Pixels once printed, using dpi of
rc[‘savefig.dpi’]
'em'
'en'
'Em'
'En'
'ax'
Axes-relative units (not always available)
'fig'
Figure-relative units (not always available)
'ly'
Light years ;)
dest (str, optional) – The destination units. Default is inches, i.e.
'in'
.axes (
Axes
, optional) – The axes to use for scaling units that look like'0.1ax'
.figure (
Figure
, optional) – The figure to use for scaling units that look like'0.1fig'
. IfNone
we try to get the figure fromaxes.figure
.width (bool, optional) – Whether to use the width or height for the axes and figure relative coordinates.