# The `Test_mcdisplay_shapes` Instrument

*McStas: Test instrument showing all mcdisplay drawing primitives*

## Identification

- **Site:** Tests_other
- **Author:** Peter Willendrup
- **Origin:** DTU
- **Date:** 20261020

## Description

```text
Places display-only components that together use every mcdisplay
primitive, to check the mcdisplay tools at --trace=1 and --trace=2:
- cone (Arm, Cone)
- polygon (Guide), drawn as a polyhedron at --trace=2
- box, hollow box, box tilted along (nx, ny, nz) and tilted hollow box (Shape)
- cylinder, hollow cylinder, cylinder along z and hollow cylinder along z (Shape)
- sphere (Shape)
- polyhedron from an OFF file (Shape)
- disc, annulus and circle (Disc, Annulus, Circle)

The shapes sit beside the beam, so only the Guide affects the neutrons.

Example: mcdisplay-webgl-classic Test_mcdisplay_shapes.instr --trace=2 -n 20
```

## Examples

- **Test: -n1e5 Detector: Mon_I=0.0141**

## Input parameters

Parameters in **boldface** are required; the others are optional.

| Name | Unit | Description | Default |
|------|------|-------------|---------|
| offfile | str | OFF file for the polyhedron Shape | "socket.off" |

## Links

- [Source code](Test_mcdisplay_shapes.instr) for `Test_mcdisplay_shapes.instr`.

---