Table of Contents
Name | Direction | Type | Default | Description |
---|---|---|---|---|
Workspace | Input | MatrixWorkspace | Mandatory | Name of the input workspace |
ShapeXML | Input | string | Mandatory | The XML definition of the shape |
IncludeMonitors | Input | boolean | False | Whether monitors should be included if they are contained in the shape (default false) |
DetectorList | Output | int list | The list of detector ids included within the shape |
The algorithm places the user-defined geometric shape within the virtual instrument and reports back the detector ID of every detector that is contained within it. Detectors are only considered if their central location point is contained within the shape.
There are a variety of shapes available.
Example - Finding Detectors Using Cylinders
import os
# Load in the MUSR instrument from its IDF file.
inst_def_file = os.path.join(config["instrumentDefinition.directory"], "MUSR_Definition.xml")
musr_inst_ws = LoadEmptyInstrument(inst_def_file)
# Define a cylinder with radius 0.1.
narrow_cylinder = """
<infinite-cylinder id=\"shape\">
<centre x=\"0.0\" y=\"0.0\" z=\"0.0\" />
<axis x=\"0.0\" y=\"0.0\" z=\"1\" />
<radius val=\"0.1\" />
</infinite-cylinder>
<algebra val=\"shape\" />
"""
# Define a wider cylinder with radius 0.2.
wide_cylinder = """
<infinite-cylinder id=\"shape\">
<centre x=\"0.0\" y=\"0.0\" z=\"0.0\" />
<axis x=\"0.0\" y=\"0.0\" z=\"1\" />
<radius val=\"0.2\" />
</infinite-cylinder>
<algebra val=\"shape\" />
"""
no_detectors = FindDetectorsInShape(musr_inst_ws, narrow_cylinder)
all_detectors = FindDetectorsInShape(musr_inst_ws, wide_cylinder)
print("The narrow cylinder contains %i of the detectors." % len(no_detectors))
print("The wide cylinder contains %i of the detectors." % len(all_detectors))
Output:
The narrow cylinder contains 0 of the detectors.
The wide cylinder contains 64 of the detectors.
Categories: Algorithms | Utility\Instrument
C++ source: FindDetectorsInShape.cpp (last modified: 2017-11-16)
C++ header: FindDetectorsInShape.h (last modified: 2017-12-11)