{
"cells": [
{
"cell_type": "markdown",
"id": "25b02eb2",
"metadata": {},
"source": [
"# hist015_TH1_read_and_draw\n",
"A Simple histogram drawing example.\n",
"\n",
"\n",
"\n",
"\n",
"**Author:** Wim Lavrijsen \n",
"This notebook tutorial was automatically generated with ROOTBOOK-izer from the macro found in the ROOT repository on Tuesday, May 19, 2026 at 08:12 PM."
]
},
{
"cell_type": "code",
"execution_count": 1,
"id": "12c94f01",
"metadata": {
"collapsed": false,
"execution": {
"iopub.execute_input": "2026-05-19T20:12:14.056697Z",
"iopub.status.busy": "2026-05-19T20:12:14.056557Z",
"iopub.status.idle": "2026-05-19T20:12:15.117462Z",
"shell.execute_reply": "2026-05-19T20:12:15.116772Z"
}
},
"outputs": [],
"source": [
"import ROOT\n",
"from ROOT import TCanvas, TPad, TFile, TPaveLabel, TPaveText\n",
"from ROOT import gROOT\n",
"\n",
"c1 = TCanvas( 'c1', 'Histogram Drawing Options', 200, 10, 700, 900 )\n",
"\n",
"pad1 = TPad( 'pad1', 'The pad with the function', 0.03, 0.62, 0.50, 0.92, 21 )\n",
"pad2 = TPad( 'pad2', 'The pad with the histogram', 0.51, 0.62, 0.98, 0.92, 21 )\n",
"pad3 = TPad( 'pad3', 'The pad with the histogram', 0.03, 0.02, 0.97, 0.57, 21 )\n",
"pad1.Draw()\n",
"pad2.Draw()\n",
"pad3.Draw()"
]
},
{
"cell_type": "markdown",
"id": "ebf9968a",
"metadata": {},
"source": [
"We connect the ROOT file generated in the hsimple.py tutorial"
]
},
{
"cell_type": "code",
"execution_count": 2,
"id": "b1457f09",
"metadata": {
"collapsed": false,
"execution": {
"iopub.execute_input": "2026-05-19T20:12:15.128271Z",
"iopub.status.busy": "2026-05-19T20:12:15.128119Z",
"iopub.status.idle": "2026-05-19T20:12:15.278126Z",
"shell.execute_reply": "2026-05-19T20:12:15.277697Z"
}
},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"TFile**\t\tpy-hsimple.root\tDemo ROOT file with histograms\n",
" TFile*\t\tpy-hsimple.root\tDemo ROOT file with histograms\n",
" KEY: TH1F\thpx;1\tThis is the px distribution\n",
" KEY: TH2F\thpxpy;1\tpy vs px\n",
" KEY: TProfile\thprof;1\tProfile of pz versus px\n",
" KEY: TNtuple\tntuple;1\tDemo ntuple\n"
]
}
],
"source": [
"example = TFile(\"py-hsimple.root\")\n",
"example.ls()"
]
},
{
"cell_type": "markdown",
"id": "f16590e1",
"metadata": {},
"source": [
"Draw a global picture title"
]
},
{
"cell_type": "code",
"execution_count": 3,
"id": "8e616111",
"metadata": {
"collapsed": false,
"execution": {
"iopub.execute_input": "2026-05-19T20:12:15.281427Z",
"iopub.status.busy": "2026-05-19T20:12:15.281293Z",
"iopub.status.idle": "2026-05-19T20:12:15.396845Z",
"shell.execute_reply": "2026-05-19T20:12:15.396025Z"
}
},
"outputs": [],
"source": [
"title = TPaveLabel( 0.1, 0.94, 0.9, 0.98,\n",
" 'Drawing options for one dimensional histograms' )\n",
"title.SetFillColor( 16 )\n",
"title.SetTextFont( 52 )\n",
"title.Draw()"
]
},
{
"cell_type": "markdown",
"id": "4a8ecdf4",
"metadata": {},
"source": [
"Draw histogram hpx in first pad with the default option."
]
},
{
"cell_type": "code",
"execution_count": 4,
"id": "40fa3110",
"metadata": {
"collapsed": false,
"execution": {
"iopub.execute_input": "2026-05-19T20:12:15.398863Z",
"iopub.status.busy": "2026-05-19T20:12:15.398733Z",
"iopub.status.idle": "2026-05-19T20:12:15.531788Z",
"shell.execute_reply": "2026-05-19T20:12:15.531023Z"
}
},
"outputs": [],
"source": [
"pad1.cd()\n",
"pad1.GetFrame().SetFillColor( 18 )\n",
"hpx = gROOT.FindObject( 'hpx' )\n",
"hpx.SetFillColor( 45 )\n",
"hpx.DrawCopy()\n",
"label1 = TPaveLabel( -3.5, 700, -1, 800, 'Default option' )\n",
"label1.SetFillColor( 42 )\n",
"label1.Draw()"
]
},
{
"cell_type": "markdown",
"id": "2adb576e",
"metadata": {},
"source": [
"Draw hpx as a lego. Clicking on the lego area will show\n",
"a \"transparent cube\" to guide you rotating the lego in real time."
]
},
{
"cell_type": "code",
"execution_count": 5,
"id": "8809b6d2",
"metadata": {
"collapsed": false,
"execution": {
"iopub.execute_input": "2026-05-19T20:12:15.533580Z",
"iopub.status.busy": "2026-05-19T20:12:15.533443Z",
"iopub.status.idle": "2026-05-19T20:12:15.644513Z",
"shell.execute_reply": "2026-05-19T20:12:15.643782Z"
}
},
"outputs": [],
"source": [
"pad2.cd()\n",
"hpx.DrawCopy( 'lego1' )\n",
"label2 = TPaveLabel( -0.72, 0.74, -0.22, 0.88, 'option Lego1' )\n",
"label2.SetFillColor( 42 )\n",
"label2.Draw()\n",
"label2a = TPaveLabel( -0.93, -1.08, 0.25, -0.92, 'Click on lego to rotate' )\n",
"label2a.SetFillColor( 42 )\n",
"label2a.Draw()"
]
},
{
"cell_type": "markdown",
"id": "f3980de0",
"metadata": {},
"source": [
"Draw hpx with its errors and a marker."
]
},
{
"cell_type": "code",
"execution_count": 6,
"id": "a010d974",
"metadata": {
"collapsed": false,
"execution": {
"iopub.execute_input": "2026-05-19T20:12:15.646694Z",
"iopub.status.busy": "2026-05-19T20:12:15.646542Z",
"iopub.status.idle": "2026-05-19T20:12:15.760744Z",
"shell.execute_reply": "2026-05-19T20:12:15.759962Z"
}
},
"outputs": [],
"source": [
"pad3.cd()\n",
"pad3.SetGridx()\n",
"pad3.SetGridy()\n",
"pad3.GetFrame().SetFillColor( 18 )\n",
"hpx.SetMarkerStyle( 21 )\n",
"hpx.Draw( 'e1p' )\n",
"label3 = TPaveLabel( 2, 600, 3.5, 650, 'option e1p' )\n",
"label3.SetFillColor( 42 )\n",
"label3.Draw()"
]
},
{
"cell_type": "markdown",
"id": "c3391499",
"metadata": {},
"source": [
"The following illustrates how to add comments using a PaveText.\n",
"Attributes of text/lines/boxes added to a PaveText can be modified.\n",
"The AddText function returns a pointer to the added object."
]
},
{
"cell_type": "code",
"execution_count": 7,
"id": "067807ce",
"metadata": {
"collapsed": false,
"execution": {
"iopub.execute_input": "2026-05-19T20:12:15.762427Z",
"iopub.status.busy": "2026-05-19T20:12:15.762301Z",
"iopub.status.idle": "2026-05-19T20:12:15.981467Z",
"shell.execute_reply": "2026-05-19T20:12:15.980975Z"
}
},
"outputs": [
{
"data": {
"text/html": [
"\n",
"\n",
"\n",
"
\n",
"\n",
"\n",
"\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"pave = TPaveText( -3.78, 500, -1.2, 750 )\n",
"pave.SetFillColor( 42 )\n",
"t1 = pave.AddText( 'You can move' )\n",
"t1.SetTextColor( 4 )\n",
"t1.SetTextSize( 0.05 )\n",
"pave.AddText( 'Title and Stats pads' )\n",
"pave.AddText( 'X and Y axis' )\n",
"pave.AddText( 'You can modify bin contents' )\n",
"pave.Draw()\n",
"c1.Update()\n",
"\n",
"if (example.IsOpen()):\n",
" example.Close()"
]
},
{
"cell_type": "markdown",
"id": "7637477b",
"metadata": {},
"source": [
"Draw all canvases "
]
},
{
"cell_type": "code",
"execution_count": 8,
"id": "24fea8a2",
"metadata": {
"collapsed": false,
"execution": {
"iopub.execute_input": "2026-05-19T20:12:15.983985Z",
"iopub.status.busy": "2026-05-19T20:12:15.983845Z",
"iopub.status.idle": "2026-05-19T20:12:16.104293Z",
"shell.execute_reply": "2026-05-19T20:12:16.103721Z"
}
},
"outputs": [
{
"data": {
"text/html": [
"\n",
"\n",
"\n",
"
\n",
"\n",
"\n",
"\n"
],
"text/plain": [
""
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"%jsroot on\n",
"from ROOT import gROOT \n",
"gROOT.GetListOfCanvases().Draw()"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.12.12"
}
},
"nbformat": 4,
"nbformat_minor": 5
}