# This code is part of a Qiskit project.
#
# (C) Copyright IBM 2021, 2023.
#
# This code is licensed under the Apache License, Version 2.0. You may
# obtain a copy of this license in the LICENSE.txt file in the root directory
# of this source tree or at http://www.apache.org/licenses/LICENSE-2.0.
#
# Any modifications or derivative works of this code must retain this
# copyright notice, and modified files need to carry a notice indicating
# that they have been altered from the originals.
"""An abstract objective function definition and common objective functions suitable
for classifiers/regressors."""
from abc import abstractmethod
from typing import Optional, Union
import numpy as np
import qiskit_machine_learning.optionals as _optionals
from qiskit_machine_learning.neural_networks import NeuralNetwork
from qiskit_machine_learning.utils.loss_functions import Loss
if _optionals.HAS_SPARSE:
# pylint: disable=import-error
from sparse import SparseArray
else:
class SparseArray: # type: ignore
"""Empty SparseArray class
Replacement if sparse.SparseArray is not present.
"""
pass
[ドキュメント]class ObjectiveFunction:
"""An abstract objective function. Provides methods for computing objective value and
gradients for forward and backward passes."""
# pylint: disable=invalid-name
def __init__(
self, X: np.ndarray, y: np.ndarray, neural_network: NeuralNetwork, loss: Loss
) -> None:
"""
Args:
X: The input data.
y: The target values.
neural_network: An instance of an quantum neural network to be used by this
objective function.
loss: A target loss function to be used in training.
"""
super().__init__()
self._X = X
self._num_samples = X.shape[0]
self._y = y
self._neural_network = neural_network
self._loss = loss
self._last_forward_weights: Optional[np.ndarray] = None
self._last_forward: Optional[Union[np.ndarray, SparseArray]] = None
[ドキュメント] @abstractmethod
def objective(self, weights: np.ndarray) -> float:
"""Computes the value of this objective function given weights.
Args:
weights: an array of weights to be used in the objective function.
Returns:
Value of the function.
"""
raise NotImplementedError
[ドキュメント] @abstractmethod
def gradient(self, weights: np.ndarray) -> np.ndarray:
"""Computes gradients of this objective function given weights.
Args:
weights: an array of weights to be used in the objective function.
Returns:
Gradients of the function.
"""
raise NotImplementedError
def _neural_network_forward(self, weights: np.ndarray) -> Union[np.ndarray, SparseArray]:
"""
Computes and caches the results of the forward pass. Cached values may be re-used in
gradient computation.
Args:
weights: an array of weights to be used in the forward pass.
Returns:
The result of the neural network.
"""
# if we get the same weights, we don't compute the forward pass again.
if self._last_forward_weights is None or (
not np.all(np.isclose(weights, self._last_forward_weights))
):
# compute forward and cache the results for re-use in backward
self._last_forward = self._neural_network.forward(self._X, weights)
# a copy avoids keeping a reference to the same array, so we are sure we have
# different arrays on the next iteration.
self._last_forward_weights = np.copy(weights)
return self._last_forward
[ドキュメント]class BinaryObjectiveFunction(ObjectiveFunction):
"""An objective function for binary representation of the output. For instance, classes of
``-1`` and ``+1``."""
[ドキュメント] def objective(self, weights: np.ndarray) -> float:
# predict is of shape (N, 1), where N is a number of samples
predict = self._neural_network_forward(weights)
target = np.array(self._y).reshape(predict.shape)
# float(...) is for mypy compliance
return float(np.sum(self._loss(predict, target)) / self._num_samples)
[ドキュメント] def gradient(self, weights: np.ndarray) -> np.ndarray:
# check that we have supported output shape
num_outputs = self._neural_network.output_shape[0]
if num_outputs != 1:
raise ValueError(f"Number of outputs is expected to be 1, got {num_outputs}")
# output must be of shape (N, 1), where N is a number of samples
output = self._neural_network_forward(weights)
# weight grad is of shape (N, 1, num_weights)
_, weight_grad = self._neural_network.backward(self._X, weights)
# we reshape _y since the output has the shape (N, 1) and _y has (N,)
# loss_gradient is of shape (N, 1)
loss_gradient = self._loss.gradient(output, self._y.reshape(-1, 1))
# for the output we compute a dot product(matmul) of loss gradient for this output
# and weights for this output.
grad = loss_gradient[:, 0] @ weight_grad[:, 0, :]
# we keep the shape of (1, num_weights)
grad = grad.reshape(1, -1) / self._num_samples
return grad
[ドキュメント]class MultiClassObjectiveFunction(ObjectiveFunction):
"""
An objective function for multiclass representation of the output. For instance, classes of
``0``, ``1``, ``2``, etc.
"""
[ドキュメント] def objective(self, weights: np.ndarray) -> float:
# probabilities is of shape (N, num_outputs)
probs = self._neural_network_forward(weights)
num_outputs = self._neural_network.output_shape[0]
val = 0.0
num_samples = self._X.shape[0]
for i in range(num_outputs):
# for each output we compute a dot product of probabilities of this output and a loss
# vector.
# loss vector is a loss of a particular output value(value of i) versus true labels.
# we do this across all samples.
val += probs[:, i] @ self._loss(np.full(num_samples, i), self._y)
val = val / self._num_samples
return val
[ドキュメント] def gradient(self, weights: np.ndarray) -> np.ndarray:
# weight probability gradient is of shape (N, num_outputs, num_weights)
_, weight_prob_grad = self._neural_network.backward(self._X, weights)
grad = np.zeros((1, self._neural_network.num_weights))
num_samples = self._X.shape[0]
num_outputs = self._neural_network.output_shape[0]
for i in range(num_outputs):
# similar to what is in the objective, but we compute a matrix multiplication of
# weight probability gradients and a loss vector.
grad += weight_prob_grad[:, i, :].T @ self._loss(np.full(num_samples, i), self._y)
grad = grad / self._num_samples
return grad
[ドキュメント]class OneHotObjectiveFunction(ObjectiveFunction):
"""
An objective function for one hot encoding representation of the output. For instance, classes
like ``[1, 0, 0]``, ``[0, 1, 0]``, ``[0, 0, 1]``.
"""
[ドキュメント] def objective(self, weights: np.ndarray) -> float:
# probabilities is of shape (N, num_outputs)
probs = self._neural_network_forward(weights)
# float(...) is for mypy compliance
value = float(np.sum(self._loss(probs, self._y)) / self._num_samples)
return value
[ドキュメント] def gradient(self, weights: np.ndarray) -> np.ndarray:
# predict is of shape (N, num_outputs)
y_predict = self._neural_network_forward(weights)
# weight probability gradient is of shape (N, num_outputs, num_weights)
_, weight_prob_grad = self._neural_network.backward(self._X, weights)
grad = np.zeros(self._neural_network.num_weights)
num_outputs = self._neural_network.output_shape[0]
# loss gradient is of shape (N, num_output)
loss_gradient = self._loss.gradient(y_predict, self._y)
for i in range(num_outputs):
# a dot product(matmul) of loss gradient and weight probability gradient across all
# samples for an output.
grad += loss_gradient[:, i] @ weight_prob_grad[:, i, :]
grad = grad / self._num_samples
return grad