Parallel Coordinates class.

The multidimensional system of Parallel coordinates is a common way of studying high-dimensional geometry and visualizing multivariate problems. It has first been proposed by A. Inselberg in 1981.

To show a set of points in an n-dimensional space, a backdrop is drawn consisting of n parallel lines. A point in n-dimensional space is represented as a polyline with vertices on the parallel axes; the position of the vertex on the i-th axis corresponds to the i-th coordinate of the point.

This tool comes with a rather large gui in the editor. It is necessary to use this editor in order to explore a data set, as explained below.

Reduce cluttering:

The main issue for parallel coordinates is the very high cluttering of the output when dealing with large data set. Two techniques have been implemented to bypass that so far:

Draw doted lines instead of plain lines with an adjustable dots spacing. A slider to adjust the dots spacing is available in the editor.
Sort the entries to display with a "weight cut". On each axis is drawn a histogram describing the distribution of the data on the corresponding variable. The "weight" of an entry is the sum of the bin content of each bin the entry is going through. An entry going through the histograms peaks will have a big weight wether an entry going randomly through the histograms will have a rather small weight. Setting a cut on this weight allows to draw only the most representative entries. A slider set the cut is also available in the gui.

Selections:

Selections of specific entries can be defined over the data se using parallel coordinates. With that representation, a selection is an ensemble of ranges defined on the axes. Ranges defined on the same axis are conjugated with OR (an entry must be in one or the other ranges to be selected). Ranges on different axes are are conjugated with AND (an entry must be in all the ranges to be selected). Several selections can be defined with different colors. It is possible to generate an entry list from a given selection and apply it to the tree using the editor ("Apply to tree" button).

Axes:

Options can be defined each axis separately using the right mouse click. These options can be applied to every axes using the editor.

Axis width: If set to 0, the axis is simply a line. If higher, a color histogram is drawn on the axis.
Axis histogram height: If not 0, a usual bar histogram is drawn on the plot.

The order in which the variables are drawn is essential to see the clusters. The axes can be dragged to change their position. A zoom is also available. The logarithm scale is also available by right clicking on the axis.

Candle chart:

TParallelCoord can also be used to display a candle chart. In that mode, every variable is drawn in the same scale. The candle chart can be combined with the parallel coordinates mode, drawing the candle sticks over the axes.

{
   TCanvas *c1 = new TCanvas("c1");
   TFile *f = TFile::Open("cernstaff.root");
   TTree *T = (TTree*)f->Get("T");
   T->Draw("Age:Grade:Step:Cost:Division:Nation","","para");
   TParallelCoord* para = (TParallelCoord*)gPad->GetListOfPrimitives()->FindObject("ParaCoord");
   TParallelCoordVar* grade = (TParallelCoordVar*)para->GetVarList()->FindObject("Grade");
   grade->AddRange(new TParallelCoordRange(grade,11.5,14));
   para->AddSelection("less30");
   para->GetCurrentSelection()->SetLineColor(kViolet);
   TParallelCoordVar* age = (TParallelCoordVar*)para->GetVarList()->FindObject("Age");
   age->AddRange(new TParallelCoordRange(age,21,30));
}

Some references:

Alfred Inselberg's Homepage http://www.math.tau.ac.il/~aiisreal, with Visual Tutorial, History, Selected Publications and Applications.
Almir Olivette Artero, Maria Cristina Ferreira de Oliveira, Haim Levkowitz, "Uncovering Clusters in Crowded Parallel Coordinates Visualizations," infovis, pp. 81-88, IEEE Symposium on Information Visualization (INFOVIS'04), 2004.

Definition at line 28 of file TParallelCoord.h.

Public Types
enum	EStatusBits { kVertDisplay = (1ULL << ( 14 )) , kCurveDisplay = (1ULL << ( 15 )) , kPaintEntries = (1ULL << ( 16 )) , kLiveUpdate = (1ULL << ( 17 )) , kGlobalScale = (1ULL << ( 19 )) , kCandleChart = (1ULL << ( 20 )) , kGlobalLogScale = (1ULL << ( 21 )) }

Public Types inherited from TObject
enum	{ kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 , kBitMask = 0x00ffffff }

enum	{ kSingleKey = (1ULL << ( 0 )) , kOverwrite = (1ULL << ( 1 )) , kWriteDelete = (1ULL << ( 2 )) }

enum	EDeprecatedStatusBits { kObjInCanvas = (1ULL << ( 3 )) }

enum	EStatusBits { kCanDelete = (1ULL << ( 0 )) , kMustCleanup = (1ULL << ( 3 )) , kIsReferenced = (1ULL << ( 4 )) , kHasUUID = (1ULL << ( 5 )) , kCannotPick = (1ULL << ( 6 )) , kNoContextMenu = (1ULL << ( 8 )) , kInvalidObject = (1ULL << ( 13 )) }

Public Member Functions
	TParallelCoord ()
	Default constructor.

	TParallelCoord (Long64_t nentries)
	Constructor without a reference to a tree, the datas must be added afterwards with TParallelCoord::AddVariable(Double_t,const char).

	TParallelCoord (TTree *tree, Long64_t nentries)
	Normal constructor, the datas must be added afterwards with TParallelCoord::AddVariable(Double_t,const char).

virtual	~TParallelCoord ()
	Destructor.

void	AddSelection (const char *title)
	Add a selection.

void	AddVariable (const char *varexp)
	Add a variable from an expression.

void	AddVariable (Double_t val, const char title="")
	Add a variable.

void	ApplySelectionToTree ()
	Apply the current selection to the tree.

void	CleanUpSelections (TParallelCoordRange *range)
	Clean up the selections from the ranges which could have been deleted when a variable has been deleted.

void	DeleteSelection (TParallelCoordSelect *sel)
	Delete a selection.

virtual Int_t	DistancetoPrimitive (Int_t px, Int_t py)
	Compute the distance from the TParallelCoord.

virtual void	Draw (Option_t *options="")
	Draw the parallel coordinates graph.

virtual void	ExecuteEvent (Int_t entry, Int_t px, Int_t py)
	Execute the corresponding entry.

Bool_t	GetCandleChart ()

Long64_t	GetCurrentFirst ()

Long64_t	GetCurrentN ()

TParallelCoordSelect *	GetCurrentSelection ()
	Return the selection currently being edited.

Bool_t	GetCurveDisplay () const

Int_t	GetDotsSpacing () const

TEntryList *	GetEntryList (Bool_t sel=kTRUE)
	Get the whole entry list or one for a selection.

Bool_t	GetGlobalLogScale ()

Double_t	GetGlobalMax ()
	return the global maximum.

Double_t	GetGlobalMin ()
	return the global minimum.

Bool_t	GetGlobalScale ()

Color_t	GetLineColor ()

Width_t	GetLineWidth ()

Int_t	GetNbins ()
	get the binning of the histograms.

Long64_t	GetNentries ()

UInt_t	GetNvar ()

TParallelCoordSelect *	GetSelection (const char *title)
	Get a selection from its title.

TList *	GetSelectList ()

TTree *	GetTree ()
	return the tree if fTree is defined.

Double_t *	GetVariable (const char *var)
	Get the variables values from its title.

Double_t *	GetVariable (Int_t i)
	Get the variables values from its index.

TList *	GetVarList ()

Bool_t	GetVertDisplay () const

Int_t	GetWeightCut () const

virtual TClass *	IsA () const

virtual void	Paint (Option_t *options="")
	Paint the parallel coordinates graph.

Bool_t	RemoveVariable (const char *var)
	Delete the variable "vartitle" from the graph.

void	RemoveVariable (TParallelCoordVar *var)
	Delete a variable from the graph.

void	ResetTree ()
	Reset the tree entry list to the initial one..

void	SaveEntryLists (const char *filename="", Bool_t overwrite=kFALSE)
	Save the entry lists in a root file "filename.root".

void	SavePrimitive (std::ostream &out, Option_t *options)
	Save the TParallelCoord in a macro.

void	SaveTree (const char *filename="", Bool_t overwrite=kFALSE)
	Save the tree in a file if fTreeFileName == "".

void	SetAxisHistogramBinning (Int_t n=100)
	Set the same histogram axis binning for all axis.

void	SetAxisHistogramHeight (Double_t h=0.5)
	Set the same histogram axis height for all axis.

void	SetAxisHistogramLineWidth (Int_t lw=2)
	Set the same histogram axis line width for all axis.

void	SetCandleChart (Bool_t can)
	Set a candle chart display.

void	SetCurrentEntries (TEntryList *entries)

void	SetCurrentFirst (Long64_t)
	Set the first entry to be displayed.

void	SetCurrentN (Long64_t)
	Set the number of entry to be displayed.

TParallelCoordSelect *	SetCurrentSelection (const char *title)
	Set the selection being edited.

void	SetCurrentSelection (TParallelCoordSelect *sel)
	Set the selection being edited.

virtual void	SetCurveDisplay (Bool_t curve=1)

void	SetDotsSpacing (Int_t s=0)
	Set dots spacing.

void	SetGlobalLogScale (Bool_t)
	All axes in log scale.

void	SetGlobalMax (Double_t max)
	Force all variables to adopt the same max.

void	SetGlobalMin (Double_t min)
	Force all variables to adopt the same min.

void	SetGlobalScale (Bool_t gl)
	Constraint all axes to the same scale.

void	SetInitEntries (TEntryList *entries)

void	SetLineColor (Color_t col)

void	SetLineWidth (Width_t wid)

void	SetLiveRangesUpdate (Bool_t)
	If true, the pad is updated while the motion of a dragged range.

void	SetNentries (Long64_t n)

void	SetTree (TTree *tree)

void	SetVertDisplay (Bool_t vert=kTRUE)
	Set the vertical or horizontal display.

void	SetWeightCut (Int_t w=0)

virtual void	Streamer (TBuffer &)
	Stream an object of class TObject.

void	StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)

void	UnzoomAll ()
	Unzoom all variables.

Public Member Functions inherited from TNamed
	TNamed ()

	TNamed (const char name, const char title)

	TNamed (const TNamed &named)
	TNamed copy ctor.

	TNamed (const TString &name, const TString &title)

virtual	~TNamed ()
	TNamed destructor.

void	Clear (Option_t *option="") override
	Set name and title to empty strings ("").

TObject *	Clone (const char *newname="") const override
	Make a clone of an object using the Streamer facility.

Int_t	Compare (const TObject *obj) const override
	Compare two TNamed objects.

void	Copy (TObject &named) const override
	Copy this to obj.

virtual void	FillBuffer (char *&buffer)
	Encode TNamed into output buffer.

const char *	GetName () const override
	Returns name of object.

const char *	GetTitle () const override
	Returns title of object.

ULong_t	Hash () const override
	Return hash value for this object.

Bool_t	IsSortable () const override

void	ls (Option_t *option="") const override
	List TNamed name and title.

TNamed &	operator= (const TNamed &rhs)
	TNamed assignment operator.

void	Print (Option_t *option="") const override
	Print TNamed name and title.

virtual void	SetName (const char *name)
	Set the name of the TNamed.

virtual void	SetNameTitle (const char name, const char title)
	Set all the TNamed parameters (name and title).

virtual void	SetTitle (const char *title="")
	Set the title of the TNamed.

virtual Int_t	Sizeof () const
	Return size of the TNamed part of the TObject.

void	StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)

Public Member Functions inherited from TObject
	TObject ()
	TObject constructor.

	TObject (const TObject &object)
	TObject copy ctor.

virtual	~TObject ()
	TObject destructor.

void	AbstractMethod (const char *method) const
	Use this method to implement an "abstract" method that you don't want to leave purely abstract.

virtual void	AppendPad (Option_t *option="")
	Append graphics object to current pad.

virtual void	Browse (TBrowser *b)
	Browse object. May be overridden for another default action.

ULong_t	CheckedHash ()
	Check and record whether this class has a consistent Hash/RecursiveRemove setup (*) and then return the regular Hash value for this object.

virtual const char *	ClassName () const
	Returns name of class to which the object belongs.

virtual void	Delete (Option_t *option="")
	Delete this object.

virtual void	DrawClass () const
	Draw class inheritance tree of the class to which this object belongs.

virtual TObject *	DrawClone (Option_t *option="") const
	Draw a clone of this object in the current selected pad with: `gROOT->SetSelectedPad(c1)`.

virtual void	Dump () const
	Dump contents of object on stdout.

virtual void	Error (const char method, const char msgfmt,...) const
	Issue error message.

virtual void	Execute (const char method, const char params, Int_t *error=nullptr)
	Execute method on this object with the given parameter string, e.g.

virtual void	Execute (TMethod method, TObjArray params, Int_t *error=nullptr)
	Execute method on this object with parameters stored in the TObjArray.

virtual void	Fatal (const char method, const char msgfmt,...) const
	Issue fatal error message.

virtual TObject *	FindObject (const char *name) const
	Must be redefined in derived classes.

virtual TObject *	FindObject (const TObject *obj) const
	Must be redefined in derived classes.

virtual Option_t *	GetDrawOption () const
	Get option used by the graphics system to draw this object.

virtual const char *	GetIconName () const
	Returns mime type name of object.

virtual char *	GetObjectInfo (Int_t px, Int_t py) const
	Returns string containing info about the object at position (px,py).

virtual Option_t *	GetOption () const

virtual UInt_t	GetUniqueID () const
	Return the unique object id.

virtual Bool_t	HandleTimer (TTimer *timer)
	Execute action in response of a timer timing out.

Bool_t	HasInconsistentHash () const
	Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveRemove (i.e.

virtual void	Info (const char method, const char msgfmt,...) const
	Issue info message.

virtual Bool_t	InheritsFrom (const char *classname) const
	Returns kTRUE if object inherits from class "classname".

virtual Bool_t	InheritsFrom (const TClass *cl) const
	Returns kTRUE if object inherits from TClass cl.

virtual void	Inspect () const
	Dump contents of this object in a graphics canvas.

void	InvertBit (UInt_t f)

Bool_t	IsDestructed () const
	IsDestructed.

virtual Bool_t	IsEqual (const TObject *obj) const
	Default equal comparison (objects are equal if they have the same address in memory).

virtual Bool_t	IsFolder () const
	Returns kTRUE in case object contains browsable objects (like containers or lists of other objects).

R__ALWAYS_INLINE Bool_t	IsOnHeap () const

R__ALWAYS_INLINE Bool_t	IsZombie () const

void	MayNotUse (const char *method) const
	Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary).

virtual Bool_t	Notify ()
	This method must be overridden to handle object notification.

void	Obsolete (const char method, const char asOfVers, const char *removedFromVers) const
	Use this method to declare a method obsolete.

void	operator delete (void *ptr)
	Operator delete.

void	operator delete[] (void *ptr)
	Operator delete [].

void *	operator new (size_t sz)

void *	operator new (size_t sz, void *vp)

void *	operator new[] (size_t sz)

void *	operator new[] (size_t sz, void *vp)

TObject &	operator= (const TObject &rhs)
	TObject assignment operator.

virtual void	Pop ()
	Pop on object drawn in a pad to the top of the display list.

virtual Int_t	Read (const char *name)
	Read contents of object with specified name from the current directory.

virtual void	RecursiveRemove (TObject *obj)
	Recursively remove this object from a list.

void	ResetBit (UInt_t f)

virtual void	SaveAs (const char filename="", Option_t option="") const
	Save this object in the file specified by filename.

void	SetBit (UInt_t f)

void	SetBit (UInt_t f, Bool_t set)
	Set or unset the user status bits as specified in f.

virtual void	SetDrawOption (Option_t *option="")
	Set drawing option for object.

virtual void	SetUniqueID (UInt_t uid)
	Set the unique object id.

void	StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)

virtual void	SysError (const char method, const char msgfmt,...) const
	Issue system error message.

R__ALWAYS_INLINE Bool_t	TestBit (UInt_t f) const

Int_t	TestBits (UInt_t f) const

virtual void	UseCurrentStyle ()
	Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked.

virtual void	Warning (const char method, const char msgfmt,...) const
	Issue warning message.

virtual Int_t	Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0)
	Write this object to the current directory.

virtual Int_t	Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0) const
	Write this object to the current directory.

Static Public Member Functions
static void	BuildParallelCoord (TSelectorDraw *selector, Bool_t candle)
	Call constructor and add the variables.

static TClass *	Class ()

static const char *	Class_Name ()

static constexpr Version_t	Class_Version ()

static const char *	DeclFileName ()

static void	SetEntryList (TParallelCoord para, TEntryList enlist)
	Set the entry lists of "para".

Static Public Member Functions inherited from TNamed
static TClass *	Class ()

static const char *	Class_Name ()

static constexpr Version_t	Class_Version ()

static const char *	DeclFileName ()

Static Public Member Functions inherited from TObject
static TClass *	Class ()

static const char *	Class_Name ()

static constexpr Version_t	Class_Version ()

static const char *	DeclFileName ()

static Longptr_t	GetDtorOnly ()
	Return destructor only flag.

static Bool_t	GetObjectStat ()
	Get status of object stat flag.

static void	SetDtorOnly (void *obj)
	Set destructor only flag.

static void	SetObjectStat (Bool_t stat)
	Turn on/off tracking of objects in the TObjectTable.

Private Member Functions
void	Init ()
	Initialise the data members of TParallelCoord.

void	PaintEntries (TParallelCoordSelect *sel=nullptr)
	Loop over the entries and paint them.

void	SetAxesPosition ()
	Update the position of the axes.

Private Attributes
TGaxis *	fCandleAxis
	! An axis used when displaying a candle chart.

TEntryList *	fCurrentEntries
	-> Current selected entries in the tree.

Long64_t	fCurrentFirst
	First entry to display.

Long64_t	fCurrentN
	Number of entries to display.

TParallelCoordSelect *	fCurrentSelection
	! Current Selection being edited.

Int_t	fDotsSpacing
	Spacing between dots to draw the entries.

TEntryList *	fInitEntries
	-> Selected entries when TParallelCoord first initialized.

Color_t	fLineColor
	entries line color.

Width_t	fLineWidth
	entries line width.

Long64_t	fNentries
	Number of entries;.

UInt_t	fNvar
	Number of variables.

TList *	fSelectList
	List of selections over the variables.

TTree *	fTree
	! Pointer to the TTree.

TString	fTreeFileName
	Name of the file containing the tree.

TString	fTreeName
	Name of the tree.

TList *	fVarList
	List of the variables.

Int_t	fWeightCut
	Specify a cut on the entries from their weight (see TParallelCoordVar::GetEvtWeight(Long64_t))

Additional Inherited Members
Protected Types inherited from TObject
enum	{ kOnlyPrepStep = (1ULL << ( 3 )) }

Protected Member Functions inherited from TObject
virtual void	DoError (int level, const char location, const char fmt, va_list va) const
	Interface to ErrorHandler (protected).

void	MakeZombie ()

Protected Attributes inherited from TNamed
TString	fName

TString	fTitle

#include <TParallelCoord.h>

Inheritance diagram for TParallelCoord:

[legend]

Member Enumeration Documentation

◆ EStatusBits

enum TParallelCoord::EStatusBits

Enumerator
kVertDisplay	If the axes are drawn vertically, false if horizontally.
kCurveDisplay	If the polylines are replaced by interpolated curves.
kPaintEntries	To paint all TParallelCoord entries.
kLiveUpdate	To paint the entries when being modified.
kGlobalScale	Every variable is on the same scale.
kCandleChart	To produce a candle chart.
kGlobalLogScale	Every variable in log scale.

Definition at line 30 of file TParallelCoord.h.

Constructor & Destructor Documentation

◆ TParallelCoord() [1/3]

TParallelCoord::TParallelCoord ( )

Default constructor.

Definition at line 130 of file TParallelCoord.cxx.

◆ TParallelCoord() [2/3]

TParallelCoord::TParallelCoord ( Long64_t nentries )

Constructor without a reference to a tree, the datas must be added afterwards with TParallelCoord::AddVariable(Double_t*,const char*).

Definition at line 141 of file TParallelCoord.cxx.

◆ TParallelCoord() [3/3]

TParallelCoord::TParallelCoord	(	TTree *	tree,
		Long64_t	nentries
	)

Normal constructor, the datas must be added afterwards with TParallelCoord::AddVariable(Double_t*,const char*).

Definition at line 156 of file TParallelCoord.cxx.

◆ ~TParallelCoord()

TParallelCoord::~TParallelCoord ( )

virtual

Destructor.

Definition at line 181 of file TParallelCoord.cxx.

Member Function Documentation

◆ AddSelection()

void TParallelCoord::AddSelection ( const char * title )

Add a selection.

Definition at line 242 of file TParallelCoord.cxx.

◆ AddVariable() [1/2]

void TParallelCoord::AddVariable ( const char * varexp )

Add a variable from an expression.

Definition at line 209 of file TParallelCoord.cxx.

◆ AddVariable() [2/2]

void TParallelCoord::AddVariable	(	Double_t *	val,
		const char *	title = `""`
	)

Add a variable.

Definition at line 199 of file TParallelCoord.cxx.

◆ ApplySelectionToTree()

void TParallelCoord::ApplySelectionToTree ( )

Apply the current selection to the tree.

Definition at line 252 of file TParallelCoord.cxx.

◆ BuildParallelCoord()

void TParallelCoord::BuildParallelCoord	(	TSelectorDraw *	selector,
		Bool_t	candle
	)

static

Call constructor and add the variables.

Definition at line 288 of file TParallelCoord.cxx.

◆ Class()

static TClass * TParallelCoord::Class ( )

static

Returns: TClass describing this class

◆ Class_Name()

static const char * TParallelCoord::Class_Name ( )

static

Returns: Name of this class

◆ Class_Version()

static constexpr Version_t TParallelCoord::Class_Version ( )

inlinestaticconstexpr

Returns: Version of this class

Definition at line 136 of file TParallelCoord.h.

◆ CleanUpSelections()

void TParallelCoord::CleanUpSelections ( TParallelCoordRange * range )

Clean up the selections from the ranges which could have been deleted when a variable has been deleted.

Definition at line 313 of file TParallelCoord.cxx.

◆ DeclFileName()

static const char * TParallelCoord::DeclFileName ( )

inlinestatic

Returns: Name of the file containing the class declaration

Definition at line 136 of file TParallelCoord.h.

◆ DeleteSelection()

void TParallelCoord::DeleteSelection ( TParallelCoordSelect * sel )

Delete a selection.

Definition at line 325 of file TParallelCoord.cxx.

◆ DistancetoPrimitive()

Int_t TParallelCoord::DistancetoPrimitive	(	Int_t	px,
		Int_t	py
	)

virtual

Compute the distance from the TParallelCoord.

Reimplemented from TObject.

Definition at line 336 of file TParallelCoord.cxx.

◆ Draw()

void TParallelCoord::Draw ( Option_t * options = "" )

virtual

Draw the parallel coordinates graph.

Reimplemented from TObject.

Definition at line 359 of file TParallelCoord.cxx.

◆ ExecuteEvent()

void TParallelCoord::ExecuteEvent	(	Int_t	entry,
		Int_t	px,
		Int_t	py
	)

virtual

Execute the corresponding entry.

Reimplemented from TObject.

Definition at line 429 of file TParallelCoord.cxx.

◆ GetCandleChart()

Bool_t TParallelCoord::GetCandleChart ( )

inline

Definition at line 81 of file TParallelCoord.h.

◆ GetCurrentFirst()

Long64_t TParallelCoord::GetCurrentFirst ( )

inline

Definition at line 82 of file TParallelCoord.h.

◆ GetCurrentN()

Long64_t TParallelCoord::GetCurrentN ( )

inline

Definition at line 83 of file TParallelCoord.h.

◆ GetCurrentSelection()

TParallelCoordSelect * TParallelCoord::GetCurrentSelection ( )

Return the selection currently being edited.

Definition at line 438 of file TParallelCoord.cxx.

◆ GetCurveDisplay()

Bool_t TParallelCoord::GetCurveDisplay ( ) const

inline

Definition at line 85 of file TParallelCoord.h.

◆ GetDotsSpacing()

Int_t TParallelCoord::GetDotsSpacing ( ) const

inline

Definition at line 86 of file TParallelCoord.h.

◆ GetEntryList()

TEntryList * TParallelCoord::GetEntryList ( Bool_t sel = kTRUE )

Get the whole entry list or one for a selection.

Definition at line 450 of file TParallelCoord.cxx.

◆ GetGlobalLogScale()

Bool_t TParallelCoord::GetGlobalLogScale ( )

inline

Definition at line 91 of file TParallelCoord.h.

◆ GetGlobalMax()

Double_t TParallelCoord::GetGlobalMax ( )

return the global maximum.

Definition at line 474 of file TParallelCoord.cxx.

◆ GetGlobalMin()

Double_t TParallelCoord::GetGlobalMin ( )

return the global minimum.

Definition at line 488 of file TParallelCoord.cxx.

◆ GetGlobalScale()

Bool_t TParallelCoord::GetGlobalScale ( )

inline

Definition at line 90 of file TParallelCoord.h.

◆ GetLineColor()

Color_t TParallelCoord::GetLineColor ( )

inline

Definition at line 92 of file TParallelCoord.h.

◆ GetLineWidth()

Width_t TParallelCoord::GetLineWidth ( )

inline

Definition at line 93 of file TParallelCoord.h.

◆ GetNbins()

Int_t TParallelCoord::GetNbins ( )

get the binning of the histograms.

Definition at line 502 of file TParallelCoord.cxx.

◆ GetNentries()

Long64_t TParallelCoord::GetNentries ( )

inline

Definition at line 96 of file TParallelCoord.h.

◆ GetNvar()

UInt_t TParallelCoord::GetNvar ( )

inline

Definition at line 95 of file TParallelCoord.h.

◆ GetSelection()

TParallelCoordSelect * TParallelCoord::GetSelection ( const char * title )

Get a selection from its title.

Definition at line 510 of file TParallelCoord.cxx.

◆ GetSelectList()

TList * TParallelCoord::GetSelectList ( )

inline

Definition at line 97 of file TParallelCoord.h.

◆ GetTree()

TTree * TParallelCoord::GetTree ( )

return the tree if fTree is defined.

If not, the method try to load the tree from fTreeFileName.

Definition at line 522 of file TParallelCoord.cxx.

◆ GetVariable() [1/2]

Double_t * TParallelCoord::GetVariable ( const char * var )

Get the variables values from its title.

Definition at line 564 of file TParallelCoord.cxx.

◆ GetVariable() [2/2]

Double_t * TParallelCoord::GetVariable ( Int_t i )

Get the variables values from its index.

Definition at line 576 of file TParallelCoord.cxx.

◆ GetVarList()

TList * TParallelCoord::GetVarList ( )

inline

Definition at line 102 of file TParallelCoord.h.

◆ GetVertDisplay()

Bool_t TParallelCoord::GetVertDisplay ( ) const

inline

Definition at line 103 of file TParallelCoord.h.

◆ GetWeightCut()

Int_t TParallelCoord::GetWeightCut ( ) const

inline

Definition at line 104 of file TParallelCoord.h.

◆ Init()

void TParallelCoord::Init ( )

private

Initialise the data members of TParallelCoord.

Definition at line 585 of file TParallelCoord.cxx.

◆ IsA()

virtual TClass * TParallelCoord::IsA ( ) const

inlinevirtual

Returns: TClass describing current object

Reimplemented from TNamed.

Definition at line 136 of file TParallelCoord.h.

◆ Paint()

void TParallelCoord::Paint ( Option_t * options = "" )

virtual

Paint the parallel coordinates graph.

Reimplemented from TObject.

Definition at line 616 of file TParallelCoord.cxx.

◆ PaintEntries()

void TParallelCoord::PaintEntries ( TParallelCoordSelect * sel = nullptr )

private

Loop over the entries and paint them.

Definition at line 645 of file TParallelCoord.cxx.

◆ RemoveVariable() [1/2]

Bool_t TParallelCoord::RemoveVariable ( const char * var )

Delete the variable "vartitle" from the graph.

Definition at line 739 of file TParallelCoord.cxx.

◆ RemoveVariable() [2/2]

void TParallelCoord::RemoveVariable ( TParallelCoordVar * var )

Delete a variable from the graph.

Definition at line 729 of file TParallelCoord.cxx.

◆ ResetTree()

void TParallelCoord::ResetTree ( )

Reset the tree entry list to the initial one..

Definition at line 759 of file TParallelCoord.cxx.

◆ SaveEntryLists()

void TParallelCoord::SaveEntryLists	(	const char *	filename = `""`,
		Bool_t	overwrite = `kFALSE`
	)

Save the entry lists in a root file "filename.root".

Definition at line 791 of file TParallelCoord.cxx.

◆ SavePrimitive()

void TParallelCoord::SavePrimitive	(	std::ostream &	out,
		Option_t *	options
	)

virtual

Save the TParallelCoord in a macro.

Reimplemented from TObject.

Definition at line 814 of file TParallelCoord.cxx.

◆ SaveTree()

void TParallelCoord::SaveTree	(	const char *	filename = `""`,
		Bool_t	overwrite = `kFALSE`
	)

Save the tree in a file if fTreeFileName == "".

Definition at line 883 of file TParallelCoord.cxx.

◆ SetAxesPosition()

void TParallelCoord::SetAxesPosition ( )

private

Update the position of the axes.

Definition at line 907 of file TParallelCoord.cxx.

◆ SetAxisHistogramBinning()

void TParallelCoord::SetAxisHistogramBinning ( Int_t n = 100 )

Set the same histogram axis binning for all axis.

Definition at line 951 of file TParallelCoord.cxx.

◆ SetAxisHistogramHeight()

void TParallelCoord::SetAxisHistogramHeight ( Double_t h = 0.5 )

Set the same histogram axis height for all axis.

Definition at line 961 of file TParallelCoord.cxx.

◆ SetAxisHistogramLineWidth()

void TParallelCoord::SetAxisHistogramLineWidth ( Int_t lw = 2 )

Set the same histogram axis line width for all axis.

Definition at line 1017 of file TParallelCoord.cxx.

◆ SetCandleChart()

void TParallelCoord::SetCandleChart ( Bool_t can )

Set a candle chart display.

Definition at line 1027 of file TParallelCoord.cxx.

◆ SetCurrentEntries()

void TParallelCoord::SetCurrentEntries ( TEntryList * entries )

inline

Definition at line 115 of file TParallelCoord.h.

◆ SetCurrentFirst()

void TParallelCoord::SetCurrentFirst ( Long64_t f )

Set the first entry to be displayed.

Definition at line 1057 of file TParallelCoord.cxx.

◆ SetCurrentN()

void TParallelCoord::SetCurrentN ( Long64_t n )

Set the number of entry to be displayed.

Definition at line 1074 of file TParallelCoord.cxx.

◆ SetCurrentSelection() [1/2]

TParallelCoordSelect * TParallelCoord::SetCurrentSelection ( const char * title )

Set the selection being edited.

Definition at line 1091 of file TParallelCoord.cxx.

◆ SetCurrentSelection() [2/2]

void TParallelCoord::SetCurrentSelection ( TParallelCoordSelect * sel )

Set the selection being edited.

Definition at line 1104 of file TParallelCoord.cxx.

◆ SetCurveDisplay()

virtual void TParallelCoord::SetCurveDisplay ( Bool_t curve = 1 )

inlinevirtual

Definition at line 114 of file TParallelCoord.h.

◆ SetDotsSpacing()

void TParallelCoord::SetDotsSpacing ( Int_t s = 0 )

Set dots spacing.

Modify the line style 11. If the canvas support transparency dot spacing is ignored.

Definition at line 1114 of file TParallelCoord.cxx.

◆ SetEntryList()

void TParallelCoord::SetEntryList	(	TParallelCoord *	para,
		TEntryList *	enlist
	)

static

Set the entry lists of "para".

Definition at line 1125 of file TParallelCoord.cxx.

◆ SetGlobalLogScale()

void TParallelCoord::SetGlobalLogScale ( Bool_t lt )

All axes in log scale.

Definition at line 971 of file TParallelCoord.cxx.

◆ SetGlobalMax()

void TParallelCoord::SetGlobalMax ( Double_t max )

Force all variables to adopt the same max.

Definition at line 1134 of file TParallelCoord.cxx.

◆ SetGlobalMin()

void TParallelCoord::SetGlobalMin ( Double_t min )

Force all variables to adopt the same min.

Definition at line 1146 of file TParallelCoord.cxx.

◆ SetGlobalScale()

void TParallelCoord::SetGlobalScale ( Bool_t gl )

Constraint all axes to the same scale.

Definition at line 984 of file TParallelCoord.cxx.

◆ SetInitEntries()

void TParallelCoord::SetInitEntries ( TEntryList * entries )

inline

Definition at line 126 of file TParallelCoord.h.

◆ SetLineColor()

void TParallelCoord::SetLineColor ( Color_t col )

inline

Definition at line 127 of file TParallelCoord.h.

◆ SetLineWidth()

void TParallelCoord::SetLineWidth ( Width_t wid )

inline

Definition at line 128 of file TParallelCoord.h.

◆ SetLiveRangesUpdate()

void TParallelCoord::SetLiveRangesUpdate ( Bool_t on )

If true, the pad is updated while the motion of a dragged range.

Definition at line 1158 of file TParallelCoord.cxx.

◆ SetNentries()

void TParallelCoord::SetNentries ( Long64_t n )

inline

Definition at line 130 of file TParallelCoord.h.

◆ SetTree()

void TParallelCoord::SetTree ( TTree * tree )

inline

Definition at line 131 of file TParallelCoord.h.

◆ SetVertDisplay()

void TParallelCoord::SetVertDisplay ( Bool_t vert = kTRUE )

Set the vertical or horizontal display.

Definition at line 1169 of file TParallelCoord.cxx.

◆ SetWeightCut()

void TParallelCoord::SetWeightCut ( Int_t w = 0 )

inline

Definition at line 133 of file TParallelCoord.h.

◆ Streamer()

virtual void TParallelCoord::Streamer ( TBuffer & R__b )

virtual

Stream an object of class TObject.

Reimplemented from TNamed.

◆ StreamerNVirtual()

void TParallelCoord::StreamerNVirtual ( TBuffer & ClassDef_StreamerNVirtual_b )

inline

Definition at line 136 of file TParallelCoord.h.

◆ UnzoomAll()

void TParallelCoord::UnzoomAll ( )

Unzoom all variables.

Definition at line 1199 of file TParallelCoord.cxx.

Member Data Documentation

◆ fCandleAxis

TGaxis* TParallelCoord::fCandleAxis

private

! An axis used when displaying a candle chart.

Definition at line 57 of file TParallelCoord.h.

◆ fCurrentEntries

TEntryList* TParallelCoord::fCurrentEntries

private

-> Current selected entries in the tree.

Definition at line 49 of file TParallelCoord.h.

◆ fCurrentFirst

Long64_t TParallelCoord::fCurrentFirst

private

First entry to display.

Definition at line 42 of file TParallelCoord.h.

◆ fCurrentN

Long64_t TParallelCoord::fCurrentN

private

Number of entries to display.

Definition at line 43 of file TParallelCoord.h.

◆ fCurrentSelection

TParallelCoordSelect* TParallelCoord::fCurrentSelection

private

! Current Selection being edited.

Definition at line 56 of file TParallelCoord.h.

◆ fDotsSpacing

Int_t TParallelCoord::fDotsSpacing

private

Spacing between dots to draw the entries.

Definition at line 45 of file TParallelCoord.h.

◆ fInitEntries

TEntryList* TParallelCoord::fInitEntries

private

-> Selected entries when TParallelCoord first initialized.

Definition at line 50 of file TParallelCoord.h.

◆ fLineColor

Color_t TParallelCoord::fLineColor

private

entries line color.

Definition at line 46 of file TParallelCoord.h.

◆ fLineWidth

Width_t TParallelCoord::fLineWidth

private

entries line width.

Definition at line 47 of file TParallelCoord.h.

◆ fNentries

Long64_t TParallelCoord::fNentries

private

Number of entries;.

Definition at line 44 of file TParallelCoord.h.

◆ fNvar

UInt_t TParallelCoord::fNvar

private

Number of variables.

Definition at line 41 of file TParallelCoord.h.

◆ fSelectList

TList* TParallelCoord::fSelectList

private

List of selections over the variables.

Definition at line 55 of file TParallelCoord.h.

◆ fTree

TTree* TParallelCoord::fTree

private

! Pointer to the TTree.

Definition at line 51 of file TParallelCoord.h.

◆ fTreeFileName

TString TParallelCoord::fTreeFileName

private

Name of the file containing the tree.

Definition at line 53 of file TParallelCoord.h.

◆ fTreeName

TString TParallelCoord::fTreeName

private

Name of the tree.

Definition at line 52 of file TParallelCoord.h.

◆ fVarList

TList* TParallelCoord::fVarList

private

List of the variables.

Definition at line 54 of file TParallelCoord.h.

◆ fWeightCut

Int_t TParallelCoord::fWeightCut

private

Specify a cut on the entries from their weight (see TParallelCoordVar::GetEvtWeight(Long64_t))

Definition at line 48 of file TParallelCoord.h.

Libraries for TParallelCoord:

[legend]

The documentation for this class was generated from the following files:

tree/treeviewer/inc/TParallelCoord.h
tree/treeviewer/src/TParallelCoord.cxx

Reduce cluttering:

Selections:

Axes:

Candle chart:

Some references:

Public Types

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Member Enumeration Documentation

◆ EStatusBits

Constructor & Destructor Documentation

◆ TParallelCoord() [1/3]

◆ TParallelCoord() [2/3]

◆ TParallelCoord() [3/3]

◆ ~TParallelCoord()

Member Function Documentation

◆ AddSelection()

◆ AddVariable() [1/2]

◆ AddVariable() [2/2]

◆ ApplySelectionToTree()

◆ BuildParallelCoord()

◆ Class()

◆ Class_Name()

◆ Class_Version()

◆ CleanUpSelections()

◆ DeclFileName()

◆ DeleteSelection()

◆ DistancetoPrimitive()

◆ Draw()

◆ ExecuteEvent()

◆ GetCandleChart()

◆ GetCurrentFirst()

◆ GetCurrentN()

◆ GetCurrentSelection()

◆ GetCurveDisplay()

◆ GetDotsSpacing()

◆ GetEntryList()

◆ GetGlobalLogScale()

◆ GetGlobalMax()

◆ GetGlobalMin()

◆ GetGlobalScale()

◆ GetLineColor()

◆ GetLineWidth()

◆ GetNbins()

◆ GetNentries()

◆ GetNvar()

◆ GetSelection()

◆ GetSelectList()

◆ GetTree()

◆ GetVariable() [1/2]

◆ GetVariable() [2/2]

◆ GetVarList()

◆ GetVertDisplay()

◆ GetWeightCut()

◆ Init()

◆ IsA()

◆ Paint()

◆ PaintEntries()

◆ RemoveVariable() [1/2]

◆ RemoveVariable() [2/2]

◆ ResetTree()

◆ SaveEntryLists()

◆ SavePrimitive()

◆ SaveTree()

◆ SetAxesPosition()

◆ SetAxisHistogramBinning()

◆ SetAxisHistogramHeight()

◆ SetAxisHistogramLineWidth()

◆ SetCandleChart()

◆ SetCurrentEntries()

◆ SetCurrentFirst()

◆ SetCurrentN()

◆ SetCurrentSelection() [1/2]

◆ SetCurrentSelection() [2/2]

◆ SetCurveDisplay()

◆ SetDotsSpacing()

◆ SetEntryList()