#include <LeafRefCandidateT.h>

Inheritance diagram for reco::LeafRefCandidateT:

Public Types
typedef int	Charge
	electric charge type More...

typedef CandidateCollection	daughters
	collection of daughter candidates More...

typedef unsigned int	index

typedef math::XYZTLorentzVector	LorentzVector
	Lorentz vector. More...

typedef math::XYZPoint	Point
	point in the space More...

typedef math::PtEtaPhiMLorentzVector	PolarLorentzVector
	Lorentz vector. More...

typedef math::XYZVector	Vector
	point in the space More...

Public Types inherited from reco::LeafCandidate
typedef int	Charge
	electric charge type More...

typedef CandidateCollection	daughters
	collection of daughter candidates More...

typedef unsigned int	index

typedef math::XYZTLorentzVector	LorentzVector
	Lorentz vector. More...

typedef math::XYZPoint	Point
	point in the space More...

typedef math::PtEtaPhiMLorentzVector	PolarLorentzVector
	Lorentz vector. More...

typedef math::XYZVector	Vector
	point in the space More...

Public Types inherited from reco::Candidate
enum	{ dimension = 3 }

enum	{ size = dimension * (dimension + 1)/2 }
	matix size More...

typedef int	Charge
	electric charge type More...

typedef candidate::const_iterator	const_iterator

typedef math::Error< dimension > ::type	CovarianceMatrix
	covariance error matrix (3x3) More...

typedef unsigned int	index
	index type More...

typedef candidate::iterator	iterator

typedef math::XYZTLorentzVector	LorentzVector
	Lorentz vector. More...

typedef math::XYZPoint	Point
	point in the space More...

typedef math::PtEtaPhiMLorentzVector	PolarLorentzVector
	Lorentz vector. More...

typedef size_t	size_type

typedef math::XYZVector	Vector
	point in the space More...

Public Member Functions
virtual const Candidate *	daughter (size_type) const
	return daughter at a given position (throws an exception) More...

virtual Candidate *	daughter (size_type)
	return daughter at a given position (throws an exception) More...

virtual Candidate *	daughter (const std::string &s)
	return daughter with a specified role name More...

virtual const Candidate *	daughter (const std::string &s) const
	return daughter with a specified role name More...

template<typename C >
C	get () const
	get a component More...

template<typename C , typename Tag >
C	get () const
	get a component More...

template<typename C >
C	get (size_type i) const
	get a component More...

template<typename C , typename Tag >
C	get (size_type i) const
	get a component More...

virtual bool	hasMasterClone () const
	This only happens if the concrete Candidate type is ShallowCloneCandidate. More...

virtual bool	hasMasterClonePtr () const

virtual bool	isCaloMuon () const

virtual bool	isConvertedPhoton () const

virtual bool	isElectron () const

virtual bool	isGlobalMuon () const

virtual bool	isJet () const

virtual bool	isMuon () const

virtual bool	isPhoton () const

virtual bool	isStandAloneMuon () const

virtual bool	isTrackerMuon () const

	LeafRefCandidateT ()
	default constructor More...

template<class REF >
	LeafRefCandidateT (const REF &c, float m)

virtual const CandidateBaseRef &	masterClone () const

virtual const CandidatePtr &	masterClonePtr () const

template<typename Ref >
Ref	masterRef () const
	cast master clone reference to a concrete type More...

virtual const Candidate *	mother (size_type) const
	return mother at a given position (throws an exception) More...

template<typename C >
size_type	numberOf () const
	number of components More...

template<typename C , typename Tag >
size_type	numberOf () const
	number of components More...

virtual size_t	numberOfDaughters () const
	number of daughters More...

virtual size_t	numberOfMothers () const
	number of mothers More...

virtual size_t	numberOfSourceCandidatePtrs () const

virtual CandidatePtr	sourceCandidatePtr (size_type i) const

virtual	~LeafRefCandidateT ()
	destructor More...

Public Member Functions inherited from reco::LeafCandidate
virtual Vector	boostToCM () const

virtual int	charge () const
	electric charge More...

virtual LeafCandidate *	clone () const
	returns a clone of the Candidate object More...

void	construct (int qx3, float pt, float eta, float phi, float mass, const Point &vtx, int pdgId, int status)

virtual double	energy () const
	energy More...

virtual double	et () const
	transverse energy More...

virtual double	et2 () const
	transverse energy squared (use this for cut!) More...

virtual double	eta () const
	momentum pseudorapidity More...

virtual void	fillVertexCovariance (CovarianceMatrix &v) const
	fill SMatrix More...

template<typename T >
T	get () const
	get a component More...

template<typename T , typename Tag >
T	get () const
	get a component More...

template<typename T >
T	get (size_type i) const
	get a component More...

template<typename T , typename Tag >
T	get (size_type i) const
	get a component More...

	LeafCandidate ()

	LeafCandidate (const Candidate &c)

template<typename... Args>
	LeafCandidate (Args &&...args)

	LeafCandidate (LeafCandidate &rh)

	LeafCandidate (LeafCandidate &&)=default

	LeafCandidate (LeafCandidate const &)=default

virtual bool	longLived () const
	is long lived? More...

virtual double	mass () const
	mass More...

virtual bool	massConstraint () const
	do mass constraint? More...

virtual double	massSqr () const
	mass squared More...

template<typename Ref >
Ref	masterRef () const
	cast master clone reference to a concrete type More...

virtual Vector	momentum () const
	spatial momentum vector More...

virtual double	mt () const
	transverse mass More...

virtual double	mtSqr () const
	transverse mass squared More...

template<typename T >
size_type	numberOf () const
	number of components More...

template<typename T , typename Tag >
size_type	numberOf () const
	number of components More...

LeafCandidate &	operator= (LeafCandidate &&)=default

LeafCandidate &	operator= (LeafCandidate const &)=default

virtual double	p () const
	magnitude of momentum vector More...

virtual const LorentzVector &	p4 () const
	four-momentum Lorentz vector More...

virtual int	pdgId () const
	PDG identifier. More...

virtual double	phi () const
	momentum azimuthal angle More...

virtual const PolarLorentzVector &	polarP4 () const
	four-momentum Lorentz vector More...

virtual double	pt () const
	transverse momentum More...

virtual double	px () const
	x coordinate of momentum vector More...

virtual double	py () const
	y coordinate of momentum vector More...

virtual double	pz () const
	z coordinate of momentum vector More...

virtual double	rapidity () const
	rapidity More...

virtual void	setCharge (Charge q)
	set electric charge More...

virtual void	setLongLived ()

virtual void	setMass (double m)
	set particle mass More...

virtual void	setMassConstraint ()

virtual void	setP4 (const LorentzVector &p4)
	set 4-momentum More...

virtual void	setP4 (const PolarLorentzVector &p4)
	set 4-momentum More...

virtual void	setPdgId (int pdgId)

virtual void	setPz (double pz)

virtual void	setStatus (int status)
	set status word More...

virtual void	setThreeCharge (Charge qx3)
	set electric charge More...

virtual void	setVertex (const Point &vertex)
	set vertex More...

virtual int	status () const
	status word More...

virtual double	theta () const
	momentum polar angle More...

virtual int	threeCharge () const
	electric charge More...

virtual const Point &	vertex () const
	vertex position (overwritten by PF...) More...

virtual double	vertexChi2 () const
	chi-squares More...

virtual double	vertexCovariance (int i, int j) const
	(i, j)-th element of error matrix, i, j = 0, ... 2 More...

CovarianceMatrix	vertexCovariance () const
	return SMatrix More...

virtual double	vertexNdof () const

virtual double	vertexNormalizedChi2 () const
	chi-squared divided by n.d.o.f. More...

virtual double	vx () const
	x coordinate of vertex position More...

virtual double	vy () const
	y coordinate of vertex position More...

virtual double	vz () const
	z coordinate of vertex position More...

virtual double	y () const
	rapidity More...

virtual	~LeafCandidate ()
	destructor More...

Public Member Functions inherited from reco::Candidate
const_iterator	begin () const
	first daughter const_iterator More...

iterator	begin ()
	first daughter iterator More...

virtual const Track *	bestTrack () const

	Candidate ()
	default constructor More...

virtual float	dxyError () const
	uncertainty on dxy More...

virtual float	dzError () const
	uncertainty on dz More...

const_iterator	end () const
	last daughter const_iterator More...

iterator	end ()
	last daughter iterator More...

template<typename T >
T	get () const
	get a component More...

template<typename T , typename Tag >
T	get () const
	get a component More...

template<typename T >
T	get (size_type i) const
	get a component More...

template<typename T , typename Tag >
T	get (size_type i) const
	get a component More...

template<typename Ref >
Ref	masterRef () const
	cast master clone reference to a concrete type More...

template<typename T >
size_type	numberOf () const
	number of components More...

template<typename T , typename Tag >
size_type	numberOf () const
	number of components More...

virtual void	setSourceCandidatePtr (const CandidatePtr &ptr)
	Set the ptr to the source Candidate. More...

virtual	~Candidate ()
	destructor More...

Static Public Member Functions
static short	Class_Version ()

Protected Member Functions
template<typename REF >
REF	getRef () const

virtual bool	overlap (const Candidate &) const
	check overlap with another Candidate More...

virtual bool	overlap (const LeafRefCandidateT &) const

Protected Attributes
edm::RefCoreWithIndex	ref_

Friends
class	::OverlapChecker

template<typename , typename , typename >
struct	component

class	ShallowCloneCandidate

class	ShallowClonePtrCandidate

Detailed Description

particle candidate with no constituent nor daughters, that takes the 3-vector from a constituent T (where T satisfies T->pt(), etc, like a TrackRef), and the mass is set

Author: Luca Lista, INFN

Definition at line 18 of file LeafRefCandidateT.h.

Member Typedef Documentation

typedef int reco::LeafRefCandidateT::Charge

electric charge type

Definition at line 23 of file LeafRefCandidateT.h.

typedef CandidateCollection reco::LeafRefCandidateT::daughters

collection of daughter candidates

Definition at line 21 of file LeafRefCandidateT.h.

typedef unsigned int reco::LeafRefCandidateT::index

Definition at line 33 of file LeafRefCandidateT.h.

typedef math::XYZTLorentzVector reco::LeafRefCandidateT::LorentzVector

Lorentz vector.

Definition at line 25 of file LeafRefCandidateT.h.

typedef math::XYZPoint reco::LeafRefCandidateT::Point

point in the space

Definition at line 29 of file LeafRefCandidateT.h.

typedef math::PtEtaPhiMLorentzVector reco::LeafRefCandidateT::PolarLorentzVector

Lorentz vector.

Definition at line 27 of file LeafRefCandidateT.h.

typedef math::XYZVector reco::LeafRefCandidateT::Vector

point in the space

Definition at line 31 of file LeafRefCandidateT.h.

Constructor & Destructor Documentation

reco::LeafRefCandidateT::LeafRefCandidateT ( )

inline

default constructor

Definition at line 36 of file LeafRefCandidateT.h.

36 { }

template<class REF >

reco::LeafRefCandidateT::LeafRefCandidateT	(	const REF &	c,
		float	m
	)

inline

Definition at line 39 of file LeafRefCandidateT.h.

                                                :  
       LeafCandidate(c->charge(),PolarLorentzVector(c->pt(), c->eta(), c->phi(), m ),c->vertex()),
       ref_(c.refCore(), c.key()){}

virtual reco::LeafRefCandidateT::~LeafRefCandidateT ( )

inlinevirtual

destructor

Definition at line 43 of file LeafRefCandidateT.h.

43 {}

Member Function Documentation

static short reco::LeafRefCandidateT::Class_Version ( )

inlinestatic

Definition at line 139 of file LeafRefCandidateT.h.

141 :

142

virtual const Candidate* reco::LeafRefCandidateT::daughter ( size_type ) const

inlinevirtual

return daughter at a given position (throws an exception)

Reimplemented from reco::LeafCandidate.

Definition at line 54 of file LeafRefCandidateT.h.

54 { return 0; }

virtual Candidate* reco::LeafRefCandidateT::daughter ( size_type )

inlinevirtual

return daughter at a given position (throws an exception)

Reimplemented from reco::LeafCandidate.

Definition at line 60 of file LeafRefCandidateT.h.

60 { return 0; }

virtual Candidate* reco::LeafRefCandidateT::daughter ( const std::string & s )

inlinevirtual

return daughter with a specified role name

Reimplemented from reco::LeafCandidate.

Definition at line 62 of file LeafRefCandidateT.h.

62 { return 0; }

virtual const Candidate* reco::LeafRefCandidateT::daughter ( const std::string & s ) const

inlinevirtual

return daughter with a specified role name

Reimplemented from reco::LeafCandidate.

Definition at line 64 of file LeafRefCandidateT.h.

64 { return 0; }

template<typename C >

C reco::LeafRefCandidateT::get ( ) const

inline

get a component

Definition at line 98 of file LeafRefCandidateT.h.

References hasMasterClone(), and masterClone().

Referenced by Options.Options::__getitem__(), betterConfigParser.BetterConfigParser::__updateDict(), rrapi.RRApi::columns(), rrapi.RRApi::count(), rrapi.RRApi::data(), betterConfigParser.BetterConfigParser::getCompares(), betterConfigParser.BetterConfigParser::getGeneral(), betterConfigParser.BetterConfigParser::getResultingSection(), rrapi.RRApi::report(), rrapi.RRApi::reports(), rrapi.RRApi::tables(), rrapi.RRApi::tags(), rrapi.RRApi::templates(), and rrapi.RRApi::workspaces().

                                        {
       if ( hasMasterClone() ) return masterClone()->template get<C>();
       else return reco::get<C>( * this );
     }

template<typename C , typename Tag >

C reco::LeafRefCandidateT::get ( ) const

inline

get a component

Definition at line 103 of file LeafRefCandidateT.h.

References hasMasterClone(), and masterClone().

Referenced by Options.Options::__getitem__(), betterConfigParser.BetterConfigParser::__updateDict(), rrapi.RRApi::columns(), rrapi.RRApi::count(), rrapi.RRApi::data(), betterConfigParser.BetterConfigParser::getCompares(), betterConfigParser.BetterConfigParser::getGeneral(), betterConfigParser.BetterConfigParser::getResultingSection(), rrapi.RRApi::report(), rrapi.RRApi::reports(), rrapi.RRApi::tables(), rrapi.RRApi::tags(), rrapi.RRApi::templates(), and rrapi.RRApi::workspaces().

                                                      {
       if ( hasMasterClone() ) return masterClone()->template get<C, Tag>();
       else return reco::get<C, Tag>( * this );
     }

template<typename C >

C reco::LeafRefCandidateT::get ( size_type i ) const

inline

get a component

Definition at line 108 of file LeafRefCandidateT.h.

References hasMasterClone(), i, and masterClone().

Referenced by Options.Options::__getitem__(), betterConfigParser.BetterConfigParser::__updateDict(), rrapi.RRApi::columns(), rrapi.RRApi::count(), rrapi.RRApi::data(), betterConfigParser.BetterConfigParser::getCompares(), betterConfigParser.BetterConfigParser::getGeneral(), betterConfigParser.BetterConfigParser::getResultingSection(), rrapi.RRApi::report(), rrapi.RRApi::reports(), rrapi.RRApi::tables(), rrapi.RRApi::tags(), rrapi.RRApi::templates(), and rrapi.RRApi::workspaces().

                                                     {
       if ( hasMasterClone() ) return masterClone()->template get<C>( i );
       else return reco::get<C>( * this, i );
     }

template<typename C , typename Tag >

C reco::LeafRefCandidateT::get ( size_type i ) const

inline

get a component

Definition at line 113 of file LeafRefCandidateT.h.

References hasMasterClone(), i, and masterClone().

Referenced by Options.Options::__getitem__(), betterConfigParser.BetterConfigParser::__updateDict(), rrapi.RRApi::columns(), rrapi.RRApi::count(), rrapi.RRApi::data(), betterConfigParser.BetterConfigParser::getCompares(), betterConfigParser.BetterConfigParser::getGeneral(), betterConfigParser.BetterConfigParser::getResultingSection(), rrapi.RRApi::report(), rrapi.RRApi::reports(), rrapi.RRApi::tables(), rrapi.RRApi::tags(), rrapi.RRApi::templates(), and rrapi.RRApi::workspaces().

                                                                   {
       if ( hasMasterClone() ) return masterClone()->template get<C, Tag>( i );
       else return reco::get<C, Tag>( * this, i );
     }

template<typename REF >

REF reco::LeafRefCandidateT::getRef ( ) const

inlineprotected

Definition at line 48 of file LeafRefCandidateT.h.

References edm::RefCoreWithIndex::index(), ref_, and edm::RefCoreWithIndex::toRefCore().

48 { return REF(ref_.toRefCore(),ref_.index()); }

edm::RefCoreWithIndex::index

unsigned int index() const

Definition: RefCoreWithIndex.h:65

edm::RefCoreWithIndex::toRefCore

RefCore const & toRefCore() const

Definition: RefCoreWithIndex.h:84

reco::LeafRefCandidateT::ref_

edm::RefCoreWithIndex ref_

Definition: LeafRefCandidateT.h:152

virtual bool reco::LeafRefCandidateT::hasMasterClone ( ) const

inlinevirtual

This only happens if the concrete Candidate type is ShallowCloneCandidate.

Reimplemented from reco::LeafCandidate.

Definition at line 78 of file LeafRefCandidateT.h.

Referenced by get(), and numberOf().

78 { return false; }

virtual bool reco::LeafRefCandidateT::hasMasterClonePtr ( ) const

inlinevirtual

returns true if this candidate has a ptr to a master clone. This only happens if the concrete Candidate type is ShallowClonePtrCandidate

Reimplemented from reco::LeafCandidate.

Definition at line 86 of file LeafRefCandidateT.h.

86 { return false; }

virtual bool reco::LeafRefCandidateT::isCaloMuon ( ) const

inlinevirtual

Reimplemented from reco::LeafCandidate.

Definition at line 134 of file LeafRefCandidateT.h.

134 { return false; }

virtual bool reco::LeafRefCandidateT::isConvertedPhoton ( ) const

inlinevirtual

Reimplemented from reco::LeafCandidate.

Definition at line 136 of file LeafRefCandidateT.h.

136 { return false; }

virtual bool reco::LeafRefCandidateT::isElectron ( ) const

inlinevirtual

Reimplemented from reco::LeafCandidate.

Definition at line 129 of file LeafRefCandidateT.h.

129 { return false; }

virtual bool reco::LeafRefCandidateT::isGlobalMuon ( ) const

inlinevirtual

Reimplemented from reco::LeafCandidate.

Definition at line 132 of file LeafRefCandidateT.h.

Referenced by Muon.Muon::muonID().

132 { return false; }

virtual bool reco::LeafRefCandidateT::isJet ( ) const

inlinevirtual

Reimplemented from reco::LeafCandidate.

Definition at line 137 of file LeafRefCandidateT.h.

137 { return false; }

virtual bool reco::LeafRefCandidateT::isMuon ( ) const

inlinevirtual

Reimplemented from reco::LeafCandidate.

Definition at line 130 of file LeafRefCandidateT.h.

130 { return false; }

virtual bool reco::LeafRefCandidateT::isPhoton ( ) const

inlinevirtual

Reimplemented from reco::LeafCandidate.

Definition at line 135 of file LeafRefCandidateT.h.

135 { return false; }

virtual bool reco::LeafRefCandidateT::isStandAloneMuon ( ) const

inlinevirtual

Reimplemented from reco::LeafCandidate.

Definition at line 131 of file LeafRefCandidateT.h.

131 { return false; }

virtual bool reco::LeafRefCandidateT::isTrackerMuon ( ) const

inlinevirtual

Reimplemented from reco::LeafCandidate.

Definition at line 133 of file LeafRefCandidateT.h.

133 { return false; }

virtual const CandidateBaseRef& reco::LeafRefCandidateT::masterClone ( ) const

inlinevirtual

returns ptr to master clone, if existing. Throws an exception unless the concrete Candidate type is ShallowCloneCandidate

Reimplemented from reco::LeafCandidate.

Definition at line 81 of file LeafRefCandidateT.h.

Referenced by get(), and numberOf().

                                                                       { 
       static const CandidateBaseRef dummyRef; return dummyRef; 
     }

virtual const CandidatePtr& reco::LeafRefCandidateT::masterClonePtr ( ) const

inlinevirtual

returns ptr to master clone, if existing. Throws an exception unless the concrete Candidate type is ShallowClonePtrCandidate

Reimplemented from reco::LeafCandidate.

Definition at line 89 of file LeafRefCandidateT.h.

                                                                      { 
       static const CandidatePtr dummyPtr; return dummyPtr; 
     }

template<typename Ref >

Ref reco::LeafRefCandidateT::masterRef ( ) const

inline

cast master clone reference to a concrete type

Definition at line 95 of file LeafRefCandidateT.h.

95 { Ref dummyRef; return dummyRef; }

reco::JetExtendedAssociation::Ref

edm::Ref< Container > Ref

Definition: JetExtendedAssociation.h:32

virtual const Candidate* reco::LeafRefCandidateT::mother ( size_type ) const

inlinevirtual

return mother at a given position (throws an exception)

Reimplemented from reco::LeafCandidate.

Definition at line 58 of file LeafRefCandidateT.h.

58 { return 0; }

template<typename C >

size_type reco::LeafRefCandidateT::numberOf ( ) const

inline

number of components

Definition at line 118 of file LeafRefCandidateT.h.

References hasMasterClone(), and masterClone().

                                                     {
       if ( hasMasterClone() ) return masterClone()->template numberOf<C>();
       else return reco::numberOf<C>( * this );
     }

template<typename C , typename Tag >

size_type reco::LeafRefCandidateT::numberOf ( ) const

inline

number of components

Definition at line 123 of file LeafRefCandidateT.h.

References hasMasterClone(), and masterClone().

                                                                   {
       if ( hasMasterClone() ) return masterClone()->template numberOf<C, Tag>();
       else return reco::numberOf<C, Tag>( * this );
     }

virtual size_t reco::LeafRefCandidateT::numberOfDaughters ( ) const

inlinevirtual

number of daughters

Reimplemented from reco::LeafCandidate.

Definition at line 52 of file LeafRefCandidateT.h.

52 { return 0; }

virtual size_t reco::LeafRefCandidateT::numberOfMothers ( ) const

inlinevirtual

number of mothers

Reimplemented from reco::LeafCandidate.

Definition at line 56 of file LeafRefCandidateT.h.

56 { return 0; }

virtual size_t reco::LeafRefCandidateT::numberOfSourceCandidatePtrs ( ) const

inlinevirtual

return the number of source Candidates ( the candidates used to construct this Candidate)

Reimplemented from reco::LeafCandidate.

Definition at line 67 of file LeafRefCandidateT.h.

67 { return 0;}

bool reco::LeafRefCandidateT::overlap ( const Candidate & o ) const

inlineprotectedvirtual

check overlap with another Candidate

Reimplemented from reco::LeafCandidate.

Definition at line 181 of file LeafRefCandidateT.h.

References reco::LeafCandidate::charge(), reco::LeafCandidate::p4(), and reco::LeafCandidate::vertex().

                                                               { 
     return  p4() == o.p4() && vertex() == o.vertex() && charge() == o.charge();
   }

bool reco::LeafRefCandidateT::overlap ( const LeafRefCandidateT & o ) const

inlineprotectedvirtual

Definition at line 186 of file LeafRefCandidateT.h.

References edm::RefCoreWithIndex::id(), edm::RefCoreWithIndex::index(), and ref_.

                                                                        { 
     return  (ref_.id() == o.ref_.id()) & (ref_.index() == o.ref_.index());
   }

virtual CandidatePtr reco::LeafRefCandidateT::sourceCandidatePtr ( size_type i ) const

inlinevirtual

return a Ptr to one of the source Candidates ( the candidates used to construct this Candidate)

Reimplemented from reco::LeafCandidate.

Definition at line 70 of file LeafRefCandidateT.h.

                                                                               {
       static const CandidatePtr dummyPtr;
       return dummyPtr;
     }

Friends And Related Function Documentation

friend class ::OverlapChecker

friend

Definition at line 147 of file LeafRefCandidateT.h.

template<typename , typename , typename >

friend struct component

friend

Definition at line 146 of file LeafRefCandidateT.h.

friend class ShallowCloneCandidate

friend

Definition at line 148 of file LeafRefCandidateT.h.

friend class ShallowClonePtrCandidate

friend

Definition at line 149 of file LeafRefCandidateT.h.

Member Data Documentation

edm::RefCoreWithIndex reco::LeafRefCandidateT::ref_

protected

Definition at line 152 of file LeafRefCandidateT.h.

Referenced by getRef(), and overlap().

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation