source: sasview/src/sas/sasgui/perspectives/file_converter/media/file_converter_help.rst @ 97e90b7

Last change on this file since 97e90b7 was 97e90b7, checked in by lewis, 5 years ago

Add links to output formats in file_converter docs

  • Property mode set to 100644
File size: 2.5 KB

File Converter Tool


This tool converts file formats with the Q data and intensity data in separate files, into a single CanSAS XML or NXcanSAS HDF5 file.

It can also convert 2D BSL files into NXcanSAS HDF5 files.

Supported input file formats:

Supported output file formats@

Using the Tool

  1. Select the files containing your Q-Axis and Intensity-Axis data
  2. Chose whether the files are in ASCII, OTOKO or BSL format
  3. Chose where you would like to save the converted file
  4. Optionally, input some metadata such as sample size, detector name, etc
  5. Click Convert to save the converted file to disk

Files With Multiple Frames

If a BSL/OTOKO file with multiple frames is selected for the intensity-axis file, a dialog will appear asking which frames you would like converted. You may enter a start frame, end frame & increment, and all frames in that subset will be converted. For example: entering 0, 50 and 10 for the first frame, last frame, and increment respectively will convert frames 0, 10, 20, 30, 40 & 50. To convert a single frame, enter the same value for first frame & last frame, and 1 as the increment.

CanSAS XML files can become quite large when exporting multiple frames to a single file, so there is an option in the Select Frame dialog to output each frame to it's own file. The single file option will produce one file with multiple <SASdata> elements. The multiple file option will output a file for each frame; each file will have one <SASdata> element, and the frame number will appended to the file name.

The multiple file option is not available when exporting to NXcanSAS. All frames will be written to the same file, since the HDF5 format is designed for handling large amounts of data.

Note: See TracBrowser for help on using the repository browser.