musrview.cpp

Go to the documentation of this file.

/***************************************************************************
 
  musrview.cpp
 
  Author: Andreas Suter
  e-mail: andreas.suter@psi.ch
 
***************************************************************************/
 
/***************************************************************************
 *   Copyright (C) 2007-2026 by Andreas Suter                              *
 *   andreas.suter@psi.ch                                                  *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/
 
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
 
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
 
#include <iostream>
#include <memory>
#include <vector>
#include <sstream>
 
 
#include <TApplication.h>
#include <TSAXParser.h>
#include <TROOT.h>
 
#ifdef HAVE_GIT_REV_H
#include "git-revision.h"
#endif
 
#include "PMusr.h"
#include "PStartupHandler.h"
#include "PMsrHandler.h"
#include "PRunDataHandler.h"
#include "PRunListCollection.h"
#include "PMusrCanvas.h"
#include "PMsgBox.h"
 
 
//--------------------------------------------------------------------------
void musrview_syntax()
{
  std::cout << std::endl << "usage: musrview <msr-file> [Options]";
  std::cout << std::endl << "       <msr-file>: msr/mlog input file";
  std::cout << std::endl << "       Options:";
  std::cout << std::endl << "       --help    : display this help and exit.";
  std::cout << std::endl << "       --version : output version information and exit.";
  std::cout << std::endl << "       --show-dynamic-path : dumps the dynamic search paths and exit.";
  std::cout << std::endl << "       -f, --fourier: will directly present the Fourier transform of the <msr-file>.";
  std::cout << std::endl << "       -a, --avg: will directly present the averaged data/Fourier of the <msr-file>.";
  std::cout << std::endl << "       -1, --one_to_one: calculate theory points only at data points.";
  std::cout << std::endl << "       --<graphic-format-extension>: ";
  std::cout << std::endl << "           will produce a graphics-output-file without starting a root session.";
  std::cout << std::endl << "           the name is based on the <msr-file>, e.g. 3310.msr -> 3310_0.png";
  std::cout << std::endl << "           supported graphic-format-extension:";
  std::cout << std::endl << "           eps, pdf, gif, jpg, png, svg, xpm, root";
  std::cout << std::endl << "           example: musrview 3310.msr --png, will produce a files 3310_X.png";
  std::cout << std::endl << "                    where 'X' stands for the plot number (starting form 0)";
  std::cout << std::endl << "       --ascii: ";
  std::cout << std::endl << "           will produce an ascii dump of the data and fit as plotted.";
  std::cout << std::endl << "       --timeout <timeout>: <timeout> given in seconds after which musrview terminates.";
  std::cout << std::endl << "           If <timeout> <= 0, no timeout will take place. Default <timeout> is 0.";
  std::cout << std::endl << "       -s, --show-errMsgBox: if this tag is defined, error message boxes are shown,";
  std::cout << std::endl << "                             rather than only stderr output.";
  std::cout << std::endl << std::endl;
}
 
//--------------------------------------------------------------------------
void musrview_error_msg(std::string errMsg)
{
  int argc=0; 
  char **argv;
  TApplication app("musrviewErrorMsg", &argc, argv);
  new PMsgBox(errMsg, gClient->GetRoot(), 600, 200);
  app.Run();
}
 
//--------------------------------------------------------------------------
int main(int argc, char *argv[])
{
  int result{PMUSR_SUCCESS};
  bool show_syntax{false};
  int  status;
  bool success{true};
  char fileName[128];
  bool fourier{false};
  bool avg{false};
  bool theoAtData{false}; // theory points only at data points
  bool graphicsOutput{false};
  bool asciiOutput{false};
  char graphicsExtension[128];
  int  timeout{0};
  bool show_errMsgBox{false};
  std::stringstream errMsg;
 
  memset(fileName, '\0', sizeof(fileName));
  memset(graphicsExtension, '\0', sizeof(graphicsExtension));
 
  // add default shared library path /usr/local/lib if not already persent
  const char *dsp = gSystem->GetDynamicPath();
  if (strstr(dsp, "/usr/local/lib") == nullptr)
    gSystem->AddDynamicPath("/usr/local/lib");
 
  // check input arguments
  if (argc == 1) {
    musrview_syntax();
    return PMUSR_SYNTAX_REQUEST;
  }
  for (int i=1; i<argc; i++) {
    if (strstr(argv[i], ".msr") || strstr(argv[i], ".mlog")) {
      if (strlen(fileName) == 0) {
        strncpy(fileName, argv[i], sizeof(fileName));
      } else {
        std::cerr << std::endl << "**ERROR** only one file name allowed." << std::endl;
        show_syntax = true;
        break;
      }
    } else if (!strcmp(argv[i], "--version")) {
#ifdef HAVE_CONFIG_H
#ifdef HAVE_GIT_REV_H
      std::cout << std::endl << "musrview version: " << PACKAGE_VERSION << ", git-branch: " << GIT_BRANCH << ", git-rev: " << GIT_CURRENT_SHA1 << " (" << BUILD_TYPE << "), ROOT version: " << ROOT_VERSION_USED << std::endl << std::endl;
#else
      std::cout << std::endl << "musrview version: " << PACKAGE_VERSION << " (" << BUILD_TYPE << "), ROOT version: " << ROOT_VERSION_USED << std::endl << std::endl;
#endif
#else
#ifdef HAVE_GIT_REV_H
      std::cout << std::endl << "musrview git-branch: " << GIT_BRANCH << ", git-rev: " << GIT_CURRENT_SHA1 << std::endl << std::endl;
#else
      std::cout << std::endl << "musrview version: unknown." << std::endl << std::endl;
#endif
#endif
      return PMUSR_SUCCESS;
    } else if (!strcmp(argv[i], "--show-dynamic-path")) {
      std::cout << std::endl << "musrview: internal dynamic search paths for shared libraries/root dictionaries:";
      std::cout << std::endl << "  '" << gSystem->GetDynamicPath() << "'" << std::endl << std::endl;
      return PMUSR_SUCCESS;
    } else if (!strcmp(argv[i], "--help")) {
      show_syntax = true;
      break;
    } else if (!strcmp(argv[i], "-f") || !strcmp(argv[i], "--fourier")) {
      fourier = true;
    } else if (!strcmp(argv[i], "-a") || !strcmp(argv[i], "--avg")) {
      avg = true;
    } else if (!strcmp(argv[i], "-1") || !strcmp(argv[i], "--one_to_one")) {
      theoAtData = true;
    } else if (!strcmp(argv[i], "--eps") || !strcmp(argv[i], "--pdf") || !strcmp(argv[i], "--gif") ||
               !strcmp(argv[i], "--jpg") || !strcmp(argv[i], "--png") || !strcmp(argv[i], "--svg") ||
               !strcmp(argv[i], "--xpm") || !strcmp(argv[i], "--root")) {
 
      graphicsOutput = true;
      strncpy(graphicsExtension, argv[i]+2, sizeof(graphicsExtension));
    } else if (!strcmp(argv[i], "--ascii")) {
      asciiOutput = true;
    } else if (!strcmp(argv[i], "--timeout")) {
      if (i+1 < argc) {
        TString str(argv[i+1]);
        if (str.IsFloat()) {
          timeout = str.Atoi();
        } else {
          show_syntax = true;
          break;
        }
        i++;
      } else {
        show_syntax = true;
        break;
      }
    } else if (!strcmp(argv[i], "-s") || !strcmp(argv[i], "--show-errMsgBox")) {
      show_errMsgBox = true;
    } else {
      show_syntax = true;
      break;
    }
  }
 
  if (show_syntax) {
    musrview_syntax();
    return PMUSR_WRONG_STARTUP_SYNTAX;
  }
 
  // read startup file
  char startup_path_name[128];
  memset(startup_path_name, '\0', sizeof(startup_path_name));
  std::unique_ptr<TSAXParser> saxParser = std::make_unique<TSAXParser>();
  std::unique_ptr<PStartupHandler> startupHandler = std::make_unique<PStartupHandler>();
  if (!startupHandler->StartupFileFound()) {
    std::cerr << std::endl << ">> musrview **WARNING** couldn't find " << startupHandler->GetStartupFilePath().Data();
    std::cerr << std::endl;
  } else {
    strncpy(startup_path_name, startupHandler->GetStartupFilePath().Data(), sizeof(startup_path_name));
    saxParser->ConnectToHandler("PStartupHandler", startupHandler.get());
    //status = saxParser->ParseFile(startup_path_name);
    // parsing the file as above seems to lead to problems in certain environments;
    // use the parseXmlFile function instead (see PStartupHandler.cpp for the definition)
    status = parseXmlFile(saxParser.get(), startup_path_name);
    // check for parse errors
    if (status) { // error
      std::cerr << std::endl << ">> musrview **WARNING** Reading/parsing musrfit_startup.xml failed.";
      std::cerr << std::endl << ">>                      Any graph will appear with random symbols and colors!";
      std::cerr << std::endl;
    } else {
      startupHandler->CheckLists();
    }
  }
 
  // read msr-file
  std::unique_ptr<PMsrHandler> msrHandler = std::make_unique<PMsrHandler>(fileName);
  status = msrHandler->ReadMsrFile();
  if (status != PMUSR_SUCCESS) {
    errMsg << msrHandler->GetLastErrorMsg();
    switch (status) {
      case PMUSR_MSR_FILE_NOT_FOUND:
        errMsg << "\n";
        errMsg << ">> musrview **ERROR** couldn't find '" << fileName << "'\n\n";
        break;
      case PMUSR_MSR_SYNTAX_ERROR:
        errMsg << "\n";
        errMsg << ">> musrview **SYNTAX ERROR** in file " << fileName << ", full stop here.\n\n";
        break;
      default:
        errMsg << "\n";
        errMsg << ">> musrview **UNKNOWN ERROR** when trying to read the msr-file.\n\n";
        break;
    }
    std::cerr << errMsg.str();
    if (show_errMsgBox)
      musrview_error_msg(errMsg.str());
    return status;
  }
  // make a plot list vector
  PMsrPlotList *msrPlotList = msrHandler->GetMsrPlotList();
  PIntVector plotList;
  bool runPresent;
  for (unsigned int i=0; i<msrPlotList->size(); i++) {
    for (unsigned int j=0; j<msrPlotList->at(i).fRuns.size(); j++) {
      // check that run is not already in the plotList
      runPresent = false;
      for (unsigned int k=0; k<plotList.size(); k++) {
        if (msrPlotList->at(i).fRuns[j] == static_cast<int>(plotList[k])) {
          runPresent = true;
          break;
        }
      }
      if (!runPresent) {
        plotList.push_back(static_cast<int>(msrPlotList->at(i).fRuns[j]));
      }
    }
  }
 
  // read all the necessary runs (raw data)
  std::unique_ptr<PRunDataHandler> dataHandler;
  if (startupHandler)
    dataHandler = std::make_unique<PRunDataHandler>(msrHandler.get(), startupHandler->GetDataPathList());
  else
    dataHandler = std::make_unique<PRunDataHandler>(msrHandler.get());
 
  dataHandler->ReadData();
 
  success = dataHandler->IsAllDataAvailable();
  if (!success) {
    errMsg << ">> musrview **ERROR** Couldn't read all data files, will quit ...\n";
    std::cerr << errMsg.str();
    if (show_errMsgBox)
      musrview_error_msg(errMsg.str());
    result = PMUSR_DATA_FILE_READ_ERROR;
  }
 
  // generate the necessary histogramms for the view
  std::unique_ptr<PRunListCollection> runListCollection;
  if (result == PMUSR_SUCCESS) {
    // feed all the necessary histogramms for the view
    runListCollection = std::make_unique<PRunListCollection>(msrHandler.get(), dataHandler.get(), theoAtData);
    for (unsigned int i=0; i<msrHandler->GetMsrRunList()->size(); i++) {
      // if run is in plotList add it, otherwise go to the next
      runPresent = false;
      for (unsigned int j=0; j<plotList.size(); j++) {
        if (static_cast<unsigned int>(plotList[j]) == i+1) {
          runPresent = true;
          break;
        }
      }
      if (runPresent) {
        success = runListCollection->Add(i, kView);
        if (!success) {
          errMsg << ">> musrview **ERROR** Couldn't handle run no " << i << " ";
          errMsg << (*msrHandler->GetMsrRunList())[i].GetRunName()->Data() << "\n";
          std::cerr << errMsg.str();
          if (show_errMsgBox)
            musrview_error_msg(errMsg.str());
          result = PMUSR_MSR_RUN_ERROR;
          break;
        }
      }
    }
  }
 
  if (result == PMUSR_SUCCESS) {
    // create the ROOT application needed for PMusrCanvas
    // and pass it only essential arguments
    std::vector<char*> args;
    args.push_back(argv[0]); // program name
    if (graphicsOutput || asciiOutput) {
      args.push_back((char*)"-b"); // batch mode flag
    }
    int cc = args.size();
    TApplication app("App", &cc, args.data());
 
    std::vector<PMusrCanvas*> canvasVector;
    PMusrCanvas *musrCanvas = nullptr;
 
    bool ok = true;
    for (unsigned int i=0; i<msrHandler->GetMsrPlotList()->size(); i++) {
 
      if (startupHandler)
        musrCanvas = new PMusrCanvas(i, msrHandler->GetMsrTitle()->Data(), 
                                     10+i*100, 10+i*100, 800, 600,
                                     startupHandler->GetFourierDefaults(),
                                     startupHandler->GetMarkerList(),
                                     startupHandler->GetColorList(),
                                     graphicsOutput||asciiOutput,
                                     fourier, avg, theoAtData);
      else
        musrCanvas = new PMusrCanvas(i, msrHandler->GetMsrTitle()->Data(), 
                                     10+i*100, 10+i*100, 800, 600,
                                     graphicsOutput||asciiOutput,
                                     fourier, avg, theoAtData);
 
      if (musrCanvas == nullptr) {
        errMsg << ">> musrview **SEVERE ERROR** Couldn't invoke all necessary objects, will quit.\n";
        std::cerr << errMsg.str();
        if (show_errMsgBox)
          musrview_error_msg(errMsg.str());
        ok = false;
        break;
      }
      if (!musrCanvas->IsValid()) {
        errMsg << ">> musrview **SEVERE ERROR** Couldn't invoke all necessary objects, will quit.\n";
        std::cerr << errMsg.str();
        if (show_errMsgBox)
          musrview_error_msg(errMsg.str());
        ok = false;
        delete musrCanvas;
        break;
      }
 
      musrCanvas->SetTimeout(timeout);
 
      // ugly but rootcling cannot handle the spirit-parser framework
      musrCanvas->SetMsrHandler(msrHandler.get());
      musrCanvas->SetRunListCollection(runListCollection.get());
 
      musrCanvas->UpdateParamTheoryPad();
      musrCanvas->UpdateDataTheoryPad();
      musrCanvas->UpdateInfoPad();
 
      if (!musrCanvas->IsValid()) { // something went wrong
        ok = false;
        break;
      }
 
      musrCanvas->Connect("Done(Int_t)", "TApplication", &app, "Terminate(Int_t)");
 
      if (graphicsOutput) {
        musrCanvas->SaveGraphicsAndQuit(fileName, graphicsExtension);
      }
 
      if (asciiOutput) {
        // generate export data file name
        TString str(fileName);
        str.Remove(str.Last('.'));
        str += ".dat";
        // save data in batch mode
        musrCanvas->ExportData(str.Data());
        musrCanvas->Done(0);
      }
 
      // keep musrCanvas objects
      canvasVector.push_back(musrCanvas);
    }
 
    // check that everything is ok
    if (ok)
      app.Run(true); // true needed that Run will return after quit so that cleanup works
 
    // clean up
    char canvasName[32];
    for (unsigned int i=0; i<canvasVector.size(); i++) {
      // check if canvas is still there before calling the destructor **TO BE DONE**
      snprintf(canvasName, sizeof(canvasName), "fMainCanvas%d", i);
      if (gROOT->GetListOfCanvases()->FindObject(canvasName) != nullptr) {
        canvasVector[i]->~PMusrCanvas();
      }
    }
    canvasVector.clear();
  }
 
  // clean up
  plotList.clear();
 
  return result;
}