The following sections describe the method implemented in SHANUM, how to run
SHANUM on the supported platforms and the required input and the generated
output files.

If you use results from SHANUM in your publication, please cite:

The program SHANUM employs Shannon sampling
formalism to demonstrate that the useful experimental data range is
defined by the number of meaningful Shannon channels that can be determined
from the data set. The algorithm to determine this number and thus the data
range is implemented in the program SHANUM and tested on a number of simulated data
sets with various noise levels and with different degree of oversampling,
corresponding to typical SAXS/SANS experiments. The method can be also applied
to analyse experimental solution scattering data recorded in various conditions.

The program SHANUM can be started in the batch mode when arguments are
given:

$ shanum DATAFILE <Dmax> [OPTIONS]

SHANUM accepts the following command line arguments:

Argument

Description

DATAFILE

A relative or absolute path to a data file that should contain
s-vector and intensity columns (obligatory) and errors of intensities
(optional)

<DMAX>

Dmax (the value of the maximum particle size) can be provided by the user
in the command line after the DATAFILE (optionally), if it is not provided
SHANUM will estimate it automatically using Autorg and AutoGNOM.

SHANUM recognizes the following command-line options.

SHANUM always displays Dmax, Smax, Nsh, Nopt and Smax values on the screen.
SHANUM outputs the best Shannon fit and the target function f(M) if
'-f' prefix has been used.
SHANUM stores all Shannon fits and the restored p(r) functions
together with the target function f(M) if '-d' prefix was used.

Run SHANUM on the input data file 'datfile.dat' using default
values for all parameters. Dmax value will be automatically estimated
by autorg and autognom.

$ shanum datfile.dat

Run SHANUM on the input data file 'datfile.dat' defining the
maximum size of the particle Dmax (it should be in the same units
as the angular axis).

$ shanum datfile.dat 30

Run SHANUM on the input data file 'datfile.dat' using default
values for all parameters. Dmax value will be automatically estimated
by autorg and autognom. The best Shannon fit and the target function will
be saved.

$ shanum datfile.dat -f

Run SHANUM on the input data file 'datfile.dat' using default
values for all parameters. Dmax value will be automatically estimated
by autorg and autognom. All Shannon fits and restored p(r) functions as wella
as the target function will be saved.