Changes between Version 11 and Version 12 of Ticket #2100


Ignore:
Timestamp:
10/01/10 02:01:28 (9 years ago)
Author:
jason
Comment:

Update the proposal.

Legend:

Unmodified
Added
Removed
Modified
  • Ticket #2100 – Description

    v11 v12  
    11We have two concepts of "aspect ratio" that we'd like to expose to the user.
    22
    3 
    4  * Figure aspect ratio -- controls the final image size, including  any text labels, etc.  This will be set using the following options:
    5    * fig_aspect_ratio
    6      * 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...)
    7      * None (default) - use bbox_inches='tight' to create a figure that holds the drawn objects
     3 * Figure aspect ratio -- controls the final image size, including  any text labels, etc.  This will be set using the following options:
    84   * figsize
    95     * single number - use this as a base size for fig_aspect_ratio calculations (i.e., bigger numbers = bigger figures)
    106     * two numbers - an actual figure size in inches
    117     * None - use the default size
     8   * fit_tight
     9     * if True, clip or extend the resulting figure to the plot objects (so the resulting figure will probably not have figsize dimensions
     10     * 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
    1211 * Pixel aspect ratio
    13    * 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
    14      * 'equal' or 1 -- square pixels.  This will be the default for most things
     12   * 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
     13     * 'equal' or 1 -- square pixels.  This will be the default for most things
    1514     * 'auto' -- plot the given data limits in the given (or computed) figsize, filling the figure
    16      * 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
    17    * 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
     15     * number -- ratio of height to width.
     16   * 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
    1817     * 'box' (default) -- the frame axes
    1918     * 'datalim' -- the data limits