[ Identification | Description | Input parameters | Output parameters | Links ]

# The `TOFRes_sample` Component

Sample for TOF resolution function calculation.

## Identification

- Author: KL, 10 October 2004
- Origin: Risoe
- Date: 1999
- Version: 1.2

## Description

    An inelastic sample with completely uniform scattering in both solid angle
    and energy. This sample is used together with the TOFRes_monitor component
    and (optionally) the mcresplot front-end to compute the resolution
    function of all time-of-flight instruments.
    The method of time focusing is used to optimize the simulations.

    The shape of the sample is either a hollow cylinder or a rectangular box. The
    hollow cylinder shape is specified with an inner and outer radius.
    The box is specified with dimensions xwidth, yheight, zthick.

    The scattered neutrons will have directions towards a given target and
    energies between E0-dE and E0+dE, where E0 is calculated from the position
    and width of the time bin.
    This target area is default disk shaped, but may also be rectangular
    if specified focus_xw and focus_yh
    or focus_aw and focus_ah, respectively in meters and degrees.
    The target itself is either situated according to given coordinates (x,y,z),
    or setting the relative target_index of the component to focus at
    (next is +1). This target position will be set to its AT position.
    When targeting to centered components, such as spheres or cylinders,
    define an Arm component where to focus at.

    Example: TOFRes_sample(radius_i=0.001, radius_o=0.01, h=0.04,
          focus_xw=0.025, focus_yh=0.025,
        E0=14.6,dE=2, target_x=0, target_y=0, target_z=1)

## Input parameters

Parameters in boldface are required; the others are optional.

Name | Unit | Description | Default
--- | --- | --- | ---
radius_i | m | Inner radius of hollow cylinder in (x,z) plane, or width of box along X | 0
radius_o | m | Outer radius of hollow cylinder | 0.01
h | m | Height of box or cylinder along Y | 0.05
focus_r | m | Radius of sphere containing target. | 0.05
time_bin | us | position of time bin | 20000
time_width | us | width of time bin | 10
target_x | - |  | 0
target_y | m | position of target to focus at | 0
target_z | - |  | .5
focus_xw | m | horiz. dimension of a rectangular area | 0
focus_yh | m | vert. dimension of a rectangular area | 0
focus_aw | deg | horiz. angular dimension of a rectangular area | 0
focus_ah | deg | vert. angular dimension of a rectangular area | 0
xwidth | m | horiz. dimension of sample, as a width | 0
yheight | m | vert. dimension of sample, as a height | 0
zthick | m | thickness of sample | 0
target_index | 1 | relative index of component to focus at, e.g. next is +1 | 0

## Output parameters

Name | Unit | Description | Default
--- | --- | --- | ---
res_struct |  |  |

## Links

- Source code for `TOFRes_sample.comp`.

[ Identification | Description | Input parameters | Output parameters | Links ]