Update SPSA doc
@@ -519,9 +519,14 @@ functional evaluations. Overall, the following parameters are supported:
.. code:: python
- parameters : [float, float, float, float, float]
+ c0 : float; default value is 0.62831853071796 (which is 0.2*PI)
+ c1 : float; default value is 0.1
+ c2 : float; default value is 0.602
+ c3 : float; default value is 0.101
+ c4 : float; default value is 0
+
+ These are the SPSA control parameters, consisting of 5 ``float`` values, and are used as described below.
- This is an optional parameter, consisting of a list of 5 ``float`` elements. The default value is ``None``.
SPSA updates the parameters (``theta``)
for the objective function (``J``) through the following equation at
iteration ``k``:
@@ -539,6 +544,16 @@ functional evaluations. Overall, the following parameters are supported:
objective function with the initial ``theta``. ``c1``, ``c2``, ``c3`` and ``c4`` are set as ``0.1``,
``0.602``, ``0.101``, ``0.0``, respectively.
+- Calibration step for SPSA.
+
+ .. code:: python
+
+ skip_calibration: bool
+
+ The default value is ``False``. When calibration is done, i.e. when ``skip_calibration`` is ``False`` (by default) the
+ control parameter ``c0`` as supplied is adjusted by the calibration step before optimization. If ``skip_calibration``
+ is ``True`` then the calibration step, which occurs ahead of optimization, is skipped and ``c0`` will be used unaltered.
+
.. topic:: Declarative Name
When referring to SPSA declaratively inside Aqua, its code ``name``, by which Aqua dynamically discovers and loads it,
