NeutronSQ (Module)
Overview
NeutronSQ
is responsible for taking a set of previously calculated
SQ module and generating a new set of neutron-weighted structure factors. The total neutron-weighted structure factor,
The NeutronSQ
module does not target any configurations itself - the underlying
GR module, referenced by the
SQ module, dictates the source configuration data.
Description
Basic Theory
The NeutronSQ
module calculates the Faber-Ziman partial structure factors weighted by the coherent atomic neutron scattering lengths, such that
where
Depending on the need, Normalisation
keyword.
Weighting
The module depends on the definition of suitable isotopologues for each species of interest in order to determine the correct Isotopologue
keyword. Furthermore, any atom types that undergo fast exchange (e.g. hydrogens attached to oxygen or nitrogen atoms) can be indicated with the Exchangeable
keyword.
With isotopologues and exchangeable atoms provided, matrices of weighting factors between atom types on the same and different molecules can be constructed. The reason to distinguish between intramolecular and intermolecular weightings is perhaps not immediately apparent, but is necessary to correctly calculate weighted
Instrumental Broadening
The application of instrumental broadening is the responsibility of the source
SQ module - see its
QBroadening
keyword.
Options
Targets
Keyword | Arguments | Default | Description |
---|---|---|---|
SourceSQs |
Module |
– | Required Source |
Isotopes & Normalisation
Keyword | Arguments | Default | Description |
---|---|---|---|
Exchangeable |
AtomType … |
– | A list of one or more atom types in the system that are exchangeable with each other |
Isotopologue |
Configuration Species Isotopologue double |
– | Set/add an isotopologue and its population for a particular species. The Isotopologue keyword may be used as many times as is necessary to satisfy the number of species in the system and their blends of isotopologues |
NormaliseTo |
NormalisationType |
None |
Normalisation to apply to the total weighted F(Q). The same normalisation is also applied to supplied reference data following removal (if appropriate) of its own normalisation (see the ReferenceNormalisedTo keyword) |
Reference Data
Keyword | Arguments | Default | Description |
---|---|---|---|
Reference |
Data1DFileAndFormat |
– | Format and filename of reference |
ReferenceFTDeltaR |
double |
0.05 | Spacing in |
ReferenceFTQMax |
double |
– | Maximum Q value to use when Fourier-transforming the reference |
ReferenceFTQMin |
double |
– | Minimum Q value to use when Fourier-transforming the reference |
ReferenceNormalisedTo |
NormalisationType |
None |
Normalisation which has been applied to the reference data |
ReferenceWindowFunction |
WindowFunction |
Lorch0 |
Window function to apply when Fourier-transforming reference |
Export
Keyword | Arguments | Default | Description |
---|---|---|---|
SaveGR |
bool |
false |
Save weighted g(r) and G(r). Separate files are written for each partial between atom types |
SaveReference |
bool |
false |
Save the reference data and its Fourier transform |
SaveRepresentativeGR |
bool |
false |
Save the representative |
SaveSQ |
bool |
false |
Save weighted partial and total structure factors. Separate files are written for each partial between atom types |