.. _config:

=================
 csensors-config
=================
.. index:: csensors-config, GUI configuration
   module: GUI , configuration
   
is the configuration tool for csensors's applet. It allows detailed tuning of graphs and gradients.

For the ease of use csensors-config is broken down to several pages

.. hlist::
   * `Detailed graphs setup`_
   * `Gradients`_
   * `Preferences`_
   * `Data page`_
   * `Assistant`_

Detailed graphs setup
---------------------

.. image:: //usr/share/icons/Adwaita/48x48/apps/utilities-system-monitor.png

allows you to set parameters of individual graph.

.. image:: ../images/csensors-config.png
   :alt:  csensors-config
   :width: 100%
   :target: _static/csensors-config.png
	    
Creating new graph [*]_.
^^^^^^^^^^^^^^^^^^^^^^^^

To create new graph you may choose from following methods

- **Short path:**
  To quickly make new graph press :guilabel:`Plus` you will be asked only for :term:`device`.
  The result is very coarse - lot of fine tuning may be required.

- **Detailed setup:**
  Run assistant and you will be guided through many steps of detailed setup.
  

Graph conditions
^^^^^^^^^^^^^^^^
After each change to graph setup following checks are made [*]_

- :term:`graph key` must be set
- :term:`graph min` must be set
- :term:`graph max` must be set
- value of :term:`graph min` must be less or equal than value of :term:`graph key`
- value of :term:`graph max` must be greater or equal than value of :term:`graph key`

If one of conditions is false, then the :term:`live graph sample` is disabled.

.. [*] Currently there is **no** way to change :term:`device` of existing graph. For example : if you dislike **Core 0** graph and want to watch drawings for **Core 3**, you must remove graph for **Core 0** and then add graph for **Core 3**.
   
.. [*] No unit checking here. All unit checks are made in :term:`graph min` and :term:`graph max` menu generation.

Text options
^^^^^^^^^^^^
Text options are well hidden under **Text options** reveal er.

.. image:: ../images/text-options.png
   :alt: text-options 
   :width: 100%

	   
Gradients
---------

.. image::  //usr/share/icons/Adwaita/48x48/apps/preferences-desktop-theme.png
	    
If :term:`default gradients` are insufficient for your needs, this page allows you to manage all gradients.
Bind gradient to :term:`graph` by :guilabel:`Gradient` menu.

.. image:: ../images/gradients-page.png

	   
Preferences
-----------

Data page
---------

.. image:: //usr/share/icons/Adwaita/48x48/apps/accessories-text-editor.png
	   
Data page serves as hub for viewing all current inputs.

.. image:: ../images/data_page.png
   :alt: data page
   :width: 100%

For array ( e.g. **/proc/loadavg**) and
matrix ( **/proc/interrupts** for example ) like files :term:`data page` act as tool for selecting
interesting parts of large data-set.

.. image:: ../images/data_page_interrupts.png
   :alt: data page interrupts
   :width: 100%


Assistant
---------