#2100: sensible defaults for aspect ratio
--------------------------------------+-------------------------------------
   Reporter:  jason                   |       Owner:  was       
       Type:  enhancement             |      Status:  needs_work
   Priority:  major                   |   Milestone:  sage-4.6.2
  Component:  graphics                |    Keywords:            
     Author:  Jason Grout             |    Upstream:  N/A       
   Reviewer:  Andrey Novoseltsev      |      Merged:            
Work_issues:  complete documentation  |  
--------------------------------------+-------------------------------------
Description changed by kcrisman:

Old 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.
> }}}

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
                 + 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.
 }}}

--

-- 
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/2100#comment:27>
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.

Reply via email to