3. Usage

3.1 General Usage

Teion-C is a simple console application for calculation of charged particle energy loss and its range in a target matter.

Synopsis

teion -a value -z value -e value -d value -c value [-o file] [-v [file]]

teion [-h] [-V]

Options

Particle options

• -a, --A value Set particle atomic weight
• -z, --Z value Set particle atomic number
• -e, --energy value Set particle energy (Mev)

Target options

• -d, --density value Set target density (g/cm**3)
• -c, --component value Set target atomic component parameters (A,Z,share)

Output options

• -o, --output file Output file with resulting curves (standard output by default).
• -v, --verbose Output processing information (no output by default).

Help options

• -h, --help Display this help and exit.
• -V, --version Display version information and exit.

3.2 GUI (Windows only)

For Windows users the Teion-C offers an user friendly GUI (graphical user interface). Teion's main window, shown in figure above, is implemented in the standard for Windows applications manner with menu-bar, tool-bar and status-bar. All tool-bar items exactly correspond to the command-line options described above. The command-line to be executed is just formed by choosing corresponding tool-bar items and is displayed on the status-bar.

3.3 Example

The simple usage example is:

teion -a 1 -z 1 -e 20 -d 2.7 -c 27,13 -o H2Al.dat -v

It's produces the following message to the standard output:

Projectile particle
*******************
        Z = 1
        A = 1
        E = 20 MeV

Target
******
        Density = 2.7 g/cm^3
        Z = 13
        A = 27
        Ionization potential = 163 eV
        Elect = 0.481481

Energy bounds
*************
        E[0] = 0.00994536 MeV
        E[1] = 0.0250473 MeV
        E[2] = 0.752904 MeV
        E[3] = 939060 MeV

Results
*******
        E - particle energy (MeV)
        R - mean range [cm]
        dE/dx - total energy loss [MeV/cm]
        dE/dx(e) - energy loss in inelastic collisions
        dE/dx(n) - energy loss in elastic collisions or pair production

           E           R       dE/dx    dE/dx(e)    dE/dx(n)
          20    0.211497     53.2996     53.2996           0

The corresponding graphics (stored in file H2Al.dat) are the following: