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

# mxplot(1)

Plotting the results of a mcxtrace simulation

## NAME

**mxplot** - Plotting the results of a mcxtrace simulation

## SYNOPSIS

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

## DESCRIPTION

The front-end **mxplot** 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 `mxplot`. 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 *mxplot*, e.g. `mxplot dir` or `mxplot file`. It is also possible to plot one single text (not binary) data file from a given monitor, passing its name to `mxplot`. The `-h` option will list valid options.

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

## OPTIONS

- **simulation**

  file or directory to plot

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

- **-t, –test**

  mxcode data loader test run

- **–invcanvas**

  invert canvas background from black to white

## FILES

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

## EXAMPLES

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

  - •

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

- •

  `mxplot output_dir`

## AUTHORS

mcxtrace Team (mcxtrace.org)

## SEE ALSO

[mcxtrace(1)](/mcxtrace/1.md), [mxdoc(1)](/mxdoc/1.md), [mxplot(1)](/mxplot/1.md), [mxrun(1)](/mxrun/1.md), [mxgui(1)](/mxgui/1.md), [mxdisplay(1)](/mxdisplay/1.md)

## AUTHORS

MCXTRACE xray Ray Tracing Team.