.. vim: set fileencoding=utf-8 :

.. Copyright (c) 2016 Idiap Research Institute, http://www.idiap.ch/          ..
.. Contact: beat.support@idiap.ch                                             ..
..                                                                            ..
.. This file is part of the beat.web module of the BEAT platform.             ..
..                                                                            ..
.. Commercial License Usage                                                   ..
.. Licensees holding valid commercial BEAT licenses may use this file in      ..
.. accordance with the terms contained in a written agreement between you     ..
.. and Idiap. For further information contact tto@idiap.ch                    ..
..                                                                            ..
.. Alternatively, this file may be used under the terms of the GNU Affero     ..
.. Public License version 3 as published by the Free Software and appearing   ..
.. in the file LICENSE.AGPL included in the packaging of this file.           ..
.. The BEAT platform is distributed in the hope that it will be useful, but   ..
.. WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY ..
.. or FITNESS FOR A PARTICULAR PURPOSE.                                       ..
..                                                                            ..
.. You should have received a copy of the GNU Affero Public License along     ..
.. with the BEAT platform. If not, see http://www.gnu.org/licenses/.          ..


.. _attestations:

==============
 Attestations
==============

Attestations provide a confirmation that the results were obtained on the
platform servers. An attestation *locks* an experiment and makes it unmutable
(cannot be changed anymore).

You can use the attestations tab to see a list of published or your own
attestations:

.. image:: img/attestation-general.*


Creating a new attestation
--------------------------

We can create a new attestation by clicking on the "Request an attestation"
button on any of our own experiments:

.. image:: img/attestation-create.*


Information on an attestation
-----------------------------

When clicking on one of the listed attestations, either on your own on the
attestation tab or on the "View attestation" button on a public experiment, a
summary of the results (error rates, performance curves, etc.) is displayed:

.. image:: img/attestation-new.*

If there are ROC curves, different formats can be chosen, such as the DET curve
fulfilling the ISO/IEC 19795-1:2006 standard:

.. image:: img/attestation-curves.*

Finally, below the results table, the complete toolchain is shown:

.. image:: img/attestation-toolchain.*

As it may be observed, if the attestation has not yet been unlocked, we can do
so by clicking on the "Unlock the attestation" button. A gentle remainder to do
it once the corresponding article has been published is included.