PyROOT Namespace Reference

Namespaces
namespace	PyStrings

Classes
class	RPyROOTApplication
	Interactive application for Python. More...
class	TMemoryRegulator

Typedefs
typedef std::unordered_map< Cppyy::TCppObject_t, Cppyy::TCppType_t >	ObjectMap_t

Functions
PyObject *	AddBranchAttrSyntax (PyObject *self, PyObject *args)
	Allow branches to be accessed as attributes of a tree. More...
PyObject *	AddCPPInstancePickling (PyObject *self, PyObject *args)
	Set reduce attribute for CPPInstance objects. More...
PyObject *	AddDirectoryGetAttrPyz (PyObject *self, PyObject *args)
	Add attr syntax to TDirectory. More...
PyObject *	AddDirectoryWritePyz (PyObject *self, PyObject *args)
	Add pythonisation of TDirectory::WriteObject. More...
PyObject *	AddFileOpenPyz (PyObject *self, PyObject *args)
	Make TFile::Open equivalent to a constructor. More...
PyObject *	AddPrettyPrintingPyz (PyObject *self, PyObject *args)
	Add pretty printing pythonization. More...
PyObject *	AddSetItemTCAPyz (PyObject *self, PyObject *args)
	Customize the setting of an item of a TClonesArray. More...
PyObject *	AddTClassDynamicCastPyz (PyObject *self, PyObject *args)
	Add pythonization for TClass::DynamicCast. More...
PyObject *	AddTDirectoryFileGetPyz (PyObject *self, PyObject *args)
	Add pythonisation of TDirectoryFile::Get() More...
PyObject *	AddTObjectEqNePyz (PyObject *self, PyObject *args)
	Add pythonization for equality and inequality operators in TObject. More...
PyObject *	AddUsingToClass (PyObject *self, PyObject *args)
	Add base class overloads of a given method to a derived class. More...
PyObject *	AsRTensor (PyObject *self, PyObject *obj)
	Adopt memory of a Python object with array interface using an RTensor. More...
PyObject *	AsRVec (PyObject *self, PyObject *obj)
	Adopt memory of a Python object with array interface using an RVec. More...
PyObject *	BranchPyz (PyObject *self, PyObject *args)
	Add pythonization for TTree::Branch. More...
PyObject *	ClearProxiedObjects (PyObject *self, PyObject *args)
PyObject *	CPPInstanceExpand (PyObject *self, PyObject *args)
	Deserialize pickled objects. More...
PyObject *	CreateBufferFromAddress (PyObject *self, PyObject *addr)
	Get a buffer starting at a given address. More...
bool	CreatePyStrings ()
PyObject *	DestroyPyStrings ()
	Remove all cached python strings. More...
PyObject *	GetDataPointer (PyObject *self, PyObject *args)
	Get pointer to the data of an object. More...
PyObject *	GetEndianess (PyObject *self, PyObject *args)
	Get endianess of the system. More...
PyObject *	GetSizeOfType (PyObject *self, PyObject *args)
	Set of helper functions that are invoked from the pythonizors, on the Python side. More...
void	Init ()
PyObject *	MakeNumpyDataFrame (PyObject *self, PyObject *obj)
	Make an RDataFrame from a dictionary of numpy arrays. More...
PyObject *	SetBranchAddressPyz (PyObject *self, PyObject *args)
	Add pythonization for TTree::SetBranchAddress. More...

Variables
PyObject *	gRootModule = 0

Typedef Documentation

ObjectMap_t

typedef std::unordered_map<Cppyy::TCppObject_t, Cppyy::TCppType_t> PyROOT::ObjectMap_t

Definition at line 49 of file TMemoryRegulator.h.

Function Documentation

AddBranchAttrSyntax()

PyObject * PyROOT::AddBranchAttrSyntax	(	PyObject *	self,
		PyObject *	args
	)

Allow branches to be accessed as attributes of a tree.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments received from Python.

Allow access to branches/leaves as if they were Python data attributes of the tree (e.g. mytree.branch)

Definition at line 174 of file TTreePyz.cxx.

AddCPPInstancePickling()

PyObject * PyROOT::AddCPPInstancePickling	(	PyObject *	self,
		PyObject *	args
	)

Set reduce attribute for CPPInstance objects.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments received from Python.

The C++ function op_reduce defined above is wrapped in a Python method so that it can be injected in CPPInstance

Definition at line 122 of file CPPInstancePyz.cxx.

AddDirectoryGetAttrPyz()

PyObject * PyROOT::AddDirectoryGetAttrPyz	(	PyObject *	self,
		PyObject *	args
	)

Add attr syntax to TDirectory.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments This allows to use TDirectory and daughters (such as TDirectoryFile and TFile) as follows myfile.mydir.mysubdir.myHist.Draw()

Definition at line 100 of file TDirectoryPyz.cxx.

AddDirectoryWritePyz()

PyObject * PyROOT::AddDirectoryWritePyz	(	PyObject *	self,
		PyObject *	args
	)

Add pythonisation of TDirectory::WriteObject.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments

Definition at line 111 of file TDirectoryPyz.cxx.

AddFileOpenPyz()

PyObject * PyROOT::AddFileOpenPyz	(	PyObject *	self,
		PyObject *	args
	)

Make TFile::Open equivalent to a constructor.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments

Definition at line 23 of file TFilePyz.cxx.

AddPrettyPrintingPyz()

PyObject * PyROOT::AddPrettyPrintingPyz	(	PyObject *	self,
		PyObject *	args
	)

Add pretty printing pythonization.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments received from Python.

This function adds the following pythonizations to print the object more user-friendly than cppyy by using the output of cling::printValue as the return value of the special method str.

Definition at line 54 of file GenericPyz.cxx.

AddSetItemTCAPyz()

PyObject * PyROOT::AddSetItemTCAPyz	(	PyObject *	self,
		PyObject *	args
	)

Customize the setting of an item of a TClonesArray.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments received from Python.

Inject a setitem implementation that customizes the setting of an item into a TClonesArray.

The setitem pythonization that TClonesArray inherits from TSeqCollection does not apply in this case and a redefinition is required. The reason is TClonesArray sets objects by constructing them in-place, which is impossible to support as the Python object given as value must exist a priori. It can, however, be memcpy'd and stolen.

Definition at line 167 of file TClonesArrayPyz.cxx.

AddTClassDynamicCastPyz()

PyObject * PyROOT::AddTClassDynamicCastPyz	(	PyObject *	self,
		PyObject *	args
	)

Add pythonization for TClass::DynamicCast.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments received from Python.

TClass::DynamicCast returns a void* that the user still has to cast (it will have the proper offset, though). Fix this by providing the requested binding if the cast succeeded.

Definition at line 89 of file TClassPyz.cxx.

AddTDirectoryFileGetPyz()

PyObject * PyROOT::AddTDirectoryFileGetPyz	(	PyObject *	self,
		PyObject *	args
	)

Add pythonisation of TDirectoryFile::Get()

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments received from Python.

Allow access to objects through the Get() method. (e.g. dirfile.Get(key))

Definition at line 69 of file TDirectoryFilePyz.cxx.

AddTObjectEqNePyz()

PyObject * PyROOT::AddTObjectEqNePyz	(	PyObject *	self,
		PyObject *	args
	)

Add pythonization for equality and inequality operators in TObject.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments received from Python.

The equality and inequality operators are better implemented in C++, since we need to need to rely on Cppyy's rich comparison if the object we are comparing ourselves with is not a Python proxy or if it contains a null pointer. For example, we need to support the comparison to None.

The rest of comparison operators (i.e. those that define order) can be implemented in Python, throwing a NotImplemented exception if we are not comparing two proxies to TObject or derivate.

Definition at line 57 of file TObjectPyz.cxx.

AddUsingToClass()

PyObject * PyROOT::AddUsingToClass	(	PyObject *	self,
		PyObject *	args
	)

Add base class overloads of a given method to a derived class.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args[0]	Derived class.
[in]	args[1]	Name of the method whose base class overloads to inject in the derived class.

This function adds base class overloads to a derived class for a given method. This covers the 'using' case, which is not supported by default by the bindings.

Definition at line 171 of file PyzPythonHelpers.cxx.

AsRTensor()

PyObject * PyROOT::AsRTensor	(	PyObject *	self,
		PyObject *	obj
	)

Adopt memory of a Python object with array interface using an RTensor.

Parameters

[in]

obj

PyObject with array interface

This function returns an RTensor which adopts the memory of the given PyObject. The RTensor takes the data pointer and the shape from the array interface dictionary.

Definition at line 28 of file RTensorPyz.cxx.

AsRVec()

PyObject * PyROOT::AsRVec	(	PyObject *	self,
		PyObject *	obj
	)

Adopt memory of a Python object with array interface using an RVec.

Parameters

[in]

obj

PyObject with array interface

This function returns an RVec which adopts the memory of the given PyObject. The RVec takes the data pointer and the size from the array interface dictionary.

Definition at line 28 of file RVecPyz.cxx.

BranchPyz()

PyObject * PyROOT::BranchPyz	(	PyObject *	self,
		PyObject *	args
	)

Add pythonization for TTree::Branch.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments received from Python.

Modify the behaviour of Branch so that proxy references can be passed as arguments from the Python side, more precisely in cases where the C++ implementation of the method expects the address of a pointer.

For example:

v = ROOT.std.vector('int')()
t.Branch('my_vector_branch', v)

The following signatures are treated in this pythonization:

• ( const char*, void*, const char*, Int_t = 32000 )
• ( const char*, const char*, T**, Int_t = 32000, Int_t = 99 )
• ( const char*, T**, Int_t = 32000, Int_t = 99 )

Definition at line 392 of file TTreePyz.cxx.

ClearProxiedObjects()

PyObject * PyROOT::ClearProxiedObjects	(	PyObject *	self,
		PyObject *	args
	)

Definition at line 64 of file PyROOTWrapper.cxx.

CPPInstanceExpand()

PyObject * PyROOT::CPPInstanceExpand	(	PyObject *	self,
		PyObject *	args
	)

Deserialize pickled objects.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments received from Python.

Helper function that deserializes pickled objects. It needs to be included in the extension module API because otherwise it is not callable from Python. This is important because it will be Python itself calling it when trying to expand a serialized object.

Definition at line 39 of file CPPInstancePyz.cxx.

CreateBufferFromAddress()

PyObject * PyROOT::CreateBufferFromAddress	(	PyObject *	self,
		PyObject *	addr
	)

Get a buffer starting at a given address.

Parameters

[in]	self	Always null, since this is a module function.
[in]	addr	Address to create buffer from

Returns

A cppyy LowLevelView object on the received address, i.e. an indexable buffer starting at that address.

Definition at line 28 of file FacadeHelpers.cxx.

CreatePyStrings()

bool PyROOT::CreatePyStrings

(

)

Definition at line 29 of file PyROOTStrings.cxx.

DestroyPyStrings()

PyObject * PyROOT::DestroyPyStrings

(

)

Remove all cached python strings.

Definition at line 46 of file PyROOTStrings.cxx.

GetDataPointer()

PyObject * PyROOT::GetDataPointer	(	PyObject *	self,
		PyObject *	args
	)

Get pointer to the data of an object.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args[0]	Python representation of the C++ object.
[in]	args[1]	Data-type of the C++ object as Python string
[in]	args[2]	Method to be called on the C++ object to get the data pointer as Python string

This function returns the pointer to the data of an object as an Python integer retrieved by the given method.

Definition at line 65 of file PyzPythonHelpers.cxx.

GetEndianess()

PyObject * PyROOT::GetEndianess	(	PyObject *	self,
		PyObject *	args
	)

Get endianess of the system.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to an empty Python tuple.
[out]	Endianess	as Python string

This function returns endianess of the system as a Python integer. The return value is either '<' or '>' for little or big endian, respectively.

Definition at line 100 of file PyzPythonHelpers.cxx.

GetSizeOfType()

PyObject * PyROOT::GetSizeOfType	(	PyObject *	self,
		PyObject *	args
	)

Set of helper functions that are invoked from the pythonizors, on the Python side.

For that purpose, they are included in the interface of the PyROOT extension module.

Get size of C++ data-type

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	C++ data-type as Python string

This function returns the length of a C++ data-type in bytes as a Python integer.

Definition at line 39 of file PyzPythonHelpers.cxx.

Init()

void PyROOT::Init

(

)

Definition at line 50 of file PyROOTWrapper.cxx.

MakeNumpyDataFrame()

PyObject * PyROOT::MakeNumpyDataFrame	(	PyObject *	self,
		PyObject *	pydata
	)

Make an RDataFrame from a dictionary of numpy arrays.

Parameters

[in]

pydata

Dictionary with numpy arrays

This function takes a dictionary of numpy arrays and creates an RDataFrame using the keys as column names and the numpy arrays as data.

Definition at line 29 of file RDataFramePyz.cxx.

SetBranchAddressPyz()

PyObject * PyROOT::SetBranchAddressPyz	(	PyObject *	self,
		PyObject *	args
	)

Add pythonization for TTree::SetBranchAddress.

Parameters

[in]	self	Always null, since this is a module function.
[in]	args	Pointer to a Python tuple object containing the arguments received from Python.

Modify the behaviour of SetBranchAddress so that proxy references can be passed as arguments from the Python side, more precisely in cases where the C++ implementation of the method expects the address of a pointer.

For example:

v = ROOT.std.vector('int')()
t.SetBranchAddress("my_vector_branch", v)

Definition at line 196 of file TTreePyz.cxx.

Variable Documentation

gRootModule

R__EXTERN PyObject * PyROOT::gRootModule = 0

Definition at line 39 of file PyROOTModule.cxx.