Graphical Output
ROXIE provides graphical output based on the CERN program library HIGZ (High level Interface to Graphics and Zebra) and thus postscript plots are produced without the use of external post-processing packages. A shortcoming of this technique is, however, that all output graphics has to be defined before the ROXIE run is launched.
General plot options
The option "Postscript Plot" in the "Main options" as well as options in the headers of the "Plotting Information 2-D/3-D"-widgets apply to a variety of different field plots. These general options are explained here, whereas the different field plots are documented in the respective chapters to follow.
Main options
| Option | Description |
|---|---|
| Postscript Plots | Use the "Plotting Information 2-D/3-D"-widgets to generate field plots. |
Note that graphs that are defined in the "Objectives"-widget are also printed to the postscript files, provided the "Postscript Plots"-option is switched 'on'.
Plotting information 2-D
| Option | Description |
|---|---|
| Coordinate Axes | Plot coordinate axes. |
| Legend | Plot the Legend. |
| Image Iron at X-Axis | Image mesh-based plots at the $x$-Axis. |
| Image Iron at Y-Axis | Image mesh-based plots at the $y$-Axis. |
| Area Boundary Plot | Plot the boundaries of areas in the .iron-file with bold line. |
| Poly-Marker | Plot markers at every data point in a graph-plot that is defined in the "Objectives"-table. |
| More Plot Options | Extend the plotting table by more options. |
The "Plot Information 2-D"-table has the following columns (including
the additional options with "More Plot Options").
| Variables | Description |
|---|---|
| No | Number of postscript plot. |
| X-Axis | Plot range in +x-direction. |
| Color | 'Y': colour plot, 'N': Black and White. |
| 4quad | 'Y': plot all 4 quadrants, 'N': plot first quadrant only. |
| Fmin | Plot range of field values: min-value in the legend. |
| Fmax | Plot range of field values: max-value in the legend. |
| X-Shift | Shift the plot by this value in $x$-direction. |
| Y-Shift | Shift the plot by this value in $y$-direction. |
| Vmax | Plot only vectors up to this value (modulus). This option is used to cut off unphysical singularities in field matrix calculations. |
| V-scale | Scale the vectors in a field matrix plot. |
| Coll | Not yet documented/available. |
| Time | Not yet documented/available. |
| Field | Select a field to plot. |
- Note that the Vmax value needs to be scaled down by the "V-scale" value: If we want to cut off all arrows larger that 4 T, and we have a "V-scale" value of 2, then the "Vmax" must be set to 2.
The fields and forces which can be displayed are documented in the respective chapters of this documentation.
Plotting information 3-D
As the design optimization processes of accelerator magnets is well established, it is convenient to define the plotting information before a ROXIE run, which thus avoids the launching of an external post-processor.
| Option | Description |
|---|---|
| Plot Imaged at z=0 Plane | Image iron and coil at z=0. |
| Display of Cut-Planes | A 3-D plot is built of plane rectangles or triangles. This option highlights the edges of those elements with a thin, white line. |
| 3-D Min Field in Conductor | See Section 3-D Analytical Field Calculation. |
| 3-D Max Field in Conductor | See Section 3-D Analytical Field Calculation. |
| No Shift of Plot Center | If we use "3-D Transforms" in the "Design Variables"-table, parts of the plot in $-z$-direction might be out of the plot-range. Click this option and adjust the "Z-axis"-entry in the "Plot Information 3-D"-table to overcome the problem. |
| Plot of Coordinate System | Plot 3-D coordinate frame. |
The "Plot Information 3-D"-table has the following columns.
| Variables | Description |
|---|---|
| No | Number of postscript plot. |
| Z-axis | Size of plot in z-direction in mm. |
| Colour | 'Y': colour plot, 'N': Black and White. |
| 360deg | 'Y': plot all 4 quadrants, 'N': plot first quadrant only. (Quadrants are seen in the xy-plane when looking in +z-direction.) |
| View | Choose between different viewpoints. |
| Layer | Choose between 0: all layers, 1: inner layer, and 2: outer layer. |
| Field | Select a field to plot. |
The fields that can be plotted are documented in the respective chapters of this documentation.
- Note that ROXIE assigns the attribute of inner or outer layer by an input in the "Global Information 3-D"-widget called "Number of Blocks in Outer Layer" with integer input $N$. The first $N$ blocks are assigned to the outer layer. This option can only be used with the "Symmetric Coil"-option in the "Main Options". The "Layer Definition"-option generally does not work due to the numbering of all blocks which is incompatible with this division in inner and outer layer.