Brazil Pix Paper Replication Package

# Brazil Pix JFSR Final Paper Replication Package This package reproduces the empirical tables, figures, and key output checks for the final JFSR paper on local banking structure and business use of Brazil's Pix instant-payment system. ## Contents - `code/`: Python scripts for cleaned-data and raw-data replication. - `data/cleaned/`: frozen processed data for the cleaned-data path. - `docs/`: data sources, codebook, raw upload list, and table/figure crosswalk. - `reference_outputs/`: reference JFSR tables, figures, table/figure crosswalk, in-text numbers, and checksums. No manuscript files are included. ## Environment Create an environment with either pip or conda: ```bash python3 -m venv .venv source .venv/bin/activate python3 -m pip install -r requirements.txt ``` ```bash conda env create -f environment.yml conda activate brazil-pix-replication ``` ## Path 1: Frozen Processed Data Run this one-liner from the package root: ```bash python3 code/run_cleaned.py --output outputs_from_cleaned && python3 code/check_outputs.py --outputs outputs_from_cleaned ``` This path uses `data/cleaned/analysis_data.parquet` and the other frozen processed files in `data/cleaned/`. It reproduces all final-paper JFSR tables and figures in: - `outputs_from_cleaned/jfsr_tables/` - `outputs_from_cleaned/jfsr_figures/` - `outputs_from_cleaned/jfsr_docs/` Expected runtime on a modern laptop is roughly 30-60 minutes. ## Path 2: Uploaded Raw Public Data Upload every file listed in `docs/raw_files_to_upload.csv` to the listed `required_upload_path`, preserving filenames and folders. Then run this one-liner from the package root: ```bash python3 code/run_raw.py --output outputs_from_raw && python3 code/check_outputs.py --outputs outputs_from_raw ``` The raw upload list contains 204 public files totaling about 835 MB. The raw path rebuilds the municipality-month analysis panel and then reproduces the same final-paper outputs. ## Output Checks `code/check_outputs.py` compares generated JFSR tables against `reference_outputs/jfsr_tables/` and verifies required figure files, the JFSR table/figure crosswalk, the in-text-number file, and the output checksum file.