Data and code for "Spin-incoherent Mott-Thouless pumps"

================================================================================
CODE AND DATA REPOSITORY
================================================================================

This repository contains the numerical simulation scripts, figure-generation 
code, and datasets associated with the manuscript:

"Spin-incoherent Mott-Thouless Pumps"
by Ajesh Kumar, Urban F. P. Seifert, Erez Berg, and Achim Rosch.

================================================================================
DIRECTORY STRUCTURE
================================================================================

├── codes/
│   ├── quarter_filling.py
│   ├── extract_J.py
│   ├── half_filling.py
│   └── figure_generation/
│       ├── fig2.py
│       ├── fig7.py
│       └── ...
└── data/
    ├── fig_data_2.txt
    ├── fig_data_7.txt
    └── ...

================================================================================
FOLDER: codes/
================================================================================

1. Simulation Scripts
---------------------
quarter_filling.py
    Simulates the time evolution of exact eigenstates of the initial Hamiltonian 
    at quarter-filling and calculates the time-dependent pumped charge by 
    integrating the current over time. Parallelized across parameter grids of 
    Hubbard interaction strength (U) and drive frequency (omega).
    - Data generated for: Figures 2, 9, 10, 11, and 12.

extract_J.py
    Calculates effective spin-exchange couplings at quarter-filling using a 
    three-site cluster. Projects the full many-body Hamiltonian onto the 
    low-energy spin sector.
    - Data and plots generated for: Figures 7 and 8.

half_filling.py
    Executes time-evolution simulations for the protocol described in the 
    half-filling section and outputs the time-dependent pumped charge.
    - Data generated for: Figure 13.

2. Figure Generation Scripts (`codes/figure_generation/`)
---------------------------------------------------------
Contains Python scripts named `fig<number>.py` used to process raw data files 
and render the publication-ready figures.

Notes on specific figure scripts:
- `fig9.py`: Set `selected_U_idx = 0` for the left panel and `selected_U_idx = 9` 
  for the right panel.

================================================================================
FOLDER: data/
================================================================================

Contains tab-delimited text files (.txt) with the raw numerical data for every 
plot presented in the paper.

- Naming convention: `fig_data_<FigureNumber>.txt`
- Subfigures: For multi-panel figures, subfigure identifiers or descriptive 
  tags (e.g., `_left`, `_right`, `a`) are included in the filename.
- File Format: Each file includes explicit header rows matching the physical 
  quantities, parameters, and axis labels used in the paper text.