Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Address the 'long tail of visualization' in the documentation #19

Open
jlstevens opened this issue Mar 18, 2015 · 2 comments
Open

Address the 'long tail of visualization' in the documentation #19

jlstevens opened this issue Mar 18, 2015 · 2 comments
Labels
type: docs Related to the documentation and examples

Comments

@jlstevens
Copy link
Contributor

HoloViews makes common operation and visualizations very easy. That said, HoloViews needs to be flexible enough to scale to finely tweaked or highly customized visualizations.

Here are our current recommendations:

  • First make sure we haven't already exposed the style or plot options you are looking for.
  • If there is some style keyword that needs to be passed to the backend (i.e. matplotlib for now) the allowed keywords can easily be extended as detailed in the FAQ. If you believe it ought to be available for all users, please submit a pull request explaining briefly why it is useful and showing which style_opts should list it, and we'll make it available by default
  • The finalize hooks need to be documented as these hooks are the easiest way for a user to change the behavior of our plotting system with minimal code.
  • Writing a new Plot class and if necessary a new Element type, typically extending from some existing class. Obviously the most work but extremely worthwhile, as your new plot will then compose nicely with the rest of HoloViews (automatic support for layouts, overlays, animation, the options system and more!).
  • Finally you can consider exporting to SVG and tweaking the figure externally e.g. in Inkscape. This is only recommended for very minor changes just before publication as such tweaks are not reproducible!

We should definitely consider authoring a new notebook tutorial on this topic.

@jlstevens jlstevens added the type: docs Related to the documentation and examples label Mar 18, 2015
@jlstevens jlstevens added this to the Whenever milestone Mar 18, 2015
@jbednar
Copy link
Member

jbednar commented Mar 18, 2015

I've updated the above recommendations slightly by editing them.

@jlstevens
Copy link
Contributor Author

I have now linked to this issue from the FAQ page: 44270ca

@jlstevens jlstevens removed this from the No milestone milestone Jun 24, 2015
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type: docs Related to the documentation and examples
Projects
None yet
Development

No branches or pull requests

2 participants