Matplotlib gallery

I will never get use to reply-all

···

---------- Forwarded message ----------
From: <josef.pktd@...287...>
Date: Thu, Feb 23, 2012 at 11:31 AM
Subject: Re: [Matplotlib-users] Matplotlib gallery
To: Nicolas Rougier <Nicolas.Rougier@...3782...>

On Thu, Feb 23, 2012 at 11:24 AM, Nicolas Rougier <Nicolas.Rougier@...3782...> wrote:

I agree, but the current matplotlib gallery is rather clueless about what the examples are related to until you click an image. I'm personally using the gallery by looking at an example that match what I've in mind most closely and then look at the code. But you're right, some structure(s) would definitely help.

Here is an example of a well structured gallery: http://www.gigawiz.com/aagraphs.html.

The first-level structure is organized at:

Specialized Scientific Graphing
Scatter Graphs
Contour Charts (2-D, 3-D, and Ternary)
Heatmaps
Voronoi Diagram
Waterfall Charts
Bubble Charts
Spider Charts
Polar Charts
Column and Bar Charts
Area Charts
Line Charts
Combination Charts (Column-Line, Bar-Line, Area-Line)
Diagrams of Multiple, Independent Value-Axes Column, Bar or Area Graphs
High-Low, (Open)-High-Low-Close, and Range Charts
Pie Charts and X-Y Scatter Pie
Vector Charts
Statistical Charts

Maybe we can find/agree on similar structure(s)/sub-structure(s) and adapt it to the current gallery ?

An advantage of the current all in one page gallery is that it is
easier to find a recipe when I just look for individual plot elements,
when I have not much idea what it might be called and just some idea
what it should look like.

That's different from looking for plots with a specific usage or content.

Josef

Nicolas

On Feb 23, 2012, at 16:59 , Jerzy Karczmarczuk wrote:

Nicolas Rougier :

I've seen the discussion around the re-organization of the matplotlib gallery.
If that might help, here is a link to a small gallery I made.

The overall organization is simply based on subdirectories so maybe it could be a (temporary) solution for the matplotlib gallery (just matter of moving examples in the right subdirectory).

THANKS, Nicolas.

This is a nice initiative, but I believe that in the context of a
presentation of some software, this is not the way I would have chosen.
Why people look-up /such/ galleries? Why I do it myself? What are the
needs of my students (about 20 - 30 guys who work with matplotlib week
after wek)?

Often because I want to find a concrete program, which answers a
concrete question : how to implement timed animations. How to make
multiple plots. How to insert a figure in a GUI with widgets, how to
distort an image matrix, etc. etc. So a gallery should contains infos
about what the hell the example XYZ is about, what does it show, where
is the *concrete* documentation page with the description of the tools
used, etc.

The order of examples should be rational, and as ALWAYS some cross-links
would be useful.
Program-sources without comments are not so useful...

==

But I believe that this is just a start, and I am aware that to
criticize is easier than to do something. (Je suis un grognon né,
Nicolas, désolé...). So please, continue, my heart is with you!

Jerzy Karczmarczuk
Caen, France.

------------------------------------------------------------------------------
Virtualization & Cloud Management Using Capacity Planning
Cloud computing makes use of virtualization - but cloud computing
also focuses on allowing computing to be delivered as a service.
http://www.accelacomm.com/jaw/sfnl/114/51521223/
_______________________________________________
Matplotlib-users mailing list
Matplotlib-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-users

------------------------------------------------------------------------------
Virtualization & Cloud Management Using Capacity Planning
Cloud computing makes use of virtualization - but cloud computing
also focuses on allowing computing to be delivered as a service.
http://www.accelacomm.com/jaw/sfnl/114/51521223/
_______________________________________________
Matplotlib-users mailing list
Matplotlib-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-users

I will never get use to reply-all

From: <josef.pktd@…287…>

Date: Thu, Feb 23, 2012 at 11:31 AM

Subject: Re: [Matplotlib-users] Matplotlib gallery

To: Nicolas Rougier <Nicolas.Rougier@…3782…>

I agree, but the current matplotlib gallery is rather clueless about what the examples are related to until you click an image. I’m personally using the gallery by looking at an example that match what I’ve in mind most closely and then look at the code. But you’re right, some structure(s) would definitely help.

Here is an example of a well structured gallery: http://www.gigawiz.com/aagraphs.html.

The first-level structure is organized at:

Specialized Scientific Graphing

Scatter Graphs

Contour Charts (2-D, 3-D, and Ternary)

Heatmaps

Voronoi Diagram

Waterfall Charts

Bubble Charts

Spider Charts

Polar Charts

Column and Bar Charts

Area Charts

Line Charts

Combination Charts (Column-Line, Bar-Line, Area-Line)

Diagrams of Multiple, Independent Value-Axes Column, Bar or Area Graphs

High-Low, (Open)-High-Low-Close, and Range Charts

Pie Charts and X-Y Scatter Pie

Vector Charts

Statistical Charts

Maybe we can find/agree on similar structure(s)/sub-structure(s) and adapt it to the current gallery ?

An advantage of the current all in one page gallery is that it is

easier to find a recipe when I just look for individual plot elements,

when I have not much idea what it might be called and just some idea

what it should look like.

That’s different from looking for plots with a specific usage or content.

Josef

You could still have a one-page gallery with plots separated into subheadings (and a table of contents at the top which allows you to jump to subheadings). This alone would greatly improve navigation in the gallery. The list of headings is great, by the way.

-Tony

···

On Thu, Feb 23, 2012 at 11:32 AM, <josef.pktd@…985…> wrote:

---------- Forwarded message ----------
On Thu, Feb 23, 2012 at 11:24 AM, Nicolas Rougier > > <Nicolas.Rougier@…3994…> wrote:

Nicolas

On Feb 23, 2012, at 16:59 , Jerzy Karczmarczuk wrote:

Nicolas Rougier :

I’ve seen the discussion around the re-organization of the matplotlib gallery.

If that might help, here is a link to a small gallery I made.

The overall organization is simply based on subdirectories so maybe it could be a (temporary) solution for the matplotlib gallery (just matter of moving examples in the right subdirectory).

THANKS, Nicolas.

This is a nice initiative, but I believe that in the context of a

presentation of some software, this is not the way I would have chosen.

Why people look-up /such/ galleries? Why I do it myself? What are the

needs of my students (about 20 - 30 guys who work with matplotlib week

after wek)?

Often because I want to find a concrete program, which answers a

concrete question : how to implement timed animations. How to make

multiple plots. How to insert a figure in a GUI with widgets, how to

distort an image matrix, etc. etc. So a gallery should contains infos

about what the hell the example XYZ is about, what does it show, where

is the concrete documentation page with the description of the tools

used, etc.

The order of examples should be rational, and as ALWAYS some cross-links

would be useful.

Program-sources without comments are not so useful…

==

But I believe that this is just a start, and I am aware that to

criticize is easier than to do something. (Je suis un grognon né,

Nicolas, désolé…). So please, continue, my heart is with you!

Jerzy Karczmarczuk

Caen, France.


Virtualization & Cloud Management Using Capacity Planning

Cloud computing makes use of virtualization - but cloud computing

also focuses on allowing computing to be delivered as a service.

http://www.accelacomm.com/jaw/sfnl/114/51521223/


Matplotlib-users mailing list

Matplotlib-users@lists.sourceforge.net

https://lists.sourceforge.net/lists/listinfo/matplotlib-users


Virtualization & Cloud Management Using Capacity Planning

Cloud computing makes use of virtualization - but cloud computing

also focuses on allowing computing to be delivered as a service.

http://www.accelacomm.com/jaw/sfnl/114/51521223/


Matplotlib-users mailing list

Matplotlib-users@lists.sourceforge.net

https://lists.sourceforge.net/lists/listinfo/matplotlib-users


Virtualization & Cloud Management Using Capacity Planning

Cloud computing makes use of virtualization - but cloud computing

also focuses on allowing computing to be delivered as a service.

http://www.accelacomm.com/jaw/sfnl/114/51521223/


Matplotlib-users mailing list

Matplotlib-users@lists.sourceforge.net

https://lists.sourceforge.net/lists/listinfo/matplotlib-users

I am banging out a pull request to do just that.

Ben Root

···

On Thu, Feb 23, 2012 at 10:41 AM, Tony Yu <tsyu80@…1896…> wrote:

On Thu, Feb 23, 2012 at 11:32 AM, <josef.pktd@…287…> wrote:

I will never get use to reply-all

---------- Forwarded message ----------

From: <josef.pktd@…287…>

Date: Thu, Feb 23, 2012 at 11:31 AM

Subject: Re: [Matplotlib-users] Matplotlib gallery

To: Nicolas Rougier <Nicolas.Rougier@…3782…>

On Thu, Feb 23, 2012 at 11:24 AM, Nicolas Rougier > > > > <Nicolas.Rougier@…3782…> wrote:

I agree, but the current matplotlib gallery is rather clueless about what the examples are related to until you click an image. I’m personally using the gallery by looking at an example that match what I’ve in mind most closely and then look at the code. But you’re right, some structure(s) would definitely help.

Here is an example of a well structured gallery: http://www.gigawiz.com/aagraphs.html.

The first-level structure is organized at:

Specialized Scientific Graphing

Scatter Graphs

Contour Charts (2-D, 3-D, and Ternary)

Heatmaps

Voronoi Diagram

Waterfall Charts

Bubble Charts

Spider Charts

Polar Charts

Column and Bar Charts

Area Charts

Line Charts

Combination Charts (Column-Line, Bar-Line, Area-Line)

Diagrams of Multiple, Independent Value-Axes Column, Bar or Area Graphs

High-Low, (Open)-High-Low-Close, and Range Charts

Pie Charts and X-Y Scatter Pie

Vector Charts

Statistical Charts

Maybe we can find/agree on similar structure(s)/sub-structure(s) and adapt it to the current gallery ?

An advantage of the current all in one page gallery is that it is

easier to find a recipe when I just look for individual plot elements,

when I have not much idea what it might be called and just some idea

what it should look like.

That’s different from looking for plots with a specific usage or content.

Josef

You could still have a one-page gallery with plots separated into subheadings (and a table of contents at the top which allows you to jump to subheadings). This alone would greatly improve navigation in the gallery. The list of headings is great, by the way.

-Tony

Just a suggestion. All these ideas sounds like a "google code-in" task.

http://code.google.com/intl/pt-BR/opensource/gci/2010-11/

I do not know if "Matplotlib" participated in the past, if not take a
look of last years sympy task list:
https://github.com/sympy/sympy/wiki/GCI-2011-Task-list

If the ideas for the gallery improvement are break down to some simple
tasks like that you guys could use Google code-in to do it.

-Filipe

···

On Thu, Feb 23, 2012 at 11:46, Benjamin Root <ben.root@...1304...> wrote:

On Thu, Feb 23, 2012 at 10:41 AM, Tony Yu <tsyu80@...287...> wrote:

On Thu, Feb 23, 2012 at 11:32 AM, <josef.pktd@...287...> wrote:

I will never get use to reply-all

---------- Forwarded message ----------
From: <josef.pktd@...287...>
Date: Thu, Feb 23, 2012 at 11:31 AM
Subject: Re: [Matplotlib-users] Matplotlib gallery
To: Nicolas Rougier <Nicolas.Rougier@...3782...>

On Thu, Feb 23, 2012 at 11:24 AM, Nicolas Rougier >>> <Nicolas.Rougier@...3782...> wrote:
>
>
> I agree, but the current matplotlib gallery is rather clueless about
> what the examples are related to until you click an image. I'm personally
> using the gallery by looking at an example that match what I've in mind most
> closely and then look at the code. But you're right, some structure(s) would
> definitely help.
>
> Here is an example of a well structured gallery:
> http://www.gigawiz.com/aagraphs.html.
>
> The first-level structure is organized at:
>
> Specialized Scientific Graphing
> Scatter Graphs
> Contour Charts (2-D, 3-D, and Ternary)
> Heatmaps
> Voronoi Diagram
> Waterfall Charts
> Bubble Charts
> Spider Charts
> Polar Charts
> Column and Bar Charts
> Area Charts
> Line Charts
> Combination Charts (Column-Line, Bar-Line, Area-Line)
> Diagrams of Multiple, Independent Value-Axes Column, Bar or Area Graphs
> High-Low, (Open)-High-Low-Close, and Range Charts
> Pie Charts and X-Y Scatter Pie
> Vector Charts
> Statistical Charts
>
>
> Maybe we can find/agree on similar structure(s)/sub-structure(s) and
> adapt it to the current gallery ?

An advantage of the current all in one page gallery is that it is
easier to find a recipe when I just look for individual plot elements,
when I have not much idea what it might be called and just some idea
what it should look like.

That's different from looking for plots with a specific usage or content.

Josef

You could still have a one-page gallery with plots separated into
subheadings (and a table of contents at the top which allows you to jump to
subheadings). This alone would greatly improve navigation in the gallery.
The list of headings is great, by the way.

-Tony

I am banging out a pull request to do just that.

Ben Root

------------------------------------------------------------------------------
Virtualization & Cloud Management Using Capacity Planning
Cloud computing makes use of virtualization - but cloud computing
also focuses on allowing computing to be delivered as a service.
http://www.accelacomm.com/jaw/sfnl/114/51521223/
_______________________________________________
Matplotlib-users mailing list
Matplotlib-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-users

I have made a pull request to change gen_gallery.py to generate a gallery page that breaks down the examples by sub directories.

https://github.com/matplotlib/matplotlib/pull/714

The idea would be that people can suggest new directories, get rid of poorly named directories, and move around existing files. The gen_gallery.py would only need to update its list of sub-directories. Also, examples/index.rst would also need to be updated, but maybe we can get that page auto-generated as well?

Cheers!
Ben Root

···

On Thu, Feb 23, 2012 at 10:55 AM, Filipe Pires Alvarenga Fernandes <ocefpaf@…287…> wrote:

Just a suggestion. All these ideas sounds like a “google code-in” task.

http://code.google.com/intl/pt-BR/opensource/gci/2010-11/

I do not know if “Matplotlib” participated in the past, if not take a

look of last years sympy task list:

https://github.com/sympy/sympy/wiki/GCI-2011-Task-list

If the ideas for the gallery improvement are break down to some simple

tasks like that you guys could use Google code-in to do it.

-Filipe