Classical Baselines¶

This module provides classical reference models for comparison with quantum machine learning workflows.

They serve two purposes:

1. establish performance baselines
2. provide sanity checks for datasets and training pipelines

All models follow the same interface pattern as the quantum workflows:

• consistent dataset generation
• structured result dictionaries
• optional plotting
• optional saving of results and figures

Classification baselines¶

Logistic regression¶

Linear classifier trained using maximum likelihood.

from qml.classical_baselines import run_logistic_classifier

result = run_logistic_classifier(
    n_samples=200,
    noise=0.1,
    seed=123,
    plot=True,
)

Returns:

train_accuracy
test_accuracy
coefficients
intercept
predictions
probabilities

Logistic regression provides a simple reference for linear decision boundaries.

Support vector machine (SVM)¶

Kernel-based classifier.

from qml.classical_baselines import run_svm_classifier

result = run_svm_classifier(
    n_samples=200,
    noise=0.1,
    kernel="rbf",
)

Key hyperparameters:

kernel ∈ {linear, poly, rbf, sigmoid}
C
gamma

Useful for comparison with quantum kernel methods.

Multi-layer perceptron (MLP) classifier¶

Feedforward neural network trained with backpropagation.

from qml.classical_baselines import run_mlp_classifier

result = run_mlp_classifier(
    n_samples=200,
    hidden_layer_sizes=(16, 16),
)

Returns:

loss_curve
train_accuracy
test_accuracy

MLPs provide a flexible nonlinear baseline.

Regression baselines¶

Ridge regression¶

Linear regression with L2 regularisation.

from qml.classical_baselines import run_ridge_regression

result = run_ridge_regression(
    n_samples=200,
    noise=0.1,
    alpha=1.0,
)

Returns:

train_mse
test_mse
train_mae
test_mae
coefficients
intercept

Provides a simple baseline for variational quantum regression.

Multi-layer perceptron (MLP) regressor¶

Nonlinear regression using a neural network.

from qml.classical_baselines import run_mlp_regressor

result = run_mlp_regressor(
    n_samples=200,
    hidden_layer_sizes=(32, 32),
)

Returns:

loss_curve
train_mse
test_mse
train_mae
test_mae

MLP regression is a useful nonlinear comparison for VQR.

Result structure¶

All baseline workflows return dictionaries containing:

model
dataset
seed
n_samples
noise
test_size

metrics
predictions
training data
test data
model parameters

Outputs can optionally be saved:

results/classification_baselines/
results/regression_baselines/

images/classification_baselines/
images/regression_baselines/

CLI usage¶

Run baselines from the command line:

python -m qml logistic
python -m qml svm
python -m qml mlp-classifier

python -m qml ridge
python -m qml mlp-regressor

Example:

python -m qml ridge --samples 200 --noise 0.05 --alpha 0.5 --plot

Relationship to quantum models¶

Classical baselines help contextualise quantum model performance:

Comparisons are demonstrated in the notebooks:

classical_vs_quantum_classifier.ipynb
classical_vs_quantum_regression.ipynb

Design notes¶

The implementation prioritises:

• minimal abstractions
• consistent interfaces
• reproducible experiments
• compatibility with sklearn
• clear comparison with quantum workflows

The goal is not to provide a full sklearn wrapper layer, but rather lightweight baselines that integrate naturally with the rest of the package.