Home > Objects > iData_subclasses > @iData_Sqw2D > dynamic_range.m

iFit/dynamic_range

PURPOSE ^

iData_Sqw2D: dynamic_range: crop the S(|q|,w) to the available dynamic range

SYNOPSIS ^

function [s, sphi] = dynamic_range(s, varargin)

DESCRIPTION ^

 iData_Sqw2D: dynamic_range: crop the S(|q|,w) to the available dynamic range
   for given incident neutron energy.

 The dynamic range is defined from the momentum and energy conservation laws:
  Ef         = Ei - w                                is positive
  cos(theta) = (Ki.^2 + Kf.^2 - q.^2) ./ (2*Ki.*Kf)  is within [-1:1]

 The incident neutron energy can be computed using:
  Ei = 2.0721*Ki^2 = 81.8042/lambda^2 with Ki in [Angs-1] and lambda in [Angs]

 conventions:
 omega = Ei-Ef = energy lost by the neutron
    omega > 0, neutron looses energy, can not be higher than p.ei (Stokes)
    omega < 0, neutron gains energy, anti-Stokes

 The scattering angle phi can be restricted to match a detection area
 with the syntax:
   sqw_Ei=dynamic_range(s, Ei, [angles])

 The syntax:
   [sqw_Ei, sphiw] = dynamic_range(s,...)
 also returns the S(phi,w) data set, which shows the detected signal vs scattering 
   angle and energy transfer.

  Input arguments can be given in order, or with name-value pairs, or as a 
    structure with named fields. In addition to Ei, one can specify 'lambda' or 'Ki'
  e.g.:
   sqw_Ei=dynamic_range(s, 'lambda', 2.36);
   sqw_Ei=dynamic_range(s, 'Ki', 2.665);

 syntax:
   sqw_Ei        =dynamic_range(s, Ei)
   [sqw_Ei,sphiw]=dynamic_range(s, Ei)
   [sqw_Ei,sphiw]=dynamic_range(s, Ei, [min_angle max_angle])
   [sqw_Ei,sphiw]=dynamic_range(s, 'Ei', Ei, 'angles', [min_angle max_angle])
   [sqw_Ei,sphiw]=dynamic_range(s, 'lambda', lambda)

 input:
   s:      Sqw data set, e.g. 2D data set with w as 1st axis (rows, meV), q as 2nd axis (Angs-1).
   Ei:     incoming neutron energy [meV]
   angles: scattering detection range in [deg] as a vector. Min and Max values are used.
   'lambda','Ki': additional named arguments to specify the incident energy
 output:
   sqw_Ei: S(q,w)   cropped to dynamic range for incident energy Ei.
   sphiw:  S(phi,w) angular dynamic structure factor for incident energy Ei.

 Example: s=iData_Sqw2D('SQW_coh_lGe.nc'); dynamic_range(s, 14.8, [-20 135])

 See also: iData_Sqw2D/Bosify, iData_Sqw2D/deBosify, iData_Sqw2D/symmetrize, iData_Sqw2D/scattering_cross_section
 (c) E.Farhi, ILL. License: EUPL.

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:
Generated on Tue 27-Nov-2018 10:56:24 by m2html © 2005. iFit (c) E.Farhi/ILL EUPL 1.1