#2100: sensible defaults for aspect ratio
---------------------------+------------------------------------------------
   Reporter:  jason        |       Owner:  was     
       Type:  enhancement  |      Status:  new     
   Priority:  major        |   Milestone:  sage-4.6
  Component:  graphics     |    Keywords:          
     Author:               |    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:
>    * fig_aspect_ratio
>      * number - make an image with the specified aspect ratio (within
> reason) using the figaspect matplotlib function (which tries to be
> marginally smart, which actually may be a dumb thing to do...)
>      * None (default) - use bbox_inches='tight' to create a figure that
> holds the drawn objects
>    * 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
>  * 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 width to height (or height to width; I can't
> remember).  For plot() and list_plot(), this will default to giving a
> golden ratio aspect ratio
>    * 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.

  * 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

--

Comment(by jason):

 Update the proposal.

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