View on GitHub

SCT

A suite of tools for atomistic modelling of SAS data

Download this project as a .zip file Download this project as a tar.gz file

sctpl - Calculate Radii of Gyration From Scattering Curves

Useage:

Run using the command:

sctpl

This will produce the following prompts, you should provide the inputs shown in italics. Individual values to input are surrounded by square braces. When multiple values are requires they can either be separated by a space on the same line or entered on separate lines. The meaning of the input values are explained in the Notes section.

Enter data type (model [m] or exptl [x]): [curve type]

Enter title of plot: [title]

Number of curves? [1] [no. curves]

Enter name of file containing data: [input file]

Smearing (y/n)? [smearing]

Type of plot: 0 Ln(IQQ) / QQ: Thickness RG 1 Ln(IQ) / QQ: Cross-sectional RG 2 Ln(I) / QQ: Overall RG; Guinier plot 3 Ln(I) / Q: Wide Angle 4 I / Q 5 IQ*Q / Q: Volume plot

Choose one of the above [3]: [plot type] Which Q range to plot (Q1, Q2; Q1 < Q2) [Q min] [Q max]

Which Q range to fit a line to (Q3, Q4; Q3 < Q4)? [fit min] [fit max]

Choose a plot style: Join the dots, no symbols [0]: Symbols only [1]: Dots and symbols [2]. [plot style]

Take your pick: 1) Get another; 2) Add another; 3) Change axes' ranges; 4) Start again; 5) Manual R-factor; 6) Auto R-factor; 7) Change a given plot's attributes; 8) Save selected plots as ASCII; 9) Screen dump; 10) Redisplay a given plot; 11) Remove a plot; 12) Quit: [menu choice]

Notes:

The original sctpl performed plotting, this is not a current feature but the options remain for compatibility with old scripts. Plotting and fitting can now be performed using sas_curve_analysis.py.

curve type = choose of model [m] or exptl [x] curve

title = title for plot

no. curves = number of curves to analyse

input file = path to input scattering curve (with $I$ and $Q$ columns).

smearing = should the curve be smeared

plot type = choice from 'Type of plot' menu shown above. This defines the radius of gyration type to be out put:

0 radius of gyration ($R_{g}$) 1 cross sectional $R_{g}$ (usually called $R_{xs1}$) 2 thickness $R_{g}$ (usually called $R_{xs2}$)

Q min = minimum Q value for plot

Q max = maximum Q value for plot

fit min = minimum Q value for fit

fit max = maximum Q value for fit

plot style = type of points used in plot

menu choice = choice from 'Take your pick' menu

Output:

sctpl produces a single output file in the current directory called 'Sctpl6_Summary'.

This has the following format:

*input file*,*calc type* ,*title*, *fit Q range*, *fit points*, *result*, *result error*,*I0*, *I0 error*

calc type = + RG = radius of gyration ($R_{g}$) + RXS = cross sectional $R_{g}$ (usually called $R_{xs1}$) + RTH = thickness $R_{g}$ (usually called $R_{xs2}$)

fit Q range = Q min -> Q max

fit points = points on teh input curve that correspond to fit Q range

result = result of the radius of gyration calculation in the units of the inverse of the input Q values

result err = uncertainty in the result from curve fitting

I0 = extrapolated $I_{0}$ value

I0 error = uncertainty in the $I_{0}$ value from curve fitting