3D diagnostics (XGC1)
---------------------

.. No-Break Space
.. |nbsp| unicode:: 0xA0 
   :trim:

.. raw:: html

    <style> .red {color:red} </style>
      
.. role:: red

.. raw:: html

    <style> .smallbluegray {font-size:60%;color:rgb(102, 153, 204)} </style>
      
.. role:: smallbluegray

.. New line 
.. |br| raw:: html

  <br/>

XGC1 3D output files xgc.3d.#####.bp and xgc.f3d.#####.bp where ##### is the time step.

.. centered:: **xgc.3d.#####.bp** |br| :smallbluegray:`Printed when: diag_3d_on=.true..` |nbsp| |nbsp| |nbsp| :smallbluegray:`Output frequency: diag_3d_period.`

.. list-table::
   :widths: 25 25 10 100
   :header-rows: 1

   * - *Output*
     - Dimension
     - Units
     - Description
   * - *aparh*
     - | :math:`N_{\mathrm{planes}} \times`
       | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Perturbed 
   * - *apars*
     - | :math:`N_{\mathrm{planes}} \times`
       | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Perturbed 
   * - *dpot*
     - | :math:`N_{\mathrm{planes}} \times`
       | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math:`\mathrm{V}`
     - Perturbed potential in volt.
   * - | *e_marker_den*
       | *i_marker_den*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math:`\mathrm{\#~marker~particles}`
     - Electron/Ion marker density at each mesh node interpolated from surrounding marker particles.
   * - | *e_mean_weight*
       | *i_mean_weight*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math:`\frac{\mathrm{\#~real~particles}}{\mathrm{\#~marker~particles}}`
     - Electron/Ion mean weight :math:`\overline{w} = \frac{1}{N_p} {\sum}_{k = 1}^{N_p} w_{1,k} \, w_{0,k}` at each mesh node interpolated from surrounding marker particles.
   * - | *e_weight_variance*
       | *i_weight_variance*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math:`\frac{(\mathrm{\#~real~particles})^2}{\mathrm{\#~marker~particles}}`
     - Electron/Ion weight variance :math:`\sigma^2 = \frac{1}{N_p} {\sum}_{k = 1}^{N_p} (w_{1,k} \, w_{0,k} - \overline{w})^2` at each mesh node interpolated from surrounding marker particles.
   * - | *eden*
       | *iden*
     - | :math:`N_{\mathrm{planes}} \times`
       | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math:`{\mathrm{m}}^{-3}`
     - Electron/Ion density at each mesh node interpolated from surrounding marker particles.
   * - | *ejpar*
       | *ijpar*
     - | :math:`N_{\mathrm{planes}} \times`
       | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *epara*
       | *ipara*
     - | :math:`N_{\mathrm{planes}} \times`
       | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math"`\mathrm{V/m}`
     - Parallel (to the magnetic field) electric field in Volt per meter
   * - | *epara2*
       | *ipara2*
     - | :math:`N_{\mathrm{planes}} \times`
       | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math:`\mathrm{V/m}`
     - Parallel electric field for evaluating :math:`\partial A_s/\partial t = -\mathbf{b}\cdot\nabla\phi`
   * - *epsi*
     - | :math:`N_{\mathrm{planes}} \times`
       | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math"`\mathrm{V/m}`
     - Radial electric field in Volt per meter
   * - *etheta*
     - | :math:`N_{\mathrm{planes}} \times`
       | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math"`\mathrm{V/m}`
     - Poloidal electric field in Volt per meter
   * - *dBpsi*
     - | :math:`N_{mathrm{planes}} \times`
       | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math:`\mathrm{T}`
     - Radial magnetic field perturbation in Tesla
   * - *dBtheta*
     - | :math:`N_{mathrm{planes}} \times`
       | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math:`\mathrm{T}`
     - Poloidal magnetic field perturbation in Tesla
   * - *dBphi*
     - | :math:`N_{mathrm{planes}} \times`
       | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math:`\mathrm{T}`
     - Toroidal magnetic field perturbation in Tesla
   * - *iphi*
     - Scalar
     - Units
     - Description
   * - *nnode*
     - Scalar
     - Positive integer
     - Number of 3D mesh nodes.
   * - *nphi*
     - Scalar
     - Positive integer
     - Number of poloidal planes :math:`N_{\mathrm{planes}}`.
   * - *pot0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math:`\mathrm{V}`
     - Description
   * - *potm0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - :math:`\mathrm{V}`
     - Description
   * - *time*
     - Scalar
     - :math:`\mathrm{s}`
     - Simulation time of step in seconds.

|br|

.. centered:: **xgc.f3d.#####.bp** |br| :smallbluegray:`Printed when: ?` |nbsp| |nbsp| |nbsp| :smallbluegray:`Output frequency: diag_f3d_period.`

.. list-table::
   :widths: 25 25 10 100
   :header-rows: 1

   * - *Output*
     - Dimension
     - Units
     - Description
   * - *dpot*
     - | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
       | :math:`\times N_{\mathrm{planes}}`
     - :math:`\mathrm{V}`
     - Perturbed potential in volt.
   * - | *e_ExB_enflux_en*
       | *i_ExB_enflux_en*
     - Dimension
     - Units
     - Description
   * - | *e_ExB_flux_en*
       | *i_ExB_flux_en*
     - Dimension
     - Units
     - Description
   * - | *e_T_para*
       | *i_T_para*
     - Dimension
     - Units
     - Description
   * - | *e_T_perp*
       | *i_T_perp*
     - Dimension
     - Units
     - Description
   * - | *e_den*
       | *i_den*
     - Dimension
     - Units
     - Description
   * - | *e_den_en*
       | *i_den_en*
     - Dimension
     - Units
     - Description
   * - | *e_energy_en*
       | *i_energy_en*
     - Dimension
     - Units
     - Description
   * - | *e_parallel_flow_n0_df*
       | *i_parallel_flow_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_parallel_flow_n0_f0*
       | *i_parallel_flow_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_parallel_flow_turb_df*
       | *i_parallel_flow_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_parallel_flow_turb_f0*
       | *i_parallel_flow_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_poloidal_flow_n0_df*
       | *i_poloidal_flow_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_poloidal_flow_n0_f0*
       | *i_poloidal_flow_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_poloidal_flow_turb_df*
       | *i_poloidal_flow_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_poloidal_flow_turb_f0*
       | *i_poloidal_flow_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_rad_mom_flux_3db_n0_df*
       | *i_rad_mom_flux_3db_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_rad_mom_flux_3db_n0_f0*
       | *i_rad_mom_flux_3db_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_rad_mom_flux_3db_turb_df*
       | *i_rad_mom_flux_3db_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_rad_mom_flux_3db_turb_f0*
       | *i_rad_mom_flux_3db_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_rad_mom_flux_ExB_n0_df*
       | *i_rad_mom_flux_ExB_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_rad_mom_flux_ExB_n0_f0*
       | *i_rad_mom_flux_ExB_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_rad_mom_flux_ExB_turb_df*
       | *i_rad_mom_flux_ExB_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_rad_mom_flux_ExB_turb_f0*
       | *i_rad_mom_flux_ExB_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_rad_mom_flux_mag_n0_df*
       | *i_rad_mom_flux_mag_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_rad_mom_flux_mag_n0_f0*
       | *i_rad_mom_flux_mag_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_rad_mom_flux_mag_turb_df*
       | *i_rad_mom_flux_mag_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_rad_mom_flux_mag_turb_f0*
       | *i_rad_mom_flux_mag_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_en_flux_3db_n0_df*
       | *i_radial_en_flux_3db_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_en_flux_3db_n0_f0*
       | *i_radial_en_flux_3db_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_en_flux_3db_turb_df*
       | *i_radial_en_flux_3db_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_en_flux_3db_turb_f0*
       | *i_radial_en_flux_3db_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_en_flux_ExB_n0_df*
       | *i_radial_en_flux_ExB_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_en_flux_ExB_n0_f0*
       | *i_radial_en_flux_ExB_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_en_flux_ExB_turb_df*
       | *i_radial_en_flux_ExB_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_en_flux_ExB_turb_f0*
       | *i_radial_en_flux_ExB_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_en_flux_mag_n0_df*
       | *i_radial_en_flux_mag_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_en_flux_mag_n0_f0*
       | *i_radial_en_flux_mag_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_en_flux_mag_turb_df*
       | *i_radial_en_flux_mag_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_en_flux_mag_turb_f0*
       | *i_radial_en_flux_mag_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_flux_3db_n0_df*
       | *i_radial_flux_3db_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_flux_3db_n0_f0*
       | *i_radial_flux_3db_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_flux_3db_turb_df*
       | *i_radial_flux_3db_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_flux_3db_turb_f0*
       | *i_radial_flux_3db_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_flux_ExB_n0_df*
       | *i_radial_flux_ExB_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_flux_ExB_n0_f0*
       | *i_radial_flux_ExB_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_flux_ExB_turb_df*
       | *i_radial_flux_ExB_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_flux_ExB_turb_f0*
       | *i_radial_flux_ExB_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_flux_mag_n0_df*
       | *i_radial_flux_mag_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_flux_mag_n0_f0*
       | *i_radial_flux_mag_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_flux_mag_turb_df*
       | *i_radial_flux_mag_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_flux_mag_turb_f0*
       | *i_radial_flux_mag_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_3db_n0_df*
       | *i_radial_pot_en_flux_3db_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_3db_n0_f0*
       | *i_radial_pot_en_flux_3db_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_3db_turb_df*
       | *i_radial_pot_en_flux_3db_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_3db_turb_f0*
       | *i_radial_pot_en_flux_3db_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_ExB0_n0_df*
       | *i_radial_pot_en_flux_ExB0_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_ExB0_n0_f0*
       | *i_radial_pot_en_flux_ExB0_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_ExB0_turb_df*
       | *i_radial_pot_en_flux_ExB0_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_ExB0_turb_f0*
       | *i_radial_pot_en_flux_ExB0_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_ExBt_n0_df*
       | *i_radial_pot_en_flux_ExBt_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_ExBt_n0_f0*
       | *i_radial_pot_en_flux_ExBt_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_ExBt_turb_df*
       | *i_radial_pot_en_flux_ExBt_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_ExBt_turb_f0*
       | *i_radial_pot_en_flux_ExBt_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_mag_n0_df*
       | *i_radial_pot_en_flux_mag_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_mag_n0_f0*
       | *i_radial_pot_en_flux_mag_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_mag_turb_df*
       | *i_radial_pot_en_flux_mag_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_radial_pot_en_flux_mag_turb_f0*
       | *i_radial_pot_en_flux_mag_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_tor_ang_mom_n0_df*
       | *i_tor_ang_mom_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_tor_ang_mom_n0_f0*
       | *i_tor_ang_mom_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_tor_ang_mom_turb_df*
       | *i_tor_ang_mom_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_tor_ang_mom_turb_f0*
       | *i_tor_ang_mom_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_toroidal_flow_n0_df*
       | *i_toroidal_flow_n0_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_toroidal_flow_n0_f0*
       | *i_toroidal_flow_n0_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_toroidal_flow_turb_df*
       | *i_toroidal_flow_turb_df*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_toroidal_flow_turb_f0*
       | *i_toroidal_flow_turb_f0*
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - | *e_u_para*
       | *i_u_para*
     - | # |nbsp| 3D |nbsp| mesh |nbsp| nodes
       | :math:`\times N_{\mathrm{planes}}`
     - Units
     - Description
   * - *inode1m1*
     - Scalar
     - Positive integer
     - Description
   * - *iphim1*
     - Scalar
     - Positive integer
     - Description
   * - *n_energy*
     - Scalar
     - Positive integer
     - Description
   * - *ndata*
     - Scalar
     - Positive integer
     - Description
   * - *nnode*
     - Scalar
     - Positive integer
     - Number of 3D mesh nodes.
   * - *nphi*
     - Scalar
     - Positive integer
     - Number of poloidal planes :math:`N_{\mathrm{planes}}`.
   * - *pot0* 
     - # |nbsp| 3D |nbsp| mesh |nbsp| nodes
     - Units
     - Description
   * - *time*
     - Scalar
     - :math:`\mathrm{s}`
     - Simulation time of step in seconds.

|br|
       
.. centered:: **xgc.f3d.#####.bp.dir** |br| :smallbluegray:`Printed when: ?` |nbsp| |nbsp| |nbsp| :smallbluegray:`Output frequency: diag_f3d_period.`

.. list-table::
   :widths: 25 25 10 100
   :header-rows: 1

   * - *Output*
     - Dimension
     - Units
     - Description
   * - *Output*
     - Dimension
     - Units
     - Description

.. toctree::
   :maxdepth: 1