CASM
AClustersApproachtoStatisticalMechanics
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules
CASM::ConfigIO::Clex Class Referenceabstract

#include <ConfigIO.hh>

+ Inheritance diagram for CASM::ConfigIO::Clex:

Detailed Description

Returns predicted formation energy.

Returns predicted formation energy (only formation energy for now)

Definition at line 334 of file ConfigIO.hh.

Public Types

enum  FormatterType
 
typedef DataObject DataObject
 
typedef long difference_type
 
typedef
DataFormatterDictionary
< DataObject,
BaseDatumFormatter< DataObject > > 
DictType
 

Public Member Functions

 Clex ()
 
 Clex (const Clexulator &clexulator, const ECIContainer &eci, const Norm< Configuration > &norm)
 Construct with Clexulator, ECI, and either 'formation_energy' or 'formation_energy_per_species'. More...
 
double evaluate (const Configuration &config) const override
 Returns the atom fraction. More...
 
std::unique_ptr< Clexclone () const
 Clone using copy constructor. More...
 
void init (const Configuration &_tmplt) const override
 If not yet initialized, use the global clexulator and eci from the PrimClex. More...
 
bool parse_args (const std::string &args) override
 Expects 'clex', 'clex(formation_energy)', or 'clex(formation_energy_per_species)'. More...
 
std::string short_header (const Configuration &_tmplt) const override
 Short header returns: 'clex(formation_energy)', 'clex(formation_energy_per_species)', etc. More...
 
virtual ValueType operator() (const DataObject &obj) const
 Return requested data from obj, throwing std::runtime_error if not valid. More...
 
virtual ValueType evaluate (const DataObject &obj) const =0
 
virtual void inject (const DataObject &_data_obj, DataStream &_stream, Index pass_index=0) const override
 Default implementation injects each element, via operator<<. 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, via operator<<. More...
 
virtual jsonParserto_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 FormatterType type () const
 
const DictTypehome () 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 void init (const DataObject &_template_obj) const
 
virtual bool validate (const DataObject &_data_obj) const
 Returns true if _data_obj has valid values for requested data. More...
 
virtual std::vector< std::string > col_header (const DataObject &_template_obj) const
 Returns a header string for each scalar produced by the formatter parsing the entries in the col_header should reproduce the exact query described by the formatter. Ex: "clex(formation_energy)" or "comp(a)", "comp(c)". 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
 

Static Public Attributes

static const std::string Name = "clex"
 
static const std::string Desc
 

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

double _norm (const Configuration &config) const
 Returns the normalization. More...
 
Clex_clone () const override
 Clone using copy constructor. More...
 

Private Attributes

std::string m_clex_name
 
Clexulator m_clexulator
 
ECIContainer m_eci
 
notstd::cloneable_ptr< Norm
< Configuration > > 
m_norm
 

Member Typedef Documentation

Definition at line 313 of file DataFormatter.hh.

Definition at line 315 of file DataFormatter.hh.

typedef multivector<Index>::X<2> CASM::BaseDatumFormatter< DataObject >::IndexContainer
protectedinherited

Definition at line 435 of file DataFormatter.hh.

Member Enumeration Documentation

Definition at line 314 of file DataFormatter.hh.

Constructor & Destructor Documentation

CASM::ConfigIO::Clex::Clex ( )

Definition at line 235 of file ConfigIO.cc.

CASM::ConfigIO::Clex::Clex ( const Clexulator clexulator,
const ECIContainer eci,
const Norm< Configuration > &  norm 
)

Construct with Clexulator, ECI, and either 'formation_energy' or 'formation_energy_per_species'.

Definition at line 240 of file ConfigIO.cc.

Member Function Documentation

void CASM::BaseDatumFormatter< DataObject >::_add_rule ( const std::vector< Index > &  new_rule) const
inlineprotectedinherited

Definition at line 447 of file DataFormatter.hh.

Clex * CASM::ConfigIO::Clex::_clone ( ) const
overrideprivatevirtual

Clone using copy constructor.

Implements CASM::BaseValueFormatter< ValueType, DataObject >.

Definition at line 315 of file ConfigIO.cc.

const IndexContainer& CASM::BaseDatumFormatter< DataObject >::_index_rules ( ) const
inlineprotectedinherited

Definition at line 451 of file DataFormatter.hh.

double CASM::ConfigIO::Clex::_norm ( const Configuration config) const
private

Returns the normalization.

Definition at line 310 of file ConfigIO.cc.

void CASM::BaseDatumFormatter< DataObject >::_parse_index_expression ( const std::string &  _expr)
protectedinherited

Derived DatumFormatters have some optional functionality for parsing index expressions in order to make it easy to handle ranges such as:

formatter_name(3,4:8)

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}}

std::unique_ptr< Clex > CASM::ConfigIO::Clex::clone ( ) const

Clone using copy constructor.

Definition at line 253 of file ConfigIO.cc.

virtual std::vector<std::string> CASM::BaseDatumFormatter< DataObject >::col_header ( const DataObject _template_obj) const
inlinevirtualinherited

Returns a header string for each scalar produced by the formatter parsing the entries in the col_header should reproduce the exact query described by the formatter. Ex: "clex(formation_energy)" or "comp(a)", "comp(c)".

  • Default uses col_header

Reimplemented in CASM::Base1DDatumFormatter< Container, DataObject >, and CASM::DatumFormatterAlias< DataObject >.

Definition at line 373 of file DataFormatter.hh.

const std::string& CASM::BaseDatumFormatter< DataObject >::description ( ) const
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 332 of file DataFormatter.hh.

double CASM::ConfigIO::Clex::evaluate ( const Configuration config) const
override

Returns the atom fraction.

Definition at line 248 of file ConfigIO.cc.

template<typename ValueType, typename DataObject>
virtual ValueType CASM::BaseValueFormatter< ValueType, DataObject >::evaluate ( const DataObject obj) const
pure virtualinherited
const DictType& CASM::BaseDatumFormatter< DataObject >::home ( ) const
inlineinherited

const Access the dictionary containing this formatter, set during DictType::lookup

Definition at line 341 of file DataFormatter.hh.

virtual void CASM::BaseDatumFormatter< DataObject >::init ( const DataObject _template_obj) const
inlinevirtualinherited
void CASM::ConfigIO::Clex::init ( const Configuration _tmplt) const
override

If not yet initialized, use the global clexulator and eci from the PrimClex.

If not yet initialized, use the default cluster expansion from the PrimClex.

Definition at line 258 of file ConfigIO.cc.

template<typename ValueType, typename DataObject>
virtual void CASM::BaseValueFormatter< ValueType, DataObject >::inject ( const DataObject _data_obj,
DataStream _stream,
Index  pass_index = 0 
) const
inlineoverridevirtualinherited

Default implementation injects each element, via operator<<.

Implements CASM::BaseDatumFormatter< DataObject >.

Reimplemented in CASM::Base1DDatumFormatter< Container, DataObject >.

Definition at line 747 of file DataFormatterTools.hh.

virtual std::string CASM::BaseDatumFormatter< DataObject >::long_header ( const DataObject _template_obj) const
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)".

  • Default uses col_header

Definition at line 382 of file DataFormatter.hh.

const std::string& CASM::BaseDatumFormatter< DataObject >::name ( ) const
inlineinherited

Returns a name for the formatter, which becomes the tag used for parsing.

Definition at line 326 of file DataFormatter.hh.

virtual Index CASM::BaseDatumFormatter< DataObject >::num_passes ( const DataObject _data_obj) const
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::DatumFormatterAlias< DataObject >.

Definition at line 406 of file DataFormatter.hh.

template<typename ValueType, typename DataObject>
virtual ValueType CASM::BaseValueFormatter< ValueType, DataObject >::operator() ( const DataObject obj) const
inlinevirtualinherited

Return requested data from obj, throwing std::runtime_error if not valid.

Definition at line 729 of file DataFormatterTools.hh.

bool CASM::ConfigIO::Clex::parse_args ( const std::string &  args)
overridevirtual

Expects 'clex', 'clex(formation_energy)', or 'clex(formation_energy_per_species)'.

Expects 'clex', 'clex(formation_energy)', or 'clex(formation_energy,per_species)'.

Reimplemented from CASM::BaseDatumFormatter< DataObject >.

Definition at line 276 of file ConfigIO.cc.

template<typename ValueType, typename DataObject>
virtual void CASM::BaseValueFormatter< ValueType, DataObject >::print ( const DataObject _data_obj,
std::ostream &  _stream,
Index  pass_index = 0 
) const
inlineoverridevirtualinherited

Default implementation prints each element in a column, via operator<<.

  • Prints "unknown" if validation fails

Implements CASM::BaseDatumFormatter< DataObject >.

Reimplemented in CASM::Base1DDatumFormatter< Container, DataObject >.

Definition at line 757 of file DataFormatterTools.hh.

void CASM::BaseDatumFormatter< DataObject >::set_home ( const DictType home) const
inlineinherited

Set the dictionary containing this formatter, set during DictType::lookup.

Definition at line 346 of file DataFormatter.hh.

std::string CASM::ConfigIO::Clex::short_header ( const Configuration _tmplt) const
inlineoverride

Short header returns: 'clex(formation_energy)', 'clex(formation_energy_per_species)', etc.

Definition at line 370 of file ConfigIO.hh.

virtual std::string CASM::BaseDatumFormatter< DataObject >::short_header ( const DataObject _template_obj) const
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 400 of file DataFormatter.hh.

template<typename ValueType, typename DataObject>
virtual jsonParser& CASM::BaseValueFormatter< ValueType, DataObject >::to_json ( const DataObject _data_obj,
jsonParser json 
) const
inlineoverridevirtualinherited

Default implementation calls jsonParser& to_json(const ValueType&, jsonParser&)

  • Does nothing if validation fails

Implements CASM::BaseDatumFormatter< DataObject >.

Definition at line 769 of file DataFormatterTools.hh.

virtual bool CASM::BaseDatumFormatter< DataObject >::validate ( const DataObject _data_obj) const
inlinevirtualinherited

Returns true if _data_obj has valid values for requested data.

Default implementation always returns true

Reimplemented in CASM::Generic1DDatumFormatter< Container, DataObject >, CASM::GenericDatumFormatter< ValueType, DataObject >, CASM::DatumFormatterAlias< DataObject >, and CASM::DataFormatterOperator< ValueType, ArgType, DataObject >.

Definition at line 363 of file DataFormatter.hh.

Member Data Documentation

const std::string CASM::ConfigIO::Clex::Desc
static
Initial value:
=
"Predicted property value."
" Accepts arguments ($clex_name,$norm)."
" ($clex_name is a cluster expansion name as listed by 'casm settings -l', default=the default clex)"
" ($norm is the normalization, either 'per_species', or 'per_unitcell' <--default)"

Definition at line 340 of file ConfigIO.hh.

std::string CASM::ConfigIO::Clex::m_clex_name
mutableprivate

Definition at line 382 of file ConfigIO.hh.

Clexulator CASM::ConfigIO::Clex::m_clexulator
mutableprivate

Definition at line 383 of file ConfigIO.hh.

ECIContainer CASM::ConfigIO::Clex::m_eci
mutableprivate

Definition at line 384 of file ConfigIO.hh.

notstd::cloneable_ptr<Norm<Configuration> > CASM::ConfigIO::Clex::m_norm
mutableprivate

Definition at line 385 of file ConfigIO.hh.

const std::string CASM::ConfigIO::Clex::Name = "clex"
static

Definition at line 338 of file ConfigIO.hh.


The documentation for this class was generated from the following files: