IMP::rmf Namespace Reference

See IMP.rmf Overview for more information.

Classes
class	LoadLink
class	SaveLink
class	SaveOptimizerState

Typedefs
typedef base::Object *	AssociationType
typedef base::Pointer< LoadLink >	LoadLinkAssociationType
typedef IMP::base::Vector < IMP::base::Pointer< LoadLink > >	LoadLinks
typedef base::Pointer< SaveLink >	SaveLinkAssociationType
typedef IMP::base::Vector < IMP::base::Pointer< SaveLink > >	SaveLinks

Functions
template<class T >
T *	get_association (RMF::NodeConstHandle nh)
std::string	get_data_path (std::string file_name)
	Return the full path to installed data. More...
std::string	get_example_path (std::string file_name)
	Return the path to installed example data for this module. More...
bool	get_has_linker (RMF::FileConstHandle nh, unsigned int id)
LoadLinkAssociationType	get_load_linker (RMF::FileConstHandle nh, unsigned int id)
SaveLinkAssociationType	get_save_linker (RMF::FileConstHandle nh, unsigned int id)
void	load_frame (RMF::FileConstHandle file, int frame)
void	save_frame (RMF::FileHandle file, int frame, std::string name="frame")
void	set_association (RMF::NodeConstHandle nh, base::Object *o, bool overwrite=false)
void	set_linker (RMF::FileConstHandle nh, unsigned int id, SaveLinkAssociationType l)
void	set_linker (RMF::FileConstHandle nh, unsigned int id, LoadLinkAssociationType l)

Associations
RMF supports tracking associations between an RMF file an native objects. In the IMP case these are IMP::base::Object and we provide some special methods aid in this process.
RMF::NodeConstHandle	get_node_from_association (RMF::FileConstHandle nh, base::Object *oi)
RMF::NodeHandle	get_node_from_association (RMF::FileHandle nh, base::Object *oi)
bool	get_has_associated_node (RMF::FileConstHandle nh, base::Object *oi)

Hierarchy I/O
Hierarchy I/O writes IMP::atom::Hierarchy information along with the information contained in the following decorators IMP::atom::Atom IMP::atom::Residue IMP::core::XYZR IMP::atom::Mass IMP::atom::Diffusion IMP::core::Typed IMP::display::Colored IMP::atom::Domain IMP::atom::Molecule IMP::atom::Copy IMP::core::RigidMember (rigid body information will be written and rigid bodies created even when the IMP::core::RigidBody is not itself written to the file) IMP::core::RigidBody Note IMP::core::XYZ and IMP::core::RigidBody data are stored at each frame. Data for all the other decorators are assumed to be static attributes, and are stored once for the entire RMF file. There is currently no way to customize this. Complain to the IMP team if this is problematic. Note To avoid unexpected behavior, be aware that when linking atom::Hierarchies against an RMF file, the linked hierarchies are assumed to be identical in all of their static attributes to the hierarchies in the RMF file (within RMF::REPRESENTATION nodes). In particular, these hierachies must have the same tree topology (number of children for each node).
void	add_hierarchies (RMF::FileHandle fh, const atom::Hierarchies &hs)
void	add_hierarchies (RMF::NodeHandle fh, const atom::Hierarchies &hs)
void	add_hierarchy (RMF::FileHandle fh, atom::Hierarchy hs)
atom::Hierarchies	create_hierarchies (RMF::FileConstHandle fh, Model *m)
void	link_hierarchies (RMF::FileConstHandle fh, const atom::Hierarchies &hs)
void	set_save_forces (RMF::FileHandle fh, bool tf)

Geometry I/O
The geometry I/O support currently handles geometry composed of IMP::display::SegmentGeometry IMP::display::CylinderGeometry IMP::display::SphereGeometry Other types can be supported when requested. Be aware, many more complex geometry types are automatically decomposed into the above types and so, more or less, supported.
void	add_geometries (RMF::FileHandle file, const display::GeometriesTemp &r)
void	add_geometries (RMF::NodeHandle parent, const display::GeometriesTemp &r)
void	add_static_geometries (RMF::FileHandle parent, const display::GeometriesTemp &r)
display::Geometries	create_geometries (RMF::FileConstHandle parent)
void	link_geometries (RMF::FileConstHandle parent, const display::GeometriesTemp &r)

Particle I/O
Arbitrary (non IMP::atom::Hierarchy) particles can be written to the file and read back from them. All non-IMP::Object attributes are supported. Note that currently particles must be added so that any particles that are stored in a given particles attributes are added to the file first. The data is stored in a category named IMP.
void	add_particles (RMF::FileHandle fh, const ParticlesTemp &hs)
void	add_particles (RMF::NodeHandle fh, const ParticlesTemp &hs)
void	add_particle (RMF::FileHandle fh, Particle *hs)
ParticlesTemp	create_particles (RMF::FileConstHandle fh, Model *m)
void	link_particles (RMF::FileConstHandle fh, const ParticlesTemp &hs)

Restraint I/O
Restraints are written as am RMF::FEATURE node with subnodes for the decomposed restraints (Restraint::create_current_decompositon()). The Restraints::get_last_score() value is what is saved to the file, so make sure that the restraints have been evaluated before saving a frame. Any particles returnd by Restraint::get_input_particles() that are also linked in the RMF file will be included in the RMF file as inputs for the Restraint. This allows external software like e.g., Chimera to associate these restrains with a certain set of particles.
void	add_restraints (RMF::FileHandle fh, const RestraintsTemp &hs)
void	add_restraints (RMF::NodeHandle fh, const RestraintsTemp &hs)
void	add_restraint (RMF::FileHandle fh, Restraint *hs)
Restraints	create_restraints (RMF::FileConstHandle fh, Model *m)
void	link_restraints (RMF::FileConstHandle fh, const Restraints &hs)
void	set_maximum_number_of_terms (RMF::FileHandle fh, unsigned int num)

Standard module methods
All IMP modules have a set of standard methods to help get information about the module and about files associated with the module.
std::string	get_module_version ()
std::string	get_module_name ()

Typedef Documentation

typedef IMP::base::Vector<IMP::base::Pointer< LoadLink > > IMP::rmf::LoadLinks

Store a set of objects.

Definition at line 32 of file links.h.

typedef IMP::base::Vector<IMP::base::Pointer< SaveLink > > IMP::rmf::SaveLinks

Store a set of objects.

Definition at line 31 of file links.h.

Function Documentation

void IMP::rmf::add_geometries	(	RMF::FileHandle	file,
		const display::GeometriesTemp &	r
	)

Add the geometry to the file

void IMP::rmf::add_geometries	(	RMF::NodeHandle	parent,
		const display::GeometriesTemp &	r
	)

Add them to a given parent node.

void IMP::rmf::add_hierarchies	(	RMF::FileHandle	fh,
		const atom::Hierarchies &	hs
	)

Add objects to the file.

Note

This does not save a configuration, make sure you use save_frame() to do that.

void IMP::rmf::add_hierarchies	(	RMF::NodeHandle	fh,
		const atom::Hierarchies &	hs
	)

Add objects to the file under the specified node.

Note

This does not save a configuration, make sure you use save_frame() to do that.

void IMP::rmf::add_hierarchy	(	RMF::FileHandle	fh,
		atom::Hierarchy	hs
	)

Add a single Hierarchy object to the RMF file.

Note

This does not save a configuration, make sure you use save_frame() to do that.

void IMP::rmf::add_particle	(	RMF::FileHandle	fh,
		Particle *	hs
	)

Add a single Particle object to the RMF file.

Note

This does not save a configuration, make sure you use save_frame() to do that.

void IMP::rmf::add_particles	(	RMF::FileHandle	fh,
		const ParticlesTemp &	hs
	)

Add objects to the file.

Note

This does not save a configuration, make sure you use save_frame() to do that.

void IMP::rmf::add_particles	(	RMF::NodeHandle	fh,
		const ParticlesTemp &	hs
	)

Add objects to the file under the specified node.

Note

This does not save a configuration, make sure you use save_frame() to do that.

void IMP::rmf::add_restraint	(	RMF::FileHandle	fh,
		Restraint *	hs
	)

Add a single Restraint object to the RMF file.

Note

This does not save a configuration, make sure you use save_frame() to do that.

void IMP::rmf::add_restraints	(	RMF::FileHandle	fh,
		const RestraintsTemp &	hs
	)

Add objects to the file.

Note

This does not save a configuration, make sure you use save_frame() to do that.

void IMP::rmf::add_restraints	(	RMF::NodeHandle	fh,
		const RestraintsTemp &	hs
	)

Add objects to the file under the specified node.

Note

This does not save a configuration, make sure you use save_frame() to do that.

void IMP::rmf::add_static_geometries	(	RMF::FileHandle	parent,
		const display::GeometriesTemp &	r
	)

Add the following geometry, assuming they do not move between frames. This can be space saving compared to resaving the constant position each frame.

display::Geometries IMP::rmf::create_geometries

(

RMF::FileConstHandle

parent

)

Create geometry objects for the geometry nodes found in the file.

atom::Hierarchies IMP::rmf::create_hierarchies	(	RMF::FileConstHandle	fh,
		Model *	m
	)

Create Hierarchy objects from the RMF file.

Note

This does not load a frame. Make sure you call IMP::rmf::load_frame() before using.

ParticlesTemp IMP::rmf::create_particles	(	RMF::FileConstHandle	fh,
		Model *	m
	)

Create Particle objects from the RMF file.

Note

This does not load a frame. Make sure you call IMP::rmf::load_frame() before using.

Restraints IMP::rmf::create_restraints	(	RMF::FileConstHandle	fh,
		Model *	m
	)

Create Restraint objects from the RMF file.

Note

This does not load a frame. Make sure you call IMP::rmf::load_frame() before using.

std::string IMP::rmf::get_data_path

(

std::string

file_name

)

Each module has its own data directory, so be sure to use the version of this function in the correct module. To read the data file "data_library" that was placed in the data directory of module "mymodule", do something like

std::ifstream in(IMP::mymodule::get_data_path("data_library"));

This will ensure that the code works when IMP is installed or used via the tools/imppy.sh script.

std::string IMP::rmf::get_example_path

(

std::string

file_name

)

Each module has its own example directory, so be sure to use the version of this function in the correct module. For example to read the file example_protein.pdb located in the examples directory of the IMP::atom module, do

IMP::atom::read_pdb(IMP::atom::get_example_path("example_protein.pdb", model));

This will ensure that the code works when IMP is installed or used via the tools/imppy.sh script.

void IMP::rmf::link_geometries	(	RMF::FileConstHandle	parent,
		const display::GeometriesTemp &	r
	)

Link the passed geometry objects to corresponding ones in the file. They must be in the same order, we don't search around for matches.

void IMP::rmf::link_hierarchies	(	RMF::FileConstHandle	fh,
		const atom::Hierarchies &	hs
	)

Link Hierarchy objects with the RMF file, possibly overwriting an existing link for loading from the file. This does not alter the object, but will affect the behaviour of functions like load_frame() and save_frame(). See Linking hierarchies for more information and intricacies

void IMP::rmf::link_particles	(	RMF::FileConstHandle	fh,
		const ParticlesTemp &	hs
	)

Link Particle objects with the RMF file, possibly overwriting an existing link for loading from the file. This does not alter the object, but will affect the behaviour of functions like load_frame() and save_frame().

void IMP::rmf::link_restraints	(	RMF::FileConstHandle	fh,
		const Restraints &	hs
	)

Link Restraint objects with the RMF file, possibly overwriting an existing link for loading from the file. This does not alter the object, but will affect the behaviour of functions like load_frame() and save_frame().

void IMP::rmf::load_frame	(	RMF::FileConstHandle	file,
		int	frame
	)

Load the specified frame into the state of the associated IMP::base::Objects with the RMF file.

The current frame is left as the passed frame number.

void IMP::rmf::save_frame	(	RMF::FileHandle	file,
		int	frame,
		std::string	name = "frame"
	)

Save the current state of the objects linked to the RMF file as the frameth frame.

The current frame is left as the passed frame number.

void IMP::rmf::set_maximum_number_of_terms	(	RMF::FileHandle	fh,
		unsigned int	num
	)

Certain restraint are made from a really large number of terms (eg IMP::core::DopePairScore based ones). Tracking and displaying all those terms can be very time consuming. If the number of terms is larger than the maximum, the terms are not displayed. By default this is

void IMP::rmf::set_save_forces	(	RMF::FileHandle	fh,
		bool	tf
	)

Set whether the forces (and torques) are saved to the file.