Changes

{{infobox relax release| version = 3.3.3| prev = 3.3.2| next = 3.3.4| type = Major feature and bugfix| date = 24 November 2014| manual = yes}} == Description ==

This is a major feature and bugfix release. It fixes a failure when loading relaxation data and adds Python 3 support for using the NMRPipe showApod software. Features include a large expansion for the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles ] and [http://www.nmr-relax.com/manual/align_tensor_svd.html align_tensor.svd ] user functions to support the standard inter-matrix angles, the unitary 9D vector notation {SxxS_xx, SxyS_xy, SxzS_xz, SyxS_yx, SyyS_yy, SyzS_yz, SzxS_zx, SzyS_zy, SzzS_zz}, and the irreducible spherical tensor 5D basis set of {A_-2, A_-1, A0A₀, A1A₁, A2A₂} for correctly calculating the inter-tensor angles, singular values and condition numbers.

== Download ==

== CHANGES file ==

=== Features ===

* Implemented the [http://www.nmr-relax.com/api/3.3/lib.geometry.vectors-module.html#vector_angle_atan2 lib.geometry.vectors.vector_angle_atan2() relax library function]. This is for calculating the inter-vector angle using the more numerically stable atan2() formula.* Implemented the [http://www.nmr-relax.com/api/3.3/lib.geometry.vectors-module.html#vector_angle_acos lib.geometry.vectors.vector_angle_acos() relax library function]. This is used to calculate the inter-vector angle using the arccos of the dot product formula. The function has been introduced into the relax library as the calculation is repeated throughout relax.* Expanded the basis sets for the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function ] to allow the correct inter-tensor angles to be calculated. This includes the standard inter-matrix angles via the arccos of the Euclidean inner product of the alignment matrices in rank-2, 3D form divided by the Frobenius norm of the matrices, irreducible spherical tensor 5D basis set {A_-2, A_-1, A0A₀, A1A₁, A2A₂}, and the unitary 9D basis set {SxxS_xx, SxyS_xy, SxzS_xz, SyxS_yx, SyyS_yy, SyzS_yz, SzxS_zx, SzyS_zy, SzzS_zz} (all of which produce the same result).* Expanded the basis sets for the [http://www.nmr-relax.com/manual/align_tensor_svd.html align_tensor.svd user function ] to allow the correct singular values and condition number to be calculated. This includes the irreducible spherical tensor 5D basis set {A_-2, A_-1, A0A₀, A1A₁, A2A₂} and the unitary 9D basis set {SxxS_xx, SxyS_xy, SxzS_xz, SyxS_yx, SyyS_yy, SyzS_yz, SzxS_zx, SzyS_zy, SzzS_zz} (both of which produce the same result).* Added the angle_units and precision arguments to the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function ] to allow either degrees or radians to be output and the number of decimal points to be specified.* Added the precision argument to the [http://www.nmr-relax.com/manual/align_tensor_svd.html align_tensor.svd user function ] to allow the number of decimal points for the singular values and condition number to be specified.* Updated the [http://www.nmr-relax.com/manual/align_tensor_display.html align_tensor.display user function ] to output the irreducible spherical harmonic weights. This is the alignment tensor in the {A_-2, A_-1, A0A₀, A1A₁, A2A₂} notation.

=== Changes ===

* Basic Epydoc fix for the [http://www.nmr-relax.com/api/3.3/data_store.exp_info-module.html data_store.exp_info module].* Epydoc fix for the [http://www.nmr-relax.com/api/3.3/auto_analyses.relax_disp_repeat_cpmg.Relax_disp_rep-class.html#name_pipe name_pipe() method of the relaxation dispersion auto-analysis for repeated data.]

* Added a line to the release checklist document about updating the wiki release links. These are for the combined release notes pages at http://wiki.nmr-relax.com/Relax_releases[[Relax releases]], http://wiki.nmr-relax.com/Relax_release_descriptions[[Relax release descriptions]], http://wiki.nmr-relax.com/Relax_release_metadata[[Relax release metadata]], http://wiki.nmr-relax.com/Relax_release_features[[Relax release features]], http://wiki.nmr-relax.com/Relax_release_changes[[Relax release changes]], http://wiki.nmr-relax.com/Relax_release_bugfixes[[Relax release bugfixes]], http://wiki.nmr-relax.com/Relax_release_links[[Relax release links]].

* Created a [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.model_free.Mf-class.html#test_data_loading_failures system test to catch a rare relaxation data loading problem].* Created the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.model_free.Mf-class.html#test_dauvergne_protocol_sphere Mf.test_dauvergne_protocol_sphere system test]. This catches bug #22963 ([https://gna.org/bugs/?22963)bug #22963: Using '@N*' to define the interatomic interactions for a model-free analysis fails when using non-backbone 15N ¹⁵N spins].* Set more reasonable default values for the [http://www.nmr-relax.com/api/3.3/lib.structure.pdb_write -module.html lib.structure.pdb_write] functions [http://www.nmr-relax.com/api/3.3/lib.structure.pdb_write-module.html#atom atom() ] and [http://www.nmr-relax.com/api/3.3/lib.structure.pdb_write-module.html#hetatm hetatm()]. The occupancy now defaults to 1.0 instead of '', and the temperature factor to 0.0 instead of ''. This avoid painful errors when using these functions, as these arguments must be floating point numbers at all times, hence the default value of '' causes a TypeError.

* Renamed vector_angle() to [http://www.nmr-relax.com/api/3.3/lib.geometry.vectors-module.html#vector_angle_normal vector_angle_normal() ] in the [http://www.nmr-relax.com/api/3.3/lib.geometry.vectors-module.html lib.geometry.vectors module]. This is to standardise the naming as there are now the standard vector angle formula implemented as the [http://www.nmr-relax.com/api/3.3/lib.geometry.vectors-module.html#vector_angle_acos vector_angle_acos() ] and [http://www.nmr-relax.com/api/3.3/lib.geometry.vectors-module.html#vector_angle_atan2 vector_angle_atan2() ] functions.* Added 6 unit tests for the [http://www.nmr-relax.com/api/3.3/lib.geometry.vectors-module.html#vector_angle_acos lib.geometry.vectors.vector_angle_acos() function]. These are similar to those of the [http://www.nmr-relax.com/api/3.3/lib.geometry.vectors-module.html#vector_angle_normal vector_angle_normal() function ] but unsigned angles are checked for.* Created 6 unit tests for the [http://www.nmr-relax.com/api/3.3/lib.geometry.vectors-module.html#vector_angle_atan2 lib.geometry.vectors.vector_angle_atan2() function].

* Improved the printouts from the [http://www.nmr-relax.com/manual/align_tensor_svd.html align_tensor.svd user function ] by including the basis set text.* Updated the log file for comparing different alignment tensor basis sets for [http://www.nmr-relax.com/manual/align_tensor_svd.html align_tensor.svd ] changes.* Implemented a new default basis set for the align_tensor[http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function]. This is uses standard definition of the inter-matrix angle using the Euclidean inner product of the two matrices divided by the product of the Frobenius norm of each matrix. As this is a linear map, it should produce the correct definition of inter-tensor angles.* Improvements to the description of the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function].* Updated the test_matrix_angles_identity[http://www.nmr-relax.com/api/3.3/test_suite.unit_tests.align_tensor_testing_base.Align_tensor_base_class-class.html#test_matrix_angles_identity test_matrix_angles_identity() unit test ] for pipe_control[http://www.nmr-relax.com/api/3.3/pipe_control.align_tensor-module.html#matrix_angles pipe_control.align_tensor.matrix_angles()]. This is the test in the _prompt[http://www.test_align_tensornmr-relax.com/api/3.3/test_suite.unit_tests._prompt.test_align_tensor-module.html _prompt.test_align_tensor.Test_align_tensor module]. The basis set has been set back to the now non-default value of 0, and the value checks have been converted from assertEqual() to assertAlmostEqual() to allow for small truncation errors.* Conversion of the basis_set argument for the align_tensor[http://www.matrix_angles user nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function]. The argument is now a string that accepts the values of 'matrix', 'unitary 5D', and 'geometric 5D' to select between the different matrix angles techniques. This has been updated in the test suite as well.* Added a check for the values of the basis_set argument. This is to the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function ] backend.* Printout improvements clarifying the align_tensor[http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function].* Conversion of the basis_set argument for the [http://www.nmr-relax.com/manual/align_tensor_svd.html align_tensor.svd user function]. The argument is now a string that accepts the values of 'unitary 9D', 'unitary 5D', and 'geometric 5D' to select between the different SVD matrices. This has been updated in the test suite as well.* Expanded the N_state_model[http://www.nmr-relax.com/api/3.3/test_suite.system_tests.n_state_model.N_state_model-class.html#test_5_state_xz N_state_model.test_5_state_xz system test]. This now covers the new 'unitary 9D' basis set for the align_tensor[http://www.svd nmr-relax.com/manual/align_tensor_svd.html align_tensor.svd user function ] and the new 'matrix' basis set for the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function].* Expansion of the align_tensor[http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function]. The new basis set 'unitary 9D' has been introduced. This creates vectors as {SxxS_xx, SxyS_xy, SxzS_xz, Syx, Syy, SyzS_yx, S_yy, SzxS_yz, SzyS_zx, Szz} and computes the inter-vector anglesS_zy, S_zz} and computes the inter-vector angles. These match the 'matrix' basis set whereby the Euclidean inner product divided by the Frobenius norms is used to calculate the inter-tensor angles. In addition, the user function documentation and printouts have been improved. And the backend code has been simplified.* Updated the script and log file for demonstrating differences between alignment tensor basis sets. This now handles the changes to the basis_set arguments used in the align_tensor[http://www.matrix_angles and align_tensornmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles] and [http://www.nmr-relax.com/manual/align_tensor_svd.html align_tensor.svd ] user functions, and includes the new basis sets.* Added the irreducible tensor notation of {A_-2, A_-1, A0A₀, A1A₁, A2A₂} to the alignment tensor object. This follows from the definition of Sass et al, J. Am. Chem. Soc. 1999, 121, 2047-2055, [http://dx.doi.org/10.1021/ja983887wDOI: 10. 1021/ja983887w]. The equations of (2) were converted using Gaussian elimination to obtain a reduced row echelon form, so that the equations in terms of {A_-2, A_-1, A0A₀, A1A₁, A2A₂} were derived. These have been coded into the alignment tensor object calc_Am2, calc_Am1, calc_A0, calc_A1 and calc_A2 methods respectively, and the values can be obtained by accessing the Am2, Am1, A0, A1, and A2 objects. To check that the implementation is correct, a unit test has been created to compare the calculated values with those determined using Pales.* Expanded the unit test of the alignment tensor {A_-2, A_-1, A0A₀, A1A₁, A2A₂} parameters to cover all values.* Created functions in the relax library for calculating the inter-vector angle for complex vectors. This is in the [http://www.nmr-relax.com/api/3.3/lib.geometry.vectors -module. The function vector_angle_complex_conjugate() has been created to calculate the angle between two complex html lib.geometry.vectorsmodule]. This uses the new auxiliary The [function complex_inner_product() to calculate <v1|v2>http://www.* Added the 'irreducible 5D' basis set option to the align_tensornmr-relax.matrix_angles user functioncom/api/3. This is for 3/lib.geometry.vectors-module.html#vector_angle_complex_conjugate vector_angle_complex_conjugate()] has been created to calculate the inter-tensor vector angle for the irreducible 5D basis set {S-2, S-1, S0, S1, S2}between two complex vectors. Its results match that of This uses the standard tensor angle as well as the 'unitary 9D' basis sets[http://www.* Added the 'irreducible 5D' basis set option to the align_tensornmr-relax.svd user functioncom/api/3.3/lib.geometry. This is for the inter-tensor vector angle for the irreducible 5D basis set {Avectors-module.html#complex_inner_product new auxiliary function complex_inner_product()] to calculate <v₁|v_{2, A-1, A0, A1, A2}. Its results match that of the 'unitary 9D' basis set.}>.* Editing of the description for Added the 'irreducible 5D' alignment tensor basis set. This is for the option to the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles and align_tensor.svd user functionsfunction]. All Sm element have been converted to Am.* Editing of the description This is for the inter-tensor vector angle for the align_tensor.matrix_angles user function.* Editing of the align_tensor.svd user function description.* Updated the script and log file for demonstrating differences between alignment tensor basis sets. The 'irreducible 5Dirreducible 5D basis set {S_-2, S_-1, S₀, S₁, S₂}. Its results match that of the standard tensor angle as well as the 'unitary 9D' basis set in now used for both sets.* Added the 'irreducible 5D' basis set option to the align_tensor[http://www.nmr-relax.com/manual/align_tensor_svd.matrix_angles and html align_tensor.svd user functionsfunction].* Fix This is for a spelling mistake in the align_tensor.matrix_angles user function printouts.* Small fix inter-tensor vector angle for the align_tensor.matrix_angles user function documentation.* Expanded the N_state_model.test_5_state_xz system test for more alignment tensor basis setsirreducible 5D basis set {A_-2, A_-1, A₀, A₁, A₂}. The align_tensor.matrix_angles and align_tensor.svd user functions are now being called with Its results match that of the additional 'irreducible 5D', and 'unitary 9D' basis sets, to make sure these work correctly.set.* Created Editing of the description for the Align_tensor.test_align_tensor_matrix_angles system test'irreducible 5D' alignment tensor basis set. This is to check the angles calculated by for the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function] and [http://www.nmr-relax. As there are no external references, this essentially fixes the angles to the currently calculated values to catch any accidental changes in the futurecom/manual/align_tensor_svd.* Created the Align_tensor.test_align_tensor_svd system test. This is to check the angles calculated by the align_tensorhtml align_tensor.svd ] user functionfunctions. As there are no external references, this essentially fixes the singular values and condition numbers All S_m element have been converted to the currently calculated values to catch any accidental changes in the futureA_m.* Fixes Editing of the description for the proportions of the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angle matrix_angles user function GUI wizard].* Expanded Editing of the 'irreducible 5D' text in the align_tensor[http://www.nmr-relax.com/manual/align_tensor_svd.matrix_angles and html align_tensor.svd user functionsfunction] description. This now explains that these are the coefficients * Updated the script and log file for the spherical harmonic decompositiondemonstrating differences between alignment tensor basis sets.* Improved the text for the The 'irreducible tensor notation 5D' basis set in now used for both the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.display user functionmatrix_angles] and [http://www.* Formatting fix for the magnetic susceptibility tensor part of the nmr-relax.com/manual/align_tensor_svd.html align_tensor.display svd] user functionfunctions.* More improvements Fix for a spelling mistake in the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function description] printouts.* Epydoc docstring fixes and expansion Small fix for the lib[http://www.ionmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.sort_filenames() matrix_angles user function] documentation.* Epydoc docstring fixes for Expanded the lib[http://www.spectrumnmr-relax.nmrpipe modulecom/api/3. This is for the API documentation at http:3//wwwtest_suite.system_tests.n_state_model.nmrN_state_model-relax.com/api/indexclass.html#test_5_state_xz N_state_model.test_5_state_xz system test] for more alignment tensor basis sets. The show_apod_rmsd_to_file() and show_apod_rmsd_dir_to_files() function docstrings have both been modified[http://www.nmr-relax.* Epydoc docstring fixes for the pipe_controlcom/manual/align_tensor_matrix_angles.opendxhtml align_tensor.map() function. This is for matrix_angles] and [http://www.nmr-relax.com/apimanual/3align_tensor_svd.3/pipe_controlhtml align_tensor.opendx-module.html#map. The fixes include whitespace svd] user functions are now being called with the additional 'irreducible 5D', and textwrapping changes.'unitary 9D' basis sets, to make sure these work correctly.* Python 2.5 fix for Created the align_tensor[http://www.display user functionnmr-relax. The new irreducible spherical tensor coefficient printout was failing as the floatcom/api/3.real variable was introduced from Python 23/test_suite.6 onwardssystem_tests.* Shifted the structure checks into their own modulealign_tensor.Align_tensor-class.html#test_align_tensor_matrix_angles Align_tensor.test_align_tensor_matrix_angles system test]. This shifts is to check the angles calculated by the special check_structure Check object from pipe_control[http://www.nmr-relax.com/manual/align_tensor_matrix_angles.structurehtml align_tensor.main into the new checks modulematrix_angles user function]. It allows As there are no external references, this essentially fixes the angles to the check currently calculated values to be performed by other modules catch any accidental changes in the pipe_control.structure packagefuture.* Added Created the missing_error keyword argument to the pipe_centre_of_mass() function[http://www. This is from the pipe_controlnmr-relax.structurecom/api/3.mass module3/test_suite.system_tests.align_tensor.Align_tensor-class.html#test_align_tensor_svd Align_tensor.test_align_tensor_svd system test]. The new keyword controls what happens with This is to check the absence of structural dataangles calculated by the [http://www.nmr-relax.com/manual/align_tensor_svd.html align_tensor.svd user function]. As there are no external references, this essentially fixes the singular values and condition numbers to the currently calculated values to catch any accidental changes in the future.* Fixes for the proportions of the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function] GUI wizard.* Expanded the 'irreducible 5D' text in the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles] and [http://www.nmr-relax.com/manual/align_tensor_svd.html align_tensor.svd] user functions. This now explains that these are the coefficients for the spherical harmonic decomposition.* Improved the text for the irreducible tensor notation in the [http://www.nmr-relax.com/manual/align_tensor_display.html align_tensor.display user function].* Formatting fix for the magnetic susceptibility tensor part of the [http://www.nmr-relax.com/manual/align_tensor_display.html align_tensor.display user function].* More improvements for the [http://www.nmr-relax.com/manual/align_tensor_matrix_angles.html align_tensor.matrix_angles user function] description.* Epydoc docstring fixes and expansion for the [http://www.nmr-relax.com/api/3.3/lib.io-module.html#sort_filenames lib.io.sort_filenames() function].* Epydoc docstring fixes for the [http://www.nmr-relax.com/api/3.3/lib.spectrum.nmrpipe-module.html lib.spectrum.nmrpipe module]. This is for the [http://www.nmr-relax.com/api/index.html API documentation]. The [http://www.nmr-relax.com/api/3.3/lib.spectrum.nmrpipe-module.html#show_apod_rmsd_to_file show_apod_rmsd_to_file()] and [http://www.nmr-relax.com/api/3.3/lib.spectrum.nmrpipe-module.html#show_apod_rmsd_dir_to_files show_apod_rmsd_dir_to_files()] function docstrings have both been modified.* Epydoc docstring fixes for the [http://www.nmr-relax.com/api/3.3/pipe_control.opendx-module.html#map pipe_control.opendx.map() function]. The fixes include whitespace and textwrapping changes.* Python 2.5 fix for the [http://www.nmr-relax.com/manual/align_tensor_display.html align_tensor.display user function]. The new irreducible spherical tensor coefficient printout was failing as the float.real variable was introduced from Python 2.6 onwards.* Shifted the [http://www.nmr-relax.com/api/3.3/pipe_control.structure.checks-module.html structure checks into their own module]. This shifts the special check_structure Check object from [http://www.nmr-relax.com/api/3.3/pipe_control.structure.main-module.html pipe_control.structure.main] into the new checks module. It allows the check to be performed by other modules in the pipe_control.structure package.* Added the [http://www.nmr-relax.com/api/3.3/pipe_control.structure.mass-module.html#pipe_centre_of_mass missing_error keyword argument to the pipe_centre_of_mass() function]. This is from the [http://www.nmr-relax.com/api/3.3/pipe_control.structure.mass-module.html pipe_control.structure.mass module]. The new keyword controls what happens with the absence of structural data. The [http://www.nmr-relax.com/api/3.3/pipe_control.structure.checks-module.html#check_structure pipe_control.structure.checks.check_structure() function ] is now being used to either throw a warning and return [0, 0, 0] or to raise a RelaxError.

=== Bugfixes ===

* Fix for bug #22961 ([https://gna.org/bugs/?22961)bug #22961, the failure of relaxation data loading with the message "IndexError: list index out of range"]. The bug was found by Julien Orts. It is triggered by loading relaxation data from a file containing spin name information and supplying the spin ID using the spin name to restrict data loading to a spin subset. To solve the problem, the [http://www.nmr-relax.com/api/3.3/pipe_control.relax_data-module.html#pack_data pipe_control.relax_data.pack_data() function ] has been redesigned. Now the selection union concept of Chris MacRaild's selection object is being used by joining the spin ID constructed from the data file and the user supplied spin ID with '&', and using this to isolate the correct spin system.* Big Python 3 bug fix for the [http://www.nmr-relax.com/api/3.3/dep_check -module .html dep_check module] for the detection of the NMRPipe showApod software. The showApod program was falsely detected as always not being present when using Python 3. This is because the output of the program was being tested using string comparisons. However the output from programs obtained from the subprocess module is no longer strings but rather byte-arrays in Python 3. Therefore the byte-array is not being converted to text if Python 3 is being used, allowing the showApod software to be detected.* Python 3 bug fix for the [http://www.nmr-relax.com/api/3.3/lib.spectrum.nmrpipe-module.html#show_apod_extract lib.spectrum.nmrpipe.show_apod_extract() function]. The subprocess module output from the showApod program, or any software, is a byte array in Python 3 rather than text. This is now detected and the byte array converted to text before any processing.* Bug fix for the [http://www.nmr-relax.com/api/3.3/lib.structure.angles-module.html lib.structure.angles.angles_*() functions ] for odd increments. This affects the PDB representations of the diffusion tensor and frame order when the number of increments in the respective user functions is set to an odd number. It really only affects the [http://www.nmr-relax.com/manual/frame_order_pdb_model.html frame_order.pdb_model user functionsfunction], as the number of increments cannot be set in any of the other user functions ([http://www.nmr-relax.com/manual/structure_create_diff_tensor_pdb.html structure.create_diff_tensor_pdb], [http://www.nmr-relax.com/manual/structure_create_rotor_pdb.html structure.create_rotor_pdb], [http://www.nmr-relax.com/manual/structure_create_vector_dist.html structure.create_vector_dist], [http://www.nmr-relax.com/manual/n_state_model_cone_pdb.html n_state_model.cone_pdb]).

== Links ==

* [https://gna.org/forum/forum.php?forum_id=2481 2482 Gna! news item].

* [http://marc.info/?l=relax-announce&m=141617497420940141686534623578&w=2 Mailing list ARChives (MARC)].

== Announcements ==

== See also ==