Difference between revisions of "Relax 3.3.9"

From relax wiki
Jump to navigation Jump to search
(→‎Description: Fix for the RDC and PCS text.)
(Links to the API documentation.)
Line 37: Line 37:
 
* In the collection bash script, removes spins which have not been fitted.  [https://gna.org/task/?7826 Task #7826: Write an Python class for the repeated analysis of dispersion data].
 
* In the collection bash script, removes spins which have not been fitted.  [https://gna.org/task/?7826 Task #7826: Write an Python class for the repeated analysis of dispersion data].
 
* Fix for use of " instead of ' in bash script.  [https://gna.org/task/?7826 Task #7826: Write an Python class for the repeated analysis of dispersion data].
 
* Fix for use of " instead of ' in bash script.  [https://gna.org/task/?7826 Task #7826: Write an Python class for the repeated analysis of dispersion data].
* Adding option to minimise class function, to perform Monte Carlo error analysis.  [https://gna.org/task/?7826 Task #7826: Write an Python class for the repeated analysis of dispersion data].
+
* Adding option to [http://www.nmr-relax.com/api/3.3/auto_analyses.relax_disp_repeat_cpmg.Relax_disp_rep-class.html#minimise_execute minimise class function], to perform Monte Carlo error analysis.  [https://gna.org/task/?7826 Task #7826: Write an Python class for the repeated analysis of dispersion data].
 
* Printout when minimising Monte Carlo simulations.  [https://gna.org/task/?7826 Task #7826: Write an Python class for the repeated analysis of dispersion data].
 
* Printout when minimising Monte Carlo simulations.  [https://gna.org/task/?7826 Task #7826: Write an Python class for the repeated analysis of dispersion data].
* Added additional test to system test Relax_disp.test_bug_23186_cluster_error_calc_dw() to prove that Bug #23619 is invalid.  [https://gna.org/bugs/?23619 Bug #23619: Stored chi2 sim values from Monte Carlo simulations does not equal normal chi2 values].
+
* Added additional test to [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.relax_disp.Relax_disp-class.html#test_bug_23186_cluster_error_calc_dw system test Relax_disp.test_bug_23186_cluster_error_calc_dw()] to prove that Bug #23619 is invalid.  [https://gna.org/bugs/?23619 Bug #23619: Stored chi2 sim values from Monte Carlo simulations does not equal normal chi2 values].
 
* Small fix for the shell script to collect data files, and not use the program "column" in the end.  The line width becomes to large to handle for column.  [https://gna.org/task/?7826 Task #7826: Write an Python class for the repeated analysis of dispersion data].
 
* Small fix for the shell script to collect data files, and not use the program "column" in the end.  The line width becomes to large to handle for column.  [https://gna.org/task/?7826 Task #7826: Write an Python class for the repeated analysis of dispersion data].
* Added a unit test that triggers the bug.  Test added in test_delete_spin_all, and can be accessed with: relax -u _pipe_control.test_spin.  [https://gna.org/bugs/?23642 Bug #23642]: When deleting all spins for a residue, an empty placeholder is where select=True.
+
* Added a unit test that triggers the bug.  Test added in [http://www.nmr-relax.com/api/3.3/test_suite.unit_tests.spin_testing_base.Spin_base_class-class.html#test_delete_spin_all test_delete_spin_all], and can be accessed with: relax -u _pipe_control.test_spin.  [https://gna.org/bugs/?23642 Bug #23642]: When deleting all spins for a residue, an empty placeholder is where select=True.
* Added sample data and analysis script, that will eventually show that there is not much difference in the sample statistics used for comparing the output of two very similar datasets.  This is a multiple comparison test with many T-tests at once, where the familywise error is controlled by the Holm method. Even if the values are close to equal, and within the standard deviation, this procedure will reject up to 20% of the null hypothesis.  This is not deemed as a suitable method.  [https://gna.org/bugs/?23644 Bug #23644: monte_carlo.error_analysis() does not update the mean value/expectation value from simulations].
+
* Added sample data and analysis script, that will eventually show that there is not much difference in the sample statistics used for comparing the output of two very similar datasets.  This is a multiple comparison test with many T-tests at once, where the familywise error is controlled by the Holm method. Even if the values are close to equal, and within the standard deviation, this procedure will reject up to 20% of the null hypothesis.  This is not deemed as a suitable method.  [https://gna.org/bugs/?23644 Bug #23644: monte_carlo.error_analysis() does not update the mean value/expectation value from simulations].
* Added Monte Carlo simulations to the N_state_model.test_absolute_T system test.  This is to demonstrate a failure of the simulations in certain N-state model setups.
+
* Added Monte Carlo simulations to the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.n_state_model.N_state_model-class.html#test_absolute_T N_state_model.test_absolute_T system test].  This is to demonstrate a failure of the simulations in certain N-state model setups.
* Added a missing call to monte_carlo.initial_values in the N_state_model.test_absolute_T system test.  This fixes the N_state_model.test_absolute_T system test, showing that there is not a problem with the Monte Carlo simulations.
+
* Added a missing call to [http://www.nmr-relax.com/manual/monte_carlo_initial_values.html monte_carlo.initial_values] in the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.n_state_model.N_state_model-class.html#test_absolute_T N_state_model.test_absolute_T system test].  This fixes the N_state_model.test_absolute_T system test, showing that there is not a problem with the Monte Carlo simulations.
* Added Monte Carlo and Bootstrap simulation support for the RDC and PCS Q factor calculations.  The pipe_control.rdc.q_factors() and pipe_control.pcs.q_factors() functions have been modified to support Monte Carlo and Bootstrap simulations.  The sim_index argument has been added to allow the Q factor for the given simulation number to be calculated.  All of the Q factor data structures in the base data pipe now have *_sim equivalents for permanently storing the simulation values.  For the simulation values, all the warnings have been silenced.
+
* Added Monte Carlo and Bootstrap simulation support for the RDC and PCS Q factor calculations.  The [http://www.nmr-relax.com/api/3.3/pipe_control.rdc-module.html#q_factors pipe_control.rdc.q_factors()] and [http://www.nmr-relax.com/api/3.3/pipe_control.pcs-module.html#q_factors pipe_control.pcs.q_factors()] functions have been modified to support Monte Carlo and Bootstrap simulations.  The sim_index argument has been added to allow the Q factor for the given simulation number to be calculated.  All of the Q factor data structures in the base data pipe now have *_sim equivalents for permanently storing the simulation values.  For the simulation values, all the warnings have been silenced.
* Added simulation support for the RDC and PCS Q factors in the N-state model analysis.  This is for both Monte Carlo and Bootstrap simulation.  The simulation RDC and PCS values, as well as the simulation back calculated values are now stored via the minimise_bc_data() function of specific_analyses.n_state_model.optimisation in the respective spin or interatomic data containers. The analysis specific API methods now send the sim_index value into minimise_bc_data(), as well as the pipe_control.rdc.q_factors() and pipe_control.pcs.q_factors() functions.
+
* Added simulation support for the RDC and PCS Q factors in the N-state model analysis.  This is for both Monte Carlo and Bootstrap simulation.  The simulation RDC and PCS values, as well as the simulation back calculated values are now stored via the [http://www.nmr-relax.com/api/3.3/specific_analyses.n_state_model.optimisation-module.html#minimise_bc_data minimise_bc_data() function] of [http://www.nmr-relax.com/api/3.3/specific_analyses.n_state_model.optimisation-module.html specific_analyses.n_state_model.optimisation] in the respective spin or interatomic data containers. The analysis specific API methods now send the sim_index value into minimise_bc_data(), as well as the [http://www.nmr-relax.com/api/3.3/pipe_control.rdc-module.html#q_factors pipe_control.rdc.q_factors()] and [http://www.nmr-relax.com/api/3.3/pipe_control.pcs-module.html#q_factors pipe_control.pcs.q_factors()] functions.
 
* Silenced a warning in the N-state model optimisation if the verbosity is set to zero.  This removes a repetitive warning from the Monte Carlo or Bootstrap simulations.
 
* Silenced a warning in the N-state model optimisation if the verbosity is set to zero.  This removes a repetitive warning from the Monte Carlo or Bootstrap simulations.
* Huge speed up for the Monte Carlo simulations in the N-state model analyses.  This speed up is also for Bootstrap simulations and the frame order analysis.  The change affects the [http://www.nmr-relax.com/manual/monte_carlo_initial_values.html monte_carlo.initial_values] user function.  The alignment tensor _update_object() method was very inefficient when updating the Monte Carlo simulation data structures.  For each simulation, each of the alignment tensor data structures were being updated for all simulations.  Now only the current simulations is being updated.  This speeds up the user function by many orders of magnitude.
+
* Huge speed up for the Monte Carlo simulations in the N-state model analyses.  This speed up is also for Bootstrap simulations and the frame order analysis.  The change affects the [http://www.nmr-relax.com/manual/monte_carlo_initial_values.html monte_carlo.initial_values] user function.  The alignment tensor [http://www.nmr-relax.com/api/3.3/data_store.align_tensor.AlignTensorData-class.html#_update_object _update_object() method] was very inefficient when updating the Monte Carlo simulation data structures.  For each simulation, each of the alignment tensor data structures were being updated for all simulations.  Now only the current simulations is being updated.  This speeds up the user function by many orders of magnitude.
* Added functions for calculating the geometric mean and standard deviation to the relax library.  These are the geometric_mean() and geometric_std() functions of the lib.statistics module.  The implementation is designed to be fast, using numpy array arithmetic rather than Python loops.
+
* Added functions for calculating the geometric mean and standard deviation to the relax library.  These are the [http://www.nmr-relax.com/api/3.3/lib.statistics-module.html#geometric_mean geometric_mean()] and [http://www.nmr-relax.com/api/3.3/lib.statistics-module.html#geometric_std geometric_std()] functions of the [http://www.nmr-relax.com/api/3.3/lib.statistics-module.html lib.statistics module].  The implementation is designed to be fast, using numpy array arithmetic rather than Python loops.
* Created a simple unit test for the new lib.statistics.geometric_mean() function.
+
* Created a simple unit test for the new [http://www.nmr-relax.com/api/3.3/lib.statistics-module.html#geometric_mean lib.statistics.geometric_mean() function].
* Added a unit test for the new lib.statistics.geometric_std() function.
+
* Added a unit test for the new [http://www.nmr-relax.com/api/3.3/lib.statistics-module.html#geometric_std lib.statistics.geometric_std() function].
 
* Made a summarize function to compare results.  [https://gna.org/task/?7826 Task #7826: Write an Python class for the repeated analysis of dispersion data].
 
* Made a summarize function to compare results.  [https://gna.org/task/?7826 Task #7826: Write an Python class for the repeated analysis of dispersion data].
 
<section end=changes/>
 
<section end=changes/>

Revision as of 12:22, 1 October 2015


Description

This is a minor feature release with improvements to the automatic relaxation dispersion protocol for repeated CPMG data, support for Monte Carlo or Bootstrap simulating RDC and PCS Q factors, a huge speedup of Monte Carlo simulations in the N-state model analysis, and geometric mean and standard deviation functions added to the relax library.


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.3.9
(30 September 2015, from /trunk)
http://svn.gna.org/svn/relax/tags/3.3.9


Features

  • Improvements to the automatic relaxation dispersion protocol for repeated CPMG data.
  • Support for Monte Carlo or Bootstrap simulating the RDC and PCS Q factors.
  • Huge speedup of Monte Carlo simulations in the N-state model analysis.
  • Geometric mean and standard deviation functions added to the relax library.


Changes


Bugfixes


Links

For reference, the announcement for this release can also be found at following links:

Softpedia also has information about the newest relax releases:


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.


See also