ANN: matplotlib website 1.0

Wow! The new site looks beautiful. Thank you!

The apparent lack of searchable, online, well organized, cross-referenced documentation has been my main frustration with Matplotlib. I’m very glad it’s being worked on.

A couple of quick things:

First, are there plans to eventually embed autogenerated plots in the the “examples” section (http://matplotlib.sourceforge.net/examples/)) in the same way that they’re embedded within the user guide?

Second, in the sidebar on the main page, in the “Need Help?” section, I’m seeing a bunch of weird gunk that’s probably not supposed to be getting through to the web…:

<<<<<<< .mine <<<<<<< .mine

Check the docs, the faq, and join the matplotlib mailing lists. There is a also community wiki cookbook

···

=======

Check the user guide, the

Check the user guide, the >>>>>> .r6222 href=“faq/index.html”>faq, the api docs, archives, and join the matplotlib mailing lists >>>>>>> .r6221

You can file bugs, patches and feature requests on the sourceforge tracker, but it is a good idea to ping us on the mailing list too.

Zane Selvans

Amateur Earthling

zane@…1923…

303/815-6866

http://zaneselvans.org

PGP Key: 55E0815F

Zane Selvans wrote:

Wow! The new site looks beautiful. Thank you!

The apparent lack of searchable, online, well organized, cross-referenced documentation has been my main frustration with Matplotlib. I'm very glad it's being worked on.

A couple of quick things:

First, are there plans to eventually embed autogenerated plots in the the "examples" section (http://matplotlib.sourceforge.net/examples/) <http://matplotlib.sourceforge.net/examples/)> in the same way that they're embedded within the user guide?

There are plans to do that, and probably to have a "thumbnail gallery" of examples as well. The sticking point is that many of the examples generate multiple figures, and we currently don't have a way to save those out automatically from the documentation. Just need to make that work.

Second, in the sidebar on the main page, in the "Need Help?" section, I'm seeing a bunch of weird gunk that's probably not supposed to be getting through to the web...:

<<<<<<< .mine <<<<<<< .mine

Check the docs, the faq, and join the matplotlib mailing lists. There is a also community wiki cookbook

Check the user guide, the

Check the user guide, the >>>>>> .r6222 href="faq/index.html">faq, the api docs, archives, and join the matplotlib mailing lists >>>>>>> .r6221

You can file bugs, patches and feature requests on the sourceforge tracker, but it is a good idea to ping us on the mailing list too.

That seems to have been fixed in the meantime. Still seeing it?

Cheers,
Mike

···

--
Michael Droettboom
Science Software Branch
Operations and Engineering Division
Space Telescope Science Institute
Operated by AURA for NASA

First, are there plans to eventually embed autogenerated plots in the the “examples” section (http://matplotlib.sourceforge.net/examples/) <http://matplotlib.sourceforge.net/examples/%29> in the same way that they’re embedded within the user guide?
There are plans to do that, and probably to have a “thumbnail gallery” of examples as well. The sticking point is that many of the examples generate multiple figures, and we currently don’t have a way to save those out automatically from the documentation. Just need to make that work.

A thumbnail gallery of all the examples in the User’s Guide and Examples is a great idea!

Plots are inherently visual, and humans have a huge amount of built-in visual processing power. Searching a even an enormous page of images to find something that looks like what you’re trying to create will be much more efficient that trying to come up with the right keyword if you don’t know what it is already, or scanning a table of contents.

Actually, it reminds me of the “graphical abstracts” that many chemistry journals use - one figure, often showing the molecule(s) that the paper is about, which readers can browse online in lieu of searching or reading long ISO approved chemical names… which often allows almost instant recognition of papers you’ll be interested in, or at least a serious pruning of the search space.

Second, in the sidebar on the main page, in the “Need Help?” section, I’m seeing a bunch of weird gunk that’s probably not supposed to be getting through to the web…:

That seems to have been fixed in the meantime. Still seeing it?

Yep, looks good.

Thanks for all your work!

···

Zane Selvans

Amateur Earthling

zane@…1923…

303/815-6866

http://zaneselvans.org

PGP Key: 55E0815F

Thanks to all for the suggestions. It took us a little longer than
expected, but Michael and I have put together a pretty useful
thumbnail and examples gallery. The thumbnails are generated by
matplotlib from all the code in the examples directory, including
those that generate multiple images. Click on any thumbnail and
you'll be taken to a page for that example which has the full
resolution image, syntax highlighted source code, and link to the
source for download. Because the images and thumbnails are generated
"live" from the source, they are more or less guaranteed to work, at
least with the version of mpl we used to build the docs (typically svn
HEAD).

  http://matplotlib.sourceforge.net/gallery.html

And the full text of the examples are searchable from the search tool -- see

  http://matplotlib.sourceforge.net/faq/howto_faq.html#search-examples

JDH

···

On Fri, Oct 17, 2008 at 12:37 PM, Zane Selvans <zane@...1923...> wrote:

A thumbnail gallery of all the examples in the User's Guide and Examples is
a great idea!
Plots are inherently visual, and humans have a huge amount of built-in
visual processing power. Searching a even an enormous page of images to
find something that looks like what you're trying to create will be much
more efficient that trying to come up with the right keyword if you don't
know what it is already, or scanning a table of contents.

Michael and John,
this is really fantastic !!
thanks,
Stef

John Hunter wrote:

···

On Fri, Oct 17, 2008 at 12:37 PM, Zane Selvans <zane@...1923...> wrote:

A thumbnail gallery of all the examples in the User's Guide and Examples is
a great idea!
Plots are inherently visual, and humans have a huge amount of built-in
visual processing power. Searching a even an enormous page of images to
find something that looks like what you're trying to create will be much
more efficient that trying to come up with the right keyword if you don't
know what it is already, or scanning a table of contents.
    
Thanks to all for the suggestions. It took us a little longer than
expected, but Michael and I have put together a pretty useful
thumbnail and examples gallery. The thumbnails are generated by
matplotlib from all the code in the examples directory, including
those that generate multiple images. Click on any thumbnail and
you'll be taken to a page for that example which has the full
resolution image, syntax highlighted source code, and link to the
source for download. Because the images and thumbnails are generated
"live" from the source, they are more or less guaranteed to work, at
least with the version of mpl we used to build the docs (typically svn
HEAD).

  http://matplotlib.sourceforge.net/gallery.html

And the full text of the examples are searchable from the search tool -- see

  http://matplotlib.sourceforge.net/faq/howto_faq.html#search-examples

JDH

-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Matplotlib-users mailing list
Matplotlib-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-users