Merge pull request #1016 from mlco2/chore/bump_3.2.1

Chore/bump 3.2.1

Author: benoit-cty

CONTRIBUTING.md

@@ -392,7 +392,7 @@ api_endpoint = http://localhost:8008
 Before using it, you need an experiment_id, to get one, run:
 
 ```
-codecarbon init
+codecarbon login
 ```
 
 It will ask the API for an experiment_id on the default project and save it to `.codecarbon.config` for you.

codecarbon/_version.py

@@ -1 +1 @@
-__version__ = "3.2.0"
+__version__ = "3.2.1"

docs/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 1179cfac2a69f75fdb97976cfa9a706e
+config: 6fab6ba8b08b27f1b70031950c82d429
 tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/_sources/api.rst.txt

@@ -8,7 +8,9 @@ CodeCarbon API
 ~~~~~~~~~~~~~~
 
 .. warning::
-    This mode use the CodeCarbon API to upload the timeseries of your emissions on a central server. All data will be public!
+    This mode use the CodeCarbon API to upload the timeseries of your emissions on a central server.
+
+    Thanks to `CleverCloud <https://www.clever.cloud/>`_ the use of API is free as soon as it remains under certain limits.
 
 
 .. image:: https://github.com/mlco2/codecarbon/raw/master/carbonserver/Images/code_carbon_archi.png
@@ -22,11 +24,13 @@ CodeCarbon API
             :alt: Summary
             :width: 700px
 
-Before using it, you need an experiment_id, to get one, run:
+Before using it, you need to create on account on the `CodeCarbon dashboard <https://dashboard.codecarbon.io/>`_
+
+Then login from your terminal:
 
 .. code-block:: console
 
-    codecarbon init
+    codecarbon login
 
 It will create an experiment_id for the default project and save it to ``codecarbon.config``
 

docs/_sources/output.rst.txt

@@ -30,11 +30,11 @@ input parameter (defaults to the current directory), for each experiment tracked
    * - emissions_rate
      - emissions divided per duration, in Kg/s
    * - cpu_power
-     - CPU power (W)
+     - Mean CPU power (W)
    * - gpu_power
-     - GPU power (W)
+     - Mean GPU power (W)
    * - ram_power
-     - RAM power (W)
+     - Mean RAM power (W)
    * - cpu_energy
      - Energy used per CPU (kWh)
    * - gpu_energy
@@ -77,8 +77,16 @@ input parameter (defaults to the current directory), for each experiment tracked
        | This is done for privacy protection.
    * - ram_total_size
      -  total RAM available (Go)
-   * - Tracking_mode:
+   * - tracking_mode:
      - ``machine`` or ``process``(default to ``machine``)
+   * - cpu_utilization_percent
+     - Average CPU utilization during tracking period (%)
+   * - gpu_utilization_percent
+     - Average GPU utilization during tracking period (%)
+   * - ram_utilization_percent
+     - Average RAM utilization during tracking period (%)
+   * - ram_used_gb
+     - Average RAM used during tracking period (GB)
 
 ..  note::
 
@@ -130,7 +138,7 @@ Logfire
 Using CodeCarbon with logfire
 `````````````````````````````````
 
-`Logfire <https://docs.pydantic.dev/logfire/>`_ is an observability platform. 
+`Logfire <https://docs.pydantic.dev/logfire/>`_ is an observability platform.
 
 CodeCarbon exposes all its metrics with the suffix `codecarbon_`.
 

docs/_sources/visualize.rst.txt

@@ -8,6 +8,19 @@ Offline
 The package also comes with a ``Dash App`` containing illustrations to understand the emissions logged from various experiments across projects.
 The App currently consumes logged information from a CSV file, generated from an in-built logger in the package.
 
+Installation
+~~~~~~~~~~~~
+The carbonboard visualization tool requires additional dependencies. Install them with:
+
+.. code-block:: bash
+
+    pip install codecarbon[carbonboard]
+
+.. note::
+   The ``viz-legacy`` extra is deprecated but still works for backwards compatibility. It will be removed in v4.0.0. Please use ``carbonboard`` instead.
+
+Usage
+~~~~~
 The App can be run by executing the below CLI command that needs following arguments:
 
 - ``filepath`` - path to the CSV file containing logged information across experiments and projects
@@ -107,6 +120,5 @@ The app also provides a visualization of regional carbon intensity of electricit
             :alt: carbon intensity carbon_map
             :width: 750px
 
-Note that for now, all data sent to CodeCarbon API are public.
 
 

…edit/_build/html/_static/base-stemmer.js docs/_static/base-stemmer.jsdocs/edit/_build/html/_static/base-stemmer.js renamed to docs/_static/base-stemmer.js docs/edit/_build/html/_static/base-stemmer.js renamed to docs/_static/base-stemmer.js

@@ -741,6 +741,14 @@ abbr, acronym {
     cursor: help;
 }
 
+.translated {
+    background-color: rgba(207, 255, 207, 0.2)
+}
+
+.untranslated {
+    background-color: rgba(255, 207, 207, 0.2)
+}
+
 /* -- code displays --------------------------------------------------------- */
 
 pre {

docs/_static/basic.css

@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: '3.1.1',
+    VERSION: '3.2.1',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',