View source for Using Matlab and access to sample Matlab scripts

Matlab packages for Inelastic Scattering data analysis used in ISIS include [http://horace.isis.rl.ac.uk/Main_Page Horace] and [http://mslice.isis.rl.ac.uk/Main_Page Mslice]. The packages have home pages with extensive descriptions, but most recent and useful sample scripts are provided to users on the file system using  '''HoraceExampleScripts''' folder, placed on IDAaaS users desktop at: 

  /mnt/nomachine/resources/HoraceExampleScripts 

also available through ''Applications->Examples->Horace Scripts'' link on IDAaaS virtual machine interface. 


[https://isis.analysis.stfc.ac.uk/workspaces/ IDAaaS] servers provide users with access to recent version of [http://uk.mathworks.com/products/matlab/ Matlab] and substantial number of floating licenses sufficient for users doing experiments and data analysis

<!--
The state of the Matlab licenses, licensing issues and number of available licenses can be checked using simple bash script (command):

 #!/bin/bash
 # check network license for Matlab
 /usr/local/MATLAB/R2014a/etc/glnxa64/lmutil lmstat -c /usr/local/MATLAB/R2014a/licenses/network.lic -a

Horace and Mslice are configured to be accessible from Matlab in two ways: 

*Using ''startup.m'' file, which is copied to each user home folder when user account is created. See the description of ''startup.m'' file at [http://mslice.isis.rl.ac.uk/Download_and_setup_MSlice Mslice] and [http://horace.isis.rl.ac.uk/Download_and_setup#Standard_Installation Horace] configuration pages for the detailed description of this file contents. 
*By adding special [http://horace.isis.rl.ac.uk/Download_and_setup#Installation_with_Horace_not_initialised_by_default_on_starting_Matlab ''horace_on''] and similar ''mslice_on'' scripts to Matlab default search path. The scripts are doing roughly the same as ''startup.m'' file but allow user to initialize [http://horace.isis.rl.ac.uk/Main_Page Horace] and [http://mslice.isis.rl.ac.uk/Main_Page Mslice] from arbitrary folder user wants to start Matlab from (not only from his or her home folder) and allows user to reinitialize these packages. This may be convenient for dealing with some errors in the analysis packages or when trying to resolve ''out of memory'' situations.
-->

=== Configuring Matlab to access ''horace_on'' and ''mslice_on'' scripts ===

The installation process for Horace and Mslice described in details on [https://pace-neutrons.github.io/Horace Horace] and [http://mslice.isis.rl.ac.uk/Main_Page Mslice] installation pages.

<!--

Configuring Matlab to access ''horace_on'' and ''mslice_on'' scripts on [http://isiscompute.nd.rl.ac.uk isiscompute] server requests superuser access and involves the following steps: 

One needs to go to matlab installation folder e.g.

  /usr/local/MATLAB/R2015b/toolbox/local/

and edit ''pathdef.m'' file:

  sudo vim pathdef.m

where find the rows:

 p=[...
 %%% BEGIN ENTRIES %%%
 matlabroot,'/toolbox/matlab/lang:',...

and modify them  as follows:

 p=[...
 %%% BEGIN ENTRIES %%%
 <span style="color:#00ff00>'/usr/local/mprogs/Users:', ...</span>
  matlabroot,'/toolbox/matlab/lang:',


where ''/usr/local/mprogs/Users'' folder is the folder where appropriately configured ''horace_on'' and ''mslice_on'' scripts can be found. See [http://horace.isis.rl.ac.uk/Download_and_setup#Installation_with_Horace_not_initialised_by_default_on_starting_Matlab Configure Horace]  and [http://mslice.isis.rl.ac.uk/Download_and_setup_MSlice Configuring Mslice] for details on how to configure these scripts. Note, that the syntax of the changes to ''pathdef.m'' has to be exact to avoid problem with Matlab components search path.

=== Configuring Matlab 2015b to work with gcc8.4.5 for combining using mex code on RHEL7 === 

By default, Maltab 2015b mex code works with GCC4.7 but RHEL 7 default compiler is GCC4.8 and downgrading to gcc 4.7 is not straightforward. 
From other side, the table below shows, that using mex code for combining files on [http://isiscompute.nd.rl.ac.uk isiscompute] cluster is very beneficial:

{| class="wikitable" style="text-align: center;"
|+Combining sqw files on isiscompute server
|-
! Code and settings
! Combining speed Mb/s
! Time to combine 142Gb (min)
! use_mex_for_combine<sup><span style="color:blue">1)</span></sup>
! mex_combine_thread_mode 
|-
| Matlab 2015b, buffer N/A
| 67
| 37
| false
| N/A
|-
| combine_sqw.mex. buffer 1024, 
| 598
| 4
| true
| 1
|-
| combine_sqw.mex. buffer 1024
| 517
| 5
| true 
| 0
|}

Notes:
   <sup><span style="color:blue">1)</span></sup>The thread mode is set up by Horace setup command: 
    '''set(hor_config,<span style="color:brown">'use_mex_for_combine',1,'mex_combine_thread_mode',1</span>)'''; 
    See [http://horace.isis.rl.ac.uk/Download_and_setup#Enabling_multi-sessions_processing Horace setup] for the details of configuring Horace to use mex files.

Apparently, one can use gcc 4.8 compiler, but to use multi-threaded combining, the following changes have to be done for Matlab 2015b, assuming Matlab and gcc4.8 are installed in the system in default locations.

  >>cd /usr/local/MATLAB/R2015b/sys/os/glnxa64
  >>rm libstdc++.so.6 
  >>ln -s /usr/lib64/libstdc++.so.6.0.19 libstdc++.so.6

The change causes no known negative effects on Matlab or Horace under Maltab2015b.
-->

[http://shadow.nd.rl.ac.uk/wiki/idr/index.php/Setting_up_Mantid,_Matlab_and_auxiliary_programs_to_process_results_of_inelastic_experiments. Back to setting up Mantid]