jet::utils Namespace Reference

Functions
template<typename T >
bool	isTypeObjFromString (const std::string &str)
template<typename T >
bool	isTypeObjFromString (const TString &str)
template<typename T >
bool	getTypeObjFromString (const std::string &str, T &obj)
template<typename T >
T	getTypeObjFromString (const std::string &str)
template<typename T >
bool	getTypeObjFromString (const TString &str, T &obj)
template<typename T >
T	getTypeObjFromString (const TString &str)
template<>
bool	getTypeObjFromString< std::string > (const std::string &str, std::string &obj)
template<>
bool	getTypeObjFromString< TString > (const std::string &str, TString &obj)
template<>
bool	getTypeObjFromString< bool > (const std::string &str, bool &obj)
template<>
bool	getTypeObjFromString< std::string > (const TString &str, std::string &obj)
template<>
bool	getTypeObjFromString< TString > (const TString &str, TString &obj)
template<>
bool	getTypeObjFromString< bool > (const TString &str, bool &obj)
template<typename T >
bool	vectorize (const TString &str, const TString &sep, std::vector< T > &result)
template<typename T >
std::vector< T >	vectorize (const TString &str, const TString &sep)
bool	fileExists (const TString &fileName)
TString	findFilePath (const TString &fileName, const TString &path="", const TString &calibArea="")
TFile *	readRootFile (const TString &fileName, const TString &path="", const TString &calibArea="")
std::vector< double >	getLogBins (const size_t numBins, const double minVal, const double maxVal)
std::vector< double >	getUniformBins (const size_t numBins, const double minVal, const double maxVal)
void	scaleHistoAxes (TH1 *toScale, const double factorX=1, const double factorY=1, const double factorZ=1)

Function Documentation

fileExists()

bool jet::utils::fileExists

(

const TString &

fileName

)

Definition at line 94 of file Reconstruction/Jet/JetUncertainties/Root/Helpers.cxx.

{
    return !gSystem->AccessPathName(fileName);
}

findFilePath()

TString jet::utils::findFilePath	(	const TString &	fileName,
		const TString &	path = "",
		const TString &	calibArea = ""
	)

Definition at line 99 of file Reconstruction/Jet/JetUncertainties/Root/Helpers.cxx.

{
    TString pathToGet = "";
 
    // First, try the raw filename plus path (user-specified), then raw filename (local or full path)
    if (path != "" && fileExists(path+(path.EndsWith("/")?"":"/")+fileName))
        pathToGet = path+(path.EndsWith("/")?"":"/")+fileName;
    else if (fileExists(fileName))
        pathToGet = fileName;
    
    // Next, try PathResolver in a few configurations
    // PathResolver #1: versioned CalibArea (most users should be in this case)
    //coverity[copy_paste_error]
    if (pathToGet == "" && calibArea != "")
        pathToGet = TString(PathResolverFindCalibFile(Form("JetUncertainties/%s/%s",calibArea.Data(),fileName.Data())).c_str());
    // PathResolver #2: unversioned CalibArea (legacy support)
    if (pathToGet == "" && calibArea == "")
        pathToGet = TString(PathResolverFindCalibFile(Form("JetUncertainties/%s",fileName.Data())).c_str());
    // PathResolver #3: general search in case of files residing in other packages (request from a Higgs group)
    if (pathToGet == "")
        pathToGet = TString(PathResolverFindCalibFile(fileName.Data()).c_str());    
    
    // Try backup locations now (legacy support)
    if (pathToGet == "")
    {
        // Try ROOTCOREBIN
        if (TString(gSystem->Getenv("ROOTCOREBIN")) != "" && fileExists(TString(gSystem->Getenv("ROOTCOREBIN"))+"/data/JetUncertainties/"+fileName))
            pathToGet = TString(gSystem->Getenv("ROOTCOREBIN"))+"/data/JetUncertainties/"+fileName;
        // Try ROOTCOREDIR
        else if (TString(gSystem->Getenv("ROOTCOREDIR")) != "" && fileExists(TString(gSystem->Getenv("ROOTCOREDIR"))+"/data/JetUncertainties/"+fileName))
            pathToGet = TString(gSystem->Getenv("ROOTCOREDIR"))+"/data/JetUncertainties/"+fileName;
        // Try standard athena location
        else if (TString(gSystem->Getenv("TestArea")) != "" && fileExists(TString(gSystem->Getenv("TestArea"))+"/Reconstruction/Jet/JetUncertainties/share/"+fileName))
            pathToGet = TString(gSystem->Getenv("TestArea"))+"/Reconstruction/Jet/JetUncertainties/share/"+fileName;
    }
 
    // Give up, hopefully sucessfully
    // User must check if return is "" (failed) or an actual path (success)
    return pathToGet;
}

getLogBins()

std::vector< double > jet::utils::getLogBins	(	const size_t	numBins,
		const double	minVal,
		const double	maxVal
	)

Definition at line 153 of file Reconstruction/Jet/JetUncertainties/Root/Helpers.cxx.

{
    std::vector<double> bins;
    bins.resize(numBins+1);
    
    const double dx = (log(maxVal)-log(minVal))/numBins;
    for (size_t iBin = 0; iBin <= numBins; ++iBin)
        bins[iBin] = exp(log(minVal)+iBin*dx);
 
    return bins;
}

getTypeObjFromString() [1/4]

template<typename T >

T jet::utils::getTypeObjFromString

(

const std::string &

str

)

Definition at line 122 of file Reconstruction/Jet/JetUncertainties/JetUncertainties/Helpers.h.

{
    T toReturn;
    if (!getTypeObjFromString(str,toReturn))
        printf("Failed to convert object: %s\n",str.c_str());
 
    return toReturn;
}

getTypeObjFromString() [2/4]

template<typename T >

bool jet::utils::getTypeObjFromString	(	const std::string &	str,
		T &	obj
	)

Definition at line 116 of file Reconstruction/Jet/JetUncertainties/JetUncertainties/Helpers.h.

{
    std::istringstream iss(str);
    return !(iss >> obj).fail();
}

getTypeObjFromString() [3/4]

template<typename T >

T jet::utils::getTypeObjFromString

(

const TString &

str

)

Definition at line 137 of file Reconstruction/Jet/JetUncertainties/JetUncertainties/Helpers.h.

{
    T toReturn;
    if (!getTypeObjFromString(str,toReturn))
        printf("ERROR: Failed to convert object: %s\n",str.Data());
 
    return toReturn;
}

getTypeObjFromString() [4/4]

template<typename T >

bool jet::utils::getTypeObjFromString	(	const TString &	str,
		T &	obj
	)

Definition at line 131 of file Reconstruction/Jet/JetUncertainties/JetUncertainties/Helpers.h.

{
    std::string stdstr = str.Data();
    return getTypeObjFromString(stdstr,obj);
}

getTypeObjFromString< bool >() [1/2]

template<>

bool jet::utils::getTypeObjFromString< bool >	(	const std::string &	str,
		bool &	obj
	)

Definition at line 33 of file Reconstruction/Jet/JetUncertainties/Root/Helpers.cxx.

{
    bool toReturn = false;
    if (str == "true" || str == "True" || str == "TRUE")
    {
        obj = true;
        toReturn = true;
    }
    else if (str == "false" || str == "False" || str == "FALSE")
    {
        obj = false;
        toReturn = true;
    }
    else
    {
        int value;
        toReturn = getTypeObjFromString<int>(str,value);
        if (toReturn)
            obj = static_cast<bool>(value);
    }
    return toReturn;
}

getTypeObjFromString< bool >() [2/2]

template<>

bool jet::utils::getTypeObjFromString< bool >	(	const TString &	str,
		bool &	obj
	)

Definition at line 71 of file Reconstruction/Jet/JetUncertainties/Root/Helpers.cxx.

{
    bool toReturn = false;
    if (str.EqualTo("true",TString::kIgnoreCase))
    {
        obj = true;
        toReturn = true;
    }
    else if (str.EqualTo("false",TString::kIgnoreCase))
    {
        obj = false;
        toReturn = true;
    }
    else
    {
        int value;
        toReturn = getTypeObjFromString<int>(str,value);
        if (toReturn)
            obj = static_cast<bool>(value);
    }
    return toReturn;
}

getTypeObjFromString< std::string >() [1/2]

template<>

bool jet::utils::getTypeObjFromString< std::string >	(	const std::string &	str,
		std::string &	obj
	)

Definition at line 19 of file Reconstruction/Jet/JetUncertainties/Root/Helpers.cxx.

{
    obj = str;
    return true;
}

getTypeObjFromString< std::string >() [2/2]

template<>

bool jet::utils::getTypeObjFromString< std::string >	(	const TString &	str,
		std::string &	obj
	)

Definition at line 57 of file Reconstruction/Jet/JetUncertainties/Root/Helpers.cxx.

{
    obj = str.Data();
    return true;
}

getTypeObjFromString< TString >() [1/2]

template<>

bool jet::utils::getTypeObjFromString< TString >	(	const std::string &	str,
		TString &	obj
	)

Definition at line 26 of file Reconstruction/Jet/JetUncertainties/Root/Helpers.cxx.

{
    obj = str.c_str();
    return true;
}

getTypeObjFromString< TString >() [2/2]

template<>

bool jet::utils::getTypeObjFromString< TString >	(	const TString &	str,
		TString &	obj
	)

Definition at line 64 of file Reconstruction/Jet/JetUncertainties/Root/Helpers.cxx.

{
    obj = str;
    return true;
}

getUniformBins()

std::vector< double > jet::utils::getUniformBins	(	const size_t	numBins,
		const double	minVal,
		const double	maxVal
	)

Definition at line 165 of file Reconstruction/Jet/JetUncertainties/Root/Helpers.cxx.

{
    std::vector<double> bins;
    bins.resize(numBins+1);
 
    const double dx = (maxVal-minVal)/numBins;
    for (size_t iBin = 0; iBin <= numBins; ++iBin)
        bins[iBin] = minVal+iBin*dx;
 
    return bins;
}

isTypeObjFromString() [1/2]

template<typename T >

bool jet::utils::isTypeObjFromString

(

const std::string &

str

)

Definition at line 101 of file Reconstruction/Jet/JetUncertainties/JetUncertainties/Helpers.h.

{
    std::istringstream iss(str);
    T obj;
    return !(iss >> obj).fail();
}

isTypeObjFromString() [2/2]

template<typename T >

bool jet::utils::isTypeObjFromString

(

const TString &

str

)

Definition at line 109 of file Reconstruction/Jet/JetUncertainties/JetUncertainties/Helpers.h.

{
    std::string stdstr = str.Data();
    return isTypeObjFromString<T>(stdstr);
}

readRootFile()

TFile * jet::utils::readRootFile	(	const TString &	fileName,
		const TString &	path = "",
		const TString &	calibArea = ""
	)

Definition at line 140 of file Reconstruction/Jet/JetUncertainties/Root/Helpers.cxx.

{
    TFile* rootFile = nullptr;
    
    TString pathToGet = findFilePath(fileName,path,calibArea);
    //std::cout << "Looking for file " << fileName << " in path " << path << std::endl;
 
    if (pathToGet != "")
        rootFile = new TFile(pathToGet,"READ");
    return rootFile;
}

scaleHistoAxes()

void jet::utils::scaleHistoAxes	(	TH1 *	toScale,
		const double	factorX = 1,
		const double	factorY = 1,
		const double	factorZ = 1
	)

Definition at line 178 of file Reconstruction/Jet/JetUncertainties/Root/Helpers.cxx.

{
    const int dim = toScale->GetDimension();
 
    // Check for simple copies and sanity checks
    bool returnDuplicate = false;
    if      ( dim == 1 && (factorX < 0 || fabs(factorX-1) < 1.e-4) )
        returnDuplicate = true;
    else if ( dim == 2 && (factorX < 0 || fabs(factorX-1) < 1.e-4)
                       && (factorY < 0 || fabs(factorY-1) < 1.e-4) )
        returnDuplicate = true;
    else if ( dim == 3 && (factorX < 0 || fabs(factorX-1) < 1.e-4)
                       && (factorY < 0 || fabs(factorY-1) < 1.e-4)
                       && (factorZ < 0 || fabs(factorZ-1) < 1.e-4) )
        returnDuplicate = true;
    if (returnDuplicate)
    {
        printf("ScaleHistoAxes: Doing nothing, as all scale factors require no changes\n");
        return;
    }
    
    // Let negative numbers mean no change
    const double facX = factorX < 0 ? 1 : factorX;
    const double facY = factorY < 0 ? 1 : factorY;
    const double facZ = factorZ < 0 ? 1 : factorZ;
 
    // Scale the x axis if necessary
    if (fabs(facX-1) > 1.e-4)
    {
        std::vector<double> binsX;
        for (int iBin = 1; iBin <= toScale->GetNbinsX()+1; ++iBin)
            binsX.push_back(toScale->GetXaxis()->GetBinLowEdge(iBin)*facX);
        toScale->GetXaxis()->Set(binsX.size()-1,&binsX[0]);
    }
    // Scale the y axis if necessary
    if (dim > 1 && fabs(facY-1) > 1.e-4)
    {
        std::vector<double> binsY;
        for (int iBin = 1; iBin <= toScale->GetNbinsY()+1; ++iBin)
            binsY.push_back(toScale->GetYaxis()->GetBinLowEdge(iBin)*facY);
        toScale->GetYaxis()->Set(binsY.size()-1,&binsY[0]);
    }
    // Scale the z axis if necessary
    if (dim > 2 && fabs(facZ-1) > 1.e-4)
    {
        std::vector<double> binsZ;
        for (int iBin = 1; iBin <= toScale->GetNbinsZ()+1; ++iBin)
            binsZ.push_back(toScale->GetZaxis()->GetBinLowEdge(iBin)*facZ);
        toScale->GetZaxis()->Set(binsZ.size()-1,&binsZ[0]);
    }
 
}

vectorize() [1/2]

template<typename T >

std::vector< T > jet::utils::vectorize	(	const TString &	str,
		const TString &	sep
	)

Definition at line 171 of file Reconstruction/Jet/JetUncertainties/JetUncertainties/Helpers.h.

{
    std::vector<T> result;
    TObjArray* tokens = str.Tokenize(sep);
    TIter istr(tokens);
 
    while(TObjString* os=(TObjString*)istr())
    {
        T obj;
        if (!getTypeObjFromString(os->GetString(),obj))
            printf("ERROR: String \"%s\" is not the requested type\n",os->GetString().Data());
        result.push_back(obj);
    }
    delete tokens;
    
    return result;
}

vectorize() [2/2]

template<typename T >

bool jet::utils::vectorize	(	const TString &	str,
		const TString &	sep,
		std::vector< T > &	result
	)

Definition at line 147 of file Reconstruction/Jet/JetUncertainties/JetUncertainties/Helpers.h.

{
    bool success = true;
    result.clear();
 
    TObjArray* tokens = str.Tokenize(sep);
    TIter istr(tokens);
    while(TObjString* os=(TObjString*)istr())
    {
        T obj;
        if (!getTypeObjFromString(os->GetString(),obj))
        {
            success = false;
            break;
        }
        else
            result.push_back(obj);
    }
    delete tokens;
 
    return success;
}