A cached energies object. More...

#include <Energies.hh>

Inheritance diagram for core::scoring::Energies:

Collaboration diagram for core::scoring::Energies:

Public Types
typedef scoring::EnergyGraph	EnergyGraph

typedef scoring::NeighborList	NeighborList

typedef scoring::ScoreType	ScoreType

typedef scoring::ScoreFunctionInfo	ScoreFunctionInfo

typedef basic::datacache::BasicDataCache	BasicDataCache

typedef id::AtomID	AtomID

typedef id::AtomID_Mask	AtomID_Mask

typedef kinematics::DomainMap	DomainMap

typedef graph::Graph	Graph

typedef scoring::EnergyMap	EnergyMap

Public Member Functions
	Energies ()
	ctor – ensure correct initial state More...

	Energies (Energies const &src)
	copy ctor – deep copy More...

virtual Energies const &	operator= (Energies const &rhs)
	assignment operator – deep copy More...

virtual bool	same_type_as_me (Energies const &other, bool recurse=true) const

virtual	~Energies ()
	dtor More...

virtual EnergiesOP	clone () const

void	set_owner (pose::PoseAP owner)
	Pose must claim its Energies object; this should happen once, at the time the Pose is allocated. Future copying of the Energies object will not change ownership. The purpose of ownership is to allow lazy context-graph creation. When context graphs are requested that have not been created, they must be created and their edges must be updated to represent the current conformation of the pose. More...

Real	total_energy () const
	energy access More...

Real &	total_energy ()

EnergyMap const &	total_energies () const
	Returns the total_energies EnergyMap after first computing the component energies if they are not up-to-date. More...

EnergyMap &	total_energies ()
	Returns a non-const reference to the total_energies EnergyMap so that external sources may append additional information to the Energies object. This is primarily useful for outputting score data with structures when those terms are not part of the energy function. This function will update the component energies if they are not up-to-date. More...

EnergyMap const &	onebody_energies (int const seqpos) const
	Read access to the components of the one-body energies. More...

EnergyMap &	onebody_energies (int const seqpos)
	Write access to the components of the one-body energies. This access is intended only for the ScoreFunction. More...

EnergyMap const &	finalized_energies () const
	Read access to the components of the "finalized" energies; These will include any score component calculated in the finalize phase of score function evaluation. These energies are copied between Energies objects, and are not evaluated during the component- energy update. More...

EnergyMap &	finalized_energies ()
	Write access to the components of the "finalized" energies. This access is intended only for the ScoreFunction. More...

EnergyMap const &	residue_total_energies (int const seqpos) const
	Returns the unweighted total_energies EnergyMap for Residue <seqpos> More...

Real	residue_total_energy (int const seqpos) const
	Returns the weighted total energy of residue <seqpos> More...

EnergyGraph const &	energy_graph () const
	Read access to the EnergyGraph. More...

EnergyGraph &	energy_graph ()
	Write access to the EnergyGraph. More...

TenANeighborGraph const &	tenA_neighbor_graph () const
	get the graph encoding # neighbors within 10 Angstroms If the graph has not been requested up until this point, then it will be instantiated and filled. If the pose has changed size since the last score function evaluation (or if the pose has never been scored) this function will exit. More...

TenANeighborGraph &	tenA_neighbor_graph ()
	Write access to the graph encoding # neighbors within 10 Angstroms If the graph has not been requested up until this point, then it will be instantiated and filled. If the pose has changed size since the last score function evaluation (or if the pose has never been scored) this function will exit. More...

scoring::TwelveANeighborGraph const &	twelveA_neighbor_graph () const
	get the graph encoding # neighbors within 12 Angstroms More...

scoring::TwelveANeighborGraph &	twelveA_neighbor_graph ()
	get the graph encoding # CB (or Gly CA) neighbors within 12 Angstroms of the side-chain "centroid" atom for each residue. More...

scoring::ContextGraphCOP	context_graph (scoring::ContextGraphType type) const
	const access to a particular context graph More...

scoring::ContextGraphOP	context_graph (scoring::ContextGraphType type)
	non-const access to a particular context graph More...

void	require_context_graph (scoring::ContextGraphType) const
	Allows non-scorefunction components of Rosetta to impose requirements on the context graphs that this object maintains. More...

EnergyMap	weights () const
	Returns an EnergyMap of the ScoreFunction weights from the last scoring. More...

void	weights (EnergyMap new_weights)
	Setter for the weights in this Energies object. More...

void	update_residue_neighbors (DomainMap const &domain_map_in, pose::Pose const &pose)
	update the residue neighbors More...

bool	residue_neighbors_updated () const

bool	energies_updated () const
	Returns true if the score is up-to-date. More...

bool	res_moved (int const seqpos) const
	check if rsd has changed internal conformation, necessitating, recomputation of 1d energies like dun,intra,prob,etc More...

void	reset_res_moved (int const seqpos)

void	clear_energies ()
	for debugging – forget all stored energies, does not change size More...

Size	size () const
	Returns the number of held residue energies. More...

bool	scoring () const
	are we in the midst of a scoring calculation? More...

void	show (std::ostream &out) const

void	show (std::ostream &out, Size res) const

void	show () const

void	show (Size res) const
	Shows the energy information of residue <seqpos> More...

void	show_totals (std::ostream &out) const

void	show_total_headers (std::ostream &out) const

void	structure_has_moved (Size const nres) const
	called (eg by pose) to notify us of a change to the structure More...

void	scoring_begin (scoring::ScoreFunction const &sfxn, pose::Pose const &pose)
	Notification of the start of a scoring calculation. More...

void	scoring_end (scoring::ScoreFunction const &scorefxn)
	signal from the scorefxn that scoring is over More...

scoring::ScoreFunctionInfo const &	get_scorefxn_info () const
	get scorefxn info More...

void	clear ()
	kill everything (that nobody forgot about) More...

bool	use_nblist () const

bool	use_nblist_auto_update () const

MinimizationGraphOP	minimization_graph ()

MinimizationGraphCOP	minimization_graph () const

void	set_minimization_graph (MinimizationGraphOP)

scoring::NeighborList const &	nblist (EnergiesCacheableDataType::Enum const &type) const

void	set_nblist (EnergiesCacheableDataType::Enum const &type, scoring::NeighborListOP nblist_in)

void	set_use_nblist (pose::Pose const &pose, DomainMap const &domain_map_in, bool const use_nblist_auto_update)

void	reset_nblist ()

BasicDataCache const &	data () const
	BasicDataCache indexed by enum in core/scoring/EnergiesCacheableDataType.hh. More...

BasicDataCache &	data ()
	BasicDataCache indexed by enum in core/scoring/EnergiesCacheableDataType.hh. More...

bool	discard_conformation_domain_map () const
	instructs Pose whether the domain map info in the Conformation object should be discarded More...

int	domain_map (int const pos) const
	Return the color assigned to a particular residue (index = pos) as held in the domain map describing how this residue has moved with respect to the other residues in the pose. More...

DomainMap const &	domain_map () const
	Read access for the domain map. More...

void	set_long_range_container (methods::LongRangeEnergyType, LREnergyContainerOP)

LREnergyContainerOP	nonconst_long_range_container (methods::LongRangeEnergyType)

LREnergyContainerCOP	long_range_container (methods::LongRangeEnergyType) const

Protected Member Functions
conformation::PointGraphOP	point_graph ()
	get access to the point graph. For derived classes More...

EnergyGraph &	energy_graph_no_state_check ()
	Write access to the EnergyGraph. More...

utility::vector1 < ContextGraphOP > &	context_graphs () const

utility::vector1< bool > &	required_context_graphs () const

Real	max_context_neighbor_cutoff () const

void	set_max_context_neighbor_cutoff (Real val) const

pose::PoseAP	owner () const

int	domain_map_during_minimization (int const pos) const
	Read access for the domain map. There is only one difference to the public interface to the domain_map_: we don't reequire that scoring is performed. This function is used during minimization by derived classes of the minimizer. More...

Private Types
enum	EnergyState { BAD, MOD, GOOD }
	should push this into energygraph once it stabilizes More...

Private Member Functions
void	set_size (Size const size_in)
	Internal method to resize data that is dependent on the number of residues in the Pose. More...

void	require_scoring () const
	will die if not in the middle of an energy evaluation More...

void	update_component_energies () const
	Lazy component evaluation for residue pair energies;. More...

void	accumulate_residue_total_energies () const
	Lazy update of residue total component energies; only compute them when they are requested. Forces an update of the energy_graph_. More...

void	accumulate_residue_total_energy () const
	Lazy update of the per-residue total weighted energy. Only computed when requested. Does not force an update of the energy_graph_. More...

void	accumulate_residue_energies (ScoreType const &type) const
	sum the residue energies to this type to get a total energy More...

void	set_scorefxn_info (scoring::ScoreFunctionInfoOP info)
	update the context graphs and the energy graph according to a new score function type More...

void	internalize_new_domain_map ()
	Save state information from the domain map and wipe dirty energies. More...

void	prepare_neighbor_graphs ()
	Delete edges from energy_graph and tenA_neighbor_graph according to the movement history described by the domain map. More...

void	delete_graph_edges_using_domain_map (graph::Graph &g)
	removes all edges in the graph that represent connections that have changed; More...

void	update_domainmap_for_lr_energy_container (LREnergyContainerOP lrec)
	Reset the "already computed" status for pairs of residues represented in a particular long-range energy container using the domain map. More...

virtual void	update_neighbor_links (pose::Pose const &pose)
	Detect the new set of neighbors given the structure of the Pose (find_neighbors()) and add new edges to the neighbor graphs so that the status of the neighbor graphs is current wrt the current conformation. More...

virtual void	fill_point_graph (pose::Pose const &pose, conformation::PointGraphOP pg) const
	Create a point graph representing the xyz coordinates of the "neighbor atoms." (Each residue_type indicates one of its atoms to be used for neighbor detection – e.g. CB for most amino acids, CA for GLY.) The point graph will then be used in a call to find_neighbors to add upper-edges to neighboring residues. More...

void	copy_nblists (Energies const &other)
	During Energies copy-ctor and assignment operator, copy over the neighbor lists objects (clone them). More...

void	copy_context_graphs (Energies const &other)
	During Energies copy-ctor and assignment operator, copy over the context graphs and the historical information about who required them (a score term, e.g. the HBondEnergy, or some other function, e.g. pack_rotamers) More...

void	copy_lr_energy_containers (Energies const &other)
	During Energies copy-ctor and assignment operator, copy over the long-range energy containers from the source Energies object. More...

virtual void	require_context_graph_ (scoring::ContextGraphType type, bool external) const
	Internal method that handles the bookkeeping for intializing a new context graph, either requested by a scoring term (external = false) or some other function (external = true ). More...

Private Attributes
Size	size_
	our internal nres More...

pose::PoseAP	owner_

EnergyGraphOP	energy_graph_

utility::vector1< ContextGraphOP >	context_graphs_
	The collection of context graphs used by the context-dependent energy components which the Energies object is responsible for maintaining. Context graphs are allocated as requested, (e.g. in a call to tenA_neighbor_graph() ), if they have not yet been allocated. If a portion of the code requires a context graph (e.g the packer), it may call require_context_graph( int cgtype ), which will create the context graph immediately. More...

utility::vector1< bool >	externally_required_context_graphs_
	those required by non-score function entities (e.g. the packer). More...

utility::vector1< bool >	required_context_graphs_
	OR of the sfxn required context graphs and the externally required ones. More...

Real	max_context_neighbor_cutoff_
	The maximum neighbor cutoff for all required context graphs;. More...

utility::vector1 < LREnergyContainerOP >	long_range_energy_containers_

std::map < EnergiesCacheableDataType::Enum, scoring::NeighborListOP >	nblist_
	atom-atom neighborlists More...

bool	use_nblist_

bool	use_nblist_auto_update_

MinimizationGraphOP	minimization_graph_

utility::vector1< EnergyMap >	onebody_energies_

bool	residue_total_energies_uptodate_
	cached energy component totals – summed twobody and one body interactions for each residue More...

utility::vector1< EnergyMap >	residue_total_energies_

bool	residue_total_energy_uptodate_
	cached energy totals – only the weighted sum, no components. More...

utility::vector1< Real >	residue_total_energy_

EnergyMap	total_energies_
	cached total energies More...

Real	total_energy_

EnergyMap	finalized_energies_
	Energies computed during the finalize() stage of scoring. More...

scoring::ScoreFunctionInfoOP	scorefxn_info_
	info about last score evaluation More...

EnergyMap	scorefxn_weights_
	ScoreFunction weights from the last scoring call. More...

DomainMap	domain_map_

bool	scoring_
	are we within a scoring evaluation? More...

EnergyState	energy_state_

EnergyState	graph_state_

BasicDataCache	data_cache_
	BasicDataCache indexed by enum in core/scoring/EnergiesCacheableDataType.hh. More...

conformation::PointGraphOP	point_graph_

Friends
std::ostream &	operator<< (std::ostream &out, const Energies &e)

Detailed Description

A cached energies object.

Stores total, residue, and residue-pair energies, as well as residue neighbor information.

Meant to replace fullatom_energies:: namespace.

Stores residue neighbor information as well as cached residue pair energies in O(N) space using a graph.

Also stores a DomainMap object which is used during scoring to know which rsd pairs have changed relative orientation and which residues have changed internally

Note: We distinguish between two kinds of per-residue (1D) energy: onebody residue energies and twobody residue energies. Onebody residue energies are things like dunbrack, intrares, Paa, which depend only on the state of the residue in question. Twobody residue energies (like the residue atr energy) are summations of twobody interactions involving a single residue. The onebody energies can be reused at positions whose internal phi/psi/chi conformation hasn't changed. Twobody residue energies, on the other hand must be invalidated if the structure has changed at all.

Definition at line 94 of file Energies.hh.

Member Typedef Documentation

typedef id::AtomID core::scoring::Energies::AtomID

Definition at line 106 of file Energies.hh.

typedef id::AtomID_Mask core::scoring::Energies::AtomID_Mask

Definition at line 107 of file Energies.hh.

typedef basic::datacache::BasicDataCache core::scoring::Energies::BasicDataCache

Definition at line 102 of file Energies.hh.

typedef kinematics::DomainMap core::scoring::Energies::DomainMap

Definition at line 108 of file Energies.hh.

typedef scoring::EnergyGraph core::scoring::Energies::EnergyGraph

Definition at line 98 of file Energies.hh.

typedef scoring::EnergyMap core::scoring::Energies::EnergyMap

Definition at line 112 of file Energies.hh.

typedef graph::Graph core::scoring::Energies::Graph

Definition at line 110 of file Energies.hh.

typedef scoring::NeighborList core::scoring::Energies::NeighborList

Definition at line 99 of file Energies.hh.

typedef scoring::ScoreFunctionInfo core::scoring::Energies::ScoreFunctionInfo

Definition at line 101 of file Energies.hh.

typedef scoring::ScoreType core::scoring::Energies::ScoreType

Definition at line 100 of file Energies.hh.

Member Enumeration Documentation

enum core::scoring::Energies::EnergyState

private

should push this into energygraph once it stabilizes

Enumerator
BAD
MOD
GOOD

Definition at line 613 of file Energies.hh.

Constructor & Destructor Documentation

core::scoring::Energies::Energies ( )

ctor – ensure correct initial state

Definition at line 73 of file Energies.cc.

Referenced by clone().

core::scoring::Energies::Energies ( Energies const & src)

copy ctor – deep copy

Definition at line 100 of file Energies.cc.

References copy_context_graphs(), copy_lr_energy_containers(), and copy_nblists().

core::scoring::Energies::~Energies ( )

virtual

dtor

Definition at line 191 of file Energies.cc.

Member Function Documentation

void core::scoring::Energies::accumulate_residue_energies ( ScoreType const & type) const

private

sum the residue energies to this type to get a total energy

void core::scoring::Energies::accumulate_residue_total_energies ( ) const

private

Lazy update of residue total component energies; only compute them when they are requested. Forces an update of the energy_graph_.

Definition at line 937 of file Energies.cc.

References energies_updated(), energy_graph_, energy_state_, core::graph::Edge::get_second_node_ind(), GOOD, long_range_energy_containers_, core::scoring::n_score_types, core::scoring::n_shortranged_2b_score_types, onebody_energies_, residue_total_energies_, residue_total_energies_uptodate_, scorefxn_weights_, size_, core::scoring::total_score, and use_nblist().

Referenced by residue_total_energies(), and show().

void core::scoring::Energies::accumulate_residue_total_energy ( ) const

private

Lazy update of the per-residue total weighted energy. Only computed when requested. Does not force an update of the energy_graph_.

Definition at line 1027 of file Energies.cc.

References core::scoring::EnergyEdge::dot(), core::scoring::EMapVector::dot(), energy_graph_, core::graph::Edge::get_second_node_ind(), long_range_energy_containers_, core::scoring::n_shortranged_2b_score_types, onebody_energies_, residue_total_energy_, residue_total_energy_uptodate_, scorefxn_weights_, and size_.

Referenced by residue_total_energy().

void core::scoring::Energies::clear ( )

kill everything (that nobody forgot about)

Definition at line 780 of file Energies.cc.

References clear_energies(), domain_map_, scorefxn_weights_, set_scorefxn_info(), size_, and core::scoring::EMapVector::zero().

Referenced by protocols::cluster::GatherPosesMover::apply(), protocols::flexpack::FlexPacker::apply(), protocols::simple_moves::ReturnSidechainMover::apply(), protocols::moves::MonteCarlo::boltzmann(), protocols::fldsgn::BluePrintBDR::centroid_build(), protocols::forge::components::BDR::centroid_build(), protocols::forge::remodel::RemodelMover::centroid_build(), protocols::forge::components::VarLengthBuild::centroid_build(), protocols::forge::components::BDR::design_refine(), protocols::forge::remodel::RemodelMover::design_refine(), protocols::forge::remodel::RemodelMover::design_refine_seq_relax(), core::io::silent::BinaryProteinSilentStruct::fill_pose(), protocols::forge::build::BuildInstruction::modify(), protocols::frag_picker::FragmentCandidate::output_silent(), protocols::toolbox::pose_manipulation::remove_non_protein_residues(), protocols::forge::methods::restore_residues(), protocols::moves::MonteCarlo::score_function(), and core::util::switch_to_residue_type_set().

void core::scoring::Energies::clear_energies ( )

for debugging – forget all stored energies, does not change size

Definition at line 434 of file Energies.cc.

References BAD, core::scoring::EMapVector::clear(), context_graphs_, domain_map_, energy_graph_, energy_state_, graph_state_, long_range_energy_containers_, onebody_energies_, residue_total_energies_, residue_total_energies_uptodate_, residue_total_energy_, residue_total_energy_uptodate_, size_, and total_energies_.

Referenced by clear().

EnergiesOP core::scoring::Energies::clone ( ) const

virtual

make a copy of this Energies( allocate actual memory for it )

Reimplemented in core::scoring::symmetry::SymmetricEnergies, and core::scoring::solid_surface::SurfaceEnergies.

Definition at line 198 of file Energies.cc.

References Energies().

scoring::ContextGraphCOP core::scoring::Energies::context_graph ( scoring::ContextGraphType type) const

const access to a particular context graph

Definition at line 352 of file Energies.cc.

References context_graphs_, GOOD, graph_state_, and require_context_graph_().

scoring::ContextGraphOP core::scoring::Energies::context_graph ( scoring::ContextGraphType type)

non-const access to a particular context graph

Definition at line 343 of file Energies.cc.

References context_graphs_, GOOD, graph_state_, and require_context_graph_().

utility::vector1< ContextGraphOP > & core::scoring::Energies::context_graphs ( ) const

protected

Definition at line 392 of file Energies.cc.

References context_graphs_.

Referenced by core::scoring::symmetry::SymmetricEnergies::require_context_graph_(), and core::scoring::symmetry::SymmetricEnergies::update_neighbor_links().

void core::scoring::Energies::copy_context_graphs ( Energies const & other)

private

During Energies copy-ctor and assignment operator, copy over the context graphs and the historical information about who required them (a score term, e.g. the HBondEnergy, or some other function, e.g. pack_rotamers)

Definition at line 1241 of file Energies.cc.

References context_graphs_, externally_required_context_graphs_, max_context_neighbor_cutoff_, and required_context_graphs_.

Referenced by Energies(), and operator=().

void core::scoring::Energies::copy_lr_energy_containers ( Energies const & other)

private

During Energies copy-ctor and assignment operator, copy over the long-range energy containers from the source Energies object.

Definition at line 1256 of file Energies.cc.

References long_range_energy_containers_.

Referenced by Energies(), and operator=().

void core::scoring::Energies::copy_nblists ( Energies const & other)

private

During Energies copy-ctor and assignment operator, copy over the neighbor lists objects (clone them).

Definition at line 1231 of file Energies.cc.

References nblist_.

Referenced by Energies(), and operator=().

BasicDataCache const& core::scoring::Energies::data ( ) const

inline

BasicDataCache indexed by enum in core/scoring/EnergiesCacheableDataType.hh.

Definition at line 523 of file Energies.hh.

References data_cache_.

BasicDataCache& core::scoring::Energies::data ( )

inline

BasicDataCache indexed by enum in core/scoring/EnergiesCacheableDataType.hh.

Definition at line 530 of file Energies.hh.

References data_cache_.

void core::scoring::Energies::delete_graph_edges_using_domain_map ( graph::Graph & g)

private

removes all edges in the graph that represent connections that have changed;

O(N) as it iterates across the edges that already exist, instead over over all pairs that moved with respect to each other (which would be O(N^2)) and deleting any obsolete edges

Definition at line 499 of file Energies.cc.

References core::graph::Graph::delete_edge(), domain_map_, core::graph::Graph::edge_list_begin(), and core::graph::Graph::edge_list_end().

Referenced by prepare_neighbor_graphs().

bool core::scoring::Energies::discard_conformation_domain_map ( ) const

instructs Pose whether the domain map info in the Conformation object should be discarded

because the Energies object does not update the EnergyGraph during minimization, the Pose should not direct the conformation object to discard its movement data. Movement data should be discarded immediately after a call to update_neighbors where use_nblist_ has been false.

Definition at line 892 of file Energies.cc.

References use_nblist_.

int core::scoring::Energies::domain_map ( int const pos) const

inline

Return the color assigned to a particular residue (index = pos) as held in the domain map describing how this residue has moved with respect to the other residues in the pose.

CAUTION new behavior: domain_map may not return 0 for residues that have undergone internal degree of freedom changes since the last scoring. Ask the res_moved() method for that information

Definition at line 545 of file Energies.hh.

References domain_map_, and require_scoring().

Referenced by core::scoring::hackelec::HackElecEnergy::finalize_total_energy(), and core::scoring::etable::BaseEtableEnergy< Derived >::finalize_total_energy().

DomainMap const& core::scoring::Energies::domain_map ( ) const

inline

Read access for the domain map.

Definition at line 553 of file Energies.hh.

References domain_map_, and require_scoring().

int core::scoring::Energies::domain_map_during_minimization ( int const pos) const

inlineprotected

Read access for the domain map. There is only one difference to the public interface to the domain_map_: we don't reequire that scoring is performed. This function is used during minimization by derived classes of the minimizer.

Definition at line 598 of file Energies.hh.

References domain_map_.

Referenced by core::scoring::symmetry::SymmetricEnergies::update_neighbor_links().

bool core::scoring::Energies::energies_updated ( ) const

inline

Returns true if the score is up-to-date.

example(s): pose.energies().energies_updated() See also: Energies Energies.residue_total_energy Energies.residue_total_energies Pose ScoreFunction ScoreFunction.show create_score_function

Definition at line 358 of file Energies.hh.

References energy_state_, and GOOD.

Referenced by accumulate_residue_total_energies(), protocols::multistate_design::SingleStateFitnessFunction::evaluate(), core::io::pdb::extract_scores(), core::scoring::ScoreFunction::get_sub_score(), core::scoring::ScoreFunction::get_sub_score_exclude_res(), protocols::toolbox::pose_metric_calculators::DecomposeAndReweightEnergiesCalculator::recompute(), residue_total_energies(), residue_total_energy(), protocols::moves::PyMolMover::send_energy(), and protocols::features::ProteinSilentReport::write_full_report().

Energies::EnergyGraph const & core::scoring::Energies::energy_graph ( ) const

Read access to the EnergyGraph.

get the energy graph (const)

assert that the graph state reflects the current set of neighbors; if the structure has moved, the neighbors may have changed. update_residue_neighbors should have been called first. If nb_list_ is true then update_residue_neighbors will set the graph state to GOOD without updating the neighbors.

Definition at line 244 of file Energies.cc.

References energy_graph_, GOOD, and graph_state_.

Referenced by protocols::enzdes::SecondaryMatchProtocol::add_enz_cst_interaction_to_pose(), protocols::features::helixAssembly::HelixBundleFeatures::calc_fa_energy(), protocols::enzdes::PackRotamersMoverPartGreedy::choose_n_best(), core::scoring::rna::RNA_PairwiseLowResolutionEnergy::clean_up_rna_two_body_energy_tables(), core::pack::compare_mingraph_and_energy_graph(), core::pack::compare_simple_inteaction_graph_alt_state_and_energy_graph(), protocols::simple_filters::ResidueSetChainEnergyFilter::compute(), core::scoring::EnvPairPotential::compute_centroid_environment(), core::scoring::SmoothEnvPairPotential::compute_centroid_environment(), core::scoring::SmoothEnvPairPotential::compute_dcentroid_environment(), protocols::toolbox::pose_metric_calculators::NumberHBondsCalculator::compute_Hbonds_for_residue(), core::pack::create_packer_graph(), core::scoring::geometric_solvation::ContextIndependentGeometricSolEnergy::eval_atom_derivative(), core::scoring::geometric_solvation::GeometricSolEnergy::eval_atom_derivative(), core::scoring::rna::RNA_LowResolutionPotential::eval_atom_derivative_base_base(), core::scoring::rna::RNA_LowResolutionPotential::eval_atom_derivative_rna_backbone_backbone(), core::scoring::rna::RNA_LowResolutionPotential::eval_atom_derivative_rna_base_backbone(), core::scoring::rna::RNA_LowResolutionPotential::eval_atom_derivative_rna_repulsive(), core::scoring::geometric_solvation::ContextIndependentGeometricSolEnergy::eval_atom_energy(), core::scoring::geometric_solvation::GeometricSolEnergy::eval_atom_energy(), protocols::enzdes::EnzdesFlexibleRegion::extract_lig_designability_score(), protocols::swa::protein::StepWiseProteinPacker::figure_out_neighbors(), protocols::swa::protein::StepWiseProteinResidueSampler::figure_out_neighbors(), core::scoring::WaterAdductHBondPotential::fill_h2o_hbond_set(), core::scoring::hbonds::fill_hbond_set(), core::scoring::hbonds::fill_hbond_set_by_AHdist_threshold(), protocols::ligand_docking::LigandBaseProtocol::get_non_bb_clashing_rotamers(), protocols::swa::monte_carlo::RNA_O2StarMover::get_random_o2star_residue_near_moving_residue(), core::scoring::SecondaryStructurePotential::hspair(), protocols::simple_filters::RotamerBoltzmannWeight::interface_interaction_energy(), protocols::swa::protein::StepWiseProteinPoseMinimizer::let_neighboring_chis_minimize(), core::scoring::electron_density::ElectronDensity::matchRes(), protocols::simple_filters::ScoreCutoffFilter::output_residue_pair_energies(), protocols::scoring::Interface::protein_calculate(), core::pose::metrics::simple_calculators::InterfaceDeltaEnergeticsCalculator::recompute(), protocols::toolbox::pose_metric_calculators::NonlocalContactsCalculator::recompute(), protocols::toolbox::pose_metric_calculators::DecomposeAndReweightEnergiesCalculator::recompute(), protocols::fldsgn::potentials::sspot::HSPairPotential::score(), protocols::fldsgn::potentials::sspot::SSPairPotential::score(), protocols::fldsgn::potentials::sspot::NatbiasStrandPairPotential::score(), protocols::vip::set_local_movemap(), core::scoring::symmetry::SymmetricScoreFunction::setup_for_minimizing(), core::scoring::ScoreFunction::setup_for_minimizing(), core::scoring::SecondaryStructurePotential::sspair(), core::optimization::symmetry::SymMinimizerMap::SymMinimizerMap(), and core::scoring::rna::RNA_LowResolutionPotential::update_rna_base_base_interactions().

Energies::EnergyGraph & core::scoring::Energies::energy_graph ( )

Write access to the EnergyGraph.

get the energy graph - see comments for const version of this method

Definition at line 252 of file Energies.cc.

References energy_graph_, GOOD, and graph_state_.

Energies::EnergyGraph & core::scoring::Energies::energy_graph_no_state_check ( )

protected

Write access to the EnergyGraph.

IA: Note derived classes may need access to graph before it has been initalized! In particular a derived class might overload update_residue_neighbors.

Definition at line 261 of file Energies.cc.

References energy_graph_.

Referenced by core::scoring::symmetry::SymmetricEnergies::update_neighbor_links().

void core::scoring::Energies::fill_point_graph	(	pose::Pose const &	pose,
		conformation::PointGraphOP	pg
	)		const

privatevirtual

Create a point graph representing the xyz coordinates of the "neighbor atoms." (Each residue_type indicates one of its atoms to be used for neighbor detection – e.g. CB for most amino acids, CA for GLY.) The point graph will then be used in a call to find_neighbors to add upper-edges to neighboring residues.

determine distance cutoff threshold based on scorefxn_info_ and then add edges to the PointGraph class

Reimplemented in core::scoring::solid_surface::SurfaceEnergies, and core::scoring::symmetry::SymmetricEnergies.

Definition at line 1216 of file Energies.cc.

References core::pose::Pose::conformation(), max_context_neighbor_cutoff_, core::pose::pose_max_nbr_radius(), core::conformation::residue_point_graph_from_conformation(), and scorefxn_info_.

Referenced by require_context_graph_(), and update_neighbor_links().

EnergyMap const& core::scoring::Energies::finalized_energies ( ) const

inline

Read access to the components of the "finalized" energies; These will include any score component calculated in the finalize phase of score function evaluation. These energies are copied between Energies objects, and are not evaluated during the component- energy update.

Definition at line 208 of file Energies.hh.

References finalized_energies_.

Referenced by core::scoring::symmetry::SymmetricScoreFunction::correct_finalize_score(), core::scoring::symmetry::SymmetricScoreFunction::operator()(), and core::scoring::ScoreFunction::operator()().

EnergyMap& core::scoring::Energies::finalized_energies ( )

inline

Write access to the components of the "finalized" energies. This access is intended only for the ScoreFunction.

Definition at line 215 of file Energies.hh.

References finalized_energies_.

scoring::ScoreFunctionInfo const& core::scoring::Energies::get_scorefxn_info ( ) const

inline

get scorefxn info

Definition at line 468 of file Energies.hh.

References scorefxn_info_.

Referenced by core::scoring::symmetry::SymmetricEnergies::fill_point_graph(), core::scoring::solid_surface::SurfaceEnergies::fill_point_graph(), core::scoring::operator<<(), show_total_headers(), show_totals(), and core::scoring::symmetry::SymmetricEnergies::update_neighbor_links().

void core::scoring::Energies::internalize_new_domain_map ( )

private

Save state information from the domain map and wipe dirty energies.

Definition at line 918 of file Energies.cc.

References domain_map_, energy_graph_, onebody_energies_, and size_.

Referenced by scoring_begin(), set_use_nblist(), and update_residue_neighbors().

LREnergyContainerCOP core::scoring::Energies::long_range_container ( methods::LongRangeEnergyType lrtype) const

Definition at line 910 of file Energies.cc.

References long_range_energy_containers_.

Real core::scoring::Energies::max_context_neighbor_cutoff ( ) const

protected

Definition at line 404 of file Energies.cc.

References max_context_neighbor_cutoff_.

Referenced by core::scoring::symmetry::SymmetricEnergies::fill_point_graph(), core::scoring::solid_surface::SurfaceEnergies::fill_point_graph(), and core::scoring::symmetry::SymmetricEnergies::require_context_graph_().

MinimizationGraphOP core::scoring::Energies::minimization_graph ( )

Definition at line 536 of file Energies.cc.

References minimization_graph_.

Referenced by core::optimization::atom_tree_get_atompairE_deriv(), core::optimization::cartesian_collect_atompairE_deriv(), core::scoring::symmetry::SymmetricScoreFunction::eval_dof_derivative(), core::scoring::ScoreFunction::eval_dof_derivative(), core::scoring::symmetry::SymmetricScoreFunction::eval_npd_atom_derivative(), core::scoring::ScoreFunction::eval_npd_atom_derivative(), core::scoring::symmetry::SymmetricScoreFunction::operator()(), core::scoring::ScoreFunction::operator()(), core::scoring::ScoreFunction::setup_for_derivatives(), and core::scoring::ScoreFunction::setup_for_scoring().

MinimizationGraphCOP core::scoring::Energies::minimization_graph ( ) const

Definition at line 542 of file Energies.cc.

References minimization_graph_.

scoring::NeighborList const & core::scoring::Energies::nblist ( EnergiesCacheableDataType::Enum const & type) const

Definition at line 555 of file Energies.cc.

References nblist_, and use_nblist_.

Referenced by core::scoring::etable::BaseEtableEnergy< Derived >::eval_atom_derivative(), core::scoring::hackelec::HackElecEnergy::finalize_total_energy(), core::scoring::etable::BaseEtableEnergy< Derived >::finalize_total_energy(), core::scoring::etable::BaseEtableEnergy< Derived >::setup_for_derivatives(), core::scoring::hackelec::HackElecEnergy::setup_for_scoring(), and core::scoring::etable::BaseEtableEnergy< Derived >::setup_for_scoring().

LREnergyContainerOP core::scoring::Energies::nonconst_long_range_container ( methods::LongRangeEnergyType lrtype)

Definition at line 904 of file Energies.cc.

References long_range_energy_containers_.

Referenced by core::scoring::disulfides::FullatomDisulfideEnergy::ensure_lrenergy_container_is_up_to_date(), core::scoring::symmetry::SymmetricScoreFunction::eval_long_range_twobody_energies(), core::scoring::ScoreFunction::eval_long_range_twobody_energies(), core::scoring::sym_e::symEnergy::setup_for_scoring(), core::scoring::disulfides::DisulfideMatchingEnergy::setup_for_scoring(), and core::scoring::disulfides::CentroidDisulfideEnergy::setup_for_scoring().

EnergyMap const& core::scoring::Energies::onebody_energies ( int const seqpos) const

inline

Read access to the components of the one-body energies.

Definition at line 189 of file Energies.hh.

References onebody_energies_.

Referenced by core::pack::compare_mingraph_and_energy_graph(), core::pack::compare_simple_inteaction_graph_alt_state_and_energy_graph(), core::scoring::Ramachandran::eval_rama_score_all(), protocols::toolbox::pose_metric_calculators::DecomposeAndReweightEnergiesCalculator::recompute(), and core::scoring::ScoreFunction::setup_for_minimizing_for_node().

EnergyMap& core::scoring::Energies::onebody_energies ( int const seqpos)

inline

Write access to the components of the one-body energies. This access is intended only for the ScoreFunction.

Definition at line 197 of file Energies.hh.

References onebody_energies_.

Energies const & core::scoring::Energies::operator= ( Energies const & rhs)

virtual

assignment operator – deep copy

Reimplemented in core::scoring::symmetry::SymmetricEnergies, and core::scoring::solid_surface::SurfaceEnergies.

Definition at line 137 of file Energies.cc.

References context_graphs_, copy_context_graphs(), copy_lr_energy_containers(), copy_nblists(), data_cache_, domain_map_, energy_graph_, energy_state_, finalized_energies_, graph_state_, minimization_graph_, core::scoring::num_context_graph_types, onebody_energies_, residue_total_energies_uptodate_, residue_total_energy_, residue_total_energy_uptodate_, scorefxn_info_, scorefxn_weights_, scoring_, size_, total_energies_, total_energy_, use_nblist_, and use_nblist_auto_update_.

Referenced by core::scoring::solid_surface::SurfaceEnergies::operator=(), and core::scoring::symmetry::SymmetricEnergies::operator=().

pose::PoseAP core::scoring::Energies::owner ( ) const

protected

Definition at line 416 of file Energies.cc.

References owner_.

Referenced by core::scoring::symmetry::SymmetricEnergies::require_context_graph_(), and set_owner().

conformation::PointGraphOP core::scoring::Energies::point_graph ( )

protected

get access to the point graph. For derived classes

Definition at line 386 of file Energies.cc.

References point_graph_.

Referenced by core::scoring::symmetry::SymmetricEnergies::require_context_graph_(), require_context_graph_(), and core::scoring::symmetry::SymmetricEnergies::update_neighbor_links().

void core::scoring::Energies::prepare_neighbor_graphs ( )

private

Delete edges from energy_graph and tenA_neighbor_graph according to the movement history described by the domain map.

Definition at line 464 of file Energies.cc.

References BAD, context_graphs_, delete_graph_edges_using_domain_map(), energy_graph_, graph_state_, long_range_energy_containers_, and update_domainmap_for_lr_energy_container().

Referenced by scoring_begin(), and update_residue_neighbors().

void core::scoring::Energies::require_context_graph ( scoring::ContextGraphType type) const

Allows non-scorefunction components of Rosetta to impose requirements on the context graphs that this object maintains.

Definition at line 360 of file Energies.cc.

References require_context_graph_().

void core::scoring::Energies::require_context_graph_	(	scoring::ContextGraphType	type,
		bool	external
	)		const

privatevirtual

Internal method that handles the bookkeeping for intializing a new context graph, either requested by a scoring term (external = false) or some other function (external = true ).

Create a context graph. If the requirement is external, someone other than a ScoreFunction has declared that the context graph is needed (possibly by asking for it right now) so the graph must also be made up-to-date.

Reimplemented in core::scoring::symmetry::SymmetricEnergies.

Definition at line 1271 of file Energies.cc.

References context_graphs_, core::scoring::ContextGraphFactory::create_context_graph(), externally_required_context_graphs_, fill_point_graph(), max_context_neighbor_cutoff_, owner_, point_graph(), required_context_graphs_, scorefxn_info_, and size_.

Referenced by context_graph(), require_context_graph(), set_scorefxn_info(), tenA_neighbor_graph(), and twelveA_neighbor_graph().

void core::scoring::Energies::require_scoring ( ) const

inlineprivate

will die if not in the middle of an energy evaluation

Definition at line 812 of file Energies.hh.

References scoring_.

Referenced by domain_map(), and res_moved().

utility::vector1< bool > & core::scoring::Energies::required_context_graphs ( ) const

protected

Definition at line 398 of file Energies.cc.

References required_context_graphs_.

Referenced by core::scoring::symmetry::SymmetricEnergies::require_context_graph_().

bool core::scoring::Energies::res_moved ( int const seqpos) const

check if rsd has changed internal conformation, necessitating, recomputation of 1d energies like dun,intra,prob,etc

Definition at line 1403 of file Energies.cc.

References energy_graph_, and require_scoring().

void core::scoring::Energies::reset_nblist ( )

Definition at line 793 of file Energies.cc.

References graph_state_, minimization_graph_, MOD, nblist_, scoring_, size_, structure_has_moved(), and use_nblist_.

Referenced by core::optimization::symmetry::SymAtomTreeMinimizer::run(), core::optimization::CartesianMinimizer::run(), and core::optimization::AtomTreeMinimizer::run().

void core::scoring::Energies::reset_res_moved ( int const seqpos)

Definition at line 814 of file Energies.cc.

References energy_graph_.

bool core::scoring::Energies::residue_neighbors_updated ( ) const

inline

Definition at line 340 of file Energies.hh.

References GOOD, and graph_state_.

Referenced by core::pack::interaction_graph::SurfacePotential::compute_pose_surface_energy(), core::pack::interaction_graph::SurfacePotential::compute_residue_surface_energy(), core::scoring::hbonds::fill_hbond_set(), protocols::features::AtomInResidueAtomInResiduePairFeatures::report_atom_pairs(), protocols::features::AtomAtomPairFeatures::report_atom_pairs(), protocols::features::HBondFeatures::report_features(), and protocols::features::PairFeatures::report_residue_pairs().

EnergyMap const& core::scoring::Energies::residue_total_energies ( int const seqpos) const

inline

Returns the unweighted total_energies EnergyMap for Residue <seqpos>

Note: : only evaluated when requested (lazy!), inaccessible during minimization, EnergyMap is an EMapVector

example(s): r3 = pose.energies().residue_total_energies(3) r3[fa_sol] See also: Energies Energies.residue_total_energy Pose ScoreFunction ScoreFunction.show create_score_function EMapVector

Definition at line 236 of file Energies.hh.

References accumulate_residue_total_energies(), energies_updated(), residue_total_energies_, residue_total_energies_uptodate_, size(), and use_nblist().

Referenced by protocols::enzdes::SecondaryMatchProtocol::add_enz_cst_interaction_to_pose(), protocols::analysis::LoopAnalyzerMover::apply(), protocols::flexpep_docking::FlexPepDockingPoseMetrics::calc_pep_scores(), protocols::analysis::InterfaceAnalyzerMover::calc_per_residue_energy(), protocols::fldsgn::filters::CoreDunbrackFilter::compute(), protocols::sasa_scores::compute_avge_scores(), protocols::enzdes::EnzdesScorefileFilter::compute_metrics_for_residue_subset(), protocols::enzdes::LigInterfaceEnergyFilter::constraint_energy(), protocols::toolbox::pose_metric_calculators::NumberHBondsCalculator::determine_res_to_recompute(), core::pose::Pose::dump_scored_pdb(), protocols::jobdist::PlainPdbJobDistributor::dump_scores(), core::io::pdb::extract_scores(), protocols::simple_moves::ddG::fill_per_residue_energy_vector(), protocols::nonlocal::get_per_residue_score(), protocols::relax::get_per_residue_scores(), protocols::enzdes::EnzdesFlexibleRegion::get_region_mm_bend_score(), protocols::simple_filters::ScoreCutoffFilter::get_score(), core::scoring::operator<<(), protocols::simple_filters::EnergyPerResidueFilter::report(), protocols::optimize_weights::IterativeOptEDriver::residue_has_unacceptably_bad_dunbrack_energy(), protocols::toolbox::pose_metric_calculators::SemiExplicitWaterUnsatisfiedPolarsCalculator::semiexpl_water_hbgeom_score(), protocols::moves::PyMolMover::send_energy(), protocols::simple_moves::EnergyCutRotamerTrialsMinMover::setup_energycut_task(), protocols::enzdes::enzutil::sum_constraint_scoreterms(), and protocols::protein_interface_design::sum_total_residue_energy().

Real core::scoring::Energies::residue_total_energy ( int const seqpos) const

inline

Returns the weighted total energy of residue <seqpos>

example(s): pose.energies().residue_total_energy(3) See also: Energies Energies.residue_total_energies Pose ScoreFunction ScoreFunction.show create_score_function

Definition at line 257 of file Energies.hh.

References accumulate_residue_total_energy(), energies_updated(), residue_total_energy_, residue_total_energy_uptodate_, size(), and use_nblist().

Referenced by protocols::flexpep_docking::FlexPepDockingPoseMetrics::calc_pep_scores(), protocols::analysis::InterfaceAnalyzerMover::compute_interface_energy(), protocols::enzdes::EnzdesBaseProtocol::design_targets_score(), protocols::enzdes::EnzdesFlexibleRegion::get_region_total_score(), protocols::features::ResidueTotalScoresFeatures::insert_residue_total_scores_rows(), protocols::moves::PyMolMover::send_energy(), protocols::simple_moves::symmetry::SymEnergyCutRotamerTrialsMover::setup_energycut_task(), and protocols::simple_moves::EnergyCutRotamerTrialsMover::setup_energycut_task().

bool core::scoring::Energies::same_type_as_me	(	Energies const &	other,
		bool	recurse = `true`
	)		const

virtual

determine whether my type is the same as another Conformation's

If recurse is true, then this is the first call to same_type_as_me;

Reimplemented in core::scoring::symmetry::SymmetricEnergies, and core::scoring::solid_surface::SurfaceEnergies.

Definition at line 180 of file Energies.cc.

References same_type_as_me().

Referenced by core::scoring::solid_surface::SurfaceEnergies::same_type_as_me(), core::scoring::symmetry::SymmetricEnergies::same_type_as_me(), and same_type_as_me().

bool core::scoring::Energies::scoring ( ) const

inline

are we in the midst of a scoring calculation?

Definition at line 399 of file Energies.hh.

References scoring_.

Referenced by set_scorefxn_info(), tenA_neighbor_graph(), twelveA_neighbor_graph(), core::scoring::symmetry::SymmetricEnergies::update_neighbor_links(), and update_neighbor_links().

void core::scoring::Energies::scoring_begin	(	scoring::ScoreFunction const &	sfxn,
		pose::Pose const &	pose
	)

Notification of the start of a scoring calculation.

This is called by ScoreFunction at the start of an energy calculation.

the responsibilities are:

to check for size/scorefxn mismatches,
reset some of the cached energies Expect that Energies::structure_has_moved( ... ) has been called already if the stucture has changed, ie if domain_map != 1

Definition at line 1328 of file Energies.cc.

References BAD, core::scoring::EMapVector::clear(), domain_map_, energy_state_, finalized_energies_, graph_state_, core::scoring::ScoreFunction::info(), internalize_new_domain_map(), MOD, prepare_neighbor_graphs(), residue_total_energies_uptodate_, residue_total_energy_uptodate_, scorefxn_info_, scorefxn_weights_, scoring_, set_scorefxn_info(), set_size(), size_, total_energies_, total_energy_, core::pose::Pose::total_residue(), update_neighbor_links(), core::scoring::ScoreFunction::weights(), and core::scoring::EMapVector::zero().

void core::scoring::Energies::scoring_end ( scoring::ScoreFunction const & scorefxn)

signal from the scorefxn that scoring is over

Definition at line 1396 of file Energies.cc.

References energy_state_, GOOD, and scoring_.

void core::scoring::Energies::set_long_range_container	(	methods::LongRangeEnergyType	lrtype,
		LREnergyContainerOP	lrec
	)

Definition at line 898 of file Energies.cc.

References long_range_energy_containers_.

Referenced by core::scoring::disulfides::FullatomDisulfideEnergy::ensure_lrenergy_container_is_up_to_date(), core::scoring::sym_e::symEnergy::setup_for_scoring(), core::scoring::disulfides::DisulfideMatchingEnergy::setup_for_scoring(), and core::scoring::disulfides::CentroidDisulfideEnergy::setup_for_scoring().

void core::scoring::Energies::set_max_context_neighbor_cutoff ( Real val) const

protected

Definition at line 410 of file Energies.cc.

References max_context_neighbor_cutoff_.

Referenced by core::scoring::symmetry::SymmetricEnergies::require_context_graph_().

void core::scoring::Energies::set_minimization_graph ( MinimizationGraphOP mingraph)

Definition at line 548 of file Energies.cc.

References minimization_graph_.

Referenced by core::scoring::ScoreFunction::setup_for_minimizing().

void core::scoring::Energies::set_nblist	(	EnergiesCacheableDataType::Enum const &	type,
		scoring::NeighborListOP	nblist_in
	)

Definition at line 564 of file Energies.cc.

References nblist_, and use_nblist_.

void core::scoring::Energies::set_owner ( pose::PoseAP owner)

Pose must claim its Energies object; this should happen once, at the time the Pose is allocated. Future copying of the Energies object will not change ownership. The purpose of ownership is to allow lazy context-graph creation. When context graphs are requested that have not been created, they must be created and their edges must be updated to represent the current conformation of the pose.

Definition at line 205 of file Energies.cc.

References owner(), and owner_.

void core::scoring::Energies::set_scorefxn_info ( scoring::ScoreFunctionInfoOP info)

private

update the context graphs and the energy graph according to a new score function type

Definition at line 1089 of file Energies.cc.

References context_graphs_, energy_graph_, externally_required_context_graphs_, max_context_neighbor_cutoff_, core::scoring::n_shortranged_2b_score_types, core::scoring::num_context_graph_types, require_context_graph_(), required_context_graphs_, scorefxn_info_, and scoring().

Referenced by clear(), and scoring_begin().

void core::scoring::Energies::set_size ( Size const size_in)

private

Internal method to resize data that is dependent on the number of residues in the Pose.

Definition at line 821 of file Energies.cc.

References core::scoring::EMapVector::clear(), context_graphs_, domain_map_, energy_graph_, long_range_energy_containers_, onebody_energies_, residue_total_energies_, residue_total_energies_uptodate_, residue_total_energy_, residue_total_energy_uptodate_, size_, and total_energies_.

Referenced by scoring_begin(), and update_residue_neighbors().

void core::scoring::Energies::set_use_nblist	(	pose::Pose const &	pose,
		DomainMap const &	domain_map_in,
		bool const	use_nblist_auto_update
	)

Definition at line 575 of file Energies.cc.

References domain_map_, energy_state_, GOOD, internalize_new_domain_map(), scoring_, use_nblist_, use_nblist_auto_update(), and use_nblist_auto_update_.

Referenced by core::optimization::symmetry::SymAtomTreeMinimizer::run(), core::optimization::CartesianMinimizer::run(), and core::optimization::AtomTreeMinimizer::run().

void core::scoring::Energies::show ( std::ostream & out) const

Show the per-residue and total energies, only for scores with a non-zero weight in the last energy evaluation

Definition at line 614 of file Energies.cc.

References protocols::comparative_modeling::features::A, accumulate_residue_total_energies(), core::scoring::EMapVector::begin(), core::scoring::EMapVector::end(), energy_state_, GOOD, core::scoring::name_from_score_type(), residue_total_energies_, residue_total_energies_uptodate_, scorefxn_weights_, size(), and total_energies_.

Referenced by protocols::simple_moves::ScoreMover::apply().

void core::scoring::Energies::show	(	std::ostream &	out,
		Size	res
	)		const

Show the residue energies, only for scores with a non-zero weight in the last energy evaluation

Definition at line 658 of file Energies.cc.

References protocols::comparative_modeling::features::A, accumulate_residue_total_energies(), core::scoring::EMapVector::begin(), core::scoring::EMapVector::end(), energy_state_, GOOD, core::scoring::name_from_score_type(), residue_total_energies_, residue_total_energies_uptodate_, scorefxn_weights_, and total_energies_.

void core::scoring::Energies::show ( ) const

inline

Definition at line 414 of file Energies.hh.

References show().

Referenced by show().

void core::scoring::Energies::show ( Size res) const

inline

Shows the energy information of residue <seqpos>

Note: : wrapper function of energies.show(Size) for Pyrosetta

example(s): pose.energies().show(3) See also: Energies Energies.residue_total_energies Energies.residue_total_energy Pose ScoreFunction ScoreFunction.show create_score_function

Definition at line 430 of file Energies.hh.

References show().

Referenced by show().

void core::scoring::Energies::show_total_headers ( std::ostream & out) const

Definition at line 751 of file Energies.cc.

References core::sequence::end, get_scorefxn_info(), and total_energies().

void core::scoring::Energies::show_totals ( std::ostream & out) const

Definition at line 764 of file Energies.cc.

References core::sequence::end, get_scorefxn_info(), and total_energies().

Size core::scoring::Energies::size ( ) const

inline

Returns the number of held residue energies.

example(s): r3 = pose.energies().residue_total_energies(3) r3[fa_sol] See also: Energies Energies.residue_total_energies Energies.residue_total_energy Pose ScoreFunction ScoreFunction.show create_score_function

Definition at line 392 of file Energies.hh.

References size_.

Referenced by core::scoring::operator<<(), core::scoring::symmetry::SymmetricEnergies::require_context_graph_(), residue_total_energies(), residue_total_energy(), show(), and core::scoring::symmetry::SymmetricEnergies::update_neighbor_links().

void core::scoring::Energies::structure_has_moved ( Size const nres) const

called (eg by pose) to notify us of a change to the structure

Triggers clearing of the total energies and the twobody rsd energies PHIL – should also mark the neighbor links as invalid somehow... Called by pose when someone tries to access us, if the Conformation indicates that the structure has moved since the last score evaluation

const b/c called inside const access methods

Definition at line 730 of file Energies.cc.

References BAD, energy_state_, GOOD, graph_state_, MOD, residue_total_energies_uptodate_, residue_total_energy_uptodate_, scoring_, size_, and total_energy_.

Referenced by reset_nblist().

scoring::TenANeighborGraph const & core::scoring::Energies::tenA_neighbor_graph ( ) const

get the graph encoding # neighbors within 10 Angstroms If the graph has not been requested up until this point, then it will be instantiated and filled. If the pose has changed size since the last score function evaluation (or if the pose has never been scored) this function will exit.

convenience function – this function violates the idea that the energies object doesn't know the kind of context information its maintaining. There is no reason to add a method like this for future context graphs.

Definition at line 271 of file Energies.cc.

References context_graphs_, GOOD, graph_state_, require_context_graph_(), scoring(), and core::scoring::ten_A_neighbor_graph.

Referenced by protocols::hotspot_hashing::HotspotStubSet::add_hotspot_constraints_to_pose(), core::scoring::geometric_solvation::add_to_individual_sol_energies(), protocols::toolbox::rotamer_set_operations::RigidBodyMoveBaseRSO::alter_rotamer_set(), core::pack::rotamer_set::RotamerSet_::build_rotamers_for_concrete(), protocols::fldsgn::filters::InterlockingAromaFilter::compute(), protocols::toolbox::pose_metric_calculators::NumberHBondsCalculator::compute_Hbonds_for_residue(), core::pack::rotamer_set::RotamerSet_::compute_one_body_energy_maps(), core::scoring::geometric_solvation::ExactOccludedHbondSolEnergy::compute_polar_group_sol_energy(), core::pack::interaction_graph::SurfacePotential::compute_pose_surface_energy(), core::scoring::methods::PairEnergy::eval_residue_pair_derivatives(), core::scoring::hbonds::HBondEnergy::evaluate_rotamer_background_energies(), core::scoring::hbonds::HBondEnergy::evaluate_rotamer_pair_energies(), core::scoring::WaterAdductHBondPotential::fill_h2o_hbond_set(), core::scoring::hbonds::fill_hbond_set(), core::scoring::hbonds::fill_hbond_set_by_AHdist_threshold(), protocols::enzdes::EnzdesFlexibleRegion::get_12A_neighbors(), core::scoring::geometric_solvation::GeometricSolEnergy::get_atom_atom_geometric_solvation_for_acceptor(), core::scoring::geometric_solvation::GeometricSolEnergy::get_atom_atom_geometric_solvation_for_donor(), protocols::optimize_weights::IterativeOptEDriver::get_nat_aa_opte_data(), protocols::enzdes::EnzdesFlexBBProtocol::get_tenA_neighbor_residues(), protocols::loops::get_tenA_neighbor_residues(), protocols::features::HBondFeatures::insert_hbond_dehydron_row(), protocols::match::NumNeighborsMPM::modified_match_positions(), protocols::features::AtomInResidueAtomInResiduePairFeatures::report_atom_pairs(), protocols::features::ProteinBackboneAtomAtomPairFeatures::report_features(), protocols::features::ResidueBurialFeatures::report_features(), protocols::features::PairFeatures::report_residue_pairs(), core::scoring::geometric_solvation::OccludedHbondSolEnergy_onebody::residue_energy(), core::scoring::geometric_solvation::ExactOccludedHbondSolEnergy::residue_energy(), core::scoring::methods::PairEnergy::residue_pair_energy(), core::io::sequence_comparation::DesignContrast::setNeighbors(), core::scoring::hbonds::HBondSet::setup_for_residue_pair_energies(), and core::scoring::hbonds::HBondEnergy::sidechain_sidechain_energy().

scoring::TenANeighborGraph & core::scoring::Energies::tenA_neighbor_graph ( )

Write access to the graph encoding # neighbors within 10 Angstroms If the graph has not been requested up until this point, then it will be instantiated and filled. If the pose has changed size since the last score function evaluation (or if the pose has never been scored) this function will exit.

get the graph encoding # neighbors within 10 Angstroms – see comments for const version of this method

Definition at line 288 of file Energies.cc.

References context_graphs_, GOOD, graph_state_, require_context_graph_(), scoring(), and core::scoring::ten_A_neighbor_graph.

EnergyMap const & core::scoring::Energies::total_energies ( ) const

Returns the total_energies EnergyMap after first computing the component energies if they are not up-to-date.

Definition at line 224 of file Energies.cc.

References total_energies_.

EnergyMap & core::scoring::Energies::total_energies ( )

Returns a non-const reference to the total_energies EnergyMap so that external sources may append additional information to the Energies object. This is primarily useful for outputting score data with structures when those terms are not part of the energy function. This function will update the component energies if they are not up-to-date.

Definition at line 230 of file Energies.cc.

References total_energies_.

Real core::scoring::Energies::total_energy ( ) const

inline

energy access

Returns the total score

example(s): pose.energies().total_energy() See also: Energies Energies.residue_total_energy Energies.residue_total_energies Pose ScoreFunction ScoreFunction.show create_score_function

Definition at line 163 of file Energies.hh.

References total_energy_.

Referenced by protocols::moves::JumpOutMover::apply(), protocols::simple_filters::EvaluatedTrialMover::apply(), protocols::antibody2::RefineOneCDRLoop::apply(), protocols::moves::TrialMover::apply(), protocols::forge::remodel::RemodelLoopMover::apply(), protocols::symmetric_docking::SymDockProtocol::docking_highres_filter(), protocols::multistate_design::SingleStateFitnessFunction::evaluate(), protocols::vip::VIP_Report::get_GOE_relaxed_report(), protocols::vip::VIP_Report::get_GOE_repack_report(), core::scoring::symmetry::SymmetricScoreFunction::operator()(), core::scoring::ScoreFunction::operator()(), protocols::vip::VIP_Mover::relax_favorable_poses(), protocols::vip::VIP_Mover::sort_fill_energies(), core::pose::total_energy_from_pose(), protocols::vip::VIP_Mover::try_point_mutants(), protocols::canonical_sampling::MetricRecorder::update_after_boltzmann(), and protocols::canonical_sampling::PDBTrajectoryRecorder::write_model().

Real& core::scoring::Energies::total_energy ( )

inline

Definition at line 169 of file Energies.hh.

References total_energy_.

scoring::TwelveANeighborGraph const & core::scoring::Energies::twelveA_neighbor_graph ( ) const

get the graph encoding # neighbors within 12 Angstroms

convenience function – this function violates the idea that the energies object doesn't know the kind of context information its maintaining. There is no reason to add a method like this for future context graphs.

Definition at line 308 of file Energies.cc.

References context_graphs_, GOOD, graph_state_, require_context_graph_(), scoring(), and core::scoring::twelve_A_neighbor_graph.

Referenced by core::scoring::methods::EnvSmoothEnergy::eval_atom_derivative(), core::scoring::methods::MembraneEnvSmoothEnergy::eval_atom_derivative(), protocols::features::ResidueBurialFeatures::report_features(), core::scoring::methods::BurialEnergy::residue_energy(), core::scoring::nv::NVscore::residue_energy(), core::scoring::methods::EnvSmoothEnergy::residue_energy(), and core::scoring::methods::MembraneEnvSmoothEnergy::residue_energy().

scoring::TwelveANeighborGraph & core::scoring::Energies::twelveA_neighbor_graph ( )

get the graph encoding # CB (or Gly CA) neighbors within 12 Angstroms of the side-chain "centroid" atom for each residue.

Definition at line 325 of file Energies.cc.

References context_graphs_, GOOD, graph_state_, require_context_graph_(), scoring(), and core::scoring::twelve_A_neighbor_graph.

void core::scoring::Energies::update_component_energies ( ) const

private

Lazy component evaluation for residue pair energies;.

void core::scoring::Energies::update_domainmap_for_lr_energy_container ( LREnergyContainerOP lrec)

private

Reset the "already computed" status for pairs of residues represented in a particular long-range energy container using the domain map.

Definition at line 517 of file Energies.cc.

References domain_map_, and size_.

Referenced by prepare_neighbor_graphs().

void core::scoring::Energies::update_neighbor_links ( pose::Pose const & pose)

privatevirtual

Detect the new set of neighbors given the structure of the Pose (find_neighbors()) and add new edges to the neighbor graphs so that the status of the neighbor graphs is current wrt the current conformation.

Add edges to the energy_graph and the context graphs according to domain map.

Precondition: if the graph contains any edges, then all neighbor relationships between pairs of residues that have not moved relative to each other are represented by the presence or absence of edges in the energy graph. If there are no edges in the energy graph, then all pair inforamtion must be calculated Precondition: if two residues have changed relative to one another according to the domain map, then there are no edges between them.

Reimplemented in core::scoring::symmetry::SymmetricEnergies.

Definition at line 1152 of file Energies.cc.

References context_graphs_, domain_map_, energy_graph_, fill_point_graph(), core::pose::symmetry::is_symmetric(), core::chemical::ResidueType::nbr_radius(), point_graph_, core::pose::Pose::residue_type(), scorefxn_info_, scoring(), and core::pose::Pose::total_residue().

Referenced by scoring_begin(), and update_residue_neighbors().

void core::scoring::Energies::update_residue_neighbors	(	DomainMap const &	domain_map_in,
		pose::Pose const &	pose
	)

update the residue neighbors

Definition at line 851 of file Energies.cc.

References BAD, domain_map_, GOOD, graph_state_, internalize_new_domain_map(), MOD, prepare_neighbor_graphs(), set_size(), size_, core::pose::Pose::total_residue(), update_neighbor_links(), and use_nblist_.

bool core::scoring::Energies::use_nblist ( ) const

inline

Definition at line 479 of file Energies.hh.

References use_nblist_.

Referenced by accumulate_residue_total_energies(), core::scoring::etable::BaseEtableEnergy< Derived >::backbone_backbone_energy(), core::scoring::etable::BaseEtableEnergy< Derived >::backbone_sidechain_energy(), core::scoring::symmetry::SymmetricScoreFunction::correct_finalize_score(), core::scoring::methods::MMLJEnergyIntra::eval_atom_derivative(), core::scoring::methods::MMLJEnergyInter::eval_atom_derivative(), core::scoring::etable::BaseEtableEnergy< Derived >::eval_atom_derivative(), core::scoring::etable::TableLookupEtableEnergy::eval_intrares_energy(), core::scoring::etable::AnalyticEtableEnergy::eval_intrares_energy(), core::scoring::symmetry::SymmetricScoreFunction::eval_long_range_twobody_energies(), core::scoring::ScoreFunction::eval_long_range_twobody_energies(), core::pack::interaction_graph::SurfaceEnergy::finalize_total_energy(), core::pack::interaction_graph::HPatchEnergy::finalize_total_energy(), core::scoring::hackelec::HackElecEnergy::finalize_total_energy(), core::scoring::hbonds::HBondEnergy::finalize_total_energy(), core::scoring::etable::BaseEtableEnergy< Derived >::finalize_total_energy(), core::scoring::electron_density::ElectronDensity::matchPoseToPatterson(), core::scoring::symmetry::SymmetricScoreFunction::operator()(), core::scoring::ScoreFunction::operator()(), core::scoring::hackelec::HackElecEnergy::residue_pair_energy(), core::scoring::etable::BaseEtableEnergy< Derived >::residue_pair_energy(), residue_total_energies(), residue_total_energy(), core::scoring::etable::BaseEtableEnergy< Derived >::setup_for_derivatives(), core::scoring::methods::MMLJEnergyIntra::setup_for_minimizing(), core::scoring::methods::MMLJEnergyInter::setup_for_minimizing(), core::scoring::hackelec::HackElecEnergy::setup_for_minimizing(), core::scoring::etable::BaseEtableEnergy< Derived >::setup_for_minimizing(), core::scoring::hackelec::HackElecEnergy::setup_for_scoring(), core::scoring::hbonds::HBondEnergy::setup_for_scoring(), core::scoring::etable::BaseEtableEnergy< Derived >::setup_for_scoring(), core::scoring::ScoreFunction::setup_for_scoring(), and core::scoring::etable::BaseEtableEnergy< Derived >::sidechain_sidechain_energy().

bool core::scoring::Energies::use_nblist_auto_update ( ) const

inline

Definition at line 485 of file Energies.hh.

References use_nblist_auto_update_.

EnergyMap core::scoring::Energies::weights ( ) const

Returns an EnergyMap of the ScoreFunction weights from the last scoring.

example(s): we = pose.energies().weights() we[fa_atr] See also: Energies Energies.residue_total_energies Energies.residue_total_energy Pose ScoreFunction ScoreFunction.show create_score_function EMapVector

May not be called during scoring, to discourage access by energy methods.

Definition at line 368 of file Energies.cc.

References scorefxn_weights_, and scoring_.

Referenced by protocols::enzdes::PackRotamersMoverPartGreedy::choose_n_best(), core::pack::compare_mingraph_and_energy_graph(), core::pack::compare_simple_inteaction_graph_alt_state_and_energy_graph(), protocols::enzdes::EnzdesScorefileFilter::compute_metrics_for_residue_subset(), protocols::enzdes::LigInterfaceEnergyFilter::constraint_energy(), protocols::jobdist::PlainPdbJobDistributor::dump_scores(), core::io::silent::SilentStruct::energies_from_pose(), core::io::silent::SilentStruct::energies_into_pose(), protocols::enzdes::EnzdesScorefileFilter::examine_pose(), protocols::enzdes::EnzdesFlexibleRegion::extract_lig_designability_score(), core::io::pdb::extract_scores(), protocols::simple_filters::ScoreCutoffFilter::get_score(), protocols::simple_filters::RotamerBoltzmannWeight::interface_interaction_energy(), protocols::simple_filters::ScoreCutoffFilter::output_residue_pair_energies(), core::pose::metrics::simple_calculators::InterfaceDeltaEnergeticsCalculator::recompute(), protocols::toolbox::pose_metric_calculators::NonlocalContactsCalculator::recompute(), protocols::toolbox::pose_metric_calculators::DecomposeAndReweightEnergiesCalculator::recompute(), protocols::jd2::ScoreMap::score_map_from_scored_pose(), protocols::enzdes::enzutil::sum_constraint_scoreterms(), and protocols::protein_interface_design::sum_total_residue_energy().

void core::scoring::Energies::weights ( EnergyMap new_weights)

Setter for the weights in this Energies object.

Definition at line 380 of file Energies.cc.

References scorefxn_weights_.

Friends And Related Function Documentation

std::ostream& operator<<	(	std::ostream &	out,
		const Energies &	e
	)

friend

Definition at line 685 of file Energies.cc.

Member Data Documentation

utility::vector1< ContextGraphOP > core::scoring::Energies::context_graphs_

mutableprivate

The collection of context graphs used by the context-dependent energy components which the Energies object is responsible for maintaining. Context graphs are allocated as requested, (e.g. in a call to tenA_neighbor_graph() ), if they have not yet been allocated. If a portion of the code requires a context graph (e.g the packer), it may call require_context_graph( int cgtype ), which will create the context graph immediately.

Definition at line 740 of file Energies.hh.

Referenced by clear_energies(), context_graph(), context_graphs(), copy_context_graphs(), operator=(), prepare_neighbor_graphs(), require_context_graph_(), set_scorefxn_info(), set_size(), tenA_neighbor_graph(), twelveA_neighbor_graph(), and update_neighbor_links().

BasicDataCache core::scoring::Energies::data_cache_

private

BasicDataCache indexed by enum in core/scoring/EnergiesCacheableDataType.hh.

Warning: DataCache must always be initialized with the number of cacheable data types – see the last enum entry.

Definition at line 798 of file Energies.hh.

Referenced by data(), and operator=().

DomainMap core::scoring::Energies::domain_map_

private

Domain map, stores information about the rigid-bodies whose internal conformation is unchanged since the last score calc'n If domain_map_(i) == 0 then residue i has changed internal conformation. – no longer true If domain_map_(i) > 0 and domain_map_(i) == domain_map_(j), then residues i and j are unchanged wrt one another

Definition at line 787 of file Energies.hh.

Referenced by clear(), clear_energies(), delete_graph_edges_using_domain_map(), domain_map(), domain_map_during_minimization(), internalize_new_domain_map(), operator=(), scoring_begin(), set_size(), set_use_nblist(), update_domainmap_for_lr_energy_container(), update_neighbor_links(), and update_residue_neighbors().

EnergyGraphOP core::scoring::Energies::energy_graph_

mutableprivate

Definition at line 732 of file Energies.hh.

Referenced by accumulate_residue_total_energies(), accumulate_residue_total_energy(), clear_energies(), energy_graph(), energy_graph_no_state_check(), internalize_new_domain_map(), operator=(), prepare_neighbor_graphs(), res_moved(), reset_res_moved(), set_scorefxn_info(), set_size(), and update_neighbor_links().

EnergyState core::scoring::Energies::energy_state_

mutableprivate

Definition at line 792 of file Energies.hh.

Referenced by accumulate_residue_total_energies(), clear_energies(), energies_updated(), operator=(), scoring_begin(), scoring_end(), set_use_nblist(), show(), and structure_has_moved().

utility::vector1< bool > core::scoring::Energies::externally_required_context_graphs_

mutableprivate

those required by non-score function entities (e.g. the packer).

Definition at line 742 of file Energies.hh.

Referenced by copy_context_graphs(), require_context_graph_(), and set_scorefxn_info().

EnergyMap core::scoring::Energies::finalized_energies_

private

Energies computed during the finalize() stage of scoring.

Definition at line 772 of file Energies.hh.

Referenced by finalized_energies(), operator=(), and scoring_begin().

EnergyState core::scoring::Energies::graph_state_

mutableprivate

Definition at line 793 of file Energies.hh.

Referenced by clear_energies(), context_graph(), energy_graph(), operator=(), prepare_neighbor_graphs(), reset_nblist(), residue_neighbors_updated(), scoring_begin(), structure_has_moved(), tenA_neighbor_graph(), twelveA_neighbor_graph(), and update_residue_neighbors().

utility::vector1< LREnergyContainerOP > core::scoring::Energies::long_range_energy_containers_

private

Definition at line 748 of file Energies.hh.

Referenced by accumulate_residue_total_energies(), accumulate_residue_total_energy(), clear_energies(), copy_lr_energy_containers(), long_range_container(), nonconst_long_range_container(), prepare_neighbor_graphs(), set_long_range_container(), and set_size().

Real core::scoring::Energies::max_context_neighbor_cutoff_

mutableprivate

The maximum neighbor cutoff for all required context graphs;.

Definition at line 746 of file Energies.hh.

Referenced by copy_context_graphs(), fill_point_graph(), max_context_neighbor_cutoff(), require_context_graph_(), set_max_context_neighbor_cutoff(), and set_scorefxn_info().

MinimizationGraphOP core::scoring::Energies::minimization_graph_

private

Definition at line 754 of file Energies.hh.

Referenced by minimization_graph(), operator=(), reset_nblist(), and set_minimization_graph().

std::map< EnergiesCacheableDataType::Enum, scoring::NeighborListOP > core::scoring::Energies::nblist_

private

atom-atom neighborlists

Definition at line 751 of file Energies.hh.

Referenced by copy_nblists(), nblist(), reset_nblist(), and set_nblist().

utility::vector1< EnergyMap > core::scoring::Energies::onebody_energies_

private

cached onebody energies – expensive – shortly to be replaced by an FArray2D which can be smarly indexed into to access only the active one-body energy terms.

Definition at line 758 of file Energies.hh.

Referenced by accumulate_residue_total_energies(), accumulate_residue_total_energy(), clear_energies(), internalize_new_domain_map(), onebody_energies(), operator=(), and set_size().

pose::PoseAP core::scoring::Energies::owner_

private

In order to do lazy context-graph creation, the Energies object must be able to access coordinates stored in the pose. This now means an Energies object cannot live independently of a Pose!

Definition at line 730 of file Energies.hh.

Referenced by owner(), require_context_graph_(), and set_owner().

conformation::PointGraphOP core::scoring::Energies::point_graph_

private

Keep this guy between score function evaluations to avoid the expense of recreating it each time; this data does not need to be copied in either the copy-ctor or the assignment operator Its purpose is solely to improve performance and the data is used only inside the neighbor calculation function call.

Definition at line 806 of file Energies.hh.

Referenced by point_graph(), and update_neighbor_links().

utility::vector1< bool > core::scoring::Energies::required_context_graphs_

mutableprivate

OR of the sfxn required context graphs and the externally required ones.

Definition at line 744 of file Energies.hh.

Referenced by copy_context_graphs(), require_context_graph_(), required_context_graphs(), and set_scorefxn_info().