#2100: sensible defaults for aspect ratio
---------------------------+------------------------------------------------
Reporter: jason | Owner: was
Type: enhancement | Status: needs_review
Priority: major | Milestone: sage-4.6
Component: graphics | Keywords:
Author: Jason Grout | Upstream: N/A
Reviewer: | Merged:
Work_issues: |
---------------------------+------------------------------------------------
Old description:
> We have two concepts of "aspect ratio" that we'd like to expose to the
> user.
>
> * Figure aspect ratio -- controls the final image size, including any
> text labels, etc. This will be set using the following options:
> * figsize
> * single number - use this as a base size for fig_aspect_ratio
> calculations (i.e., bigger numbers = bigger figures)
> * two numbers - an actual figure size in inches
> * None - use the default size
> * fit_tight
> * if True, clip or extend the resulting figure to the plot objects
> (so the resulting figure will probably not have figsize dimensions
> * if False, the resulting figure has exactly figsize dimensions, but
> items in the plot may be clipped or there may be excessive padding around
> drawn objects
> * Pixel aspect ratio
> * aspect_ratio -- the aspect ratio of a pixel in the image (or of a
> unit square in data coordinates, for example). The default here will
> change depending on the type of plot
> * 'equal' or 1 -- square pixels. This will be the default for most
> things
> * 'auto' -- plot the given data limits in the given (or computed)
> figsize, filling the figure
> * number -- ratio of height to width.
> * aspect_ratio_adjust -- what should we adjust to achieve the desired
> aspect ratio for the items drawn? Note that by default, the axes limits
> are enlarged slightly; to eliminate this, set axes_pad=0
> * 'box' (default) -- the frame axes
> * 'datalim' -- the data limits
New description:
We have two concepts of "aspect ratio" that we'd like to expose to the
user.
This patch exposes the following behavior:
{{{
* Figure aspect ratio -- controls the final image size, including any
text labels, etc. This will be set using the following options:
o figsize
+ single number - use this as a base size for the width of
the figure canvas
+ two numbers - an actual figure size in inches
+ None - use the default size in Matplotlib
o fit_tight
+ if True, clip or extend the resulting figure to the plot
objects (so the resulting figure will probably not have figsize dimensions
+ if False, the resulting figure has exactly figsize
dimensions, but items in the plot may be clipped or there may be excessive
padding around drawn objects
* Pixel aspect ratio
o aspect_ratio -- the ratio height/width for a unit square
+ 'equal' or 1 -- a unit square appears to have equal
height and width. This will be the default for Graphics objects (so if a
default is not explicitly set, the default is this.)
+ 'auto' -- plot the given data limits in the given (or
computed) figsize, filling the figure (default for plot and list_plot)
+ number -- ratio of height to width.
}}}
--
Comment(by jason):
Updating description to reflect changes in the patch.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/2100#comment:18>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
