# Goals and status This file is processed by convert.py to generate
#the goals web page.  Format is that goal entries in the table follow
#a line that contains only asterisks; first block is the description
#of the goal (should be brief as possible; second block is the
#status--it is recommended that goals recently finished say Done
#(release number with a link to the release notes for that release for
#the details); the third block is for any comments or associated
#information. The blocks are separated by blank lines. Blocks 2 and 3
#are optional.  lines starting with # are ignored.



==========================================================================
Plot Functionality
###################
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Math text
*******************
Support special symbols

mostly done

Many of the standard TeX symbols are already defined (see <a
href=matplotlib.mathtext.html>mathtext</a>).  The framework for adding
composite symbols is in place, eg \angstrom is defined.  Additional
symbols will be added on as as needed bassis, so speak up!  These
improvements appeared in <a href="whats_new.html#0.54-Enhanced_mathtext">matplotlib-0.54</a>.

*******************
Postscript support

done

Paul Barrett has completed the port of mathtext to postscript.  This
work also includes the support of arbitrary truetype fonts in PS
figures so text appears the same in agg and ps backends.


*******************
SVG support

not started

*******************
Parser fixes

mostly done

Over/under subscripts now work, recursive sub/superscipts are
supported if you do x_i_{j}, note the extra curlys; fixed in <a
href="whats_new.html#0.54-Enhanced_mathtext">matplotlib-0.54</a>

*******************
kerning

not started
*******************
rotation

mostly done

Jim Benson contributed a patch for vertical mathtext for *Agg, which
was ported to backend_gtk.  Paul Barrett provided arbitrary rotation
of mathtext for PS

*******************
sqrt overlines

not started
*******************
add spacing commands

done

added \/ the small space command and \hspace{frac} where frac is a
space determined by a fraction of the point size; added in <a
href="whats_new.html#0.54-Enhanced_mathtext">matplotlib-0.54</a>

*******************
embedded mathtext

not started

Currently a string is all mathtext or None.  To get roman fonts in a
mathtext string you can use \rm.  Ideally, we could embed mathtext
expressions in a regular string, ie, strings like <tt>r"Rate constant
$5\lambda$"</tt>

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Regular text
*******************
Relative font sizes

done

This will allow specification of a font size relative to
an existing font rather than in absolute terms, which will 
make scaling all fonts within a plot simpler.

*******************
Newline separated text and arbitrary rotations

done


Properly aligned newline separated text works across backends.  The
support for arbitrary rotations depends on whether the backend
supports arbitrary rotations (*Agg, PS, GD, Paint do; GTK and WX
support only horizontal and vertical).  Added in <a href="whats_new.html#0.54-Newlines_in_text">matplotlib-0.54</a>.

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Plot types
*******************
Image support

done

AGG support appeared in 
<a href="whats_new.html#0.52-Image_support">
matplotlib-0.52</a>, Postscript image support in 
<a href="whats_new.html#0.53-Ported_image_support_to_numarray_and_postscript_backend">
matplotlib-0.53</a>.
See <a href="matplotlib.matlab.html#-imshow">
imshow</a>
*******************
Polar plots

work underway
*******************
Shared axes

not started

Although it is now possible to have multiple plots share a common
axis, this work would make it easier to create such plots.
*******************
Contour plots

work in progress

*******************
Log histogram

not started
*******************
2-D vector plots

not started

*******************
Full dash control

done

You can set a sequence of on-off ink for dashes in addition to the
preset line styles '--' and '-.'.  Added in <a
href=whats_new.html#0.54-Full_dash_control>matplotlib-0.54</a>.  See
<a href=examples/dash_control.py>dash_control.py</a>.

*******************
Generalize date plots

done

Rewrote the date code to require datetime and thus support a wider
range of date intervals.  Version of matplotlib < 0.63 did not require
datetime and only supported epoch dates (seconds since 1972).  <a
href=whats_new.html#0.63-new_dates_handling>matplotlib-0.63</a>, dates
in the range of 0001-9999 are supported.  See the <a
href=tutorial.html#dates>dates tutorial</a>.

*******************
Bezier curves, paths

not started

*******************
3-D visualization

some proof-of-concept work completed

Most likely based on embedding VTK functionality.  Randy Heiland has
done <a href=http://poincare.uits.iupui.edu/matplot>some basic
work</a> to show how to use VTK with offline rendering in combination
with matplotlib imshow to incorporate 3D but much more work is needed.

*******************
Pie Charts

not started
*******************
Map Projections

some preliminary work

Support standard map projections (e.g., Mercator) as well as allowing
user-defined 2-D coordinate mappings. Jeffrey Whittaker has been
working on a cartographic project module for use with matplotlib.  See
<a href=screenshots.html#plotmap>the plotmap demo</a>.

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Axis autoranging and tick customization
*******************
Error bars included in auto ranging

done

Plots often clip error bars; fixed in <a
href="whats_new.html#0.54-Bug_fix_roundup">matplotlib-0.54</a>.

===========================================================================
GUI Functionality
*******************
Generalized event handling framework

partly done

Provide a standard event handling framework that works with all GUI
back-ends. Some basic event handling, GUI neutral, event handling is
implemented with the <a
href=matplotlib.matlab.html#-mpl_connect>mpl_connect</a> and <a
href=matplotlib.matlab.html#-mpl_disconnect>mpl_disconnect</a>
methods.  See, for example, <a
href=examples/coords_demo.py>coords_demo.py</a>.


*******************
Cursor read function

95% done

Provide a standard function for reading cursor position from a program
either immeditately or based on a specified event (e.g., keypress or
mouse button).  The example <a
href=examples/coords_demo.py>coords_demo.py</a> shows you how to use
GUI callbacks to get the x and y mouse coordinates in display and data
units with the GTK and Tk backend.  Yet to be added is a blocking
function, like x, y = mouse_press(*args)

********************
Solve mainloop issues

some progress

The ultimate goal is to have matplotlib work across IDEs and standard
python shells.  Fernando Perez helped with an important first step, in
releasing a version of <a href=http://ipython.scipy.org>ipython</a>
that works in interactive mode with all of the matplotlib GUIs.

============================================================================
Performance
*******************
Faster Postscript rendering

done

font caching and other changes have significantly improved postscript
performance; fixed in <a href="whats_new.html#0.54-Font_cacheing">matplotlib-0.54</a>

*******************
Faster point and symbol plots

mostly done

A new transformation class and <a
href=matplotlib.collections.html>collections</a> module have
dramatically improved pcolor and scatter plots.  scatter also supports
a variety of different markers - currently regular polygons but this
will soon be expanded.  For large scatter plots (eg 50,000 markers),
performance is 10x faster in <a href="whats_new.html#0.54-New_scatter_plots">matplotlib-0.54</a>.

********************
Faster math text

done

Mathtext performance improved 5x in <a
href="whats_new.html#0.62-Faster-mathtext">matplotlib-0.61</a>.
Thanks to Paul Mcguire for fixes both to pyparsing and to the
matplotlib grammar!

============================================================================
Documentation
*******************
Fixed and non-fixed interfaces

not started

Provide a guide to users as to what parts of matplotlib should
not change and what parts may still change.
============================================================================
User Interface
*******************
Use of Traits package

uncertain

Allows validation of user-supplied plotting parameters
============================================================================
Backends
*******************
Various WX improvements and fixes

mostly done

Jeremy fixed the known wx bugs relating to tooltips and the close
button button not returning the interpreter in <a
href="whats_new.html#0.54-Bug_fix_roundup">matplotlib-0.54</a>.
Jeremy, the author and maintainer of the wx backend, no longer has the
time to fully maintain the wx backend, though he continues to work on
it.  So we are looking for someone to help maintain the wx and wxagg
backends.

*******************
PDF backend

not started
*******************
SVG backend

almost done 

Jared Wahlstrand wrote the SVG backend.  As of <a
href="whats_new.html#0.61-svg_fixes">matplotlib-0.61</a> svg has fast
rendering, good layout, image support and font support.  Remaining is
mathtext for svg.

*******************
Paint clipping problems

very low priority

The problem resides in the underlying libart package (which
sees little maintenance).
*******************
GD color allocation

very low priority