[11794f2] | 1 | .. file_converter_help.rst |
---|
| 2 | |
---|
[da456fb] | 3 | .. _File_Converter_Tool: |
---|
| 4 | |
---|
[11794f2] | 5 | File Converter Tool |
---|
| 6 | =================== |
---|
| 7 | |
---|
| 8 | Description |
---|
| 9 | ----------- |
---|
| 10 | |
---|
| 11 | This tool converts file formats with the Q data and intensity data in separate |
---|
[d3e1870] | 12 | files, into a single CanSAS XML or NXcanSAS HDF5 file. |
---|
[11794f2] | 13 | |
---|
[d3e1870] | 14 | It can also convert 2D BSL files into NXcanSAS HDF5 files. |
---|
[ebc1407] | 15 | |
---|
[97e90b7] | 16 | Supported input file formats: |
---|
[11794f2] | 17 | |
---|
[94f4518] | 18 | * Single column ASCII data, with lines that end with a digit (no delimiter), |
---|
| 19 | comma or semi-colon. |
---|
[ebc1407] | 20 | * `One-Dimensional OTOKO formatted |
---|
| 21 | <http://www.diamond.ac.uk/Beamlines/Soft-Condensed-Matter/small-angle/ |
---|
[97e90b7] | 22 | SAXS-Software/CCP13/XOTOKO.html>`_ data. |
---|
[ebc1407] | 23 | * `Two-Dimensional BSL formatted |
---|
[11794f2] | 24 | <http://www.diamond.ac.uk/Beamlines/Soft-Condensed-Matter/small-angle/ |
---|
[97e90b7] | 25 | SAXS-Software/CCP13/BSL.html>`_ data. |
---|
| 26 | |
---|
| 27 | Supported output file formats@ |
---|
| 28 | |
---|
| 29 | * `CanSAS XML <http://www.cansas.org/formats/canSAS1d/1.1/doc/>`_ |
---|
| 30 | * `NXcanSAS HDF5 <http://download.nexusformat.org/sphinx/classes/contributed_definitions/NXcanSAS.html>`_ |
---|
[11794f2] | 31 | |
---|
| 32 | .. ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ |
---|
| 33 | |
---|
| 34 | Using the Tool |
---|
| 35 | -------------- |
---|
| 36 | |
---|
[eb8da5f] | 37 | 1) Select the files containing your Q-Axis and Intensity-Axis data |
---|
[ebc1407] | 38 | 2) Chose whether the files are in ASCII, OTOKO or BSL format |
---|
| 39 | 3) Chose where you would like to save the converted file |
---|
[11794f2] | 40 | 4) Optionally, input some metadata such as sample size, detector name, etc |
---|
| 41 | 5) Click *Convert* to save the converted file to disk |
---|
[eb8da5f] | 42 | |
---|
[94f4518] | 43 | Files With Multiple Frames |
---|
| 44 | ^^^^^^^^^^^^^^^^^^^^^^^^^^ |
---|
| 45 | |
---|
| 46 | If a BSL/OTOKO file with multiple frames is selected for the intensity-axis |
---|
| 47 | file, a dialog will appear asking which frames you would like converted. You |
---|
| 48 | may enter a start frame, end frame & increment, and all frames in that subset |
---|
| 49 | will be converted. For example: entering 0, 50 and 10 for the first frame, last |
---|
| 50 | frame, and increment respectively will convert frames 0, 10, 20, 30, 40 & 50. |
---|
| 51 | To convert a single frame, enter the same value for first frame & last frame, |
---|
| 52 | and 1 as the increment. |
---|
| 53 | |
---|
[d3e1870] | 54 | CanSAS XML files can become quite large when exporting multiple frames to a |
---|
| 55 | single file, so there is an option in the *Select Frame* dialog to output each |
---|
| 56 | frame to it's own file. The single file option will produce one file with |
---|
| 57 | multiple `<SASdata>` elements. The multiple file option will output a file for |
---|
| 58 | each frame; each file will have one `<SASdata>` element, and the frame number |
---|
| 59 | will appended to the file name. |
---|
[ebc1407] | 60 | |
---|
[d3e1870] | 61 | The multiple file option is not available when exporting to NXcanSAS. All |
---|
| 62 | frames will be written to the same file, since the HDF5 format is designed for |
---|
| 63 | handling large amounts of data. |
---|