.. _Asec-angel:

ANGEL
==================================================

ANGEL is a computer program for making graphs in the Enhanced PostScript, EPS, format using simple input files.
In brief, ANGEL converts files written in the ANGEL computer language, which consists of the minimum order to construct figures from numerical data, to files in PostScript, a page description language created by Adobe Systems.
ANGEL is included in the PHITS sources, and therefore EPS files can be obtained in addition to ASCII files from PHITS output, but a stand-alone ANGEL code is sometimes required for off-line plotting and further formatting.
The stand-alone ANGEL can be easily compiled using ``make.ang`` in ``/src/`` folder as follows.

.. code-block:: text
   :caption: Example compilation of ANGEL

   make -f make.ang

Please refer to the ANGEL manual for more details.

ANGEL parameters
--------------------------------------------------

In order to add ANGEL parameters in tally output, define as

.. code-block:: text
   :caption: Example of ANGEL parameter definition

   angel = xmin(1.0) ymin(1.3e-8)

Defined parameters are converted to the ANGEL format as

.. code-block:: text
   :caption: Example of ANGEL parameter in tally output

   p: xmin(1.0) ymin(1.3e-8)

These parameters change the minimum of the horizontal and vertical axes, respectively.
The main ANGEL parameters are shown in :numref:`sec-angel`.
Please see the ANGEL manual in more detail for other ANGEL parameters.

.. _sec-angel:

.. list-table:: ANGEL parameters
   :header-rows: 1

   * - ANGEL parameter
     - Explanation
   * - **xmin**
     - Minimum of horizontal axis.
   * - **xmax**
     - Maximum of horizontal axis.
   * - **ymin**
     - Minimum of vertical axis.
   * - **ymax**
     - Maximum of vertical axis.
   * - **xlin**
     - Change horizontal axis to linear scale.
   * - **xlog**
     - Change horizontal axis to logarithmic scale.
   * - **ylin**
     - Change vertical axis to linear scale.
   * - **ylog**
     - Change vertical axis to logarithmic scale.
   * - **xdec**
     - Decimal notation for horizontal axis values.
   * - **xexp**
     - Exponential notation for horizontal axis values.
   * - **ydec**
     - Decimal notation for vertical axis values.
   * - **yexp**
     - Exponential notation for vertical axis values.
   * - **cmin**
     - Minimum of color plot.
   * - **cmax**
     - Maximum of color plot.
   * - **cmnm**
     - Convert cm to nm.
   * - **cmum**
     - Convert cm to um.
   * - **cmmm**
     - Convert cm to mm.
   * - **cmmt**
     - Convert cm to m.
   * - **cmkm**
     - Convert cm to km.
   * - **nsps**
     - Convert nsec to psec.
   * - **nsus**
     - Convert nsec to usec.
   * - **nsms**
     - Convert nsec to msec.
   * - **nssc**
     - Convert nsec to sec.
   * - **scmn**
     - Convert sec to min.
   * - **schr**
     - Convert sec to hour.
   * - **scdy**
     - Convert sec to day.
   * - **scyr**
     - Convert sec to year.
   * - **cmap**
     - Specification of colormap name.
       Example: ``angel = cmap(phits2)``.
       The available colormap names are ``phits2`` and those used in Matplotlib [#angel_matplotlib]_.
       By adding ``_r`` to the colormap name, the color bar can be inverted.
       Example: ``angel = cmap(hot_r)``.
   * - **ndis**
     - Usage of discrete color bars and specification of the number of colors.
       Example: ``angel = ndis(15)``.

.. [#angel_matplotlib] J. D. Hunter, "Matplotlib: A 2D Graphics Environment", Computing in Science \& Engineering, vol. 9, no. 3, pp. 90-95, 2007. Colormap: https://matplotlib.org/stable/users/explain/colors/colormaps.html License: https://matplotlib.org/stable/project/license.html The license is also directly stated in ``a-main1.f``.

Version 2.89 or later changed the default output size from A4 to US letter.
If you wish to change the paper size of an output EPS file, use the ANGEL parameters **a4us** (US letter), **a3pp** (A3), **a4pp** (A4), **a5pp** (A5), **b3pp** (B3), **b4pp** (B4), and **b5pp** (B5).
The characters in parentheses indicate the respective paper size.