maritime-choke
An interactive model of the macroeconomic risk from maritime-chokepoint trade
disruptions. Close any set of the world's 12 major shipping chokepoints, pick a
(τ, ρ, ϱ, δ) calibration, solve a short-run production-network model forward, and
explore where the value-added loss falls — on an interactive world heat map, by
country, and by sector — all in a local browser GUI.
Based on the paper Macroeconomic Risks from Maritime Trade Disruptions (Veetil & Vemmarath). Source & data: https://bitbucket.org/VipinVeetil/chokepoints
Install
pip install maritime-choke
Run
maritime-choke run
That's it. On first launch this downloads the model cache (~90 MB, not shipped in the wheel; published on Zenodo, DOI 10.5281/zenodo.21263267) and then opens the GUI in your browser at http://127.0.0.1:5057. Stop it with Ctrl-C.
To pre-fetch the data on its own (e.g. offline prep), or install it from a local copy:
maritime-choke fetch-data
maritime-choke fetch-data --from-local /path/to/model_cache_2019
Pick chokepoints, set the calibration, hit Run scenario. The defaults are
the paper's baseline (τ, ρ, ϱ) = (0.3, −1, −1) with uniform leakage
δ = 0.10; the commodity-differentiated energy leakage (δ = 0.45 on
B05/B06/C19) is available as a toggle. Results are written
to a per-user folder (see maritime-choke where) and shown in the page:
world value-added loss, a relatable "scale of the loss" comparison, the world
heat map (recolour by any of 50 sectors), and per-country / per-sector drill-downs.
Commands
| command | what it does |
|---|---|
maritime-choke run |
launch the GUI (--port, --no-browser) |
maritime-choke fetch-data |
download/install the model cache (--url, --from-local, --force) |
maritime-choke pack-data <dir> |
pack a local cache into a .tar.xz for hosting |
maritime-choke where |
show data / cache / run-output locations |
maritime-choke build-data |
how to rebuild the cache from GTAP + OECD ICIO |
Data locations can be overridden with MARITIME_CHOKE_DATA (cache root) and
MARITIME_CHOKE_RUNS (run outputs). The download URL can be set with
MARITIME_CHOKE_DATA_URL.
Data & licensing
The model cache is derived from OECD ICIO (freely downloadable) and the licensed
GTAP 10 data base. The raw GTAP data is not redistributed; if you need to
rebuild the cache from scratch you must supply your own GTAP licence — see
maritime-choke build-data. The shipped map/comparison assets are built from
public Natural Earth and World Bank data.
License
MIT (code). Underlying GTAP and OECD ICIO data are governed by their own terms.
1 maintainer
Metadata
1 maintainer
Release files for maritime-choke 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| maritime_choke-0.3.0.tar.gz | 114.4 kB | Without provenance | Details for maritime_choke-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| maritime_choke-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for maritime_choke-0.3.0-py3-none-any.whl |
Total release size: 230.2 kB
Release files / maritime_choke-0.3.0.tar.gz
| Download URL | maritime_choke-0.3.0.tar.gz |
|---|---|
| Size | 114.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b547d462bb381e3a1cd6bc3af994c6026760ee3360cdebf0921f21a573998e0c
|
|
BLAKE2b-256 checksum How to use checksums |
5558eccbcc2a48a5777ab268797b662cdc0e91819ccc3dfccd82a4ab34bc7f69
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.0
|
Release files / maritime_choke-0.3.0-py3-none-any.whl
| Download URL | maritime_choke-0.3.0-py3-none-any.whl |
|---|---|
| Size | 115.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2d090c9b2eef63b7197fc7e5e1e0deaf1e9944b24845c6e63cf0af9eb16d84ef
|
|
BLAKE2b-256 checksum How to use checksums |
839143517ca4435488a034dd2145fe3b71c7803763be825d6a88954ca6862fbf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.0
|
Security for maritime-choke 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
