diff --git a/Code/Mantid/docs/conf-html.py b/Code/Mantid/docs/conf-html.py
index 38bafbb6e6df50ed30d1f73a7a647b5e2e5e5ec1..176d3f6292d26735ef8e914bf053a9aa00d7aa44 100644
--- a/Code/Mantid/docs/conf-html.py
+++ b/Code/Mantid/docs/conf-html.py
@@ -27,9 +27,10 @@ html_theme_options = {
# Remove the local TOC from the nav bar
'navbar_pagenav': False,
# Hide the next/previous in the nav bar.
- 'navbar_sidebarrel': False,
+ 'navbar_sidebarrel': True,
# Use the latest version.
'bootstrap_version': "3",
# Ensure the nav bar always stays on top of page.
'navbar_fixed_top': "false",
+
}
diff --git a/Code/Mantid/docs/conf.py.in b/Code/Mantid/docs/conf.py.in
index 87c3ebadd54677ca27fcd9083bb49ea561a48b8b..19699bad5dadd8eff15da79644cd14844f8c555c 100644
--- a/Code/Mantid/docs/conf.py.in
+++ b/Code/Mantid/docs/conf.py.in
@@ -144,7 +144,7 @@ html_use_smartypants = True
html_show_sphinx = False
# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-html_show_copyright = True
+html_show_copyright = False
# -- Options for selected builder output ---------------------------------------
diff --git a/Code/Mantid/docs/source/_static/custom.css b/Code/Mantid/docs/source/_static/custom.css
index 76a9886d9abced4c15b1f2a5a384ba808f4a7131..22b02d8ed0250d1ce0e2a2fae491281125312411 100644
--- a/Code/Mantid/docs/source/_static/custom.css
+++ b/Code/Mantid/docs/source/_static/custom.css
@@ -98,3 +98,14 @@ td, th {
max-width: 40%;
}
}
+/*---------------------Coloured_text-------------------------*/
+
+.red {
+ color:red;
+}
+.blue {
+ color:blue;
+}
+.green {
+ color:green;
+}
diff --git a/Code/Mantid/docs/source/_templates/layout.html b/Code/Mantid/docs/source/_templates/layout.html
index 3728141dd335582b8c0efd8d135cd027070203e9..81c75a3d306762706c42f27765f4581ad5b4b3e9 100644
--- a/Code/Mantid/docs/source/_templates/layout.html
+++ b/Code/Mantid/docs/source/_templates/layout.html
@@ -15,5 +15,38 @@
{% endif %}
{% endblock %}
+{% block footer %}
+<footer class="footer">
+ <div class="container">
+ <ul class="nav navbar-nav" style=" float: right;">
+ {% if theme_source_link_position == "footer" %}
+ <li>{% include "sourcelink.html" %}</li>
+ {% endif %}
+ {% if theme_navbar_sidebarrel %}
+ {% block sidebarrel %}
+ {% include "relations.html" %}
+ {% endblock %}
+ {% endif %}
+ <li><a href="#">Back to top</a></li>
+ </ul>
+ <p>
+ {%- if show_copyright %}
+ {%- if hasdoc('copyright') %}
+ {% trans path=pathto('copyright'), copyright=copyright|e %}© <a href="{{ path }}">Copyright</a> {{ copyright }}.{% endtrans %}<br/>
+ {%- else %}
+ {% trans copyright=copyright|e %}© Copyright {{ copyright }}.{% endtrans %}<br/>
+ {%- endif %}
+ {%- endif %}
+ {%- if last_updated %}
+ {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %}<br/>
+ {%- endif %}
+ {%- if show_sphinx %}
+ {% trans sphinx_version=sphinx_version|e %}Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> {{ sphinx_version }}.{% endtrans %}<br/>
+ {%- endif %}
+ </p>
+ </div>
+</footer>
+{%- endblock %}
+
{# Custom CSS overrides #}
{% set bootswatch_css_custom = ['_static/custom.css'] %}
diff --git a/Code/Mantid/docs/source/_templates/navbar.html b/Code/Mantid/docs/source/_templates/navbar.html
index 3990e9310cb9d8d8bcd1c7e52a7a5effef4f1e13..ace61b0efd278b23fbcd4f78704c3941a802c5df 100644
--- a/Code/Mantid/docs/source/_templates/navbar.html
+++ b/Code/Mantid/docs/source/_templates/navbar.html
@@ -42,11 +42,6 @@
{% include "navbartoc.html" %}
{% endif %}
{% endblock %}
- {% if theme_navbar_sidebarrel %}
- {% block sidebarrel %}
- {% include "relations.html" %}
- {% endblock %}
- {% endif %}
{% block navbarextra %}
{% endblock %}
{% if theme_source_link_position == "nav" %}
diff --git a/Code/Mantid/docs/source/images/554px-SliceViewer_DynamicRebinOn.png b/Code/Mantid/docs/source/images/554px-SliceViewer_DynamicRebinOn.png
new file mode 100644
index 0000000000000000000000000000000000000000..7ffab654e559cfdb3c4c53ecda7a48705f916b7e
Binary files /dev/null and b/Code/Mantid/docs/source/images/554px-SliceViewer_DynamicRebinOn.png differ
diff --git a/Code/Mantid/docs/source/images/AddBackgroundOption.png b/Code/Mantid/docs/source/images/AddBackgroundOption.png
new file mode 100644
index 0000000000000000000000000000000000000000..be373cff799b2f80a5ddb18810770e8c08555b1b
Binary files /dev/null and b/Code/Mantid/docs/source/images/AddBackgroundOption.png differ
diff --git a/Code/Mantid/docs/source/images/AddButton.png b/Code/Mantid/docs/source/images/AddButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..5b80a4c3f51d61841349bb5d641b455abce750fe
Binary files /dev/null and b/Code/Mantid/docs/source/images/AddButton.png differ
diff --git a/Code/Mantid/docs/source/images/AddOtherFunctionOption.png b/Code/Mantid/docs/source/images/AddOtherFunctionOption.png
new file mode 100644
index 0000000000000000000000000000000000000000..cd3581812a59cd0572b88ef8d5ab4afed1eb4154
Binary files /dev/null and b/Code/Mantid/docs/source/images/AddOtherFunctionOption.png differ
diff --git a/Code/Mantid/docs/source/images/AddedUserFunction.png b/Code/Mantid/docs/source/images/AddedUserFunction.png
new file mode 100644
index 0000000000000000000000000000000000000000..89d22d7ff4dd337f2596f4aeb79a6cf0569caba3
Binary files /dev/null and b/Code/Mantid/docs/source/images/AddedUserFunction.png differ
diff --git a/Code/Mantid/docs/source/images/ApplyAndSaveMenu.png b/Code/Mantid/docs/source/images/ApplyAndSaveMenu.png
new file mode 100644
index 0000000000000000000000000000000000000000..1e7ce3b9ba89e0ad1ad385aeb15e042fe7a5c05e
Binary files /dev/null and b/Code/Mantid/docs/source/images/ApplyAndSaveMenu.png differ
diff --git a/Code/Mantid/docs/source/images/ApplyToDataButton.png b/Code/Mantid/docs/source/images/ApplyToDataButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..fe4e16495928f3f9459dbd4447ad1b3f5ab8ad82
Binary files /dev/null and b/Code/Mantid/docs/source/images/ApplyToDataButton.png differ
diff --git a/Code/Mantid/docs/source/images/ApplyToViewButton.png b/Code/Mantid/docs/source/images/ApplyToViewButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..fbc9d471cbfe33f41d04f6ba586a9ddbd707beb7
Binary files /dev/null and b/Code/Mantid/docs/source/images/ApplyToViewButton.png differ
diff --git a/Code/Mantid/docs/source/images/ArrowRight.png b/Code/Mantid/docs/source/images/ArrowRight.png
new file mode 100644
index 0000000000000000000000000000000000000000..b13d5b83c25796b8c2eae5d7e0fdd00d28762414
Binary files /dev/null and b/Code/Mantid/docs/source/images/ArrowRight.png differ
diff --git a/Code/Mantid/docs/source/images/Binning_example.png b/Code/Mantid/docs/source/images/Binning_example.png
new file mode 100644
index 0000000000000000000000000000000000000000..78599b4628792cc733df05cbcf3576ba5cec460a
Binary files /dev/null and b/Code/Mantid/docs/source/images/Binning_example.png differ
diff --git a/Code/Mantid/docs/source/images/ChangePeakWidth.png b/Code/Mantid/docs/source/images/ChangePeakWidth.png
new file mode 100644
index 0000000000000000000000000000000000000000..8e4897a4068b08ba6f8c48970bcf324c9ced933d
Binary files /dev/null and b/Code/Mantid/docs/source/images/ChangePeakWidth.png differ
diff --git a/Code/Mantid/docs/source/images/ChooseExpDecay.png b/Code/Mantid/docs/source/images/ChooseExpDecay.png
new file mode 100644
index 0000000000000000000000000000000000000000..405b61604422c0a1d1a510818ec06d8fcc19159e
Binary files /dev/null and b/Code/Mantid/docs/source/images/ChooseExpDecay.png differ
diff --git a/Code/Mantid/docs/source/images/ClearAllButton.png b/Code/Mantid/docs/source/images/ClearAllButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..342cbf16f69352da9066e0b2242d7e574d2fbaff
Binary files /dev/null and b/Code/Mantid/docs/source/images/ClearAllButton.png differ
diff --git a/Code/Mantid/docs/source/images/ClearModel.png b/Code/Mantid/docs/source/images/ClearModel.png
new file mode 100644
index 0000000000000000000000000000000000000000..c8e6e749b8cadfda36e13f6a5fbd656e4927d7e1
Binary files /dev/null and b/Code/Mantid/docs/source/images/ClearModel.png differ
diff --git a/Code/Mantid/docs/source/images/ColourFillPlotMar11060.PNG b/Code/Mantid/docs/source/images/ColourFillPlotMar11060.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..d8d4d7636695226d0f2e266db9b4758b5862a2e4
Binary files /dev/null and b/Code/Mantid/docs/source/images/ColourFillPlotMar11060.PNG differ
diff --git a/Code/Mantid/docs/source/images/ContourLinesDialog.png b/Code/Mantid/docs/source/images/ContourLinesDialog.png
new file mode 100644
index 0000000000000000000000000000000000000000..02d1a82d849b71a991b65e9da857104f1bc4a02d
Binary files /dev/null and b/Code/Mantid/docs/source/images/ContourLinesDialog.png differ
diff --git a/Code/Mantid/docs/source/images/ContourPlot.png b/Code/Mantid/docs/source/images/ContourPlot.png
new file mode 100644
index 0000000000000000000000000000000000000000..5b427931177e8aa182d89ff4685e25fec3356c10
Binary files /dev/null and b/Code/Mantid/docs/source/images/ContourPlot.png differ
diff --git a/Code/Mantid/docs/source/images/Data_replace.png b/Code/Mantid/docs/source/images/Data_replace.png
new file mode 100644
index 0000000000000000000000000000000000000000..1c109b4c413864bee7c008acb467d424e210898b
Binary files /dev/null and b/Code/Mantid/docs/source/images/Data_replace.png differ
diff --git a/Code/Mantid/docs/source/images/DemoLocationAlgorithmsPanel_MBC.PNG b/Code/Mantid/docs/source/images/DemoLocationAlgorithmsPanel_MBC.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..e2949669bee217e6806160e28acd212846f48f73
Binary files /dev/null and b/Code/Mantid/docs/source/images/DemoLocationAlgorithmsPanel_MBC.PNG differ
diff --git a/Code/Mantid/docs/source/images/DetectorPositionOptions.png b/Code/Mantid/docs/source/images/DetectorPositionOptions.png
new file mode 100644
index 0000000000000000000000000000000000000000..bca94bd4128a571128ffe7de500437284bf2f9a1
Binary files /dev/null and b/Code/Mantid/docs/source/images/DetectorPositionOptions.png differ
diff --git a/Code/Mantid/docs/source/images/DisplaySettings.png b/Code/Mantid/docs/source/images/DisplaySettings.png
new file mode 100644
index 0000000000000000000000000000000000000000..bcb723a61c7ad2bb8cb18222814fc0a202d45af9
Binary files /dev/null and b/Code/Mantid/docs/source/images/DisplaySettings.png differ
diff --git a/Code/Mantid/docs/source/images/DrawingEllipse.png b/Code/Mantid/docs/source/images/DrawingEllipse.png
new file mode 100644
index 0000000000000000000000000000000000000000..20ca6a3e203d6c7f72cf9697fc8fd67c1dca2e06
Binary files /dev/null and b/Code/Mantid/docs/source/images/DrawingEllipse.png differ
diff --git a/Code/Mantid/docs/source/images/ExerciseFittingMBCfit.PNG b/Code/Mantid/docs/source/images/ExerciseFittingMBCfit.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..45d217503baf1d36fe2f6ea7af0d4bb35687d8a8
Binary files /dev/null and b/Code/Mantid/docs/source/images/ExerciseFittingMBCfit.PNG differ
diff --git a/Code/Mantid/docs/source/images/ExerciseFittingMBCfit2.PNG b/Code/Mantid/docs/source/images/ExerciseFittingMBCfit2.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..147ee07061a12cc19bbe9f49e209eb1636450af0
Binary files /dev/null and b/Code/Mantid/docs/source/images/ExerciseFittingMBCfit2.PNG differ
diff --git a/Code/Mantid/docs/source/images/ExerciseFittingMBCguess.PNG b/Code/Mantid/docs/source/images/ExerciseFittingMBCguess.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..8dc108da15966e214e1f31f3da366c298bab9136
Binary files /dev/null and b/Code/Mantid/docs/source/images/ExerciseFittingMBCguess.PNG differ
diff --git a/Code/Mantid/docs/source/images/FirstStartMantidPlotFittingMBC.PNG b/Code/Mantid/docs/source/images/FirstStartMantidPlotFittingMBC.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..8ca51111de6867439b6ffc563eb9a68910c1c54d
Binary files /dev/null and b/Code/Mantid/docs/source/images/FirstStartMantidPlotFittingMBC.PNG differ
diff --git a/Code/Mantid/docs/source/images/FitResultWorkspace.png b/Code/Mantid/docs/source/images/FitResultWorkspace.png
new file mode 100644
index 0000000000000000000000000000000000000000..fda4de62d6db8d73207ec4c0c5b97692c592f9c8
Binary files /dev/null and b/Code/Mantid/docs/source/images/FitResultWorkspace.png differ
diff --git a/Code/Mantid/docs/source/images/FitResults.png b/Code/Mantid/docs/source/images/FitResults.png
new file mode 100644
index 0000000000000000000000000000000000000000..e7c36780cee61820d59426d34e809e0dcbea708d
Binary files /dev/null and b/Code/Mantid/docs/source/images/FitResults.png differ
diff --git a/Code/Mantid/docs/source/images/Fit_PlotToolbar.png b/Code/Mantid/docs/source/images/Fit_PlotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..9ff645dd3d69a73777dd34d7447c3afe82938daa
Binary files /dev/null and b/Code/Mantid/docs/source/images/Fit_PlotToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/FittedGaussian.png b/Code/Mantid/docs/source/images/FittedGaussian.png
new file mode 100644
index 0000000000000000000000000000000000000000..dd75cc6a467d289557a917609af26eca812f6541
Binary files /dev/null and b/Code/Mantid/docs/source/images/FittedGaussian.png differ
diff --git a/Code/Mantid/docs/source/images/FittingMultiplePeaks.png b/Code/Mantid/docs/source/images/FittingMultiplePeaks.png
new file mode 100644
index 0000000000000000000000000000000000000000..d63ef70556cdca1c7cb0a34301f652536a2e084c
Binary files /dev/null and b/Code/Mantid/docs/source/images/FittingMultiplePeaks.png differ
diff --git a/Code/Mantid/docs/source/images/Fly.png b/Code/Mantid/docs/source/images/Fly.png
new file mode 100644
index 0000000000000000000000000000000000000000..54fda1781acf6a22d0c276c8344c89fdd9ad353b
Binary files /dev/null and b/Code/Mantid/docs/source/images/Fly.png differ
diff --git a/Code/Mantid/docs/source/images/FourViewsOfInstrument.png b/Code/Mantid/docs/source/images/FourViewsOfInstrument.png
new file mode 100644
index 0000000000000000000000000000000000000000..425008669f0a914789a1836eb8634a6894f55b38
Binary files /dev/null and b/Code/Mantid/docs/source/images/FourViewsOfInstrument.png differ
diff --git a/Code/Mantid/docs/source/images/GEMAsymmetricPeak.png b/Code/Mantid/docs/source/images/GEMAsymmetricPeak.png
new file mode 100644
index 0000000000000000000000000000000000000000..dfaa47a9c7b56a519467c16b77bb7e5e7089c0e1
Binary files /dev/null and b/Code/Mantid/docs/source/images/GEMAsymmetricPeak.png differ
diff --git a/Code/Mantid/docs/source/images/GEMGaussianFit.png b/Code/Mantid/docs/source/images/GEMGaussianFit.png
new file mode 100644
index 0000000000000000000000000000000000000000..85942b83da69d313d9d3bc5ca848e2d81cc3ed19
Binary files /dev/null and b/Code/Mantid/docs/source/images/GEMGaussianFit.png differ
diff --git a/Code/Mantid/docs/source/images/GEMIkedaCarpenterFit.png b/Code/Mantid/docs/source/images/GEMIkedaCarpenterFit.png
new file mode 100644
index 0000000000000000000000000000000000000000..220be04273e67f317bb04e30d8824dc395371036
Binary files /dev/null and b/Code/Mantid/docs/source/images/GEMIkedaCarpenterFit.png differ
diff --git a/Code/Mantid/docs/source/images/GemSinglePeak.png b/Code/Mantid/docs/source/images/GemSinglePeak.png
new file mode 100644
index 0000000000000000000000000000000000000000..1686f29635d40bdc8d124e54288cee01f4883dc0
Binary files /dev/null and b/Code/Mantid/docs/source/images/GemSinglePeak.png differ
diff --git a/Code/Mantid/docs/source/images/GroupBlueRing.png b/Code/Mantid/docs/source/images/GroupBlueRing.png
new file mode 100644
index 0000000000000000000000000000000000000000..b5ee799d1c2684ac2f133a41eda22afe5d67cb5d
Binary files /dev/null and b/Code/Mantid/docs/source/images/GroupBlueRing.png differ
diff --git a/Code/Mantid/docs/source/images/GroupingOperations.png b/Code/Mantid/docs/source/images/GroupingOperations.png
new file mode 100644
index 0000000000000000000000000000000000000000..d4b0c7221c9cf76c706e5485763db3ddb613509e
Binary files /dev/null and b/Code/Mantid/docs/source/images/GroupingOperations.png differ
diff --git a/Code/Mantid/docs/source/images/HistoryRebinOfCNCS7860event.PNG b/Code/Mantid/docs/source/images/HistoryRebinOfCNCS7860event.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..9cea5f936f5a1aff0e1c5c407c2125185270f22c
Binary files /dev/null and b/Code/Mantid/docs/source/images/HistoryRebinOfCNCS7860event.PNG differ
diff --git a/Code/Mantid/docs/source/images/ImageViewer.png b/Code/Mantid/docs/source/images/ImageViewer.png
new file mode 100644
index 0000000000000000000000000000000000000000..36ab7ba4b7a2e662db6c0c8c6f05fc7d092019ce
Binary files /dev/null and b/Code/Mantid/docs/source/images/ImageViewer.png differ
diff --git a/Code/Mantid/docs/source/images/ImportantMantidPlotDependences.PNG b/Code/Mantid/docs/source/images/ImportantMantidPlotDependences.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..4f6a32fd576769c170def558c6099a006ca7cb4a
Binary files /dev/null and b/Code/Mantid/docs/source/images/ImportantMantidPlotDependences.PNG differ
diff --git a/Code/Mantid/docs/source/images/InstrumentTree.png b/Code/Mantid/docs/source/images/InstrumentTree.png
new file mode 100644
index 0000000000000000000000000000000000000000..e3861db9ae3491d26c6a79c855dacccf6fb3b3bf
Binary files /dev/null and b/Code/Mantid/docs/source/images/InstrumentTree.png differ
diff --git a/Code/Mantid/docs/source/images/InstrumentViewGeneralView.png b/Code/Mantid/docs/source/images/InstrumentViewGeneralView.png
new file mode 100644
index 0000000000000000000000000000000000000000..6310ed5b4fd22133bd061d5ae00857c759cd8536
Binary files /dev/null and b/Code/Mantid/docs/source/images/InstrumentViewGeneralView.png differ
diff --git a/Code/Mantid/docs/source/images/InstrumentViewTypeDropDown.png b/Code/Mantid/docs/source/images/InstrumentViewTypeDropDown.png
new file mode 100644
index 0000000000000000000000000000000000000000..493c6e79e36f7d2a5913a56fe742f2d65b207e9a
Binary files /dev/null and b/Code/Mantid/docs/source/images/InstrumentViewTypeDropDown.png differ
diff --git a/Code/Mantid/docs/source/images/InterfacesMenu.png b/Code/Mantid/docs/source/images/InterfacesMenu.png
new file mode 100644
index 0000000000000000000000000000000000000000..02a83e7494d6f945d56b65cbcdc7aa09ffd0762b
Binary files /dev/null and b/Code/Mantid/docs/source/images/InterfacesMenu.png differ
diff --git a/Code/Mantid/docs/source/images/JustAddedPeak.png b/Code/Mantid/docs/source/images/JustAddedPeak.png
new file mode 100644
index 0000000000000000000000000000000000000000..81384ee010a143fd68813b1ac70028dfd6bf1e6f
Binary files /dev/null and b/Code/Mantid/docs/source/images/JustAddedPeak.png differ
diff --git a/Code/Mantid/docs/source/images/LOQAppliedMask.png b/Code/Mantid/docs/source/images/LOQAppliedMask.png
new file mode 100644
index 0000000000000000000000000000000000000000..bce5465d3ff8678b306be25edd41ec40d26134f7
Binary files /dev/null and b/Code/Mantid/docs/source/images/LOQAppliedMask.png differ
diff --git a/Code/Mantid/docs/source/images/LOQEllipseMasking.png b/Code/Mantid/docs/source/images/LOQEllipseMasking.png
new file mode 100644
index 0000000000000000000000000000000000000000..5c6bf42bc7dd0f646084e82dbba6d44c2db331c2
Binary files /dev/null and b/Code/Mantid/docs/source/images/LOQEllipseMasking.png differ
diff --git a/Code/Mantid/docs/source/images/LOQForMasking.png b/Code/Mantid/docs/source/images/LOQForMasking.png
new file mode 100644
index 0000000000000000000000000000000000000000..fdb2502471fefa8fdd635e1b49d6a22fb01da013
Binary files /dev/null and b/Code/Mantid/docs/source/images/LOQForMasking.png differ
diff --git a/Code/Mantid/docs/source/images/LOQRectRingMasking.png b/Code/Mantid/docs/source/images/LOQRectRingMasking.png
new file mode 100644
index 0000000000000000000000000000000000000000..80606bd670ce9dd60510287153d100d86bd4acff
Binary files /dev/null and b/Code/Mantid/docs/source/images/LOQRectRingMasking.png differ
diff --git a/Code/Mantid/docs/source/images/LiveDataCycle.png b/Code/Mantid/docs/source/images/LiveDataCycle.png
new file mode 100644
index 0000000000000000000000000000000000000000..2c9c2a44798c062cda4c03bf4f0f1f6403f038c9
Binary files /dev/null and b/Code/Mantid/docs/source/images/LiveDataCycle.png differ
diff --git a/Code/Mantid/docs/source/images/LoadAlgorithmsSep2013.PNG b/Code/Mantid/docs/source/images/LoadAlgorithmsSep2013.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..20bec42f627f065c70069efb15719762f23b30dd
Binary files /dev/null and b/Code/Mantid/docs/source/images/LoadAlgorithmsSep2013.PNG differ
diff --git a/Code/Mantid/docs/source/images/LoadFileButton.png b/Code/Mantid/docs/source/images/LoadFileButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..99849d868ee3076e8e58be28fe39b5cf7c94b452
Binary files /dev/null and b/Code/Mantid/docs/source/images/LoadFileButton.png differ
diff --git a/Code/Mantid/docs/source/images/LoadLiveDataButton.png b/Code/Mantid/docs/source/images/LoadLiveDataButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..c97095c39ced5a8836c70f8152705e9392ed5d94
Binary files /dev/null and b/Code/Mantid/docs/source/images/LoadLiveDataButton.png differ
diff --git a/Code/Mantid/docs/source/images/LoglinearAxes.png b/Code/Mantid/docs/source/images/LoglinearAxes.png
new file mode 100644
index 0000000000000000000000000000000000000000..d374e561bc9ae8d1f02eeac20b1f29d5228e53bc
Binary files /dev/null and b/Code/Mantid/docs/source/images/LoglinearAxes.png differ
diff --git a/Code/Mantid/docs/source/images/MAR11060PartialLoad.png b/Code/Mantid/docs/source/images/MAR11060PartialLoad.png
new file mode 100644
index 0000000000000000000000000000000000000000..9b96199ca5ac7c7a5f6b6e4b91e4c965b1377b0d
Binary files /dev/null and b/Code/Mantid/docs/source/images/MAR11060PartialLoad.png differ
diff --git a/Code/Mantid/docs/source/images/MBCMantidPlotaskforhelp.PNG b/Code/Mantid/docs/source/images/MBCMantidPlotaskforhelp.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..9029c349ba13d685390e120420dfd603391da010
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBCMantidPlotaskforhelp.PNG differ
diff --git a/Code/Mantid/docs/source/images/MBC_Alg_Example2.png b/Code/Mantid/docs/source/images/MBC_Alg_Example2.png
new file mode 100644
index 0000000000000000000000000000000000000000..4f58831870d9f0c8cb6c8561fc9c1e994422ab42
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_Alg_Example2.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_Alg_Example3.png b/Code/Mantid/docs/source/images/MBC_Alg_Example3.png
new file mode 100644
index 0000000000000000000000000000000000000000..c3ea95aafcd055c11cf9e50fca275b7585cbd348
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_Alg_Example3.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_AlgorithmDialog.png b/Code/Mantid/docs/source/images/MBC_AlgorithmDialog.png
new file mode 100644
index 0000000000000000000000000000000000000000..5c595f64d58c1bdcf7ebc425889fa8363b1ad8e7
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_AlgorithmDialog.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_PickDemo.png b/Code/Mantid/docs/source/images/MBC_PickDemo.png
new file mode 100644
index 0000000000000000000000000000000000000000..64f0307aaea02e7e80eb3bb8566aba09918e20bb
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_PickDemo.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_Ragged.png b/Code/Mantid/docs/source/images/MBC_Ragged.png
new file mode 100644
index 0000000000000000000000000000000000000000..547e7628f5b81e51cbc82a66c5e0fdbcf756bea8
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_Ragged.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_Rebin_Coarse.png b/Code/Mantid/docs/source/images/MBC_Rebin_Coarse.png
new file mode 100644
index 0000000000000000000000000000000000000000..9604d72a882d89a5555fdd3efdd0781e9790e90d
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_Rebin_Coarse.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_Rebin_Fine.png b/Code/Mantid/docs/source/images/MBC_Rebin_Fine.png
new file mode 100644
index 0000000000000000000000000000000000000000..8f1a56d1c446b13e2988a3dc49270ea66268b946
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_Rebin_Fine.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_Rebin_MED.png b/Code/Mantid/docs/source/images/MBC_Rebin_MED.png
new file mode 100644
index 0000000000000000000000000000000000000000..a2f1055d419857b137f1a92ebb1dd2634c62ac74
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_Rebin_MED.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_Rebinned.png b/Code/Mantid/docs/source/images/MBC_Rebinned.png
new file mode 100644
index 0000000000000000000000000000000000000000..14def68f98b9e5aa7e6d72e4ba1a32575f1d2431
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_Rebinned.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_SliceViewer_Controls.png b/Code/Mantid/docs/source/images/MBC_SliceViewer_Controls.png
new file mode 100644
index 0000000000000000000000000000000000000000..811fade2da7f3707e5dc258cef20f41946a8e4df
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_SliceViewer_Controls.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_VSI_Example1.png b/Code/Mantid/docs/source/images/MBC_VSI_Example1.png
new file mode 100644
index 0000000000000000000000000000000000000000..be39903995f8504d85c98dc4d2eece54a6dbdf5e
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_VSI_Example1.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_VSI_Example2.png b/Code/Mantid/docs/source/images/MBC_VSI_Example2.png
new file mode 100644
index 0000000000000000000000000000000000000000..c168220230c894095073854024371eac056fce17
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_VSI_Example2.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_VSI_Example3.png b/Code/Mantid/docs/source/images/MBC_VSI_Example3.png
new file mode 100644
index 0000000000000000000000000000000000000000..3e54daeee2e8995ccf20d7505c801a20a1948f2f
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_VSI_Example3.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_Workspace2D.png b/Code/Mantid/docs/source/images/MBC_Workspace2D.png
new file mode 100644
index 0000000000000000000000000000000000000000..a4b32799eab643e1f02b57c512f7bbc19644dd0f
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_Workspace2D.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_algorithm_example.png b/Code/Mantid/docs/source/images/MBC_algorithm_example.png
new file mode 100644
index 0000000000000000000000000000000000000000..63827bfd7f42f91fefbf5eee5ca3ec9d0c451373
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_algorithm_example.png differ
diff --git a/Code/Mantid/docs/source/images/MBC_axes_annotated.png b/Code/Mantid/docs/source/images/MBC_axes_annotated.png
new file mode 100644
index 0000000000000000000000000000000000000000..8531b9a07cbbcdd83c16663ca33392c098894aa6
Binary files /dev/null and b/Code/Mantid/docs/source/images/MBC_axes_annotated.png differ
diff --git a/Code/Mantid/docs/source/images/MUSRDataSet.png b/Code/Mantid/docs/source/images/MUSRDataSet.png
new file mode 100644
index 0000000000000000000000000000000000000000..64fd7a76ca0b0f4ba211e03b6ac80ce3438e39ac
Binary files /dev/null and b/Code/Mantid/docs/source/images/MUSRDataSet.png differ
diff --git a/Code/Mantid/docs/source/images/MUSRDataSetFittingOn.png b/Code/Mantid/docs/source/images/MUSRDataSetFittingOn.png
new file mode 100644
index 0000000000000000000000000000000000000000..e5dc6309bb40c78add8d0c41fa25931c94846776
Binary files /dev/null and b/Code/Mantid/docs/source/images/MUSRDataSetFittingOn.png differ
diff --git a/Code/Mantid/docs/source/images/MUSRDataSetFittingResults.png b/Code/Mantid/docs/source/images/MUSRDataSetFittingResults.png
new file mode 100644
index 0000000000000000000000000000000000000000..1c770b0e754899d750187e27fb3a96d063166f58
Binary files /dev/null and b/Code/Mantid/docs/source/images/MUSRDataSetFittingResults.png differ
diff --git a/Code/Mantid/docs/source/images/ManageDirectories.png b/Code/Mantid/docs/source/images/ManageDirectories.png
new file mode 100644
index 0000000000000000000000000000000000000000..f4bfb472c1a586ce4c7e65bb0c05544ceef3cd46
Binary files /dev/null and b/Code/Mantid/docs/source/images/ManageDirectories.png differ
diff --git a/Code/Mantid/docs/source/images/MantidChooseDefaultSettings.png b/Code/Mantid/docs/source/images/MantidChooseDefaultSettings.png
new file mode 100644
index 0000000000000000000000000000000000000000..4658afaea20ea758ebb507cbdce084420542dbd1
Binary files /dev/null and b/Code/Mantid/docs/source/images/MantidChooseDefaultSettings.png differ
diff --git a/Code/Mantid/docs/source/images/MantidPlotDesktopIcon.PNG b/Code/Mantid/docs/source/images/MantidPlotDesktopIcon.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..000fecd60cf7b4fd28c8da3eea3f44088b55d7d2
Binary files /dev/null and b/Code/Mantid/docs/source/images/MantidPlotDesktopIcon.PNG differ
diff --git a/Code/Mantid/docs/source/images/MantidPlotStartUpWindow.PNG b/Code/Mantid/docs/source/images/MantidPlotStartUpWindow.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..309e9911977a8d4f14d38d6aa1d2cb1914134a93
Binary files /dev/null and b/Code/Mantid/docs/source/images/MantidPlotStartUpWindow.PNG differ
diff --git a/Code/Mantid/docs/source/images/MantidPlot_VSI-v2_Menu.png b/Code/Mantid/docs/source/images/MantidPlot_VSI-v2_Menu.png
new file mode 100644
index 0000000000000000000000000000000000000000..99c11d2ef4e71cbec3f456897e71d15b88c5ae92
Binary files /dev/null and b/Code/Mantid/docs/source/images/MantidPlot_VSI-v2_Menu.png differ
diff --git a/Code/Mantid/docs/source/images/MaskOrGroup.png b/Code/Mantid/docs/source/images/MaskOrGroup.png
new file mode 100644
index 0000000000000000000000000000000000000000..e4113b7cb17ef3b3d484412a7f3ced08067bca80
Binary files /dev/null and b/Code/Mantid/docs/source/images/MaskOrGroup.png differ
diff --git a/Code/Mantid/docs/source/images/MaskRedRing.png b/Code/Mantid/docs/source/images/MaskRedRing.png
new file mode 100644
index 0000000000000000000000000000000000000000..e68930077dc965a34c70e68c7275f0af3ed3e66c
Binary files /dev/null and b/Code/Mantid/docs/source/images/MaskRedRing.png differ
diff --git a/Code/Mantid/docs/source/images/MaskTabToolButtons.png b/Code/Mantid/docs/source/images/MaskTabToolButtons.png
new file mode 100644
index 0000000000000000000000000000000000000000..cd643c3821109be01b0d3f6ff6e85af6c4809958
Binary files /dev/null and b/Code/Mantid/docs/source/images/MaskTabToolButtons.png differ
diff --git a/Code/Mantid/docs/source/images/MaskWorkspaceView.png b/Code/Mantid/docs/source/images/MaskWorkspaceView.png
new file mode 100644
index 0000000000000000000000000000000000000000..9d002a6a5166c50a41b1e0a71aaada966183c18b
Binary files /dev/null and b/Code/Mantid/docs/source/images/MaskWorkspaceView.png differ
diff --git a/Code/Mantid/docs/source/images/MaskedViewPixels.png b/Code/Mantid/docs/source/images/MaskedViewPixels.png
new file mode 100644
index 0000000000000000000000000000000000000000..2ff9a3acfe8c491783ea925a91520d697f6ada53
Binary files /dev/null and b/Code/Mantid/docs/source/images/MaskedViewPixels.png differ
diff --git a/Code/Mantid/docs/source/images/MaskingViewAndWorkspace.png b/Code/Mantid/docs/source/images/MaskingViewAndWorkspace.png
new file mode 100644
index 0000000000000000000000000000000000000000..9f663a9305654c6e55a84a7a2393b4d9a9b4e795
Binary files /dev/null and b/Code/Mantid/docs/source/images/MaskingViewAndWorkspace.png differ
diff --git a/Code/Mantid/docs/source/images/MatrixDisplayRightClickOptions.PNG b/Code/Mantid/docs/source/images/MatrixDisplayRightClickOptions.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..0433744799f2bef13fc696b25d63aa3c89846acf
Binary files /dev/null and b/Code/Mantid/docs/source/images/MatrixDisplayRightClickOptions.PNG differ
diff --git a/Code/Mantid/docs/source/images/MatrixWorkspaceHierachy.png b/Code/Mantid/docs/source/images/MatrixWorkspaceHierachy.png
new file mode 100644
index 0000000000000000000000000000000000000000..11605699a1a9164ea3c3fd6bc6259140b9a3274a
Binary files /dev/null and b/Code/Mantid/docs/source/images/MatrixWorkspaceHierachy.png differ
diff --git a/Code/Mantid/docs/source/images/Miniplot.png b/Code/Mantid/docs/source/images/Miniplot.png
new file mode 100644
index 0000000000000000000000000000000000000000..4ccd48f181763753fedaddc1092bcc02e08a0892
Binary files /dev/null and b/Code/Mantid/docs/source/images/Miniplot.png differ
diff --git a/Code/Mantid/docs/source/images/MiniplotIntegrate.png b/Code/Mantid/docs/source/images/MiniplotIntegrate.png
new file mode 100644
index 0000000000000000000000000000000000000000..c2d69e7f908cae85bc3ec5837a2a1ebe057b1b98
Binary files /dev/null and b/Code/Mantid/docs/source/images/MiniplotIntegrate.png differ
diff --git a/Code/Mantid/docs/source/images/MiniplotSum.png b/Code/Mantid/docs/source/images/MiniplotSum.png
new file mode 100644
index 0000000000000000000000000000000000000000..fff7052380beb51ab9888155635b80afae2e4fb8
Binary files /dev/null and b/Code/Mantid/docs/source/images/MiniplotSum.png differ
diff --git a/Code/Mantid/docs/source/images/MultiLayerGraph.png b/Code/Mantid/docs/source/images/MultiLayerGraph.png
new file mode 100644
index 0000000000000000000000000000000000000000..460926bbfacc638decfc8012d9c28e5da32a0e50
Binary files /dev/null and b/Code/Mantid/docs/source/images/MultiLayerGraph.png differ
diff --git a/Code/Mantid/docs/source/images/MuonAnalysisInterface.png b/Code/Mantid/docs/source/images/MuonAnalysisInterface.png
new file mode 100644
index 0000000000000000000000000000000000000000..58b66112dc67145539df56c3f5e228871c2195c2
Binary files /dev/null and b/Code/Mantid/docs/source/images/MuonAnalysisInterface.png differ
diff --git a/Code/Mantid/docs/source/images/NewTrainingData.jpg b/Code/Mantid/docs/source/images/NewTrainingData.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..2848bde4c8603ca247cdb8a45c8a16ef249c9047
Binary files /dev/null and b/Code/Mantid/docs/source/images/NewTrainingData.jpg differ
diff --git a/Code/Mantid/docs/source/images/PanZoom_plotToolbar.png b/Code/Mantid/docs/source/images/PanZoom_plotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..a3ad0f01a3951c118cacf8580e3fed762ae84188
Binary files /dev/null and b/Code/Mantid/docs/source/images/PanZoom_plotToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/ParametersTable.png b/Code/Mantid/docs/source/images/ParametersTable.png
new file mode 100644
index 0000000000000000000000000000000000000000..e3a8fd2bebb6cfa0dcbb2c69ccb9781f8b30e911
Binary files /dev/null and b/Code/Mantid/docs/source/images/ParametersTable.png differ
diff --git a/Code/Mantid/docs/source/images/PeakAndBackgroundSetup.png b/Code/Mantid/docs/source/images/PeakAndBackgroundSetup.png
new file mode 100644
index 0000000000000000000000000000000000000000..6b309a0a7c53fe598427a7d843c6379c65dbb67e
Binary files /dev/null and b/Code/Mantid/docs/source/images/PeakAndBackgroundSetup.png differ
diff --git a/Code/Mantid/docs/source/images/PeakFitToolbar.png b/Code/Mantid/docs/source/images/PeakFitToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..7ae5d52ab85b9d432d632a8f4e0090bf651dc6e4
Binary files /dev/null and b/Code/Mantid/docs/source/images/PeakFitToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/Peaks_view_outline_unannotated.png b/Code/Mantid/docs/source/images/Peaks_view_outline_unannotated.png
new file mode 100644
index 0000000000000000000000000000000000000000..30be7d01845e6dacb5973cf00cbedf1635104de4
Binary files /dev/null and b/Code/Mantid/docs/source/images/Peaks_view_outline_unannotated.png differ
diff --git a/Code/Mantid/docs/source/images/PickSingleDetector.png b/Code/Mantid/docs/source/images/PickSingleDetector.png
new file mode 100644
index 0000000000000000000000000000000000000000..9f4736d0aefc305aec06d20559c93555b4a6bada
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickSingleDetector.png differ
diff --git a/Code/Mantid/docs/source/images/PickTabAddPeakButton.png b/Code/Mantid/docs/source/images/PickTabAddPeakButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..13b136aec2f5587f5de3251bdbd086ef424c5b2b
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickTabAddPeakButton.png differ
diff --git a/Code/Mantid/docs/source/images/PickTabEditButton.png b/Code/Mantid/docs/source/images/PickTabEditButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..ec2492a88e43c0007afaaa877fe6b9044653ae99
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickTabEditButton.png differ
diff --git a/Code/Mantid/docs/source/images/PickTabElRingButton.png b/Code/Mantid/docs/source/images/PickTabElRingButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..e9ad762be57653a0df4ff372438f0f790bfb83e4
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickTabElRingButton.png differ
diff --git a/Code/Mantid/docs/source/images/PickTabEllipseButton.png b/Code/Mantid/docs/source/images/PickTabEllipseButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..6f65fd3729079f6a0f867d3106a009483adc0e07
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickTabEllipseButton.png differ
diff --git a/Code/Mantid/docs/source/images/PickTabEraseButton.png b/Code/Mantid/docs/source/images/PickTabEraseButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..508e661d829f0230996db3baeec3370786e20156
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickTabEraseButton.png differ
diff --git a/Code/Mantid/docs/source/images/PickTabPickPixelButton.png b/Code/Mantid/docs/source/images/PickTabPickPixelButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..875ba4fa58a137d949839543bace1a15ffb20196
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickTabPickPixelButton.png differ
diff --git a/Code/Mantid/docs/source/images/PickTabPickTubeButton.png b/Code/Mantid/docs/source/images/PickTabPickTubeButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..6e5353bd34a99c97227e39465a35c3d90830b3ac
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickTabPickTubeButton.png differ
diff --git a/Code/Mantid/docs/source/images/PickTabRectButton.png b/Code/Mantid/docs/source/images/PickTabRectButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..bcf2b3818e75f817ef9d12ff3b1c88cc432c9e0f
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickTabRectButton.png differ
diff --git a/Code/Mantid/docs/source/images/PickTabRectRingButton.png b/Code/Mantid/docs/source/images/PickTabRectRingButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..ea4cb29e9548bb6a5ac19579c42cc53d65071044
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickTabRectRingButton.png differ
diff --git a/Code/Mantid/docs/source/images/PickTabToolButtons.png b/Code/Mantid/docs/source/images/PickTabToolButtons.png
new file mode 100644
index 0000000000000000000000000000000000000000..99996d001d59c72af2e70b42c43df26f953cd06b
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickTabToolButtons.png differ
diff --git a/Code/Mantid/docs/source/images/PickTabZoomButton.png b/Code/Mantid/docs/source/images/PickTabZoomButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..e4df723becccce21f76b40945c68e7e18f18e42e
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickTabZoomButton.png differ
diff --git a/Code/Mantid/docs/source/images/PickTube.png b/Code/Mantid/docs/source/images/PickTube.png
new file mode 100644
index 0000000000000000000000000000000000000000..d77fb4c93f61d84d519eee0ed6faeae60458551e
Binary files /dev/null and b/Code/Mantid/docs/source/images/PickTube.png differ
diff --git a/Code/Mantid/docs/source/images/Plot3DMenu.png b/Code/Mantid/docs/source/images/Plot3DMenu.png
new file mode 100644
index 0000000000000000000000000000000000000000..8c7512b988e58dc86e3b18da8f84b7384bd49758
Binary files /dev/null and b/Code/Mantid/docs/source/images/Plot3DMenu.png differ
diff --git a/Code/Mantid/docs/source/images/PlotGuess.png b/Code/Mantid/docs/source/images/PlotGuess.png
new file mode 100644
index 0000000000000000000000000000000000000000..2bd2023e94aa85736e4ca36b8720835ee796d8b3
Binary files /dev/null and b/Code/Mantid/docs/source/images/PlotGuess.png differ
diff --git a/Code/Mantid/docs/source/images/PlotToolbar.png b/Code/Mantid/docs/source/images/PlotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..b6d26ec259269bfa6239cf478371d0c408427cff
Binary files /dev/null and b/Code/Mantid/docs/source/images/PlotToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/PreparedToFitGaussian.png b/Code/Mantid/docs/source/images/PreparedToFitGaussian.png
new file mode 100644
index 0000000000000000000000000000000000000000..bccd97014cb5566e0028f3013ccab73c88341c2f
Binary files /dev/null and b/Code/Mantid/docs/source/images/PreparedToFitGaussian.png differ
diff --git a/Code/Mantid/docs/source/images/ReleasePic.png b/Code/Mantid/docs/source/images/ReleasePic.png
new file mode 100644
index 0000000000000000000000000000000000000000..782ac9940f95344ca1609fd2ccdf398a1fcfb026
Binary files /dev/null and b/Code/Mantid/docs/source/images/ReleasePic.png differ
diff --git a/Code/Mantid/docs/source/images/RemoveButton.png b/Code/Mantid/docs/source/images/RemoveButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..7970b04539c5ff636ff4178a5a81072c5b07b7d9
Binary files /dev/null and b/Code/Mantid/docs/source/images/RemoveButton.png differ
diff --git a/Code/Mantid/docs/source/images/RunFitOption.png b/Code/Mantid/docs/source/images/RunFitOption.png
new file mode 100644
index 0000000000000000000000000000000000000000..653dc802f307f97a4146f4eb9bf49d8d12a38ff4
Binary files /dev/null and b/Code/Mantid/docs/source/images/RunFitOption.png differ
diff --git a/Code/Mantid/docs/source/images/RunningAlgDetailsButton.png b/Code/Mantid/docs/source/images/RunningAlgDetailsButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..22412b71130866859629d7ea7a5e3dc34769a6a2
Binary files /dev/null and b/Code/Mantid/docs/source/images/RunningAlgDetailsButton.png differ
diff --git a/Code/Mantid/docs/source/images/RunningAlgProgressDialog.png b/Code/Mantid/docs/source/images/RunningAlgProgressDialog.png
new file mode 100644
index 0000000000000000000000000000000000000000..7d48677e8eaf0b6db5c0526435d1d23a51321585
Binary files /dev/null and b/Code/Mantid/docs/source/images/RunningAlgProgressDialog.png differ
diff --git a/Code/Mantid/docs/source/images/Sans2Dcolourfillplotexercise1MBC.PNG b/Code/Mantid/docs/source/images/Sans2Dcolourfillplotexercise1MBC.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..9350f34a0695fb5f8d0bff04de2248c90f7e98f5
Binary files /dev/null and b/Code/Mantid/docs/source/images/Sans2Dcolourfillplotexercise1MBC.PNG differ
diff --git a/Code/Mantid/docs/source/images/SaveButton.png b/Code/Mantid/docs/source/images/SaveButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..55d9bf5090d5e458fcb4d97dba60002068a2724f
Binary files /dev/null and b/Code/Mantid/docs/source/images/SaveButton.png differ
diff --git a/Code/Mantid/docs/source/images/SaveSetup.png b/Code/Mantid/docs/source/images/SaveSetup.png
new file mode 100644
index 0000000000000000000000000000000000000000..f5d2584cbc42788489f1d0450e94a534dfe289f6
Binary files /dev/null and b/Code/Mantid/docs/source/images/SaveSetup.png differ
diff --git a/Code/Mantid/docs/source/images/SaveSetupDialog.png b/Code/Mantid/docs/source/images/SaveSetupDialog.png
new file mode 100644
index 0000000000000000000000000000000000000000..4be9542bb8992c6907c5b88b8d4664dda902d103
Binary files /dev/null and b/Code/Mantid/docs/source/images/SaveSetupDialog.png differ
diff --git a/Code/Mantid/docs/source/images/SaveUserFunctionDialog.png b/Code/Mantid/docs/source/images/SaveUserFunctionDialog.png
new file mode 100644
index 0000000000000000000000000000000000000000..b6586f9795232e1ca539c871f9eaaec3eb992935
Binary files /dev/null and b/Code/Mantid/docs/source/images/SaveUserFunctionDialog.png differ
diff --git a/Code/Mantid/docs/source/images/SavedFunctionRecord.png b/Code/Mantid/docs/source/images/SavedFunctionRecord.png
new file mode 100644
index 0000000000000000000000000000000000000000..4458d0530fe29f3df0edce684657fac79bf200de
Binary files /dev/null and b/Code/Mantid/docs/source/images/SavedFunctionRecord.png differ
diff --git a/Code/Mantid/docs/source/images/SelectMuplipleShapes.png b/Code/Mantid/docs/source/images/SelectMuplipleShapes.png
new file mode 100644
index 0000000000000000000000000000000000000000..627ac32b8b3709d0293413884410c86d83b32cfe
Binary files /dev/null and b/Code/Mantid/docs/source/images/SelectMuplipleShapes.png differ
diff --git a/Code/Mantid/docs/source/images/SelectPlotGuess.png b/Code/Mantid/docs/source/images/SelectPlotGuess.png
new file mode 100644
index 0000000000000000000000000000000000000000..be215eb4aec52b085406e3a91ce66648de4462ef
Binary files /dev/null and b/Code/Mantid/docs/source/images/SelectPlotGuess.png differ
diff --git a/Code/Mantid/docs/source/images/SelectedMuplipleShapes.png b/Code/Mantid/docs/source/images/SelectedMuplipleShapes.png
new file mode 100644
index 0000000000000000000000000000000000000000..d6cdddc071f1f10f14e5919c3af44b6bf66f9025
Binary files /dev/null and b/Code/Mantid/docs/source/images/SelectedMuplipleShapes.png differ
diff --git a/Code/Mantid/docs/source/images/ShowInstrumentOption.png b/Code/Mantid/docs/source/images/ShowInstrumentOption.png
new file mode 100644
index 0000000000000000000000000000000000000000..f712ba523c13fe8e56c1a8396b0dfe89e943668e
Binary files /dev/null and b/Code/Mantid/docs/source/images/ShowInstrumentOption.png differ
diff --git a/Code/Mantid/docs/source/images/ShowLoadandWorkspaceAreaInMantidPlot.PNG b/Code/Mantid/docs/source/images/ShowLoadandWorkspaceAreaInMantidPlot.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..786fbb1c56d760084e5ae07cd815402a34d80238
Binary files /dev/null and b/Code/Mantid/docs/source/images/ShowLoadandWorkspaceAreaInMantidPlot.PNG differ
diff --git a/Code/Mantid/docs/source/images/ShowMatrixOfMar11060.PNG b/Code/Mantid/docs/source/images/ShowMatrixOfMar11060.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..411301ef4348a6ed1ebdb656bc9a33e2cd7a2de6
Binary files /dev/null and b/Code/Mantid/docs/source/images/ShowMatrixOfMar11060.PNG differ
diff --git a/Code/Mantid/docs/source/images/Showmar11060detectortable.PNG b/Code/Mantid/docs/source/images/Showmar11060detectortable.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..2aae9a69d3c775352def94dd099f285944eb8e2b
Binary files /dev/null and b/Code/Mantid/docs/source/images/Showmar11060detectortable.PNG differ
diff --git a/Code/Mantid/docs/source/images/SimpleGraph.png b/Code/Mantid/docs/source/images/SimpleGraph.png
new file mode 100644
index 0000000000000000000000000000000000000000..d16434a7baf370531575e19505edf0096a4b66ba
Binary files /dev/null and b/Code/Mantid/docs/source/images/SimpleGraph.png differ
diff --git a/Code/Mantid/docs/source/images/SliceViewer_DynamicRebinOff.png b/Code/Mantid/docs/source/images/SliceViewer_DynamicRebinOff.png
new file mode 100644
index 0000000000000000000000000000000000000000..503e44359fa82572a444312e0e942097874bfe97
Binary files /dev/null and b/Code/Mantid/docs/source/images/SliceViewer_DynamicRebinOff.png differ
diff --git a/Code/Mantid/docs/source/images/SliceViewer_DynamicRebinOn.png b/Code/Mantid/docs/source/images/SliceViewer_DynamicRebinOn.png
new file mode 100644
index 0000000000000000000000000000000000000000..b9d59a28e6f62652362e480ad649544d4cb867b9
Binary files /dev/null and b/Code/Mantid/docs/source/images/SliceViewer_DynamicRebinOn.png differ
diff --git a/Code/Mantid/docs/source/images/SliceViewer_and_LineViewer.png b/Code/Mantid/docs/source/images/SliceViewer_and_LineViewer.png
new file mode 100644
index 0000000000000000000000000000000000000000..c7776ef6afe60058f1de81ddcfe1eec2eb4e9290
Binary files /dev/null and b/Code/Mantid/docs/source/images/SliceViewer_and_LineViewer.png differ
diff --git a/Code/Mantid/docs/source/images/Spectrum100to102Mar11060.png b/Code/Mantid/docs/source/images/Spectrum100to102Mar11060.png
new file mode 100644
index 0000000000000000000000000000000000000000..36b2ac1d1bf0786a71b5e8627d66a458b058198c
Binary files /dev/null and b/Code/Mantid/docs/source/images/Spectrum100to102Mar11060.png differ
diff --git a/Code/Mantid/docs/source/images/StartLiveData.png b/Code/Mantid/docs/source/images/StartLiveData.png
new file mode 100644
index 0000000000000000000000000000000000000000..e2342a315073e17d42564e203d471fee6397ff41
Binary files /dev/null and b/Code/Mantid/docs/source/images/StartLiveData.png differ
diff --git a/Code/Mantid/docs/source/images/SumIntegrateMenu.png b/Code/Mantid/docs/source/images/SumIntegrateMenu.png
new file mode 100644
index 0000000000000000000000000000000000000000..f1001cb3adca0dac0e6d3edcecbbd6ed050da44d
Binary files /dev/null and b/Code/Mantid/docs/source/images/SumIntegrateMenu.png differ
diff --git a/Code/Mantid/docs/source/images/TabulatedFunction.png b/Code/Mantid/docs/source/images/TabulatedFunction.png
new file mode 100644
index 0000000000000000000000000000000000000000..dea4ef92e2e88282ef548318b419f64867b94c24
Binary files /dev/null and b/Code/Mantid/docs/source/images/TabulatedFunction.png differ
diff --git a/Code/Mantid/docs/source/images/TieConstraintContextManu.png b/Code/Mantid/docs/source/images/TieConstraintContextManu.png
new file mode 100644
index 0000000000000000000000000000000000000000..fec1d0dabe12308259ce4491b794f48f628d595c
Binary files /dev/null and b/Code/Mantid/docs/source/images/TieConstraintContextManu.png differ
diff --git a/Code/Mantid/docs/source/images/TwoLayersExampleMBC.PNG b/Code/Mantid/docs/source/images/TwoLayersExampleMBC.PNG
new file mode 100644
index 0000000000000000000000000000000000000000..7567e7ccff64923428612fc569d27e351170bd3f
Binary files /dev/null and b/Code/Mantid/docs/source/images/TwoLayersExampleMBC.PNG differ
diff --git a/Code/Mantid/docs/source/images/UseButton.png b/Code/Mantid/docs/source/images/UseButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..f70ab46b0819c1b76aa6b195410cada1e1b2e5a4
Binary files /dev/null and b/Code/Mantid/docs/source/images/UseButton.png differ
diff --git a/Code/Mantid/docs/source/images/UserFunctionDialog.png b/Code/Mantid/docs/source/images/UserFunctionDialog.png
new file mode 100644
index 0000000000000000000000000000000000000000..bffd30b2c881fc26e471c15f273ad84636e08b28
Binary files /dev/null and b/Code/Mantid/docs/source/images/UserFunctionDialog.png differ
diff --git a/Code/Mantid/docs/source/images/VSI-MultisliceButton.png b/Code/Mantid/docs/source/images/VSI-MultisliceButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..980c9ba82711ec9d2d927920142e24cb97b9eb21
Binary files /dev/null and b/Code/Mantid/docs/source/images/VSI-MultisliceButton.png differ
diff --git a/Code/Mantid/docs/source/images/VSI-SplatterPlotButton.png b/Code/Mantid/docs/source/images/VSI-SplatterPlotButton.png
new file mode 100644
index 0000000000000000000000000000000000000000..2bbae87669e364bfeda71e7bdc7a8631b9ab99a0
Binary files /dev/null and b/Code/Mantid/docs/source/images/VSI-SplatterPlotButton.png differ
diff --git a/Code/Mantid/docs/source/images/WorkspaceMatrixAnnotated.png b/Code/Mantid/docs/source/images/WorkspaceMatrixAnnotated.png
new file mode 100644
index 0000000000000000000000000000000000000000..156b1882a610c7c70471164bb9af75d453ca6229
Binary files /dev/null and b/Code/Mantid/docs/source/images/WorkspaceMatrixAnnotated.png differ
diff --git a/Code/Mantid/docs/source/images/ZoomUnwrapped.png b/Code/Mantid/docs/source/images/ZoomUnwrapped.png
new file mode 100644
index 0000000000000000000000000000000000000000..316d6a58e0a87e1c3fc72336026dfc80f5211297
Binary files /dev/null and b/Code/Mantid/docs/source/images/ZoomUnwrapped.png differ
diff --git a/Code/Mantid/docs/source/images/addfunction_plotToolbar.png b/Code/Mantid/docs/source/images/addfunction_plotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..e3b49da958bcf364fee728b9d6c5baff492cf45d
Binary files /dev/null and b/Code/Mantid/docs/source/images/addfunction_plotToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/addtext_plotToolbar.png b/Code/Mantid/docs/source/images/addtext_plotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..7b1c726cc003ce2ad00c6e0bc803cd86d94be86a
Binary files /dev/null and b/Code/Mantid/docs/source/images/addtext_plotToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/disable_plotToolbar.png b/Code/Mantid/docs/source/images/disable_plotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..d37a35686e92d1001ee2037e801c345938594112
Binary files /dev/null and b/Code/Mantid/docs/source/images/disable_plotToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/drawarrow_plotToolbar.png b/Code/Mantid/docs/source/images/drawarrow_plotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..f2a8669bd516f56d46789dd720066b9de04465c6
Binary files /dev/null and b/Code/Mantid/docs/source/images/drawarrow_plotToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/drawline_plotToolbar.png b/Code/Mantid/docs/source/images/drawline_plotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..9bc99d4b3c2631f7bfe2aeb2e39bb0b657d81e92
Binary files /dev/null and b/Code/Mantid/docs/source/images/drawline_plotToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/newlegend_plotToolbar.png b/Code/Mantid/docs/source/images/newlegend_plotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..a669360fa5fb8958c9297e9633e1932b260f1eed
Binary files /dev/null and b/Code/Mantid/docs/source/images/newlegend_plotToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/rescaletoall_plotToolbar.png b/Code/Mantid/docs/source/images/rescaletoall_plotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..4c5ffa9d91459e2492cdfae8ff6f1e0a7c764ca8
Binary files /dev/null and b/Code/Mantid/docs/source/images/rescaletoall_plotToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/screenreader_plotToolbar.png b/Code/Mantid/docs/source/images/screenreader_plotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..7f21acac8b0b216951627a3490a75be0b97db8ea
Binary files /dev/null and b/Code/Mantid/docs/source/images/screenreader_plotToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/zoomin_plotToolbar.png b/Code/Mantid/docs/source/images/zoomin_plotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..e0fc9fdc965a5245a8a50db72ef535b427fd3626
Binary files /dev/null and b/Code/Mantid/docs/source/images/zoomin_plotToolbar.png differ
diff --git a/Code/Mantid/docs/source/images/zoomout_plotToolbar.png b/Code/Mantid/docs/source/images/zoomout_plotToolbar.png
new file mode 100644
index 0000000000000000000000000000000000000000..0afa414f8b3add17e30c1a8a291dae3982e71ea5
Binary files /dev/null and b/Code/Mantid/docs/source/images/zoomout_plotToolbar.png differ
diff --git a/Code/Mantid/docs/source/index.rst b/Code/Mantid/docs/source/index.rst
index 65ef864bf2be1dad3543b9a7deee9cf17ba703e0..c7d6c7f8c491e11166bf87ab44aed597e5ed2faf 100644
--- a/Code/Mantid/docs/source/index.rst
+++ b/Code/Mantid/docs/source/index.rst
@@ -20,6 +20,7 @@
concepts/index
interfaces/index
fitfunctions/*
+ training/*
api/index
This is the documentation for Mantid |release|.
@@ -32,3 +33,5 @@ This is the documentation for Mantid |release|.
* `Fit Functions <fitfunctions/index.html>`_
* `API <api/index.html>`_
- `Python <api/python/index.html>`_
+* `Training Courses <training/index.html>`_
+ - `Mantid Basics <training/MantidBasics/index.html>`_
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Algorithms.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Algorithms.rst
new file mode 100644
index 0000000000000000000000000000000000000000..0ff3444ff405142fa6766aa3c794ca5e878a8902
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Algorithms.rst
@@ -0,0 +1,79 @@
+.. _train-MBC_Algorithms:
+
+Algorithms
+==========
+
+.. image:: ../../images/DemoLocationAlgorithmsPanel_MBC.PNG
+ :align: right
+
+:ref:`Algorithms <Algorithm>` are
+the verbs of Mantid - they are the "doing" objects. If you want to
+manipulate your data in any way it will be done through an algorithm.
+Algorithms operate primarily on data in workspaces. They will normally
+take one or more workspaces as an input, perform some processing on them
+and provide an output as another workspace (although it is possible to
+have multiple outputs).
+
+In MantidPlot, your primary source for Algorithms is the Algorithm panel
+shown on the right: The panel should be visible by default on the bottom
+right of the MantidPlot window. It can be shown/hidden by choosing
+**View -> Algorithms** option from the MantidPlot top menu. The panel
+may also be re-located and re-docked by dragging the top bar with the
+left mouse button held down.
+
+The algorithms can either be navigated by category (see green
+highlighted section), or searched by name (red highlighted section).
+In the search box, start writing the algorithm name, and it will
+predict the name of the algorithm as you continue typing.
+
+.. image:: ../../images/MBC_AlgorithmDialog.png
+ :width: 300px
+ :align: right
+
+Algorithm Help
+--------------
+
+Once you have an algorithm selected, you can get additional information
+about what it does, what it takes as inputs, what it provides as
+outputs, and how to use it. This is achieved via the help button on the
+algorithm dialog box that appears once the algorithm is selected. The
+help button shows up as a **?** and will take you to the documentation
+page specific to that algorithm. For example :ref:`Rebin2D <algm-Rebin2D>`.
+
+Validation of Inputs
+--------------------
+
+Many algorithms have mandatory input properties. Others have constraints
+on the inputs, such as numbers that are bounded. The red asterisk next
+to some of the input properties indicate that they must be provided
+before the algorithm can run. Hovering over the asterisk will tell you
+what is wrong with the input.
+
+Input workspaces are also validated against. If the workspace type does
+not match the validator of the input workspace for the algorithm it will
+not appear as a possible workspace to use as an input.
+
+Overwriting InputWorkspace
+--------------------------
+
+The button next to the OutputWorkspace |Data_replace.png| will populate
+the OutputWorkspace property with the same name as that of the
+InputWorkspace. This will mean that the new OutputWorkspace will
+overwrite the original input workspace.
+
+Running Algorithms
+------------------
+
+On the Algorithm dialog, the run button will execute the algorithm. If
+successful, new output workspaces will appear in the Workspace list
+panel. Algorithm outputs are sent to the Results Log panel. If the
+algorithm fails to complete, the reason should also appear in the same
+Results Log panel.
+
+
+
+
+
+.. |Data_replace.png| image:: ../../images/Data_replace.png
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Algorithms_History_EventWorkspace.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Algorithms_History_EventWorkspace.rst
new file mode 100644
index 0000000000000000000000000000000000000000..fa43e643592447f88ba059912ac4201105beb19d
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Algorithms_History_EventWorkspace.rst
@@ -0,0 +1,24 @@
+.. _train-MBC_Algorithms_History_EventWorkspace:
+
+================================
+Algorithms, History & Workspaces
+================================
+
+Introduction
+============
+
+:ref:`Workspaces <Workspace>` are the data storage units of Mantid. If you
+want to create, save or manipulate in any way a workspace this is done
+using Mantid :ref:`algorithms <Algorithm>`.
+
+For example an algorithm is used when loading data into a workspace. The
+current list of available
+`algorithms <../../algorithms/index.html>`__ is very large,
+but most algorithms interact with workspaces in the same way, generating
+a new output workspace as the result.
+
+In this section we will introduce you to some basic types of workspaces,
+and some key algorithms to operate upon those workspaces.
+
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Connecting_Data_To_Instrument.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Connecting_Data_To_Instrument.rst
new file mode 100644
index 0000000000000000000000000000000000000000..738c933c0bb180ac6acf5a73c623bdea2dc37a67
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Connecting_Data_To_Instrument.rst
@@ -0,0 +1,33 @@
+.. _train-MBC_Connecting_Data_To_Instrument:
+
+=================================
+Connecting Data To The Instrument
+=================================
+
+Introduction
+============
+
+The Instrument View is a widget for displaying instrument geometry. It
+consists of three elements:
+
+- the controls panel
+- the graphical display
+- the data integration slider
+
+.. image:: ../../images/InstrumentViewGeneralView.png
+ :width: 500px
+
+
+The controls in the controls panel are placed into four tabs according
+to their functions
+
+- Render
+- Pick
+- Mask/Group
+- Instrument Tree
+
+The display window show the instrument detector coloured according to
+the integrated counts in a workspace. The integration range is adjusted
+using the data integration slider.
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_and_Navigating_Instrument.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_and_Navigating_Instrument.rst
new file mode 100644
index 0000000000000000000000000000000000000000..e0f0c07986ed5c6377ec28e6c56102d04994f347
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_and_Navigating_Instrument.rst
@@ -0,0 +1,80 @@
+.. _train-MBC_Displaying_and_Navigating_Instrument:
+
+
+========================================
+Displaying and Navigating The Instrument
+========================================
+
+Opening the Instrument View
+===========================
+
+To see the Instrument View
+
+#. :ref:`Load <algm-Load>` a data set
+#. Right-click on the workspace and select Show Instrument
+
+.. image:: ../../images/ShowInstrumentOption.png
+ :width: 200px
+
+
+Different projections
+=====================
+
+There are two ways to display the instrument geometry: the 3D view and
+an "unwrapped" view. An "unwrapped" view shows a projection of the
+instrument onto a surface (a cylinder or a sphere) unfolded onto the
+screen. Use this drop-down menu to select the type of the projection
+
+.. image:: ../../images/InstrumentViewTypeDropDown.png
+ :width: 150px
+
+
+Here is an example of how an instrument may look in different views:
+
+.. image:: ../../images/FourViewsOfInstrument.png
+ :width: 500px
+
+
+Settings
+========
+
+Some aspects of the instrument appearance in the view can be set from
+the Display Settings drop-down menu.
+
+.. image:: ../../images/DisplaySettings.png
+ :width: 150px
+
+
+Navigating in 3D
+================
+
+.. role:: red
+
+.. role:: green
+
+.. role:: blue
+
+In the 3D view:
+
+- The X axis is :red:`red`.
+- The Y axis is :green:`green`.
+- The Z axis is :blue:`blue`.
+
+Rotate the instrument by left-clicking and dragging.
+
+Pan the view by right-clicking and dragging.
+
+Zoom in and out by rotating the wheel or holding down the middle button
+and dragging up and down.
+
+Zooming in 2D
+=============
+
+In an unwrapped view to zoom in select an area by left-clicking and
+dragging.
+
+.. image:: ../../images/ZoomUnwrapped.png
+ :width: 300px
+
+Right click to zoom out.
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_data.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_data.rst
new file mode 100644
index 0000000000000000000000000000000000000000..94778416c351df124b8235f2e994a561956aab26
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_data.rst
@@ -0,0 +1,94 @@
+.. _train-MBC_Displaying_data:
+
+===============
+Displaying data
+===============
+
+The Simplest Plot
+=================
+
+#. :ref:`Load <algm-Load>` "MAR11060".
+#. Right click the workspace in the workspace list.
+#. Select "Plot Spectrum ...".
+#. In the dialog that appears enter "1-3" in the spectra number box.
+
+You should get a plot like this with three spectra corresponding to
+spectra 1-3 (which in this case these are the monitors on MARI):
+
+.. image:: ../../images/SimpleGraph.png
+ :width: 300px
+ :align: center
+
+Another way to plot
+===================
+
+.. image:: ../../images/MAR11060PartialLoad.png
+ :width: 200px
+ :align: right
+
+
+#. :ref:`Load <algm-Load>` MAR11060.raw, but this time set SpectrumMin to be "100" and
+ SpectrumMax to be "200". Because the values are inclusive, we are
+ actually loading 101 spectra, starting at 100.
+#. Display the matrix window to view the data:
+
+ |ShowMatrixOfMar11060|
+#. In the matrix window highlight rows 0-2 and bring up the right-click
+ menu:
+
+ |MatrixDisplayRightClickOptions|
+#. Select multiple rows using one of the following methods:
+
+ - Click the first index label, and then hold shift while selecting
+ the last.
+ - Click and drag down the index labels to select as many as you
+ want.
+ - Click while holding Ctrl to select / deselect individual rows.
+
+#. You will presented with 3 options for plotting the selected spectra,
+ which are plotting with and without errors or plotting the spectra as
+ a waterfall. The latter option is only available if more than one
+ spectra has been selected. Select "Plot Spectra" (showing the values
+ only):
+
+.. image:: ../../images/Spectrum100to102Mar11060.png
+ :width: 400px
+.. FIXME (inline definition does not allow align) :align: centre
+
+ :alt: centre|
+
+ centre\|
+
+Notice the legend entries "MAR11060-sp-100", ..., "MAR11060-sp-102",
+where "sp" is shorthand for spectrum.
+
+Adding a curve to an existing plot
+==================================
+
+There are two ways to add spectra to an already existing graph, either
+from the same workspace of from another.
+
+Drag and Drop
+-------------
+
+#. Drag the :ref:`Workspace <Workspace>` from the Workspace List and drop it onto the graph
+ you want to add the curve to.
+#. If the :ref:`Workspace <Workspace>` contains more than one spectra you will be asked
+ which you wish to add to the plot.
+
+From Another Plot
+-----------------
+
+#. Create a plot containing the spectra or curve you want to import into
+ your destination plot.
+#. In the destination plot double click the "1" in the top left.
+#. In the "Add/Remove Curves Dialog" that appears, select the data you
+ want from the available data, and click "->" to add it to your plot.
+
+.. |ShowMatrixOfMar11060| image:: ../../images/ShowMatrixOfMar11060.PNG
+ :width: 300px
+
+.. |MatrixDisplayRightClickOptions| image:: ../../images/MatrixDisplayRightClickOptions.PNG
+ :width: 300px
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_data_2D.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_data_2D.rst
new file mode 100644
index 0000000000000000000000000000000000000000..ca35f14c5595128ade641fa4f1f8f059bb8061c8
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_data_2D.rst
@@ -0,0 +1,108 @@
+.. _train-MBC_Displaying_data_2D:
+
+==================
+Displaying data 2D
+==================
+
+Plotting All Spectra
+====================
+
+We have previously seen how to plot one or more rows from a dataset.
+Here we will show how to visually inspect entire datasets.
+
+#. :ref:`Load <algm-Load>` the MAR11060 dataset.
+#. Right click the workspace in the workspace list and select "Colour
+ Fill Plot". This will create a fairly boring blue display of the
+ data, because one spectrum contains much higher counts than any of
+ the other spectra, and the color scale has adjusted accordingly.
+#. To make the colour fill plot more sensitive to its smaller features,
+ right-click on the plot and select "Colour Bar->Log Scale".
+#. Finally, right-clicking on the colour bar and selecting 'Rescale to
+ show all' will give a more meaningful result:
+
+.. image:: ../../images/ColourFillPlotMar11060.PNG
+
+
+Plotting from the Matrix View
+=============================
+
+.. image:: ../../images/Plot3DMenu.png
+ :align: right
+
+
+As long as this matrix is in focus, the MantidPlot menubar will contain
+a menu called "3D Plot". This contains many options for plotting full
+datasets. The "Color Fill" option is one of the most useful among them.
+
+Changing the Colour Map
+-----------------------
+
+There are several colour maps to choose from that are already installed
+with Mantid:
+
+#. Double-click within the data of the plot (or right-click and select
+ "Properties").
+#. In the "Plot Details" dialog that appears select "Layer Details" in
+ the left-hand pane.
+#. Select "Custom Color Map" in "Colors" tab, click the "Select
+ ColourMap" button, and select any of the colour map files.
+
+Creating Your Own Colour Map
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you don't like any of the colour maps you can create your own. The
+files are just 256 entries of Red, Green and Blue values (0-255 for
+each)::
+
+ ...
+ 120Â 136Â 260
+ 124Â 140Â 260
+ 128Â 144Â 260
+ 128Â 144Â 260
+ 132Â 148Â 260
+ 136Â 152Â 260
+ 140Â 152Â 260
+ 140Â 156Â 211
+ 144Â 160Â 211
+ 148Â 160Â 211
+ 148Â 164Â 211
+ 152Â 168Â 211
+ 156Â 168Â 211
+ 160Â 172Â 211
+ ...
+
+Contour Lines
+=============
+
+.. image:: ../../images/ContourLinesDialog.png
+ :width: 300px
+ :align: right
+
+
+You can plot contour lines onto your colour maps.
+
+#. Double-click within the data of the plot (or right-click and select
+ "Properties").
+#. In the "Plot Details" dialog that appears select "Layer details" in
+ the left hand pane.
+#. Select the "Contour Lines" tab.
+#. Here you can set the values for the contours; the pen contour, line
+ thickness, etc.
+#. Click "OK" and the contour lines will appear on your plot:
+
+.. image:: ../../images/ContourPlot.png
+ :width: 400px
+
+
+Spectrum Viewer
+===============
+
+The Spectrum viewer is a useful way to investigate 2D image data. You
+can rapidly look through the spectrum and bin data for any point in the
+2D map. To launch the Spectrum Viewer just right-click on the MAR11060
+Workspace and select 'Show Spectrum Viewer':
+
+.. image:: ../../images/ImageViewer.png
+ :width: 600px
+ :align: center
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_data_Complex.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_data_Complex.rst
new file mode 100644
index 0000000000000000000000000000000000000000..09babb2c50b1d150a1cf945337db7f0228676068
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_data_Complex.rst
@@ -0,0 +1,39 @@
+.. _train-MBC_Displaying_data_Complex:
+
+Making a more complex example - Add a new layer to a plot
+=========================================================
+
+Adding a layer to a plot is, for example, like using subplots in
+Matplotlib or Matlab.
+
+#. Create a plot of spectra 5-7 from MAR11060.
+#. Create a second plot of spectra 8 and 9.
+#. Click on the plot window "MAR11060-1" and select the MantidPlot menu
+ Graph->"Add layer" to add a new layer to this plot window. When
+ presented with a window with the title "MantidPlot - Guess best
+ origin for the new layer?", choose the default value of "Guess".
+#. Right-click on the plot window "MAR11060-1" and select "Add/Remove
+ Curve...". This will open an "Add/Remove curves" window.
+#. Select in "Available data" the datasets "MAR11060-sp-8" and
+ "MAR11060-sp-9" and use the right arrow to move these into the graph
+ contents. Then press the "OK" button.
+#. Note that the labels of the new layers are set to "X axis Title", "Y
+ axis Title" and "Title". Change these (by double-clicking on them) to
+ "Time-of-flight / microsecond", "Counts" and "Something".
+#. Right-click on the plot while '2' is highlighted in the top left
+ corner, and select Axes->"Log(x),Log(y)" to change both the axes of
+ the 2nd layer to logarithmic scales.
+#. Add a legend to the 2nd layer by selecting Graph->"Add New Legend".
+#. Change the dimensions of this layer so that it is the same size as
+ the previous layer.
+#. Double-click on the new legend and change/move these legends until
+ you get a result similar to the following:
+ |TwoLayersExampleMBC.PNG|
+#. When you're happy, you can export the plot to a number of different
+ formats by right-clicking on the plot and selecting Export->Window,
+ then for example saving the plot to a .jpeg file.
+
+
+.. |TwoLayersExampleMBC.PNG| image:: ../../images/TwoLayersExampleMBC.PNG
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_data_Formatting.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_data_Formatting.rst
new file mode 100644
index 0000000000000000000000000000000000000000..26f1cedd42b82033d036c8973bd3a482bd303dca
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Displaying_data_Formatting.rst
@@ -0,0 +1,97 @@
+.. _train-MBC_Displaying_data_Formatting:
+
+Floating and Docking a Window
+=============================
+
+By default on Windows a plot window will be floating, meaning it can be
+dragged outside the main MantidPlot work area. For Linux versions,
+windows do not float by default as they have a tendency to get lost
+behind the main application window. The state of the selected window can
+be controlled using the "Windows Menu".
+
+#. Use "Windows->Change to docked". This will dock this plot window
+ within MantidPlot.
+#. Use "Windows->Change to floating" to float it again.
+
+The Plot Toolbar
+================
+
+This toolbar is only active when a plot window is selected.
+
+image:: ../../images/PlotToolbar.png
+
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+| Icon | Command | Key | Description |
++==================================================================+==========================================================================================================================================+================+============================================================================================================================================+
+| .. image:: ../../images/disable_plotToolbar.png | Selection Tool | Â | Sets the mouse to the normal pointer mode. This is useful when you want to select items within the plot or axes. |
+| :alt: disable_plotToolbar.png | | | |
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+| .. image:: ../../images/PanZoom_plotToolbar.png | `Zoom in or out and drag canvas <http://www.mantidproject.org/MantidPlot:_The_Data_Menu#Data_-.3E_Zoom_in_.28Ctrl-.2B.29>`__ | Shift+ +/- | Click this tool and then move the mouse wheel over the plot to zoom in/out the active plot. The left mouse button drags the active plot. |
+| :alt: PanZoom_plotToolbar.png | | | |
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+| .. image:: ../../images/zoomin_plotToolbar.png | `Zoom in <http://www.mantidproject.org/MantidPlot:_The_Data_Menu#Data_-.3E_Zoom_in_.28Ctrl-.2B.29>`__ | Ctrl+ + | Zooms in to the plot. |
+| :alt: zoomin_plotToolbar.png | | | |
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+| .. image:: ../../images/zoomout_plotToolbar.png | `Zoom out <http://www.mantidproject.org/MantidPlot:_The_Data_Menu#Data_-.3E_Zoom_out_.28Ctrl--.29>`__ | Ctrl+ - | Zooms out of the plot. |
+| :alt: zoomout_plotToolbar.png | | | |
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+| .. image:: ../../images/rescaletoall_plotToolbar.png | Rescale to Show All | Ctrl+Shift+R | Rescales the axes to show all data points. |
+| :alt: rescaletoall_plotToolbar.png | | | |
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+| .. image:: ../../images/screenreader_plotToolbar.png | `Screen Reader <http://www.mantidproject.org/MantidPlot:_The_Data_Menu#Data_-.3E_Screen_Reader>`__ | Â | Switches the plot to the "Screen Reader" mode. This allows you to read off axis values more accurately. |
+| :alt: screenreader_plotToolbar.png | | | |
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+| .. image:: ../../images/Fit_PlotToolbar.png | `Fit Function/peak <http://www.mantidproject.org/MantidPlot:_Simple_Peak_Fitting_with_the_Fit_Wizard#Peak_Fit_Toolbar>`__ | Â | Opens the "Fit Function" toolbox for fitting peaks or models to your data. |
+| :alt: Fit_PlotToolbar.png | | | |
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+| .. image:: ../../images/addtext_plotToolbar.png | `Add Text <http://www.mantidproject.org/MantidPlot:_The_Graph_Menu#Graph_-.3E_Add_Text_.28Alt-T.29>`__ | Alt+T | Adds a new text element in the active plot. |
+| :alt: addtext_plotToolbar.png | | | |
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+| .. image:: ../../images/drawarrow_plotToolbar.png | `Draw Arrow <http://www.mantidproject.org/MantidPlot:_The_Graph_Menu#Graph_-.3E_Draw_Arrow_.28Ctrl-Alt-A.29>`__ | Ctrl+Alt+A | Adds a new arrow on the active plot. |
+| :alt: drawarrow_plotToolbar.png | | | |
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+| .. image:: ../../images/drawline_plotToolbar.png | `Draw Line <http://www.mantidproject.org/MantidPlot:_The_Graph_Menu#Graph_-.3E_Draw_Line_.28Ctrl-Alt-L.29>`__ | Ctrl+Alt+L | Adds a new line on the active plot. |
+| :alt: drawline_plotToolbar.png | | | |
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+| .. image:: ../../images/addfunction_plotToolbar.png | `Add Function... <http://www.mantidproject.org/MantidPlot:_The_Graph_Menu#Graph_-.3E_Add_Layer_.28Alt-L.29>`__ | Ctrl+Alt+F | Adds a curve based on a function to the active plot window. |
+| :alt: addfunction_plotToolbar.png | | | |
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+| .. image:: ../../images/newlegend_plotToolbar.png | `New Legend <http://www.mantidproject.org/MantidPlot:_The_Graph_Menu#Graph_-.3E_New_Legend_.28Ctrl-L.29>`__ | Ctrl+L | Adds a new legend to the active plot window. |
+| :alt: newlegend_plotToolbar.png | | | |
++------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------+----------------+--------------------------------------------------------------------------------------------------------------------------------------------+
+
+Adjusting the Properties of Plot Windows
+========================================
+
+Many aspects of these graphs can be adjusted to fit how you want to
+display the data. Just double-click on the item you want to change. For
+example, the following are editable:
+
+- The graph title.
+- The legend text. You may also move the legend by selecting and
+ dragging it.
+- The axes labels.
+- The axes themselves. You can change the range, scaling and gridlines,
+ or even introduce axis breaks.
+- A curve allows you to set the line colour and styles.
+- Double-clicking the "1" in the corner allows you to remove curves or
+ add them from other graphs.
+
+.. image:: ../../images/LoglinearAxes.png
+ :align: right
+ :width: 300px
+
+
+Quickly changing to Log axes
+----------------------------
+
+We have a fast way to change the axes between log an linear as this is
+such a common operation.
+
+#. Right-click within the plot.
+#. Select "Axes" to quickly switch the X and Y axes.
+#. Select "Color Bar" to quickly switch the colour bar scaling.
+
+
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Exercise_Algorithms_History_EventWorkspace.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Exercise_Algorithms_History_EventWorkspace.rst
new file mode 100644
index 0000000000000000000000000000000000000000..515a8083eb1d0ae66dbc7bbbd16e7260eb35e2ee
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Exercise_Algorithms_History_EventWorkspace.rst
@@ -0,0 +1,68 @@
+.. _train-MBC_Exercise_Algorithms_History_EventWorkspace:
+
+=========================================
+Exercise Algorithms, History & Workspaces
+=========================================
+
+Exercise 1
+==========
+
+#. :ref:`Load <algm-Load>` the :ref:`EventWorkspace <EventWorkspace>` *HYS_11388_event.nxs*
+#. Sum across each spectra in the workspace using the :ref:`SumSpectra <algm-SumSpectra>`
+ algorithm. Set the **OutputWorkspace** to be called *Sum*
+#. :ref:`Rebin <algm-Rebin>` this grouped workspace, specify **OutputWorkspace** to
+ *binned* and that the bin width is *100* microseconds, and keep
+ **PreserveEvents** ticked
+#. Right-click the workspace called *binned* and choose the **Plot
+ Spectrum** option. Once the graph is plotted, leave do not delete it
+#. Events in a :ref:`EventWorkspace <EventWorkspace>` may get filtered according to other
+ recorded events during the experiments. At perhaps the simplest level
+ you can filter out events between specific times. Use
+ :ref:`FilterByTime <algm-FilterByTime>` for this. It has a parameter called
+ **StartTime**, which is the start time, in seconds, since the start
+ of the run. Events before this time are filtered out. Run
+ :ref:`FilterByTime <algm-FilterByTime>` with **StartTime**\ =\ *4000* and call the
+ **OutputWorkspace** *FilteredByTime*
+#. Drag the workspace FilteredByTime into the plot where workspace
+ *binned* is plotted. What you should see now is
+ |MBC_algorithm_example|
+#. Replay by the steps used to create the *FilteredByTime* workspace
+ from the history of this workspace
+
+Exercise 2
+==========
+
+#. Using the *Binned* workspace from the previous example as the
+ InputWorkspace, use :ref:`FilterByLogValue <algm-FilterByLogValue>` with
+ **LogName**\ =\ *proton_charge*, **MinimumValue**\ =\ *17600000*,
+ **MaximumValue**\ =\ *17890000*
+#. Overplot the OutputWorkspace over your existing plots from the
+ previous example
+#. Run :ref:`FilterBadPulses <algm-FilterBadPulses>` with **InputWorkspace**\ =\ *Binned* and
+ **LowerCutoff**\ =\ *99.999*
+#. Overplot the *OutputWorkspace* over your existing plots
+
+.. image:: ../../images/MBC_Alg_Example2.png
+ :width: 500px
+
+
+Exercise 3
+==========
+
+#. :ref:`Load <algm-Load>` the same workspace used in Exercise 1, but this time perform
+ the same filtering achieved in Exercise 1 as part of the Loading
+#. :ref:`SumSpectra <algm-SumSpectra>` on your new workspace
+#. Use :ref:`RebinToWorkspace <algm-RebinToWorkspace>` to achieve the same binning as the existing
+ *Binned* workspace
+#. Plot both your newly rebinned workspace and *FilteredByTime* created
+ in exercise 1 on a new plot.
+
+.. image:: ../../images/MBC_Alg_Example3.png
+ :width: 500px
+
+
+.. |MBC_algorithm_example| image:: ../../images/MBC_algorithm_example.png
+ :width: 500px
+
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Exercise_Connecting_Data_To_Instrument.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Exercise_Connecting_Data_To_Instrument.rst
new file mode 100644
index 0000000000000000000000000000000000000000..0d836cefd52d54aaab14f8d8201cb040eecd1817
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Exercise_Connecting_Data_To_Instrument.rst
@@ -0,0 +1,106 @@
+.. _train-MBC_Exercise_Connecting_Data_To_Instrument:
+
+==========================================
+Exercise Connecting Data To The Instrument
+==========================================
+
+Exercise 1
+==========
+
+- :ref:`Load <algm-Load>` *SXD23767.raw* into MantidPlot
+- Open the Instrument View
+- Change colour map to IDL-rainbow
+- Change the colour scale to *Log10* set the scale range to be between
+ 1 and 1e9
+- Go to the *Pick* tab. choose *Add single crystal peak*
+ |PickTabAddPeakButton.png| go to a Bragg peak and left-click. The
+ mini-plot should now be showing a plot of counts vs TOF for that
+ detector.
+- Move the mouse over the mini-plot, **right-click** the mouse and
+ select *Save plot to workspace*, plot the workspace called *Curves*
+ which should now be in the MantidPlot workspace panel.
+- Go back to the Instrument View, and the same mini-plot. This time
+ select a peak in the plot and **left-click** the mouse. A new peak
+ should be shown in the instrument view. A workspace (:ref:`PeaksWorkspace <PeaksWorkspace>`)
+ called *SingleCrystalPeakTable* should also exist now in the
+ MantidPlot workspace panel.
+
+ |MBC_PickDemo.png|
+- Double click the new :ref:`PeaksWorkspace <PeaksWorkspace>` to open it as a table and verify
+ that the TOF value is the same as shown in the mini-plot and the
+ detector ID is the same as shown in the text area above the mini plot
+- Now in the Instrument View window use the *Erase single crystal
+ peak(s)* |PickTabEraseButton.png| tool to remove the Peak just added
+
+Exercise 2
+==========
+
+Here we are going to mask out the beam stop and the edge of the main
+detector for a small angle dataset.
+
+#. :ref:`Load <algm-Load>` LOQ48097 data set.
+#. Open the Instrument View by right-clicking on the workspace and
+ selecting Show Instrument.
+#. If the Instrument View shows one of the "unwrapped" projections
+ switch to Full 3D on Render tab.
+#. Select the Axis view to Z+ (to avoid having a view with the front LOQ
+ detector in front of the main detector)
+#. Make sure that the colour map axis has the Log10 scaling. The
+ instrument display should look like this:
+
+ |LOQForMasking.png|
+#. Switch to the Mask/Group tab.
+#. Select the ellipse drawing button |PickTabEllipseButton.png|.
+#. Draw an ellipse in the middle of the panel to cover completely the
+ blue disk there.
+
+ |LOQEllipseMasking.png|
+#. Select the button for drawing an rectangular ring
+ |PickTabRectRingButton.png|
+#. Draw a ring masking the edge detectors of the panel. Use its control
+ points to adjust it to the right sizes.
+
+ |LOQRectRingMasking.png|
+#. Click |ApplyToViewButton.png| button.
+
+ |LOQAppliedMask.png|
+#. Click Apply and Save button and select As Mask to :ref:`Workspace <Workspace>`. A
+ workspace named "MaskWorkspace" is created.
+#. Click |ClearAllButton.png| button. The instrument image returns to
+ the original, all masking is removed.
+#. Right-click on "MaskWorkspace" and select Show Instrument.
+#. Change to Full 3D. The image should look like this:
+
+ |MaskWorkspaceView.png|
+
+.. |PickTabAddPeakButton.png| image:: ../../images/PickTabAddPeakButton.png
+
+.. |MBC_PickDemo.png| image:: ../../images/MBC_PickDemo.png
+ :width: 600px
+
+.. |PickTabEraseButton.png| image:: ../../images/PickTabEraseButton.png
+
+.. |LOQForMasking.png| image:: ../../images/LOQForMasking.png
+ :width: 200px
+
+.. |PickTabEllipseButton.png| image:: ../../images/PickTabEllipseButton.png
+
+.. |LOQEllipseMasking.png| image:: ../../images/LOQEllipseMasking.png
+ :width: 200px
+
+.. |PickTabRectRingButton.png| image:: ../../images/PickTabRectRingButton.png
+
+.. |LOQRectRingMasking.png| image:: ../../images/LOQRectRingMasking.png
+ :width: 200px
+
+.. |ApplyToViewButton.png| image:: ../../images/ApplyToViewButton.png
+
+.. |LOQAppliedMask.png| image:: ../../images/LOQAppliedMask.png
+ :width: 200px
+
+.. |ClearAllButton.png| image:: ../../images/ClearAllButton.png
+
+.. |MaskWorkspaceView.png| image:: ../../images/MaskWorkspaceView.png
+ :width: 200px
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Exercise_Intelligent_Fitting.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Exercise_Intelligent_Fitting.rst
new file mode 100644
index 0000000000000000000000000000000000000000..081594f22c5caf1593575681286a5fafa6dd96c3
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Exercise_Intelligent_Fitting.rst
@@ -0,0 +1,129 @@
+.. _train-MBC_Exercise_Intelligent_Fitting:
+
+===============================
+Exercise Fitting Models To Data
+===============================
+
+Exercise 1
+==========
+
+In this exercise we will fit a simple :ref:`Gaussian <func-Gaussian>` on a linear background.
+
+#. Start with :ref:`Loading <algm-Load>` the data set (GEM38370_Focussed).
+#. Plot spectrum 4.
+#. Zoom into the peak around 5 angstroms.
+
+ |GemSinglePeak.png|
+
+#. Start the fitting tool.
+#. Adjust the fitting range if needed.
+#. Make sure the fitting model is empty in the Fit Function browser. If
+ necessary clear it.
+
+ |ClearModel.png|
+
+#. Add a background function. Select :ref:`LinearBackground <func-LinearBackground>`.
+
+ |AddBackgroundOption.png|
+
+#. Add a peak. Select :ref:`Gaussian <func-Gaussian>`.
+#. Click at peak's maximum point to set initial values for the centre
+ and the height.
+#. Adjust the width.
+
+ |PreparedToFitGaussian.png|
+
+#. Run Fit.
+
+ |FittedGaussian.png|
+
+Exercise 2
+==========
+
+This exercise will mainly quiz about fitting.
+
+#. Ensure that the Fit Function panel is clear using panel option
+ Setup->'Clear model'
+#. :ref:`Load <algm-Load>` the GEM63437_focussed.nxs data. Note the workspace created is a
+ :ref:`WorkspaceGroup <WorkspaceGroup>`. This is simply a containing workspace grouping one of
+ more other workspaces. This dataset has been proceed already with
+ Mantid. How many algorithms have been applied to this processed
+ dataset?
+#. Plot the spectrum in GEM63437_focussed_2, and zoom in on the area
+ of the three peaks
+#. Associate the plot with the Fit Function panel and set fitting range
+ to be between approximately 2270 and 5000 microseconds
+#. Right click on plot and select 'Add background...' then
+ :ref:`FlatBackground <func-FlatBackground>`
+#. Right click on plot and add peak
+ :ref:`IkedaCarpenterPV <func-IkedaCarpenterPV>`. This is peak function where
+ some parameters of the peak function may be related to instrument
+ geometry. As of this writing scientist(s) of the GEM instrument
+ modified the file MantidInstall/instrument/GEM_Parameters.xml such
+ that when you added the :ref:`IkedaCarpenterPV <func-IkedaCarpenterPV>` peak it automatically
+ selected some sensible starting parameter values. This is evident
+ from the starting guess of the peak width but also by inspecting this
+ function in the Fit Function panel
+#. Hold down shift key and click on top of the two other peaks
+#. Plot (fitting) guess and what you should see is something similar to
+
+ |ExerciseFittingMBCguess.PNG|
+
+ where the red line is the guess
+
+#. Remove plot guess
+#. Fit the data with the model, where the output should be something
+ similar to
+
+ |ExerciseFittingMBCfit.PNG|
+
+ where the red line is here the fit
+
+#. clear the model
+#. Plot the spectrum in GEM63437_focussed_3
+#. Using the same background and peak fitting function as above fit the
+ region between about 2000 and 9400 microseconds, and obtain a result
+ similar to
+
+ |ExerciseFittingMBCfit 2.PNG|
+
+ .. note:: this will take a while as it is a fit with almost 40
+ independent parameters to optimise.
+
+#. Optionally using a similar approach try to fit the spectrum in for
+ example GEM63437_focussed_5
+
+Exercise 3
+==========
+
+#. :ref:`Load <algm-Load>` the MUSR00015189 data set.
+#. Plot a spectrum.
+#. Start the fitting interface.
+#. Follow the steps described earlier to add and set up a user defined
+ function (:ref:`UserFunction <func-UserFunction>`).
+#. Define a function with Formula = h\*exp(-a\*x)
+#. Fit the data.
+
+
+.. |GemSinglePeak.png| image:: ../../images/GemSinglePeak.png
+ :width: 400px
+
+.. |ClearModel.png| image:: ../../images/ClearModel.png
+
+.. |AddBackgroundOption.png| image:: ../../images/AddBackgroundOption.png
+ :width: 400px
+
+.. |PreparedToFitGaussian.png| image:: ../../images/PreparedToFitGaussian.png
+ :width: 400px
+
+.. |FittedGaussian.png| image:: ../../images/FittedGaussian.png
+ :width: 400px
+
+.. |ExerciseFittingMBCguess.PNG| image:: ../../images/ExerciseFittingMBCguess.PNG
+ :width: 400px
+
+.. |ExerciseFittingMBCfit.PNG| image:: ../../images/ExerciseFittingMBCfit.PNG
+ :width: 400px
+
+.. |ExerciseFittingMBCfit 2.PNG| image:: ../../images/ExerciseFittingMBCfit2.PNG
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Exercise_Loading_And_Displaying_Data.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Exercise_Loading_And_Displaying_Data.rst
new file mode 100644
index 0000000000000000000000000000000000000000..889bc8e485d274d87a4cd5bde93c41f43237af70
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Exercise_Loading_And_Displaying_Data.rst
@@ -0,0 +1,49 @@
+.. _train-MBC_Exercise_Loading_And_Displaying_Data:
+
+====================================
+Exercise Loading And Displaying Data
+====================================
+
+Part 1
+======
+
+#. :ref:`Load <algm-Load>` the File "GEM38370_Focussed_Legacy.nxs".
+#. Plot spectra 2-7 (all of them).
+#. Edit the d-spacing axis range, or zoom into the range of 0-10
+ angstroms.
+#. Try changing the X-Axis to log scaling.
+
+Part 2
+======
+
+#. :ref:`Load <algm-Load>` the SANSLOQCan2D.nxs data. This is the output of a 2D SANS data
+ reduction. Although a :ref:`Workspace2D <Workspace2D>` is mainly designed to store
+ spectra, this is just the default, and in this data the loaded axes
+ are momentum transfer Qx and the scattering cross section, and the
+ 'spectrum' axis is momentum transfer Qy.
+#. Plot this data as a colour fill plot to get the following result:
+ |Sans2Dcolourfillplotexercise1MBC|
+#. Change the colour bar axis to logarithm.
+#. Change the Colour Map to Jet.
+#. Create Contour Lines and labels in White at 20, 30 and 40.
+#. Zoom in to see the results of your work.
+
+Part 3
+======
+
+#. Using the workspace GEM38370_Focussed_Legacy try to reproduce the
+ graph below.
+
+ - You will need to add three layers to the graph.
+ - It is easier to start off with all three spectra in the first
+ graph.
+ - Use the approach of double clicking on the layer label (top left
+ numbers) to set the data for each layer.
+
+.. image:: ../../images/MultiLayerGraph.png
+ :width: 600px
+ :align: center
+
+
+.. |Sans2Dcolourfillplotexercise1MBC| image:: ../../images/Sans2Dcolourfillplotexercise1MBC.PNG
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Fit_Model_Choices.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Fit_Model_Choices.rst
new file mode 100644
index 0000000000000000000000000000000000000000..4f9858198650ad63505102ae1c6175cf4b52744c
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Fit_Model_Choices.rst
@@ -0,0 +1,99 @@
+.. _train-MBC_Fit_Model_Choices:
+
+
+=================
+Fit Model Choices
+=================
+
+Mantid containing a constant increasing catalogue of predefined fitting
+function which can be used to create a model. Some of these well be
+demonstrated here. In addition you can create new fitting functions using the Fit
+Function toolbox or by extending Mantid using a plugin mechanism.
+The former will be covered here.
+
+Multiple peaks + background
+===========================
+
+Mantid allows one to fit overlapping peaks on a common background. Just
+follow the steps described earlier to add more peaks to the model. The
+peaks don't have to be of the same type.
+
+.. image:: ../../images/FittingMultiplePeaks.png
+ :width: 500px
+
+
+Non peak model + background
+===========================
+
+Mantid fitting tool isn't limited to peaks and backgrounds. You can
+select any other function from a list offered by the "Add other
+function.." option.
+
+.. image:: ../../images/AddOtherFunctionOption.png
+ :width: 400px
+
+
+Use custom fitting function
+===========================
+
+User defined function
+---------------------
+
+Mantid provides a user defined function called :ref:`UserFunction <func-UserFunction>`. It has an
+attribute called "Formula" which accepts a text string with a
+mathematical formula. All variables in the formula are treated as
+parameters except for "x" which is the argument.
+
+.. image:: ../../images/AddedUserFunction.png
+ :width: 200px
+
+
+The formula can either be entered in the text editor in the Fit Function
+browser or constructed with the help of the User Function Dialog.
+
+.. image:: ../../images/UserFunctionDialog.png
+ :width: 500px
+
+
+Edit your function in the text field, browse and add (|AddButton.png|)
+to your formula any built-in or saved function. The fitting parameters
+are extracted automatically and displayed in the Parameters read-only
+field. If the field is empty then your formula contains errors.
+
+When finished click the Use button |UseButton.png| to insert the formula
+into the Fit Function browser.
+
+The constructed formula can be saved permanently for future use. Click
+the Save button |SaveButton.png| to see the dialog:
+
+.. image:: ../../images/SaveUserFunctionDialog.png
+ :width: 200px
+
+
+Now your function appears in the list of available functions:
+
+.. image:: ../../images/SavedFunctionRecord.png
+ :width: 500px
+
+
+Any unwanted function can be removed from the list using
+|RemoveButton.png| button.
+
+Tabulated function
+------------------
+
+A :ref:`TabulatedFunction <func-TabulatedFunction>` takes its values from a file or a workspace
+
+.. image:: ../../images/TabulatedFunction.png
+ :width: 200px
+
+
+.. |AddButton.png| image:: ../../images/AddButton.png
+
+.. |UseButton.png| image:: ../../images/UseButton.png
+
+.. |SaveButton.png| image:: ../../images/SaveButton.png
+
+.. |RemoveButton.png| image:: ../../images/RemoveButton.png
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Getting_set_up.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Getting_set_up.rst
new file mode 100644
index 0000000000000000000000000000000000000000..6668f6e6c52ff109da12183ff53b8e08fb5d8aa4
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Getting_set_up.rst
@@ -0,0 +1,82 @@
+.. _train-MBC_Getting_set_up:
+
+Installing Mantid
+=================
+
+If you do not already have Mantid installed then Mac, Linux and Windows
+binaries are available to
+`download <http://download.mantidproject.org/>`__ (using the "Latest
+Release" is recommended). On Windows the result of the install is that
+you should have a desktop icon called MantidPlot on your desktop:
+
+.. image:: ../../images/MantidPlotDesktopIcon.PNG
+
+A more detailed screencast on how to install Mantid is also
+`available <http://files.mantidproject.org/videos/Installation.htm>`__.
+
+Getting the Data Files
+======================
+
+**Note: This section has already been done on the Course provided
+computers.**
+
+#. The data you need to follow the Mantid Basic Course (MBC) tutorials
+ can be downloaded from the `Mantid download
+ page <http://download.mantidproject.org>`__. Pick the
+ "TrainingCourseData.zip" file from the sample data section.
+ |NewTrainingData.jpg|
+
+
+#. Place the files in c:\\MantidInstall\\data on windows, and somewhere
+ in your home directory on Mac or Linux.
+
+MantidPlot First-Time Setup
+===========================
+
+The first time you start Mantidplot you will be presented with a
+configuration window.
+
+.. image:: ../../images/MantidPlotStartUpWindow.PNG
+ :width: 300px
+
+Default Instrument and Directories
+----------------------------------
+
+.. image:: ../../images/ManageDirectories.png
+ :width: 300px
+ :align: right
+
+#. If you have a favourite instrument go ahead and select it, otherwise
+ select ISIS and MARI.
+#. Click on the "Manage User Directories" button.
+
+ #. Click "Browse To Directory" and navigate to the location of the
+ data files (c:\\mantidinstall\\data).
+ #. Do the same for the default save directory.
+ #. Click "OK".
+
+#. Click "Set".
+
+You can always get this back using the Help->First Time Setup menu item.
+Manage User Directories is available from a number of other locations
+also, see `here <http://www.mantidproject.org/ManageUserDirectories>`__.
+
+Default Settings
+----------------
+
+Mantid can plot data with the intensity normalized by the bin width, and
+this is the default behaviour for all histogram and event data. As we
+are not going to use this normalization in this course we need to change
+the default settings. To do that, go to "View"->"Preferences..." and in
+the new window select "2D Plots" and untick "Normalize histograms to bin
+width".
+
+.. image:: ../../images/MantidChooseDefaultSettings.png
+
+
+
+.. |NewTrainingData.jpg| image:: ../../images/NewTrainingData.jpg
+ :width: 500px
+
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_History.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_History.rst
new file mode 100644
index 0000000000000000000000000000000000000000..3a1b9f7cf79ef779f90c284d7bb3eace25d09df4
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_History.rst
@@ -0,0 +1,39 @@
+.. _train-MBC_History:
+
+Algorithm History
+=================
+
+Mantid keeps the entire history of all algorithms applied to workspaces.
+Not only does this allow you to audit the data reduction and analysis,
+it also provides the means to extract a re-executable python script from
+the GUI.
+
+#. Right click on HYS_11388_event and select 'Show History'. This will
+ open up the Algorihm History window. In the left-hand side Algorithms
+ panel click on the arrow in front of :ref:`Rebin <algm-Rebin>` v.1 and should see the
+ following:
+
+ |HistoryRebinOfCNCS 7860 event.PNG|
+
+ This reveals the history done to this workspace, i.e. :ref:`Load <algm-Load>` to load
+ the workspace, :ref:`SumSpectra <algm-SumSpectra>`, and three Rebins.
+
+To replay the history do:
+
+#. From the main MantidPlot menu Select **View->Script Window**, this
+ opens the 'MantidPlot: Python Window'
+#. Go back to Algorithm History window and press the 'Script to
+ Clipboard' button and close the Algorithm History window
+#. Flip to the script window ('MantidPlot: Python Window') and paste
+ what was copied to the clipboard into the script window
+#. Close the HYS_11388_event-1 plot window
+#. Delete the HYS_11388_event workspace from the Algorithms panel
+#. To recreate the work you have just done script window execute the
+ script via **Execute->Execute All** on the script window.
+#. To verify that history has been replayed either look at history or
+ plot spectrum again
+
+
+
+.. |HistoryRebinOfCNCS 7860 event.PNG| image:: ../../images/HistoryRebinOfCNCS7860 event.PNG
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Instrument_Tree.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Instrument_Tree.rst
new file mode 100644
index 0000000000000000000000000000000000000000..ccdc5f623b81f1bd5366681fc67fe7999c6fac3b
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Instrument_Tree.rst
@@ -0,0 +1,17 @@
+.. _train-MBC_Instrument_Tree:
+
+Instrument Tree
+===============
+
+The Instrument Tree tab allows you to see parts of the instrument in
+isolation. Select a part in the tree widget and the display will show
+only the selected part.
+
+.. image:: ../../images/InstrumentTree.png
+ :width: 400px
+
+
+.. raw:: mediawiki
+
+ {{SlideNavigationLinks|MBC_Masking_and_Grouping|Mantid_Basic_Course|MBC_Exercise_Connecting_Data_To_Instrument}}
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Intelligent_Fitting.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Intelligent_Fitting.rst
new file mode 100644
index 0000000000000000000000000000000000000000..9068691c65ad0cef555d7a3ddcb0d4cfb843f540
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Intelligent_Fitting.rst
@@ -0,0 +1,47 @@
+.. _train-MBC_Intelligent_Fitting:
+
+Intelligent Fitting
+===================
+
+Fitting is the modelling of data where parameters of the model are
+allowed to vary during a fitting process until the agreement between
+model and data agree better according to some cost function.
+
+In summary the Mantid fitting provides
+
+- General fitting capabilities
+- Neutron and Muon intelligent fitting tools, which makes use of
+ additional information about the data, such as instrument geometry
+ and log value information
+- Easily expandable
+
+Here a more advanced aspect of Mantid fitting is presented. We will fit
+an asymmetric peak from a GEM data set with the Ikeda-Carpenter function
+on a :ref:`LinearBackground <func-LinearBackground>`.
+
+| Let's load GEM63437_focussed.nxs file and plot GEM63437_focussed_3
+ workspace. Zoom into the region 4300 - 4900 microseconds.
+| |GEMAsymmetricPeak.png|
+
+| Try to fit it with a :ref:`Gaussian <func-Gaussian>` (plus :ref:`LinearBackground <func-LinearBackground>`):
+| |GEMGaussianFit.png|
+
+Not a very good job. The :ref:`Ikeda-Carpenter <func-IkedaCarpenterPV>` function is a better
+choice here. But this is a very difficult function to work with. It
+requires very good initial parameter values for the fit to converge. The
+Mantid approach is to use the pre-set values which are defined on a
+per-instrument basis. For example, when the :ref:`Ikeda-Carpenter <func-IkedaCarpenterPV>` function is used with
+GEM data the fitting tools automatically find and set the appropriate
+initial values. This results in a good fit.
+
+.. image:: ../../images/GEMIkedaCarpenterFit.png
+ :width: 400px
+
+
+.. |GEMAsymmetricPeak.png| image:: ../../images/GEMAsymmetricPeak.png
+ :width: 400px
+
+.. |GEMGaussianFit.png| image:: ../../images/GEMGaussianFit.png
+ :width: 400px
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Interfaces.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Interfaces.rst
new file mode 100644
index 0000000000000000000000000000000000000000..088d45aca63f57aa899b5a9b1eca46286dd24a65
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Interfaces.rst
@@ -0,0 +1,48 @@
+.. _train-MBC_Interfaces:
+
+.. image:: ../../images/InterfacesMenu.png
+ :align: right
+
+Custom Interfaces
+=================
+
+Some analysis workflows are too complex, need more
+user input or need a better way to present the results than a single
+algorithm interface can provide. This is where custom interfaces come
+in. These are pluggable interfaces for Mantidplot that are loaded at run
+time to give a much richer interface to work with for your data
+analysis. Several interfaces have now been developed to handle different
+aspects of the reduction and analysis workflow for data from the various
+scientific techniques.
+
+An Example - The Muon Analysis Interface
+========================================
+
+The muon analysis interface is an example that uses both algorithmic
+analysis, plotting and curve fitting within one interface to provide a
+single interface that covers a large proportion of the analysis required
+for basic muon spin resonance.
+
+.. image:: ../../images/MuonAnalysisInterface.png
+ :width: 400px
+
+A simple walkthrough
+--------------------
+
+#. Start the interface with the Interfaces->Muon Analysis Menu
+#. On the Settings tab set the end value to 10
+#. On the Home tab change the instrument to Emu
+#. Enter 20884 in the :ref:`Load <algm-Load>` Run box and hit enter
+#. You will get a plot of the Asymetry of the data
+#. You can change the plot data drop down box to see other plot types
+#. With the Asymetry plot visible, go to the Data Analysis Tab
+#. Right click the grey Functions bar and "Add Function"
+#. Under Muon select :ref:`ExpDecayOsc <func-ExpDecayOsc>` and click ok
+#. Click :ref:`Fit <algm-Fit>` under the fit button, the fitted data is displayed on the
+ graph
+#. On the Results Table tab click the Field_Danfysik and Temp_D logs
+ and click create table
+#. A table with all of the fit parameters and the selected log values is
+ created
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Introduction.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Introduction.rst
new file mode 100644
index 0000000000000000000000000000000000000000..9660d13b01952246f9876b42fc5fb89c9b11e654
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Introduction.rst
@@ -0,0 +1,40 @@
+.. _train-MBC_Introduction:
+
+About Mantid
+============
+
+The Mantid Framework has been created to manipulate and analyse neutron
+and muon scattering data.
+
+The MantidPlot Graphical User Interface (GUI) is one way in which this
+framework has been exposed to users. MantidPlot also utilises a set of
+tools offered by the scientific visualisation software "QtiPlot", which
+like Mantid is also open-source.
+
+In addition to the GUI, Python scripts can be executed (both inside and
+outside of MantidPlot) that allow the automation of complex interactions
+with the framework.
+
+The dependencies between the various parts of Mantid can be visualised
+as follows:
+
+.. image:: ../../images/ImportantMantidPlotDependences.PNG
+
+
+The aim of this tutorial is to present an overview of the MantidPlot
+GUI.
+
+Issues
+======
+
+Instructors will be around during the course, but afterwards help will
+also available. The Mantid Development Team can be contacted either by
+navigating to the 'Contact Us' section of the `Mantid
+Wiki <http://www.mantidproject.org/Main_Page>`__, or by using the "Help" menu from within MantidPlot
+itself:
+
+.. image:: ../../images/MBC MantidPlotaskforhelp.PNG
+
+
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Investigating_Data.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Investigating_Data.rst
new file mode 100644
index 0000000000000000000000000000000000000000..d3aa4739fcee2e2fe1b8056606c82c1c6e903f47
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Investigating_Data.rst
@@ -0,0 +1,164 @@
+.. _train-MBC_Investigating_Data:
+
+The Pick tab on the controls panel allows you to see the data in the
+workspace.
+
+The Toolbar
+===========
+
+| |PickTabToolButtons.png|
+
++---------------------------------------------------+--------------------------------------------+
+|Icon | Description |
++===================================================+============================================+
+|.. image:: ../../images/PickTabZoomButton.png | Navigate in the instrument display window. |
++---------------------------------------------------+--------------------------------------------+
+|.. image:: ../../images/PickTabEditButton.png | Edit a shape. |
++---------------------------------------------------+--------------------------------------------+
+|.. image:: ../../images/PickTabEllipseButton.png | Draw an ellipse. |
++---------------------------------------------------+--------------------------------------------+
+|.. image:: ../../images/PickTabRectButton.png | Draw a rectangle. |
++---------------------------------------------------+--------------------------------------------+
+|.. image:: ../../images/PickTabElRingButton.png | Draw an elliptical ring. |
++---------------------------------------------------+--------------------------------------------+
+|.. image:: ../../images/PickTabRectRingButton.png | Draw a rectangular ring. |
++---------------------------------------------------+--------------------------------------------+
+|.. image:: ../../images/PickTabPickPixelButton.png | Select a single detector. |
++---------------------------------------------------+--------------------------------------------+
+|.. image:: ../../images/PickTabPickTubeButton.png | Select a tube/bank. |
++---------------------------------------------------+--------------------------------------------+
+|.. image:: ../../images/PickTabAddPeakButton.png | Add a single crystal peak. |
++---------------------------------------------------+--------------------------------------------+
+|.. image:: ../../images/PickTabEraseButton.png | Erase a peak. |
++---------------------------------------------------+--------------------------------------------+
+
+Picking a Single Detector
+=========================
+
+The Single Pixel tool |PickSingleDetector.png| displays the detector
+data in the mini-plot at the bottom of the tab.
+
+.. image:: ../../images/Miniplot.png
+
+
+Hover the mouse over a detector and see the mini-plot update.
+
+Picking a Tube
+==============
+
+The Tube selection tool |PickTube.png| is useful for tube instruments.
+When it's on the mini-plot displays the integrated data in the whole
+tube. The integration is done either over the detectors in the tube (Sum
+option) or over time (Integrate). To switch between the option use the
+context menu of the mini-plot:
+
+.. image:: ../../images/SumIntegrateMenu.png
+
+
+|
+
+Summing over the detectors
+--------------------------
+
+With the Sum option the mini-plot displays a sum of the counts in all
+detectors in a tube vs time of flight.
+
+.. image:: ../../images/MiniplotSum.png
+
+
+Integrating over the time of flight
+-----------------------------------
+
+With the Integrate option the mini-plot displays the counts integrated
+over time of flight vs detector position in the tube.
+
+| |MiniplotIntegrate.png|
+
+Detector positions can be shown as detector IDs, or distance form a
+tube's end, or the φ angle. Switch between the units using the
+mini-plot's context menu.
+
+.. image:: ../../images/DetectorPositionOptions.png
+
+
+Navigate
+========
+
+The |PickTabZoomButton.png| tool button switches on the navigation mode
+which is the same as in Render Tab.
+
+Selecting Arbitrary Sets of Detectors
+=====================================
+
+The rest of the buttons in the top row are for making complex
+selections. Buttons
+|PickTabEllipseButton.png|\ |PickTabRectButton.png|\ |PickTabElRingButton.png|\ |PickTabRectRingButton.png|
+are for drawing shapes, |PickTabEditButton.png| is for editing them.
+
+Draw an ellipse
+---------------
+
+#. Click the |PickTabEllipseButton.png| button.
+#. Click and hold the mouse button down to start drawing.
+#. Drag to resize.
+
+.. image:: ../../images/DrawingEllipse.png
+
+
+Edit a shape
+------------
+
+#. Switch on the editing tool |PickTabEditButton.png|.
+#. Click on a shape you would like to edit. The selected shape displays
+ control points as small white rectangles.
+#. Drag the control points to resize the shape.
+#. To translate the shape click inside its shaded area and drag.
+
+To select multiple shapes draw a rubber band around them.
+
+.. image:: ../../images/SelectMuplipleShapes.png
+
+
+The selected shapes are indicated by drawing a bounding box around each
+of them.
+
+.. image:: ../../images/SelectedMuplipleShapes.png
+
+
+Only translation is possible for a multiple selection.
+
+Sum selected detectors
+----------------------
+
+The mini-plot automatically sums the counts in the detectors covered by
+the shapes and plots them vs time of flight.
+
+.. |PickTabToolButtons.png| image:: ../../images/PickTabToolButtons.png
+
+.. |PickTabZoomButton.png| image:: ../../images/PickTabZoomButton.png
+
+.. |PickTabEditButton.png| image:: ../../images/PickTabEditButton.png
+
+.. |PickTabEllipseButton.png| image:: ../../images/PickTabEllipseButton.png
+
+.. |PickTabRectButton.png| image:: ../../images/PickTabRectButton.png
+
+.. |PickTabElRingButton.png| image:: ../../images/PickTabElRingButton.png
+
+.. |PickTabRectRingButton.png| image:: ../../images/PickTabRectRingButton.png
+
+.. |PickTabPickPixelButton.png| image:: ../../images/PickTabPickPixelButton.png
+
+.. |PickTabPickTubeButton.png| image:: ../../images/PickTabPickTubeButton.png
+
+.. |PickTabAddPeakButton.png| image:: ../../images/PickTabAddPeakButton.png
+
+.. |PickTabEraseButton.png| image:: ../../images/PickTabEraseButton.png
+
+.. |PickSingleDetector.png| image:: ../../images/PickSingleDetector.png
+
+.. |PickTube.png| image:: ../../images/PickTube.png
+
+.. |MiniplotIntegrate.png| image:: ../../images/MiniplotIntegrate.png
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Live_Data_Simple_Examples.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Live_Data_Simple_Examples.rst
new file mode 100644
index 0000000000000000000000000000000000000000..e4485e5127fcbe8a64a13d911d35e941dfb99e2e
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Live_Data_Simple_Examples.rst
@@ -0,0 +1,253 @@
+.. _train-MBC_Live_Data_Simple_Examples:
+
+
+=========================
+Live Data Simple Examples
+=========================
+
+Video example
+=============
+
+An example of using multiple live streams and full direct elastic data
+reduction can be seen at
+`http://download.mantidproject.org/videos/LiveData.htm <http://files.mantidproject.org/videos/LiveData.htm>`__.
+
+Do it yourself examples
+=======================
+
+For all of these you will need to change your Facility to TEST_LIVE.
+You will need to be using Mantid version 3.2.1 or above.
+
+#. Open the "Help" menu and select "First Time Setup"
+#. Change the default facility to TEST_LIVE and click "Set"
+
+You can follow the same approach to set your facility back afterwards.
+
+Starting a Fake Instrument
+--------------------------
+
+ISIS Event
+~~~~~~~~~~
+
+#. Run the :ref:`FakeISISEventDAE <algm-FakeISISEventDAE>` Algorithm from the Algorithms toolbox
+#. These settings will create an instrument with 100 spectra,
+ transmitting 2000 events every 20 milliseconds in 1 period. The data
+ is between 10,000 and 20,000 microseconds TOF.
+
+ #. NPeriods = 1
+ #. NSpectra = 100
+ #. Rate = 20
+ #. NEvents = 2000
+
+#. To stop the fake instrument, open the Algorithm Details window, by
+ clicking on the "Details" button at the bottom of the Algorithms
+ Toolbox. Then click "Cancel" next to :ref:`FakeISISEventDAE <algm-FakeISISEventDAE>`.
+
+ISIS Histogram
+~~~~~~~~~~~~~~
+
+#. Run the :ref:`FakeISISHistoDAE <algm-FakeISISHistoDAE>` Algorithm from the Algorithms toolbox
+#. These settings will create an instrument with 100 spectra, with 100
+ bins in 1 period.
+
+ #. NPeriods = 1
+ #. NSpectra = 100
+ #. NBins = 100
+
+#. To stop the fake instrument, open the Algorithm Details window, by
+ clicking on the "Details" button at the bottom of the Algorithms
+ Toolbox. Then click "Cancel" next to :ref:`FakeISISHistoDAE <algm-FakeISISHistoDAE>`.
+
+ADARA Fake Event
+~~~~~~~~~~~~~~~~
+
+No setup is needed, Just use the instrument "ADARA_FakeEvent" in the
+"TEST_LIVE" facility. Equally there is no need to stop this fake
+instrument.
+
+The events are sent as coming from 2 spectra, and 200 events/second,
+with a time of flight between 40,000 and 60,000.
+
+ADARA File Reader
+~~~~~~~~~~~~~~~~~
+
+This approach reads from an SNS pre-nexus file to recreate realistic
+event data, however It is a little more fiddly to setup.
+
+#. Find the file "mantid.user.properties" it's location will vary with
+ your operating system.
+
+ - Windows: c:\\MantidInstall\\bin
+ - Mac or linux: ~/.mantid (in a .mantid directory under your home
+ directory)
+
+#. Edit the file in your favorite text editor and add the following
+ lines::
+
+ fileeventdatalistener.filename=REF_L_32035_neutron_event.dat
+ fileeventdatalistener.chunks=300
+
+#. Start MantidPlot
+#. Use the instrument "ADARA_FileReader" in the "TEST_LIVE" facility.
+ There is no need to stop this fake instrument.
+
+The data from this file comprises almost 50,000 events across 77,824
+histograms, with TOF values between 6,000 and 23,000 microseconds.
+
+Starting a live data session
+----------------------------
+
+#. To open the :ref:`StartLiveData <algm-StartLiveData>` interface you can either
+
+ - click the drop down ":ref:`Load <algm-Load>`" button in the Workspaces toolbox and
+ select "Live Data"
+ - Run the :ref:`StartLiveData <algm-StartLiveData>` algorithm from the Algorithms toolbox
+
+Stopping a live data session
+----------------------------
+
+A live data session will run until it is cancelled or Mantid is closed.
+To cancel a session:
+
+#. To stop the live data session, open the Algorithm Details window, by
+ clicking on the "Details" button at the bottom of the Algorithms
+ Toolbox
+#. Find the Algorithm "MonitorLiveData" and click the "Cancel" button
+ next to it.
+
+Live Histogram Data
+~~~~~~~~~~~~~~~~~~~
+
+Setup : ISIS Histogram For Histogram data the accumulationMethod needs
+to be set to Replace, you will get a warning otherwise.
+
+#. Open the :ref:`StartLiveData <algm-StartLiveData>` interface
+#. Instrument: ISIS_Histogram
+#. Start Time: now
+#. Update Every: 1 second
+#. Processing: No Processing
+#. Accumulation Method: Replace
+#. Post Processing: No Processing
+#. OutputWorkspace: live
+
+Live Event Rebin using an algorithm
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Setup : ADARA Fake Event
+
+#. Open the :ref:`StartLiveData <algm-StartLiveData>` interface
+#. Instrument: ADARA_FakeEvent
+#. Start Time: now
+#. Update Every: 1 second
+#. Processing: Algorthim
+
+ #. Within the Processing step tab select the :ref:`Rebin <algm-Rebin>` algorithm
+ #. In the algorithm properties set **Params** to 40e3,1000,60e3
+
+#. PreserveEvents: unticked
+#. Accumulation Method: Add
+#. OutputWorkspace: live
+
+Live Event Pre and post processing
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This uses rebin to select a region of time of flight, and then after the
+data is accumulated it uses :ref:`SumSpectra <algm-SumSpectra>` to sum all of the data into a
+single spectrum. When using post processing you have to give the
+accumulation workspace a name.
+
+Setup : ADARA Fake Event
+
+#. Open the :ref:`StartLiveData <algm-StartLiveData>` interface
+#. Instrument: ADARA_FakeEvent
+#. Start Time: now
+#. Update Every: 1 second
+#. Processing: Algorithm
+
+ #. Within the Processing step tab select the :ref:`Rebin <algm-Rebin>` algorithm
+ #. In the algorthim properties set **Params** to 40e3,500,60e3
+
+#. PreserveEvents: Not Ticked
+#. Accumulation Method: Add
+#. Post Processing: Algorithm
+
+ #. Within the Post Processing step tab select the :ref:`SumSpectra <algm-SumSpectra>`
+ algorithm
+
+#. AccumulationWorkspace: accumulation
+#. OutputWorkspace: live
+
+Examples using the ADARA File Reader
+------------------------------------
+
+For these you will nedd to have performed the steps in the ADARA File
+Reader setup above.
+
+Rebinning the data & plotting
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. Open the :ref:`StartLiveData <algm-StartLiveData>` interface
+#. Start Time: now
+#. Update Every: 1 second
+#. Processing: Algorithm
+
+ #. Within the Processing step tab select the :ref:`Rebin <algm-Rebin>` algorithm
+ #. In the algorthim properties set **Params** to 6e3,200,23e3
+
+#. PreserveEvents: Not Ticked
+#. Accumulation Method: Add
+#. Post Processing: None
+#. OutputWorkspace: live
+
+Take a look at the instrument view, and try plotting spectra 38020. Both
+views should update as more data comes in.
+
+You could repeat this with the accumulation method set to Replace. That
+would give you just the events as seen over the last second.
+
+Listen and post process with python script
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. Open the :ref:`StartLiveData <algm-StartLiveData>` interface
+#. Start Time: now
+#. Update Every: 1 second
+#. Processing: Algorithm
+
+ #. Within the Processing step tab select the :ref:`SumSpectra <algm-SumSpectra>` algorithm
+
+#. PreserveEvents: Not Ticked
+#. Accumulation Method: Add
+#. Post Processing: Script
+
+ #. Within the Post Processing step tab use the script below
+
+#. OutputWorkspace: live
+
+.. code:: python
+
+ from datetime import datetime
+
+ #Now get the data, read the first spectra
+ spectra=input.readY(0)
+ #extract the first value from the array
+ count=spectra[0]
+ #output it as a log message
+ logger.notice("Total counts so far " + str(count))
+
+ #if my output workspace has not been created yet, create it.
+ if not mtd.doesExist(output):
+ table=:ref:`CreateEmptyTableWorkspace <algm-CreateEmptyTableWorkspace>`(OutputWorkspace=output)
+ table.setTitle("Event Rate History")
+ table.addColumn("str", "Time")
+ table.addColumn("int", "Events")
+
+ table = mtd[output]
+
+ table.addRow([datetime.now().isoformat(), int(count)])
+
+
+This will log the current total of events, but also creates a table
+workspace with the history of that value.
+
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Live_Data_User_Interface.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Live_Data_User_Interface.rst
new file mode 100644
index 0000000000000000000000000000000000000000..5ceba8ca10f1458a1bb30d5db2c6a32497bf85fc
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Live_Data_User_Interface.rst
@@ -0,0 +1,109 @@
+.. _train-MBC_Live_Data_User_Interface:
+
+.. image:: ../../images/LoadLiveDataButton.png
+ :align: right
+
+
+How to Start a live data stream
+===============================
+
+To start a live data stream into Mantid you need to use the
+:ref:`StartLiveData <algm-StartLiveData>` algorithm. You can do this the same
+way as any other algorithm using the Algorithms toolbox, or you can
+select the Live Data option under the :ref:`Load <algm-Load>` button.
+
+Start Live Data
+===============
+
+The start live data interface can seem quite daunting at first, but it
+is easy to do setup simple data streams quite easily, the next section
+will take you through several examples.
+
+.. image:: ../../images/StartLiveData.png
+
+
+For now I'll just introduce a few of the more common properties.
+
+Starting Time
+ This allows you to set when you want the stream to start at
+ facilities that support this. If your facility does not support
+ variable start times then the stream will start from "now".
+
+Update Every
+ Here you set the delay between each "chunk" of data being read. The
+ optimal value depends on the amount of processing you are doing, but
+ I suggest you start with something like 3 seconds.
+
+Processing
+ Here you select what processing you want to do to each live data
+ chunk on it's way to the accumulation workspace. If you choose
+ algorithm or script the Processing step pane on the right will
+ change to allow you to define the processing.
+
+Preserve Events
+ This only applies to event based live data streams. If you tick
+ preserve events the data will be maintained as events through to the
+ accumulation workspace, this allows more flexibility for filtering
+ and rebinning later, but will lead to large amounts or data
+ accumulating in memory over time, eventually the system can run out
+ of memory and the live data stream would stop.
+
+Accumulation Method
+ Here you can choose how the data is "added" into the accumulation
+ workspace. In most cases for event based data the correct option is
+ "Add", and for Histogram based data it is "Replace". There is also
+ an "append" option which will append spectra to the output
+ workspace, increasing its size.
+
+Post Processing
+ Here you select what post processing you want to do to the entire
+ data in the accumulation workspace each time a new chunk is "added".
+ If you choose algorithm or script the Post Processing step pane on
+ the right will change to allow you to define the processing.
+
+At End of Run
+ At facilities that support this you can define what you want Mantid
+ to do when one run is ended and another started.
+
+Accumulation :ref:`Workspace <Workspace>`
+ This is the name that will be used for the accumulation workspace.
+ If no post-processing is selected this is greyed out as it is not
+ needed.
+
+Output :ref:`Workspace <Workspace>`
+ The name of the output workspace containing the results you are
+ after.
+
+.. image:: ../../images/RunningAlgDetailsButton.png
+ :align: right
+
+
+How to Stop a live data stream
+==============================
+
+Once you start a live data stream it creates a background algorithm
+called MonitorLiveData which keeps the process running. This means it
+will continue until one of the following happens:
+
+#. MantidPlot (or Mantid if using through command line python) is
+ closed.
+#. You manually cancel the MonitorLiveData algorithm using the process
+ below.
+#. The run ends (although the process may continue if you set the live
+ data stream to continue on run end).
+
+To manually stop the live data stream you need to:
+
+#. Bring up the running algorithm details using the "Details" button at
+ the bottom of the algorithms toolbox (next to the progress bar).
+#. Click the cancel button next to the MonitorLiveData algorithm you
+ wish to stop.
+#. If you have more than one, clicking the arrow next to the algorithm
+ name will list all of the properties to help you select the right one
+ to cancel.
+
+|RunningAlgProgressDialog.png|
+
+.. |RunningAlgProgressDialog.png| image:: ../../images/RunningAlgProgressDialog.png
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Live_Data_Workflow.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Live_Data_Workflow.rst
new file mode 100644
index 0000000000000000000000000000000000000000..0240db233d964cb4cd10614a9e6f82722b74e806
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Live_Data_Workflow.rst
@@ -0,0 +1,12 @@
+.. _train-MBC_Live_Data_Workflow:
+
+Live Data Processing workflow
+=============================
+
+.. image:: ../../images/LiveDataCycle.png
+
+
+.. raw:: mediawiki
+
+ {{SlideNavigationLinks|MBC_Why_Live_Data|Mantid_Basic_Course|MBC_Live_Data_User_Interface}}
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Loading_Data.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Loading_Data.rst
new file mode 100644
index 0000000000000000000000000000000000000000..5905f63b4c987c9affc87dc4f1760edd528ef82c
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Loading_Data.rst
@@ -0,0 +1,100 @@
+.. _train-MBC_Loading_Data:
+
+.. image:: ../../images/ShowLoadandWorkspaceAreaInMantidPlot.PNG
+ :align: right
+
+
+Loading a File
+==============
+
+First, let's load the dataset MAR11060.raw collected on the ISIS MARI
+instrument:
+
+#. In MantidPlot click on the the "Load" button (as shown highlighted in
+ red), and select "File". This will open the :ref:`Load <algm-Load>` Dialog window.
+#. Browse to the location of the file MAR11060.raw.
+
+ - If you have successfully added the directory containing this file
+ to your data search directories (see
+ :ref:`MBC Getting set up <train-MBC_Getting_set_up>`) then you can
+ simply enter the filename in the File textbox.
+ - Typing "MAR11060" would actually be enough for MantidPlot to find
+ the data, but if you have set MARI as you default instrument
+ typing just "11060" would work!
+
+#. Mantid will suggest the OutputWorkspace name to be "MAR11060", but
+ feel free to use whatever you like.
+#. Leave the other properties alone and press the Run button. A
+ :ref:`Workspace <Workspace>` will appear in the Workspaces list (as shown highlighted in
+ green).
+#. Click on this workspace entry and drag it into the main area to the
+ left of the workspace. This will display the data in a matrix window
+ named 'MAR11060 - Mantid', as shown below:
+
+.. image:: ../../images/ShowMatrixOfMar11060.PNG
+
+
+Other equivalent methods exist for loading files in MantidPlot:
+
+- Navigating to the "Load->File" menu item.
+- Clicking the |LoadFileButton.png| toolbar button.
+- Using the :ref:`Load <algm-Load>` Algorithm. (More on this later!)
+
+.. figure:: ../../images/LoadAlgorithmsSep2013.PNG
+ :width: 300px
+ :align: right
+ :alt: The list of Load algorithms for Mantid v2.6.
+
+ The list of :ref:`Load <algm-Load>` algorithms for Mantid v2.6.
+
+Types of Data Files
+===================
+
+Mantid can load many different data formats. A few examples are:
+
+- ISIS, SNS, ILL, PSI .nexus data files.
+- ISIS .raw data and log files.
+- Simulated data formats.
+- Ascii data, Table data, etc.
+- Live data streams.
+
+Fortunately, you don't have to learn how to use all of these :ref:`Load <algm-Load>`
+algorithms. In fact, just one, ":ref:`Load <algm-Load>`", which was used earlier when you
+loaded the workspace. Whenever you use ":ref:`Load <algm-Load>`" Mantid takes care of the
+following:
+
+- Expanding out run numbers to full file names.
+- Finding the file in the data search directories, and optionally the
+ facility archive.
+- Determining the format of the file and using the correct algorithm to
+ read it.
+- Loading or summing multiple files.
+
+Loading Lots of Data Files
+==========================
+
+You can load multiple files into mantid with a single :ref:`Load <algm-Load>` command,
+either keeping each workspace separate, or summing the data into a
+single workspace:
+
++---------------------------------+--------------------------------+-----------------+------------------------------------------------------------+
+| Usage | Description | Example |
+| | +-----------------+------------------------------------------------------------+
+| | | Input | Result |
++=================================+================================+=================+============================================================+
+| ``<run>,<run>`` | Load a list of runs. | ``INST1,2,3`` | Load runs 1, 2 and 3. |
++---------------------------------+--------------------------------+-----------------+------------------------------------------------------------+
+| ``<run>+<run>`` | Sum a list of runs together. | ``INST1+2+3`` | Load and sum runs 1, 2 and 3. |
++---------------------------------+--------------------------------+-----------------+------------------------------------------------------------+
+| ``<run>:<run>`` | Load a range of runs. | ``INST1:4`` | Load runs 1, 2, 3 and 4. |
++---------------------------------+--------------------------------+-----------------+------------------------------------------------------------+
+| ``<run>-<run>`` | Sum a range of runs. | ``INST1-4`` | Load and then sum runs 1, 2, 3 and 4. |
++---------------------------------+--------------------------------+-----------------+------------------------------------------------------------+
+
+A full explanation of all the functionality and limitations is
+`available <http://www.mantidproject.org/MultiFileLoading>`__.
+
+
+.. |LoadFileButton.png| image:: ../../images/LoadFileButton.png
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_MDVisualisation.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_MDVisualisation.rst
new file mode 100644
index 0000000000000000000000000000000000000000..cd115f50eae8ef75557dfe092c89bf438df78c1c
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_MDVisualisation.rst
@@ -0,0 +1,218 @@
+.. _train-MBC_MDVisualisation:
+
+==========================
+MD Workspace Visualisation
+==========================
+
+Creating Your Data
+==================
+
+The next section requires a dataset that is faster to create than :ref:`Load <algm-Load>`.
+
+#. Click the View -> Script window menu.
+#. In the script window click File->Open, and open the file
+ "C:\\MantidInstall\\data\\CreateSXDNaClQLab.py"
+#. Click the Execute -> Execute All menu.
+#. After about 30 seconds you should have a SXDNaClQLab workspace.
+
+**Note to Demonstrators:** You may want to do this during the preceding
+exercise.
+
+SliceViewer
+===========
+
+| |MBC_SliceViewer_Controls.png|
+| The `SliceViewer <SliceViewer>`__ provides 2D slices through
+ MDWorkspaces. It is designed to provide very fast, interactive
+ projections on large datasets. The SliceViewer is also furnished with
+ a number of 2D tools to aid further visualisation and analysis.
+
+Features include:
+
+- `LineViewer <LineViewer>`__ for creating arbitrary 1D integrated cuts
+ as separate workspaces
+- `PeaksViewer <PeaksViewer>`__ for over-plotting one or more
+ :ref:`PeaksWorkspaces <PeaksWorkspace>` in the Q coordinate frame
+- Control via python `SliceViewer Python
+ Interface <SliceViewer_Python_Interface>`__
+- In-situ rebinning according to slice location
+- Zooming and panning control
+
+Introduction to Feature Controls
+--------------------------------
+
+From the image above
+
+Dimension Selection (1)
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Allows you to choose which dimensions in the workspace are to be plotted
+X and Y on the plot. All other dimensions are provided as sliders. Each
+dimension has an **X** button and a **Y** button. Selecting one of these
+will make this dimension either the X or Y of the plot.
+
+Slice Point Selection (2)
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+| Sliders allow you to choose the slice location. The plot will
+ immediately update to show a projection at the new slice location. N-2
+ dimensions are represented with sliders.
+
+Line Integration Mode (3)
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. image:: ../../images/SliceViewer_and_LineViewer.png
+ :width: 500px
+ :align: right
+
+Selecting this button will allow you to draw a line on the current
+slice. This will also open the *LineViewer* panel. The line can be
+controlled in the following ways:
+
+- Start and end positions
+- Width in plane
+- Thickness (into plane)
+- Number of bins
+
+The controls may be updated either graphically, for example by grabbing
+the start position point and moving it with the left-click mouse option,
+or by updating the coordinates in the *LineViewer* panel.
+
+| Hitting the *Apply* button results in the generation of a new
+ :ref:`Workspace <Workspace>` which is one-dimensional.
+
+Dynamic Rebinning (4)
+~~~~~~~~~~~~~~~~~~~~~
+
+The slice viewer allows you to
+interactively rebin the currently viewed slice to a regular grid. This
+will also result in the generation of a new rebinned workspace in
+Mantid.
+
++---------------------------------------------------------+-------------------------------------------------------+
+| Original Data | Dynamically Rebinned Data |
++=========================================================+=======================================================+
+| .. image:: ../../images/SliceViewer_DynamicRebinOff.png | .. image:: ../../images/SliceViewer_DynamicRebinOn.png|
+| :width: 400px | :width: 400px |
++---------------------------------------------------------+-------------------------------------------------------+
+
+
+Peaks Viewer (5)
+~~~~~~~~~~~~~~~~
+
+|Peaks_view_outline_unannotated.png|
+
+The *PeaksViewer* is a tool for Single Crystal Diffraction. It allows
+you to overlay one or more PeaksWorkspaces over the :ref:`MDWorkspace <MDWorkspace>` to
+which it belongs. PeaksWorkspaces are typically generated by running
+algorithms, such as :ref:`FindPeaksMD <algm-FindPeaksMD>`.
+
+- Slice through the :ref:`MDWorkspace <MDWorkspace>` and the PeaksWorkspaces simultaneously
+ in the SliceViewer plot
+- Select peaks from the peaks list in the PeaksViewer, and cause the
+ SliceViewer to zoom into that exact location on the plot
+- Show integration regions and optionally integration background
+ regions
+- PeaksViewer auto selects the coordinates frame for the
+ PeaksWorkspaces based on the :ref:`MDWorkspace <MDWorkspace>`
+- Sort the PeaksWorkspaces in-situ, for example by greatest intensity
+
+Amongst other usages, this tool therefore allows you to inspect the
+quality of the peak finding, or peak integration operations.
+
+Example
+-------
+
+#. Run :ref:`Load <algm-Load>` on the :ref:`MDWorkspace <MDWorkspace>` file *SXDNaClQLab.nxs*
+#. Run :ref:`Load <algm-Load>` on the :ref:`PeaksWorkspace <PeaksWorkspace>` file *peaks_qLab.nxs*
+#. Right click the :ref:`MDWorkspace <MDWorkspace>` and select *Show Slice Viewer* option
+#. Use the Slider to slice through the Qz dimension
+#. Open the LineViewer and draw a line
+
+Vates Simple Interface
+======================
+
+.. image:: ../../images/ReleasePic.png
+ :width: 300px
+ :align: right
+
+The `Vates Simple Interface <VatesSimpleInterface_v2>`__, or VSI provides full-blown 4D
+visualisation capabilities. The VSI uses ParaView as the visualisation
+engine.
+
+| The VSI is only enabled if you have the correct version of ParaView
+ installed on your computer. Instructions on how to do this are
+ `here <Paraview_setup>`__ for windows. The current version of ParaView
+ required is ParaView 3.98.1, which should be sourced from the Mantid
+ download page `here <http://download.mantidproject.org/>`__.
+
+Examples
+========
+
+Example 1
+---------
+
+#. Run :ref:`Load <algm-Load>` on the :ref:`MDWorkspace <MDWorkspace>` file *SXDNaClQLab.nxs*
+#. Right click the :ref:`MDWorkspace <MDWorkspace>` and select *Show Vates Simple Interface*.
+ The VSI should open showing a 3D representation of the :ref:`MDWorkspace <MDWorkspace>`
+
+ |MantidPlot_VSI-v2_Menu.png|
+#. Click the :ref:`Rebin <algm-Rebin>` button above the plot area
+#. On the properties panel change the number of **Bins** property to 100
+ for each dimension click the **Apply** button. The Workspace should
+ now be rebinned to a regular 100\*100\*100 Grid
+
+ .. image:: ../../images/MBC_VSI_Example1.png
+ :width: 400px
+
+
+Example 2
+---------
+
+#. Complete Example 1 if you haven't already and leave the VSI open
+#. On the top menu select the '''MultiSlice '''
+ |VSI-MultisliceButton.png| mode
+#. The view should be empty. Cuts can be added by double-clicking on an
+ axis scale between the axis scale line and the view area to place an
+ indicator at that point and this adds the slice on the 3D view. Add a
+ few cuts
+#. Move the cut slice positions along the axis and observe the surface
+ projections updating
+
+ .. image:: ../../images/MBC_VSI_Example2.png
+ :width: 400px
+
+
+Example 3
+---------
+
+#. Follow steps 1-2 from Example 1.
+#. On the top menu select the **ScatterPlot**
+ |VSI-SplatterPlotButton.png| mode
+#. Set the **Top Percentile** option on the Properties Tab to be *0.05*
+#. Click *'Use Log :ref:`Scale <algm-Scale>`* at the top of the plot area
+#. Without closing the VSI load the file **peaks_qLab.nxs** into
+ MantidPlot, which produces a :ref:`PeaksWorkspace <PeaksWorkspace>`.
+#. Load the :ref:`PeaksWorkspace <PeaksWorkspace>` into the VSI, by right-clicking the workspace
+ and selecting *Show Vates Simple Interface*. You should now see peak
+ positions as cross-hairs overlayed over the original :ref:`MDWorkspace <MDWorkspace>`
+ data.
+
+ .. image:: ../../images/MBC_VSI_Example3.png
+ :width: 400px
+
+.. |MBC_SliceViewer_Controls.png| image:: ../../images/MBC_SliceViewer_Controls.png
+ :width: 600px
+
+
+.. |Peaks_view_outline_unannotated.png| image:: ../../images/Peaks_view_outline_unannotated.png
+ :width: 800px
+
+
+.. |MantidPlot_VSI-v2_Menu.png| image:: ../../images/MantidPlot_VSI-v2_Menu.png
+
+.. |VSI-MultisliceButton.png| image:: ../../images/VSI-MultisliceButton.png
+
+.. |VSI-SplatterPlotButton.png| image:: ../../images/VSI-SplatterPlotButton.png
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_MDWorkspaces.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_MDWorkspaces.rst
new file mode 100644
index 0000000000000000000000000000000000000000..a91a47f22e505b1b003bf0c30e297b230e03f20d
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_MDWorkspaces.rst
@@ -0,0 +1,77 @@
+.. _train-MBC_MDWorkspaces:
+
+=============
+MD Workspaces
+=============
+
+Where multi-dimensional capabilities are required, Mantid provides a
+relatively new set of :ref:`MDWorkspace <MDWorkspace>` (multi-dimensional workspace) types.
+MDWorkspaces come in two forms :ref:`MDEventWorkspaces <MDWorkspace>`,
+which are analogous to :ref:`EventWorkspaces <EventWorkspace>` and the
+:ref:`MDHistoWorkspace <MDHistoWorkspace>`, which is analogous to the
+:ref:`Workspace2D <Workspace2D>`.
+
+MDEventWorkspaces
+=================
+
+These carry the transformed observed events, organised into a tree image
+structure. The name of this workspace type is a little misleading, as
+the source data does not necessarily have to come from an
+EventsWorkspace. |MDWorkspace_structure.png|
+
+MDHistoWorkspaces
+=================
+
+:ref:`MDHistoWorkspaces <MDHistoWorkspace>` store regularly binned
+multi-dimensional data. These are image-only.
+
+Creating MDWorkspaces
+=====================
+
+:ref:`ConvertToMD <algm-ConvertToMD>` is an umbrella algorithm that provides a
+large number of conversions. The details of all the available options
+are outside the scope of this course.
+
+Below is an example of the generation of a 4D :ref:`MDWorkspace <MDWorkspace>` from a direct
+run on CNCS.
+
+- Run :ref:`Load <algm-Load>` with **Filename** *CNCS_7860_event.nxs*
+- Run :ref:`AddSampleLog <algm-AddSampleLog>` with **LogName**\ =\ *Ei*, **LogText**\ =\ *3*,
+ **LogType**\ =\ *Number*
+- Run :ref:`SetUB <algm-SetUB>` with **a, b and c** = *1.4165*, **u**\ =\ *[1,0,0]*,
+ **v**\ =\ *[0,1,0]*
+- Run :ref:`SetGoniometer <algm-SetGoniometer>` with **Axis0**\ =\ *Psi,0,1,0,1*
+- Now Run :ref:`ConvertToMD <algm-ConvertToMD>` with **QDimensions**\ =\ *Q3D*,
+ **QConversionScales**\ =\ *HKL*, **dEAnalysisMode**\ =\ *Direct*,
+ **MinValues**\ =\ *[-3,-3,-3,-1]*, **MaxValues**\ =\ *[3,3,3,3]*
+
+or run the following ...
+
+.. code:: python
+
+ ws = Load(Filename='CNCS_7860_event')
+ AddSampleLog(Workspace=ws,LogName='Ei',LogText='3.0',LogType='Number')
+ SetUB(Workspace=ws,a='1.4165',b='1.4165',c='1.4165',u=[1,0,0],v=[0,1,0])
+ AddSampleLog(Workspace=ws,LogName='Psi',LogText='0.0', LogType='Number')
+ x = ws.getRun().getLogData('Psi')
+ SetGoniometer(Workspace=ws,Axis0='Psi,0,1,0,1')
+ mdws = ConvertToMD(InputWorkspace=ws,QDimensions='Q3D',QConversionScales='HKL', dEAnalysisMode='Direct',MinValues=[-3,-3,-3,-1],MaxValues=[3,3,3,3])
+ plotSlice(mdws, xydim=["[H,0,0]","[0,K,0]"], slicepoint=[0,0], colorscalelog=True )
+
+
+Other sources
+-------------
+
+MDWorkspaces need not be in **Q** at all. Below is an example of image
+data ported into an :ref:`MDEventWorkspace <MDWorkspace>`, where coordinates are in
+real-space.
+
+|Fly.png|
+
+
+.. |MDWorkspace_structure.png| image:: ../../images/MDWorkspace_structure.png
+
+.. |Fly.png| image:: ../../images/Fly.png
+ :width: 200px
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Masking_and_Grouping.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Masking_and_Grouping.rst
new file mode 100644
index 0000000000000000000000000000000000000000..935c61922cbbf82311a0bf37f9470afc93c1fa25
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Masking_and_Grouping.rst
@@ -0,0 +1,76 @@
+.. _train-MBC_Masking_and_Grouping:
+
+====================
+Masking and Grouping
+====================
+
+The Mask/Group tab is for grouping or masking detectors.
+
+The toolbar on this tab consists of the same tools as the top row of
+tools in the Pick tab. Their functions and behaviours are also the same
+but the shapes are used for masking and grouping instead of displaying
+the data.
+
+.. image:: ../../images/MaskTabToolButtons.png
+
+
+Use these radio-buttons to switch between masking and grouping
+functions.
+
+.. image:: ../../images/MaskOrGroup.png
+
+
+The shapes ready for masking have red border |MaskRedRing.png|
+
+The shapes ready for grouping have blue border |GroupBlueRing.png|
+
+Grouping
+========
+
+In the grouping mode you can extract the data or save grouping to a
+file:
+
+.. image:: ../../images/GroupingOperations.png
+
+
+Masking
+=======
+
+In the masking mode operations can either be applied to the view only or
+to the underlying workspace.
+
+.. image:: ../../images/MaskingViewAndWorkspace.png
+
+
+When the "Apply to View" button is clicked the detectors covered by the
+shapes are greyed out indicating that they are masked.
+
+.. image:: ../../images/MaskedViewPixels.png
+
+
+The purpose of applying to view only is to make creation of masking
+workspaces/files easier. You can create a mask, apply it to view, save
+it in a workspace or a file but then clear the view
+(|ClearAllButton.png| button) and create another mask without closing
+the Instrument View or need to reload the data. The masking operations
+are available from the "Apply and Save" menu.
+
+.. image:: ../../images/ApplyAndSaveMenu.png
+
+
+If masking is applied to the data (by clicking |ApplyToDataButton.png|)
+it cannot be undone.
+
+.. raw:: mediawiki
+
+ {{SlideNavigationLinks|MBC_Investigating_Data|Mantid_Basic_Course|MBC_Instrument_Tree}}
+
+.. |MaskRedRing.png| image:: ../../images/MaskRedRing.png
+
+.. |GroupBlueRing.png| image:: ../../images/GroupBlueRing.png
+
+.. |ClearAllButton.png| image:: ../../images/ClearAllButton.png
+
+.. |ApplyToDataButton.png| image:: ../../images/ApplyToDataButton.png
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Setup_And_Execute_First_Fit.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Setup_And_Execute_First_Fit.rst
new file mode 100644
index 0000000000000000000000000000000000000000..3cf6562ae962d59899169835941d802267082a84
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Setup_And_Execute_First_Fit.rst
@@ -0,0 +1,316 @@
+.. _train-MBC_Setup_And_Execute_First_Fit:
+
+======================
+Fitting Models to Data
+======================
+
+Fitting is the modelling of data where parameters of a model are allowed
+to vary during a fitting process until the agreement between model and
+data has seen an improvement according to some cost function.
+
+In summary the Mantid fitting provides
+
+- General fitting capabilities
+- Fitting extras, that make use of data log file and instrument
+ geometry information to enhance the user fitting experience
+- Easily expandable
+
+The main focus of this basic course is to cover the basic mantid fitting
+capabilities.
+
+Simple fitting
+==============
+
+#. Plot a data set. We will use data from MUSR00015189_cropped.nxs
+ file.
+
+ |MUSRDataSet.png|
+
+
+#. Select the fitting tool button: |PeakFitToolbar.png|
+
+ |MUSRDataSetFittingOn.png|
+
+#. Right click on the plot to select a fitting function.
+
+ |AddOtherFunctionOption.png|
+
+#. Choose :ref:`ExpDecay <func-ExpDecay>`.
+
+ |ChooseExpDecay.png|
+#. Run :ref:`Fit <algm-Fit>`.
+
+ |RunFitOption.png|
+#. Examine the results.
+
+ |MUSRDataSetFittingResults.png|
+
+A more complex case
+===================
+
+Activating the fitting tools
+----------------------------
+
+#. Open any data, here HRP39182.raw and plot first spectrum
+#. Zoom in on any peak, for example the peak near 93150 microseconds
+#. Close to the zoom toolbar button, click on the :ref:`Fit <algm-Fit>` Function toolbar
+ button:
+ |PeakFitToolbar.png|.
+ If this toolbar is not visible ensure that View->Toolbars...->Plot is
+ ticked.
+
+What you should now see is something similar to
+
+|FirstStartMantidPlotFitting MBC.PNG|
+
+Three things happens when you click on the Fit Function toolbar button
+
+- The Fit Function toolbox, by default, will position itself on the
+ left side of MantidPlot (if not already docked somewhere else)
+- fit function items are adding to the plot, initially the two vertical
+ dashed lines highlighted in red in the image above
+- and additional right click menu options becomes available on the plot
+ window
+
+Selecting the fitting range
+---------------------------
+
+The fitting range is the region of the data where you will attempt to do
+a fit.
+
+This vertical dashed lines shows the fitting region of the data. These
+are in sync with the Fit Function setting properties: StartX and EndX
+values highlighted in green in the image above.
+
+#. Use the mouse to adjust the vertical dashed lines and therefore the
+ fitting range. Notice the StartX and EndX get updated in the Fit
+ Function property browser.
+#. Alternative adjust StartX and EndX in the Fit Function property
+ browser which will adjust the positions of the vertical dashed lines
+
+Other fit function settings properties
+--------------------------------------
+
+In addition to StartX and EndX there are a number of other essential fit
+setting properties including:
+
+- :ref:`Workspace <Workspace>` and Workspace Index: what data to fit. Note typically you
+ should not need to update these manually, these gets updated
+ automatically as the Fit Function button is used to associate theFit
+ Function toolbox with different plots
+- Minimizer: Here you chose between a number of minimizer to search for
+ better fit to a model
+- Cost function: The function used to specify the quality of a fit.
+- Plot Difference: When the result of a fit is displayed optionally the
+ difference between the model and the fit can also be displayed
+
+More documentation of these is available from :ref:`Fit <algm-Fit>`.
+
+Setting up a fit model
+----------------------
+
+Here start up with building up a model consisting of one peak and one
+background function.
+
+This can in fact be done using just the Fit Function toolbox. However in
+practice it is advantegeous to also use the fitting tools available on
+the plot and from the plot right click menu.
+
+#. Select the right click plot menu option 'Add peak...'. This pops up a
+ new window and in the combobox, select :ref:`Gaussian <func-Gaussian>`. The mouse cursor
+ then changes to a cross. Move this cross near the top of the peak and
+ click any mouse button
+
+ |JustAddedPeak.png|
+
+#. Click on the red line and drag it sideways to set the initial width
+ (FWHM) of the peak.
+
+ |ChangePeakWidth.png|
+
+ Now you can see 3 red lines - one solid line indicating peak's
+ position and height, and two dashed ones representing the width
+ of the peak. The dashed lines usually show the points of half
+ peak's maximum. All three lines can be dragged within the plot to
+ modify its centre, height or with parameters which is instantly
+ reflected in the Fit Function browser.
+
+#. Select the right click plot menu option 'Add background...'. This
+ pops up a new window and in the combobox, select :ref:`FlatBackground <func-FlatBackground>`
+
+The result of this is
+
+.. image:: ../../images/PeakAndBackgroundSetup.png
+ :width: 500px
+
+
+Note that a vertical line has appeared in the plot where the peak was
+positioned and two fit function entries have appeared in the :ref:`Fit <algm-Fit>`
+Function property browser called 'f0-:ref:`Gaussian <func-Gaussian>`' and 'f1-:ref:`FlatBackground <func-FlatBackground>`'.
+
+In summary from the Fit Function property browser you have created model
+consisting of a :ref:`CompositeFunction <func-CompositeFunction>` which contains a :ref:`Gaussian <func-Gaussian>` and a
+flat-background. The :ref:`CompositeFunction <func-CompositeFunction>` part means that the model is sum
+of its parts, i.e. here the model is::
+
+ 'f0-Gaussian'Â +Â 'f1-FlatBackground'
+
+Adjusting fit function parameter
+--------------------------------
+
+When you do fitting the starting fit function parameter values can
+greatly affect both the speed and the result you obtain from fitting. In
+general you want to use staring parameter that are a close as possible
+to the result you want to obtain.
+
+Fit tools are available on the plot to help you with doing this. In
+doing this it can be helpful to turn on Plot Guess,
+
+.. image:: ../../images/SelectPlotGuess.png
+ :width: 200px
+
+
+what this means does is to plot how the model you have created looks
+like compared to your data.
+
+.. image:: ../../images/PlotGuess.png
+ :width: 400px
+
+
+The aim is to have this plot and your data overlap reasonable well
+before you do the actual fit. Note this is not an absolute requirement
+but your chances of a successful fit increase this way.
+
+Saving a model
+--------------
+
+If you have spend a considerable amount of type setting up a model you
+can save it and then load it later.
+
+|SaveSetup.png| |ArrowRight.png| |SaveSetupDialog.png|
+
+After saving the model it can be imported into Fit Function browser at
+any time using Custom Setup option from the same menu. Importing
+(loading) a model replaces all functions in the browser.
+
+Tying and constraining fit parameters
+-------------------------------------
+
+Mantid fitting framework allows you to tie or constrain parameters
+during the fit. We define tying as setting a parameter equal to a result
+of an expression involving other parameters of the same function. The
+expression can be a constant (doesn't involve any parameters), in this
+case we call the tied parameter fixed.
+
+By constraining we understand setting conditions on acceptable values of
+a parameter. For example limiting its value from below or above.
+
+To set a constraint or a tie right click on a parameter name:
+
+.. image:: ../../images/TieConstraintContextManu.png
+
+
+The menu offers three options:
+
+- Fix: tie this parameter to its current value.
+- Constraint: set a bounding constraining condition - define a lower or
+ upper bound, or both.
+- Tie: tie this parameter to an arbitrary expression.
+
+The tying expression can be as simple as a parameter name::
+
+ f0.Height
+
+Note that parameter names of a model include prefixes such as "f0."
+which indicate the particular function they belong to.
+
+A more interesting example is setting parameter f1.A0 from our earlier
+model to formula::
+
+ 20Â -Â f0.Height
+
+This will ensure that the maximum point is exactly 20 units above 0.
+
+Execute your fit
+----------------
+
+After the model has been defined, its initial values are set, any ties
+and constraints defined we are ready to run a fit. It is done by
+selecting the Fit option from the Fit menu:
+
+.. image:: ../../images/RunFitOption.png
+
+
+Inspecting a fit result
+-----------------------
+
+After a successful fit the results can be examined in three ways.
+
+#. The Fit Function property browser will show the fitted parameters
+ instead of their initial values.
+#. A plot of the fitted model will be added to the graph along with the
+ difference with the original data.
+#. Output workspaces will be created and available via the workspace
+ dock.
+
+.. image:: ../../images/FitResults.png
+ :width: 500px
+
+
+There are three output workspaces:
+
+#. A TableWorkspace with the name suffixed with "\_Parameters". It
+ contains the fitting parameters and their corresponding errors.
+
+ .. image:: ../../images/ParametersTable.png
+ :width: 300px
+
+
+#. A :ref:`MatrixWorkspace <MatrixWorkspace>` with the name suffixed with "\_Workspace". Its
+ first three spectra are: the original data, the calculated model, and
+ the difference.
+
+ .. image:: ../../images/FitResultWorkspace.png
+ :width: 350px
+
+
+#. A :ref:`TableWorkspace<Table Workspaces>` with the name suffixed with
+ "\_NormalisedCovarianceMatrix". It contains the variance-covariance
+ matrix normalized to 100.
+
+
+.. |MUSRDataSet.png| image:: ../../images/MUSRDataSet.png
+ :width: 400px
+
+.. |PeakFitToolbar.png| image:: ../../images/PeakFitToolbar.png
+
+.. |MUSRDataSetFittingOn.png| image:: ../../images/MUSRDataSetFittingOn.png
+ :width: 500px
+
+.. |AddOtherFunctionOption.png| image:: ../../images/AddOtherFunctionOption.png
+ :width: 500px
+
+.. |ChooseExpDecay.png| image:: ../../images/ChooseExpDecay.png
+
+.. |RunFitOption.png| image:: ../../images/RunFitOption.png
+
+.. |MUSRDataSetFittingResults.png| image:: ../../images/MUSRDataSetFittingResults.png
+
+.. |FirstStartMantidPlotFitting MBC.PNG| image:: ../../images/FirstStartMantidPlotFittingMBC.PNG
+
+.. |JustAddedPeak.png| image:: ../../images/JustAddedPeak.png
+ :width: 400px
+
+.. |ChangePeakWidth.png| image:: ../../images/ChangePeakWidth.png
+ :width: 400px
+
+.. |SaveSetup.png| image:: ../../images/SaveSetup.png
+ :width: 300px
+
+.. |ArrowRight.png| image:: ../../images/ArrowRight.png
+ :width: 100px
+
+.. |SaveSetupDialog.png| image:: ../../images/SaveSetupDialog.png
+ :width: 100px
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_The_Workspace_Matrix.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_The_Workspace_Matrix.rst
new file mode 100644
index 0000000000000000000000000000000000000000..eac1c82a0a016c2f7678dc65e8ea1dab34fa8504
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_The_Workspace_Matrix.rst
@@ -0,0 +1,101 @@
+.. _train-MBC_The_Workspace_Matrix:
+
+.. image:: ../../images/ShowMatrixOfMar11060.PNG
+ :align: right
+
+
+The Workspace Toolbox
+=====================
+
+MantidPlot needs a way of storing the data it loads into something.
+These 'somethings' are called :ref:`workspaces <Workspace>`. You can see all of the
+Workspaces that Mantid has loaded in the Workspaces toolbox, together
+with buttons for:
+
+- Loading new workspaces.
+- Deleting workspaces.
+- Grouping workspaces. If a grouped workspace is already selected this
+ will change to "Ungroup" the workspaces.
+- Sorting the workspace list.
+- Saving workspaces.
+
+Next to each :ref:`workspace <Workspace>` is a little triangle you can click to review a
+few more details about the workspace.
+
+The Workspace Matrix View
+=========================
+
+The dialog with the blue background is the workspace matrix view, and
+can be used to look at histogram or event data. You can create one in a
+few ways:
+
+- Click and drag the workspace name into the main window area (the grey
+ bit in the middle).
+- Right click the workspace name and select show data. The next dialog
+ gives you options to limit the amount of data displayed; just click
+ OK.
+- Double click the workspace name
+- Using python commands. There are more details in the Python in Mantid
+ course.
+
+.. image:: ../../images/WorkspaceMatrixAnnotated.png
+
+
+Each row in the matrix shown shows data values of a single spectra. By
+flipping between the tabs you can see the X, Y and E values.
+
+- X contains the Bin boundaries or bin centre values of the X axis. If
+ they are bin Boundaries you will have one more column in the X tab
+ than you do in the Y or E tabs.
+- Y contains the counts found in each bin of the spectrum.
+- E contains the errors associated with the counts. For most raw data
+ this will initially be the square root of Y on loading.
+
+The number at the left of each row we call the "Workspace Index", or WI
+for short, and is simply the row number as data is read into the
+workspace; in the same way as a spreadsheet program like Excel uses row
+numbers. This always starts from zero and is important as it is used
+quite a bit in displaying and running Algorithms on your data.
+
+Linking :ref:`Workspace <Workspace>` Index to Spectra Number
+=========================================
+
+Many instruments use a unique number to refer to each of the spectra in
+a data file. We call this the "Spectrum Number". If you load the whole
+file you will often find that the :ref:`Workspace <Workspace>` Index and Spectrum Number
+match each other closely, just out by one. However if you only load part
+of a file, for example spectra 100 - 200, then the :ref:`Workspace <Workspace>` Indices
+will still be 0-100, but Mantid will remember the original Spectra
+Number of each spectrum.
+
+Linking :ref:`Workspace <Workspace>` Index to Detector IDs
+=======================================
+
+The data in each spectrum can come from one or more detectors, and
+sometimes it is useful to know exactly which detectors. You can get
+spectra linked to multiple detectors either by hardware detector
+grouping or by grouping the detectors in Mantid.
+
+There are two methods you can use to see the detector table of a
+workspace within MantidPlot:
+
+- Right-click on the workspace name and select "Show Detectors".
+- Right-click within the workspace matrix and select "View Detectors
+ Table".
+
+Either of these methods will display a table containing the :ref:`Workspace <Workspace>`
+Indices, Spectra Numbers, Detector IDs and locations of the detectors,
+together with a flag showing which are monitors. If a spectrum contains
+a group of detectors then the position shown will be the average
+position of those detectors.
+
+.. image:: ../../images/Showmar11060detectortable.PNG
+
+
+In the example above, the first three spectra correspond to data from
+monitors. The fourth spectrum (with a Spectrum Number of -1) loaded from
+the MAR11060 run is for some reason not present in the Instrument
+definition, and the remaining rows that are visible show histograms
+wired up to detectors with spectrum number 5-7 or equivalently detectors
+with IDs of 4101-3.
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Why_Live_Data.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Why_Live_Data.rst
new file mode 100644
index 0000000000000000000000000000000000000000..9f4de75574b90a273cecf76abc7ef6bb0d6229ff
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Why_Live_Data.rst
@@ -0,0 +1,50 @@
+.. _train-MBC_Why_Live_Data:
+
+Why might you want to look at live data?
+========================================
+
+- Monitoring the experiment
+
+ - Raw data (e.g. monitor plots, alignment scans, etc…)
+
+ - Are neutrons actually getting through? Are the shutters really
+ open?
+ - Is my crystal aligned?
+ - Is everything still going ok?
+
+ - Reduced data (e.g. S(Q,ω), etc…)
+
+ - Are the statistics good enough yet?
+ - Given this result what should we look at next?
+
+- This enables better Experimental steering
+
+ - Provide user with more information to make better use of beam time
+ - Automatic feedback to Data Acquisition System
+
+ - This has been shown to work in principle and is a future area
+ of development for Mantid.
+
+Perhaps the better question is "Why should you have to wait for the run
+to finish, and the file to be written to see your data?".
+
+Why do this in Mantid?
+======================
+
+This type of thing could be built into each facilities data acquisition
+system, indeed Mantid needs the data acquisition system to broadcast the
+live data stream, so why choose mantid as the location for live data
+processing and visualization?
+
+- Standard framework for data reduction
+- Can process Event and Histogram data
+- Provides comprehensive visualisation tools
+
+ - which can update automatically with data changes
+
+- Easy to customize and extend.
+
+.. raw:: mediawiki
+
+ {{SlideNavigationLinks|MBC_Exercise_Intelligent_Fitting|Mantid_Basic_Course|MBC_Live_Data_Workflow }}
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/MBC_Workspaces.rst b/Code/Mantid/docs/source/training/MantidBasics/MBC_Workspaces.rst
new file mode 100644
index 0000000000000000000000000000000000000000..bf65b343fa3d4049da5170f503be6c608923dcd8
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/MBC_Workspaces.rst
@@ -0,0 +1,150 @@
+.. _train-MBC_Workspaces:
+
+==========
+Workspaces
+==========
+
+Workspaces come in several forms, but the most common by far is the
+:ref:`MatrixWorkspace <MatrixWorkspace>` which represents XYE data for one
+or more spectra. The :ref:`MatrixWorkspace <MatrixWorkspace>` itself can be sub-grouped into
+:ref:`EventWorkspaces <EventWorkspace>` and :ref:`Workspace2Ds <Workspace2D>`.
+
+.. image:: ../../images/MatrixWorkspaceHierachy.png
+ :width: 300px
+
+
+Workspace2D
+===========
+
+A :ref:`Workspace2D <Workspace2D>` consists of a workspace with 1 or more spectra. Typically,
+each spectrum will be a histogram. For each spectrum X, Y (counts) and E
+(error) data is stored as a separate array.
+
+| |MBC_Workspace2D.png|
+| Each workspace has two axes, the Spectrum axis and the X-axis. Where
+ an axis holds a known unit type, it may be converted to another set of
+ units.
+| |MBC_axes_annotated.png|
+
+:ref:`Rebinning <algm-Rebin>` a :ref:`Workspace2D <Workspace2D>` is a one-way process when the rebinning leads to
+a coarser structure.
+
+Ragged Workspaces
+-----------------
+
+Converting x-axis units can lead to a ragged workspace, in which bin
+boundaries are not consistent across the spectra. Some algorithms will
+not accept input workspaces that are ragged. The fix to this is to apply
+:ref:`Rebin <algm-Rebin>` to the Ragged workspace structure, as the example below shows.
+
+#. run :ref:`Load <algm-Load>` on *GEM38370_Focussed.nxs* setting the
+ **OutputWorkspace** to be *ws*
+#. run :ref:`ConvertUnits <algm-ConvertUnits>` on *ws* setting **OutputWorkspace** to *lambda*,
+ **Target**\ =\ *Wavelength*, **EMode**\ =\ *Elastic*. Plotting this
+ in the *Color Fill Plot* demonstrates the ragged X-bins.
+
+ |MBC_Ragged.png|
+#. run :ref:`Rebin <algm-Rebin>` on *lambda* setting **Params** to *0.5* and
+ **OutputWorkspace** to *Rebinned*. Plotting this in the *Color Fill
+ Plot* demonstrates that uniform binning across all spectra has been
+ achieved.
+
+ |MBC_Rebinned.png|
+
+Event Workspaces
+================
+
+An :ref:`EventWorkspace <EventWorkspace>` stores information about each
+individual event observation in detectors. More specifically, at a
+neutron spallation source, this means that the time of arrival and
+detector ID of each individual neutron is recorded. Only fairly recent
+advances in computer and acquisition hardware have made storing this
+detailed knowledge a practical solution. For example at the SNS facility
+all data, except for data collected in monitors, are stored in this way.
+
+Event specifies “when†and “whereâ€
+
+**Pulse time** – when the proton pulse happened in absolute time
+
+**Time-of-flight** – time for the neutron to travel from moderator to
+the detector
+
+Basic Example
+-------------
+
+.. image:: ../../images/Binning_example.png
+ :width: 500px
+
+
+Rebinning
+---------
+
+- Rebinning is essentially free and can be conducted in-place. This is
+ because the data does not need to change, only the overlaying
+ histogramming.
+
+Performance
+-----------
+
+- Each event list is separate
+- Sorting events is O(n) = n log(n)
+- Histogramming is O(n) = n
+- Only histogram as needed
+
+Example of Workspace usage
+==========================
+
+#. :ref:`Load <algm-Load>` the event data HYS_11388_event.nxs
+#. Execute the ':ref:`SumSpectra <algm-SumSpectra>`' algorithm
+#. :ref:`Rebin <algm-Rebin>` with Params=300 and plot, ensure PreserveEvents=True
+
+ |MBC_Rebin_Coarse.png|
+#. :ref:`Rebin <algm-Rebin>` with Params=100, the plot will automatically update, ensure
+ PreserveEvents=True
+
+ |MBC_Rebin_MED.png|
+#. :ref:`Rebin <algm-Rebin>` with Params=10 the plot will automatically update, ensure
+ PreserveEvents=True
+
+ |MBC_Rebin_Fine.png|
+
+Keep the workspace open for the next section.
+
+Other Workspace Types
+=====================
+
+- :ref:`GroupWorkspaces <WorkspaceGroup>` store a collection of other
+ workspaces in a group, this can be created manually and is often used
+ in multi-period data. Either the whole group or individual members
+ can be processed using algorithms.
+- :ref:`TableWorkspaces <Table Workspaces>` stores data as cells. Columns determine the type of
+ the data, for example double precision float, while each entry
+ appears as a new row. This is analogous to a Microsoft Excel
+ Spreadsheet.
+- :ref:`PeaksWorkspace <PeaksWorkspace>` is a special type of
+ TableWorkspace with additional support for Single Crystal peaks.
+- :ref:`MDWorkspace <MDWorkspace>` will be covered later in this course
+
+
+.. |MBC_Workspace2D.png| image:: ../../images/MBC_Workspace2D.png
+ :width: 400px
+
+.. |MBC_axes_annotated.png| image:: ../../images/MBC_axes_annotated.png
+ :width: 400px
+
+.. |MBC_Ragged.png| image:: ../../images/MBC_Ragged.png
+ :width: 300px
+
+.. |MBC_Rebinned.png| image:: ../../images/MBC_Rebinned.png
+ :width: 300px
+
+.. |MBC_Rebin_Coarse.png| image:: ../../images/MBC_Rebin_Coarse.png
+ :width: 400px
+
+.. |MBC_Rebin_MED.png| image:: ../../images/MBC_Rebin_MED.png
+ :width: 400px
+
+.. |MBC_Rebin_Fine.png| image:: ../../images/MBC_Rebin_Fine.png
+ :width: 400px
+
+
diff --git a/Code/Mantid/docs/source/training/MantidBasics/index.rst b/Code/Mantid/docs/source/training/MantidBasics/index.rst
new file mode 100644
index 0000000000000000000000000000000000000000..badbd3619a717075aaf6ac2687b0c6a2468e5e50
--- /dev/null
+++ b/Code/Mantid/docs/source/training/MantidBasics/index.rst
@@ -0,0 +1,105 @@
+.. _train-MBC_contents:
+
+=====================
+ Mantid Basic Course
+=====================
+
+No knowledge of Mantid is assumed and the focus will be how to use Mantid via the MantidPlot GUI. The separate Python In Mantid course covers material on using Mantid via Python scripting.
+
+Duration: 4 hours as a hands-on course including exercises.
+
+.. toctree::
+ :maxdepth: 1
+ :hidden:
+
+ MBC_Getting_set_up
+ MBC_Introduction
+ MBC_Loading_Data
+ MBC_The_Workspace_Matrix
+ MBC_Displaying_data
+ MBC_Displaying_data_2D
+ MBC_Displaying_data_Formatting
+ MBC_Displaying_data_Complex
+ MBC_Exercise_Loading_And_Displaying_Data
+ MBC_Algorithms_History_EventWorkspace
+ MBC_Algorithms
+ MBC_Workspaces
+ MBC_History
+ MBC_Interfaces
+ MBC_Exercise_Algorithms_History_EventWorkspace
+ MBC_Connecting_Data_To_Instrument
+ MBC_Displaying_and_Navigating_Instrument
+ MBC_Investigating_Data
+ MBC_Masking_and_Grouping
+ MBC_Instrument_Tree
+ MBC_Exercise_Connecting_Data_To_Instrument
+ MBC_Setup_And_Execute_First_Fit
+ MBC_Fit_Model_Choices
+ MBC_Intelligent_Fitting
+ MBC_Exercise_Intelligent_Fitting
+ MBC_Why_Live_Data
+ MBC_Live_Data_Workflow
+ MBC_Live_Data_User_Interface
+ MBC_Live_Data_Simple_Examples
+ MBC_MDWorkspaces
+ MBC_MDVisualisation
+
+Setup and Introduction
+######################
+
+* :ref:`Getting set up <train-MBC_Getting_set_up>`
+* :ref:`Introduction <train-MBC_Introduction>`
+
+Loading and Displaying Data
+###########################
+
+* :ref:`Loading Data <train-MBC_Loading_Data>`
+* :ref:`The Workspace Matrix <train-MBC_The_Workspace_Matrix>`
+* :ref:`Displaying 1D Data <train-MBC_Displaying_data>`
+* :ref:`2D Data Plots <train-MBC_Displaying_data_2D>`
+* :ref:`Formatting Your Plots <train-MBC_Displaying_data_Formatting>`
+* :ref:`Multi-Layer Plots <train-MBC_Displaying_data_Complex>`
+* :ref:`Exercise <train-MBC_Exercise_Loading_And_Displaying_Data>`
+
+Algorithms, History and Workspaces
+##################################
+
+* :ref:`Introduction <train-MBC_Algorithms_History_EventWorkspace>`
+* :ref:`Algorithms <train-MBC_Algorithms>`
+* :ref:`Workspaces <train-MBC_Workspaces>`
+* :ref:`Algorithm History <train-MBC_History>`
+* :ref:`Interfaces <train-MBC_Interfaces>`
+* :ref:`Exercise <train-MBC_Exercise_Algorithms_History_EventWorkspace>`
+
+Connecting Data to Instrument
+#############################
+
+* :ref:`Introduction <train-MBC_Connecting_Data_To_Instrument>`
+* :ref:`Displaying and Navigating <train-MBC_Displaying_and_Navigating_Instrument>`
+* :ref:`Investigating Data <train-MBC_Investigating_Data>`
+* :ref:`Masking and Grouping <train-MBC_Masking_and_Grouping>`
+* :ref:`Instrument Tree <train-MBC_Instrument_Tree>`
+* :ref:`Exercise <train-MBC_Exercise_Connecting_Data_To_Instrument>`
+
+Fitting
+#######
+
+* :ref:`Fitting Models to Data <train-MBC_Setup_And_Execute_First_Fit>`
+* :ref:`Fit Model Choices <train-MBC_Fit_Model_Choices>`
+* :ref:`Intelligent Fitting <train-MBC_Intelligent_Fitting>`
+* :ref:`Exercise <train-MBC_Exercise_Intelligent_Fitting>`
+
+Live Data Analysis
+##################
+
+* :ref:`Why Would You Want to Process Live Data? <train-MBC_Why_Live_Data>`
+* :ref:`The Flow of Live Data Through Mantid <train-MBC_Live_Data_Workflow>`
+* :ref:`Starting Live Data Through Mantid <train-MBC_Live_Data_User_Interface>`
+* :ref:`Examples <train-MBC_Live_Data_Simple_Examples>`
+
+Multi-Dimensional Workspaces
+############################
+
+* :ref:`Introduction to Creating and Using MDWorkspaces <train-MBC_MDWorkspaces>`
+* :ref:`Introduction to Multidimensional Visualisation Tools <train-MBC_MDVisualisation>`
+
diff --git a/Code/Mantid/docs/source/training/index.rst b/Code/Mantid/docs/source/training/index.rst
new file mode 100644
index 0000000000000000000000000000000000000000..175dbbc75ab12481f24e3446521d66753b093700
--- /dev/null
+++ b/Code/Mantid/docs/source/training/index.rst
@@ -0,0 +1,17 @@
+.. _train-contents:
+
+===============
+ Training
+===============
+
+.. toctree::
+ :hidden:
+ :glob:
+ :maxdepth: 1
+
+ MantidBasics/*
+
+
+**Courses:**
+
+* `Mantid Basics </MantidBasics/index.html>`_
diff --git a/Code/Tools/scripts/ConvertToRST/ConvertWikiPage.py b/Code/Tools/scripts/ConvertToRST/ConvertWikiPage.py
new file mode 100644
index 0000000000000000000000000000000000000000..618c066e923864977aee829330c5b004a296337c
--- /dev/null
+++ b/Code/Tools/scripts/ConvertToRST/ConvertWikiPage.py
@@ -0,0 +1,284 @@
+###########################################################################################
+# Converts mediawiki pages to rst pages for sphinx.
+# run with -h for command line arguments
+#
+# sample command C:\MantidInstall\bin\python.exe C:/Mantid/Code/Tools/scripts/ConvertToRST/ConvertWikiPage.py
+# -o C:/Mantid/Code/Mantid/docs/source/training/MBC_Displaying_data_Formatting.rst
+#
+# pandoc must be installed an in the path
+#
+# extends pandoc by downloading and correcting image links, and adding links for algorithms,
+# fit functions and common concepts (workspace types)
+#
+# Limitations:
+# 1. in adding text to links or images in tables the table formatting will be disrupted
+# 2. pandoc creates some images in an inline format, these cannot have the align tags added
+# back on, this is marked with a comment, the solution is probably to move the image from
+# the inline to normal format.
+# 3. Image links cannot have spaces in the filename in rst.
+# The spaces are removed in the downloaded file names, but not the links in the rst files.
+#
+##########################################################################################
+import os
+import re
+import sys
+import urllib2
+import urlparse
+import argparse
+import subprocess
+import mantid
+
+def readWebPage(url):
+ # set your environment HTTP_PROXY to be your proxy
+ # for ral HTTP_PROXY=http://wwwcache.rl.ac.uk:8080
+ aResp = urllib2.urlopen(url)
+ web_pg = aResp.read()
+ return web_pg
+
+def downloadImage(imgUrl, filePath):
+ downloadedImage = file(filePath, "wb")
+
+ imageOnWeb = urllib2.urlopen(imgUrl)
+ while True:
+ buf = imageOnWeb.read(65536)
+ if len(buf) == 0:
+ break
+ downloadedImage.write(buf)
+ downloadedImage.close()
+ imageOnWeb.close()
+
+ return filePath
+
+def convertURLToRaw(url):
+ return url + "?action=raw"
+
+def covertMediaWikiToRST(url):
+ cmd = 'pandoc -f mediawiki -t rst "' + url + '"'
+ print cmd
+
+ return runProcess(cmd)
+
+def runProcess(cmd):
+ # instantiate a startupinfo obj:
+ startupinfo = subprocess.STARTUPINFO()
+ # set the use show window flag, might make conditional on being in Windows:
+ startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
+
+ p = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT,
+ startupinfo=startupinfo)
+ output, error = p.communicate()
+ output = output.replace("\r\n","\n")
+ print error
+ return output
+
+def processImageLinks(mediawikiText,rstText, imagePath, relImagePath):
+ retRstText = rstText
+ mwImagePattern = re.compile(r'\[\[(Image|File):(.+?)(\|.*?)?(\|.*?)?(\|.*?)?(\|.*?)?(\|.*?)?(\|.*?)?\]\]',
+ re.IGNORECASE)
+ rstImagePattern = re.compile(r'figure:: (([\w\-\_\\\/]+)\.(\w{2,5}))(.{0,50}\3){2}',
+ re.DOTALL)
+ rstSubstitutionImagePattern = re.compile(r'(figure|image):: (([\w\-\_\\\/]+)\.(\w{2,5}))')
+
+
+ imgLinkDict ={}
+ #for all of the mediawiki links
+ for m in re.finditer(mwImagePattern, mediawikiText):
+ print ("processing image link",m.group(0))
+ rstLink = generateRstImageLink(m,relImagePath)
+ imgLinkDict[m.group(2)] = rstLink
+ print (rstLink)
+
+ #for all of the rst figure links
+ replacements = []
+ for m in re.finditer(rstImagePattern, retRstText):
+ rstLink = imgLinkDict[m.group(1)]
+ replacements.append((m.start(), m.end(), m.group(1), rstLink))
+
+ #perform replacements in reverse order
+ for (start,end,imagefile,rstLink) in reversed(replacements):
+ retRstText = retRstText[0:start] + rstLink + retRstText[end:]
+
+ replacements = []
+ for m in re.finditer(rstSubstitutionImagePattern, retRstText):
+ rstLink = imgLinkDict[m.group(2)]
+ rstLink = cleanInlineImagesDefinition(rstLink)
+ replacements.append((m.start(), m.end(), m.group(2), rstLink))
+
+ #perform replacements in reverse order
+ for (start,end,imagefile,rstLink) in reversed(replacements):
+ retRstText = retRstText[0:start] + rstLink + retRstText[end:]
+
+ #get all of the image files
+ for imageName in imgLinkDict.keys():
+ saveImageFromMW(imageName,imagePath)
+
+
+ return retRstText
+
+def saveImageFromMW(imageName,path):
+ url = "http://www.mantidproject.org/File:"+imageName.replace(" ","_")
+ print "Downloading image: ", url
+ imagePage = readWebPage(url)
+ mwImagePattern = re.compile(r'<div class="fullImageLink" id="file"><a href="([\/\w\.\-]+)">')
+
+ imagePath = path + "/" + imageName.replace(" ","")
+
+ match = re.search(mwImagePattern,imagePage)
+ if match is not None:
+ imageURL = match.group(1)
+ imageURL = "http://www.mantidproject.org" + imageURL
+ if not os.path.exists(imagePath):
+ print "saving ", imageName, "to", imagePath
+ downloadImage(imageURL,imagePath)
+
+def generateRstImageLink(match,relImagePath):
+ link = "image:: " + relImagePath+ "/" + match.group(2) + "\n"
+ for i in range(3,len(match.groups())):
+ if match.group(i) is None:
+ break
+ #strip off the first character as it is the | pipe
+ imageOption = addImageOption(match.group(i)[1:])
+ if imageOption is not None:
+ link += "\t\t\t" + imageOption + "\n"
+ return link
+
+def addImageOption(mwImageOption):
+ imageOption = mwImageOption.strip()
+ if len(imageOption)>0:
+ if imageOption.endswith("px"):
+ return ":width: " + imageOption
+ elif imageOption in ["right","left","middle","centre"]:
+ return ":align: " + imageOption
+ else:
+ return ":alt: " + imageOption
+
+def cleanInlineImagesDefinition(rstLink):
+ match = re.search(r'^\s+:align:\s+\w+\s*$',rstLink,re.MULTILINE)
+ if match is not None:
+ #take the align out
+ rstLink = rstLink[0:match.start()] + rstLink[match.end()+1:]
+ #then add it at the end as a comment
+ rstLink += ".. FIXME (inline definition does not allow align)" + match.group(0)
+ return rstLink
+
+def ensureDirectoriesExist(path):
+ try:
+ os.makedirs(path)
+ except OSError:
+ pass
+
+def addLocalLinks(rstText,list,prefix):
+ retRstText = rstText
+ #build regex string for simple words
+ regex = r"[^`<]((\*{0,2})(\b" + r"\b|\b".join(list) + r"\b)\2)[^`_]"
+ pattern = re.compile(regex)
+
+ replacements = []
+ for m in re.finditer(pattern, retRstText):
+ rstLink = ":ref:`" + m.group(3) + " <" + prefix + m.group(3) + ">`"
+ print ("processing new link",m.group(1), rstLink)
+ replacements.append((m.start(1), m.end(1), m.group(1), rstLink))
+
+ #perform replacements in reverse order
+ for (start,end,item,rstLink) in reversed(replacements):
+ retRstText = retRstText[0:start] + rstLink + retRstText[end:]
+
+ #build regex string for links
+ regexLink = r"`(.+?)<(\b" + r"\b|\b".join(list) + r"\b)>`__"
+ patternLink = re.compile(regexLink)
+ replacements = []
+ for m in re.finditer(patternLink, retRstText):
+ rstLink = ":ref:`" + m.group(1) + " <" + prefix + m.group(2) + ">`"
+ print ("processing existing link",m.group(0), rstLink)
+ replacements.append((m.start(), m.end(), m.group(0), rstLink))
+
+ #perform replacements in reverse order
+ for (start,end,item,rstLink) in reversed(replacements):
+ retRstText = retRstText[0:start] + rstLink + retRstText[end:]
+
+ return retRstText
+
+def fixUnderscoresInRefLinks(rstText):
+ retRstText = rstText
+ retRstText = re.sub(r"\b\\\_","_",retRstText)
+
+ return retRstText
+
+################################################################################################################
+
+parser = argparse.ArgumentParser(description='Converts mediawiki pages to rst pages for sphinx.')
+parser.add_argument('inputURL', help='the url of a mediawiki page')
+parser.add_argument('-o', '--o',
+ help='Provide a path to output to a file')
+parser.add_argument('-i', '--i',
+ help='Provide a relative path from the file to the images directory')
+parser.add_argument('-rp', '--rp',
+ help='Provide a reference link prefix')
+parser.add_argument('-r', '--r',
+ help='Provide a reference link')
+
+args = parser.parse_args()
+print args.inputURL
+print args.o
+
+urlSegments = urlparse.urlparse(args.inputURL)
+pageName = urlSegments.path[1:]
+print "Parsing ", pageName
+
+#run pandoc and get the output in rst
+mediawikiText = readWebPage(convertURLToRaw(args.inputURL))
+
+#run pandoc and get the output in rst
+rstText = covertMediaWikiToRST(convertURLToRaw(args.inputURL))
+
+#print "*****************"
+#print rstText
+#print "*****************"
+
+relPath = "../images"
+if args.i is not None:
+ relPath = os.path.dirname(args.i)
+outDir = os.curdir
+if args.o is not None:
+ outDir = os.path.dirname(args.o)
+
+imagePath = os.path.join(outDir,relPath)
+imagePath = os.path.abspath(imagePath)
+print imagePath, outDir
+
+ensureDirectoriesExist(imagePath)
+ensureDirectoriesExist(outDir)
+
+#perform any processing beyond pandoc
+rstText = fixUnderscoresInRefLinks(rstText)
+
+rstText = processImageLinks(mediawikiText,rstText, imagePath, relPath)
+
+wsList = ['EventWorkspace','MatrixWorkspace','PeaksWorkspace','MDWorkspace','Table Workspaces','WorkspaceGroup',
+ 'RectangularDetector','RAW File','Facilities File','FitConstraint','Framework Manager',
+ 'Instrument Data Service','InstrumentDefinitionFile','InstrumentParameterFile','Properties File',
+ 'MDHistoWorkspace','MDNorm','Nexus file','PeaksWorkspace','Point and space groups','RAW File'
+ 'Shared Pointer','Symmetry groups','Unit Factory','UserAlgorithms','Workflow Algorithm',
+ 'Workspace','Workspace2D','WorkspaceGroup']
+rstText = addLocalLinks(rstText,wsList,"")
+
+algList = mantid.AlgorithmFactory.getRegisteredAlgorithms(False).keys()
+rstText = addLocalLinks(rstText,algList,"algm-")
+
+funcList = mantid.FunctionFactory.getFunctionNames()
+rstText = addLocalLinks(rstText,funcList,"func-")
+
+#add reference name
+refPrefix = "train-"
+if args.rp is not None:
+ refPrefix = args.rp
+refName = pageName
+if args.r is not None:
+ refName = args.r
+rstText = ".. _" + refPrefix + refName + ":\n\n" + rstText
+
+#save output
+if args.o is not None:
+ sys.stdout = open(args.o, 'w')
+print rstText
+