#2100: sensible defaults for aspect ratio
-------------------------------------------------------+--------------------
   Reporter:  jason                                    |       Owner:  was      
   
       Type:  enhancement                              |      Status:  
needs_review
   Priority:  major                                    |   Milestone:  
sage-4.6.2  
  Component:  graphics                                 |    Keywords:           
   
     Author:  Jason Grout, Karl-Dieter Crisman         |    Upstream:  N/A      
   
   Reviewer:  Andrey Novoseltsev, Karl-Dieter Crisman  |      Merged:           
   
Work_issues:  unify option names                       |  
-------------------------------------------------------+--------------------
Changes (by kcrisman):

  * status:  needs_work => needs_review


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

 Apply trac_2100-aspect-ratio-rebase.patch and trac_2100-auto-automatic-
 and-vector.patch for this.

--

Comment:

 This should all work fine now.  I do want to point out that the standard
 plots seem to have increased somewhat in size.  The new reviewer patch is
 now different enough that it needs review.  Please do so now to avoid
 bitrot!

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