v0.4.1 Agentic SKILLS

What's Changed

• Add agent skill for using GIModel.jl by @mmikhasenko in #14
• Remove scratch notebooks and stale tutorial copy before release by @mmikhasenko in #15

Full Changelog: v0.4.0...v0.4.1

v0.4.0 GIModel.jl. First public release

First public release of GIModel.jl, a Julia implementation of the
Godfrey–Isgur relativized quark model for meson spectra, wavefunctions and
decays (S. Godfrey and N. Isgur, Phys. Rev. D 32, 189 (1985),
doi:10.1103/PhysRevD.32.189).

Highlights

• Meson spectra and wavefunctions from the full relativized Hamiltonian.
  Mesons are defined by quark flavors (Meson(mq, :c, :b)) and levels by
  explicit n^{2S+1}L_J multiplets. compute_spectrum returns a Spectrum
  with contribution breakdowns and mixing within each meson.
• Two independent solvers: a harmonic-oscillator basis and finite
  differences, which can be used to cross-check each other's convergence.
• Isoscalar annihilation mixing (η–η′ and related sectors).
• GIModel.QuarkModelTransitions: radiative, leptonic, annihilation and
  strong transitions between resolved physical states. Includes helicity
  amplitudes, all allowed partial waves, charge radii and widths. The Eq. (19)
  strong-decay operator can be applied directly to solved wavefunctions, beyond
  the paper's single-β SU(6) approximation.
• GIPaper (companion package in GIPaper/): digitized 1985 reference data
  with provenance, and scripts that reproduce the paper's spectrum, mixing and
  Table IV/V decay results, plus residual reports.
• Documentation: https://mmikhasenko.github.io/GIModel.jl/dev/. It covers
  getting started, the model and its inputs, tutorials (charmonium, heavy-light
  mixing, charm-to-bottom limit, η–η′, strong decays) and the paper
  reproduction, including the mixing-angle discrepancy in the 1985 figure
  captions.
• LearningTrack: a pen-and-paper course from radial quantum mechanics to
  the complete spectrum algorithm.

Installation

Requires Julia ≥ 1.11.

    using Pkg
    Pkg.add(url = "https://github.com/mmikhasenko/GIModel.jl")
    using GIModel
    params, mq = load_parameters_and_quark_masses(default_parameters_path())
    spec = compute_spectrum(params, Meson(mq, :c, :c); levels = spectrum_levels(1))

Citation

If you use GIModel.jl, please cite the original work (Godfrey & Isgur 1985).
An accompanying paper is on arXiv on 1/10/2206, see link in README.md.
This release is also tagged with Zenodo DOI.

License

See LICENSE.

Learning sheets

PDFs built from commit ad44f11543293e81bc84d77f0162b664fb43fd7f. Updated after successful builds on main.

• 01_radial_quantum_mechanics.pdf
• 02_angular_momentum_and_mesons.pdf
• 03_variational_and_semirelativistic.pdf
• 04_color_confinement_running_coupling.pdf
• 05_relativization_and_smearing.pdf
• 06_spin_fine_structure.pdf
• 07_state_and_flavor_mixing.pdf
• 08_decay_observables.pdf
• 09_full_algorithm_capstone.pdf
• C1_computational_discovery.pdf