GENERAL COMMANDS

Up to Menu

Commands must be edited in an input file, by using free format. Commands are case insensitive and comments can be added starting with "!". An example of input file is given here. Other examples of input files are given as demo material. The commands listed in this page are not specific of a given analysis. They are:

whichanalysis

datatype

skiplines

file

range

preprocess

interpolate

waveshift

sgfilter

peakalign

verbose

backscale

savefig

figpaper

shiftfactor

startfromone

offsetvar

skipdata

standardrx

ignoresigma

nophase

varbin

writehkl

writefiles

corrtype

wgen

 

 

whichanalysis

Defines which type of analysis has to be performed.

datatype

Defines the type of input data.

skiplines

Number of lines to skip from the beginning of each input file. No line is skipped in default.

 

file

Defines the file containing a single input profile or the whole data matrix. The name of the file, with its path, has to be specified after the command: file <file path>/<file name>.

Example:

file /home/rocco/prot/compmod/alpha/paper/PADv3/0.dat

 

range

Defines the range of the independent variable for the input profile. More ranges, separated by each other, can be defined. In case of single-crystal X-ray diffraction patterns (datatype 8), three range intervals can be defined, referring to the Miller indices. This command cannot be used if a data matrix is given in input (datatype 6).

Examples:

range 10 60   

the 2θ range from 10° to 60° is selected for an X-ray powder diffraction pattern

 

range 10 40 50 60   

two 2θ ranges are selected for an X-ray powder diffraction pattern: the first from 10° to 40°, the second from 50° to 60°.

 

 

preprocess

Defines the type of pre-processing for input profiles. Four values should follow the command, each corresponding to one level of pre-processing. Less than four values can be given, provided the subsequent missed values are all zero. Level 1,2,3 operate on individual profiles taken one after the other, level 4 operates on the whole set of profiles at the same time.

Level 1: Modification. Defines operations on each input profile that modify its information content. If y is the original profile, the modified profile is y'=f(y).

Level 2: Rescaling. Rescaled profiles are produced by using linear operations of the type y'=A(y'-B) , where y' is the profile obtained after level 1 pre-processing.

Level 3: Background subtraction. An estimate of the background b is made by means of the SNIP algorithm. New profiles are calculated as y'''=y''-b, where y'' are the profiles obtained after level 2 pre-processing.

Level 4: Filtering, operating at the same time on the whole set of profiles.

Examples:

preprocessing 0 3   

A standard normal variate rescaling is performed.

 

preprocessing 0 1 30   

Mean centering rescaling is performed, followed by a background subtraction with Nclip parameter equal to 30.

interpolate

Set the number of sampling points  in case of Level 1, preprocessing 10 or 11. It is defined as a multiplicative factor of the original number of points. The default value is 4.

waveshift

Defines the initial wavelength (in Angstrom) to be used for the wavelength shift (Level 1, preprocessing 11).

Examples:

waveshift 0.1664

2θ profiles measured at λ=0.1664 Å are transformed in 2θ profiles at λ=1.540562 Å

 

waveshift 0

Q profiles are transformed in 2θ profiles at λ=1.540562 Å

 

sgfilter

Sets the parameters for the Savizky-Golay filtering (Level 1, preprocessing 12). It requires three arguments, which specify the order of derivatives, the polynomial degree and the width of the window (number of profile points). Default values are respectively 1, 2 and 5.

Example:

sgfilter 2 5 10   

Savizky-Golay filtering is applied by using second-order derivatives, a polynomial of 5th degree and a window of 10 points.

peakalign

Defines the method used for peak alignment preprocessing (Level 4, preprocessing 5).

verbose

Defines the amount of text output.

 

backscale

Command for implementing background subtraction by using an external background file (for example an empty target measurement). It takes as arguments the scale factors that have to be applied to background before subtraction to each data file. The number of scale factors has be equal to the number of data files loaded through the command file. The background file has to be specified as an additional dummy data file through the command file. It should be the LAST data file!

Example:

file datafile1.dat

file datafile2.dat

file Experimentalbackground.dat

backscale 0.8 0.2

 

The background Experimentalbackground.dat is subtracted to patterns datafile1.dat and datafile2.dat, by using the scale factor 0.8 and 0.2, respectively. The background file is not processed further.

 

savefig

Defines how to store histograms generated run-time.

 

figpaper

 Defines specific histogram layouts.

 

shiftfactor

Defines the shift among profiles in the plot showing all the input profiles together. The shift is defined as the maximum intensity of the profiles multiplied by shiftfactor.

 

startfromone

Defines the way the profiles are numbered in the histograms and output text.

 

offsetvar

Add a number to the variable of each input profile. It does not applies if single-crystal datasets are given in input.

 

skipdata

Allows to skip some data points in each input profiles, to speed up calculations. A number should be specified, representing the number of data points to be skipped after reading a data point from an input profiles. This command is not applied in case of X-ray absorption data (datatype 4), because they are usually taken at a variable step. 

 

standardrx

Defines the way the X-ray powder diffraction profiles are read.

 

ignoresigma

Allow to ignore the last column of the data file, which usually contains error values.

 

nophase

Defines the minimum and maximum values of the independent variable which enclose the peaks to be ignored from a profile (up to 20 values).

Example:

nophase 31 35 54 57

 

2θ values comprised between 31° and 35°, and 54° and 57°  from a X-ray powder diffraction pattern are not considered for further analysis.

 

varbin

Allows to manage profiles having different binning. When performing Quantitative analysis by MultiFit this option allows more precise fits in case of profiles with different binning.

 

writehkl

Transform HKL files (single crystal diffraction patterns) in unidimensional profiles, which are written in output files having the same name of the input file, and extension .prof. This command is executed only if the datatype 3 and whichanalysis > 0 commands are given.

 

writefiles

Each input files, after preprocessing, is written in output as a separate file, with extension .prof added.  This command is executed only if the  whichanalysis 0 command is given.

 

corrtype

Define criteria to compare two profiles in case of correlation analysis (whichanalysis 2 command).

wgen

Include the linear coefficients for profile generation. The command is followed by a series of numbers comprised in the range [0,1]. The numbers following the command should be as many as the number of profiles loaded thorugh the command file.

 

 

EXAMPLE of input file

 

datatype 6

threshold 0.25

sogdiff 0.8

! mean centering pre-processing

preprocess 0 1

! put my cluster definition

clusterswitch 2

file /home/rocco/prot/compmod/alpha/paper/PADv3/0.dat

myclust 0

file /home/rocco/prot/compmod/alpha/paper/PADv3/1.dat

myclust 1

file /home/rocco/prot/compmod/alpha/paper/PADv3/2.dat

myclust 0

file /home/rocco/prot/compmod/alpha/paper/PADv3/3.dat

myclust 1

file /home/rocco/prot/compmod/alpha/paper/PADv3/4.dat

myclust 0

file /home/rocco/prot/compmod/alpha/paper/PADv3/5.dat

myclust 0

 

Up to Menu