propagate documentation for basic functions at module level

[yarikoptic]

ATM

In [6]: galry.plot?
Type:       function
String Form:<function plot at 0x41e6320>
File:       /home/yoh/deb/perspect/galry/galry/pyplot.py
Definition: galry.plot(*args, **kwargs)
Docstring:  <no docstring>

I guess you could use smth like https://github.com/PyMVPA/PyMVPA/blob/HEAD/mvpa2/base/dochelpers.py#L550

[yarikoptic]

damn -- I already complained about it... just decided to give galry a fresh look to promote it a bit to other people, but ran into the same old issue.... are you guys still interested in pushing it forward or done with it? ;)

[rossant]

whoops, this issue is quite old already... :)

I'm now working exclusively (and actively) on Galry's replacement: Vispy (github, dev mailing list). If you have very basic requirements, Galry might work for you. If you want to do more advanced stuff, I would highly recommend to contribute to the Vispy project.

What would you want to do exactly?

[yarikoptic]

I want peace in the world! ;)
but for that, starting small -- ran into the glueviz project by @ChrisBeaumont et al., which is currently relying on matplotlib exclusively. That, as you know, leads to suffering performance and thus limitations, such as difficulty to do colored scatter plots (https://github.com/glue-viz/glue/issues/403#issuecomment-48531999). So I thought to recommend Galry as a backend for those -- seems to work splendid

[ChrisBeaumont]

@rossant and I have discussed adding a vispy backend for Glue, which I think is a great idea. It's a nontrivial addition, so I'm also kind of waiting to see how vispy (and other projects like bokeh) mature to see where effort is best spent

[yarikoptic]

@ChrisBeaumont ah -- cool. So then it would be just a matter of extending glue interface to support those features (colored points) while hoping that backend eventually would become powerful enough to support it for large arrays ;) right?

[ChrisBeaumont]

yep, that's the idea