Difference between revisions of "Relax 3.2.0"

From relax wiki
Jump to navigation Jump to search
m (Line breaks.)
(Addition of labelled section transclusion tags.)
Line 3: Line 3:
 
= Description =
 
= Description =
  
<onlyinclude>
+
<section begin=description/>
 
This is a major feature release.  It includes the addition of the new [[B14]] and [[B14 full]] [[:Category:relaxation dispersion|relaxation dispersion]] models [Baldwin 2014], a complete rearrangement of the module layout of the specific analyses packages, a number of new [http://www.nmr-relax.com/manual/list_functions.html user functions], documentation improvements including the addition of a [http://www.nmr-relax.com/manual/N_state_model_or_ensemble_analysis.html new chapter to the manual for the N-state model or ensemble analysis], and numerous of other features.  This is also a major bugfix release, so all users are recommended to upgrade.  This is essential if you are using the new relaxation dispersion analysis in relax as a severe bug in the error calculation has been corrected.  See below for a comprehensive list of new features, the rather large number of changes, and the long list of all bugs fixed.
 
This is a major feature release.  It includes the addition of the new [[B14]] and [[B14 full]] [[:Category:relaxation dispersion|relaxation dispersion]] models [Baldwin 2014], a complete rearrangement of the module layout of the specific analyses packages, a number of new [http://www.nmr-relax.com/manual/list_functions.html user functions], documentation improvements including the addition of a [http://www.nmr-relax.com/manual/N_state_model_or_ensemble_analysis.html new chapter to the manual for the N-state model or ensemble analysis], and numerous of other features.  This is also a major bugfix release, so all users are recommended to upgrade.  This is essential if you are using the new relaxation dispersion analysis in relax as a severe bug in the error calculation has been corrected.  See below for a comprehensive list of new features, the rather large number of changes, and the long list of all bugs fixed.
</onlyinclude>
+
<section end=description/>
  
 
= Download =
 
= 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 3.2.0 <br/>
 
Version 3.2.0 <br/>
 
(20 May 2014, from /trunk) <br/>
 
(20 May 2014, from /trunk) <br/>
 
http://svn.gna.org/svn/relax/tags/3.2.0
 
http://svn.gna.org/svn/relax/tags/3.2.0
 
+
<section end=metadata/>
  
 
== Features ==
 
== Features ==
  
 +
<section begin=features/>
 
*  Addition of the vector_angle() relax library function for calculating the signed or directional angle between two vectors.
 
*  Addition of the vector_angle() relax library function for calculating the signed or directional angle between two vectors.
 
*  Huge speed up of the [http://www.nmr-relax.com/manual/interatom_define.html interatom.define user function].
 
*  Huge speed up of the [http://www.nmr-relax.com/manual/interatom_define.html interatom.define user function].
Line 42: Line 45:
 
*  Creation of the new [http://www.nmr-relax.com/manual/pymol_frame_order.html pymol.frame_order user function] for visualising results.
 
*  Creation of the new [http://www.nmr-relax.com/manual/pymol_frame_order.html pymol.frame_order user function] for visualising results.
 
*  Expansion of the Grace 2D data plotting capabilities.
 
*  Expansion of the Grace 2D data plotting capabilities.
 
+
<section end=features/>
  
 
== Changes ==
 
== Changes ==
  
 +
<section begin=changes/>
 
*  Shifted two functions from pipe_control.angles into the new lib.geometry.angles module.  This is the fold_spherical_angles() and wrap_angles() functions which are not related to the relax data store and hence can be made independent.
 
*  Shifted two functions from pipe_control.angles into the new lib.geometry.angles module.  This is the fold_spherical_angles() and wrap_angles() functions which are not related to the relax data store and hence can be made independent.
 
*  Replaced function atan(&omega;<sub>1</sub> / &Delta;&omega;) with atan2(&omega;<sub>1</sub> , &Delta;&omega;), to make sure returned &theta; values are between 0 and &pi;.  This was done in the function return_offset_data() in the specific_analyses of relax_disp.  This was discussed in: http://thread.gmane.org/gmane.science.nmr.relax.devel/5210.
 
*  Replaced function atan(&omega;<sub>1</sub> / &Delta;&omega;) with atan2(&omega;<sub>1</sub> , &Delta;&omega;), to make sure returned &theta; values are between 0 and &pi;.  This was done in the function return_offset_data() in the specific_analyses of relax_disp.  This was discussed in: http://thread.gmane.org/gmane.science.nmr.relax.devel/5210.
Line 610: Line 614:
 
*  Python 3 fixes for all of the relax code base.  The lib.compat and multi.processor module changes were fatal, not useful for Python 3, and hence reverted.
 
*  Python 3 fixes for all of the relax code base.  The lib.compat and multi.processor module changes were fatal, not useful for Python 3, and hence reverted.
 
*  Python >= 3.2 fix for the Relax_disp.test_sod1wt_t25_to_sherekhan_input system test.  The B0 field value of the ShereKhan input files created by the [http://www.nmr-relax.com/manual/relax_disp_sherekhan_input.html relax_disp.sherekhan_input user function] was formatted as "%s".  However in Python >= 3.2, floats are now converted to have 14 decimal places whereas previous Python versions only had 10 places.  The user function backend now forces only 10 decimal places to be written to the input files.
 
*  Python >= 3.2 fix for the Relax_disp.test_sod1wt_t25_to_sherekhan_input system test.  The B0 field value of the ShereKhan input files created by the [http://www.nmr-relax.com/manual/relax_disp_sherekhan_input.html relax_disp.sherekhan_input user function] was formatted as "%s".  However in Python >= 3.2, floats are now converted to have 14 decimal places whereas previous Python versions only had 10 places.  The user function backend now forces only 10 decimal places to be written to the input files.
 
+
<section end=changes/>
  
 
== Bugfixes ==
 
== Bugfixes ==
  
 +
<section begin=bugfixes/>
 
*  Fix for [https://gna.org/bugs/?21814 bug #21814, the PDB reading failure when the PDB records are not padded to 80 spaces].  The fix is simple, all PDB records are pre-validated.  This includes removing all newline characters and padding each PDB record to 80 spaces when needed.  This will however add an overhead cost -- the internal PDB reader will now be slower.  However corrupted PDB files, produced by MODELLER for example, not padded to 80 spaces will now be better supported.
 
*  Fix for [https://gna.org/bugs/?21814 bug #21814, the PDB reading failure when the PDB records are not padded to 80 spaces].  The fix is simple, all PDB records are pre-validated.  This includes removing all newline characters and padding each PDB record to 80 spaces when needed.  This will however add an overhead cost -- the internal PDB reader will now be slower.  However corrupted PDB files, produced by MODELLER for example, not padded to 80 spaces will now be better supported.
 
*  Bug fix for all of the R<sub>1&rho;</sub> relaxation dispersion models.  The atan2() function is now being used rather than atan() for determining the rotating frame tilt angle.  This is to allow the angle to be in the correct quadrant - i.e. to have a sign or direction.
 
*  Bug fix for all of the R<sub>1&rho;</sub> relaxation dispersion models.  The atan2() function is now being used rather than atan() for determining the rotating frame tilt angle.  This is to allow the angle to be in the correct quadrant - i.e. to have a sign or direction.
Line 661: Line 666:
 
*  Fix for [https://gna.org/bugs/?22041 bug #22041, the PDB atom serial number error from the structure.write_pdb user function].  The problem is that the [http://www.nmr-relax.com/manual/structure_write_pdb.html structure.write_pdb user function] preserves the atom numbering from the original structure and uses that for the atom serial number.  However the atom serial number must be replaced with sequential values to produce a valid PDB file.  This is fatal for any CONECT records.
 
*  Fix for [https://gna.org/bugs/?22041 bug #22041, the PDB atom serial number error from the structure.write_pdb user function].  The problem is that the [http://www.nmr-relax.com/manual/structure_write_pdb.html structure.write_pdb user function] preserves the atom numbering from the original structure and uses that for the atom serial number.  However the atom serial number must be replaced with sequential values to produce a valid PDB file.  This is fatal for any CONECT records.
 
*  Fix for the chain-reaction failures in the test suite.  This fixes [https://gna.org/bugs/?22055 bug #22055, the processor.run_queue() not cleaning up in uni_processor - chain-reaction failures in the test suite].  The fix was insanely simple, just implementing what was mentioned Gary Thompson's FIXME comment in the run_queue() method of the uni-processor object.  The queue execution code has been placed inside a 'try' statement and the queue cleaning up code in a 'finally' statement.  This closes a painfully difficult to find bug that has been in relax since 2006, though only affecting relax developers.
 
*  Fix for the chain-reaction failures in the test suite.  This fixes [https://gna.org/bugs/?22055 bug #22055, the processor.run_queue() not cleaning up in uni_processor - chain-reaction failures in the test suite].  The fix was insanely simple, just implementing what was mentioned Gary Thompson's FIXME comment in the run_queue() method of the uni-processor object.  The queue execution code has been placed inside a 'try' statement and the queue cleaning up code in a 'finally' statement.  This closes a painfully difficult to find bug that has been in relax since 2006, though only affecting relax developers.
 
+
<section end=bugfixes/>
  
 
= Links =
 
= Links =
  
 +
<section begin=links/>
 
For reference, the following links are also part of the announcement for this release:
 
For reference, the following links are also part of the announcement for this release:
 
* [http://wiki.nmr-relax.com/Relax_3.2.0 Official release notes]
 
* [http://wiki.nmr-relax.com/Relax_3.2.0 Official release notes]
Line 671: Line 677:
 
* [https://mail.gna.org/public/relax-announce/2014-05/msg00000.html Local archives]
 
* [https://mail.gna.org/public/relax-announce/2014-05/msg00000.html Local archives]
 
* [http://marc.info/?l=relax-announce&m=140071233101164&w=2 MARC]
 
* [http://marc.info/?l=relax-announce&m=140071233101164&w=2 MARC]
 
+
<section end=links/>
  
 
= Announcements =
 
= Announcements =
Line 680: Line 686:
 
= References =
 
= References =
  
 +
<section start=references/>
 
* [*Baldwin 2014] A. Baldwin (2014).  An exact solution for R2,eff in CPMG experiments in the case of two site chemical exchange.  ''J. Magn. Reson.'', '''244''', 114-124.  (DOI: [http://dx.doi.org/10.1016/j.jmr.2014.02.023 10.1016/j.jmr.2014.02.023]).
 
* [*Baldwin 2014] A. Baldwin (2014).  An exact solution for R2,eff in CPMG experiments in the case of two site chemical exchange.  ''J. Magn. Reson.'', '''244''', 114-124.  (DOI: [http://dx.doi.org/10.1016/j.jmr.2014.02.023 10.1016/j.jmr.2014.02.023]).
 +
<section end=references/>
 
<HarvardReferences />
 
<HarvardReferences />
  

Revision as of 16:39, 10 September 2014


Description

This is a major feature release. It includes the addition of the new B14 and B14 full relaxation dispersion models [Baldwin 2014], a complete rearrangement of the module layout of the specific analyses packages, a number of new user functions, documentation improvements including the addition of a new chapter to the manual for the N-state model or ensemble analysis, and numerous of other features. This is also a major bugfix release, so all users are recommended to upgrade. This is essential if you are using the new relaxation dispersion analysis in relax as a severe bug in the error calculation has been corrected. See below for a comprehensive list of new features, the rather large number of changes, and the long list of all bugs fixed.


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 3.2.0
(20 May 2014, from /trunk)
http://svn.gna.org/svn/relax/tags/3.2.0


Features

  • Addition of the vector_angle() relax library function for calculating the signed or directional angle between two vectors.
  • Huge speed up of the interatom.define user function.
  • For improved feedback, a busy cursor is shown in the GUI when executing user functions.
  • The steady-state NOE auto-analysis now produces a 2D Grace plot of the reference and saturated spectra peak intensity values.
  • Complete redesign of the specific analyses backend, simplifying and cleaning up this internal API and making it easier for users to add completely new analysis types to relax.
  • Parametric reduction of the rotor frame order model, eliminating one redundant parameter hence simplifying optimisation.
  • Large improvement for the lib.software.grace module. The '*_err' and '*_bc' parameter names for the parameter error and back-calculated parameters respectively are now supported, allowing these values to be easily plotted.
  • Expansion of the value.set user function to handle parameters which consist of lists of values. The index argument has been added to allow the index of the list to be specified, and this is then propagated into the specific analysis API.
  • Improvements for the parameter definitions in all analysis types. This allows for better output in 2D plots and text files.
  • Implemented linear constraints for the frame order analysis. This uses the log-barrier constraint algorithm in the minfx library to provide constraints without requiring gradients.
  • Improved and expanded the relax command line options for debugging.
  • Full independence of the relax library so that it can be used outside of relax.
  • The addition of a relaxation dispersion user function for setting the R20 values to the minimum R2eff value.
  • Expanded capabilities for the relax_disp.sherekhan_input user function.
  • Implementation of the B14 and B14 full relaxation dispersion CPMG models for 2-site exchange for all time scales (from the new paper [Baldwin 2014] at http://dx.doi.org/10.1016/j.jmr.2014.02.023).
  • Large improvements to the relax HTML manual including fixes for URLs, bibliography entries, links, and tables.
  • Support for multiple point creation for the OpenDX chi-squared space mapping user function.
  • Automatic determination of reasonable initial contour levels for the OpenDX mapping user function.
  • Addition of a new chapter to the manual for the N-state model or ensemble analysis.
  • Creation of the new pymol.frame_order user function for visualising results.
  • Expansion of the Grace 2D data plotting capabilities.


Changes


Bugfixes


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

  • [*Baldwin 2014] A. Baldwin (2014). An exact solution for R2,eff in CPMG experiments in the case of two site chemical exchange. J. Magn. Reson., 244, 114-124. (DOI: 10.1016/j.jmr.2014.02.023).

<HarvardReferences />


See also

relax release descriptions