UCL / ioe-student-school-allocation

Public release of the code for paper 846 of AGILE2023
BSD 3-Clause "New" or "Revised" License
4 stars 2 forks source link
education parallelism python requests tfl-api

IOE Student School Allocation

This site demonstrates the capacitated p-median location-allocation mode developed for AGILE paper 846, Developing capacitated p-median location-allocation model in the spopt library to allow UCL student teacher placements using public transport.

This repository includes the code for the "App" to create an Origin-Destination matrix from a series of school and student postcodes (app on the figure below) and an example Jupyter Notebook demonstrating how this is applied in practice.

flowchart

This work was presented at AGILE 2023 by Nick Bearman & Levi Wolf.

Currently, (as at 06/06/2023) the new code developed for spopt is not integrated in to the main spopt version. There is currently a PR in progress for this at https://github.com/pysal/spopt/pull/374/.

Installation of pre-processing code

Install using pip:

python -m pip install -e .

You will also need to add a TfL API key, available from https://api-portal.tfl.gov.uk/. It is set in .envrc_sample export TFL_APP_KEY=

What you should do is

cp .envrc_sample .envrc

Then put in the key. Then run

source .envrc

Then re-run. You can check if it’s worked by running echo $TFL_APP_KEY, and export N_CORES=1.

Run using

tfl example_subject

For more details, see the Juypter Notebook example.