This package combines classic work on Input-Output economics1 with transport costs2 and changes over time to estimate trade between different geographic regions (cities or towns or even MSOAs).
To begin we infer UK city Input-Output tables from national Input-Output tables by weighting on city employment data per sector and simply the distance between cities (as a crow flies).
This is a proof of concept and much more work is needed to reach the level of detail we would like. Suggestions and contributions (preferably GitHub issues) are welcome.
We use geopandas and it will be necessary to install some system pacakges to manage this. GDAL is often the main source of difficulty. Via debian linux distros you should be able to simply install the library without modificaitons. On macOS via homebrew you can install that with
$ brew install gdalSee fiona and geopandas documentation for more information, and feel free to raise a ticket.
We use pyproject.toml with poetry to manage dependencies.
With poetry version >=1.2 simply downloading a zip of this package or a git clone should be enough to set up a local environment. Below is an example using poetry:
$ poetry init
$ poetry add path/to/estios.zipOnce the local poetry environment is created, run
$ poetry run estios server --no-auth
MAPBOX access token not found in local .env file.
Starting dash server with port 8090 and ip 127.0.0.1 at /uk-cities
Server running on: http://127.0.0.1:8090/uk-cities
Warning: publicly viewable without authentication.in the environment folder3 to model trade flow between 10 English cities to generate a web visualisation available locally at http://127.0.0.1:8090/uk-cities for quarters of 2017. The estimates will be calculated on the fly then cached, and should be ready when
INFO: Uvicorn running on http://127.0.0.1:8090 (Press CTRL+C to quit)is printed in the terminal.
Note: Without
--no-autha login dropdown will appear prior to the visualisation. This provides a very thin layer of security to ease testing prior to a public release. Usernames and passwords are managed in ajsonfile (by defaultuser_db.json). Documentation on that (and much more) to come.
Copyright 2022 The Alan Turing Institute, British Library Board, Queen Mary University of London, University of Exeter, University of East Anglia and University of Cambridge.
See LICENSE for more details.
This repo contains and uses data from the UK Office of National Statistics under the Open Governance License and the Organisation for Economic Co-operation and Development (OECD)
This software has been developed as part of two UK Research and Innovation (UKRI) Strategic Priorities Funded projects:
- AI for Science and Governance (ASG), specifically Wave 1 of ASG under the Engineering and Physical Sciences Research Council (EPSRC), specifically the Digital Twins: Urban Analytics theme. Grant reference: EP/W006022/1
- Living with Machines, funded under the Arts and Humanities Research Council (AHRC), with The Alan Turing Institute, the British Library and the Universities of Cambridge, East Anglia, Exeter, and Queen Mary University of London. Grant reference: AH/S01179X/1
We are grateful for the extensive advice and support from colleagues across both projects.
Footnotes
-
Leontief, Wassily. Input-Output Economics. Oxford, UNITED STATES: Oxford University Press, Incorporated, 1986. http://ebookcentral.proquest.com/lib/manchester/detail.action?docID=4701165. ↩
-
Wilson, A G. ‘A Family of Spatial Interaction Models, and Associated Developments’. Environment and Planning A: Economy and Space 3, no. 1 (1 March 1971): 1–32. https://doi.org/10.1068/a030001. ↩
-
The
MAPBOX access token not found in local .env filewarning indicates you aren't using a registered Mapbox token. This shouldn't prevent you from running locally, but you may need one if you wish to run this publicly. The easiest solution is to add a.envfile withMAPBOX=THE-TOKENin the directory you run in. More details forthcoming. ↩