Manual

The following sections briefly describe how to run DATCROP from the command-line, the required input and the produced output files.

Introduction

DATCROP is a tool for removing data points from the beginning and/or the end of the scattering curve. Primarily it is used for removing noisy data close to the beamstop and excess data at high angles.

Running datcrop

Usage:

$ datcrop <SASDATA> [OPTIONS]

OPTIONS known by DATCROP are described in next section, the required argument SASDATA, in the section on input files.

Command-Line Arguments and Options

DATCROP requires the following command line arguments:

Argument	Description
SASDATA	Exactly one experimental SAS data (.dat) file.

Absolute as well as relative path to data files are accepted. Instead of a file name, the argument may be given as ‘-‘ to read data from stdin.

DATCROP recognizes following command-line options:

Short option	Long option	Description
	--first <N>	Index of the first point to be kept. This is mutually exclusive with smin.
	--last <N>	Index of the last point to be kept. This is mutually exclusive with smax.
	--smin <S>	Minimal_s_value to be kept. This is mutually exclusive with first.
	--smax <S>	Maximal_s_value to be kept. This is mutually exclusive with last.
-o	--output SASDATA	Relative or absolute path to save the result; if not specified, the result is printed to stdout.
-v	--version	Print version information and exit.
-h	--help	Print a summary of arguments, options, and exit.

datcrop input files

DATCROP expects experimental SAS data (.dat).

datcrop output files

DATCROP writes the same experimental SAS data (.dat), but reduced to the selected data range.

Examples

$ autorg bsa.dat -f table
File              Rg  stdev  I(0)    stdev  Guinier points   Quality
bsa.dat           3.12   1%  65.1       0%   30-122 ( 93)    88%

$ datcrop bsa.dat --first 29 --smax 2.5 -o bsa_cropped.dat

Here we start with the first point of the Guinier region and keep angles only up to \(2.5 \text{nm} ^{-1}\).