Documentation for using ROOT with IPython Notebook

ROOT
1

Dear ROOT experts,

I prepared some examples on how to use PyROOT with the IPython Notebook. A tutorial has been given at a hands on session (HATS) at the LPC for CMS and at two CMS data analysis schools.

I did not find any other such documentation besides this page:
root.cern.ch/drupal/content/ipyt … and-root-0
and the rootnotes script that I included in the examples (and slightly modified) to allow for plot embedding in the notebook page.

I was wondering if you are interested in adding some of the examples to a web page to make them available for other interested users.

The examples are mostly CMS independent and cover various topics. They are available in git:
github.com/demattia/usercode/tr … /HATS_2013

And the ones that might be of interest for a non-CMS specific audience are:

I typically took existing PyROOT examples (or C++ ones when no suitable PyROOT example was available) and adapted them to the IPython Notebook format.

Please, let me know what you think and if you would like to have more details.

2

Hi,

thanks! Examples for PyROOT are sorely missing, so this is very helpful. (Another good source is http://www.rootpy.org/#examples.)

You ask “adding some of the examples to a web page”? Do you mean copying the material or adding a link? The latter I can easily do.

Thanks,
Wim

3

Hi Wim,

thank you for the pointer. I had already checked quickly the rootpy package in the past, but coming back to it now after gaining more experience with the python tools it seems even more valuable. I will definitely give it another try.

About the documentation, I think we can add links to a page. I do not expect to touch that git folder, I leave it fixed so that the tutorial is reproducible.
I am not sure about a location where they could be easily found by PyROOT users, though, where do you suggest they could be added?

In any case, please go ahead!

Thank you,

Marco

4

Marco,

I was thinking of here: http://root.cern.ch/drupal/content/pyroot. The “More detailed examples” is so old, that it’s more of an insult than actual help.

Cheers,
Wim

5

Hi Wim,

I see that the page you pointed refers also to a kind of User’s Guide.
wlav.web.cern.ch/wlav/pyroot/

What about having a such guide in MarkDown like the other ROOT Users’s manual ?

root.cern.ch/drupal/content/users-guide

This format has the advantage of being really simple and very flexible: from one source you can generate
all the following formats: html, latex, pdf, epub (for tablets)…

The ROOT manuals sources are in $ROOTSYS/docbook.

I can help for the first conversion depending in which format you manuel is written.

Olivier

6

Hi Wim

[quote=“wlav”]Marco,

I was thinking of here: http://root.cern.ch/drupal/content/pyroot. The “More detailed examples” is so old, that it’s more of an insult than actual help.

Cheers,
Wim[/quote]

Thank you for adding the link. Could you please change it to:
github.com/demattia/usercode/tr … /HATS_2013
The main Notebook folder contains also other temporary or work in progress files.

I added a readme to the HATS_2013 folder so in github there are some basic information and links to nbviewer for all notebook pages.

Thank you,

Marco

7

Olivier,

[quote=“couet”]What about having a such guide in MarkDown like the other ROOT Users’s manual ?
root.cern.ch/drupal/content/users-guide[/quote]See http://root.cern.ch/download/doc/PythonRuby.html. Is basically the same content.

Cheers,
Wim

8

Marco,

[quote=“demattia”]Could you please change it to:
github.com/demattia/usercode/tr … /HATS_2013
The main Notebook folder contains also other temporary or work in progress files.[/quote]done!

Thanks,
Wim

9

Ah ok… it is done already. thanks