Changes

{{infobox relax release| version = 3.3.2| prev = 3.3.1| next = 3.3.3| type = Minor feature and bugfix| date = 13 November 2014| manual = yes}} == Description ==

This is a minor feature and bugfix release. It includes improvements to the readability of the [http://www.nmr-relax.com/manual/index.html HTML version of the manual], improved printouts throughout the program, numerous GUI enhancements, and far greater Python 3 support. Please see below for a full listing of all the new features and bugfixes.

== Download ==

== CHANGES file ==

=== Features ===

=== Changes ===

* Updated the [{{minfx homepage}} minfx] version in the release checklist document to version 1.0.11.

* Added the write out of parameters and χ² values, when creating a dx_map. [https://{{gna.org/task/index.php?link|7860 |text=Task #7860: When dx_map is issued, create a parameter file which maps parameters to χ² value]}}.* Created [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.relax_disp.Relax_disp-class.html#test_dx_map_clustered_create_par_file system test Relax_disp.test_dx_map_clustered_create_par_file], which must show that relax is not able to find the local minimum under clustered conditions. When creating the map, the map contain χ² values, which are lower than the clustered fitted values. This should not be the case. Running a larger map with larger bounds and more increments, which should show that there exist a minimum in the minimisation space with a lower χ² value. [https://gna.org/bugs/index.php?22754 Bug #22754: The minimise.calculate() does not calculate χ² value for clustered residues]. [https://{{gna.org/task/index.php?link|7860 |text=Task #7860: When dx_map is issued, create a parameter file which maps parameters to χ² value]}}.

* Added example surface χ² values for plots. [https://{{gna.org/task/index.php?link|7826 |text=Task #7826: Write an python class for the repeated analysis of dispersion data]}}.

* Added boolean argument to [http://www.nmr-relax.com/manual/dx.map.html dx.map() user function], to specify the creation of a parameter and associated χ² values file. For very very special situations, the creation of this file is not desired.* Modified that structure of points in [http://www.nmr-relax.com/manual/dx.map() .html dx.map] is always a list of numpy arrays with 3 values.* When issuing [http://www.nmr-relax.com/manual/dx.map.html dx.map() user function ] with points, implemented the writing out of parameter file, with associated calculated χ² values.* Improved the feedback in the [http://www.nmr-relax.com/api/3.3/test_suite.gui_tests.test_user_functions.User_functions-class.html#test_structure_add_atom User_functions.test_structure_add_atom system GUI test]. It is now clearer what the input and output data is.

* Added check to [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.relax_disp.Relax_disp-class.html#test_cpmg_synthetic_dx_map_points system test Relax_disp.test_cpmg_synthetic_dx_map_points() ] for the creation of a matplotlib surface command plot file.

* Narrowed in dx_map in [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.relax_disp.Relax_disp-class.html#test_dx_map_clustered_create_par_file system test Relax_disp.test_dx_map_clustered_create_par_file()]. This is to illustrate the failure of relax finding the global minimum. It seems there is a shallow barrier, which relax failed to climb over, in order to find the minimum value.* Added the verbosity argument to the [http://www.nmr-relax.com/api/3.3/pipe_control.minimise-module.html#reset_min_stats pipe_control.minimise.reset_min_stats() function]. All of the minimisation code which calls this now send in their verbosity arguments. This allows the text "Resetting the minimisation statistics." to be suppressed.* Added the verbosity argument to the [http://www.nmr-relax.com/api/3.3/pipe_control.value-module.html#set pipe_control.value.set() function]. This is passed into the [http://www.nmr-relax.com/api/3.3/pipe_control.minimise-module.html#reset_min_stats pipe_control.minimise.reset_min_stats() function ] so its printouts can be silenced.* The pipe_control.opendx space mapping code now calls the [http://www.nmr-relax.com/api/3.3/pipe_control.value-module.html#set value.set() function ] with verbosity=0. This is to silence the very repetitive statistics resetting messages when executing the [http://www.nmr-relax.com/manual/dx_map.html dx.map user function].* Added more checks to the [http://www.nmr-relax.com/api/3.3/auto_analyses.dauvergne_protocol.dAuvergne_protocol-class.html#determine_rnd determine_rnd() of the dauvergne_protocol model-free auto-analysis]. This is to try to catch bizarre situations such as [https://gna.org/bugs/?22730 bug #22730, model-free auto-analysis - relax stops and quits at the polate step]. The following additional fatal conditions are now checked for: A file with the same name as the base model directory already exists; The base model directory is not readable; The base model directory is not writable. The last two could be caused by file system corruptions. In addition, the presence of the base model directory is checked for using os.path.isdir() rather than catching errors coming out of the os.listdir() function. These changes should make the analysis more robust in the presence of 'strangeness'.* Added an additional check to [http://www.nmr-relax.com/api/3.3/auto_analyses.dauvergne_protocol.dAuvergne_protocol-class.html#determine_rnd determine_rnd() of the dauvergne_protocol model-free auto-analysis]. This is to try to catch bizarre situations such as [https://gna.org/bugs/?22730 bug #22730, model-free auto-analysis - relax stops and quits at the polate step]. The additional check is that if the base model directory is not executable, a RelaxError is raised.* Added printouts to the [http://www.nmr-relax.com/api/3.3/auto_analyses.dauvergne_protocol.dAuvergne_protocol-class.html#determine_rnd determine_rnd() function of the dauvergne_protocol model-free auto-analysis]. This is for better user feedback in the log files as to what is happening. It may help in debugging [https://gna.org/bugs/?22730 bug #22730: Model-free auto-analysis - relax stops and quits at the polate step].* Alphabetical ordering of imports in the [http://www.nmr-relax.com/api/3.3/auto_analyses.dauvergne_protocol-module.html dauvergne_protocol model-free auto-analysis].* Changed the model-free single spin optimisation title printouts. The [http://www.nmr-relax.com/api/3.2/specific_analyses.model_free.optimisation-module.html#spin_print specific_analyses.model_free.optimisation.spin_print() function ] has been deleted. It has instead been replaced by a call to [http://www.nmr-relax.com/api/3.3/lib.text.sectioning-module.html#subtitle lib.text.sectioning.subtitle()]. This is to match the grid search setup title printouts and to differentiate these titles from those printed out by [{{minfx homepage}} minfx] being underlined by '~' characters.* Added extensive sectioning printouts to the [http://www.nmr-relax.com/api/3.3/auto_analyses.dauvergne_protocol-module.html dauvergne_protocol model-free auto-analysis]. The [http://www.nmr-relax.com/api/3.3/lib.text.sectioning-module.html lib.text.section sectioning] functions title() and subtitle() are now used to mark out all parts of the auto-analysis. This will allow for a much better understanding of the log files produced by this auto-analysis.

* Modified the behaviour of the relax controller window so that pressing escape closes the window. This involves setting the initial focus on the LogCtrl, and catching the ESC key press in the LogCtrl as well as all relax controller read only wx.Field elements and calling the parent [http://www.nmr-relax.com/api/3.3/gui.controller.Controller-class.html#handler_close controller handle_close() method].* Replaced the hardcoded integer keycodes in the relax controller with the wx variables. This is for the [http://www.nmr-relax.com/api/3.3/gui.controller.LogCtrl-class.html#capture_keys LogCtrl.capture_keys() handler method for dealing with key presses].

* The ESC character now closes all wizards and user functions in the relax GUI. By using an accelerator table set to the entire wizard window to catch the ESC keyboard event, the ESC key will cause the [http://www.nmr-relax.com/api/3.3/gui.wizards.wiz_objects.Wiz_window-class.html#_handler_escape _handler_escape() method ] to be called which then calls the windows Close() method to close the window.* Changed the logic for how the new analysis wizard in the GUI is destroyed. This relates to [https://gna.org/bugs/?22818 bug #22818, the GUI test suite failures in MS Windows - PyAssertionError: C++ assertion "Assert failure"]. The [http://www.nmr-relax.com/api/3.3/gui.analyses.wizard.Analysis_wizard-class.html#Destroy Destroy() method has been added to the Analysis_wizard class ] to properly close all elements of the wizard. This is now called from the [http://www.nmr-relax.com/api/3.3/gui.analyses.Analysis_controller-class.html#menu_new menu_new() method of the Analysis_controller class], which is the target of the menu item and toolbar button. To allow the test suite to use this, the menu_new() method now accepts the destroy boolean argument. The test suite can set this to False and then access the GUI elements after calling the method (however the Destroy() method must be called by the test suite).

* Fix for the [http://www.nmr-relax.com/api/3.3/gui.fonts-module.html gui.fonts module ] to allow it to be used outside of the GUI.

* The [http://www.nmr-relax.com/api/3.3/gui.misc-module.html#bitmap_setup gui.misc.bitmap_setup() function ] can now be used outside of the GUI.* Fix for the [http://www.nmr-relax.com/api/3.3/test_suite.gui_tests.base_classes.GuiTestCase-class.html#new_analysis_wizard GUI test base class new_analysis_wizard() method ] for relaxation dispersion analyses.* Modified the [http://www.nmr-relax.com/api/3.3/pipe_control.pipes-module.html#get_bundle pipe_control.pipes.get_bundle() function ] to operate when no pipe is supplied. In this case, the pipe bundle that the current data pipe belongs to will be returned.* Created the [http://www.nmr-relax.com/api/3.3/lib.periodic_table.Periodic_table-class.html#has_element Periodic_table.has_element() method ] for the [http://www.nmr-relax.com/api/3.3/lib.periodic_table-module.html lib.periodic_table module]. This is used to simply check if a given symbol exists as an atom in the periodic table.* Added 4 unit tests to the _lib.test_periodic_table module for the [http://www.nmr-relax.com/api/3.3/lib.periodic_table.Periodic_table-class.html#has_element Periodic_table.has_element() method].* Modified the internal structural object backend for the [http://www.nmr-relax.com/manual/structure_read_pdb.html structure.read_pdb user function]. The [http://www.nmr-relax.com/api/3.3/lib.structure.internal.molecules.MolContainer-class.html#_det_pdb_element MolContainer._det_pdb_element() method ] for handling PDB files with missing element information has been updated to use the [http://www.nmr-relax.com/api/3.3/lib.periodic_table.Periodic_table-class.html#has_element Periodic_table.has_element() method ] to check if the PDB atom name corresponds to any atoms in the periodic table. This allows for far greater support for HETATOMS and all of the metals.* Created the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.structure.Structure-class.html#test_load_spins_multi_mol Structure.test_load_spins_multi_mol system test]. This is to test yet to be implemented functionality of the [http://www.nmr-relax.com/manual/structure_load_spins.html structure.load_spins user function]. This is the loading of spin information similar, but not necessarily identical molecules all loaded into the same structural model. For this, the from_mols argument will be added.* Fixes for the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.structure.Structure-class.html#test_load_spins_multi_mol Structure.test_load_spins_multi_mol system test]. The call to the [http://www.nmr-relax.com/manual/structure_load_spins.html structure.load_spins user function] has also been modified so that all 3 spins are loaded at the same time.* Implemented the multiple molecule merging functionality of the [http://www.nmr-relax.com/manual/structure_load_spins.html structure.load_spins user function]. The argument has been added to the user function frontend and a description added for this new functionality. In the backend, the [http://www.nmr-relax.com/api/3.3/pipe_control.structure.main-module.html#load_spins pipe_control.structure.main.load_spins() function ] will now call the [http://www.nmr-relax.com/api/3.3/pipe_control.structure.main-module.html#load_spins_multi_mol load_spins_multi_mol() function ] if from_mols is supplied. This alternative function is required to handle missing atoms and differential atom numbering.* Modified the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.n_state_model.N_state_model-class.html#test_populations N_state_model.test_populations system test ] to test the grid search code paths. This performs a grid search of one increment after minimisation, then switches to the 'fixed' N-state model and performs a second grid search of one increment. This now tests currently untested code paths in the [http://www.nmr-relax.com/api/3.3/specific_analyses.n_state_model.api.N_state_model-class.html#grid_search grid_search() API method ] behind the [http://www.nmr-relax.com/manual/minimise_grid_search.html minimise.grid_search user function]. The test demonstrates a bug in the N-state model which was not uncovered in the test suite.* Created the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.n_state_model.N_state_model-class.html#test_CaM_IQ_tensor_fit N_state_model.test_CaM_IQ_tensor_fit system test]. This is for catching [https://gna.org/bugs/?22849 bug #22849, the failure of the N-state model analysis when optimising only alignment tensors using RDCs and/or PCSs]. This new test checks code paths unchecked in the rest of the test suite, and is therefore of high value.* Modified the atomic position handling in [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.structure.Structure-class.html#test_load_spins_multi_mol pipe_control.structure.main.load_spins_multi_mol()]. The multiple molecule merging functionality of the [http://www.nmr-relax.com/manual/structure_load_spins.html structure.load_spins user function] now handles missing atomic positions differently. The aim is that the length of the spin container position variable is fixed for all spins to the number of structures, as the N-state model analysis assumes this equal length for all spins. When data is missing, the atomic position for that structure is now set to None. This will require other modifications in relax to support this new design.

* Fix for the atomic position handling in [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.structure.Structure-class.html#test_load_spins_multi_mol pipe_control.structure.main.load_spins_multi_mol()]. The dimensionality of the position structure returned by the [http://www.nmr-relax.com/api/3.3/lib.structure.internal.object.Internal-class.html#atom_loop structural object atom_loop() method ] needed to be reduced.

* Clean up and speed up of the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.n_state_model.N_state_model-class.html#test_CaM_IQ_tensor_fit N_state_model.test_CaM_IQ_tensor_fit system test]. All output files are now set to 'devnull' so that the system test no longer creates any files within the relax source directories. And the optimisation settings have been decreased to hugely speed up the system test.* Expanded the [http://www.nmr-relax.com/api/3.3/lib.arg_check-module.html#is_float_matrix lib.arg_check.is_float_matrix() function ] by adding the none_elements argument. This matches a number of the other module functions, and allows for entire rows of the matrix to be None.* Lists of lists containing rows of None are now better supported by the [http://www.nmr-relax.com/api/3.3/lib.xml-module.html lib.xml ] functions. The [http://www.nmr-relax.com/api/3.3/lib.xml-module.html#object_to_xml object_to_xml() function ] will now convert the float parts to IEEE-754 byte arrays, and the None parts will be stored as None in the <ieee_754_byte_array> list node. The matching [http://www.nmr-relax.com/api/3.3/lib.xml-module.html#xml_to_object xml_to_object() method function] has also been modified to read in this new node format. This affects the [http://www.nmr-relax.com/manual/results_write.html results.write] and [http://www.nmr-relax.com/manual/state_save.html state.save] user functions (as well as the [http://www.nmr-relax.com/manual/results_read.html results.read] and [http://www.nmr-relax.com/manual/state_load.html state.load] user functions).

* Speed up of the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.n_state_model.N_state_model-class.html#test_CaM_IQ_tensor_fit N_state_model.test_CaM_IQ_tensor_fit system test]. This test is however still far too slow.* Added printouts to [http://www.nmr-relax.com/api/3.3/pipe_control.pcs-module.html#return_pcs_data pipe_control.pcs.return_pcs_data() ] and [http://www.nmr-relax.com/api/3.3/pipe_control.rdc-module.html#return_rdc_data pipe_control.rdc.return_rdc_data()]. These functions now accept the verbosity argument which if greater than 0 will activate printouts of how many RDCs or PCSs have been assembled for each alignment. This will be useful for user feedback as the spin verses interatomic data container selections can be difficult to understand.* The verbosity argument for the N-state model optimisation is now propagated for more printouts. The argument for the [http://www.nmr-relax.com/api/3.3/specific_analyses.n_state_model.api.N_state_model-class.html#calculate calculate() ] and [http://www.nmr-relax.com/api/3.3/specific_analyses.n_state_model.api.N_state_model-class.html#minimise minimise() ] API methods is now sent into [http://www.nmr-relax.com/api/3.3/specific_analyses.n_state_model.optimisation-module.html#target_fn_setup specific_analyses.n_state_model.optimisation.target_fn_setup()], and from there into the [http://www.nmr-relax.com/api/3.3/pipe_control.pcs-module.html#return_pcs_data pipe_control.pcs.return_pcs_data() ] and [http://www.nmr-relax.com/api/3.3/pipe_control.rdc-module.html#return_rdc_data pipe_control.rdc.return_rdc_data() ] functions. That way the number of RDCs and PCSs used in the N-state model is reported back to the user for better feedback.* Updated the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.n_state_model.N_state_model-class.html#test_CaM_IQ_tensor_fit N_state_model.test_CaM_IQ_tensor_fit system test ] so it operates correctly as a GUI test. All user functions are now executed through the special self._execute_uf() method to allow either the prompt interpreter or the GUI to execute the user function.* Modified the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.n_state_model.N_state_model-class.html#test_CaM_IQ_tensor_fit N_state_model.test_CaM_IQ_tensor_fit system/GUI test ] for implementing a new feature. The 'spin_selection' argument has been added to the [http://www.nmr-relax.com/manual/interatom_define.html interatom.define user function]. This will be used to carry the spin selections over into the interatomic data containers.

* Modified the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.structure.Structure-class.html#test_load_spins_multi_mol Structure.test_load_spins_multi_mol system test ] for the spin.pos variable changes. The atomic position for an ensemble of structures is now set to None rather than being missing, so the system test has been updated to check for this.* The [http://www.nmr-relax.com/manual/align_tensor_display.html align_tensor.display user function] now has more consistent section formatting. The section() and subsection() functions of the [http://www.nmr-relax.com/api/3.3/lib.text.sectioning -module .html lib.text.sectioning module] are now being used to standardise these custom printouts with the rest of relax.* Modifications to the new [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.n_state_model.N_state_model-class.html#test_CaM_IQ_tensor_fit N_state_model.test_CaM_IQ_tensor_fit system test]. The system test now checks all of the optimised values to make sure the correct values have been found. That will block any future regressions in this N-state model code path. The system test is now also faster. And the [http://www.nmr-relax.com/manual/pcs_structural_noise.html pcs.structural_noise user function] RMSD value has been set to 0.0 so that the test no longer has a random component affecting the final optimised values.

* Created the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.structure.Structure-class.html#test_bug_22860_CoM_after_deletion Structure.test_bug_22860_CoM_after_deletion system test]. This is to catch [https://gna.org/bugs/?22860 bug #22860, the failure of the structure.com user function after calling structure.delete].* Fix for the checks in the new [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.structure.Structure-class.html#test_load_spins_multi_mol Structure.test_load_spins_multi_mol system test]. A spin index was incorrect.* Fix for the [http://www.nmr-relax.com/manual/structure_load_spins.html structure.load_spins user function] when the from_mols argument is used. The [http://www.nmr-relax.com/api/3.3/pipe_control.structure.main-module.html#load_spins_multi_mol load_spins_multi_mol() function ] of the [http://www.nmr-relax.com/api/3.3/pipe_control.structure.main -module .html pipe_control.structure.main module] was incorrectly handling the atomic position returned by the [http://www.nmr-relax.com/api/3.3/lib.structure.internal.object.Internal-class.html#atom_loop internal structural object atom_loop() method]. This position is a list of lists when multiple models are present. But when only a single model is present, it returns a simple list.* Modified the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.structure.Structure-class.html#test_bug_22860_CoM_after_deletion Structure.test_bug_22860_CoM_after_deletion system test ] to expect a RelaxNoPdbError. This tests that the [http://www.nmr-relax.com/manual/structure_com.html structure.com user function] raises RelaxNoPdbError after deleting all of the structural information from the current data pipe.

* Created the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.structure.Structure-class.html#test_bug_22861_PDB_writing_chainID_fail Structure.test_bug_22861_PDB_writing_chainID_fail system test]. This is to catch [https://gna.org/bugs/?22861 bug #22861, the chain IDs in the structure.write_pdb user function PDB files are incorrect after calling structure.delete].* Small modification of the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.structure.Structure-class.html#test_bug_22861_PDB_writing_chainID_fail Structure.test_bug_22861_PDB_writing_chainID_fail system test]. File metadata is now being set to demonstrate that the [http://www.nmr-relax.com/manual/structure_delete.html structure.delete user function] does not remove this once there is no more data left for the molecule.

* Fix for [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.relax_disp.Relax_disp-class.html#test_cpmg_synthetic_dx_map_points system test Relax_disp.test_cpmg_synthetic_dx_map_points]. Another import line was written to the matplotlib script.* Speedup and fix for [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.relax_disp.Relax_disp-class.html#test_dx_map_clustered_create_par_file system test Relax_disp.test_dx_map_clustered_create_par_file]. The following test was taken out, since this a particular interesting case. There exist a double minimum, where relax has not found the global minimum. This is due to not grid searching for R_a², but using the minimum value.* Removed debugging code from the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.n_state_model.N_state_model-class.html#test_CaM_IQ_tensor_fit N_state_model.test_CaM_IQ_tensor_fit system test]. This was an accidentally introduced [http://www.nmr-relax.com/manual/state_save.html state.save user function] used to catch the system test state. It would results in the 'x.bz2' file being dumped in the current directory.* Loosened the checks in the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.relax_disp.Relax_disp-class.html#test_baldwin_synthetic_full Relax_disp.test_baldwin_synthetic_full system test]. This is to allow the test to pass on Python 2.5 and 3.1 on a 32-bit GNU/Linux system.* Fix for the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.relax_disp.Relax_disp-class.html#test_cpmg_synthetic_dx_map_points Relax_disp.test_cpmg_synthetic_dx_map_points system test ] for certain systems. This change is to allow the test to pass on Python 2.5 and 3.1 on a 32-bit GNU/Linux system. This may be related to 32-bit numpy 1.6.2 verses later numpy versions causing precision differences.* Fixes for the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.relax_disp.Relax_disp-class.html#test_hansen_cpmg_data_missing_auto_analysis Relax_disp.test_hansen_cpmg_data_missing_auto_analysis system test ] for certain systems. The optimisation precision has been increased, and the value checking precision has been decreased. This change is to allow the test to pass on Python 2.5 and 3.1 on a 32-bit GNU/Linux system. This may be related to 32-bit numpy 1.6.2 verses later numpy versions causing precision differences.

* The [http://www.nmr-relax.com/api/3.3/target_functions.relax_fit-module.html target_function.relax_fit module ] unit tests are now skipped if the C module is not compiled.

* The [http://www.nmr-relax.com/api/3.3/lib.errors -module .html lib.errors module] is now importing lib.compat.pickle for better Python 2 and 3 support. This shifts the compatibility code from lib.errors into [http://www.nmr-relax.com/api/3.3/lib.compat-module.html lib.compat ] so that the 2to3 program will not touch the [http://www.nmr-relax.com/api/3.3/lib.errors-module.html lib.errors module].

* The [http://www.nmr-relax.com/api/3.3/lib.check_types-module.html lib.check_types module] now imports io.IOBase from the [http://www.nmr-relax.com/api/3.3/lib.compat-module.html lib.compat module]. This is to shift more Python 2 vs. 3 compatibility into lib.compat and out of all other modules.* Python 3 improvements - changed how the Python 3 absent builtins.unicode() function is handled. The aliased builtins.str() function is now referenced as lib.compat.unicode(). The Python 2 __builtin__.unicode() function is also aliased to lib.compat.unicode(). The GUI using this function now import it from [http://www.nmr-relax.com/api/3.3/lib.compat-module.html lib.compat].* Removed the [http://www.nmr-relax.com/api/3.3/auto_analyses.dauvergne_protocol-pysrc.html#dAuvergne_protocol.determine_rnd writable base directory check in the dauvergne_protocol auto-analysis]. This check was causing the system test to fail if the user does not have write access to the installed relax directory.

* Important bug fix for racing causing the GUI to freeze. This is really only seen in the GUI tests on MS Windows systems, as a user could never be fast enough with the mouse. The [http://www.nmr-relax.com/api/3.3/gui.interpreter.Interpreter-class.html#flush GUI interpreter flush() method ] for ensuring that all user functions in the queue have been cleared now calls wx.Yield() to force all wxPython events to also be flushed. This change will avoid random freezing of the relax test suite.* Bug fix for the [http://www.nmr-relax.com/api/3.3/test_suite.gui_tests.model_free.Mf-class.html#test_bug_21615_incomplete_setup_failure Mf.test_bug_21615_incomplete_setup_failure GUI test ] on MS Windows systems. The [http://www.nmr-relax.com/api/3.3/gui.interpreter.Interpreter-class.html#flush GUI interpreter flush() method ] needs to be called between the two [http://www.nmr-relax.com/manual/structure_load_spins.html structure.load_spins user function] calls. Without this, the test will freeze on MS Windows. The freezing behaviour is however not 100% reproducible and is dependent on the Windows version and wxPython version.

* Menus created by the [http://www.nmr-relax.com/api/3.3/gui.components.menu-module.html#build_menu_item gui.components.menu.build_menu_item() ] now default to the wx ID of -1. This is to conserve wx IDs. If the calling code does not provide the ID, there is no need to grab one from the small pool of IDs.* Shifted the [http://www.nmr-relax.com/api/3.3/gui.spin_viewer.tree-module.html spin viewer GUI window toolbar button wx IDs to the module namespace]. This should conserve wx IDs as the window is created and destroyed, as only 2 IDs will be taken from the small pool for the entire lifetime of the program.* Shifted all of the [http://www.nmr-relax.com/api/3.3/gui.analyses.wizard-module.html wx.NewId() calls for the new analysis wizard into the module namespace]. This will hugely save the number of wx IDs used by the GUI, especially in the test suite. Instead of grabbing 8 IDs from the small pool every time the new analysis wizard is created, only 8 IDs for the lifetime of the program will be used.

* Bug fix for the [http://www.nmr-relax.com/manual/structure_load_spins.html structure.load_spins user function] new from_mols argument. This was incorrectly using the [http://www.nmr-relax.com/api/3.3/pipe_control.pipes-module.html#pipe_names pipe_control.pipes.pipe_names() function ] to obtain its default values in the GUI (although this is not currently uesd). The result was a non-fatal error message on Mac OS X systems of "Python[1065:1d03] *** __NSAutoreleaseNoPool(): Object 0x3a3944c of class NSCFString autoreleased with no pool in place - just leaking".

* Created the blacklisted [http://www.nmr-relax.com/api/3.3/test_suite.gui_tests.noe.Noe-class.html#test_noe_analysis_memory_leaks Noe.test_noe_analysis_memory_leaks GUI test]. This long test can be manually run to help chase down memory leaks. This can be monitored using the MS Windows task manager, once the 'USER Objects' column is shown. If the USER Objects count reaches 10,000 in Windows, then no more GUI elements can be created and the user will see errors.* Added a printout to the [http://www.nmr-relax.com/api/3.3/test_suite.gui_tests.noe.Noe-class.html#test_noe_analysis_memory_leaks Noe.test_noe_analysis_memory_leaks GUI test ] to help with debugging.* Improved debugging printouts for the [http://www.nmr-relax.com/api/3.3/test_suite.gui_tests.noe.Noe-class.html#test_noe_analysis_memory_leaks Noe.test_noe_analysis_memory_leaks GUI test].* Small fix for the [http://www.nmr-relax.com/api/3.3/gui.analyses.Analysis_controller-class.html#delete_analysis GUI analysis deletion method ] to prevent racing in the GUI tests.* Redesigned how wizards are destroyed in the GUI. The [http://www.nmr-relax.com/api/3.3/gui.wizards.wiz_objects.Wiz_window-class.html#Destroy relax wizard Destroy() method ] is now overridden. This allows the buttons in the wizard to be properly destroyed, as well as all wizard pages. This should remove a lot of GUI memory leaks.* Created the [http://www.nmr-relax.com/api/3.3/test_suite.gui_tests.general.General-class.html#test_new_analysis_wizard_memory_leak General.test_new_analysis_wizard_memory_leak blacklisted GUI test]. This will be used to check for memory leaks in the new analysis wizard.

* Added a wx.Yield() before destroying the new analysis wizard via [http://www.nmr-relax.com/api/3.3/gui.analyses.Analysis_controller-class.html#menu_new menu_new()]. This is to avoid racing which can be triggered in the test suite.

=== Bugfixes ===

* Fix for the poorly written [http://www.nmr-relax.com/api/3.3/test_suite.gui_tests.test_user_functions.User_functions-class.html#test_structure_add_atom User_functions.test_structure_add_atom GUI test]. This fixes one part of 2 of the [https://gna.org/bugs/?22772 bug #22772, the modelfree4 binary issue and the User_functions GUI tests with wxPython 2.9 failures of the test suite]. The problem was that a list element was being set in the GUI test, but that element did not exist yet. Somehow this worked in wxPython 2.8. But the bad code failed on wxPython 2.9.* Updated the [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.palmer.Palmer-class.html#test_palmer_omp Palmer.test_palmer_omp system test ] for the 64-bit Linux Modelfree 4.20 GCC binary file. This fixes the second part and last part of the [https://gna.org/bugs/?22772 bug #22772, the modelfree4 binary issue and the User_functions GUI tests with wxPython 2.9 failures of the test suite]. The problem is that the 64-bit GNU/Linux GCC compiled binary of Modelfree 4.20 produces different results as previous versions. These are now caught by the system test and correctly checked.

* Fix for find dialog in the relax controller window. This is for [https://gna.org/bugs/?22816 bug #22816, the find functionality of the relax controller window does not find text when using wxPython >= 2.9]. The find wxPython events are now bound to the find dialog rather than the [http://www.nmr-relax.com/api/3.3/gui.controller.LogCtrl-class.html relax controller window LogCtrl element for displaying the relax messages]. This works on all wxPython versions.

* Bug fix for the N-state model grid search when only alignment tensor parameters are optimised. The algorithm for splitting up the grid search to optimise each tensor separately, hence massively collapsing the dimensionality of the problem, was being performed incorrectly. The [http://www.nmr-relax.com/api/3.3/specific_analyses.n_state_model.api.N_state_model-class.html#grid_search grid_search() API method ] inc, lower, and upper arguments are lists of lists, but were only being treated as lists.* Final fix for [https://gna.org/bugs/?22849 bug #22849, the failure of the N-state model analysis when optimising only alignment tensors using RDCs and/or PCSs]. The alignment tensor is no longer initialised to zero values. This is to allow the skip_preset argument for the [http://www.nmr-relax.com/manual/minimise_grid_search.html minimise.grid_search user function] to be operational for the N-state model, a feature introduced with the zooming grid search. The solution was to check for the uninitialised tensor in the [http://www.nmr-relax.com/api/3.3/specific_analyses.n_state_model.optimisation-module.html#minimise_setup_fixed_tensors minimise_setup_fixed_tensors() method ] of the [http://www.nmr-relax.com/api/3.3/specific_analyses.n_state_model.optimisation -module.html specific_analyses.n_state_model.optimisation module].* Bug fix for the [http://www.nmr-relax.com/api/3.3/lib.arg_check-module.html#is_float_matrix lib.arg_check.is_float_matrix() function]. The check for a numpy.ndarray data structure type was incorrect so that lists of numpy arrays were failing in this function. Rank-2 arrays were not affected.

* The [http://www.nmr-relax.com/manual/structure_write_pdb.html structure.write_pdb user function] can now handle empty molecules. This fixes [https://gna.org/bugs/?22861 bug #22861, the chain IDs in the structure.write_pdb user function PDB files are incorrect after calling structure.delete]. To handle this consistently, the [http://www.nmr-relax.com/api/3.3/lib.structure.internal.models.ModelContainer-class.html#mol_loop internal structural object ModelContainer.mol_loop() generator method ] has been created. This loops over the molecules, yielding those that are not empty. The [http://www.nmr-relax.com/api/3.3/lib.structure.internal.molecules.MolContainer-class.html#is_empty MolContainer.is_empty() method ] has been fixed by not checking for the molecule name, as that remains after the [http://www.nmr-relax.com/manual/structure_delete.html structure.delete user function] call while all other information has been removed. And finally the [http://www.nmr-relax.com/api/3.3/lib.structure.internal.object.Internal-class.html#write_pdb write_pdb() structural object method ] has been modified to use the [http://www.nmr-relax.com/api/3.3/lib.structure.internal.models.ModelContainer-class.html#mol_loop mol_loop() method ] rather than performing the loop itself.

* Fix for [http://www.nmr-relax.com/api/3.3/test_suite.system_tests.relax_disp.Relax_disp-class.html#test_bug_atul_srivastava system test Relax_disp.test_bug_atul_srivastava]. The call to the expected RelaxError needed to be performed differently for erlier python versions that 2.7.

== Links ==

* [http://wiki.nmr-relax.com/Relax_3.3.1 2 Official release notes on the relax wiki].* [https://{{gna link|url=gna.org/forum/forum.php?forum_id=2478 2481|text=Gna! news item]}}.* [http://article.gmane.org/gmane.science.nmr.relax.announce/59 60 Gmane mailing list archive].* [http://www.mail-archive.com/relax-announce%40gna.org/msg00050msg00051.html The Mail Archive].* [https://mail.gna.org/public/relax-announce/2014-1011/msg00000.html Local archives].* [http://marc.info/?l=relax-announce&m=141289520301920141617497420939&w=2 Mailing list ARChives (MARC)].

== Announcements ==

== See also ==