tdiagnostic-viewers.rst - pism - [fork] customized build of PISM, the parallel ice sheet model (tillflux branch)
 (HTM) git clone git://src.adamsgaard.dk/pism
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) LICENSE
       ---
       tdiagnostic-viewers.rst (1847B)
       ---
            1 .. include:: ../../global.txt
            2 
            3 .. _sec-diagnostic-viewers:
            4 
            5 Run-time diagnostic viewers
            6 ---------------------------
            7 
            8 Basic graphical views of the changing state of a PISM ice model are available at the
            9 command line by using options listed in :numref:`tab-diag-viewers`. All the quantities
           10 listed in :ref:`sec-extra_vars` are available. Additionally, a couple of diagnostic
           11 quantities are *only* available as run-time viewers; these are shown in table
           12 :numref:`tab-special-diag-viewers`.
           13 
           14 .. list-table:: Options controlling run-time diagnostic viewers
           15    :name: tab-diag-viewers
           16    :header-rows: 1
           17    :widths: 1,3
           18 
           19    * - Option
           20      - Description
           21    * - :opt:`-view`
           22      - Turns on map-plane views of one or several variables, see :ref:`sec-extra_vars`.
           23    * - :opt:`-view_size` (number)
           24      - desired viewer size, in pixels
           25    * - :opt:`-display`
           26      - The option ``-display :0`` seems to frequently be needed to let PETSc use Xwindows
           27        when running multiple processes. It must be given as a *final* option, after all
           28        the others.
           29 
           30 The option ``-view`` shows map-plane views of 2D fields and surface and basal views of 3D
           31 fields (see :ref:`sec-extra_vars`); for example:
           32 
           33 .. code-block:: none
           34 
           35    pismr -i input.nc -y 1000 -o output.nc -view thk,tempsurf
           36 
           37 shows ice thickness and ice temperature at the surface.
           38 
           39 .. list-table:: Special run-time-only diagnostic viewers
           40    :name: tab-special-diag-viewers
           41    :header-rows: 1
           42    :widths: 3,5
           43 
           44    * - Option
           45      - Description
           46    * - :opt:`-ssa_view_nuh`
           47      - log base ten of ``nuH``, only available if the finite-difference SSA solver is
           48        active.
           49    * - :opt:`-ssa_nuh_viewer_size` (number)
           50      - Adjust the viewer size.
           51    * - :opt:`-ksp_monitor_draw`
           52      - Iteration monitor for the Krylov subspace routines (KSP) in PETSc. Residual norm
           53        versus iteration number.