================================================================================
SUPPLEMENTARY SOFTWARE: BMCM-ILQ MACROECONOMIC ADULTERATION QUANTIZATION PIPELINE
================================================================================
Manuscript: ISOTOPIC EVIDENCE OF SYSTEMIC ECONOMICALLY MOTIVATED ADULTERATION IN SERBIA: Empirical Loss Quantization and Bounded Macroeconomic Projections
Target Journal: Nature Food

1. ENGINE & SOFTWARE REQUIREMENTS
---------------------------------
This computational pipeline requires Python software to execute. The codebase 
is fully verified, tested, and optimized for Python version 3.11.9.

If Python is not installed on your system, please download and install the official 
release for your operating system from: https://python.org

2. SYSTEM DEPENDENCIES & ENVIRONMENT SETUP
------------------------------------------
Before running the scripts, the core data science libraries must be installed. 
Open your terminal or command prompt and run the following automated installation command:

  pip install numpy matplotlib scipy

Required core library versions (minimum baseline tested):
- numpy (>= 1.20.0)
- matplotlib (>= 3.4.0)
- scipy (>= 1.7.0)

3. COMPONENT STRUCTURE
----------------------
The execution framework is modularized into three distinct scripts to decouple 
programmatic data load and ensure cross-platform graphic stability:

- `part1_bayesian.py`: Drives the micro-level forensic inference engine, processes 
  the dynamic Bayesian update layers, and tracks Markov Chain Monte Carlo (MCMC) 
  convergence diagnostic tracking (Gelman-Rubin R-hat parameters).
- `part2_montecarlo.py`: Runs the 10,000-iteration empirical log-normal Monte Carlo 
  risk simulations and structural parameter variance monitoring for all four targeted matrices.
- `part3_tornado_figure4b4c.py`: Computes and maps the analytical Tornado sensitivity 
  index layouts, handles historical macroeconomic trajectory back-casting, and directly 
  renders figures 4b and 4c.

4. EXECUTION INSTRUCTIONS
-------------------------
To replicate and compile the entire research portfolio, open your terminal or 
command prompt inside this source directory and execute the scripts sequentially:

  python part1_bayesian.py
  python part2_montecarlo.py
  python part3_tornado_figure4b4c.py

5. OUTPUT LOGISTICS
-------------------
All generated high-resolution assets (.png, 200 DPI, publication-ready) are 
automatically compiled and saved to the local workspace destination directory:
C:\Gotovi_Grafikoni_za_Nature

*Note for Mac/Linux Reviewers: The scripts utilize standard cross-platform absolute 
paths. If directory creation permissions are restricted on C:\, please adjust the 
`target_dir` variable on line 12 of all three scripts to your local workspace path.*
================================================================================
