Skip to content

PMM Tools Documentation

Overview

pmm_tools provides a lightweight toolbox for constructing and manipulating symbolic Hamiltonians describing one-dimensional fermionic systems. The utilities focus on turning concise parameter dictionaries into consistent second-quantized models that can be explored analytically or fed into numerical pipelines.

Guiding ideas

  • Symbolic-first workflow – use SymPy objects to express on-site terms, interactions, and coupling patterns without hard-coding matrix elements.
  • Composable helpers – build repeatable chains (dot, ABS, Kitaev-like structures) from reusable parameter specifications.
  • Bridging to numerics – interface the symbolic Hamiltonians with the second_quantization ecosystem to extract matrices, parity operators, and spectral information.

What you can do next

  • Instantiate models from pmm_tools.models to generate tight-binding style Hamiltonians that include chemical potentials, superconducting pairing, spin-orbit coupling, and Coulomb interactions.
  • Explore the walkthrough in examples/usage.md for a guided tour covering both spinless and spinful chains.

This documentation site will grow to include worked examples, API references, and workflows for integrating the symbolic models with downstream solvers.