root.hist3D {xps} | R Documentation

## ROOT 3D-Histogram

### Description

Creates a ROOT 3D-histogram for a ROOT tree.

### Usage

    root.hist3D(x, treename1 = character(0), treename2 = character(0), treename3 = character(0), logbase = "log2", option = "HIST", canvasname = "Histogram3D", save.as = "", w = 540, h = 540)

### Arguments

`x` | object of class `DataTreeSet` or `ExprTreeSet`.
`treename1` | name of first tree, must be present in `rootfile` of object `x`.
`treename2` | name of second tree, must be present in `rootfile` of object `x`.
`treename3` | name of third tree, must be present in `rootfile` of object `x`.
`logbase` | usually “log2”, or “0”, determines if leaf data should be converted to log.
`option` | ROOT hist TH3 option, usually one of “HIST”, “SCAT”, “BOX”.
`canvasname` | name of ROOT canvas
`save.as` | gaphics tye for saving canvas, one of “ps”, “eps”, “pdf”, “jpg”, “gif”, “png”, “tiff”
`w` | the width of the canvas in pixels.
`h` | the height of the canvas in pixels.

### Details

Creates a ROOT 3D-histogram for trees `treename1`, `treename2` and `treename3` present in `rootfile`. By selecting menu “File->Save->canvasname.xxx” you can save the figure as e.g. *gif, *.jpg, *.pdf, *.ps or even as C++ macro.

By moving the mouse into the middle of the canvas, the cursor changes and you can rotate the 3D-histogram. By selecting menu “View->View With->OpenGL” the OpenGL viewer opens, where you can rotate the 3D-histogram interactively.

Alternatively, you can save the plot by setting `save.as`. However, this will close the canvas immediately after opening it.

### Note

Always select menu item “Quit ROOT” from menu “File” to close the ROOT canvas, otherwise you are in the CINT C/C++ interpreter from `ROOT`. To exit CINT, you need to type “.q”.

### Author(s)

Christian Stratowa

### See Also

`root.hist1D`, `root.hist2D`

### Examples

    ## Not run:
    ## first, load ROOT scheme file and ROOT data file
    scheme.test3 <- root.scheme(paste(.path.package("xps"),"schemes/SchemeTest3.root",sep="/"))
    data.test3 <- root.data(scheme.test3, paste(.path.package("xps"),"rootdata/DataTest3_cel.root",sep="/"))

    root.hist3D(data.test3, "TestA1.cel", "TestB2.cel", "TestB1.cel", option="BOX")
    ## End(Not run)

[Package xps version 1.2.10 Index]