DATMERGE manual

datmerge

Post all your questions about DATMERGE to the ATSAS Forum.

Manual
Example

Manual

The following sections shortly describe how to run DATMERGE from the command-line on any of the supported platforms, the required input and the produced output files.

Introduction

DATMERGE may be used to merge two and more data files with scaling of scattering vectors if necessary. The main application of DATMERGE is merging SAXS and WAXS data sets.

Running datmerge

Usage:

$ datmerge <FILE> <FILE> [FILE(S)] [-f] [-o FILE]

OPTIONS known by DATMERGE are described in next section, the required FILE arguments in the section on input files.

Command-line arguments and options

DATMERGE requires the following command line arguments:

Argument	Description
`FILE`	Data file in any of the supported formats
`FILE(S)`	Additional data files in any of the supported formats

Absolute as well as relative paths to data files are accepted. Up to one of the input files may also be given as '-', in this case input is read from stdin instead of a file.

DATMERGE recognizes following command-line options:

Short option	Long option	Description
`-f`	`--factors`	prints scaling factors to stdout if specified, requires an output file name.
`-o`	`--output=<FILE>`	Specify a `FILE` where to write the merged data to, the `FILE` may contain relative or absolute path components. By default the result is written to stdout.
`-v`	`--version`	Print version information and exit.
`-h`	`--help`	Print a summary of arguments and options and exit.

datmerge input files

Input files for DATMERGE may be in any of the supported data formats as long as scattering vector, experimental intensity and errors are available.

datmerge output files

The produced output file contains merged data from the given data sets and scaling coefficients for each parent file.

Example

$ datmerge data_001.dat data_002.dat -o output.dat -f
1.0000000000000000      data_001.dat
1.5666391739917378      data_002.dat