A molecular system including residues, kinematics, and energies. More...

#include <Pose.hh>

Inheritance diagram for core::pose::Pose:

Public Types
typedef id::AtomID	AtomID

typedef id::NamedAtomID	NamedAtomID

typedef id::TorsionID	TorsionID

typedef id::DOF_ID	DOF_ID

typedef conformation::Residue	Residue

typedef conformation::Conformation	Conformation

typedef conformation::ConformationOP	ConformationOP

typedef conformation::ConformationCOP	ConformationCOP

typedef pose::datacache::ObserverCache	ObserverCache

typedef pose::datacache::ObserverCacheOP	ObserverCacheOP

typedef pose::signals::ConformationEvent	ConformationEvent

typedef pose::signals::DestructionEvent	DestructionEvent

typedef pose::signals::EnergyEvent	EnergyEvent

typedef pose::signals::GeneralEvent	GeneralEvent

typedef scoring::constraints::ConstraintSetOP	ConstraintSetOP

typedef scoring::constraints::ConstraintSetCOP	ConstraintSetCOP

typedef basic::datacache::BasicDataCache	BasicDataCache

typedef basic::datacache::BasicDataCacheOP	BasicDataCacheOP

typedef basic::datacache::ConstDataMap	ConstDataMap

typedef basic::datacache::ConstDataMapOP	ConstDataMapOP

typedef boost::indirect_iterator< conformation::ResidueOPs::const_iterator, Residue const >	const_iterator

typedef boost::indirect_iterator< conformation::ResidueOPs::iterator, Residue const >	iterator

Public Member Functions
iterator	begin () noexcept

const_iterator	begin () const noexcept

iterator	end () noexcept

const_iterator	end () const noexcept

	Pose ()
	default constructor, builds an empty pose More...

	~Pose () override
	destructor – > kill data on the heap More...

	Pose (Pose const &src)
	copy constructor More...

	Pose (Pose const &src, Size residue_begin, Size residue_end)
	partial copy constructor More...

Pose &	operator= (Pose const &src)
	Construct pose from pdb file. More...

void	detached_copy (Pose const &src)
	Performs a deep copy of the src Pose into this Pose in a way that guarantees that no non-bitwise-constant data is shared between them (such as the AtomTree's observer system) – this Pose will be effectively detached from any data that lives in other objects. More...

PoseOP	clone () const
	clone the conformation More...

PoseCOP	get_self_ptr () const
	self pointers More...

PoseOP	get_self_ptr ()

PoseCAP	get_self_weak_ptr () const

PoseAP	get_self_weak_ptr ()

Conformation const &	conformation () const
	Returns the pose Conformation (const-access) More...

Conformation &	conformation ()
	Returns the pose Conformation (non-const access) More...

ConformationCOP	conformation_ptr () const
	Returns the pose Conformation pointer (const access) More...

ConformationOP &	conformation_ptr ()
	Returns the pose Conformation pointer (nonconst access) More...

kinematics::FoldTree const &	fold_tree () const
	Returns the pose FoldTree. More...

void	fold_tree (kinematics::FoldTree const &fold_tree_in)
	Sets the pose FoldTree to <fold_tree_in> More...

void	set_new_conformation (conformation::ConformationCOP new_conformation)
	Now that the conformation_ member data is an owning pointer, and we have derived classes of Conformation. More...

void	set_new_energies_object (scoring::EnergiesOP energies)
	Now that the energies_ member data is an owning pointer, and we have derived classes of Energies. More...

kinematics::AtomTree const &	atom_tree () const
	Returns the pose AtomTree. More...

scoring::Energies const &	energies () const
	Returns the pose Energies (const-access) More...

scoring::Energies &	energies ()
	Returns the pose Energies (non-const access) More...

ConstraintSetCOP	constraint_set () const

scoring::constraints::ConstraintCOP	add_constraint (scoring::constraints::ConstraintCOP cst)
	adding a constraint is done by cloning the input constraint. A const copy is then returned More...

scoring::constraints::ConstraintCOPs	add_constraints (scoring::constraints::ConstraintCOPs const &csts)
	Add a list of constraints to a pose. More...

bool	remove_constraint (scoring::constraints::ConstraintCOP cst, bool object_comparison=false)
	re object_comparison see comment for ConstraintSet::remove_constraint function More...

bool	remove_constraints (scoring::constraints::ConstraintCOPs csts, bool object_comparison=false)
	re object_comparison see comment for ConstraintSet::remove_constraint function More...

bool	remove_constraints ()

void	clear_sequence_constraints ()
	Remove all sequence constraints from this pose. More...

void	constraint_set (ConstraintSetOP)

void	transfer_constraint_set (const pose::Pose &pose)

void	reference_pose_from_current (std::string const &ref_pose_name, bool override_current=false)
	Create a new reference pose from the current state of the pose. More...

core::pose::reference_pose::ReferencePoseSetOP	reference_pose_set ()
	Access the ReferencePoseSet object (non-const). More...

core::pose::reference_pose::ReferencePoseSetCOP	reference_pose_set_cop () const
	Const-access the ReferencePoseSet object. More...

core::Size	corresponding_residue_in_current (core::Size const ref_residue_index, std::string const &ref_pose_name) const
	Returns the index of a residue in this pose corresponding to a residue in a reference pose. More...

void	increment_reference_pose_mapping_after_seqpos (core::Size const seqpos)
	Find all mappings in the new pose after seqpos in all ReferencePose objects, and increment them by 1. More...

void	decrement_reference_pose_mapping_after_seqpos (core::Size const seqpos)
	Find all mappings in the new pose after seqpos in all ReferencePose objects, and decrement them by 1. More...

void	zero_reference_pose_mapping_at_seqpos (core::Size const seqpos)
	Find all mappings in the new pose to seqpos in all ReferencePose objects, and set them to point to residue 0 (deletion signal). More...

bool	has_reference_pose () const
	Returns true if a pose has at least one reference pose, false otherwise. More...

PDBInfoCOP	pdb_info () const
	Returns the pose PDBInfo (const) More...

PDBInfoOP	pdb_info ()
	Returns the pose PDBInfo. More...

PDBInfoOP	pdb_info (PDBInfoOP new_info)
	Sets pose PDBInfo to <new_info> More...

void	metric (std::string const &calculator_name, std::string const &key, basic::MetricValueBase &val) const

std::string	print_metric (std::string const &calculator_name, std::string const &key) const

void	append_residues (utility::vector1< conformation::ResidueOP > const &residues, utility::vector1< core::Size > const &jump_connection)
	Convenience function to add a bunch of residues at once to the end of the pose jump_connection lists the residue (in the new pose) to which to attach the residue by jump a value of 0 for jump_connection means that the residue will be attached polymerically to the previous residue. More...

void	append_residue_by_jump (conformation::Residue const &new_rsd, Size const jump_anchor_residue, std::string const &jump_anchor_atom="", std::string const &jump_root_atom="", bool const start_new_chain=false)
	Appends <new_rsd> (a residue) to pose by a new jump. More...

void	append_residue_by_bond (conformation::Residue const &new_rsd, bool const build_ideal_geometry=false, int const connection=0, Size const anchor_residue=0, int const anchor_connection=0, bool const start_new_chain=false, bool const lookup_bond_length=false)
	Appends <new_rsd> (a residue) to pose by a new bond. More...

void	append_residue_by_atoms (conformation::Residue const &new_rsd, bool const build_ideal_geometry, std::string const &connect_atom, Size const anchor_rsd_seqpos, std::string const &anchor_connect_atom, bool const start_new_chain=false, bool const lookup_bond_length=false)
	Appends <new_rsd> (a residue) to pose by a new bond to a given atom. More...

void	insert_residue_by_jump (Residue const &new_rsd_in, Size const seqpos, Size anchor_pos, std::string const &anchor_atomno="", std::string const &root_atomno="")
	Adds <new_rsd_in> to pose at <seqpos> More...

void	insert_residue_by_bond (Residue const &new_rsd_in, Size const seqpos, Size anchor_pos, bool const build_ideal_geometry=false, std::string const &anchor_atom="", std::string const &root_atom="", bool new_chain=false, bool const lookup_bond_length=false)
	Adds <new_rsd_in> to pose at <seqpos> More...

void	insert_residue_by_atoms (Residue const &new_rsd, Size const seqpos, bool const build_ideal_geometry, std::string const &connect_atom, Size const anchor_rsd_seqpos, std::string const &anchor_connect_atom="", bool const start_new_chain=false, bool const lookup_bond_length=false)

void	replace_residue (Size const seqpos, Residue const &new_rsd_in, bool const orient_backbone)
	Replaces the residue at <seqpos> with <new_rsd_in> More...

void	replace_residue (int const seqpos, Residue const &new_rsd_in, utility::vector1< std::pair< std::string, std::string > > const &atom_pairs)
	Replaces the residue at <seqpos> with <new_rsd> based on superposition on the specified input atom pairs NOTE: at the moment, only superposition on 3 atoms works This code sorely belongs in Pose.cc. More...

void	append_polymer_residue_after_seqpos (Residue const &new_rsd, Size const seqpos, bool const build_ideal_geometry)
	glues to seqpos and perhaps also seqpos+1 More...

void	prepend_polymer_residue_before_seqpos (Residue const &new_rsd, Size const seqpos, bool const build_ideal_geometry)
	glues to seqpos and perhaps also seqpos-1 More...

void	append_pose_by_jump (Pose const &src, Size const jump_anchor_residue, std::string const &jump_anchor_atom="", std::string const &jump_root_atom="")
	Appends source pose conformation to pose by a new jump. More...

void	delete_polymer_residue (Size const seqpos)
	Delete a residue in the pose. Update Observers. Update any Reference Poses. More...

void	delete_residue_slow (Size const seqpos)
	Slow method that relies on FoldTree::delete_seqpos, rebuilds atomtree, can handle jumps/root residue. Update Observers. Update any Reference Poses. More...

void	delete_residue_range_slow (Size const start, Size const end)
	Delete a range of residues in the pose. More...

void	copy_segment (Size const size, Pose const &src, Size const begin, Size const src_begin)
	Copy a stretch of coordinates/torsions from <src> to pose. More...

BasicDataCache const &	data () const
	BasicDataCache indexed by enum in core/pose/datacache/CacheableDataType.hh. More...

BasicDataCache &	data ()
	BasicDataCache indexed by enum in core/pose/datacache/CacheableDataType.hh. More...

template<class T >
void	set_const_data (std::string const &category, std::string const &name, T const &original)
	Controlled method for adding an object to the Pose's constant data cache; this function is the only way to add data to the Pose's data cache. An object, identified by two strings, is freshly constructed and inserted into the ConstDataCache. Objects inserted into the ConstDataCache must remain bitwise const for thread-safety reasons. The ConstDataCache has shallow-copy semantics, meaning that two poses would point to the same object if one were copied into the other. If these two Poses were then handed to separate threads, and the data they were both pointing at were to change, that would create race conditions. For this reason, the Pose attempts to prevent non-constant pointers to the data held in the ConstDataCache from existing. Objects placed in the ConstDataCache must have a copy constructor (either implicit or explicit). More...

basic::datacache::ConstDataMap const &	const_data_cache () const
	Read access to the const data cache. More...

ObserverCache const &	observer_cache () const
	ObserverCache indexed by enum in core/pose/datacache/CacheableObserverType.hh. More...

ObserverCache &	observer_cache ()
	ObserverCache indexed by enum in core/pose/datacache/CacheableObserverType.hh. More...

Size	total_residue () const
	Returns the number of residues in the pose conformation. More...

Size	size () const
	Returns the number of residues in the pose conformation. More...

Size	total_atoms () const
	Returns the total number of atoms in the pose conformation example: pose.total_atoms() More...

bool	empty () const
	Returns true if there are no residues in the conformation. More...

Size	num_jump () const
	Returns the number of jumps in the pose FoldTree. More...

chemical::AA	aa (Size const seqpos) const
	Returns the chemical::AA of the residue at <seqpos> More...

char	secstruct (Size const seqpos) const
	Returns the secondary structure of residue <seqpos> this usually comes from fragments. The conformation object will not invoke DSSP to determine the secondary structure if e.g. it has not been made from fragments. 'H' = helical 'E' = strand or sheet 'L' = loop. More...

std::string	secstruct () const
	Returns a string representing pose secondary structure. More...

void	set_secstruct (Size const seqpos, char const setting)
	Assign the secondary structure of residue <seqpos> to <setting> More...

std::string	sequence () const
	Returns a string representing the 1-letter-coded sequence of the pose conformation. More...

std::string	sequence (core::Size resnum_start, core::Size resnum_end) const
	Returns a string representing the 1-letter-coded sequence of the pose conformation. From start to end. More...

std::string	annotated_sequence (bool show_all_variants=false) const
	Returns the variant-tagged string representing the residue types that make up a conformation; e.g. M[MET:N-Terminus-Variant]CDH[HIS_D]LLR[ARG:C-Terminus-Variant]. More...

std::string	chain_sequence (core::Size const chain_in) const
	Returns the sequence for the chain number <chain_in> More...

std::string	glycan_tree_branch_sequence (core::uint const start_residue) const
	Return the IUPAC sequence of a single branch of a glycan tree, Beginning with residue number <start_residue>. More...

std::string	glycan_tree_sequence (core::uint const residue_in_tree) const
	Return the IUPAC sequence of the entire glycan tree encompassing residue number <residue_in_tree>. More...

Residue const &	residue (Size const seqpos) const
	Returns the Residue at position <seqpos> (read access) Note: this method will trigger a refold if either the torsions or the coordinates are out-of-date. More...

basic::datacache::BasicDataCache &	residue_data (Size const seqpos)
	Returns the DataCache held by Residue at position <seqpos> (read/write access) Note: this method will trigger a refold if either the torsions or the coordinates are out-of-date. More...

basic::datacache::BasicDataCache const &	residue_data (Size const seqpos) const
	Returns the DataCache held by Residue at position <seqpos> (read access) Note: this method will trigger a refold if either the torsions or the coordinates are out-of-date. More...

chemical::ResidueType const &	residue_type (Size const seqpos) const
	Returns the ResidueType at position <seqpos> (read access) Note: this method NOT will trigger a refold if either the torsions or the coordinates are out-of-date. More...

chemical::ResidueTypeCOP	residue_type_ptr (Size const seqpos) const
	Returns the ResidueTypeCOP for position <seqpos> (read access) Note: this method NOT will trigger a refold if either the torsions or the coordinates are out-of-date. More...

bool	is_fullatom () const
	Returns true if pose is ResidueType fullatom. More...

bool	is_centroid () const
	Returns true if pose is ResidueType centroid. More...

core::chemical::ResidueTypeSetCOP	residue_type_set_for_pose (core::chemical::TypeSetMode mode=core::chemical::INVALID_t) const
	Return the custom ResidueTypeSet for the Pose, if any. Otherwise will return the appropriate global ResidueTypeSet. More...

Real	phi (Size const seqpos) const
	Returns the phi torsion angle of residue <seqpos> in degrees. More...

void	set_phi (Size const seqpos, Real const setting)
	Sets the phi torsion angle of residue <seqpos> to <setting> More...

Real	psi (Size const seqpos) const
	Returns the psi torsion angle of residue <seqpos> in degrees Note: assumes the residue is an amino acid or monosaccharide. More...

void	set_psi (Size const seqpos, Real const setting)
	Sets the psi torsion angle of residue <seqpos> to <setting> More...

Real	omega (Size const seqpos) const
	Returns the omega torsion angle of residue <seqpos> in degrees. More...

void	set_omega (Size const seqpos, Real const setting)
	Sets the omega torsion angle of residue <seqpos> to <setting> More...

Real	theta (Size const seqpos) const
	Returns the theta torsion angle of beta-amino acid residue or oligourea residue <seqpos>. More...

void	set_theta (Size const seqpos, Real const setting)
	Sets the theta torsion angle of beta-amino acid residue or oligourea residue <seqpos> to <setting>. More...

Real	mu (Size const seqpos) const
	Returns the mu torsion angle of oligourea residue <seqpos>. More...

void	set_mu (Size const seqpos, Real const setting)
	Sets the mu torsion angle of oligourea residue <seqpos> to <setting>. More...

Real	alpha (Size const pos) const
	Returns the alpha torsion angle of residue <seqpos> More...

void	set_alpha (Size const seqpos, Real const setting)
	Sets the alpha torsion angle of residue <seqpos> to <setting> More...

Real	beta (Size const seqpos) const
	Returns the beta torsion angle of residue <seqpos> More...

void	set_beta (Size const seqpos, Real const setting)
	Sets the beta torsion angle of residue <seqpos> to <setting> More...

Real	gamma (Size const seqpos) const
	Returns the gamma torsion angle of residue <seqpos> More...

void	set_gamma (Size const seqpos, Real const setting)
	Sets the gamma torsion angle of residue <seqpos> to <setting> More...

Real	delta (Size const pos) const
	Returns the delta torsion angle of residue <seqpos> More...

void	set_delta (Size const seqpos, Real const setting)
	Sets the delta torsion angle of residue <seqpos> to <setting> More...

Real	epsilon (Size const seqpos) const
	Returns the epsilon torsion angle of residue <seqpos> More...

void	set_epsilon (Size const seqpos, Real const setting)
	Sets the epsilon torsion angle of residue <seqpos> to <setting> More...

Real	zeta (Size const seqpos) const
	Returns the zeta torsion angle of residue <seqpos> More...

void	set_zeta (Size const seqpos, Real const setting)
	Sets the zeta torsion angle of residue <seqpos> to <setting> More...

Real	chi (int const chino, Size const seqpos) const
	Returns the <chino> chi torsion angle of residue <seqpos> More...

void	set_chi (int const chino, Size const seqpos, Real const setting)
	Sets the <chino> chi torsion angle of residue <seqpos> to <setting> More...

Real	chi (Size const seqpos) const
	Returns the chi torsion angle of residue <seqpos> More...

void	set_chi (Size const seqpos, Real const setting)
	Sets the chi torsion angle of residue <seqpos> to <setting> More...

core::Size	num_chains () const
	Returns the total number of (chain ID) chains in the pose. More...

core::Size	chain (Size const seqpos) const
	Returns the chain number of residue <seqpos> More...

core::Size	chain_begin (Size const chain_num) const
	Returns the sequence position of the beginning of chain <chain_num>. More...

core::Size	chain_end (Size const chain_num) const
	Returns the sequence position of the end of chain <chain_num>. More...

utility::vector1< PoseOP >	split_by_chain () const
	Returns a vector of poses with one element per (chain number) chain of the original pose. More...

PoseOP	split_by_chain (Size chain_id) const
	Return a new pose with just the residues from the specified (chain number) chain. More...

void	update_pose_chains_from_pdb_chains ()
	Updates the pose chain IDs to match the pdb chain letters. More...

void	set_jump (int const jump_number, const kinematics::Jump &new_jump)
	Sets the pose FoldTree Jump <jump_number> to <new_jump> More...

kinematics::Jump const &	jump (int const jump_number) const
	Returns the pose FoldTree Jump <jump_number> More...

void	set_jump (AtomID const &id, const kinematics::Jump &new_jump)
	Sets the pose FoldTree Jump <id> to <new_jump> More...

kinematics::Jump const &	jump (AtomID const &id) const
	Returns the pose FoldTree Jump <id> More...

void	set_ring_conformation (uint const seqpos, uint const ring_num, core::chemical::rings::RingConformer const &conformer)
	Set the given residue and ring's ring conformation, if appropriate. More...

Real	torsion (TorsionID const &id) const
	Returns the Conformation torsion angle identified by <id> More...

void	set_torsion (TorsionID const &id, Real const setting)
	Sets the Conformation torsion angle identified by <id> to <setting> More...

Real	dof (DOF_ID const &id) const
	Returns the value of the AtomTree DOF <id> More...

void	set_dof (DOF_ID const &id, Real const setting)
	Sets the value of the AtomTree DOF <id> More...

bool	has_dof (DOF_ID const &id) const
	Returns true if pose has DOF <id> More...

PointPosition const &	xyz (AtomID const &id) const
	Returns the location (xyz) of pose AtomID <id> More...

PointPosition const &	xyz (NamedAtomID const &id) const
	Returns the location (xyz) of pose NamedAtomID <id> More...

void	set_xyz (AtomID const &id, PointPosition const &point)
	Sets the location (xyz) of pose AtomID <id> to the PointPosition <point> More...

void	set_xyz (NamedAtomID const &id, PointPosition const &point)
	Sets the location (xyz) of pose NamedAtomID <id> to the PointPosition <point> More...

void	batch_set_xyz (utility::vector1< AtomID > const &ids, utility::vector1< PointPosition > const &points)
	Sets the locations (xyz) of pose AtomIDs in <ids> to mathcing PointPositions in <points> More...

void	batch_get_xyz (utility::vector1< AtomID > const &ids, utility::vector1< PointPosition > &points) const
	Gets the locations (xyz) of pose AtomIDs in <ids> More...

kinematics::Stub	stub_from_id (id::NamedStubID const &id)

void	center ()
	Sets pose coordinates such that the pose center is at the Euclidean origin. More...

void	update_residue_neighbors ()
	Updates neighbor links in the pose Energies object. More...

void	scoring_begin (scoring::ScoreFunction const &info)
	Called by ScoreFunction at the beginning of scoring. More...

void	scoring_end (scoring::ScoreFunction const &scorefxn)
	Called by ScoreFunction at the end of scoring. More...

void	update_actcoords ()
	Called by PairEPotential to update the action coordinates for all residues. More...

void	update_actcoord (Size resid)
	Updates the action coordinates for pose residue <resid> More...

void	update_orbital_coords (Size resid)

void	apply_transform_Rx_plus_v (numeric::xyzMatrix< Real > const &R, Vector const &v)
	Apply a transform of the Rx + v form, where R is a rotation matrix and v is a translation vector. More...

void	real_to_virtual (core::Size seqpos)
	Switch residues to VIRTUAL. More...

void	virtual_to_real (core::Size seqpos)
	Switch residues from VIRTUAL to a REAL residue. More...

conformation::carbohydrates::GlycanTreeSetCOP	glycan_tree_set () const
	Get information on any glycan trees within this pose. If this is not setup, will return a nullptr due to the const nature of the function. More...

conformation::membrane::MembraneInfoOP	membrane_info () const
	Get information about the membrane orientaiton, geometry, and lipid composition within this pose. More...

conformation::membrane::MembraneInfoOP	membrane_info ()
	Get information about the membrane orientaiton, geometry, and lipid composition within this pose. More...

void	clear ()
	Empty the pose contents. More...

void	dump_file (std::string const &file_name) const
	Export pose data to a file, <file_name>, determining which type of file format to write based on the file extension. More...

void	dump_cif (std::string const &file_name) const
	Export pose data to the mmCIF file <file_name> More...

void	dump_mmtf (std::string const &file_name) const
	Export pose data to the mmtf file <file_name> More...

bool	dump_pdb (std::string const &file_name) const
	Export pose data to the PDB file <file_name> More...

void	dump_pdb (std::ostream &out) const

void	dump_pdb (std::ostream &out, utility::vector1< core::Size > const &residue_indices) const
	for writing a specified subset of residues in pdb format More...

void	dump_scored_pdb (std::string const &file_name, scoring::ScoreFunction const &scorefxn)
	Export pose data to the PDB file <file_name>, add some score output. More...

template<typename MemFn , typename Ptr >
utility::signals::Link	attach_destruction_obs (MemFn fn, Ptr ptr)
	attach DestructionEvent observer function More...

template<typename MemFn , typename Ptr >
bool	detach_destruction_obs (MemFn fn, Ptr ptr) const
	detach DestructionEvent observer function More...

template<typename MemFn , typename Ptr >
utility::signals::Link	attach_general_obs (MemFn fn, Ptr ptr)
	attach GeneralEvent observer function More...

template<typename MemFn , typename Ptr >
bool	detach_general_obs (MemFn fn, Ptr ptr) const
	detach GeneralEvent observer function More...

template<typename MemFn , typename Ptr >
utility::signals::Link	attach_energy_obs (MemFn fn, Ptr ptr)
	attach EnergyEvent observer function More...

template<typename MemFn , typename Ptr >
bool	detach_energy_obs (MemFn fn, Ptr ptr) const
	detach EnergyEvent observer function More...

template<typename MemFn , typename Ptr >
utility::signals::Link	attach_conformation_obs (MemFn fn, Ptr ptr)
	attach ConformationEvent observer function More...

template<typename MemFn , typename Ptr >
bool	detach_conformation_obs (MemFn fn, Ptr ptr) const
	detach ConformationEvent observer function More...

template<>
void	set_const_data (std::string const &category, std::string const &name, Pose const &original)

Private Member Functions
void	init (void)
	initialize internal for a freshly build pose object. Use this function when you need to create new constructor. More...

void	store_const_data (std::string const &category, std::string const &name, utility::VirtualBaseCOP)
	Internal method for storing a shared pointer to some constant object in the ConstantDataCache. More...

void	notify_destruction_obs (DestructionEvent const &e)
	notify DestructionEvent observers More...

void	notify_general_obs (GeneralEvent const &e)
	notify GeneralEvent observers More...

void	notify_energy_obs (EnergyEvent const &e, bool const fire_general=true)
	notify EnergyEvent observers More...

void	notify_conformation_obs (ConformationEvent const &e, bool const fire_general=true)
	notify ConformationEvent observers More...

void	buffer_observers () const
	Temporarily turn off observer notification Used for places where the Pose is in a temporarily inconsistent state. More...

void	unbuffer_observers () const
	Turn back on observer notification Used for places where the Pose is in a temporarily inconsistent state. More...

void	on_conf_xyz_change (core::conformation::signals::XYZEvent const &event)
	upon receiving a conformation::signals::XYZEvent More...

Private Attributes
ConformationOP	conformation_

scoring::EnergiesOP	energies_

metrics::PoseMetricContainerOP	metrics_

BasicDataCacheOP	data_cache_
	BasicDataCache indexed by enum in core/pose/datacache/CacheableDataType.hh. More...

ConstDataMapOP	constant_cache_
	The DataMap is a way to store arbitrarily complicated, constant data. The contents of the datamap are copied by value – the pointers are copied – meaning that two poses can point to the same data. For thread safety reasons, it is essential that the data inside this map is bitwise const (i.e. no mutable data is used or changes state). Poses may be placed inside the constant datamap, but it is important that ownership cycles are not created (e.g. A --> B; B-->C; C-->A) or memory will be leaked. Care must be taken that the this never happens. One way to avoid this possibility is to only cache freshly cloned Poses. The other way is to first call Pose::purge_cached_poses. More...

ObserverCacheOP	observer_cache_
	ObserverCache indexed by enum in core/pose/datacache/CacheableObserverType.hh. More...

PDBInfoOP	pdb_info_
	pdb info More...

ConstraintSetOP	constraint_set_

core::pose::reference_pose::ReferencePoseSetOP	reference_pose_set_
	The set of ReferencePose objects that this pose stores. More...

utility::signals::BufferedSignalHub< void, DestructionEvent >	destruction_obs_hub_
	DestructionEvent observers. More...

utility::signals::BufferedSignalHub< void, GeneralEvent >	general_obs_hub_
	GeneralEvent observers. More...

utility::signals::BufferedSignalHub< void, EnergyEvent >	energy_obs_hub_
	EnergyEvent observers. More...

utility::signals::BufferedSignalHub< void, ConformationEvent >	conformation_obs_hub_
	ConformationEvent observers. More...

Detailed Description

A molecular system including residues, kinematics, and energies.

The Pose class represents a molecular system (protein-dna-ligand...) as a container of Rosetta Residue objects together with a Conformation object that defines how internal coordinate changes propagate through the system and an Energies object that stores information from the last energy evaluation.

The main responsibilities of the pose are:

Kinematic: (a) to update the xyz coordinates in response to changes to internal degrees of freedom, and (b) to update internal coordinates when the user modifes the xyz (Cartesian) coords,

Scoring: (a) to keep track of what parts of the structure have changed since the last score evaluation, and (b) to cache residue and residue-pair energies for efficient re-use

As a container: The pose provides a single object for passing a molecular system and for copying of entire molecules or stretches of molecules from one Pose object into another.

Output Methods: Common Methods: Pose.assign Pose.atom_tree Pose.conformation Pose.dump_pdb Pose.dump_cif Pose.dump_mmtf Pose.dump_file Pose.energies Pose.fold_tree Pose.pdb_info Pose.residue Pose.sequence Pose.size

Member Typedef Documentation

◆ AtomID

typedef id::AtomID core::pose::Pose::AtomID

◆ BasicDataCache

typedef basic::datacache::BasicDataCache core::pose::Pose::BasicDataCache

◆ BasicDataCacheOP

typedef basic::datacache::BasicDataCacheOP core::pose::Pose::BasicDataCacheOP

◆ Conformation

typedef conformation::Conformation core::pose::Pose::Conformation

◆ ConformationCOP

typedef conformation::ConformationCOP core::pose::Pose::ConformationCOP

◆ ConformationEvent

typedef pose::signals::ConformationEvent core::pose::Pose::ConformationEvent

◆ ConformationOP

typedef conformation::ConformationOP core::pose::Pose::ConformationOP

◆ const_iterator

typedef boost::indirect_iterator< conformation::ResidueOPs::const_iterator, Residue const > core::pose::Pose::const_iterator

◆ ConstDataMap

typedef basic::datacache::ConstDataMap core::pose::Pose::ConstDataMap

◆ ConstDataMapOP

typedef basic::datacache::ConstDataMapOP core::pose::Pose::ConstDataMapOP

◆ ConstraintSetCOP

typedef scoring::constraints::ConstraintSetCOP core::pose::Pose::ConstraintSetCOP

◆ ConstraintSetOP

typedef scoring::constraints::ConstraintSetOP core::pose::Pose::ConstraintSetOP

◆ DestructionEvent

typedef pose::signals::DestructionEvent core::pose::Pose::DestructionEvent

◆ DOF_ID

typedef id::DOF_ID core::pose::Pose::DOF_ID

◆ EnergyEvent

typedef pose::signals::EnergyEvent core::pose::Pose::EnergyEvent

◆ GeneralEvent

typedef pose::signals::GeneralEvent core::pose::Pose::GeneralEvent

◆ iterator

typedef boost::indirect_iterator< conformation::ResidueOPs::iterator, Residue const > core::pose::Pose::iterator

◆ NamedAtomID

typedef id::NamedAtomID core::pose::Pose::NamedAtomID

◆ ObserverCache

typedef pose::datacache::ObserverCache core::pose::Pose::ObserverCache

◆ ObserverCacheOP

typedef pose::datacache::ObserverCacheOP core::pose::Pose::ObserverCacheOP

◆ Residue

typedef conformation::Residue core::pose::Pose::Residue

◆ TorsionID

typedef id::TorsionID core::pose::Pose::TorsionID

Constructor & Destructor Documentation

◆ Pose() [1/3]

core::pose::Pose::Pose ( )

default constructor, builds an empty pose

AtomTree default /bonding information Conformation default /change propagation Energies default /contains pose energy information FoldTree default /directs building of Pose Residue default /container of individual Residue objects

default constructor

References init().

◆ ~Pose()

core::pose::Pose::~Pose ( )

override

destructor – > kill data on the heap

References clear(), and notify_destruction_obs().

◆ Pose() [2/3]

core::pose::Pose::Pose ( Pose const & src )

copy constructor

◆ Pose() [3/3]

core::pose::Pose::Pose	(	Pose const &	src,
		Size	residue_begin,
		Size	residue_end
	)

partial copy constructor

References begin(), end(), init(), and core::io::pose_from_pose().

Member Function Documentation

◆ aa()

chemical::AA core::pose::Pose::aa ( Size const seqpos ) const

Returns the chemical::AA of the residue at <seqpos>

example(s): pose.aa(17) See also: Pose Pose.Residue Pose.sequence Residue

References conformation_, and size().

Referenced by protocols::splice::Splice::add_coordinate_constraints(), protocols::splice::SpliceManager::add_coordinate_constraints(), protocols::splice::Splice::add_dihedral_constraints(), protocols::splice::SpliceManager::add_dihedral_constraints(), protocols::loops::loop_mover::refine::LoopMover_Refine_KIC::apply(), protocols::flxbb::FilterStructs_TotalCharge::apply(), protocols::task_operations::JointSequenceOperation::apply(), protocols::generalized_kinematic_closure::perturber::GeneralizedKICperturber::apply_randomize_alpha_backbone_by_rama(), protocols::constel::PresenceCommon::are_aa_pres(), protocols::ligand_docking::ga_ligand_dock::GALigandDock::auto_determine_optH_mode(), protocols::analysis::simple_metrics::SequenceRecoveryMetric::calculate(), protocols::kinematic_closure::ClosureSolution::check_rama(), protocols::simple_filters::NetChargeFilter::compute(), protocols::matdes::ClashCheckFilter::compute(), protocols::fldsgn::filters::InterlockingAromaFilter::compute(), protocols::fldsgn::filters::CoreDunbrackFilter::compute(), protocols::fldsgn::filters::ParallelBetaPairingPreferenceFilter::compute(), core::select::util::SelectResiduesByLayer::compute(), protocols::loops::loop_closure::ccd::RamaCheck1B::compute_rama_score(), protocols::loops::loop_closure::ccd::RamaCheck2B::compute_rama_score(), protocols::ddG_main(), protocols::design_opt::GreedyOptMutationMover::dump_scoring_table(), protocols::matdes::MatDesGreedyOptMutationMover::dump_scoring_table(), protocols::motif_grafting::movers::MotifGraftMover::generate_match_pose(), protocols::motif_grafting::movers::MotifGraftMover::get_fragments_by_CA_distances_and_NCpoints_restrains(), core::scoring::rna::data::RNA_DMS_Potential::get_logL_values(), protocols::stepwise::modeler::protein::StepWiseProteinBackboneSampler::get_main_chain_torsion_set_list_coarse(), protocols::antibody::design::NativeAntibodySeq::get_native_sequence_matching_current_length(), protocols::loops::loop_closure::kinematic_closure::TabooSamplingKinematicPerturber::get_random_phi_psi_for_residue(), protocols::loops::loop_closure::kinematic_closure::NeighborDependentTabooSamplingKinematicPerturber::get_random_phi_psi_for_residue(), core::scoring::rna::get_rna_motifs(), protocols::constel::FilterBySASA::has_low_per_atom_sasa(), protocols::stepwise::modeler::StepWiseConnectionSampler::initialize_useful_info(), core::pose::MiniPose::MiniPose(), protocols::loops::loop_mover::perturb::LoopMover_Perturb_KIC::model_loop(), protocols::constel::pair_constel_set(), protocols::constel::pair_constel_set_idx2(), protocols::loops::loop_closure::kinematic_closure::TorsionSamplingKinematicPerturber::perturb_chain(), protocols::loops::loop_closure::kinematic_closure::NeighborDependentTorsionSamplingKinematicPerturber::perturb_chain(), protocols::loops::loop_closure::kinematic_closure::TorsionRestrictedKinematicPerturber::perturb_chain(), protocols::loops::loop_closure::kinematic_closure::BaseTabooPerturber::perturb_chain(), protocols::kinematic_closure::perturbers::OmegaPerturber::perturb_subset(), protocols::kinematic_closure::perturbers::Rama2bPerturber::perturb_subset(), protocols::kinematic_closure::perturbers::RamaPerturber::perturb_subset(), protocols::kinematic_closure::perturbers::RamaPerturber::perturb_subset_with_balance(), protocols::stepwise::modeler::protein::StepWiseProteinBackboneSampler::rama_energy(), protocols::fldsgn::potentials::AACompositionEnergy::residue_energy(), protocols::antibody::design::NativeAntibodySeq::set_from_cdr(), protocols::loops::set_secstruct_from_dssp(), protocols::antibody::design::NativeAntibodySeq::set_sequence(), protocols::constel::SingResCnlCrea::strip_atoms(), protocols::constel::target_constel(), protocols::constel::triple_constel_set_idx3(), and protocols::constel::SingResCnlCrea::zero_occ_for_deleted_atoms().

◆ add_constraint()

scoring::constraints::ConstraintCOP core::pose::Pose::add_constraint ( scoring::constraints::ConstraintCOP cst )

adding a constraint is done by cloning the input constraint. A const copy is then returned

References conformation_, constraint_set_, and energies_.

◆ add_constraints()

scoring::constraints::ConstraintCOPs core::pose::Pose::add_constraints ( scoring::constraints::ConstraintCOPs const & csts )

Add a list of constraints to a pose.

References conformation_, constraint_set_, and energies_.

◆ alpha()

Real core::pose::Pose::alpha ( Size const pos ) const

Returns the alpha torsion angle of residue <seqpos>

Note: assumes the residue is an nucleic acid

example(s): pose.alpha(1) See also: Pose Pose.residue Pose.set_alpha Residue

References core::id::BB, residue_type(), size(), and torsion().

◆ annotated_sequence()

std::string core::pose::Pose::annotated_sequence ( bool show_all_variants = false ) const

Returns the variant-tagged string representing the residue types that make up a conformation; e.g. M[MET:N-Terminus-Variant]CDH[HIS_D]LLR[ARG:C-Terminus-Variant].

example(s): pose.annotated_sequence() See also: Pose Pose.sequence Pose.size Residue

References conformation_.

◆ append_polymer_residue_after_seqpos()

void core::pose::Pose::append_polymer_residue_after_seqpos	(	Residue const &	new_rsd,
		Size const	seqpos,
		bool const	build_ideal_geometry
	)

glues to seqpos and perhaps also seqpos+1

References conformation_, energies_, increment_reference_pose_mapping_after_seqpos(), and size().

Referenced by protocols::pose_sewing::movers::AddFlankingVirtualResiduesMover::add_flanking_virtual_residues(), protocols::cryst::MakeLatticeMover::add_monomers_to_lattice(), protocols::cryst::MakeLayerMover::add_monomers_to_layer(), protocols::denovo_design::add_residues_to_pose(), protocols::denovo_design::components::add_to_pose(), core::import_pose::RNA_HelixAssembler::append_Aform_residue(), protocols::cyclic_peptide::PeptideStubMover::append_by_bond(), protocols::denovo_design::components::append_new_chain_from_template_segment(), protocols::denovo_design::components::append_new_residues(), protocols::stepwise::monte_carlo::mover::AddMover::append_residue(), protocols::denovo_design::components::append_residues_from_template_segment(), protocols::splice::SpliceOut::build_ideal_segment(), protocols::splice::SpliceIn::build_ideal_segment(), protocols::splice::SpliceInTail::build_ideal_segment(), protocols::splice::SpliceOutTail::build_ideal_segment(), protocols::cyclic_peptide::PeptideStubMover::handle_repeats_in_append_by_bond(), and core::scoring::motif::Xfrag::insert().

◆ append_pose_by_jump()

void core::pose::Pose::append_pose_by_jump	(	Pose const &	src,
		Size const	jump_anchor_residue,
		std::string const &	jump_anchor_atom = `""`,
		std::string const &	jump_root_atom = `""`
	)

Appends source pose conformation to pose by a new jump.

References conformation(), conformation_, energies_, glycan_tree_set(), core::conformation::Conformation::insert_conformation_by_jump(), num_jump(), pdb_info(), and size().

Referenced by protocols::helical_bundle::MakeBundle::apply(), protocols::helical_bundle::MakeBundleHelix::apply(), protocols::simple_moves::LoadPDBMover::apply(), protocols::simple_moves::DeleteChainMover::apply(), protocols::protein_interface_design::movers::TopologyBrokerMover::apply(), protocols::tcr::TCRmodel::build_graft_model(), and protocols::protein_interface_design::filters::ClashWithTargetFilter::compute().

◆ append_residue_by_atoms()

void core::pose::Pose::append_residue_by_atoms	(	conformation::Residue const &	new_rsd,
		bool const	build_ideal_geometry,
		std::string const &	connect_atom,
		Size const	anchor_rsd_seqpos,
		std::string const &	anchor_connect_atom,
		bool const	start_new_chain = `false`,
		bool const	lookup_bond_length = `false`
	)

Appends <new_rsd> (a residue) to pose by a new bond to a given atom.

This function effectively wraps append_residue_by_bond for an easier syntax. Instead of having to know what the connection, anchor residue, and anchor connection are, we give the atoms and query the ResidueType for the remaining information.

If build_ideal_bond is TRUE it will transform the coordinates of the new residue so that the bond geometry of the new bond is ideal according to the icoor_internal data in the residues.

Otherwise the incoming coordinates of new_rsd are preserved.

References core::conformation::Residue::atom_index(), conformation_, energies_, core::conformation::Residue::has(), core::conformation::Residue::n_possible_residue_connections(), residue(), and core::conformation::Residue::residue_connect_atom_index().

Referenced by core::pose::append_pose_with_glycan_residues(), protocols::farnesyl::InstallFarnesylMover::apply(), and core::pose::make_pose_from_sequence().

◆ append_residue_by_bond()

void core::pose::Pose::append_residue_by_bond	(	conformation::Residue const &	new_rsd,
		bool const	build_ideal_geometry = `false`,
		int const	connection = `0`,
		Size const	anchor_residue = `0`,
		int const	anchor_connection = `0`,
		bool const	start_new_chain = `false`,
		bool const	lookup_bond_length = `false`
	)

Appends <new_rsd> (a residue) to pose by a new bond.

The default behavior is to append by a polymeric connection to the preceding residue If we want to connect via a non-polymer connection, we give the connection number, anchor residue and the connection number for the anchor residue. These connection numbers are wrt the connections_ arrays in Residue and ResidueType

If build_ideal_bond is TRUE it will transform the coordinates of the new residue so that the bond geometry of the new bond is ideal according to the icoor_internal data in the residues.

Otherwise the incoming coordinates of new_rsd are preserved.

References conformation_, and energies_.

Referenced by protocols::cyclic_peptide::PeptideStubMover::add_residue_to_empty_pose(), protocols::generalized_kinematic_closure::GeneralizedKIC::addloopgeometry(), protocols::generalized_kinematic_closure::GeneralizedKIC::addtailgeometry(), protocols::generalized_kinematic_closure::GeneralizedKIC::addupperanchor(), protocols::cyclic_peptide::PeptideStubMover::append_by_bond(), protocols::cyclic_peptide::PeptideStubMover::append_by_jump(), core::pose::append_pose_with_glycan_residues(), core::pose::append_subpose_to_pose(), protocols::simple_moves::ReportEffectivePKA::apply(), protocols::ligand_docking::GrowLigand::apply(), protocols::ligand_docking::LigandDesign::apply(), protocols::rbsegment_relax::IdealizeHelicesMover::apply(), protocols::rna::movers::RNAIdealizeMover::apply(), protocols::hybridization::HybridizeProtocol::apply(), protocols::simple_moves::DeclareBond::apply(), protocols::forge::remodel::RemodelMover::apply(), protocols::hybridization::CartesianSampler::apply_frame(), protocols::pockets::PocketGrid::autoexpanding_pocket_eval(), protocols::metal_interface::MatchGrafter::build_combined_pose_with_zinc_overlay(), protocols::cryst::MakeLatticeMover::build_lattice_of_virtuals(), protocols::cryst::MakeLayerMover::build_layer_of_virtuals(), core::pack::rotamer_set::build_lib_dna_rotamers(), core::pack::rotamer_set::build_random_dna_rotamers(), core::energy_methods::DumpTrajectoryEnergy::calculate_energy(), protocols::hotspot_hashing::HotspotStubSet::create_hotspot_after_pose(), protocols::unfolded_state_energy_calculator::UnfoldedStateEnergyCalculatorMover::create_random_fragments(), protocols::rna::denovo::create_rna_vall_torsions(), protocols::unfolded_state_energy_calculator::UnfoldedStateEnergyCalculatorMover::create_sequence_match_fragments(), protocols::simple_moves::CutChainMover::create_subpose(), core::pose::create_subpose(), protocols::cyclic_peptide::SymmetricCycpepAlign::do_trim_to_single_repeat(), protocols::sic_dock::dump_loophash_linkers(), protocols::simple_moves::RepeatPropagationMover::duplicate_residues_by_type(), core::pose::symmetry::extract_asymmetric_unit(), core::pose::symmetry::get_asymmetric_pose_copy_from_symmetric_pose(), core::pose::symmetry::get_buildingblock_and_neighbor_subs(), core::pose::symmetry::get_subpose(), protocols::stepwise::legacy::modeler::protein::StepWiseProteinPoseSetup::get_working_pose(), protocols::forge::methods::grow_right_r(), protocols::cyclic_peptide::PeptideStubMover::handle_repeats_in_append_by_bond(), protocols::chemically_conjugated_docking::UBQ_GTPaseMover::initialize(), protocols::ncbb::SecStructFinder::initialize_pose(), core::energy_methods::IdealParametersDatabase::lookup_torsion_legacy(), protocols::sic_dock::make_Cx(), protocols::ncbb::ResidueReplacementRebuildMover::make_new_pose(), core::pose::make_pose_from_sequence(), core::fragment::make_pose_from_sequence_(), protocols::pose_creation::MergePDBatOverlapMover::merge_poses(), protocols::stepwise::modeler::merge_two_poses(), protocols::forge::build::ConnectRight::modify_impl(), core::pose::pdbslice(), protocols::make_rot_lib::MakeRotLibJobInputter::pose_from_job(), core::io::serialization::read_binary(), protocols::sic_dock::read_biounit(), protocols::stepwise::monte_carlo::mover::DeleteMover::remove_singletons_and_update_pose_focus(), protocols::rna::movers::RNA_LoopCloser::rna_ccd_close(), protocols::simple_moves::PeriodicBoxMover::setup_pose(), protocols::rbsegment_relax::setup_pose_from_rbsegs(), protocols::relax::RepeatProteinRelax::setup_repeat_pose(), protocols::stepwise::modeler::slice(), protocols::motif_grafting::movers::MotifGraftMover::stich_motif_in_scaffold_by_indexes_rotation_and_translation(), protocols::motif_grafting::movers::MotifGraftMover::test_epigraft_and_contextStructure_clashes(), and protocols::hybridization::MRMover::trim_target_pose().

◆ append_residue_by_jump()

void core::pose::Pose::append_residue_by_jump	(	conformation::Residue const &	new_rsd,
		Size const	jump_anchor_residue,
		std::string const &	jump_anchor_atom = `""`,
		std::string const &	jump_root_atom = `""`,
		bool const	start_new_chain = `false`
	)

Appends <new_rsd> (a residue) to pose by a new jump.

References conformation_, and energies_.

◆ append_residues()

void core::pose::Pose::append_residues	(	utility::vector1< conformation::ResidueOP > const &	residues,
		utility::vector1< core::Size > const &	jump_connection
	)

Convenience function to add a bunch of residues at once to the end of the pose jump_connection lists the residue (in the new pose) to which to attach the residue by jump a value of 0 for jump_connection means that the residue will be attached polymerically to the previous residue.

References conformation_, and energies_.

Referenced by core::io::pose_from_sfr::PoseFromSFRBuilder::build_initial_pose().

◆ apply_transform_Rx_plus_v()

void core::pose::Pose::apply_transform_Rx_plus_v	(	numeric::xyzMatrix< Real > const &	R,
		Vector const &	v
	)

Apply a transform of the Rx + v form, where R is a rotation matrix and v is a translation vector.

Applies a transform of the form Rx + v, where R is a rotation matrix, V is a vector, and x is the original position in xyz space.

References conformation_.

Referenced by protocols::pose_sewing::movers::SewAnythingAddMover::align(), protocols::cyclic_peptide::SymmetricCycpepAlign::align_to_origin(), protocols::cyclic_peptide::SymmetricCycpepAlign::align_to_zaxis(), protocols::cryst::UpdateCrystInfo::apply(), protocols::symmetry::DetectSymmetry::apply(), protocols::pockets::PlaidFingerprint::apply_rotation_offset_to_pose_(), protocols::pockets::PlaidFingerprint::dump_oriented_pose_and_fp_to_pdb(), protocols::electron_density::VoxelSpacingMultifunc::foldInChanges(), protocols::pockets::PlaidFingerprint::get_oriented_pose(), protocols::cryst::DockLatticeMover::initialize(), protocols::pockets::PocketGrid::move_pose_to_standard_orie(), core::energy_methods::parcs_ccs(), protocols::cryst::MakeLatticeMover::place_near_origin(), protocols::cryst::MakeLayerMover::place_near_origin(), protocols::pockets::PlaidFingerprint::PlaidFingerprint(), and protocols::simple_moves::PeriodicBoxMover::setup_pose().

◆ atom_tree()

kinematics::AtomTree const & core::pose::Pose::atom_tree ( ) const

Returns the pose AtomTree.

get the atom_tree

References conformation_.

Referenced by core::scoring::MultipoleElecPotential::align_residue_multipole_axes(), protocols::chemically_conjugated_docking::UBQ_GTPaseMover::analyze_and_filter(), protocols::simple_moves::TorsionDOFMover::apply(), core::optimization::atom_tree_dfunc(), core::optimization::symmetry::atom_tree_dfunc(), protocols::backrub::BackrubSegment::bond_angle_atoms(), protocols::stepwise::sampler::rigid_body::RigidBodyStepWiseSampler::calculate_jump(), core::import_pose::RNA_JumpMover::check_forward_backward(), protocols::simple_moves::ConstrainToIdealMover::check_if_really_connected(), protocols::toolbox::match_enzdes_util::constrain_pose_res_to_invrots(), protocols::loops::loop_closure::jacobi::JacobiLoopClosureMover::default_target_icoors(), protocols::ligand_docking::ga_ligand_dock::GriddedAtomTreeMultifunc::dfunc(), core::scoring::constraints::AtomPairConstraint::dist(), core::scoring::constraints::AtomToAxisConstraint::dist(), protocols::backrub::BackrubMover::dof_id_ranges(), core::import_pose::atom_tree_diffs::dump_atom_tree_diff(), protocols::viewer::dump_pose_kinemage(), protocols::backrub::BackrubSegment::end_atoms1(), protocols::stepwise::sampler::rna::RNA_KinematicCloser::figure_out_dof_ids_and_offsets(), protocols::rna::denovo::coarse::CoarseRNA_LoopCloser::figure_out_dof_ids_and_offsets(), protocols::stepwise::legacy::modeler::rna::RNA_AnalyticLoopCloser::figure_out_dof_ids_and_offsets(), core::pose::copydofs::CopyDofs::figure_out_dofs(), protocols::rna::denovo::coarse::CoarseRNA_LoopCloser::figure_out_forward_backward_res_by_backtracking(), core::pose::rna::fix_sugar_coords(), protocols::stepwise::modeler::align::StepWisePoseAligner::get_root_triad_atom_id_map(), core::pose::rna::initialize_atoms_for_which_we_need_new_dofs(), protocols::simple_moves::DOFHistogramRecorder::insert_dofs_by_residue(), protocols::branch_angle::BranchAngleOptimizer::optimize_angles(), protocols::branch_angle::BranchAngleOptimizer::overall_params(), protocols::rna::denovo::print_internal_coords(), protocols::backrub::BackrubMover::random_angle(), protocols::ligand_docking::LigandBaseProtocol::restrain_ligand_nbr_atom(), protocols::ligand_docking::restrain_ligand_nbr_atom(), protocols::ligand_docking::LigandBaseProtocol::restrain_protein_Calphas(), protocols::ligand_docking::MinimizeBackbone::restrain_protein_Calphas(), core::import_pose::atom_tree_diffs::rms_error_with_noise(), protocols::rna::movers::RNA_LoopCloser::rna_ccd_close(), protocols::backrub::BackrubMover::rotate_segment(), protocols::loops::loop_closure::kinematic_closure::TorsionSamplingKinematicPerturber::set_pose_after_closure(), protocols::loops::loop_closure::kinematic_closure::VicinitySamplingKinematicPerturber::set_pose_after_closure(), protocols::loops::loop_closure::kinematic_closure::NeighborDependentTorsionSamplingKinematicPerturber::set_pose_after_closure(), protocols::loops::loop_closure::kinematic_closure::TorsionRestrictedKinematicPerturber::set_pose_after_closure(), protocols::loops::loop_closure::kinematic_closure::BaseTabooPerturber::set_pose_after_closure(), core::optimization::CartesianMinimizerMap::setup(), core::optimization::MinimizerMap::setup(), protocols::backrub::BackrubSegment::start_atoms1(), protocols::backrub::BackrubSegment::start_atoms2(), protocols::loops::loop_closure::jacobi::JacobiLoopClosureMover::store_target(), core::optimization::symmetry::SymMinimizerMap::SymMinimizerMap(), protocols::loops::loop_closure::jacobi::JacobiLoopClosureMover::update_current(), protocols::rna::movers::ErraserMinimizerMover::vary_bond_geometry(), and protocols::simple_moves::ConstrainToIdealMover::vary_bond_geometry().

◆ attach_conformation_obs()

template<typename MemFn , typename Ptr >

utility::signals::Link core::pose::Pose::attach_conformation_obs	(	MemFn	fn,
		Ptr	ptr
	)

inline

attach ConformationEvent observer function

Parameters

fn	pointer to observer's unary member function with signature void( ConformationEvent const & )
ptr	RAW pointer to observer object

Returns: Link that can be used to manage the connection.

References conformation_obs_hub_.

Referenced by protocols::moves::PyMOLObserver::attach_impl(), protocols::network::UIObserver::attach_impl(), and core::pose::metrics::PoseMetricContainer::attach_to().

◆ attach_destruction_obs()

template<typename MemFn , typename Ptr >

utility::signals::Link core::pose::Pose::attach_destruction_obs	(	MemFn	fn,
		Ptr	ptr
	)

inline

attach DestructionEvent observer function

Parameters

fn	pointer to observer's unary member function with signature void( DestructionEvent const & )
ptr	RAW pointer to observer object

Returns: Link that can be used to manage the connection.

Remarks: DestructionEvent observers will only be notified upon destruction of the Pose

References destruction_obs_hub_.

Referenced by core::pose::metrics::PoseMetricContainer::attach_to().

◆ attach_energy_obs()

template<typename MemFn , typename Ptr >

utility::signals::Link core::pose::Pose::attach_energy_obs	(	MemFn	fn,
		Ptr	ptr
	)

inline

attach EnergyEvent observer function

Parameters

fn	pointer to observer's unary member function with signature void( EnergyEvent const & )
ptr	RAW pointer to observer object

Returns: Link that can be used to manage the connection.

References energy_obs_hub_.

Referenced by protocols::moves::PyMOLObserver::attach_impl(), protocols::network::UIObserver::attach_impl(), core::pose::metrics::PoseMetricContainer::attach_to(), and protocols::viewer::SilentObserver::attach_to().

◆ attach_general_obs()

template<typename MemFn , typename Ptr >

utility::signals::Link core::pose::Pose::attach_general_obs	(	MemFn	fn,
		Ptr	ptr
	)

inline

attach GeneralEvent observer function

Parameters

fn	pointer to observer's unary member function with signature void( GeneralEvent const & )
ptr	RAW pointer to observer object

Returns: Link that can be used to manage the connection.

Remarks: GeneralEvent observers will be notified whenever any signal derived from GeneralEvent occurs.

References general_obs_hub_.

Referenced by protocols::moves::PyMOLObserver::attach_impl(), and protocols::network::UIObserver::attach_impl().

◆ batch_get_xyz()

void core::pose::Pose::batch_get_xyz	(	utility::vector1< AtomID > const &	ids,
		utility::vector1< PointPosition > &	points
	)		const

Gets the locations (xyz) of pose AtomIDs in <ids>

get the locations of a vector of atoms

References conformation_.

Referenced by protocols::cyclic_peptide::CycpepRigidBodyPermutationMover::copy_cycpep_pose_coordinates_to_original_pose(), core::optimization::CartesianMinimizerMap::copy_dofs_from_pose(), protocols::cyclic_peptide::CycpepRigidBodyPermutationMover::perturb_cycpep_pose_orientation(), and protocols::cyclic_peptide::CycpepRigidBodyPermutationMover::perturb_cycpep_pose_position().

◆ batch_set_xyz()

void core::pose::Pose::batch_set_xyz	(	utility::vector1< AtomID > const &	ids,
		utility::vector1< PointPosition > const &	points
	)

Sets the locations (xyz) of pose AtomIDs in <ids> to mathcing PointPositions in <points>

set the locations of a vector of atoms

References conformation_.

Referenced by protocols::loop_grower::LoopGrower::addnativesolution(), protocols::loop_grower::SheetSampler::alignPerfectCA(), protocols::loop_grower::SheetSampler::alignStrand(), protocols::loophash::LoopHashMoverWrapper::apply(), protocols::simple_moves::Tumble::apply(), protocols::rbsegment_relax::SequenceShiftMover::apply(), protocols::comparative_modeling::PartialThreadingMover::apply(), protocols::hybridization::CartesianHybridize::apply_frag(), protocols::hybridization::CartesianHybridize::apply_frame(), protocols::electron_density::apply_transform(), protocols::forge::methods::apply_transformation(), protocols::simple_filters::RepeatParameterFilter::apply_transformation(), protocols::hybridization::apply_transformation(), protocols::rbsegment_relax::RBSegmentMover::applyTransformation(), protocols::rbsegment_relax::RBSegmentMover::applyTranslation(), protocols::hybridization::InsertChunkMover::check_overlap(), protocols::cyclic_peptide::CycpepRigidBodyPermutationMover::copy_cycpep_pose_coordinates_to_original_pose(), core::optimization::CartesianMinimizerMap::copy_dofs_to_pose(), core::io::silent::BinarySilentStruct::fill_pose(), protocols::cyclic_peptide::CycpepRigidBodyPermutationMover::perturb_cycpep_pose_orientation(), protocols::cyclic_peptide::CycpepRigidBodyPermutationMover::perturb_cycpep_pose_position(), protocols::hybridization::InsertChunkMover::set_bb_xyz_aligned(), protocols::loop_grower::LoopPartialSolution::set_coordinates(), protocols::features::ProteinResidueConformationFeatures::set_coords_for_residues(), and protocols::hybridization::FoldTreeHybridize::translate_virt_to_CoM().

◆ begin() [1/2]

const_iterator core::pose::Pose::begin ( ) const

noexcept

◆ begin() [2/2]

iterator core::pose::Pose::begin ( )

noexcept

Referenced by core::pose::canonical_atom_count(), core::pose::canonical_residue_count(), chain_sequence(), copy_segment(), protocols::tcr::graft_framework(), protocols::forge::methods::grow_left_rtype(), protocols::forge::methods::grow_right_rtype(), protocols::forge::build::SegmentInsert::modify_impl(), core::pose::noncanonical_atom_count(), core::pose::noncanonical_chi_count(), core::pose::noncanonical_residue_count(), core::pose::nres_protein(), and Pose().

◆ beta()

Real core::pose::Pose::beta ( Size const seqpos ) const

Returns the beta torsion angle of residue <seqpos>

Note: assumes the residue is an nucleic acid

example(s): pose.beta(2) See also: Pose Pose.residue Pose.set_beta Residue

References core::id::BB, residue_type(), size(), and torsion().

◆ buffer_observers()

void core::pose::Pose::buffer_observers ( ) const

private

Temporarily turn off observer notification Used for places where the Pose is in a temporarily inconsistent state.

References conformation_obs_hub_, destruction_obs_hub_, energy_obs_hub_, and general_obs_hub_.

Referenced by operator=().

◆ center()

void core::pose::Pose::center ( )

Sets pose coordinates such that the pose center is at the Euclidean origin.

References core::conformation::Residue::natoms(), residue(), set_xyz(), size(), and xyz().

Referenced by protocols::relax::loop::LoopRelaxMover::apply(), protocols::simple_moves::AlignChainMover::apply(), and protocols::features::strand_assembly::SandwichFeatures::report_features().

◆ chain()

core::Size core::pose::Pose::chain ( Size const seqpos ) const

Returns the chain number of residue <seqpos>

See the documentation of Pose::num_chains() for details about chain numbers, chain letters and jumps.

example(s): pose.chain(3) see also: pose pose.num_chains pose.annotated_sequence pose.chain_sequence pose.fold_tree pose.sequence foldtree

References core::conformation::Residue::chain(), residue(), and size().

◆ chain_begin()

core::Size core::pose::Pose::chain_begin ( Size const chain_num ) const

Returns the sequence position of the beginning of chain <chain_num>.

See the documentation of Pose::num_chains() for details about chain numbers, chain letters and jumps. This is a pass-through function which returns conformation_->chain_begin( chain_num )

example(s): pose.chain_begin(1) see also: pose pose.num_chains pose.annotated_sequence pose.chain_sequence pose.fold_tree pose.sequence foldtree

References conformation_, and num_chains().

Referenced by protocols::pose_sewing::movers::AddFlankingVirtualResiduesMover::add_flanking_virtual_residues(), protocols::stepwise::monte_carlo::mover::ensure_appropriate_foldtree_for_move(), protocols::constel::get_chain_terms(), and split_by_chain().

◆ chain_end()

core::Size core::pose::Pose::chain_end ( Size const chain_num ) const

Returns the sequence position of the end of chain <chain_num>.

See the documentation of Pose::num_chains() for details about chain numbers, chain letters and jumps. This is a pass-through function which returns conformation_->chain_end( chain_num )

example(s): pose.chain_end(1) see also: pose pose.num_chains pose.annotated_sequence pose.chain_sequence pose.fold_tree pose.sequence foldtree

References conformation_, and num_chains().

Referenced by protocols::pose_sewing::movers::AddFlankingVirtualResiduesMover::add_flanking_virtual_residues(), protocols::constel::get_chain_terms(), and split_by_chain().

◆ chain_sequence()

std::string core::pose::Pose::chain_sequence ( core::Size const chain_in ) const

Returns the sequence for the chain number <chain_in>

See the documentation of Pose::num_chains() for details about chain numbers, chain letters and jumps.

Example(s): pose.chain_sequence(1) See also: Pose Pose.chain Pose.residue Pose.sequence

References begin(), core::chemical::ResidueType::carbohydrate_info(), conformation_, end(), core::chemical::ResidueTypeBase::name1(), num_chains(), core::conformation::membrane::out, and residue_type().

Referenced by protocols::symmetry::DetectSymmetry::apply(), protocols::monte_carlo::GenericMonteCarloMover::boltzmann(), protocols::evolution::EvolutionaryDynamicsMover::boltzmann(), protocols::evolution::AASynthesisFitnessCost::compute(), protocols::frag_picker::FragmentScoreFilter::compute(), core::pose::compute_unique_chains(), protocols::energy_based_clustering::EnergyBasedClusteringProtocol::do_initial_import_and_scoring(), protocols::simple_filters::SecretionPredictionFilter::find_tm_regions(), protocols::pdbinfo_manipulations::get_pose_sequences(), core::scoring::methods::NMerSVMEnergy::get_residue_energy_by_svm(), core::scoring::methods::NMerRefEnergy::get_residue_energy_by_table(), core::pose::make_pose_from_saccharide_sequence(), core::io::external::PsiPredInterface::run_psipred(), and core::io::external::PsiPredInterface::run_psipred_prob().

◆ chi() [1/2]

Real core::pose::Pose::chi	(	int const	chino,
		Size const	seqpos
	)		const

Returns the <chino> chi torsion angle of residue <seqpos>

Note: assumes the residue is an amino acid or monosaccharide

example(s): pose.chi(1,7) See also: Pose Pose.set_chi Pose.residue Residue

References core::conformation::Residue::chi(), residue(), residue_type(), and size().

Referenced by protocols::simple_moves::RepeatPropagationMover::add_cap_seq(), protocols::splice::Splice::add_coordinate_constraints(), protocols::splice::SpliceManager::add_coordinate_constraints(), protocols::backrub::BackrubSidechainMover::apply(), protocols::pose_sewing::movers::SewAnythingAddMover::apply(), protocols::simple_moves::CopyRotamerMover::apply(), protocols::comparative_modeling::Align_RotamerEvaluator::apply(), protocols::simple_moves::CombinePoseMover::apply(), protocols::simple_moves::CopyRotamerMover::apply_from_template_pose(), protocols::comparative_modeling::chis_from_pose(), protocols::pose_metric_calculators::RotamerRecovery::chis_from_pose(), protocols::simple_moves::RepeatPropagationMover::copy_phi_psi_omega(), protocols::stepwise::legacy::modeler::protein::StepWiseProteinPoseSetup::copy_rna_chi(), core::scoring::rna::data::RNA_DMS_LowResolutionPotential::evaluate(), core::scoring::rna::data::RNA_DMS_Potential::get_features(), protocols::simple_moves::sidechain_moves::SidechainMover::idealize_sidechains(), protocols::simple_moves::sidechain_moves::SidechainMoverBase::idealize_sidechains(), protocols::make_rot_lib::MakeRotLibMover::minimize_rotamer(), core::pose::rna::mutate_position(), protocols::ligand_docking::ga_ligand_dock::EntropyEstimator::perturb(), protocols::cryst::DockLatticeMover::perturb_chis(), protocols::ligand_docking::ga_ligand_dock::LigandAligner::perturb_lig(), protocols::ligand_docking::ga_ligand_dock::perturb_ligand_torsions(), protocols::simple_moves::PeriodicBoxMover::perturb_molecule_move(), protocols::loop_grower::ResTorsions::ResTorsions(), protocols::environment::ClientMover::sandboxed_copy(), protocols::rotamer_recovery::PerNativeRRReporterHuman::set_native(), and protocols::ligand_docking::ga_ligand_dock::EntropyEstimator::update_chis().

◆ chi() [2/2]

Real core::pose::Pose::chi ( Size const seqpos ) const

Returns the chi torsion angle of residue <seqpos>

Note: assumes the residue is an nucleic acid

example(s): pose.chi(7) See also: Pose Pose.residue Pose.set_chi Residue

References core::id::CHI, residue_type(), size(), and torsion().

◆ clear()

void core::pose::Pose::clear ( )

Empty the pose contents.

example(s): pose.clear() See also: Pose Pose.assign Pose.empty

References conformation_, constraint_set_, data_cache_, energies_, metrics_, observer_cache_, and pdb_info().

Referenced by protocols::generalized_kinematic_closure::GeneralizedKIC::addloweranchor(), protocols::topology_broker::TopologyBroker::apply(), protocols::helical_bundle::MakeBundle::apply(), protocols::helical_bundle::MakeBundleHelix::apply(), protocols::pose_creation::ExtendedPoseMover::apply(), protocols::pose_creation::PoseFromSequenceMover::apply(), protocols::simple_moves::SwitchChainOrderMover::apply(), protocols::cyclic_peptide::PeptideStubMover::apply(), protocols::simple_moves::DeclareBond::apply(), protocols::cryst::MakeLatticeMover::build_lattice_of_virtuals(), protocols::cryst::MakeLayerMover::build_layer_of_virtuals(), core::io::pose_from_sfr::PoseFromSFRBuilder::build_pose(), protocols::LoopRebuild::build_random_loops(), protocols::forge::remodel::RemodelAccumulator::clear(), protocols::design_opt::GreedyOptMutationMover::clear_cached_data(), protocols::matdes::MatDesGreedyOptMutationMover::clear_cached_data(), protocols::loop_modeling::LoopProtocol::clear_movers(), protocols::simple_filters::NetChargeFilter::compute(), protocols::simple_moves::CutChainMover::create_subpose(), core::pose::create_subpose(), protocols::pockets::GenPharmacophore::extract_rna_rings_from_protein_rna_complex(), core::scoring::motif::ResPairMotif::fill_pose_with_motif(), protocols::protein_interface_design::movers::PlaceSimultaneouslyMover::final_cleanup(), core::fragment::Frame::fragment_as_pose(), core::pack::interaction_graph::generate_pose_from_packer_description(), protocols::topology_broker::FragmentJumpClaimer::init_jumps(), core::fragment::make_pose_from_frags(), core::pose::make_pose_from_saccharide_sequence(), core::pose::make_pose_from_sequence(), core::fragment::make_pose_from_sequence_(), protocols::forge::build::SegmentRebuild::modify_impl(), protocols::topology_broker::FragmentJumpClaimer::new_decoy(), protocols::protein_interface_design::movers::PlaceSimultaneouslyMover::pair_sets_with_positions(), core::pose::pdbslice(), protocols::cyclic_peptide::crosslinker::TMA_Helper::place_tma_asymmetric(), protocols::cyclic_peptide::crosslinker::TMA_Helper::place_tma_symmetric(), core::import_pose::atom_tree_diffs::pose_from_atom_tree_diff(), protocols::checkpoint::pose_from_binary_silent_file(), protocols::jd2::AtomTreeDiffJobInputter::pose_from_job(), protocols::jd2::LazySilentFileJobInputter::pose_from_job(), protocols::jd2::PoseInputStreamJobInputter::pose_from_job(), protocols::jd2::SilentFileJobInputter::pose_from_job(), protocols::features::DatabaseJobInputter::pose_from_job(), protocols::jd2::EmptyPoseJobInputter::pose_from_job(), protocols::denovo_design::components::prune_unpaired_residues(), core::io::serialization::read_binary(), protocols::stepwise::monte_carlo::mover::DeleteMover::remove_singletons_and_update_pose_focus(), protocols::tcr::TCRmodel::set_default(), protocols::rbsegment_relax::setup_pose_from_rbsegs(), protocols::fold_from_loops::movers::SplitAndMixPoseMover::transfer_conformation(), protocols::fold_from_loops::utils::Nub::transfer_unfolded_conformation(), and ~Pose().

◆ clear_sequence_constraints()

void core::pose::Pose::clear_sequence_constraints ( )

Remove all sequence constraints from this pose.

References constraint_set_.

Referenced by protocols::aa_composition::ClearCompositionConstraintsMover::apply().

◆ clone()

PoseOP core::pose::Pose::clone ( ) const

clone the conformation

clone the pose

◆ conformation() [1/2]

Conformation& core::pose::Pose::conformation ( )

inline

Returns the pose Conformation (non-const access)

References conformation_.

◆ conformation() [2/2]

Conformation const& core::pose::Pose::conformation ( ) const

inline

Returns the pose Conformation (const-access)

example(s): pose.Conformation() See also: Pose Conformation

References conformation_.

◆ conformation_ptr() [1/2]

ConformationOP & core::pose::Pose::conformation_ptr ( )

Returns the pose Conformation pointer (nonconst access)

WHOA: This is not cool. The Pose cannot hand out access to the OP directly. Do not use.

References conformation_.

◆ conformation_ptr() [2/2]

ConformationCOP core::pose::Pose::conformation_ptr ( ) const

Returns the pose Conformation pointer (const access)

References conformation_.

◆ const_data_cache()

basic::datacache::ConstDataMap const & core::pose::Pose::const_data_cache ( ) const

Read access to the const data cache.

References constant_cache_.

Referenced by core::pack::guidance_scoreterms::approximate_buried_unsat_penalty::ApproximateBuriedUnsatPenalty::get_energies_cache().

◆ constraint_set() [1/2]

Pose::ConstraintSetCOP core::pose::Pose::constraint_set ( ) const

References constraint_set_.

◆ constraint_set() [2/2]

void core::pose::Pose::constraint_set ( ConstraintSetOP constraint_set )

FIX ME! This function should clone all of the constraints held in the input constraint set instead of allowing the input constraint set to perform a shallow copy of its constraints. Someone may be nefariously holding onto non-const pointers to the constraints in the input constraint set.

References conformation_, constraint_set(), constraint_set_, and energies_.

◆ copy_segment()

void core::pose::Pose::copy_segment	(	Size const	size,
		Pose const &	src,
		Size const	begin,
		Size const	src_begin
	)

Copy a stretch of coordinates/torsions from <src> to pose.

References begin(), conformation(), conformation_, and size().

Referenced by protocols::hybridization::DomainAssembly::apply(), protocols::protein_interface_design::Revert::apply(), protocols::loops::loop_closure::ccd::ShortLoopClosure::apply(), protocols::simple_moves::AddCavitiesMover::clear_suckers(), protocols::splice::Splice::copy_stretch(), core::fragment::fill_template_frames_from_pdb(), protocols::ub_e2c::ubi_e2c_modeler::init_d77_perturbation(), protocols::ub_e2c::ubi_e2c_modeler::init_k48r_perturbation(), protocols::surface_docking::SurfaceDockingProtocol::merge_protein_surface_poses(), protocols::ub_e2c::ubi_e2c_modeler::restore_cter(), protocols::rbsegment_relax::restore_pose_from_rbsegs(), and protocols::docking::ConformerSwitchMover::switch_conformer().

◆ corresponding_residue_in_current()

core::Size core::pose::Pose::corresponding_residue_in_current	(	core::Size const	ref_residue_index,
		std::string const &	ref_pose_name
	)		const

Returns the index of a residue in this pose corresponding to a residue in a reference pose.

Throws an error if the reference pose with the given name doesn't exist, or the residue number doesn't exist in that reference pose. Returns zero if no corresponding residue exists in this pose (e.g. if the residue in question has been deleted.

References reference_pose_set_cop().

Referenced by protocols::pose_sewing::movers::AddFlankingVirtualResiduesMover::add_flanking_virtual_residues(), protocols::carbohydrates::SimpleGlycosylateMover::apply(), core::select::residue_selector::GlycanResidueSelector::apply(), core::pose::carbohydrates::delete_carbohydrate_branch(), core::pose::carbohydrates::delete_leaf(), core::pose::get_resnumber_from_reference_pose(), and core::simple_metrics::SimpleMetricData::get_value().

◆ data() [1/2]

BasicDataCache& core::pose::Pose::data ( )

inline

BasicDataCache indexed by enum in core/pose/datacache/CacheableDataType.hh.

References data_cache_.

◆ data() [2/2]

BasicDataCache const& core::pose::Pose::data ( ) const

inline

BasicDataCache indexed by enum in core/pose/datacache/CacheableDataType.hh.

References data_cache_.

◆ decrement_reference_pose_mapping_after_seqpos()

void core::pose::Pose::decrement_reference_pose_mapping_after_seqpos ( core::Size const seqpos )

Find all mappings in the new pose after seqpos in all ReferencePose objects, and decrement them by 1.

If there is no ReferencePose object, do nothing.

References reference_pose_set_.

Referenced by delete_polymer_residue(), delete_residue_range_slow(), and delete_residue_slow().

◆ delete_polymer_residue()

void core::pose::Pose::delete_polymer_residue ( Size const seqpos )

Delete a residue in the pose. Update Observers. Update any Reference Poses.

delete a polymer residues Fires a LengthEvent::RESIDUE_DELETE signal.

References conformation_, decrement_reference_pose_mapping_after_seqpos(), energies_, size(), and zero_reference_pose_mapping_at_seqpos().

Referenced by protocols::protein_interface_design::movers::LoopLengthChange::apply(), core::import_pose::RNA_HelixAssembler::get_rid_of_capping_base_pairs(), core::scoring::motif::Xfrag::insert(), protocols::protein_interface_design::movers::PlaceOnLoop::loop_length(), core::pose::rna::position_cutpoint_phosphate_torsions(), protocols::stepwise::modeler::rna::phosphate::position_five_prime_phosphate_SLOW(), protocols::splice::Splice::remove_hairpin(), protocols::splice::SpliceOut::remove_hairpin(), and protocols::ub_e2c::ubi_e2c_modeler::trim_cter().

◆ delete_residue_range_slow()

void core::pose::Pose::delete_residue_range_slow	(	Size const	start,
		Size const	end
	)

Delete a range of residues in the pose.

Calls confromation::delete_residue_range_slow(). Update Observers. Update any Reference Poses

Calls confromation::delete_residue_range_slow(). Also, updates reference poses, if present.

References conformation_, decrement_reference_pose_mapping_after_seqpos(), end(), energies_, size(), and protocols::loops::start.

Referenced by protocols::loop_grower::LoopComparator::apply(), protocols::forge::remodel::RemodelMover::apply(), protocols::splice::SpliceOut::build_ideal_segment(), protocols::splice::SpliceIn::build_ideal_segment(), protocols::splice::SpliceInTail::build_ideal_segment(), protocols::splice::SpliceOutTail::build_ideal_segment(), protocols::ligand_docking::ga_ligand_dock::GALigandDock::calculate_free_receptor_score(), protocols::rna::denovo::delete_non_protein_from_pose(), protocols::grafting::delete_region(), and protocols::ligand_docking::ga_ligand_dock::GALigandDock::replace_ligand().

◆ delete_residue_slow()

void core::pose::Pose::delete_residue_slow ( Size const seqpos )

Slow method that relies on FoldTree::delete_seqpos, rebuilds atomtree, can handle jumps/root residue. Update Observers. Update any Reference Poses.

Delete a residue from the Conformation the slow way – triggers a rebuild of the atomtree Fires a LengthEvent::RESIDUE_DELETE signal.

Note: Could be upstream and/or downstream of a jump or chemical edge, or the root of the tree; Not well-tested. Expect funny behavior in new or different situations (email pbrad.nosp@m.ley@.nosp@m.fhcrc.nosp@m..org)

LOGIC: uses fold_tree.delete_seqpos to handle shifting the topology around if necessary, then calls setup_atom_tree

References conformation_, decrement_reference_pose_mapping_after_seqpos(), energies_, size(), and zero_reference_pose_mapping_at_seqpos().

Referenced by protocols::antibody::snugdock::SnugDockProtocol::apply(), protocols::protein_interface_design::movers::LoopLengthChange::apply(), protocols::docking::DockingEnsemble::calculate_highres_ref_energy(), core::pose::carbohydrates::delete_leaf(), protocols::ligand_docking::ga_ligand_dock::GALigandDock::final_exact_cartmin(), protocols::ligand_docking::ga_ligand_dock::EntropyEstimator::MCEntropy(), protocols::cyclic_peptide::PeptideStubMover::preserve_old_mainchain_torsions(), and protocols::rna::movers::RNAThreadAndMinimizeMover::process_deletions().

◆ delta()

Real core::pose::Pose::delta ( Size const pos ) const

Returns the delta torsion angle of residue <seqpos>

Note: assumes the residue is an nucleic acid

example(s): pose.delta(4) See also: Pose Pose.residue Pose.set_delta Residue

References core::id::BB, residue_type(), size(), and torsion().

Referenced by protocols::stepwise::monte_carlo::rna::RNA_TorsionMover::apply_random_suite_torsion(), and protocols::stepwise::modeler::rna::phosphate::PhosphateMover::screen_three_prime_phosphate().

◆ detach_conformation_obs()

template<typename MemFn , typename Ptr >

bool core::pose::Pose::detach_conformation_obs	(	MemFn	fn,
		Ptr	ptr
	)		const

inline

detach ConformationEvent observer function

Parameters

fn	pointer to observer's unary member function with signature void( ConformationEvent const & )
ptr	RAW pointer to observer object

Returns: true if disconnect successful, false if connection does not exist

References conformation_obs_hub_.

Referenced by core::pose::metrics::PoseMetricContainer::detach_from().

◆ detach_destruction_obs()

template<typename MemFn , typename Ptr >

bool core::pose::Pose::detach_destruction_obs	(	MemFn	fn,
		Ptr	ptr
	)		const

inline

detach DestructionEvent observer function

Parameters

fn	pointer to observer's unary member function with signature void( DestructionEvent const & )
ptr	RAW pointer to observer object

Returns: true if disconnect successful, false if connection does not exist

Remarks: DestructionEvent observers will only be notified upon destruction of the Pose

References destruction_obs_hub_.

Referenced by core::pose::metrics::PoseMetricContainer::detach_from().

◆ detach_energy_obs()

template<typename MemFn , typename Ptr >

bool core::pose::Pose::detach_energy_obs	(	MemFn	fn,
		Ptr	ptr
	)		const

inline

detach EnergyEvent observer function

Parameters

fn	pointer to observer's unary member function with signature void( EnergyEvent const & )
ptr	RAW pointer to observer object

Returns: true if disconnect successful, false if connection does not exist

References energy_obs_hub_.

Referenced by core::pose::metrics::PoseMetricContainer::detach_from().

◆ detach_general_obs()

template<typename MemFn , typename Ptr >

bool core::pose::Pose::detach_general_obs	(	MemFn	fn,
		Ptr	ptr
	)		const

inline

detach GeneralEvent observer function

Parameters

fn	pointer to observer's unary member function with signature void( GeneralEvent const & )
ptr	RAW pointer to observer object

Returns: true if disconnect successful, false if connection does not exist

Remarks: GeneralEvent observers will be notified whenever any signal derived from GeneralEvent occurs.

References general_obs_hub_.

◆ detached_copy()

void core::pose::Pose::detached_copy ( Pose const & src )

Performs a deep copy of the src Pose into this Pose in a way that guarantees that no non-bitwise-constant data is shared between them (such as the AtomTree's observer system) – this Pose will be effectively detached from any data that lives in other objects.

This is basically a stub for an actual implementation of detached_copy which would not contain the "receive_observers_from" call that the operator = assignment does.

References conformation_, constraint_set_, and on_conf_xyz_change().

Referenced by protocols::fold_from_loops::utils::Nub::add_binders(), protocols::fold_from_loops::movers::AlignByResidueSelectorMover::apply(), protocols::fold_from_loops::utils::Nub::apply(), protocols::fold_from_loops::filters::RmsdFromResidueSelectorFilter::compute(), protocols::fold_from_loops::filters::ScorePoseSegmentFromResidueSelectorFilter::compute(), protocols::fold_from_loops::NubInitioMover::refold_pose(), and protocols::fold_from_loops::NubInitioMover::sanity_check().

◆ dof()

Real core::pose::Pose::dof ( DOF_ID const & id ) const

Returns the value of the AtomTree DOF <id>

get the value of the atomtree degree of freedom (DOF)

◆ dump_cif()

void core::pose::Pose::dump_cif ( std::string const & file_name ) const

Export pose data to the mmCIF file <file_name>

example(s): pose.dump_cif('new_01.cif') See also: Pose pose_from_cif dump_file

References core::io::mmcif::dump_cif().

◆ dump_file()

void core::pose::Pose::dump_file ( std::string const & file_name ) const

Export pose data to a file, <file_name>, determining which type of file format to write based on the file extension.

example(s): pose.dump_file('new_01.pdb') pose.dump_file('new_01.cif') See also: Pose dump_cif dump_mmtf dump_file

Dumps an mmcif formatted file if the extension on the input file_name_string is .cif

References core::io::mmcif::dump_cif(), core::io::mmtf::dump_mmtf(), and core::io::pdb::dump_pdb().

◆ dump_mmtf()

void core::pose::Pose::dump_mmtf ( std::string const & file_name ) const

Export pose data to the mmtf file <file_name>

example(s): pose.dump_mmtf('new_01.mmtf') See also: Pose pose_from_mmtf dump_file

References core::io::mmtf::dump_mmtf().

◆ dump_pdb() [1/3]

void core::pose::Pose::dump_pdb ( std::ostream & out ) const

References core::io::pdb::dump_pdb(), and core::conformation::membrane::out.

◆ dump_pdb() [2/3]

void core::pose::Pose::dump_pdb	(	std::ostream &	out,
		utility::vector1< core::Size > const &	residue_indices
	)		const

for writing a specified subset of residues in pdb format

References core::io::pdb::dump_pdb(), and core::conformation::membrane::out.

◆ dump_pdb() [3/3]

bool core::pose::Pose::dump_pdb ( std::string const & file_name ) const

Export pose data to the PDB file <file_name>

example(s): pose.dump_pdb('new_01.pdb') See also: Pose pose_from_pdb dump_cif dump_file

save pose data to file with supplied file_name

References core::io::pdb::dump_pdb().

◆ dump_scored_pdb()

void core::pose::Pose::dump_scored_pdb	(	std::string const &	file_name,
		scoring::ScoreFunction const &	scorefxn
	)

Export pose data to the PDB file <file_name>, add some score output.

Dump a pdbfile with some score info at the end.

References conformation_, core::io::pdb::dump_pdb(), energies(), core::conformation::membrane::out, core::scoring::Energies::residue_total_energies(), secstruct(), core::scoring::ScoreFunction::show(), core::scoring::EMapVector::show_nonzero(), size(), core::scoring::Energies::total_energies(), core::scoring::total_score, core::scoring::EMapVector::weighted_string_of(), and core::scoring::ScoreFunction::weights().

Referenced by protocols::docking::membrane::MPFindInterfaceMover::apply(), protocols::helical_bundle::BundleGridSampler::apply(), protocols::ncbb::SecStructFinder::apply(), protocols::membrane::MPMutateRelaxMover::apply(), protocols::simple_moves::DumpPdb::apply(), protocols::protein_interface_design::filters::FilterScanFilter::apply(), protocols::enzdes::EnzdesBaseProtocol::cst_minimize(), protocols::design_opt::Supercharge::design_supercharge(), protocols::design_opt::Supercharge::design_supercharge_AvNAPSA(), protocols::residue_optimization::MetapatchEnumeration::generate_derived_types(), protocols::pmut_scan::PointMutScanDriver::make_specific_mutant(), protocols::optimize_weights::IterativeOptEDriver::measure_sequence_recovery(), protocols::protein_interface_design::movers::ProteinInterfaceMultiStateDesignMover::output_alternative_states(), and protocols::motifs::IRCollection::try_for_more().

◆ empty()

bool core::pose::Pose::empty ( ) const

Returns true if there are no residues in the conformation.

example(s): pose.empty() See also: Pose Pose.clear Pose.sequence Pose.size

References conformation_.

Referenced by protocols::denovo_design::add_residues_to_pose(), protocols::denovo_design::components::SheetDB::add_sheets_from_pose(), protocols::fold_from_loops::utils::append_pose_to_pose_keep_fold_tree(), core::pose::append_pose_with_glycan_residues(), protocols::topology_broker::TopologyBroker::apply(), protocols::helical_bundle::MakeBundle::apply(), protocols::simple_moves::DumpSingleResidueRotamers::apply(), protocols::struct_fragment::StructFragmentMover::apply(), protocols::fold_from_loops::utils::Nub::apply(), protocols::design_opt::GreedyOptMutationMover::apply(), protocols::matdes::MatDesGreedyOptMutationMover::apply(), protocols::energy_based_clustering::EnergyBasedClusteringProtocol::do_ABOXYZ_bin_analysis(), protocols::cyclic_peptide::CycpepRigidBodyPermutationMover::generate_cycpep_pose_copy(), and protocols::energy_based_clustering::EnergyBasedClusteringProtocol::is_all_alpha_aa_or_peptoid().

◆ end() [1/2]

const_iterator core::pose::Pose::end ( ) const

noexcept

◆ end() [2/2]

iterator core::pose::Pose::end ( )

noexcept

Referenced by protocols::enzdes::EnzdesFlexibleRegion::assemble_enzdes_fragdata(), core::pose::canonical_atom_count(), core::pose::canonical_residue_count(), chain_sequence(), protocols::denovo_design::components::StructureData::check_chains(), delete_residue_range_slow(), core::pose::noncanonical_atom_count(), core::pose::noncanonical_chi_count(), core::pose::noncanonical_residue_count(), core::pose::nres_protein(), and Pose().

◆ energies() [1/2]

scoring::Energies& core::pose::Pose::energies ( )

inline

Returns the pose Energies (non-const access)

References energies_.

◆ energies() [2/2]

scoring::Energies const& core::pose::Pose::energies ( ) const

inline

Returns the pose Energies (const-access)

APL Removing illegal non-const accessors to residues which otherwise violate the data-integrity guarantees provided by class Conformation. accessors for iteration over residues THIS MUST BE REMOVED ASAP!

example(s): pose.energies() See also: Pose Energies PDBInfo ScoreFunction create_score_function

References energies_.

◆ epsilon()

Real core::pose::Pose::epsilon ( Size const seqpos ) const

Returns the epsilon torsion angle of residue <seqpos>

Note: assumes the residue is an nucleic acid

example(s): pose.epsilon(5) See also: Pose Pose.residue Pose.set_epsilon Residue

References core::id::BB, residue_type(), size(), and torsion().

◆ fold_tree() [1/2]

kinematics::FoldTree const & core::pose::Pose::fold_tree ( ) const

Returns the pose FoldTree.

example(s): pose.fold_tree() See also: Pose FoldTree

References conformation_.

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ AtomID

◆ BasicDataCache

◆ BasicDataCacheOP

◆ Conformation

◆ ConformationCOP

◆ ConformationEvent

◆ ConformationOP

◆ const_iterator

◆ ConstDataMap

◆ ConstDataMapOP

◆ ConstraintSetCOP

◆ ConstraintSetOP

◆ DestructionEvent

◆ DOF_ID

◆ EnergyEvent

◆ GeneralEvent

◆ iterator

◆ NamedAtomID

◆ ObserverCache

◆ ObserverCacheOP

◆ Residue

◆ TorsionID

Constructor & Destructor Documentation

◆ Pose() [1/3]

◆ ~Pose()

◆ Pose() [2/3]

◆ Pose() [3/3]

Member Function Documentation

◆ aa()

◆ add_constraint()

◆ add_constraints()

◆ alpha()

◆ annotated_sequence()

◆ append_polymer_residue_after_seqpos()

◆ append_pose_by_jump()

◆ append_residue_by_atoms()

◆ append_residue_by_bond()

◆ append_residue_by_jump()

◆ append_residues()

◆ apply_transform_Rx_plus_v()

◆ atom_tree()

◆ attach_conformation_obs()

◆ attach_destruction_obs()

◆ attach_energy_obs()

◆ attach_general_obs()

◆ batch_get_xyz()

◆ batch_set_xyz()

◆ begin() [1/2]

◆ begin() [2/2]

◆ beta()

◆ buffer_observers()

◆ center()

◆ chain()

◆ chain_begin()

◆ chain_end()

◆ chain_sequence()

◆ chi() [1/2]

◆ chi() [2/2]

◆ clear()

◆ clear_sequence_constraints()

◆ clone()

◆ conformation() [1/2]

◆ conformation() [2/2]

◆ conformation_ptr() [1/2]

◆ conformation_ptr() [2/2]

◆ const_data_cache()

◆ constraint_set() [1/2]

◆ constraint_set() [2/2]

◆ copy_segment()

◆ corresponding_residue_in_current()

◆ data() [1/2]

◆ data() [2/2]

◆ decrement_reference_pose_mapping_after_seqpos()

◆ delete_polymer_residue()