---
name: "mcgui"
section: "1"
platform: "linux"
package: "mcstas-mcgui"
version: "3.5+3.5.19+ds5-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mcgui"
---

# mcgui(1)

The mcstas graphical user interface

## NAME

**mcgui** - The mcstas graphical user interface

## SYNOPSIS

**mcgui** \[INSTR\]

## DESCRIPTION

The front-end **mcgui** provides a graphical user interface that interfaces the various parts of the mcstas package. It is started from a shell/command prompt using simply the command mcgui The `mcgui` program may optionally be given the name INSTR of an instrument file. When the front-end is started, a main window is opened. This window displays the output from compiling and running simulations, and also contains a few menus and buttons. The main purpose of the front-end is to edit and compile instrument definitions, run the simulations, and visualize the results.

## OPTIONS

- **INSTR**

  optional name of the instrument to open.

## FILES

/usr/share/mcstas/resources /usr/share/mcstas/tools/Python/mccodelib/mccode\_config.json ~/.mcstas/mccode\_config.json http://www.mcstas.org

## EXAMPLES

- Open the *Test\_SX* example (Single crystal diffraction)

  - •

  `mcgui Test_SX.instr`

## AUTHORS

mcstas Team (mcstas.org)

## SEE ALSO

[mcstas(1)](/mcstas/1.md), [mcdoc(1)](/mcdoc/1.md), [mcplot(1)](/mcplot/1.md), [mcrun(1)](/mcrun/1.md), [mcgui(1)](/mcgui/1.md), [mcdisplay(1)](/mcdisplay/1.md)

## AUTHORS

MCSTAS neutron Ray Tracing Team.