source:
sasview/src/sas/sasgui/perspectives/file_converter/media/file_converter_help.rst
@
f00691d4
| Last change on this file since f00691d4 was 97e90b7, checked in by lewis, 8 years ago | |
|---|---|
|
|
| File size: 2.5 KB | |
File Converter Tool
Description
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:
- Single column ASCII data, with lines that end with a digit (no delimiter), comma or semi-colon.
- One-Dimensional OTOKO formatted data.
- Two-Dimensional BSL formatted data.
Supported output file formats@
Using the Tool
- Select the files containing your Q-Axis and Intensity-Axis data
- Chose whether the files are in ASCII, OTOKO or BSL format
- Chose where you would like to save the converted file
- Optionally, input some metadata such as sample size, detector name, etc
- 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.
