Changeset 247

Timestamp:

Dec 4, 2009 5:02:51 PM (14 years ago)

Author:

toby

Message:

# on 2000/07/28 20:20:03, toby did:
document profile constraints

File:

• trunk/doc/expgui6.html (modified) (4 diffs, 3 props)

trunk/doc/expgui6.html

@@ -36 +36 @@
 The constraints pane is used to set these "hard constraints."
 At this time the only constraints that can be set in EXPGUI are on atomic
-parameters (others can be set in EXPEDT).
+and profile profile (others can be set in EXPEDT).
 <P>
-Note that these constraints are only applied to shifts but not to the
+Note that these constraints are only applied to shifts, but not to the
 actual values. This means that, for example, 
 if two atoms 
@@ -45 +45 @@
 as the values refine.
 <P>
+Due to the way GSAS implements constraints, a parameter can be included 
+in only one constraint. Should one or more parameters be constrained twice,
+the refinement results are unpredictable.
+
+</DL></DL>
 <H4>Atom Constraints</H4>
+<DL><DL>
 The atom constraints editing pane appears below. Note that constraints can 
 be listed sorted by constraint number, phase number, lowest atom number or
@@ -55 +61 @@
 <DL><DL>
 
-Due to the way GSAS implements these constraints, a parameter can be included 
-in only one constraint. Should one or more parameters be constrained twice, 
-an error message is shown as shown below.
-Note that the constraint number is displayed as red, for constraints that 
-have conflicts in the constraints editing pane (see above.)
+Should parameters be included in more than one constraint, 
+an error message is displayed, as shown below.
+Note that the constraint number is displayed as red on the main 
+atomic constraints window (see above), if the 
+constraint contains a parameter referenced elsewhere.
+
 </DL></DL>
 <img SRC="mcerr.gif" align=TEXTTOP>
@@ -95 +102 @@
 </DL></DL>
 
+<H4>Profile Constraints</H4>
+<DL><DL>
+The profile constraints editing pane appears below. Profile constraints
+are used to relate the shifts applied to profile terms for different
+phase/histogram combinations. Profile terms are identified by number,
+so while EXPEDT allows one to constrain the first profile term for
+a TOF histogram to a the first term in a CW histogram, EXPGUI attempts to 
+make this impossible. 
+<P>
+To delete one or more constraints, click on the appropriate checkbuttons
+in the <B>Delete</B> column and the press the Delete button, below.
+</DL></DL>
+<img SRC="pc.gif" align=TEXTTOP>
+<DL><DL>
+
+<img SRC="pcerr.gif" align=LEFT>
+Should parameters be included in more than one constraint, 
+an error message is displayed, as shown below.
+Note that the constraint number is displayed as red on the main 
+profile constraints window (see above), if the 
+constraint contains a parameter referenced elsewhere.
+
+<BR CLEAR=LEFT>
+<P>
+When the edit button for a constraint is pressed, the constraint is 
+opened for editing, as shown below. 
+Listboxes contain the available phases and histograms.
+Only the histograms of the same data type (TOF, CW or ED) are included,
+but no check is made to ensure that the 
+selected phase/histogram combinations
+all have the same profile type.
+Note that for phase and histogram selection, use of the control key 
+and the left mouse button allow individual items to be selected or deselected.
+Shift and the left mouse button allow ranges of items to be selected and the 
+right mouse button selects all phases or histograms.
+<A href="expgui.html#mouseactions">(see Mouse Actions)</A>.
+<P>
+<img SRC="pcedit.gif" align=TEXTTOP>
+<P>
+</DL></DL>
+<img SRC="pcnew1.gif" align=LEFT>
+When the "New Constraint" button is pressed, a window is opened to select
+the histogram and profile function type to be constrained. Note that 
+only for profile function #4, where the number of terms depends on the 
+phase symmetry, does it matter what phase you select. The available profile 
+terms are displayed on the bottom of the window and more than
+one can be selected. 
+<BR CLEAR=LEFT>
+<P>
+<DL><DL>
+<img SRC="pcnew2.gif" align=LEFT>
+
+After the "Continue" button is pressed, a constraint 
+edit window is opened, as shown to the left.
+Listboxes contain the available phases and histograms and 
+only the histograms of the selected data type are included, as before.
+Also, for phase and histogram selection, use of the control or shift key 
+and the left mouse button allow individual items to be selected or deselected
+and the right mouse button selects all phases or histograms.
+Note that if more than one profile term was selected on the previous window,
+the same set of constraints are for each term.
+
+<BR CLEAR=LEFT>
+</DL></DL>
 <hr>
 <A Href="expgui.html">EXPGUI top</A>