PoW Modeling

This repository is set up for GitBook Git Sync. The main rendered document is:

• Stale Block and Fork Rate Analysis

GitBook reads README.md as the documentation homepage and SUMMARY.md as the table of contents. The report embeds committed PNG files with relative paths, so the page can be opened directly from the GitBook sidebar or from its page link.

Recreate the plots

Run the commands below from this repository root.

python3 archive/plot_tau_eff_intuition.py
python3 archive/plot_stale_rate_explainers.py
python3 plot_experiment_results.py

The scripts require Python with matplotlib, numpy, and pandas available.

The archived explainer scripts regenerate:

• tau_eff_intuition.png
• stale_rate_probability_model.png
• block_time_and_stale_expectations.png
• reach_proxy_tau_eff.png

The experiment plotting script regenerates:

• experiment_block_propagation.png
• experiment_block_times.png
• experiment_competing_blocks_per_height.png
• experiment_stale_height_rates.png
• experiment_stale_height_rate_proxy.csv
• experiment_results_summary.json

plot_experiment_results.py defaults to experiment data at /home/evan/src/zcash/experiments/valar-1/data. To use a different checkout or exported data directory, set POW_MODELING_DATA_DIR:

POW_MODELING_DATA_DIR=/path/to/valar-1/data python3 plot_experiment_results.py

The model helper, deprecated exploratory scripts, and no-longer-used plot outputs are kept in archive/ so the document root contains the current Markdown and embedded figures.