Ignore:
Timestamp:
Apr 30, 2015 12:39:39 PM (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:
a9dc4eb
Parents:
892a2cc
Message:

Work in progress

File:
1 edited

Legend:

Unmodified
Added
Removed
  • src/sas/guiframe/media/graph_help.rst

    r1394952 r0cdf1af  
    1111==================== 
    1212 
    13 Graph_Window_Options_ 
    14  
    15 Dataset_Menu_Options_ 
    16  
    17 2D_Data_Averaging_ 
     13Help is available on: 
     14 
     15Graph_window_options_ 
     16 
     17Dataset_menu_options_ 
     18 
     192D_data_averaging_ 
    1820 
    1921.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ 
    2022 
    21 .. _Graph_Window_Options: 
    22  
    23 Graph Window Options 
     23.. _Graph_window_options: 
     24 
     25Graph window options 
    2426-------------------- 
    2527 
    26 Invoking_the_Graph_Menu_ 
    27  
    28 Hide_Show_Delete_Graph_ 
    29  
    30 Drag_Plot_ 
    31  
    32 Zoom_In_Out_ 
    33  
    34 Save_Plot_Image_ 
    35  
    36 Print_Plot_ 
    37  
    38 Reset_Graph_ 
    39  
    40 Graph_Modifications_ 
    41  
    42 Change_Scale_ 
    43  
    44 Toggle_Scale_ 
    45  
    46 2D_Color_Map_ 
    47  
    48 Data_Coordinates_ 
    49  
    50 .. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ 
    51  
    52 .. _Dataset_Menu_Options: 
    53  
    54 Dataset Menu Options 
    55 -------------------- 
    56  
    57 Invoking_the_Dataset_Menu_ 
    58  
    59 Data_Info_ 
    60  
    61 Save_Data_ 
    62  
    63 Linear_Fit_ 
    64  
    65 Remove_Data_from_Plot_ 
    66  
    67 Show_Hide_Error_Bars_ 
    68  
    69 Modify_Plot_Property_ 
    70  
    71 2D Averaging 
    72 ------------ 
    73  
    74 2D_Data_Averaging_ 
     28Invoking_the_graph_menu_ 
     29 
     30How_to_Hide-Show-Delete_a_graph_ 
     31 
     32Dragging_a_plot_ 
     33 
     34Zooming_In-Out_on_a_plot_ 
     35 
     36Saving_a_plot_image_ 
     37 
     38Printing_a_plot_ 
     39 
     40Resetting_the_graph_ 
     41 
     42Modifying_the_graph_ 
     43 
     44Changing_scales_ 
     45 
     46Toggling_scales_ 
     47 
     482D_color_maps_ 
     49 
     50Getting_data_coordinates_ 
    7551 
    7652.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ 
    7753 
    78 .. _Invoking_the_Graph_Menu: 
    79  
    80 Invoking the Graph Menu 
    81 ----------------------- 
     54.. _Invoking_the_graph_menu: 
     55 
     56Invoking the graph menu 
     57^^^^^^^^^^^^^^^^^^^^^^^ 
    8258 
    8359To invoke the *Graph Menu* simply right-click on a data/theory plot, or click  
     
    8561Then select a menu item. 
    8662 
    87 .. _Hide_Show_Delete_Graph: 
    88  
    89 Hide/Show/Delete Graph 
    90 ---------------------- 
     63.. _How_to_Hide-Show-Delete_a_graph: 
     64 
     65How to Hide-Show-Delete a graph 
     66^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 
    9167 
    9268To expand a plot window, click the *Maximise* (square) icon in the top-right  
     
    10884after computation.* 
    10985 
    110 .. _Drag_Plot: 
    111  
    112 Drag Plot 
    113 --------- 
     86.. _Dragging_a_plot: 
     87 
     88Dragging a plot 
     89^^^^^^^^^^^^^^^ 
    11490 
    11591Select the *Pan* (crossed arrows) icon in the toolbar at the bottom of the plot  
     
    12096To disable dragging mode, unselect the *crossed arrows* icon on the toolbar. 
    12197 
    122 .. _Zoom_In_Out: 
    123  
    124 Zoom In/Out 
    125 ----------- 
     98.. _Zooming_In-Out_on_a_plot: 
     99 
     100Zooming In-Out on a plot 
     101^^^^^^^^^^^^^^^^^^^^^^^^ 
    126102 
    127103Select the *Zoom* (magnifying glass) button in the toolbar at the bottom of  
     
    140116 
    141117To return to the original view of the data, click the the *Reset* (home) icon  
    142 in the toolbar at the bottom of the plot (see Reset_Graph_ for further details). 
    143  
    144 .. _Save_Plot_Image: 
    145  
    146 Save Plot Image 
    147 --------------- 
     118in the toolbar at the bottom of the plot (see Resetting_the_graph_ for further details). 
     119 
     120.. _Saving_a_plot_image: 
     121 
     122Saving a plot image 
     123^^^^^^^^^^^^^^^^^^^ 
    148124 
    149125To save the current plot as an image file, right click on the plot to bring up  
    150 the *Graph Menu* (see Invoking_the_Graph_Menu_) and select *Save Image*.  
     126the *Graph Menu* (see Invoking_the_graph_menu_) and select *Save Image*. 
    151127Alternatively, click on the *Save* (floppy disk) icon in the toolbar at the  
    152128bottom of the plot. 
     
    167143*  TIF/TIFF (tagged iamge file) 
    168144 
    169 .. _Print_Plot: 
    170  
    171 Print Plot 
    172 ---------- 
     145.. _Printing_a_plot: 
     146 
     147Printing a plot 
     148^^^^^^^^^^^^^^^ 
    173149 
    174150To send the current plot to a printer, click on the *Print* (printer) icon in  
    175151the toolbar at the bottom of the plot. 
    176152 
    177 .. _Reset_Graph: 
    178  
    179 Reset Graph 
    180 ----------- 
     153.. _Resetting_the_graph: 
     154 
     155Resetting the graph 
     156^^^^^^^^^^^^^^^^^^^ 
    181157 
    182158To reset the axis range of a graph to its initial values select *Reset Graph  
    183 Range* on the *Graph Menu* (see Invoking_the_Graph_Menu_). Alternatively, use  
     159Range* on the *Graph Menu* (see Invoking_the_graph_menu_). Alternatively, use 
    184160the *Reset* (home) icon in the toolbar at the bottom of the plot. 
    185161 
    186 .. _Graph_Modifications: 
    187  
    188 Graph Modifications 
    189 ------------------- 
    190  
    191 From the *Graph Menu* (see Invoking_the_Graph_Menu_) it is also possible to  
     162.. _Modifying_the_graph: 
     163 
     164Modifying the graph 
     165^^^^^^^^^^^^^^^^^^^ 
     166 
     167From the *Graph Menu* (see Invoking_the_graph_menu_) it is also possible to 
    192168make some custom modifications to plots, including: 
    193169 
     
    200176*  adding a grid overlay 
    201177 
    202 .. _Change_Scale: 
    203  
    204 Change Scale 
    205 ------------ 
     178.. _Changing_scales: 
     179 
     180Changing scales 
     181^^^^^^^^^^^^^^^ 
    206182 
    207183This menu option is only available with 1D data. 
    208184 
    209 From the *Graph Menu* (see Invoking_the_Graph_Menu_) select *Change Scale*. A  
     185From the *Graph Menu* (see Invoking_the_graph_menu_) select *Change Scale*. A 
    210186dialog window will appear in which it is possible to choose different  
    211187transformations of the x (usually Q) or y (usually I(Q)) axes, including: 
     
    225201For properly corrected and scaled data, these SAS transformations can be used  
    226202to estimate, for example, Rg, rod diameter, or SANS incoherent background  
    227 levels, via a linear fit (see Linear_Fit_). 
    228  
    229 .. _Toggle_Scale: 
    230  
    231 Toggle Scale 
    232 ------------ 
     203levels, via a linear fit (see Making_a_linear_fit_). 
     204 
     205.. _Toggling_scales: 
     206 
     207Toggling scales 
     208^^^^^^^^^^^^^^^ 
    233209 
    234210This menu option is only available with 2D data. 
    235211 
    236 From the *Graph Menu* (see Invoking_the_Graph_Menu_) select *Toggle Linear/Log  
     212From the *Graph Menu* (see Invoking_the_graph_menu_) select *Toggle Linear/Log 
    237213Scale* to switch between a linear to log intensity scale. The type of scale  
    238214selected is written alongside the colour scale. 
    239215 
    240 .. _2D_Color_Map: 
    241  
    242 2D Color Map 
    243 ------------ 
     216.. _2D_color_maps: 
     217 
     2182D color maps 
     219^^^^^^^^^^^^^ 
    244220 
    245221This menu option is only available with 2D data. 
     
    249225minimum limits of the scale. 
    250226 
    251 .. _Data_Coordinates: 
    252  
    253 Data Coordinates 
    254 ---------------- 
     227.. _Getting_data_coordinates: 
     228 
     229Getting data coordinates 
     230^^^^^^^^^^^^^^^^^^^^^^^^ 
    255231 
    256232Clicking anywhere in the plot window will cause the current coordinates to be  
     
    259235.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ 
    260236 
    261 .. _Invoking_the_Dataset_Menu: 
    262  
    263 Invoking_the_Dataset_Menu 
    264 ------------------------- 
    265  
    266 From the *Graph Menu* (see Invoking_the_Graph_Menu_) highlight a plotted  
     237.. _Dataset_menu_options: 
     238 
     239Dataset menu options 
     240-------------------- 
     241 
     242Invoking_the_dataset_menu_ 
     243 
     244Getting_data_info_ 
     245 
     246Saving_data_ 
     247 
     248Making_a_linear_fit_ 
     249 
     250Removing_data_from_the_plot_ 
     251 
     252Show-Hide_error_bars_ 
     253 
     254Modify_plot_properties_ 
     255 
     256.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ 
     257 
     258.. _Invoking_the_dataset_menu: 
     259 
     260Invoking the dataset menu 
     261^^^^^^^^^^^^^^^^^^^^^^^^^ 
     262 
     263From the *Graph Menu* (see Invoking_the_graph_menu_) highlight a plotted 
    267264dataset. 
    268265 
    269 .. _Data_Info: 
    270  
    271 Data Info 
    272 --------- 
    273  
    274 In the *Dataset Menu* (see Invoking_the_Dataset_Menu_), highlight a data set  
     266.. _Getting_data_info: 
     267 
     268Getting data info 
     269^^^^^^^^^^^^^^^^^ 
     270 
     271In the *Dataset Menu* (see Invoking_the_dataset_menu_), highlight a data set 
    275272and select *DataInfo* to bring up a data information dialog panel for that  
    276273data set. 
    277274 
    278 .. _Save_Data: 
    279  
    280 Save Data 
    281 --------- 
    282  
    283 In the *Dataset Menu* (see Invoking_the_Dataset_Menu_), select *Save Points as  
     275.. _Saving_data: 
     276 
     277Saving data 
     278^^^^^^^^^^^ 
     279 
     280In the *Dataset Menu* (see Invoking_the_dataset_menu_), select *Save Points as 
    284281a File* (if 1D data) or *Save as a file(DAT)* (if 2D data). A save dialog will  
    285282appear. 
     
    2902872D data can only be saved in the NIST 2D format (.DAT) (see :ref:`2D_Formats`). 
    291288 
    292 .. _Linear_Fit: 
    293  
    294 Linear Fit 
    295 ---------- 
     289.. _Making_a_linear_fit: 
     290 
     291Making a linear fit 
     292^^^^^^^^^^^^^^^^^^^ 
    296293 
    297294Linear fit performs a simple ( y(x)=ax+b ) linear fit within the plot window. 
    298295 
    299 In the *Dataset Menu* (see Invoking_the_Dataset_Menu_), select *Linear Fit*. A  
     296In the *Dataset Menu* (see Invoking_the_dataset_menu_), select *Linear Fit*. A 
    300297fitting dialog will appear. Set some initial parameters and data limits and  
    301298click *Fit*. The fitted parameter values are displayed and the resulting line  
     
    310307.. image:: guinier_fit.png 
    311308 
    312 .. _Remove_Data_from_Plot: 
    313  
    314 Remove Data from Plot 
    315 --------------------- 
    316  
    317 In the *Dataset Menu* (see Invoking_the_Dataset_Menu_), select *Remove*. The  
     309.. _Removing_data_from_the_plot: 
     310 
     311Removing data from the plot 
     312^^^^^^^^^^^^^^^^^^^^^^^^^^^ 
     313 
     314In the *Dataset Menu* (see Invoking_the_dataset_menu_), select *Remove*. The 
    318315selected data will be removed from the plot. 
    319316 
    320317*NOTE! This action cannot be undone.* 
    321318 
    322 .. _Show_Hide_Error_Bars: 
    323  
    324 Show/Hide Error Bars 
    325 -------------------- 
    326  
    327 In the *Dataset Menu* (see Invoking_the_Dataset_Menu_), select *Show Error Bar*  
     319.. _Show-Hide_error_bars: 
     320 
     321Show-Hide error bars 
     322^^^^^^^^^^^^^^^^^^^^ 
     323 
     324In the *Dataset Menu* (see Invoking_the_dataset_menu_), select *Show Error Bar* 
    328325or *Hide Error Bar* to switch between showing/hiding the errors associated  
    329326with the chosen dataset.  
    330327 
    331 .. _Modify_Plot_Property: 
    332  
    333 Modify Plot Property 
    334 -------------------- 
    335  
    336 In the *Dataset Menu* (see Invoking_the_Dataset_Menu_), select *Modify Plot  
     328.. _Modify_plot_properties: 
     329 
     330Modify plot properties 
     331^^^^^^^^^^^^^^^^^^^^^^ 
     332 
     333In the *Dataset Menu* (see Invoking_the_dataset_menu_), select *Modify Plot 
    337334Property* to change the size, color, or shape of the displayed marker for the  
    338335chosen dataset, or to change the dataset label that appears on the plot. 
     
    340337.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ 
    341338 
    342 .. _2D_Data_Averaging: 
    343  
    344 2D Data Averaging 
     339.. _2D_data_averaging: 
     340 
     3412D data averaging 
    345342----------------- 
    346343 
    347344Purpose_ 
    348345 
    349 How_to_Average_ 
    350  
    351 Available_Averagings_ 
    352  
    353 Unmasked_Circular_Average_ 
    354  
    355 Masked_Circular_Average_ 
    356  
    357 Sector_Average_ 
    358  
    359 Annular_Average_ 
    360  
    361 Box_Sum_ 
    362  
    363 Box_Averaging_in_Qx_ 
    364  
    365 Box_Averaging_in_Qy_ 
     346How_to_average_ 
     347 
     348Unmasked_circular_average_ 
     349 
     350Masked_circular_average_ 
     351 
     352Sector_average_ 
     353 
     354Annular_average_ 
     355 
     356Box_sum_ 
     357 
     358Box_averaging_in_Qx_ 
     359 
     360Box_averaging_in_Qy_ 
    366361 
    367362.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ 
    368363 
    369 .. Purpose:  
     364.. _Purpose: 
    370365 
    371366Purpose 
    372 ------- 
     367^^^^^^^ 
    373368 
    374369This feature is only available with 2D data. 
     
    378373can be modified by dragging the boundaries around. 
    379374 
    380 .. _How_to_Average: 
    381  
    382 How to Average 
    383 -------------- 
    384  
    385 In the *Dataset Menu* (see Invoking_the_Dataset_Menu_), select one of the  
     375.. _How_to_average: 
     376 
     377How to average 
     378^^^^^^^^^^^^^^ 
     379 
     380In the *Dataset Menu* (see Invoking_the_dataset_menu_), select one of the 
    386381following averages 
    387382 
     
    416411To remove a 'slicer', bring back the *Dataset menu* and select *Clear Slicer*. 
    417412 
    418 .. _Available_Averagings: 
    419  
    420 Available Averagings 
    421 -------------------- 
    422  
    423 The available averages are 
    424  
    425 .. _Unmasked_Circular_Average: 
    426  
    427 Unmasked Circular Average 
    428 ------------------------- 
     413.. _Unmasked_circular_average: 
     414 
     415Unmasked circular average 
     416^^^^^^^^^^^^^^^^^^^^^^^^^ 
    429417 
    430418This operation will perform an average in constant Q-rings around the (x,y)  
    431419pixel location of the beam center. 
    432420 
    433 .. _Masked_Circular_Average: 
    434  
    435 Masked Circular Average 
    436 ----------------------- 
     421.. _Masked_circular_average: 
     422 
     423Masked circular average 
     424^^^^^^^^^^^^^^^^^^^^^^^ 
    437425 
    438426This operation is the same as 'Unmasked Circular Average' except that any  
    439427masked region is excluded. 
    440428 
    441 .. _Sector_Average: 
    442  
    443 Sector Average [Q View] 
    444 ----------------------- 
     429.. _Sector_average: 
     430 
     431Sector average [Q View] 
     432^^^^^^^^^^^^^^^^^^^^^^^ 
    445433 
    446434This operation averages in constant Q-arcs. 
     
    449437of the central angle (|phi|\). 
    450438 
    451 .. _Annular_Average: 
    452  
    453 Annular Average [|phi| View] 
    454 ---------------------------- 
     439.. _Annular_average: 
     440 
     441Annular average [|phi| View] 
     442^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 
    455443 
    456444This operation performs an average between two Q-values centered on (0,0),  
     
    460448degrees at the 3 O'clock position. 
    461449 
    462 .. _Box_Sum: 
    463  
    464 Box Sum 
    465 ------- 
     450.. _Box_sum: 
     451 
     452Box sum 
     453^^^^^^^ 
    466454 
    467455This operation performs a sum of counts in a 2D region of interest. 
     
    470458the rectangular slicer and the coordinates of the center of the rectangle. 
    471459 
    472 .. _Box_Averaging_in_Qx: 
     460.. _Box_averaging_in_Qx: 
    473461 
    474462Box Averaging in Qx 
    475 ------------------- 
     463^^^^^^^^^^^^^^^^^^^ 
    476464 
    477465This operation computes an average I(Qx) for the region of interest. 
     
    482470is, the central value of each bin on the x-axis. 
    483471 
    484 .. _Box_Averaging_in_Qy: 
     472.. _Box_averaging_in_Qy: 
    485473 
    486474Box Averaging in Qy 
    487 ------------------- 
    488  
     475^^^^^^^^^^^^^^^^^^^ 
    489476 
    490477This operation computes an average I(Qy) for the region of interest. 
     
    497484.. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ 
    498485 
    499 .. note::  This help document was last changed by Steve King, 18Feb2015 
     486.. note::  This help document was last changed by Steve King, 30Apr2015 
Note: See TracChangeset for help on using the changeset viewer.