Acquisition Functions Guide

5. Acquisition Functions Guide#

5.1. 🎯 Introduction#

Acquisition functions are the heart of Bayesian optimization. They determine where to sample next by balancing exploration (sampling in uncertain regions) and exploitation (sampling near current best points).

5.2. 📊 Available Acquisition Functions#

5.2.1. 1. Expected Improvement (EI)#

The most popular acquisition function that balances exploration and exploitation naturally.

Mathematical Formula:

EI(x) = (μ(x) - f*) * Φ(Z) + σ(x) * φ(Z)
where Z = (μ(x) - f*) / σ(x)

Usage:

from Bgolearn import BGOsampling
import numpy as np
import pandas as pd

# Create sample data
def create_test_function():
    """Create a test optimization problem."""
    np.random.seed(42)
    X = np.random.uniform(-3, 3, (20, 2))
    y = -(X[:, 0]**2 + X[:, 1]**2) + 0.1 * np.random.randn(20)  # Negative quadratic with noise
    return pd.DataFrame(X, columns=['x1', 'x2']), pd.Series(y)

# Generate candidates
def create_candidates():
    x1 = np.linspace(-3, 3, 50)
    x2 = np.linspace(-3, 3, 50)
    X1, X2 = np.meshgrid(x1, x2)
    candidates = np.column_stack([X1.ravel(), X2.ravel()])
    return pd.DataFrame(candidates, columns=['x1', 'x2'])

X_train, y_train = create_test_function()
X_candidates = create_candidates()

# Initialize and fit
optimizer = BGOsampling.Bgolearn()
model = optimizer.fit(X_train, y_train, X_candidates, min_search=False)

# Expected Improvement
ei_values, next_point = model.EI()
print(f"EI selected point: {next_point}")
print(f"EI values range: [{ei_values.min():.4f}, {ei_values.max():.4f}]")

# Expected Improvement with custom baseline
ei_values_custom, next_point_custom = model.EI(T=-2.0)  # Custom threshold
print(f"EI with custom baseline: {next_point_custom}")

When to use:

General-purpose optimization
Balanced exploration-exploitation
Most research applications

5.2.2. 2. Expected Improvement with Plugin#

Uses the model’s prediction on training data as the baseline instead of the actual best observed value.

# Expected Improvement with Plugin
eip_values, next_point_eip = model.EI_plugin()
print(f"EI Plugin selected point: {next_point_eip}")

# Compare with standard EI
print(f"Standard EI point: {next_point}")
print(f"Plugin EI point: {next_point_eip}")

When to use:

When training data has noise
Model predictions are more reliable than observations

5.2.3. 3. Upper Confidence Bound (UCB)#

Optimistic approach that selects points with high predicted mean plus uncertainty.

Mathematical Formula:

UCB(x) = μ(x) + α * σ(x)

# Upper Confidence Bound with different exploration parameters
ucb_conservative, point_conservative = model.UCB(alpha=1.0)  # Conservative
ucb_balanced, point_balanced = model.UCB(alpha=2.0)  # Balanced (default)
ucb_exploratory, point_exploratory = model.UCB(alpha=3.0)  # Exploratory

print("UCB Results:")
print(f"Conservative (α=1.0): {point_conservative}")
print(f"Balanced (α=2.0): {point_balanced}")
print(f"Exploratory (α=3.0): {point_exploratory}")

# Visualize the effect of alpha
import matplotlib.pyplot as plt

fig, axes = plt.subplots(1, 3, figsize=(15, 5))
alphas = [1.0, 2.0, 3.0]
titles = ['Conservative', 'Balanced', 'Exploratory']

for i, (alpha, title) in enumerate(zip(alphas, titles)):
    ucb_vals, _ = model.UCB(alpha=alpha)
    
    # Reshape for 2D plot (assuming square grid)
    grid_size = int(np.sqrt(len(ucb_vals)))
    ucb_grid = ucb_vals[:grid_size**2].reshape(grid_size, grid_size)
    
    im = axes[i].imshow(ucb_grid, extent=[-3, 3, -3, 3], origin='lower', cmap='viridis')
    axes[i].set_title(f'{title} (α={alpha})')
    axes[i].set_xlabel('x1')
    axes[i].set_ylabel('x2')
    plt.colorbar(im, ax=axes[i])

plt.tight_layout()
plt.show()

When to use:

Noisy functions
When you want to control exploration explicitly
Multi-armed bandit problems

5.2.4. 4. Probability of Improvement (PoI)#

Selects points with highest probability of improving over current best.

Mathematical Formula:

PoI(x) = Φ((μ(x) - f* - τ) / σ(x))

# Probability of Improvement with different thresholds
poi_strict, point_strict = model.PoI(tao=0.0)  # Strict improvement
poi_relaxed, point_relaxed = model.PoI(tao=0.1)  # Allow small degradation
poi_very_relaxed, point_very_relaxed = model.PoI(tao=0.5)  # Very relaxed

print("PoI Results:")
print(f"Strict (τ=0.0): {point_strict}")
print(f"Relaxed (τ=0.1): {point_relaxed}")
print(f"Very Relaxed (τ=0.5): {point_very_relaxed}")

# Custom baseline
poi_custom, point_custom = model.PoI(tao=0.1, T=-1.5)
print(f"Custom baseline (T=-1.5): {point_custom}")

When to use:

When any improvement is valuable
Risk-averse optimization
Proof-of-concept studies

5.2.5. 5. Augmented Expected Improvement (AEI)#

Enhanced version of EI that accounts for noise and uses a more sophisticated baseline.

# Augmented Expected Improvement
aei_default, point_aei_default = model.Augmented_EI()
aei_custom, point_aei_custom = model.Augmented_EI(alpha=1.5, tao=0.1)

print("AEI Results:")
print(f"Default parameters: {point_aei_default}")
print(f"Custom (α=1.5, τ=0.1): {point_aei_custom}")

Parameters:

alpha: Trade-off coefficient for baseline selection
tao: Noise standard deviation

When to use:

Noisy experimental data
When you want more sophisticated baseline selection

5.2.6. 6. Expected Quantile Improvement (EQI)#

Uses quantiles instead of mean for more robust optimization.

# Expected Quantile Improvement
eqi_median, point_eqi_median = model.EQI(beta=0.5)  # Median
eqi_conservative, point_eqi_conservative = model.EQI(beta=0.25)  # 25th percentile
eqi_optimistic, point_eqi_optimistic = model.EQI(beta=0.75)  # 75th percentile

print("EQI Results:")
print(f"Median (β=0.5): {point_eqi_median}")
print(f"Conservative (β=0.25): {point_eqi_conservative}")
print(f"Optimistic (β=0.75): {point_eqi_optimistic}")

When to use:

Robust optimization
When you want to optimize specific quantiles
Risk management scenarios

5.2.7. 7. Reinterpolation Expected Improvement (REI)#

Uses reinterpolated values for baseline calculation.

# Reinterpolation Expected Improvement
rei_values, point_rei = model.Reinterpolation_EI()
print(f"REI selected point: {point_rei}")

When to use:

When model predictions on training data are unreliable
Iterative refinement scenarios

5.2.8. 8. Predictive Entropy Search (PES)#

Information-theoretic approach that maximizes information gain about the optimum.

# Predictive Entropy Search
pes_default, point_pes_default = model.PES()  # Default 100 samples
pes_high_precision, point_pes_high = model.PES(sam_num=500)  # Higher precision

print("PES Results:")
print(f"Default (100 samples): {point_pes_default}")
print(f"High precision (500 samples): {point_pes_high}")

When to use:

Information-theoretic optimization
When you want to maximize learning about the optimum
Academic research

5.2.9. 9. Knowledge Gradient (KG)#

Estimates the value of information from each potential measurement.

# Knowledge Gradient
kg_fast, point_kg_fast = model.Knowledge_G(MC_num=1)  # Fast approximation
kg_accurate, point_kg_accurate = model.Knowledge_G(MC_num=5)  # More accurate

print("KG Results:")
print(f"Fast (1 MC sample): {point_kg_fast}")
print(f"Accurate (5 MC samples): {point_kg_accurate}")

# Parallel version (if supported)
try:
    kg_parallel, point_kg_parallel = model.Knowledge_G(MC_num=3, Proc_num=2)
    print(f"Parallel (2 processes): {point_kg_parallel}")
except:
    print("Parallel processing not available on this system")

When to use:

When measurement cost varies
Portfolio optimization
Multi-fidelity optimization

5.2.10. 10. Thompson Sampling#

Probabilistic approach that samples from the posterior distribution.

# Thompson Sampling
ts_point, ts_value, ts_uncertainty = model.Thompson_sampling()

print("Thompson Sampling Results:")
print(f"Selected point: {ts_point}")
print(f"Sampled value: {ts_value:.4f}")
print(f"Uncertainty: {ts_uncertainty:.4f}")

# Multiple Thompson samples
print("\nMultiple Thompson samples:")
for i in range(5):
    point, value, uncertainty = model.Thompson_sampling()
    print(f"Sample {i+1}: point={point}, value={value:.4f}")

When to use:

Exploration-heavy scenarios
Multi-armed bandit problems
When you want diverse sampling strategies

5.3. 🔄 Sequential Optimization Strategy#

For multiple experiments, use sequential optimization by updating the model:

# Sequential optimization example
def sequential_optimization(model, n_iterations=3):
    """Perform sequential optimization."""
    results = []

    for i in range(n_iterations):
        print(f"\n=== Iteration {i+1} ===")

        # Get recommendation using EI
        ei_values, recommended_points = model.EI()
        next_point = recommended_points[0]

        print(f"Recommended point: {next_point}")

        # Simulate experiment (replace with actual experiment)
        # For demo, we'll use the true function
        simulated_result = -(next_point[0]**2 + next_point[1]**2) + 0.1 * np.random.randn()

        results.append({
            'iteration': i+1,
            'point': next_point,
            'result': simulated_result
        })

        print(f"Experimental result: {simulated_result:.4f}")

        # In practice, you would retrain the model with new data here
        # model = retrain_with_new_data(model, next_point, simulated_result)

    return results

# Run sequential optimization
optimization_results = sequential_optimization(model, n_iterations=3)

5.4. 📋 Table 2.1: Complete Acquisition Functions in Bgolearn#

No.	Function Name	Method Call	Parameters	Return Format	Mathematical Basis	Primary Use Case
1	Expected Improvement	`model.EI(T=None)`	`T`: baseline threshold (float, optional)	`(values, points)`	EI(x) = (μ(x) - f*) × Φ(Z) + σ(x) × φ(Z)	General-purpose optimization
2	EI with Plugin	`model.EI_plugin()`	None	`(values, points)`	EI with model prediction baseline	Noisy experimental data
3	Augmented Expected Improvement	`model.Augmented_EI(alpha=1, tao=0)`	`alpha`: trade-off coefficient (float) `tao`: noise std (float)	`(values, points)`	Enhanced EI with noise consideration	Noisy optimization problems
4	Expected Quantile Improvement	`model.EQI(beta=0.5, tao_new=0)`	`beta`: quantile level (0-1) `tao_new`: noise std (float)	`(values, points)`	Quantile-based improvement	Robust optimization
5	Reinterpolation EI	`model.Reinterpolation_EI()`	None	`(values, points)`	EI with reinterpolated baseline	Model refinement scenarios
6	Upper Confidence Bound	`model.UCB(alpha=1)`	`alpha`: exploration weight (float)	`(values, points)`	UCB(x) = μ(x) ± α × σ(x)	High exploration needs
7	Probability of Improvement	`model.PoI(tao=0, T=None)`	`tao`: improvement threshold (float) `T`: baseline (float, optional)	`(values, points)`	PoI(x) = Φ((μ(x) - f* - τ) / σ(x))	Risk-averse optimization
8	Predictive Entropy Search	`model.PES(sam_num=500)`	`sam_num`: Monte Carlo samples (int)	`(values, points)`	Information-theoretic approach	Maximum information gain
9	Knowledge Gradient	`model.Knowledge_G(MC_num=1, Proc_num=None)`	`MC_num`: MC simulations (1-10) `Proc_num`: processors (int, optional)	`(values, points)`	Value of information estimation	Multi-fidelity optimization
10	Thompson Sampling	`model.Thompson_sampling()`	None	`(point, value, uncertainty)`	Posterior sampling	Diverse exploration strategies

5.4.1. 📊 Function Categories#

5.4.1.1. Improvement-Based Functions#

EI, EI_plugin, Augmented_EI, EQI, Reinterpolation_EI: Focus on expected improvement over current best
Mathematical Foundation: Based on improvement probability and magnitude
Best For: General optimization, noisy data, robust optimization

5.4.1.2. Confidence-Based Functions#

UCB, PoI: Based on confidence bounds and improvement probability
Mathematical Foundation: Statistical confidence intervals
Best For: Exploration control, risk management

5.4.1.3. Information-Theoretic Functions#

PES, Knowledge_G: Maximize information gain about the optimum
Mathematical Foundation: Entropy and information theory
Best For: Learning about the function, multi-fidelity problems

5.4.1.4. Sampling-Based Functions#

Thompson_sampling: Probabilistic sampling from posterior
Mathematical Foundation: Bayesian posterior sampling
Best For: Diverse exploration, multi-armed bandits

5.4.2. 📋 Table 2.2: Parameter Details and Default Values#

Function	Parameter	Type	Default	Range/Options	Description	Effect
EI	`T`	float	`None`	Any float or `None`	Baseline threshold for improvement	Lower T → more exploration
Augmented_EI	`alpha`	float	`1`	> 0	Trade-off coefficient	Higher α → more conservative baseline
	`tao`	float	`0`	≥ 0	Noise standard deviation	Higher τ → accounts for more noise
EQI	`beta`	float	`0.5`	[0, 1]	Quantile level (0.5 = median)	Lower β → more conservative
	`tao_new`	float	`0`	≥ 0	Noise standard deviation	Higher τ → more robust
UCB	`alpha`	float	`1`	> 0	Exploration weight	Higher α → more exploration
PoI	`tao`	float	`0`	≥ 0	Improvement threshold	Higher τ → easier to satisfy
	`T`	float	`None`	Any float or `None`	Baseline threshold	Custom baseline override
PES	`sam_num`	int	`500`	> 0	Monte Carlo samples	Higher → more accurate, slower
Knowledge_G	`MC_num`	int	`1`	1-10	Monte Carlo simulations	Higher → more accurate, slower
	`Proc_num`	int	`None`	> 0 or `None`	Number of processors	Parallel processing control

5.4.3. 📊 Table 2.3: Exploration vs Exploitation Characteristics#

Function	Exploration Level	Exploitation Level	Balance Type	Tuning Parameter
EI	Medium	Medium	Balanced	`T` (baseline)
EI_plugin	Medium	Medium	Balanced	None
Augmented_EI	Medium-High	Medium	Balanced+	`alpha`, `tao`
EQI	Medium	Medium-High	Balanced	`beta`
Reinterpolation_EI	Medium	Medium	Balanced	None
UCB	High	Low-Medium	Exploration-heavy	`alpha`
PoI	Low	High	Exploitation-heavy	`tao`
PES	High	Low	Exploration-heavy	`sam_num`
Knowledge_G	Medium-High	Medium	Balanced	`MC_num`
Thompson_sampling	High	Low	Exploration-heavy	None

5.4.4. 🎯 Quick Selection Guide#

For beginners: Start with Expected Improvement (EI) - it’s the most widely used and well-understood.

For noisy data: Use Augmented EI or UCB with appropriate parameters.

For risk-averse optimization: Use Probability of Improvement (PoI).

For maximum exploration: Use UCB with high alpha or Thompson Sampling.

For information-theoretic approaches: Use PES or Knowledge Gradient.

For robust optimization: Use Expected Quantile Improvement (EQI).

5.5. 📊 Table 2.4: Complete Usage Examples#

# Complete demonstration of all acquisition functions
from Bgolearn import BGOsampling
import numpy as np
import pandas as pd

# Create sample optimization problem
def demonstrate_all_acquisition_functions():
    """Demonstrate all 10 acquisition functions in Bgolearn."""

    # Setup data
    np.random.seed(42)
    X_train = pd.DataFrame(np.random.randn(15, 2), columns=['x1', 'x2'])
    y_train = pd.Series(-(X_train['x1']**2 + X_train['x2']**2) + 0.1*np.random.randn(15))
    X_candidates = pd.DataFrame(np.random.randn(50, 2), columns=['x1', 'x2'])

    # Fit model
    optimizer = BGOsampling.Bgolearn()
    model = optimizer.fit(X_train, y_train, X_candidates, opt_num=1)

    print("🎯 All Bgolearn Acquisition Functions Demo")
    print("=" * 60)

    # 1. Expected Improvement
    print("\n1. Expected Improvement (EI)")
    ei_values, ei_point = model.EI()
    print(f"   Selected point: {ei_point[0]}")
    print(f"   EI range: [{ei_values.min():.4f}, {ei_values.max():.4f}]")

    # 2. EI with Plugin
    print("\n2. Expected Improvement with Plugin")
    eip_values, eip_point = model.EI_plugin()
    print(f"   Selected point: {eip_point[0]}")
    print(f"   EI Plugin range: [{eip_values.min():.4f}, {eip_values.max():.4f}]")

    # 3. Augmented EI
    print("\n3. Augmented Expected Improvement")
    aei_values, aei_point = model.Augmented_EI(alpha=1.5, tao=0.1)
    print(f"   Selected point: {aei_point[0]}")
    print(f"   AEI range: [{aei_values.min():.4f}, {aei_values.max():.4f}]")

    # 4. Expected Quantile Improvement
    print("\n4. Expected Quantile Improvement")
    eqi_values, eqi_point = model.EQI(beta=0.5, tao_new=0.05)
    print(f"   Selected point: {eqi_point[0]}")
    print(f"   EQI range: [{eqi_values.min():.4f}, {eqi_values.max():.4f}]")

    # 5. Reinterpolation EI
    print("\n5. Reinterpolation Expected Improvement")
    rei_values, rei_point = model.Reinterpolation_EI()
    print(f"   Selected point: {rei_point[0]}")
    print(f"   REI range: [{rei_values.min():.4f}, {rei_values.max():.4f}]")

    # 6. Upper Confidence Bound
    print("\n6. Upper Confidence Bound")
    ucb_values, ucb_point = model.UCB(alpha=2.0)
    print(f"   Selected point: {ucb_point[0]}")
    print(f"   UCB range: [{ucb_values.min():.4f}, {ucb_values.max():.4f}]")

    # 7. Probability of Improvement
    print("\n7. Probability of Improvement")
    poi_values, poi_point = model.PoI(tao=0.01)
    print(f"   Selected point: {poi_point[0]}")
    print(f"   PoI range: [{poi_values.min():.4f}, {poi_values.max():.4f}]")

    # 8. Predictive Entropy Search
    print("\n8. Predictive Entropy Search")
    pes_values, pes_point = model.PES(sam_num=100)
    print(f"   Selected point: {pes_point[0]}")
    print(f"   PES range: [{pes_values.min():.4f}, {pes_values.max():.4f}]")

    # 9. Knowledge Gradient
    print("\n9. Knowledge Gradient")
    kg_values, kg_point = model.Knowledge_G(MC_num=1)
    print(f"   Selected point: {kg_point[0]}")
    print(f"   KG range: [{kg_values.min():.4f}, {kg_values.max():.4f}]")

    # 10. Thompson Sampling (different return format)
    print("\n10. Thompson Sampling")
    ts_point, ts_value, ts_uncertainty = model.Thompson_sampling()
    print(f"   Selected point: {ts_point}")
    print(f"   Sampled value: {ts_value:.4f}")
    print(f"   Uncertainty: {ts_uncertainty:.4f}")

    print("\n" + "=" * 60)
    print("✅ All 10 acquisition functions demonstrated successfully!")

# Run the demonstration
demonstrate_all_acquisition_functions()

5.6. 📊 Comparing Acquisition Functions#

# Compare all acquisition functions
def compare_acquisition_functions(model):
    """Compare different acquisition functions."""
    results = {}

    # Standard acquisition functions (return values, points)
    methods = {
        'EI': lambda: model.EI(),
        'EI_Plugin': lambda: model.EI_plugin(),
        'Augmented_EI': lambda: model.Augmented_EI(),
        'EQI': lambda: model.EQI(beta=0.5),
        'Reinterpolation_EI': lambda: model.Reinterpolation_EI(),
        'UCB': lambda: model.UCB(alpha=2.0),
        'PoI': lambda: model.PoI(tao=0.01),
        'PES': lambda: model.PES(sam_num=100),
        'Knowledge_G': lambda: model.Knowledge_G(MC_num=1)
    }

    # Thompson Sampling (different return format)
    ts_methods = {
        'Thompson_Sampling': lambda: model.Thompson_sampling()
    }
    
    for name, method in methods.items():
        try:
            values, point = method()
            results[name] = {
                'point': point[0] if len(point.shape) > 1 else point,
                'max_value': values.max(),
                'mean_value': values.mean(),
                'std_value': values.std()
            }
        except Exception as e:
            print(f"Error with {name}: {e}")
            results[name] = None

    # Handle Thompson Sampling separately (different return format)
    for name, method in ts_methods.items():
        try:
            point, value, uncertainty = method()
            results[name] = {
                'point': point,
                'sampled_value': value,
                'uncertainty': uncertainty
            }
        except Exception as e:
            print(f"Error with {name}: {e}")
            results[name] = None

    return results

# Run comparison
comparison = compare_acquisition_functions(model)

# Display results
print("Acquisition Function Comparison:")
print("-" * 70)
for name, result in comparison.items():
    if result:
        print(f"{name:15s}: Point={result['point']}")
        if 'max_value' in result:
            print(f"                Max={result['max_value']:.4f}, "
                  f"Mean={result['mean_value']:.4f}, "
                  f"Std={result['std_value']:.4f}")
        elif 'sampled_value' in result:
            print(f"                Sampled Value={result['sampled_value']:.4f}, "
                  f"Uncertainty={result['uncertainty']:.4f}")
    else:
        print(f"{name:15s}: Failed")
    print()

5.7. 🎨 Visualizing Acquisition Functions#

import matplotlib.pyplot as plt
import numpy as np

# Basic visualization using matplotlib

# Example: 1D acquisition function visualization
def visualize_1d_acquisition():
    """Visualize acquisition functions for 1D problems."""
    from Bgolearn import BGOsampling
    import pandas as pd

    # Create 1D test problem
    x_1d = np.linspace(-3, 3, 100).reshape(-1, 1)
    y_1d = -(x_1d.flatten() - 1)**2 + 0.1 * np.random.randn(100)

    # Select training points
    train_indices = np.random.choice(100, 10, replace=False)
    X_train_1d = x_1d[train_indices]
    y_train_1d = y_1d[train_indices]

    # Fit model
    optimizer_1d = BGOsampling.Bgolearn()
    model_1d = optimizer_1d.fit(
        pd.DataFrame(X_train_1d, columns=['x']),
        pd.Series(y_train_1d),
        pd.DataFrame(x_1d, columns=['x']),
        min_search=False
    )

    # Get acquisition values
    ei_vals, ei_point = model_1d.EI()

    # Create custom plot
    fig, (ax1, ax2) = plt.subplots(2, 1, figsize=(12, 8))

    # Plot 1: Objective function and model
    x_plot = x_1d.flatten()
    ax1.plot(x_plot, y_1d, 'b-', alpha=0.3, label='True function')
    ax1.scatter(X_train_1d.flatten(), y_train_1d, c='red', s=50, label='Training data')
    ax1.plot(x_plot, model_1d.virtual_samples_mean, 'g-', label='GP mean')
    ax1.fill_between(x_plot,
                     model_1d.virtual_samples_mean - model_1d.virtual_samples_std,
                     model_1d.virtual_samples_mean + model_1d.virtual_samples_std,
                     alpha=0.2, color='green', label='GP uncertainty')
    ax1.axvline(x=ei_point[0], color='orange', linestyle='--', label='Next point')
    ax1.set_ylabel('Objective Value')
    ax1.set_title('Gaussian Process Model')
    ax1.legend()
    ax1.grid(True)

    # Plot 2: Acquisition function
    ax2.plot(x_plot, ei_vals, 'purple', linewidth=2, label='Expected Improvement')
    ax2.axvline(x=ei_point[0], color='orange', linestyle='--', label='Next point')
    ax2.set_xlabel('x')
    ax2.set_ylabel('EI Value')
    ax2.set_title('Expected Improvement Acquisition Function')
    ax2.legend()
    ax2.grid(True)

    plt.tight_layout()
    plt.show()

# Run 1D visualization
visualize_1d_acquisition()

5.8. 🎯 Choosing the Right Acquisition Function#

5.8.1. Decision Tree#

Are you doing parallel experiments?
├─ Yes → Use batch_EI() or batch_UCB()
└─ No → Continue below

Is your function very noisy?
├─ Yes → Use UCB (high α) or AEI
└─ No → Continue below

Do you want balanced exploration/exploitation?
├─ Yes → Use EI (recommended for most cases)
└─ No → Continue below

Do you want more exploration?
├─ Yes → Use UCB (high α) or PES
└─ No → Use PoI or EQI

5.8.2. Performance Characteristics#

Function	Exploration	Exploitation	Noise Robustness	Computational Cost
EI	Medium	Medium	Medium	Low
UCB	High	Low	High	Low
PoI	Low	High	Low	Low
AEI	Medium	Medium	High	Medium
EQI	Medium	Medium	High	Medium
REI	Medium	Medium	Medium	Medium
PES	High	Low	Medium	High
KG	Medium	Medium	Medium	High

5.9. 💡 Advanced Tips#

5.9.1. Custom Acquisition Functions#

# You can implement custom acquisition functions
class CustomAcquisition:
    def __init__(self, model, X_train, y_train):
        self.model = model
        self.X_train = X_train
        self.y_train = y_train
        self.current_best = y_train.max()  # For maximization
    
    def custom_ei_variant(self, X_candidates, beta=1.0):
        """Custom EI variant with additional parameter."""
        mean, std = self.model.fit_pre(self.X_train, self.y_train, X_candidates)
        
        improvement = mean - self.current_best
        z = improvement / (std + 1e-9)
        
        # Custom modification: add beta parameter
        ei = improvement * norm.cdf(z) + beta * std * norm.pdf(z)
        return np.maximum(ei, 0)

# Usage would require integration with the main framework

5.9.2. Parameter Tuning#

# Systematic parameter exploration
def tune_acquisition_parameters():
    """Tune acquisition function parameters."""
    
    # UCB alpha tuning
    alphas = [0.5, 1.0, 1.5, 2.0, 2.5, 3.0]
    ucb_results = {}
    
    for alpha in alphas:
        ucb_vals, point = model.UCB(alpha=alpha)
        ucb_results[alpha] = {
            'point': point,
            'max_acquisition': ucb_vals.max()
        }
    
    print("UCB Alpha Tuning:")
    for alpha, result in ucb_results.items():
        print(f"α={alpha}: max_acq={result['max_acquisition']:.4f}")
    
    # PoI tau tuning
    taus = [0.0, 0.01, 0.05, 0.1, 0.2]
    poi_results = {}
    
    for tau in taus:
        poi_vals, point = model.PoI(tao=tau)
        poi_results[tau] = {
            'point': point,
            'max_acquisition': poi_vals.max()
        }
    
    print("\nPoI Tau Tuning:")
    for tau, result in poi_results.items():
        print(f"τ={tau}: max_acq={result['max_acquisition']:.4f}")

tune_acquisition_parameters()

Acquisition Functions Guide

Contents

5. Acquisition Functions Guide#

5.1. 🎯 Introduction#

5.2. 📊 Available Acquisition Functions#

5.2.1. 1. Expected Improvement (EI)#

5.2.2. 2. Expected Improvement with Plugin#

5.2.3. 3. Upper Confidence Bound (UCB)#

5.2.4. 4. Probability of Improvement (PoI)#

5.2.5. 5. Augmented Expected Improvement (AEI)#

5.2.6. 6. Expected Quantile Improvement (EQI)#

5.2.7. 7. Reinterpolation Expected Improvement (REI)#

5.2.8. 8. Predictive Entropy Search (PES)#

5.2.9. 9. Knowledge Gradient (KG)#

5.2.10. 10. Thompson Sampling#

5.3. 🔄 Sequential Optimization Strategy#

5.4. 📋 Table 2.1: Complete Acquisition Functions in Bgolearn#

5.4.1. 📊 Function Categories#

5.4.1.1. Improvement-Based Functions#

5.4.1.2. Confidence-Based Functions#

5.4.1.3. Information-Theoretic Functions#

5.4.1.4. Sampling-Based Functions#

5.4.2. 📋 Table 2.2: Parameter Details and Default Values#

5.4.3. 📊 Table 2.3: Exploration vs Exploitation Characteristics#

5.4.4. 🎯 Quick Selection Guide#

5.5. 📊 Table 2.4: Complete Usage Examples#

5.6. 📊 Comparing Acquisition Functions#

5.7. 🎨 Visualizing Acquisition Functions#

5.8. 🎯 Choosing the Right Acquisition Function#

5.8.1. Decision Tree#

5.8.2. Performance Characteristics#

5.9. 💡 Advanced Tips#

5.9.1. Custom Acquisition Functions#

5.9.2. Parameter Tuning#