CosmoHidden_lite

Minimal utilities to explore a 1D U(1) scalar finite-temperature effective potential and compute the tunneling action S(T) using cosmoTransitions path deformation. Built to support analyses in the paper 2501.14986.

What this provides

• U(1) model effective potential with tree-level, Coleman–Weinberg, and thermal pieces
• Counterterm fixing to keep the minimum and curvature at a chosen VEV
• Critical temperature Tc and curvature-flip temperature T0 finders
• Path-deformation tunneling action S3(T)/T and an S(T) spline interpolant
• A tutorial notebook to run end-to-end

Project layout

• CosmoHidden_lite/ package with U1model
• tutorial.ipynb notebook with a guided walk-through
• requirements.txt pinned dependencies

Install

• Python 3.10 is suggested (older/newer may work).
• Install dependencies from source:

pip install -r requirements.txt

Quickstart

• For a quick start, open tutorial.ipynb and run the cells top-to-bottom. It walks you through:
  • Importing the package and creating a U1model
  • Running Veffprecalc() to compute S(T) and build an interpolant
  • Plotting and inspecting T0, Tc, and S(T)

API at a glance

• Class CosmoHidden_lite.U1model(gx, lambdah, v, cutoff, Xi, verbose=True, **kwargs)
  • Parameters: gx (U(1) gauge coupling), lambdah (quartic), v (VEV scale), cutoff (renormalization scale), Xi (portal-like/gauge parameter), verbose (progress off)
  • Key attributes after Veffprecalc():
    • T0, Tc: temperatures where curvature flips / phases are degenerate
    • T_valsforS, S_vals: sampled grid and values of S(T)
    • S_interpolation(T): cubic spline interpolant over valid T
  • Useful methods:
    • Veffprecalc(): compute S(T) grid and spline
    • Findaction(T): compute S3(T)/T via path deformation
    • Vtot(X, T): cosmoTransitions-compatible 1D potential wrapper
    • V_original(phi, T, Xi): full effective potential

Citation

• If you use this repository, please cite the associated paper 2501.14986.

License

• See LICENSE for licensing information.