CASM
1.1.0
A Clusters Approach to Statistical Mechanics
|
#include <DataFormatterTools.hh>
Abstract base class for creating 1D DatumFormatter.
A 1D DatumFormatter accepts an object of type DataObject and returns a one-dimensional Container object.
To implement My1DDatumFormatter, you must:
The ContainerTraits specialization requires specifying:
The My1DDatumFormatter class is required to provide an implementation for:
See BaseDatumFormatter and BaseValueFormatter for default implementations which may be specialized.
\seealso Generic1DDatumFormatter to specialize a 1D DatumFormatter at runtime.
Definition at line 1002 of file DataFormatterTools.hh.
Public Types | |
typedef ContainerTraits< Container >::Access | Access |
Access methods for Container. More... | |
typedef ContainerTraits< Container >::value_type | ValueType |
typedef DataObject | DataObject |
typedef long | difference_type |
typedef DataFormatterDictionary< DataObject, BaseDatumFormatter< DataObject > > | DictType |
Public Member Functions | |
Base1DDatumFormatter (const std::string &_name, const std::string &_desc) | |
Constructor. More... | |
virtual | ~Base1DDatumFormatter () |
Destructor. More... | |
std::unique_ptr< Base1DDatumFormatter > | clone () const |
Clone. More... | |
virtual bool | init (const DataObject &_template_obj) const override |
Default initialization adds rules for each element. More... | |
virtual std::vector< std::string > | col_header (const DataObject &_template_obj) const override |
Default col_header uses 'name(index)' for each column. More... | |
virtual bool | parse_args (const std::string &args) override |
Default implementation calls _parse_index_expression. More... | |
virtual void | inject (const DataObject &_data_obj, DataStream &_stream, Index pass_index=0) const override |
Default implementation injects each element. More... | |
virtual void | print (const DataObject &_data_obj, std::ostream &_stream, Index pass_index=0) const override |
Default implementation prints each element in a column. More... | |
virtual Container | operator() (const DataObject &obj) const |
Return requested data from obj, throwing std::runtime_error if not valid. More... | |
virtual Container | evaluate (const DataObject &obj) const=0 |
virtual jsonParser & | to_json (const DataObject &_data_obj, jsonParser &json) const override |
Default implementation calls jsonParser& to_json(const ValueType&, jsonParser&) More... | |
const std::string & | name () const |
Returns a name for the formatter, which becomes the tag used for parsing. More... | |
const std::string & | description () const |
Returns a short description of the formatter and its allowed arguments (if any). This description is used to automatically generate help screens. More... | |
virtual DatumFormatterClass | type () const |
const DictType & | home () const |
const Access the dictionary containing this formatter, set during DictType::lookup More... | |
void | set_home (const DictType &home) const |
Set the dictionary containing this formatter, set during DictType::lookup. More... | |
virtual bool | validate (const DataObject &_data_obj) const |
Returns true if _data_obj has valid values for requested data. More... | |
virtual std::string | long_header (const DataObject &_template_obj) const |
Returns a long expression for each scalar produced by the formatter parsing the long_header should reproduce the exact query described by the formatter Ex: "clex(formation_energy)" or "comp(a) comp(c)". More... | |
virtual std::string | short_header (const DataObject &_template_obj) const |
Returns a short expression for the formatter parsing the short_header should allow the formatter to be recreated (but the short header does not specify a subset of the elements) Ex: "clex(formation_energy)" or "comp". More... | |
virtual Index | num_passes (const DataObject &_data_obj) const |
Protected Types | |
typedef multivector< Index >::X< 2 > | IndexContainer |
Protected Member Functions | |
void | _parse_index_expression (const std::string &_expr) |
void | _add_rule (const std::vector< Index > &new_rule) const |
const IndexContainer & | _index_rules () const |
Private Member Functions | |
virtual Base1DDatumFormatter * | _clone () const override=0 |
Clone. More... | |
Private Attributes | |
std::string | m_name |
std::string | m_description |
IndexContainer | m_index_rules |
const DictType * | m_home |
typedef ContainerTraits<Container>::Access CASM::Base1DDatumFormatter< Container, DataObject >::Access |
Access methods for Container.
Definition at line 1006 of file DataFormatterTools.hh.
|
inherited |
Definition at line 334 of file DataFormatter.hh.
|
inherited |
Definition at line 337 of file DataFormatter.hh.
|
inherited |
Definition at line 335 of file DataFormatter.hh.
|
protectedinherited |
Definition at line 459 of file DataFormatter.hh.
typedef ContainerTraits<Container>::value_type CASM::Base1DDatumFormatter< Container, DataObject >::ValueType |
Definition at line 1007 of file DataFormatterTools.hh.
|
inline |
Constructor.
Definition at line 1010 of file DataFormatterTools.hh.
|
inlinevirtual |
Destructor.
Definition at line 1014 of file DataFormatterTools.hh.
|
inlineprotectedinherited |
Definition at line 472 of file DataFormatter.hh.
|
overrideprivatepure virtual |
Clone.
Implements CASM::BaseValueFormatter< Container, DataObject >.
Implemented in CASM::ScelIO::TransfMat, CASM::ConfigIO::StrucScore, CASM::ConfigIO::DoFStrain, CASM::ConfigIO::RelaxationStrain, CASM::ConfigIO::PointCorr, CASM::ConfigIO::CorrContribution, CASM::ConfigIO::Corr, CASM::ConfigIO::AtomFrac, CASM::ConfigIO::SiteFrac, CASM::ConfigIO::CompN, CASM::ConfigIO::Comp, and CASM::Generic1DDatumFormatter< Container, DataObject >.
|
inlineprotectedinherited |
Definition at line 476 of file DataFormatter.hh.
|
protectedinherited |
Derived DatumFormatters have some optional functionality for parsing index expressions in order to make it easy to handle ranges such as:
in which case, DerivedDatumFormatter::parse_args() is called with the string "3,4:8" by dispatching that string to BaseDatumFormatter::_parse_index_expression(), m_index_rules will be populated with {{3,4},{3,5},{3,6},{3,7},{3,8}}
Definition at line 470 of file DataFormatter_impl.hh.
|
inline |
Clone.
Definition at line 1017 of file DataFormatterTools.hh.
|
inlineoverridevirtual |
Default col_header uses 'name(index)' for each column.
Ex: "corr(0)" "corr(1)" "corr(5)" "corr(6)"
Reimplemented from CASM::BaseDatumFormatter< DataObject >.
Definition at line 1041 of file DataFormatterTools.hh.
|
inlineinherited |
Returns a short description of the formatter and its allowed arguments (if any). This description is used to automatically generate help screens.
Definition at line 352 of file DataFormatter.hh.
|
pure virtualinherited |
|
inlineinherited |
const Access the dictionary containing this formatter, set during DictType::lookup
Definition at line 360 of file DataFormatter.hh.
|
inlineoverridevirtual |
Default initialization adds rules for each element.
Reimplemented from CASM::BaseDatumFormatter< DataObject >.
Definition at line 1025 of file DataFormatterTools.hh.
|
inlineoverridevirtual |
Default implementation injects each element.
Reimplemented from CASM::BaseValueFormatter< Container, DataObject >.
Definition at line 1063 of file DataFormatterTools.hh.
|
inlinevirtualinherited |
Returns a long expression for each scalar produced by the formatter parsing the long_header should reproduce the exact query described by the formatter Ex: "clex(formation_energy)" or "comp(a) comp(c)".
Definition at line 399 of file DataFormatter.hh.
|
inlineinherited |
Returns a name for the formatter, which becomes the tag used for parsing.
Definition at line 347 of file DataFormatter.hh.
|
inlinevirtualinherited |
If data must be printed on multiple rows, returns number of rows needed to output all data from _data_obj DataFormatter class will subsequently pass over _data_obj multiple times to complete printing (if necessary)
Reimplemented in CASM::Base2DDatumFormatter< Container, DataObject >, and CASM::DatumFormatterAlias< DataObject >.
Definition at line 424 of file DataFormatter.hh.
|
inlinevirtualinherited |
Return requested data from obj, throwing std::runtime_error if not valid.
Definition at line 803 of file DataFormatterTools.hh.
|
inlineoverridevirtual |
Default implementation calls _parse_index_expression.
Reimplemented from CASM::BaseDatumFormatter< DataObject >.
Reimplemented in CASM::ConfigIO::StrucScore, CASM::ScelIO::TransfMat, CASM::ScelIO::SupercellCheckBase< VectorXiAttribute< Supercell > >, CASM::ConfigIO::DoFStrain, CASM::ConfigIO::RelaxationStrain, CASM::ConfigIO::PointCorr, CASM::ConfigIO::CorrContribution, CASM::ConfigIO::Corr, CASM::ConfigIO::Comp, and CASM::ConfigIO_impl::MolDependent.
Definition at line 1055 of file DataFormatterTools.hh.
|
inlineoverridevirtual |
Default implementation prints each element in a column.
Reimplemented from CASM::BaseValueFormatter< Container, DataObject >.
Definition at line 1087 of file DataFormatterTools.hh.
|
inlineinherited |
Set the dictionary containing this formatter, set during DictType::lookup.
Definition at line 364 of file DataFormatter.hh.
|
inlinevirtualinherited |
Returns a short expression for the formatter parsing the short_header should allow the formatter to be recreated (but the short header does not specify a subset of the elements) Ex: "clex(formation_energy)" or "comp".
Reimplemented in CASM::DatumFormatterAlias< DataObject >, and CASM::DataFormatterOperator< ValueType, ArgType, DataObject >.
Definition at line 417 of file DataFormatter.hh.
|
inlineoverridevirtualinherited |
Default implementation calls jsonParser& to_json(const ValueType&, jsonParser&)
Implements CASM::BaseDatumFormatter< DataObject >.
Definition at line 847 of file DataFormatterTools.hh.
|
inlinevirtualinherited |
Reimplemented in CASM::DatumFormatterAlias< DataObject >, and CASM::DataFormatterOperator< ValueType, ArgType, DataObject >.
Definition at line 354 of file DataFormatter.hh.
|
inlinevirtualinherited |
Returns true if _data_obj has valid values for requested data.
Default implementation always returns true
Reimplemented in CASM::Generic2DDatumFormatter< Container, DataObject >, CASM::Generic1DDatumFormatter< Container, DataObject >, CASM::GenericDatumFormatter< ValueType, DataObject >, CASM::DatumFormatterAlias< DataObject >, and CASM::DataFormatterOperator< ValueType, ArgType, DataObject >.
Definition at line 381 of file DataFormatter.hh.
|
privateinherited |
Definition at line 486 of file DataFormatter.hh.
|
mutableprivateinherited |
Definition at line 488 of file DataFormatter.hh.
|
mutableprivateinherited |
Definition at line 487 of file DataFormatter.hh.
|
privateinherited |
{ return notstd::make_unique<DerivedDatumFormatter>(*this);}
Definition at line 485 of file DataFormatter.hh.