################################################
Reading and plotting the data in controlvect.nc
################################################


.. warning::
   To generate :bash:`controlvect.nc` files, use the option :bash:`save_out_netcdf` in :doc:`controlvect</documentation/plugins/controlvects/standard>`.

NetCDF controlvect files are stored in :bash:`$WORKDIR/controlvect/THE_VARIABLE`, where :bash:`THE_VARIABLE` is one of flux, inicond, latcond, topcond, etc., depending on which :bash:`components` were selected for inversion in :bash:`datavect` (see :doc:`the inversion tutorial</usertutos/first-inversion/index>`).

Their format is as follows:

.. literalinclude:: dump_generic_controlvect.txt

where:

 - TT: the number of time steps at the controlled resolution. For example, fluxes inverted at weekly resolution over two months give TT = 8.
 - NL, NLAT, NLON, NLATC, NLONC: the number of vertical levels, latitudes, longitudes, corner latitudes, and corner longitudes of the control vector's physical grid.
 - PP: the number of time steps at the native resolution of THE_VARIABLE. For example, fluxes inverted at weekly resolution over March and April but provided at hourly resolution give PP = (31 + 30) × 24 = 1464.
 - :bash:`x`: the increments (posterior corrections)
 - :bash:`xb`: the prior increments (typically 1 for multiplicative corrections, 0 for additive ones)
 - :bash:`b_std`: the diagonal of the :math:`\mathbf{P}^\textrm{b}` matrix (prior variances)
 - :bash:`x_phys`: the posterior physical field values
 - :bash:`xb_phys`: the prior physical field values
 - :bash:`b_phys`: the diagonal of the :math:`\mathbf{P}^\textrm{b}` matrix in physical units.

.. explications sur les unites!

Examples for reading and plotting :bash:`controlvect.nc` files are given in :doc:`the VERIFY project</projects/VERIFY/with_surf_stat>`.