User Guide for Sample Reduction at GP-SANS
Bichler, Karin J., Debeer-Schmitt, Lisa M., He, Lilin et al. · 2025
Read User Guide for Sample Reduction at GP-SANS by Bichler, Karin J., Debeer-Schmitt, Lisa M., He, Lilin et al. (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/doe-osti-3013466-user-guide-for-sample-reduction-at-gp-sa.txt.
Introduction
Karin Bichler, Lisa DeBeer-Schmitt, Lilin He, Arina Rostopchina, and Arturo Diaz wrote this user guide, ORNL/TM-2025/4160, dated January 2026, for data reduction at GP-SANS. GP-SANS is the general-purpose small-angle neutron scattering instrument at Oak Ridge's High Flux Isotope Reactor. Visiting scientists measure samples there, then must reduce raw detector data into clean scattering curves before analysis.
The guide walks through the reduction workflow step by step. Users set folders and directories, choose the scattering vector range, and merge data taken at different detector distances into one stitched curve. Stitching ranges are saved to their own comma-separated files so runs can be reproduced. Screenshots and menu paths match the reduction software as installed, making the guide the first stop for new instrument users.
Catalog record
| CREATOR | Bichler, Karin J., Debeer-Schmitt, Lisa M., He, Lilin et al. |
|---|---|
| YEAR | 2025 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 9 KB |
| LICENSE | Public Domain |
| RIGHTS | PUBLIC DOMAIN |
| SOURCE | DOE OSTI |
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
ORNL/TM-2025/4160 User Guide for Sample Reduction at GP-SANS Karin Bichler Lisa DeBeer-Schmitt Lilin He Arina Rostopchina Arturo Diaz January 2026 ORNL IS MANAGED BY UT-BATTELLE LLC FOR THE US DEPARTMENT OF ENERGY DOCUMENT AVAILABILITY Online Access: US Department of Energy (DOE) reports produced after 1991 and a growing number of pre-1991 documents are available free via https://www.osti.gov. The public may also search the National Technical Information Service’s National Technical Reports Library (NTRL) for reports not available in digital format. DOE and DOE contractors should contact DOE’s Office of Scientific and Technical Information (OSTI) for reports not currently available in digital format: US Department of Energy Office of Scientific and Technical Information PO Box 62 Oak Ridge, TN 37831-0062 Telephone: (865) 576-8401 Fax: (865) 576-5728 Email: [email protected] Website: www.osti.gov This report was prepared as an account of work sponsored by an agency of the United States Government. Neither the United States Government nor any agency thereof, nor any of their employees, makes any warranty, express or implied, or assumes any legal liability or responsibility for the accuracy, completeness, or usefulness of any information, apparatus, product, or process disclosed, or represents that its use would not infringe privately owned rights. Reference herein to any specific commercial product, process, or service by trade name, trademark, manufacturer, or otherwise, does not necessarily constitute or imply its endorsement, recommendation, or favoring by the United States Government or any agency thereof. The views and opinions of authors expressed herein do not necessarily state or reflect those of the United States Government or any agency thereof. 2 ORNL/TM-2025/4160 Neutron Science Directorate Neutron Scattering Division USER GUIDE FOR DATA REDUCTION AT GP-SANS Karin Bichler Lisa DeBeer-Schmitt Lilin He Arina Rostopchina Arturo Diaz January 2026 Prepared by OAK RIDGE NATIONAL LABORATORY Oak Ridge, TN 37831 managed by UT-BATTELLE LLC for the US DEPARTMENT OF ENERGY under contract DE-AC05-00OR22725 This manual is intended as a quick guide for data reduction of GP-SANS data. It includes all necessary steps to do the data reduction based on absolute calibration using the open beam method and how to transfer the reduced data to the personal computer system. If any errors are coming up so that the reduction script is not functioning as intended, please contact the instrument scientist. 1. Download Run Numbers from OnCat On OnCat webpage (oncat.ornl.gov), download .csv table from all the runs of the experiment Login → Browse → at HFIR select CG-2 GP SANS → go into your IPTS number → Runs → Download as CSV (upper right corner) 5 2. Upload OnCat file to Jupyter Notebook Import to: Jupyter.sns.gov into your IPTS shared folder 6 3. User Input in Script From the downloaded OnCat table, several information is taken automatically: - Scattering and Transmission run number - Thickness of the samples - Sample names Adjust the following entries are required: - IPTS-Number (user experiment number) - Cycle - Notebook_name (must match Jupyter notebook name) - Oncat_file (must match name of .cvs table) - Adjust Name of: Empty_Cell and Open_Beam After adjusting the entries, run the first cell. (Please see Step 4: Running First Cell) 7 4. Running First Cell To run the cell, hit the “play” button Running the first cell opens a pop-up field with following information included (as shown below): 1. Sample Title 2. Scattering and Transmission runs at different detector distances a. Scattering and transmission runs are automatically sorted in a descending order, with scattering runs first, followed by transmission runs. 3. Sample Thickness Please see 5.1 Please see 5.2 8 In this step, the user needs to specify the folder for saving the reduced data. This is done by including the folder name into the field “Folder: Folder Name for Data Storage” and clicking on the “Submit” button After specifying the folder for data storage, the directory is set for further data processing. (Please see Step 5: Adjusting the 𝑸-Range for Data Merging (Part I)) 5. Adjusting the 𝑸-Range for Data Merging (Part I) After setting the folder and the directory (Step 4), the selection of the 𝑄 -range for merging the data from different detector settings is next. This involves the adjustment of the different 𝑄 -ranges from the different detector distances. These defined regions are used for merging the data and for defining the stitching ranges, leading to the full 𝑄 -range selected for the experiment. The determined 𝑄-ranges and stitching regions are saved in its own .csv file – 𝑄-values-direct- beam.csv – in the user IPTS folder per default. Those ranges are further used for reducing all samples from the experiment until a new Q-range selection is done. 5.1 Sample selection: For starting this step, you need to select one sample where the 𝑄-ranges and stitching ranges will be adjusted on. Sample selection is done by setting the tick accordingly and click the “Submit” button. This confirms the sample selection. Any sample can be taken for this step. 9 5.2 𝑄 – setting and Q – range adjustment: Before starting the 𝑸-range adjustment, the desired 𝑄 - setting needs to be selected. It can be any configuration between 1 and 3 detector distances as selected by the drop-down menu. Based on the configuration number the 𝑄 ranges need to be ticked. Note: Config. Num. 1: Low 𝑄 or Mid 𝑄 or High 𝑄 (only one tick is possible) Config. Num. 2: Low 𝑄 and Mid 𝑄, or Low 𝑄 and High 𝑄, or Mid 𝑄 and High 𝑄 (only two ticks are possible) Config. Num. 3: Low 𝑄, Mid 𝑄, and High 𝑄 (three ticks are set per default) After selecting the right 𝑄 - setting, click the button “Apply 𝑸 Setting” The next step is to start the 𝑸-range adjustment by clicking the “𝑸-range” button. Please see Step 6: Adjusting the 𝑸-Range for Data Merging (Part II) 10 6. Adjusting the 𝑸-Range for Data Merging (Part II) The data reduction for one specific sample that is used for adjusting the 𝑄-range is running and stops once each single 𝑄-range is reduced. At this time, you have the option to adjust/change the 𝑄- and stitching ranges for further data reduction. That option is provided with the buttons “removing or adding points” for each 𝑄- range. Changes are applied and visible immediately leading to cleaned 𝑄-ranges. Once satisfied with the adjusted 𝑄- and stitching ranges, click the “Continue” button. This starts the further data reduction including merging the 𝑄-ranges together. This step is only required once and provides the 𝑄- and stitching ranges for all the other samples. Next step is reducing the actual samples from the experiment. Please see Step 7: Sample Reduction 11 7. Sample Reduction Starting the sample reduction requires to go back to Step 4 (skipping Step 5 and Step 6) and set the directory for saving the reduced sample data and click “Submit”. As a next step you can either select specific samples by selecting them followed by clicking “Submit” or you can click “Select All” which takes every sample in the list for data reduction. Independently on the sample selection, the next step is clicking the “Apply 𝑸 Setting” button again followed by clicking the button “Reduce” This starts the data reduction for the selected samples