SampleEnvironmentFactory.cpp

Go to the documentation of this file.

// Mantid Repository : https://github.com/mantidproject/mantid
//
// Copyright © 2018 ISIS Rutherford Appleton Laboratory UKRI,
//   NScD Oak Ridge National Laboratory, European Spallation Source,
//   Institut Laue - Langevin & CSNS, Institute of High Energy Physics, CAS
// SPDX - License - Identifier: GPL - 3.0 +
#include "MantidDataHandling/SampleEnvironmentFactory.h"
#include "MantidDataHandling/SampleEnvironmentSpecParser.h"
#include "MantidKernel/Logger.h"
#include "MantidKernel/Material.h"
 
#include "Poco/File.h"
#include "Poco/Path.h"
 
#include <fstream>
#include <utility>
 
namespace Mantid::DataHandling {
 
//------------------------------------------------------------------------------
// Anonyomous
//------------------------------------------------------------------------------
namespace {
// static logger object
Mantid::Kernel::Logger g_log("SampleEnvironment");
 
// Typedef for cache
using SampleEnvironmentSpecCache = std::unordered_map<std::string, SampleEnvironmentSpec_uptr>;
 
SampleEnvironmentSpecCache &retrieveSpecCache() {
  static SampleEnvironmentSpecCache cache;
  return cache;
}
 
std::string createCacheKey(const std::string &facility, const std::string &instrument, const std::string &specName) {
  return facility + "/" + instrument + "/" + specName;
}
} // namespace
 
//------------------------------------------------------------------------------
// SampleEnvironmentFactory
//------------------------------------------------------------------------------
SampleEnvironmentFactory::SampleEnvironmentFactory(ISampleEnvironmentSpecFinder_uptr specFinder)
    : m_finder(std::move(specFinder)) {}
 
Geometry::SampleEnvironment_uptr SampleEnvironmentFactory::create(const std::string &facility,
                                                                  const std::string &instrument,
                                                                  const std::string &specName,
                                                                  const std::string &canName) {
  assert(m_finder);
  auto &specCache = retrieveSpecCache();
  auto cacheKey = createCacheKey(facility, instrument, specName);
 
  SampleEnvironmentSpec *spec(nullptr);
  auto iter = specCache.find(cacheKey);
  if (iter != specCache.end()) {
    spec = iter->second.get();
  } else {
    auto specUPtr = m_finder->find(facility, instrument, specName);
    spec = specUPtr.get();
    specCache.emplace(cacheKey, std::move(specUPtr));
  }
  return spec->buildEnvironment(canName);
}
 
size_t SampleEnvironmentFactory::cacheSize() const { return retrieveSpecCache().size(); }
 
void SampleEnvironmentFactory::clearCache() { retrieveSpecCache().clear(); }
 
SampleEnvironmentSpec_uptr SampleEnvironmentFactory::parseSpec(const std::string &filename,
                                                               const std::string &filepath) const {
  assert(m_finder);
  Poco::File fullpath(Poco::Path(filepath, filename + ".xml"));
  return m_finder->parseSpec(filename, fullpath.path());
}
 
//------------------------------------------------------------------------------
// SampleEnvironmentSpecFileFinder
//------------------------------------------------------------------------------
 
SampleEnvironmentSpecFileFinder::SampleEnvironmentSpecFileFinder(std::vector<std::string> directories)
    : m_rootDirs(std::move(directories)) {
  if (m_rootDirs.empty()) {
    throw std::invalid_argument("SampleEnvironmentSpecFileFinder() - Empty directory search list.");
  }
}
 
SampleEnvironmentSpec_uptr SampleEnvironmentSpecFileFinder::find(const std::string &facility,
                                                                 const std::string &instrument,
                                                                 const std::string &name) const {
  using Poco::File;
  using Poco::Path;
 
  Path relpath_instr(facility);
  relpath_instr.append(instrument).append(name + m_fileext);
 
  Path relpath_facil(facility);
  relpath_facil.append(name + m_fileext);
 
  // check for the instrument environment, then facility environment
  for (const auto &rel_path : {relpath_instr, relpath_facil}) {
    for (const auto &prefixStr : m_rootDirs) {
      Path prefix(prefixStr);
      // Ensure the path is a directory (note that this does not create it!)
      prefix.makeDirectory();
      File fullpath(Poco::Path(prefix, rel_path));
      if (fullpath.exists()) {
        g_log.debug() << "Found environment at \"" << fullpath.path() << "\"\n";
        return parseSpec(name, fullpath.path());
      } else {
        g_log.debug() << "Failed to find environment at \"" << fullpath.path() << "\"\n";
      }
    }
  }
 
  // no match if we get here
  std::ostringstream msg;
  msg << "Unable to find sample environment file '" << name << "' for facility '" << facility << "' and instrument '"
      << instrument << "'";
  throw std::runtime_error(msg.str());
}
 
SampleEnvironmentSpec_uptr SampleEnvironmentSpecFileFinder::parseSpec(const std::string &name,
                                                                      const std::string &filename) const {
  std::ifstream reader(filename, std::ios_base::in);
  if (!reader) {
    throw std::runtime_error("SampleEnvironmentSpecFileFinder() - Error accessing file '" + filename + "'");
  }
  SampleEnvironmentSpecParser parser;
  return parser.parse(name, filename, reader);
}
 
} // namespace Mantid::DataHandling