relax SVN archive

Fix for the bmrb.read user function for the recent molecule, residue and spin metadata improvements.

The generic_fns.bmrb.generate_sequence() function now calls generic_fns.mol_res_spin.metadata_clean()
to be sure that the metadata is correct. The problem is the structure of the BMRB file with no spin
information in the entity record, hence the residues are created first and the spins much later in
generate_sequence().

Large cleanup and bugfixes for the molecule, residue, and spin data structure metadata maintenance.

The bugs fixed are important for non-protein molecules. For example is the spin name is not unique
per residue, or per molecule if no residues are defined, many parts of relax would fail.

All of the metadata_*() and spin_id_variants*() functions have been redesigned. It was also
identified that metadata_prune() was being used by different parts of relax for two different
purposes - the removal or pruning of metadata prior to the deletion of a data structure and the
clean up of no longer valid metadata. These two goals conflicted resulting in unpredictable
behaviour. Therefore the new metadata_cleanup() and spin_id_variants_cleanup() functions have been
created and the two behaviours separated.

The spin_id argument to the residue.delete user function is no longer read-only.

This allows spin ranges or other complicated IDs to be specified. This is needed for the Bmrb GUI
tests to pass.

Added the profile flag keyword argument to the relax startup script for Unix-like systems.

This is to simplify the switching on of profiling.

Large speed ups of the Bmrb system tests by the deletion of most of the residues.

On one system, this cuts the time for all 3 Bmrb tests from 70 to ~12 seconds.

The pcs.read user function backend now uses generic_fns.mol_res_spin.generate_spin_id_unique().

This allows the matching spin container to always be returned for storing the data.

Improved the generic_fns.mol_res_spin.generate_spin_id_unique() function.

This can now work with molecule, residue, and spin names and numbers alternatively to the containers
supplied as arguments. For this to work, the return_molecule_by_name() function has been improved
and the functions return_residue_by_info() and return_spin_by_info() have been added.

Fix for the rdc.read user function for the recent spin ID metadata changes.

Fix for the new generate_spin_id_unique() function.

The precedence is now residue number then name, and spin name then number.

The spin_loop() function now uses generate_spin_id_unique() when the return_id flag is set.

This ensures that the caller received a unique spin ID which can be used to retrieve the
corresponding spin container.