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}\).