Source code for scripts.xy.correlation_comparison

"""
Comparison of spin-spin correlation functions G(r) for the XY model.
Contrasts power-law decay (low T) with exponential decay (high T).
"""
from __future__ import annotations

import argparse
import logging

import matplotlib.pyplot as plt
import numpy as np

from models.xy_model import XYSimulation
from utils.observables import (
    CorrelationPoint,
    fit_correlation_exponent,
    fit_correlation_length,
    measure_correlation_point,
)
from utils.plotting import ensure_results_dir, save_plot
from utils.system import parallel_sweep, parse_args_compat, setup_logging


[docs] def main() -> None: """Run the correlation comparison analysis for the XY model.""" parser = argparse.ArgumentParser(description='2D XY Model Correlation Comparison') parser.add_argument('--size', type=int, default=128, help='Linear lattice size L') parser.add_argument('--steps', type=int, default=10000, help='Measurement steps') parser.add_argument('--eq-probe', type=int, default=200, help='Convergence probe chunk size') # At T = 0.4 the random start sheds its vortex pairs only after 46,000 to # 58,000 sweeps on L = 128, so the cap leaves room for slower seeds. parser.add_argument('--eq-max', type=int, default=200000, help='Max equilibration steps') parser.add_argument('--interval', type=int, default=20, help='Sample interval') parser.add_argument('--seed', type=int, default=510, help='Random seed') parser.add_argument('--output-dir', type=str, default='results/xy', help='Output directory') parser.add_argument('--log-file', type=str, default=None, help='Optional log file path') parser.add_argument('--verbose', action='store_true', help='Enable verbose logging') args = parse_args_compat(parser=parser) # Configure logging log_level = logging.DEBUG if args.verbose else logging.INFO logger = setup_logging(level=log_level, log_file=args.log_file) # Temperatures T_LOW: float = 0.4 # Well below BKT (Power law expected) T_HIGH: float = 1.5 # Well above BKT (Exponential expected) logger.info(f'Starting XY correlation comparison (L={args.size})...') points = [ CorrelationPoint( label=label, temperature=T, model_cls=XYSimulation, model_kwargs={}, size=args.size, seed=args.seed, eq_probe=args.eq_probe, eq_max=args.eq_max, meas_steps=args.steps, interval=args.interval, ) for label, T in (('low', T_LOW), ('high', T_HIGH)) ] results = { label: (r, G) for label, r, G in parallel_sweep( worker_func=measure_correlation_point, params=points, ) } r_low, G_low = results['low'] r_high, G_high = results['high'] # Below the transition the XY model is quasi-ordered, so the expected form # is a power law whose exponent spin-wave theory fixes at eta = T/(2 pi J); # above it correlations decay exponentially with a finite length. eta_low = fit_correlation_exponent(r=r_low, G=G_low) xi_high = fit_correlation_length(r=r_high, G=G_high) eta_spin_wave = T_LOW / (2.0 * np.pi) logger.info( f'T={T_LOW}: fitted eta = {eta_low:.4f} ' f'(spin-wave prediction {eta_spin_wave:.4f})' ) logger.info(f'T={T_HIGH}: fitted correlation length xi = {xi_high:.4f}') # Plotting fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(14, 6)) # 1. Log-Log Plot (Best for Power Law / Low T) # We skip r=0 to avoid log(0) ax1.loglog(r_low[1:], G_low[1:], 'o-', label=f'T={T_LOW} (Low Temp)') ax1.loglog(r_high[1:], G_high[1:], 'x-', label=f'T={T_HIGH} (High Temp)') ax1.set_title('Log-Log Plot\n(Straight line = Power Law Decay)') ax1.set_xlabel('Distance r') ax1.set_ylabel('Correlation G(r)') ax1.legend() ax1.grid(True, which='both', ls='-', alpha=0.5) # 2. Semi-Log Plot (Best for Exponential / High T) ax2.plot(r_low, G_low, 'o-', label=f'T={T_LOW} (Low Temp)') ax2.plot(r_high, G_high, 'x-', label=f'T={T_HIGH} (High Temp)') ax2.set_yscale('log') ax2.set_title('Semi-Log Plot\n(Straight line = Exponential Decay)') ax2.set_xlabel('Distance r') ax2.set_ylabel('Correlation G(r)') ax2.legend() ax2.grid(True, which='both', ls='-', alpha=0.5) output_dir: str = ensure_results_dir(directory=args.output_dir) save_plot(filename='correlation_comparison.png', directory=output_dir) # Save data for notebook consumption npz_path = f'{output_dir}/correlation_comparison.npz' np.savez_compressed( npz_path, r_low=r_low, G_low=G_low, r_high=r_high, G_high=G_high, T_low=T_LOW, T_high=T_HIGH, L=args.size, steps=args.steps, eq_probe=args.eq_probe, eq_max=args.eq_max, sample_interval=args.interval, seed=args.seed, eta_low=eta_low, eta_low_spin_wave=eta_spin_wave, xi_high=xi_high, ) logger.info(f'Data saved to {npz_path}')
if __name__ == '__main__': main()