This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
xray_data:convertfileseries [2019/01/18 13:19] smerkel created |
xray_data:convertfileseries [2019/02/18 10:11] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | Convert! | + | ====== Convert image file series ====== |
| + | |||
| + | |||
| + | ===== Introduction ===== | ||
| + | |||
| + | Typical diamond anvil cell beamlines generate series of diffraction files in various formats, which are not the [[fileformat:edf|EDF]] format used in further processing. The tools here can be used to convert the files into the proper format. | ||
| + | |||
| + | Data collected at step scans have a starting ω position, an end ω position, and a step size δω. Diffraction are collected at each ω and save in files such as ''name-0000.tif'', ''name-0001.tif'', etc. For instance, if you collect data from -2° to +2° with a step size of 1.0°, starting from image 5, with a stem ''mydata'', you will save the following data files | ||
| + | * ''mydata-0005.tif'' for a scan between ω = -2.0° to -1.0° with an average ω of -1.5°, | ||
| + | * ''mydata-0006.tif'' for a scan between ω = -1.0° to -0.0° with an average ω of -0.5°, | ||
| + | * ''mydata-0007.tif'' for a scan between ω = +0.0° to +1.0° with an average ω of -0.5°, | ||
| + | * ''mydata-0008.tif'' for a scan between ω = +1.0° to +2.0° with an average ω of -1.5°. | ||
| + | |||
| + | The scripts ''timelessTiff2edf'' and ''timelessMccd2edf'', which are both part of the [[software:timelesstools|TIMEleSS tools]], are meant to convert such file series into series of EDF files. | ||
| + | |||
| + | Watch out! You can generate vast amount of data! You may want to include such scripts into larger scripts as you develop your data processing strategy. | ||
| + | |||
| + | ===== timelessTiff2edf ===== | ||
| + | |||
| + | <code> | ||
| + | timelessTiff2edf -h | ||
| + | |||
| + | usage: timelessTiff2edf -f from -t to -s step -n stem -i first image [OPTIONS] | ||
| + | |||
| + | Creates a list of EDF files based on a collection of TIFF files This is part | ||
| + | of the TIMEleSS project http://timeless.texture.rocks | ||
| + | |||
| + | optional arguments: | ||
| + | -h, --help show this help message and exit | ||
| + | -f FROM, --from FROM Start for omega scan (in degrees, required) | ||
| + | -t TO, --to TO End for omega scan (in degrees, required) | ||
| + | -s STEP, --step STEP Omega step (in degrees, required) | ||
| + | -n STEM, --stem STEM Stem for images files (required) | ||
| + | -i IMAGEFIRST, --imagefirst IMAGEFIRST | ||
| + | Number of first image file in series (required) | ||
| + | -p TIFFIMAGEPATH, --tiffimagepath TIFFIMAGEPATH | ||
| + | Path to tiff images. Default is ./ | ||
| + | -e EDFIMAGEPATH, --edfimagepath EDFIMAGEPATH | ||
| + | Path in which to save edf images. Default is ./ | ||
| + | -x EXTENSION, --extension EXTENSION | ||
| + | Extension for tiff files. Default is tif | ||
| + | -d NDIGITS, --ndigits NDIGITS | ||
| + | Number of digits for file number. Default is 4 | ||
| + | </code> | ||
| + | |||
| + | |||
| + | ===== timelessMccd2edf ===== | ||
| + | |||
| + | <code> | ||
| + | timelessMccd2edf -h | ||
| + | |||
| + | usage: timelessMccd2edf -f from -t to -s step -n stem -i first image [OPTIONS] | ||
| + | |||
| + | Creates a list of EDF files based on a collection of MarCCD files This is part | ||
| + | of the TIMEleSS project http://timeless.texture.rocks | ||
| + | |||
| + | optional arguments: | ||
| + | -h, --help show this help message and exit | ||
| + | -f FROM, --from FROM Start for omega scan (in degrees, required) | ||
| + | -t TO, --to TO End for omega scan (in degrees, required) | ||
| + | -s STEP, --step STEP Omega step (in degrees, required) | ||
| + | -n STEM, --stem STEM Stem for images file (required) | ||
| + | -i IMAGEFIRST, --imagefirst IMAGEFIRST | ||
| + | Number of first image file in series (required) | ||
| + | -p MCCDIMAGEPATH, --mccdimagepath MCCDIMAGEPATH | ||
| + | Path to MarCCD images. Default is ./ | ||
| + | -e EDFIMAGEPATH, --edfimagepath EDFIMAGEPATH | ||
| + | Path in which to save edf images. Default is ./ | ||
| + | -x EXTENSION, --extension EXTENSION | ||
| + | Extension for MarCCD files. Default is mccd | ||
| + | -d NDIGITS, --ndigits NDIGITS | ||
| + | Number of digits for file number. Default is 4 | ||
| + | </code> | ||