Editing Input syntax manual (section)

=== plot (geometry plot definition)<span id="plot"></span> ===

 '''plot''' ''TYPE'' ''XPIX'' ''YPIX'' [ ''POS'' ''MIN<sub>1</sub>'' ''MAX<sub>1</sub>'' ''MIN<sub>2</sub>'' ''MAX<sub>2</sub>'' ]

 '''plot''' ''TYPE'' ''F<sub>min</sub>'' ''F<sub>max</sub>'' ''E'' ''XPIX'' ''YPIX'' [ ''POS'' ''MIN<sub>1</sub>'' ''MAX<sub>1</sub>'' ''MIN<sub>2</sub>'' ''MAX<sub>2</sub>'' ]

Produces a png-format geometry plot. Input values:

{|
| <tt>''TYPE''</tt> 
| : defines the plot type (orientation and plotting of boundaries)
|-
| <tt>''XPIX''</tt>
| : horizontal image size [in pixels]
|-
| <tt>''YPIX''</tt>
| : vertical image size [in pixels]
|-
| <tt>''POS''</tt>
| : position of plot plane [in cm]
|-
| <tt>''MIN<sub>1</sub>''</tt>
| : minimum horizontal coordinate of plotted region [in cm]
|-
| <tt>''MAX<sub>1</sub>''</tt>
| : maximum horizontal coordinate of plotted region [in cm]
|-
| <tt>''MIN<sub>2</sub>''</tt>
| : minimum vertical coordinate of plotted region [in cm]
|-
| <tt>''MAX<sub>2</sub>''</tt>
| : maximum vertical coordinate of plotted region [in cm]
|-
| <tt>''F<sub>min</sub>''</tt>
| : minimum importance for importance map plots
|-
| <tt>''F<sub>max</sub>''</tt>
| : maximum importance for importance map plots
|-
| <tt>''E''</tt>
| : particle energy for importance map plots [in MeV]
|}

<u>Notes:</u>

*The <tt>''TYPE''</tt> parameter consists of one ('A') or two concatenated values ('AB'): 
**The first value ('A') defines the plot plane (yz-plot = 1, "<tt>x</tt>", xz-plot = 2, "<tt>y</tt>", xy-plot = 3, "<tt>z</tt>"). 
**The second value ('B') defines which boundaries are plotted (0 = no boundaries, 1 = cell boundaries, 2 = material boundaries, 3 = both cell and material boundaries). 
***If the second value ('B') is not provided, default value 2 = material boundaries is used.
*The relative dimensions of image size (<tt>''XPIX''</tt>, <tt>''YPIX''</tt>) should match that of the plotted region. Otherwise the image gets distorted.
*The position parameter <tt>''POS''</tt> defines the location of the plot plane on the axis perpendicular to it (e.g. z-coordinate for xy-type plot).
*The minimum and maximum coordinates: <tt>''MIN<sub>n</sub>''</tt>, <tt>''MAX<sub>n</sub>''</tt>, define the boundaries of the plotted region (e.g. minimum and maximum x- and y-coordinates for xy-type plot). 
** If the coordinates are not provided, the plot is extended to the maximum dimensions of the geometry.

*The second format allows to plot he importance maps read using the [[#wwin|wwin card]]:
**They can be plotted on top of the geometry by setting the second value ('B') of the type parameter for:
*** Cell importances: 4 (linear color scheme) or 5 (logarithmic color scheme)
*** Source importances: 6 (linear color scheme) or 7 (logarithmic color scheme)
**The input parameters include the minimum and maximum importance (<tt>''F<sub>min</sub>''</tt>, <tt>''F<sub>max</sub>''</tt>) and the particle energy, <tt>''E''</tt>. 
***If importance maps are provided for both neutrons and photons, they can be plotted by entering positive and negative energy values, respectively. 
***If both, minimum and maximum importance values are set to "-1", Serpent automatically adjusts them based on the weight-window mesh data, from version 2.2.0 and on.
****If the calculation fails on providing those minimum and maximum values due to the weight-window evaluation, the values are set by default to (1E-200, 1E+200).
**''Note to developers: particle type should be included as an input parameter in importance map plots.''

*Material colors:
**Each material plotted with different color.
**The colors are sampled randomly, unless defined using the '''rgb''' entry in the material card (see [[#mat|mat]]) or mixture card (see [[#mix|mix]])
**Special RGB-colors:

::{|class="wikitable" style="text-align: left;"
! RGB value
! Color
! Description
|-
| (0, 0, 0)
| <span style="color:#000; background:#000">COLOR</span>
| Outside cell or void-material
|-
| (0, 255, 0)
| <span style="color:#00FF00; background:#00FF00">COLOR</span>
| No cell found at coordinates
|-
| (255, 0, 0)
| <span style="color:#FF0000; background:#FF0000">COLOR</span>
| Overlap of multiple cells found at coordinates
|-
| (255, 0, 255)
| <span style="color:#FF00FF; background:#FF00FF">COLOR</span>
| Undefined material density factor at coordinates
|}

*Geometry plotter requires compiling the source code with [[Installing and running Serpent#GD Graphics library|GD Graphics libraries]].
*Command line options:
**[[Installing and running Serpent#Running Serpent|<tt>''-plot''</tt>]] stops the execution after the geometry plots are produced
**[[Installing and running Serpent#Running Serpent|<tt>''-qp''</tt>]] invokes a quick plot mode, which does not check for overlaps
**[[Installing and running Serpent#Running Serpent|<tt>''-noplot''</tt>]] skips the geometry plots altogether
*See also [[Visualizing the results#Geometry plotter|detailed description]] on geometry plotter.
*The geometry plot produced by the ''n''-th plot-card is written in file <tt>[input]_geom[n].png</tt>.