Labeler
=======

Labeler adds ``label`` data into the given ``JSON`` file (the one generated by :doc:`calculator`). One can add labels such as "Exposition", "First Theme", and so on. :doc:`plotter` needs labeled ``JSON`` to render comparative partitiograms.

The command below parses the given ``score-labels.txt`` file and adds it to the ``score.json`` file.

.. code-block:: console

    rpscripts label -t score-labels.txt score.json

Labeler demands a TXT file with annotations with the label name and its start point, one in each line and separated by commas:

.. code-block::

    One label,1+0
    Another label,2+1/4
    One more label,2+3/2

Option ``-h`` returns the program's help:

.. code-block:: console

    usage: rpscripts label [-h] [-t TXT_FILENAME] filename

    positional arguments:
    filename              JSON filename (calc's output)

    options:
    -h, --help            show this help message and exit
    -t TXT_FILENAME, --txt_filename TXT_FILENAME
                            TXT filename (labels map)

See :ref:`comparative_partitiograms` and :ref:`form_displaying` for some labels applications.