Difference between revisions of "Relax 2.2.5"

From relax wiki
Jump to navigation Jump to search
m (→‎Links: Fix the broken Gna! forum link by switching to {{gna link}}.)
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{lowercase title}}
 
{{lowercase title}}
  
= Description =
+
{{infobox relax release
 +
| version  = 2.2.5
 +
| prev    = 2.2.4
 +
| next    = 3.0.0
 +
| keywords = Model-free analysis, structure
 +
| type    = Minor feature
 +
| date    = 24 March 2013
 +
| manual  = yes
 +
}}
  
<onlyinclude>
+
== Description ==
This is a minor feature release.  Improvements include the creation of ''R<sub>ex</sub>'' value files scaled to all spectrometer frequencies for the model-free auto-analysis [d'Auvergne and Gooley, 2007][d'Auvergne and Gooley, 2008] and some new capabilities in the structural API.  Feel free to upgrade if you wish to use these new features.
 
</onlyinclude>
 
  
= Download =
+
<section begin=description/>
 +
This is a minor feature release.  Improvements include the creation of R<sub>ex</sub> value files scaled to all spectrometer frequencies for the model-free auto-analysis [d'Auvergne and Gooley, 2007][d'Auvergne and Gooley, 2008b] and some new capabilities in the structural API.  Feel free to upgrade if you wish to use these new features.
 +
<section end=description/>
  
 +
== Download ==
 +
 +
<section begin=download/>
 
The new relax versions can be downloaded from http://www.nmr-relax.com/download.html. If binary distributions are not yet available for your platform and you manage to compile the binary modules, please consider contributing these to the relax project (described in section 3.6 of the relax manual, http://www.nmr-relax.com/manual/relax_distribution_archives.html).  
 
The new relax versions can be downloaded from http://www.nmr-relax.com/download.html. If binary distributions are not yet available for your platform and you manage to compile the binary modules, please consider contributing these to the relax project (described in section 3.6 of the relax manual, http://www.nmr-relax.com/manual/relax_distribution_archives.html).  
 +
<section end=download/>
  
 +
== CHANGES file ==
  
= CHANGES file =
+
<section begin=metadata/>
 
+
Version 2.2.5 <br/>
Version 2.2.5
+
(24 March 2013, from /trunk) <br/>
(24 March 2013, from /trunk)
 
 
http://svn.gna.org/svn/relax/tags/2.2.5
 
http://svn.gna.org/svn/relax/tags/2.2.5
 +
<section end=metadata/>
  
== Features ==
+
=== Features ===
  
 +
<section begin=features/>
 
*  The files created by the [http://www.nmr-relax.com/manual/value_write.html value.write user function] now include a header describing the parameter.
 
*  The files created by the [http://www.nmr-relax.com/manual/value_write.html value.write user function] now include a header describing the parameter.
 
*  The relax internal structural object now supports the merger of molecules.  This can be useful if different domains of one system are in two PDB files or are split in the one file.
 
*  The relax internal structural object now supports the merger of molecules.  This can be useful if different domains of one system are in two PDB files or are split in the one file.
Line 25: Line 39:
 
*  Helix and sheet information from PDB files are now stored in the internal structural object as metadata.  The [http://www.nmr-relax.com/manual/structure_read_pdb.html structure.read_pdb] and [http://www.nmr-relax.com/manual/structure_write_pdb.html structure.write_pdb] user functions will preserve this information.
 
*  Helix and sheet information from PDB files are now stored in the internal structural object as metadata.  The [http://www.nmr-relax.com/manual/structure_read_pdb.html structure.read_pdb] and [http://www.nmr-relax.com/manual/structure_write_pdb.html structure.write_pdb] user functions will preserve this information.
 
*  The numbers output by the [http://www.nmr-relax.com/manual/value_display.html value.display] and [http://www.nmr-relax.com/manual/value_write.html value.write] user functions can now be scaled.
 
*  The numbers output by the [http://www.nmr-relax.com/manual/value_display.html value.display] and [http://www.nmr-relax.com/manual/value_write.html value.write] user functions can now be scaled.
*  The model-free auto-analysis now generates field strength dependent Rex files for each field present.
+
*  The model-free auto-analysis now generates field strength dependent R<sub>ex</sub> files for each field present.
 
+
<section end=features/>
  
== Changes ==
+
=== Changes ===
  
*  Added a comment to the output from value.display and value.write to describe the parameter.  This idea is discussed at http://thread.gmane.org/gmane.science.nmr.relax.user/1428.  The idea is to take the parameter description from the specific analysis API and add it to the top of the file or output.  This is to help understand what the Rex value are.  For example for the Rex parameter the first line would be: "# Parameter description:  Chemical exchange relaxation (sigma_ex = Rex / omega**2)."
+
<section begin=changes/>
*  Created the Structure.test_read_merge system test to test a new concept - merging of structures.  The idea is to add the merge argument to the structure.read_pdb user function to allow two different structures in two PDB files to be merged.  This is useful if structures of individual domains have have been solved separately and are located in two PDB files.  Then with the merge flag, you will not need to use and external program or hand edit PDB files to join them.
+
*  Added a comment to the output from value.display and value.write to describe the parameter.  This idea is discussed at http://thread.gmane.org/gmane.science.nmr.relax.user/1428.  The idea is to take the parameter description from the specific analysis API and add it to the top of the file or output.  This is to help understand what the R<sub>ex</sub> value are.  For example for the R<sub>ex</sub> parameter the first line would be: "# Parameter description:  Chemical exchange relaxation (sigma_ex = Rex / omega**2)."
*  Added the merge flag to the structure.read_pdb user function.  This currently does nothing.
+
*  Created the Structure.test_read_merge system test to test a new concept - merging of structures.  The idea is to add the merge argument to the [http://www.nmr-relax.com/manual/structure_read_pdb.html structure.read_pdb user function] to allow two different structures in two PDB files to be merged.  This is useful if structures of individual domains have have been solved separately and are located in two PDB files.  Then with the merge flag, you will not need to use and external program or hand edit PDB files to join them.
*  The merge flag for the structure.read_pdb user function is now propagated to the pack_structs() method.  This structure API method calls the ModelList.merge_item() method which is yet to be implemented.
+
*  Added the merge flag to the [http://www.nmr-relax.com/manual/structure_read_pdb.html structure.read_pdb user function].  This currently does nothing.
 +
*  The merge flag for the [http://www.nmr-relax.com/manual/structure_read_pdb.html structure.read_pdb user function] is now propagated to the pack_structs() method.  This structure API method calls the ModelList.merge_item() method which is yet to be implemented.
 
*  The MolList.add_item() structural API method now returns the added molecule container.  This is used by the pack_structs() method to alias the molecule, and will be required when structure merging is implemented.
 
*  The MolList.add_item() structural API method now returns the added molecule container.  This is used by the pack_structs() method to alias the molecule, and will be required when structure merging is implemented.
 
*  Whitespace fixes - replaced many instances of the tab character '\t' with 4 spaces.
 
*  Whitespace fixes - replaced many instances of the tab character '\t' with 4 spaces.
 
*  Implemented the merging of structural objects.  This allows the merge flag of the structure.read_pdb user function to work.
 
*  Implemented the merging of structural objects.  This allows the merge flag of the structure.read_pdb user function to work.
*  The printouts from the structure.read_pdb user function are now different with the merge flag set.  The text now says that the molecules are being merged rather than added.
+
*  The printouts from the [http://www.nmr-relax.com/manual/structure_read_pdb.html structure.read_pdb user function] are now different with the merge flag set.  The text now says that the molecules are being merged rather than added.
*  Sections of molecules can now be deleted using the structure.delete user function.  The atom ID argument has been added and this is now propagated into the internal structural object.  This ID string can be used to delete subsets of the 3D structural data in the relax data store.
+
*  Sections of molecules can now be deleted using the [http://www.nmr-relax.com/manual/structure_delete.html structure.delete user function].  The atom ID argument has been added and this is now propagated into the internal structural object.  This ID string can be used to delete subsets of the 3D structural data in the relax data store.
*  Created the Structure.test_read_write_pdb_1UBQ system test.  This is for checking the use of the structure.delete user function with the atom ID argument.
+
*  Created the Structure.test_read_write_pdb_1UBQ system test.  This is for checking the use of the [http://www.nmr-relax.com/manual/structure_delete.html structure.delete user function] with the atom ID argument.
 
*  The Structure.test_read_write_pdb_1UBQ system test now checks for HELIX and SHEET records.  This is not implemented yet, but the idea is that the structure.read_pdb and structure.write_pdb should preserve the helix and sheet information present in the original PDB and that the internal structural object should store this information.
 
*  The Structure.test_read_write_pdb_1UBQ system test now checks for HELIX and SHEET records.  This is not implemented yet, but the idea is that the structure.read_pdb and structure.write_pdb should preserve the helix and sheet information present in the original PDB and that the internal structural object should store this information.
 
*  Created the internal structural object _pdb_chain_id_to_mol_index() method.  This will be used to convert PDB chain IDs, which are used to indicate different molecules in the PDB, into molecule indices for the internal structural object.
 
*  Created the internal structural object _pdb_chain_id_to_mol_index() method.  This will be used to convert PDB chain IDs, which are used to indicate different molecules in the PDB, into molecule indices for the internal structural object.
*  HELIX PDB records are now read, stored, and written out by the internal structural object.  This affects the structure.read_pdb and structure.write_pdb user functions.  The helix is stored as a metadata type object - its elements do not correspond to the atoms in the structural object.
+
*  HELIX PDB records are now read, stored, and written out by the internal structural object.  This affects the [http://www.nmr-relax.com/manual/structure_read_pdb.html structure.read_pdb] and [http://www.nmr-relax.com/manual/structure_write_pdb.html structure.write_pdb] user functions.  The helix is stored as a metadata type object - its elements do not correspond to the atoms in the structural object.
*  SHEET PDB records are now read, stored, and written out by the internal structural object.  This affects the structure.read_pdb and structure.write_pdb user functions.  The sheet is stored as a metadata type object - its elements do not correspond to the atoms in the structural object.
+
*  SHEET PDB records are now read, stored, and written out by the internal structural object.  This affects the [http://www.nmr-relax.com/manual/structure_read_pdb.html structure.read_pdb] and [http://www.nmr-relax.com/manual/structure_write_pdb.html structure.write_pdb] user functions.  The sheet is stored as a metadata type object - its elements do not correspond to the atoms in the structural object.
 
*  Created 13 unit tests of the Internal._trim_helix() internal structural object method.
 
*  Created 13 unit tests of the Internal._trim_helix() internal structural object method.
 
*  Added the index_flag argument to all structural API atom_loop() methods.
 
*  Added the index_flag argument to all structural API atom_loop() methods.
*  Implemented the internal structural object _trim_helix() method.  This is used when the structure.delete user function is called to trim and remove the helix metadata.  For this to work, the additional method _residue_data() was written to create a dictionary with residue numbers as keys and the residue names as numbers.  This dictionary is used by _trim_helix() to change the residue names in the helix metadata.
+
*  Implemented the internal structural object _trim_helix() method.  This is used when the [http://www.nmr-relax.com/manual/structure_delete.html structure.delete user function] is called to trim and remove the helix metadata.  For this to work, the additional method _residue_data() was written to create a dictionary with residue numbers as keys and the residue names as numbers.  This dictionary is used by _trim_helix() to change the residue names in the helix metadata.
 
*  Created 13 unit tests of the Internal._trim_sheet() internal structural object method.  These are mirror the 13 unit tests of Internal._trim_helix().
 
*  Created 13 unit tests of the Internal._trim_sheet() internal structural object method.  These are mirror the 13 unit tests of Internal._trim_helix().
*  Implemented the Internal._trim_sheet() internal structural object method.  This is also now used by the structure.delete user function to remove sheet metadata for residues which no longer exist.
+
*  Implemented the Internal._trim_sheet() internal structural object method.  This is also now used by the [http://www.nmr-relax.com/manual/structure_delete.html structure.delete user function] to remove sheet metadata for residues which no longer exist.
 
*  Modified the ScientificPython structural object atom_loop() method to match the internal object.  If only one element is returned from the atom_loop(), then this is returned as a single item rather than a tuple of length 1.
 
*  Modified the ScientificPython structural object atom_loop() method to match the internal object.  If only one element is returned from the atom_loop(), then this is returned as a single item rather than a tuple of length 1.
 
*  Lots of fixes for the change to the structural API atom_loop() method.  This method when returning a single item now returns a single item rather than a tuple of length 1.
 
*  Lots of fixes for the change to the structural API atom_loop() method.  This method when returning a single item now returns a single item rather than a tuple of length 1.
Line 54: Line 69:
 
*  Created the Structure.test_metadata_xml system test.  This is used to check that the structural metadata (currently helices and sheets) are stored in the relax XML save files and then can be read back into relax again.
 
*  Created the Structure.test_metadata_xml system test.  This is used to check that the structural metadata (currently helices and sheets) are stored in the relax XML save files and then can be read back into relax again.
 
*  The helix and sheet metadata is now stored in and read from relax XML state files.
 
*  The helix and sheet metadata is now stored in and read from relax XML state files.
*  Added the scaling argument to the value.display and value.write user functions.  The idea comes from a suggestion by Angelo Figueiredo <am dott figueiredo att fct dott unl dott pt> and was discussed at http://thread.gmane.org/gmane.science.nmr.relax.user/1428/focus=1430.  This allows the user to scale parameters to any value, for example scaling the Rex value to the field strength dependent value.
+
*  Added the scaling argument to the [http://www.nmr-relax.com/manual/value_display.html value.display] and [http://www.nmr-relax.com/manual/value_write.html value.write] user functions.  The idea comes from a suggestion by Angelo Figueiredo <am dott figueiredo att fct dott unl dott pt> and was discussed at http://thread.gmane.org/gmane.science.nmr.relax.user/1428/focus=1430.  This allows the user to scale parameters to any value, for example scaling the R<sub>ex</sub> value to the field strength dependent value.
*  The model-free auto-analysis (the dauvergne_protocol) now generates field strength dependent Rex files.  The idea comes from a suggestion by Angelo Figueiredo <am dott figueiredo att fct dott unl dott pt> and was discussed at http://thread.gmane.org/gmane.science.nmr.relax.user/1428/focus=1430.  One file per field strength is generated and named 'rex_600' for 600 MHz, for example.  The new scaling argument of the value.write user function is being used to scale the tiny field strength independent value used internally in relax to the Rex value in rad.s^-1 that you would see in an R2 data set.
+
*  The model-free auto-analysis (the dauvergne_protocol [d'Auvergne and Gooley, 2007][d'Auvergne and Gooley, 2008b]) now generates field strength dependent R<sub>ex</sub> files.  The idea comes from a suggestion by Angelo Figueiredo <am dott figueiredo att fct dott unl dott pt> and was discussed at http://thread.gmane.org/gmane.science.nmr.relax.user/1428/focus=1430.  One file per field strength is generated and named 'rex_600' for 600 MHz, for example.  The new scaling argument of the [http://www.nmr-relax.com/manual/value_write.html value.write user function] is being used to scale the tiny field strength independent value used internally in relax to the R<sub>ex</sub> value in rad.s<sup>-1</sup> that you would see in an R<sub>2</sub> data set.
*  Added the new 'comment' argument to the value.write user function.  This is used to add user comments to the top of the file.
+
*  Added the new 'comment' argument to the [http://www.nmr-relax.com/manual/value_write.html value.write user function].  This is used to add user comments to the top of the file.
*  The model-free auto-analysis (the dauvergne_protocol module) now adds comments to the Rex files.  This is through the new comment argument of the value.write user function.  These comments explain that the Rex values are scaled to the stated field strength.
+
*  The model-free auto-analysis (the dauvergne_protocol module [d'Auvergne and Gooley, 2007][d'Auvergne and Gooley, 2008b]) now adds comments to the R<sub>ex</sub> files.  This is through the new comment argument of the [http://www.nmr-relax.com/manual/value_write.html value.write user function].  These comments explain that the R<sub>ex</sub> values are scaled to the stated field strength.
 
*  Modified the Mf.test_dauvergne_protocol system test to check for all the files and directories created.
 
*  Modified the Mf.test_dauvergne_protocol system test to check for all the files and directories created.
 
*  Created the new lib.text.sectioning module for formatting titles, subtitles and other sectioning text.  The two functions title() and subtitle() have been implemented.
 
*  Created the new lib.text.sectioning module for formatting titles, subtitles and other sectioning text.  The two functions title() and subtitle() have been implemented.
Line 67: Line 82:
 
*  Initialised the lib.structure package - this is currently empty.
 
*  Initialised the lib.structure package - this is currently empty.
 
*  Shifted the rotor creation components from generic_fns.structure.geometric to lib.structure.rotor.  The create_rotor_pdb() function remains in place as this is the user function backend which checks for data pipes and updates the status object, but the rotor_pdb() and create_rotor_propellers() functions have been moved into the relax library.  The create_rotor_propellers() function has been renamed to lib.structure.rotor.rotor_propellers().
 
*  Shifted the rotor creation components from generic_fns.structure.geometric to lib.structure.rotor.  The create_rotor_pdb() function remains in place as this is the user function backend which checks for data pipes and updates the status object, but the rotor_pdb() and create_rotor_propellers() functions have been moved into the relax library.  The create_rotor_propellers() function has been renamed to lib.structure.rotor.rotor_propellers().
*  Converted links in all docstrings to use the Epydoc hyperlink notation.  This will allow links to be clickable for the API documentation (http://www.nmr-relax.com/api/).
+
*  Converted links in all docstrings to use the Epydoc hyperlink notation.  This will allow links to be clickable for the [http://www.nmr-relax.com/api/ API documentation].
*  Added Epydoc hyperlink markup for the bug tracker in the system test docstring where missing.  This is for a better API documentation (http://www.nmr-relax.com/api/).
+
*  Added Epydoc hyperlink markup for the bug tracker in the system test docstring where missing.  This is for a better [http://www.nmr-relax.com/api/ API documentation].
*  The lib.structure.rotor.rotor_pdb() rotor_angle argument should now be in radians.  This does not affect the structure.create_rotor_pdb() user function as the generic_fns.structure.geometric.create_rotor_pdb() function converts the value to radians prior to calling the rotor_pdb() function.
+
*  The lib.structure.rotor.rotor_pdb() rotor_angle argument should now be in radians.  This does not affect the [http://www.nmr-relax.com/manual/structure_create_rotor_pdb.html structure.create_rotor_pdb user function] as the generic_fns.structure.geometric.create_rotor_pdb() function converts the value to radians prior to calling the rotor_pdb() function.
 
*  The lib.structure.rotor.rotor_pdb() function can now handle structural models.  The model number argument has been added to allow the rotor structure to be added to a single model, or to all models if not supplied.
 
*  The lib.structure.rotor.rotor_pdb() function can now handle structural models.  The model number argument has been added to allow the rotor structure to be added to a single model, or to all models if not supplied.
 +
<section end=changes/>
  
 +
=== Bugfixes ===
  
== Bugfixes ==
+
<section begin=bugfixes/>
 
 
 
*  Fix for a copy and paste error in the Structure.test_read_merge system test.
 
*  Fix for a copy and paste error in the Structure.test_read_merge system test.
 
*  Fixes for all the Ap4Aase truncated PDB files.  The atom numbers are now sequential, as defined by the PDB standard.
 
*  Fixes for all the Ap4Aase truncated PDB files.  The atom numbers are now sequential, as defined by the PDB standard.
Line 80: Line 96:
 
*  Python 3 fix for an import into the generic_fns.structure.internal module.
 
*  Python 3 fix for an import into the generic_fns.structure.internal module.
 
*  Python 3 fixes for the relax version information for code checked out from the relax repository.  The subversion version.revision() and version.url() functions now handle the Python 3 issue of Popen working with byte arrays instead of normal strings.
 
*  Python 3 fixes for the relax version information for code checked out from the relax repository.  The subversion version.revision() and version.url() functions now handle the Python 3 issue of Popen working with byte arrays instead of normal strings.
 +
<section end=bugfixes/>
 +
 +
== Links ==
 +
 +
<section begin=links/>
 +
For reference, the following links are also part of the announcement for this release:
 +
* [http://wiki.nmr-relax.com/Relax_2.2.5 Official release notes]
 +
* {{gna link|url=gna.org/forum/forum.php?forum_id=2388|text=Gna! news item}}
 +
* [http://article.gmane.org/gmane.science.nmr.relax.announce/42 Gmane]
 +
* [http://www.mail-archive.com/relax-announce%40gna.org/msg00038.html Mail Archive]
 +
* [https://mail.gna.org/public/relax-announce/2013-03/msg00002.html Local archives]
 +
* [http://marc.info/?l=relax-announce&m=136416224729554&w=2 MARC]
 +
<section end=links/>
 +
 +
== Announcements ==
 +
{{:relax release announcements}}
  
  
= References =
+
== References ==
  
* [*d'Auvergne and Gooley, 2007] d'Auvergne, E. J. and Gooley, P. R. (2007).  Set theory formulation of the model-free problem and the diffusion seeded model-free paradigm.  ''Mol. BioSyst.'', '''3'''(7), 483–494. (DOI: [http://dx.doi.org/10.1039/b702202f 10.1039/b702202f).
+
<section start=references/>
* [*d'Auvergne and Gooley, 2008] d'Auvergne, E. J. and Gooley, P. R. (2008).  Optimisation of NMR dynamic models II.  A new methodology for the dual optimisation of the model-free parameters and the Brownian rotational diffusion tensor.  ''J. Biomol. NMR'', '''40'''(2), 121-133. (DOI: [http://dx.doi.org/10.1007/s10858-007-9213-3 10.1007/s10858-007-9213-3]).
+
* [*d'Auvergne and Gooley, 2007] {{#lst:Citations|dAuvergneGooley07}}
 +
* [*d'Auvergne and Gooley, 2008b] {{#lst:Citations|dAuvergneGooley08b}}
 +
<section end=references/>
 
<HarvardReferences />
 
<HarvardReferences />
  
 +
== See also ==
  
= See also =
+
* [http://www.nmr-relax.com/api/2.2/ The relax 2.2 API documentation]
 
+
{{:relax release see also}}
[[Category:Release_Notes]]
+
[[Category:Model-free analysis]]

Latest revision as of 11:31, 14 October 2020


Official relax releases
relax logo
relax version 2.2.5
Previous version Next version
← relax 2.2.4 relax 3.0.0 →

Keywords Model-free analysis, structure
Release type Minor feature
Release date 24 March 2013

The PDF version of the relax 2.2.5 user manual The relax 2.2.5 user manual

Description

This is a minor feature release. Improvements include the creation of Rex value files scaled to all spectrometer frequencies for the model-free auto-analysis [d'Auvergne and Gooley, 2007][d'Auvergne and Gooley, 2008b] and some new capabilities in the structural API. Feel free to upgrade if you wish to use these new features.


Download

The new relax versions can be downloaded from http://www.nmr-relax.com/download.html. If binary distributions are not yet available for your platform and you manage to compile the binary modules, please consider contributing these to the relax project (described in section 3.6 of the relax manual, http://www.nmr-relax.com/manual/relax_distribution_archives.html).


CHANGES file

Version 2.2.5
(24 March 2013, from /trunk)
http://svn.gna.org/svn/relax/tags/2.2.5


Features

  • The files created by the value.write user function now include a header describing the parameter.
  • The relax internal structural object now supports the merger of molecules. This can be useful if different domains of one system are in two PDB files or are split in the one file.
  • The structure.delete user function can now be used to delete parts of molecules down to the level of individual atoms.
  • Helix and sheet information from PDB files are now stored in the internal structural object as metadata. The structure.read_pdb and structure.write_pdb user functions will preserve this information.
  • The numbers output by the value.display and value.write user functions can now be scaled.
  • The model-free auto-analysis now generates field strength dependent Rex files for each field present.


Changes

  • Added a comment to the output from value.display and value.write to describe the parameter. This idea is discussed at http://thread.gmane.org/gmane.science.nmr.relax.user/1428. The idea is to take the parameter description from the specific analysis API and add it to the top of the file or output. This is to help understand what the Rex value are. For example for the Rex parameter the first line would be: "# Parameter description: Chemical exchange relaxation (sigma_ex = Rex / omega**2)."
  • Created the Structure.test_read_merge system test to test a new concept - merging of structures. The idea is to add the merge argument to the structure.read_pdb user function to allow two different structures in two PDB files to be merged. This is useful if structures of individual domains have have been solved separately and are located in two PDB files. Then with the merge flag, you will not need to use and external program or hand edit PDB files to join them.
  • Added the merge flag to the structure.read_pdb user function. This currently does nothing.
  • The merge flag for the structure.read_pdb user function is now propagated to the pack_structs() method. This structure API method calls the ModelList.merge_item() method which is yet to be implemented.
  • The MolList.add_item() structural API method now returns the added molecule container. This is used by the pack_structs() method to alias the molecule, and will be required when structure merging is implemented.
  • Whitespace fixes - replaced many instances of the tab character '\t' with 4 spaces.
  • Implemented the merging of structural objects. This allows the merge flag of the structure.read_pdb user function to work.
  • The printouts from the structure.read_pdb user function are now different with the merge flag set. The text now says that the molecules are being merged rather than added.
  • Sections of molecules can now be deleted using the structure.delete user function. The atom ID argument has been added and this is now propagated into the internal structural object. This ID string can be used to delete subsets of the 3D structural data in the relax data store.
  • Created the Structure.test_read_write_pdb_1UBQ system test. This is for checking the use of the structure.delete user function with the atom ID argument.
  • The Structure.test_read_write_pdb_1UBQ system test now checks for HELIX and SHEET records. This is not implemented yet, but the idea is that the structure.read_pdb and structure.write_pdb should preserve the helix and sheet information present in the original PDB and that the internal structural object should store this information.
  • Created the internal structural object _pdb_chain_id_to_mol_index() method. This will be used to convert PDB chain IDs, which are used to indicate different molecules in the PDB, into molecule indices for the internal structural object.
  • HELIX PDB records are now read, stored, and written out by the internal structural object. This affects the structure.read_pdb and structure.write_pdb user functions. The helix is stored as a metadata type object - its elements do not correspond to the atoms in the structural object.
  • SHEET PDB records are now read, stored, and written out by the internal structural object. This affects the structure.read_pdb and structure.write_pdb user functions. The sheet is stored as a metadata type object - its elements do not correspond to the atoms in the structural object.
  • Created 13 unit tests of the Internal._trim_helix() internal structural object method.
  • Added the index_flag argument to all structural API atom_loop() methods.
  • Implemented the internal structural object _trim_helix() method. This is used when the structure.delete user function is called to trim and remove the helix metadata. For this to work, the additional method _residue_data() was written to create a dictionary with residue numbers as keys and the residue names as numbers. This dictionary is used by _trim_helix() to change the residue names in the helix metadata.
  • Created 13 unit tests of the Internal._trim_sheet() internal structural object method. These are mirror the 13 unit tests of Internal._trim_helix().
  • Implemented the Internal._trim_sheet() internal structural object method. This is also now used by the structure.delete user function to remove sheet metadata for residues which no longer exist.
  • Modified the ScientificPython structural object atom_loop() method to match the internal object. If only one element is returned from the atom_loop(), then this is returned as a single item rather than a tuple of length 1.
  • Lots of fixes for the change to the structural API atom_loop() method. This method when returning a single item now returns a single item rather than a tuple of length 1.
  • The index_flag argument to the ScientificPython structural object atom_loop() method is now used.
  • Created the Structure.test_metadata_xml system test. This is used to check that the structural metadata (currently helices and sheets) are stored in the relax XML save files and then can be read back into relax again.
  • The helix and sheet metadata is now stored in and read from relax XML state files.
  • Added the scaling argument to the value.display and value.write user functions. The idea comes from a suggestion by Angelo Figueiredo <am dott figueiredo att fct dott unl dott pt> and was discussed at http://thread.gmane.org/gmane.science.nmr.relax.user/1428/focus=1430. This allows the user to scale parameters to any value, for example scaling the Rex value to the field strength dependent value.
  • The model-free auto-analysis (the dauvergne_protocol [d'Auvergne and Gooley, 2007][d'Auvergne and Gooley, 2008b]) now generates field strength dependent Rex files. The idea comes from a suggestion by Angelo Figueiredo <am dott figueiredo att fct dott unl dott pt> and was discussed at http://thread.gmane.org/gmane.science.nmr.relax.user/1428/focus=1430. One file per field strength is generated and named 'rex_600' for 600 MHz, for example. The new scaling argument of the value.write user function is being used to scale the tiny field strength independent value used internally in relax to the Rex value in rad.s-1 that you would see in an R2 data set.
  • Added the new 'comment' argument to the value.write user function. This is used to add user comments to the top of the file.
  • The model-free auto-analysis (the dauvergne_protocol module [d'Auvergne and Gooley, 2007][d'Auvergne and Gooley, 2008b]) now adds comments to the Rex files. This is through the new comment argument of the value.write user function. These comments explain that the Rex values are scaled to the stated field strength.
  • Modified the Mf.test_dauvergne_protocol system test to check for all the files and directories created.
  • Created the new lib.text.sectioning module for formatting titles, subtitles and other sectioning text. The two functions title() and subtitle() have been implemented.
  • Created unit tests for the title() and subtitle() functions of the lib.text.sectioning module.
  • Expansion of the lib.text.sectioning module. The following new functions have been added: box(), section(), subsection(), subsubsection(),subtitle(), subsubtitle(), underline().
  • Expanded the unit testing of the lib.text.sectioning module to cover all title and section functions.
  • Added prespace and postspace arguments to the *section() and *title() functions of lib.text.sectioning. Through these arguments, the amount of spacing above and below the section text can be controlled.
  • Split the generic_fns.structure.geometric.create_rotor_pdb() function. The non-relax specific code has been shifted into the rotor_pdb() function.
  • Initialised the lib.structure package - this is currently empty.
  • Shifted the rotor creation components from generic_fns.structure.geometric to lib.structure.rotor. The create_rotor_pdb() function remains in place as this is the user function backend which checks for data pipes and updates the status object, but the rotor_pdb() and create_rotor_propellers() functions have been moved into the relax library. The create_rotor_propellers() function has been renamed to lib.structure.rotor.rotor_propellers().
  • Converted links in all docstrings to use the Epydoc hyperlink notation. This will allow links to be clickable for the API documentation.
  • Added Epydoc hyperlink markup for the bug tracker in the system test docstring where missing. This is for a better API documentation.
  • The lib.structure.rotor.rotor_pdb() rotor_angle argument should now be in radians. This does not affect the structure.create_rotor_pdb user function as the generic_fns.structure.geometric.create_rotor_pdb() function converts the value to radians prior to calling the rotor_pdb() function.
  • The lib.structure.rotor.rotor_pdb() function can now handle structural models. The model number argument has been added to allow the rotor structure to be added to a single model, or to all models if not supplied.


Bugfixes

  • Fix for a copy and paste error in the Structure.test_read_merge system test.
  • Fixes for all the Ap4Aase truncated PDB files. The atom numbers are now sequential, as defined by the PDB standard.
  • Bug fix for the structural data consistency test in the pack_structs() structural API method. The index was not correct causing failures in certain rare cases.
  • Python 3 fix for an import into the generic_fns.structure.internal module.
  • Python 3 fixes for the relax version information for code checked out from the relax repository. The subversion version.revision() and version.url() functions now handle the Python 3 issue of Popen working with byte arrays instead of normal strings.


Links

For reference, the following links are also part of the announcement for this release:


Announcements

If you would like to receive announcements about new relax versions, please subscribe to the relax announcement mailing list. This list only receives ~10 emails per year. It is archived at the SourceForge archives and in The Mail Archive.


References

  • [*d'Auvergne and Gooley, 2007] d'Auvergne, E. J. and Gooley, P. R. (2007). Set theory formulation of the model-free problem and the diffusion seeded model-free paradigm. Mol. BioSyst., 3(7), 483-494. (DOI: 10.1039/b702202f)
  • [*d'Auvergne and Gooley, 2008b] d'Auvergne, E. J. and Gooley, P. R. (2008). Optimisation of NMR dynamic models II. A new methodology for the dual optimisation of the model-free parameters and the Brownian rotational diffusion tensor. J. Biomol. NMR, 40(2), 121-133. (DOI: 10.1007/s10858-007-9213-3)

<HarvardReferences />

See also