Changeset 63d314b in sasview for src/sas/perspectives/fitting

Timestamp:

May 27, 2015 4:15:10 AM (10 years ago)

Author:

smk78

Branches:

master, ESS_GUI, ESS_GUI_Docs, ESS_GUI_batch_fitting, ESS_GUI_bumps_abstraction, ESS_GUI_iss1116, ESS_GUI_iss879, ESS_GUI_iss959, ESS_GUI_opencl, ESS_GUI_ordering, ESS_GUI_sync_sascalc, costrafo411, magnetic_scatt, release-4.1.1, release-4.1.2, release-4.2.2, release_4.0.1, ticket-1009, ticket-1094-headless, ticket-1242-2d-resolution, ticket-1243, ticket-1249, ticket885, unittest-saveload

Children:

b5846a10

Parents:

9776c82

Message:

Work in progress

File:

• src/sas/perspectives/fitting/media/fitting_help.rst (modified) (4 diffs)

src/sas/perspectives/fitting/media/fitting_help.rst

@@ -314 +314 @@
 *the Data Explorer is checked (see the section* :ref:`Loading_data` *).*
 
+This mode fits one data set.
+
 When data is sent to the fitting perspective it is plotted in a graph window as
 markers.
@@ -359 +361 @@
 ---------------------
 
-This fitting option enables to set a number of the constraints between the 
-parameters of fitting(s). It requires one or more FitPages with a data and a 
-model set for the fitting, and performs multiple fittings given by the 
-FitPage(s). The Complex (ParkMC) FitEngine will be used automatically.
-
-Simultaneous Fit without Constraint
+*NB: Before proceeding, ensure that the Single Mode radio button at the bottom of*
+*the Data Explorer is checked (see the section* :ref:`Loading_data` *).*
+
+This mode is an extension of the :ref:`Single Fit Mode` that fits two or more data 
+sets *to the same model* simultaneously. If necessary it is possible to constrain 
+fit parameters between data sets (eg, to fix a background level, or radius, etc).
+
+If the data to be fit are in multiple files, load each file, select it in the 
+*Data Explorer*, and *Send To Fitting*.
+
+If multiple data sets are in one file, load that file, *Unselect All Data*, then 
+select each dataset one at a time and Send To Fitting.
+
+The result should be that for 
+n
+datsets you have 2
+n
+graphs (
+n
+of the data & model fit and 
+n
+residuals plots).
+
+IMPORTANT! 
+If you need to create a n
+ew model with the new model wizard, or use a 
+model which is the sum of two existing models, go Fitting 
+
+Edit Custom Model 
+before
+sending the data to the fitting engine.
+The model will be available under 
+‘
+Customised 
+Models
+’
+on 
+the FitPage. NB: the name will likely be abbreviated; eg, 
+‘
+Peak 
+Gauss
+Model + Absolute Power Law Model
+’
+will appear as 
+‘
+PGM + APL
+’
+.
+3.
+Go to each Fit
+Page in turn
+and:
+
+Select the required model.
+
+Unselect all the model par
+ameters.
+
+Enter some starting guesses for the parameters (it may be helpful to remove the 
+residuals plots for clarity; go Graph 
+
+Show and untick graph windows as required).
+
+Enter any parameter limits (recommended).
+
+Select which parameters will refine (sele
+cting all is probably a bad idea...).
+4.
+Select Fitting 
+
+Simultaneous Fit (this also selects the Complex Fit Engine).
+5.
+Go to the Simultaneous Fit page
+and:
+
+Select which datasets are to be fitted (which will probably be all of them or you wouldn’t 
+have 
+loaded them in!).
+
+It is possible to tie parameters between datasets with constraints; eg, make the 
+Background in FitPage1 the same as the Background in FitPage2, and so on. To do this, 
+answer ‘yes’ to Add Constraints in the Fit Constraints box.
+
+But note th
+at SANSView only lets you constrain parameters that are refining.
+6.
+Click Fit
+
+
+
+Simultaneous Fits without Constraints
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Assuming some FitPages are already set up, check the checkboxes of the 
@@ -374 +462 @@
 FitPage to recalculate.
 
-Simultaneous Fit with Constraint
+Simultaneous Fits with Constraints
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Enter constraint in the text control next to *constraint fit*  button. 
@@ -391 +480 @@
 Batch Fit Mode
 --------------
+
+*NB: Before proceeding, ensure that the Batch Mode radio button at the bottom of*
+*the Data Explorer is checked (see the section* :ref:`Loading_data` *).*
 
 Batch Fit