Ignore:
Timestamp:
Dec 25, 2016 9:43:21 PM (5 years ago)
Author:
toby
Message:

redo drawing and editing of masks, document; add transfer angles to Integration controls

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/help/gsasII.html

    r2545 r2602  
    31693169that can be selected, cut &amp; pasted into a document. <o:p></o:p></span></p>
    31703170
     3171<h3><a name=Tutorials><strong>Macintosh
     3172notes</strong></a><strong>:<o:p></o:p></strong></h3>
     3173
     3174GSAS-II can be run on Windows, Linux and Macintosh/OS X computers, but
     3175due to the different nature of the Mac, the program behaves slightly
     3176differently. On Windows and Linux, there are two menu bars: (A) found
     3177at the top of the GSAS-II data tree and (B) on GSAS-II data editing
     3178window. The latter changes, based on which data item is selected in
     3179the data tree. On the Mac, these menus are combined located on the
     3180location that has been configured for menus (usually at the top of the
     3181screen). The main manu and the data editing menu (if present) are
     3182separated by a vertical bar.
     3183<P>
     3184GSAS-II uses both the left and right buttons on a two-button mouse. If
     3185a mac has a two or three-button mouse attached, these mouse buttons will be
     3186used on the other platforms. If using a Mac touchpad or single-button
     3187mouse, the control-key should be held down to simulate use of the
     3188right mouse button. The left button click is generated otherwise. 
     3189
    31713190<h2><a name=Programmers><strong>Programmers documentation</strong></a><strong>:<o:p></o:p></strong></h2>
    31723191
     
    55055524
    55065525<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
    5507 "Times New Roman"'>This window... <span class=MsoHyperlink><span
     5526"Times New Roman"'>This window displays calibration values needed to
     5527convert pixel locations to two-theta and azimuth. Also shown are
     5528controls that determine how integration is performed.
     5529<P class=MsoNormal style='margin-left:.5in'>
     5530Menu command for this window are used to perform calibration (fitting
     5531the calibration values from a diffraction pattern image taken with a
     5532calibrant) and for integration. Other menu commands allow the values
     5533on the window to be saved to a file, read from a file or copied to
     5534other images. The "Xfer Angles" menu command scales the current
     5535integration range for other images located at different detector
     5536distances.
     5537
     5538
     5539<span class=MsoHyperlink><span
    55085540style='color:windowtext;text-decoration:none;text-underline:none'><o:p></o:p></span></span></span></p>
    55095541
    5510 <h4 style='margin-left:.5in'>Ma<a name="Image_Masks"></a>sks</h4>
     5542<h4 style='margin-left:.5in'><a name="Image_Masks">Masks</a></h4>
    55115543
    55125544<p class=MsoNormal style='margin-left:.5in'><span style='mso-fareast-font-family:
    5513 "Times New Roman"'>This window... <span class=MsoHyperlink><span
     5545"Times New Roman"'>
     5546Image masks are used designate areas of an image that should not be
     5547included in the integration, typically used due to detector
     5548irregularities, shadows of the beamstop, single-crystal peaks from a
     5549mounting, etc. Masks can be created with a menu command or with
     5550keyboard/mouse shortcuts.
     5551
     5552There are five types of masks:<OL>
     5553<LI style='margin-left:.5in'>Spot masks: occlude a circle with a
     5554  selected center and diameter in image coordinates (mm).
     5555<P style='margin-left:.25in'><B>Create Spot masks</B> with a menu command and then by clicking on
     5556  the location on the image that should be masked. Or, there are also
     5557  three ways to create spot masks with the keyboard:
     5558 <UL>
     5559<LI style='margin-left:.2in'>Press the 's' key and then click on the mask location.   
     5560<LI style='margin-left:.2in'>Press the 'm' key and
     5561   then click successively on multiple locations for spot masks. Press the 'm' key again
     5562   to stop adding spot masks.
     5563<LI style='margin-left:.2in'>Move the mouse to the position for a
     5564   new spot mask and press the 't' key. (Note that
     5565   this can be used while the plot is in Zoom or Pan mode.)
     5566</UL>
     5567<P style='margin-left:.25in'><B>Edit Spot mask location</B> by left-clicking inside
     5568  or on the edge the of the mask and then drag the spot mask to a new
     5569  location.
     5570<P style='margin-left:.25in'><B>Edit Spot mask radius</B> by <a href="#Mac_rightclick">right-clicking*</a> inside
     5571  the mask and then dragging to change the mask size.
     5572
     5573<LI style='margin-left:.5in'>Ring masks: occludes a specific Bragg
     5574  reflection (a ring placed relative to the image center). The
     5575  location and thickness of the ring are specified in degrees
     5576  2-theta.
     5577<P style='margin-left:.25in'><B>Create Ring masks</B> with a menu command and then by clicking on
     5578  the location on the image that should be masked. Or, by pressing the
     5579  'r' key and then clicking at the appropriate radius. Initially the
     5580  mask is given a thickness of 0.1 degrees.
     5581<P style='margin-left:.25in'><B>Edit Ring mask location</B> by
     5582  left-clicking on either the inner or outer circle and drag the
     5583  circle to the new radius.
     5584<P style='margin-left:.25in'><B>Edit Ring mask thickness</B> by
     5585  <a href="#Mac_rightclick">right-clicking*</a> either on the inner or outer circle and drag the
     5586  the circle change spacing between the inner and outer circle.
     5587
     5588<LI style='margin-left:.5in'>Arc masks: occludes a section of a Bragg
     5589  reflection, similar to a ring mask, except that in addition to the
     5590  location and thickness of the ring (in degrees
     5591  2-theta), the starting and ending
     5592  azimuthal angles are also specified in degrees.
     5593
     5594<P style='margin-left:.25in'><B>Create Arc masks</B> with a menu command and then by clicking on
     5595  the location on the image that should be masked. Or, by pressing the
     5596  'a' key and then clicking at the appropriate radius. Initially the
     5597  mask is given a thickness of 0.1 degrees and an azimuthal range of
     5598  10 degrees. 
     5599<P style='margin-left:.25in'><B>Edit Arc mask location</B> by
     5600  left-clicking on either the inner or outer circle and drag the
     5601  circle to the new radius. Alternately, left-click on the upper or
     5602  lower arc limit (the straight lines) and drag them to rotate the
     5603  center of the arc azimuthal range to a new position.
     5604<P style='margin-left:.25in'><B>Edit Arc mask thickness or range</B> by
     5605  <a href="#Mac_rightclick">right-clicking*</a> either on the inner or outer circle and drag the
     5606  the circle change spacing between the inner and outer
     5607  circle. Alternately, <a href="#Mac_rightclick">right-click*</a> on the upper or
     5608  lower arc limit (the straight lines) and drag them to change the
     5609  arc azimuthal range.
     5610
     5611<LI style='margin-left:.5in'>Polygon masks: occludes an arbitary
     5612  region created by line segments joining a series of points
     5613  specified in image coordinates (mm). Pixels inside the polygon mask are not
     5614  used for integration.
     5615<P style='margin-left:.25in'><B>Create Polygon masks</B> with a menu
     5616  command and then by left-clicking successively on the vertices of the
     5617  polygon shape surrounding pixels to be excluded. After the last
     5618  point is defined, <a href="#Mac_rightclick">right-click*</a>
     5619  anywhere to close the mask. Alternately, press the 'p' key and then
     5620  left-click, as before, to define the mask and  <a
     5621  href="#Mac_rightclick">right-click*</a> anywhere to close the mask.
     5622<P style='margin-left:.25in'><B>Edit Polygon mask</B> by
     5623  left-clicking on any point at a vertex in the polygon mask and drag
     5624  that point to a new position. If the vertex is dragged to the same
     5625  position as any other vertex in the mask the dragged point is deleted.
     5626<P style='margin-left:.25in'><B>Add a point to Polygon mask</B> by
     5627  <a href="#Mac_rightclick">right-clicking*</a> on any vertex and dragging. A new
     5628  point is added to the mask immediately after the selected point at
     5629  the position where the mouse is released.
     5630
     5631<LI style='margin-left:.5in'>The Frame mask: occludes an arbitary
     5632  region created by line segments joining a series of points
     5633  specified in image coordinates (mm). Typically a point is placed
     5634  near each corner of the image. Only pixels inside the frame mask are
     5635  used for integration. Only one frame mask can be defined.
     5636<P style='margin-left:.25in'><B>Create a Frame mask</B> with a menu
     5637  command and then by left-clicking successively on the vertices of a
     5638  polygon. After the last point is defined, <a href="#Mac_rightclick">right-click*</a>
     5639  anywhere to close the frame mask. Alternately, press the 'f' key and then
     5640  left-click, as before, to define the mask and  <a
     5641  href="#Mac_rightclick">right-click*</a> anywhere to close the mask.
     5642  Note that if a Frame mask already exists, using the 'f' key or the
     5643  "Create Frame" menu item causes the existing frame mask to be deleted.
     5644<P style='margin-left:.25in'><B>Edit the Frame mask</B> by
     5645  left-clicking on any point at a vertex in the frame mask and drag
     5646  that point to a new position. If the vertex is dragged to the same
     5647  position as any other vertex in the mask the dragged point is deleted.
     5648<P style='margin-left:.25in'><B>Add a point to the Frame mask</B> by
     5649  <a href="#Mac_rightclick">right-clicking*</a> on any vertex and dragging. A new
     5650  point is added to the mask immediately after the selected point at
     5651  the position where the mouse is released.
     5652</OL>
     5653<P style='margin-left:.5in'>The frame mask, if defined, is displayed in green, while
     5654the other types of masks are shown in red. <a name="Mac_rightclick">*</a>Note that on a Mac with a
     5655  one-button mouse, a right-click is generated by pressing the control
     5656  button while clicking the mouse.
     5657<span class=MsoHyperlink><span
    55145658style='color:windowtext;text-decoration:none;text-underline:none'><o:p></o:p></span></span></span></p>
    55155659
     
    74967640style='mso-bookmark:Pawley'><o:p>&nbsp;</o:p></span></p>
    74977641
    7498 <p class=MsoNormal style='margin-left:.5in'><span style='mso-bookmark:Pawley'><!-- hhmts start -->Last
    7499 modified: Mon Oct 31 17:35:19 CDT 2016 <!-- hhmts end --></span></p>
     7642<p class=MsoNormal style='margin-left:.5in'><span style='mso-bookmark:Pawley'><!-- hhmts start -->Last modified: Sun Dec 25 21:30:18 CST 2016 <!-- hhmts end --></span></p>
    75007643
    75017644</div>
Note: See TracChangeset for help on using the changeset viewer.