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

# mcplot-pyqtgraph(1)

Plotting the results of a mcstas simulation

## NAME

**mcplot** - Plotting the results of a mcstas simulation

## SYNOPSIS

**mcplot** \[-h\] \[-t\] \[–invcanvas\] \[simulation ...\]

## DESCRIPTION

The front-end **mcplot** is a program that produces plots of all the monitors in a simulation, and it is thus useful to get a quick overview of the simulation results. In the simplest case, the front-end is run simply by typing `mcplot`. This will plot any simulation data stored in the current directory, which is where simulations store their results by default. If the –dir or –file options have been used (see section 5.2), the name of the file or directory should be passed to *mcplot*, e.g. `mcplot dir` or `mcplot file`. It is also possible to plot one single text (not binary) data file from a given monitor, passing its name to `mcplot`. The `-h` option will list valid options.

The default plotting backend is `mcplot-pyqtgraph`, but there exists a number of additional plotters such as `mcplot-matplotlib`, `mcplot-html` (in a browser), `mcplot-matlab` (using Matlab or Octave).

## OPTIONS

- **simulation**

  file or directory to plot

options: **-h, –help** : show this help message and exit

- **-t, –test**

  mccode data loader test run

- **–invcanvas**

  invert canvas background from black to white

## FILES

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

## EXAMPLES

- Run and plot the *Test\_SX* example (Single crystal diffraction)

  - •

  `mcrun Test_SX.instr -d output_dir -n 1e7 TTH=13.4`

- •

  `mcplot output_dir`

## 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.