parser.hh
No OneTemporary
Actions

Subscribers

None

File Metadata

Created: Tue, May 14, 13:44

parser.hh
View Options

	/**
	* @file parser.hh
	*
	* @author Nicolas Richart <nicolas.richart@epfl.ch>
	*
	* @date creation: Wed Nov 13 2013
	* @date last modification: Wed Jan 13 2016
	*
	* @brief File parser interface
	*
	* @section LICENSE
	*
	* Copyright (©) 2014, 2015 EPFL (Ecole Polytechnique Fédérale de Lausanne)
	* Laboratory (LSMS - Laboratoire de Simulation en Mécanique des Solides)
	*
	* Akantu is free software: you can redistribute it and/or modify it under the
	* terms of the GNU Lesser General Public License as published by the Free
	* Software Foundation, either version 3 of the License, or (at your option) any
	* later version.
	*
	* Akantu 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 Lesser General Public License for more
	* details.
	*
	* You should have received a copy of the GNU Lesser General Public License
	* along with Akantu. If not, see <http://www.gnu.org/licenses/>.
	*
	*/

	/* -------------------------------------------------------------------------- */
	#include "aka_common.hh"
	#include "aka_random_generator.hh"
	/* -------------------------------------------------------------------------- */
	#include <map>
	/* -------------------------------------------------------------------------- */

	#ifndef __AKANTU_PARSER_HH__
	#define __AKANTU_PARSER_HH__

	namespace akantu {

	// clang-format off
	#define AKANTU_SECTION_TYPES \
	(global) \
	(material) \
	(model) \
	(mesh) \
	(heat) \
	(contact) \
	(friction) \
	(embedded_interface) \
	(rules) \
	(non_local) \
	(user) \
	(solver) \
	(neighborhoods) \
	(neighborhood) \
	(time_step_solver) \
	(non_linear_solver) \
	(model_solver) \
	(integration_scheme) \
	(weight_function) \
	(not_defined)
	// clang-format on

	#define AKANTU_SECTION_TYPES_PREFIX(elem) BOOST_PP_CAT(_st_, elem)

	#define AKANTU_SECT_PREFIX(s, data, elem) AKANTU_SECTION_TYPES_PREFIX(elem)
	/// Defines the possible section types
	enum SectionType {
	BOOST_PP_SEQ_ENUM(
	BOOST_PP_SEQ_TRANSFORM(AKANTU_SECT_PREFIX, _, AKANTU_SECTION_TYPES))
	};
	#undef AKANTU_SECT_PREFIX

	#define AKANTU_SECTION_TYPE_PRINT_CASE(r, data, elem) \
	case AKANTU_SECTION_TYPES_PREFIX(elem): { \
	stream << BOOST_PP_STRINGIZE(AKANTU_SECTION_TYPES_PREFIX(elem)); \
	break; \
	}

	inline std::ostream & operator<<(std::ostream & stream, SectionType type) {
	switch (type) {
	BOOST_PP_SEQ_FOR_EACH(AKANTU_SECTION_TYPE_PRINT_CASE, _,
	AKANTU_SECTION_TYPES)
	default:
	stream << "not a SectionType";
	break;
	}
	return stream;
	}

	#undef AKANTU_SECTION_TYPE_PRINT_CASE
	/// Defines the possible search contexts/scopes (for parameter search)
	enum ParserParameterSearchCxt {
	_ppsc_current_scope = 0x1,
	_ppsc_parent_scope = 0x2,
	_ppsc_current_and_parent_scope = 0x3
	};

	/* ------------------------------------------------------------------------ */
	/* Parameters Class */
	/* ------------------------------------------------------------------------ */
	class ParserSection;

	/// @brief The ParserParameter objects represent the end of tree branches as
	/// they
	/// are the different informations contained in the input file.
	class ParserParameter {
	public:
	ParserParameter()
	: parent_section(NULL), name(std::string()), value(std::string()),
	dbg_filename(std::string()) {}

	ParserParameter(const std::string & name, const std::string & value,
	const ParserSection & parent_section)
	: parent_section(&parent_section), name(name), value(value),
	dbg_filename(std::string()) {}

	ParserParameter(const ParserParameter & param)
	: parent_section(param.parent_section), name(param.name),
	value(param.value), dbg_filename(param.dbg_filename),
	dbg_line(param.dbg_line), dbg_column(param.dbg_column) {}

	virtual ~ParserParameter() {}

	/// Get parameter name
	const std::string & getName() const { return name; }
	/// Get parameter value
	const std::string & getValue() const { return value; }

	/// Set info for debug output
	void setDebugInfo(const std::string & filename, UInt line, UInt column) {
	dbg_filename = filename;
	dbg_line = line;
	dbg_column = column;
	}

	template <typename T> inline operator T() const;

	// template <typename T> inline operator Vector<T>() const;
	// template <typename T> inline operator Matrix<T>() const;

	/// Print parameter info in stream
	void printself(std::ostream & stream,
	__attribute__((unused)) unsigned int indent = 0) const {
	stream << name << ": " << value << " (" << dbg_filename << ":" << dbg_line
	<< ":" << dbg_column << ")";
	}

	private:
	void setParent(const ParserSection & sect) { parent_section = § }

	friend class ParserSection;

	private:
	/// Pointer to the parent section
	const ParserSection * parent_section;
	/// Name of the parameter
	std::string name;
	/// Value of the parameter
	std::string value;
	/// File for debug output
	std::string dbg_filename;
	/// Position of parameter in parsed file
	UInt dbg_line, dbg_column;
	};

	/* ------------------------------------------------------------------------ */
	/* Sections Class */
	/* ------------------------------------------------------------------------ */
	/// ParserSection represents a branch of the parsing tree.
	class ParserSection {
	public:
	typedef std::multimap<SectionType, ParserSection> SubSections;
	typedef std::map<std::string, ParserParameter> Parameters;

	private:
	typedef SubSections::const_iterator const_section_iterator_;

	public:
	/* ------------------------------------------------------------------------ */
	/* SubSection iterator */
	/* ------------------------------------------------------------------------ */
	/// Iterator on sections
	class const_section_iterator {
	public:
	const_section_iterator() {}
	const_section_iterator(const const_section_iterator & other)
	: it(other.it) {}
	const_section_iterator(const const_section_iterator_ & it) : it(it) {}

	const_section_iterator & operator=(const const_section_iterator & other) {
	if (this != &other) {
	it = other.it;
	}
	return *this;
	}
	const ParserSection & operator*() const { return it->second; }
	const ParserSection * operator->() const { return &(it->second); }
	bool operator==(const const_section_iterator & other) const {
	return it == other.it;
	}
	bool operator!=(const const_section_iterator & other) const {
	return it != other.it;
	}

	const_section_iterator & operator++() {
	++it;
	return *this;
	}
	const_section_iterator operator++(int) {
	const_section_iterator tmp = *this;
	operator++();
	return tmp;
	}

	private:
	const_section_iterator_ it;
	};

	/* ------------------------------------------------------------------------ */
	/* Parameters iterator */
	/* ------------------------------------------------------------------------ */
	/// Iterator on parameters
	class const_parameter_iterator {
	public:
	const_parameter_iterator(const const_parameter_iterator & other)
	: it(other.it) {}
	const_parameter_iterator(const Parameters::const_iterator & it) : it(it) {}

	const_parameter_iterator &
	operator=(const const_parameter_iterator & other) {
	if (this != &other) {
	it = other.it;
	}
	return *this;
	}
	const ParserParameter & operator*() const { return it->second; }
	const ParserParameter * operator->() { return &(it->second); };
	bool operator==(const const_parameter_iterator & other) const {
	return it == other.it;
	}
	bool operator!=(const const_parameter_iterator & other) const {
	return it != other.it;
	}
	const_parameter_iterator & operator++() {
	++it;
	return *this;
	}
	const_parameter_iterator operator++(int) {
	const_parameter_iterator tmp = *this;
	operator++();
	return tmp;
	}

	private:
	Parameters::const_iterator it;
	};

	/* ---------------------------------------------------------------------- */
	ParserSection()
	: parent_section(NULL), name(std::string()), type(_st_not_defined) {}

	ParserSection(const std::string & name, SectionType type)
	: parent_section(NULL), name(name), type(type) {}

	ParserSection(const std::string & name, SectionType type,
	const std::string & option,
	const ParserSection & parent_section)
	: parent_section(&parent_section), name(name), type(type),
	option(option) {}

	ParserSection(const ParserSection & section)
	: parent_section(section.parent_section), name(section.name),
	type(section.type), option(section.option),
	parameters(section.parameters),
	sub_sections_by_type(section.sub_sections_by_type) {
	setChldrenPointers();
	}

	ParserSection & operator=(const ParserSection & other) {
	if (&other != this) {
	parent_section = other.parent_section;
	name = other.name;
	type = other.type;
	option = other.option;
	parameters = other.parameters;
	sub_sections_by_type = other.sub_sections_by_type;
	setChldrenPointers();
	}
	return *this;
	}

	virtual ~ParserSection();

	virtual void printself(std::ostream & stream, unsigned int indent = 0) const;

	/* ---------------------------------------------------------------------- */
	/* Creation functions */
	/* ---------------------------------------------------------------------- */
	public:
	ParserParameter & addParameter(const ParserParameter & param);
	ParserSection & addSubSection(const ParserSection & section);

	protected:
	/// Clean ParserSection content
	void clean() {
	parameters.clear();
	sub_sections_by_type.clear();
	}

	private:
	void setChldrenPointers() {
	Parameters::iterator pit = this->parameters.begin();
	for (; pit != this->parameters.end(); ++pit)
	pit->second.setParent(*this);

	SubSections::iterator sit = this->sub_sections_by_type.begin();
	for (; sit != this->sub_sections_by_type.end(); ++sit)
	sit->second.setParent(*this);
	}

	/* ---------------------------------------------------------------------- */
	/* Accessors */
	/* ---------------------------------------------------------------------- */
	public:
	/// Get begin and end iterators on subsections of certain type
	std::pair<const_section_iterator, const_section_iterator>
	getSubSections(SectionType type = _st_not_defined) const {
	if (type != _st_not_defined) {
	std::pair<const_section_iterator_, const_section_iterator_> range =
	sub_sections_by_type.equal_range(type);
	return std::pair<const_section_iterator, const_section_iterator>(
	range.first, range.second);
	} else {
	return std::pair<const_section_iterator, const_section_iterator>(
	sub_sections_by_type.begin(), sub_sections_by_type.end());
	}
	}

	/// Get number of subsections of certain type
	UInt getNbSubSections(SectionType type = _st_not_defined) const {
	if (type != _st_not_defined) {
	return this->sub_sections_by_type.count(type);
	} else {
	return this->sub_sections_by_type.size();
	}
	}

	/// Get begin and end iterators on parameters
	std::pair<const_parameter_iterator, const_parameter_iterator>
	getParameters() const {
	return std::pair<const_parameter_iterator, const_parameter_iterator>(
	parameters.begin(), parameters.end());
	}

	/* ---------------------------------------------------------------------- */
	/// Get parameter within specified context
	const ParserParameter & getParameter(
	const std::string & name,
	ParserParameterSearchCxt search_ctx = _ppsc_current_scope) const {
	Parameters::const_iterator it;
	if (search_ctx & _ppsc_current_scope)
	it = parameters.find(name);

	if (it == parameters.end()) {
	if ((search_ctx & _ppsc_parent_scope) && parent_section)
	return parent_section->getParameter(name, search_ctx);
	else {
	AKANTU_SILENT_EXCEPTION(
	"The parameter " << name
	<< " has not been found in the specified context");
	}
	}
	return it->second;
	}

	/* ------------------------------------------------------------------------ */
	/// Get parameter within specified context, with a default value in case the
	/// parameter does not exists
	template <class T>
	const T getParameter(
	const std::string & name, const T & default_value,
	ParserParameterSearchCxt search_ctx = _ppsc_current_scope) const {
	try {
	T tmp = this->getParameter(name, search_ctx);
	return tmp;
	} catch (debug::Exception &) {
	return default_value;
	}
	}

	/* ------------------------------------------------------------------------ */
	/// Check if parameter exists within specified context
	bool hasParameter(
	const std::string & name,
	ParserParameterSearchCxt search_ctx = _ppsc_current_scope) const {

	Parameters::const_iterator it;
	if (search_ctx & _ppsc_current_scope)
	it = parameters.find(name);

	if (it == parameters.end()) {
	if ((search_ctx & _ppsc_parent_scope) && parent_section)
	return parent_section->hasParameter(name, search_ctx);
	else {
	return false;
	}
	}
	return true;
	}

	/* --------------------------------------------------------------------------
	*/
	/// Get value of given parameter in context
	template <class T>
	T getParameterValue(
	const std::string & name,
	ParserParameterSearchCxt search_ctx = _ppsc_current_scope) const {
	const ParserParameter & tmp_param = getParameter(name, search_ctx);
	T t = tmp_param;
	return t;
	}

	/* --------------------------------------------------------------------------
	*/
	/// Get section name
	const std::string getName() const { return name; }
	/// Get section type
	SectionType getType() const { return type; }
	/// Get section option
	const std::string getOption(const std::string & def = "") const {
	return option != "" ? option : def;
	}

	protected:
	void setParent(const ParserSection & sect) { parent_section = § }

	/* ---------------------------------------------------------------------- */
	/* Members */
	/* ---------------------------------------------------------------------- */
	private:
	/// Pointer to the parent section
	const ParserSection * parent_section;
	/// Name of section
	std::string name;
	/// Type of section, see AKANTU_SECTION_TYPES
	SectionType type;
	/// Section option
	std::string option;
	/// Map of parameters in section
	Parameters parameters;
	/// Multi-map of subsections
	SubSections sub_sections_by_type;
	};

	/* ------------------------------------------------------------------------ */
	/* Parser Class */
	/* ------------------------------------------------------------------------ */
	/// Root of parsing tree, represents the global ParserSection
	class Parser : public ParserSection {
	public:
	Parser() : ParserSection("global", _st_global) {}

	void parse(const std::string & filename);

	std::string getLastParsedFile() const;

	static bool isPermissive() { return permissive_parser; }

	public:
	/// Parse real scalar
	static Real parseReal(const std::string & value,
	const ParserSection & section);
	/// Parse real vector
	static Vector<Real> parseVector(const std::string & value,
	const ParserSection & section);
	/// Parse real matrix
	static Matrix<Real> parseMatrix(const std::string & value,
	const ParserSection & section);
	/// Parse real random parameter
	static RandomParameter<Real>
	parseRandomParameter(const std::string & value,
	const ParserSection & section);

	protected:
	/// General parse function
	template <class T, class Grammar>
	static T parseType(const std::string & value, Grammar & grammar);

	protected:
	// friend class Parsable;
	static bool permissive_parser;
	std::string last_parsed_file;
	};

	inline std::ostream & operator<<(std::ostream & stream,
	const ParserParameter & _this) {
	_this.printself(stream);
	return stream;
	}

	inline std::ostream & operator<<(std::ostream & stream,
	const ParserSection & section) {
	section.printself(stream);
	return stream;
	}

	} // akantu

	#include "parser_tmpl.hh"

	#endif /* __AKANTU_PARSER_HH__ */

parser.hhNo OneTemporaryActions

File Metadata

parser.hhView Options

Event Timeline

parser.hh
No OneTemporary
Actions

parser.hh
View Options