Trade flow routing on multi-modal networks

[thomas-fred]

Merge in work from World Bank project to open-gira.

Main features:

• Allocation of flows from a trade OD matrix across multi-modal network. Flows are between target country road nodes and partner countries. Trade flows have a volume (tonnes) and a monetary value ($).
• Disruption of network due to generic hazard raster (value exceeding configurable threshold). Can then allocate flows on the degraded network for comparison.

[tomalrussell]

Thanks for preparing this to merge. Are the following inputs everything that is not (yet) produced by other rules? (i.e. everything in "{OUTPUT_DIR}/input/..." should be provided.

# Maritime network
# workflow/transport/maritime/maritime.smk
        nodes = "{OUTPUT_DIR}/input/networks/maritime/nodes.gpq",
        edges_no_geom = "{OUTPUT_DIR}/input/networks/maritime/edges_by_cargo/maritime_base_network_general_cargo.pq",
        edges_visualisation = "{OUTPUT_DIR}/input/networks/maritime/edges.gpq",

# Project-specific road and rail network, hazard footprint
# workflow/transport/multi-modal/multi_modal.smk
        road_network_nodes = "{OUTPUT_DIR}/input/networks/road/{PROJECT_SLUG}/nodes.gpq",
        road_network_edges = "{OUTPUT_DIR}/input/networks/road/{PROJECT_SLUG}/edges.gpq",
        rail_network_nodes = "{OUTPUT_DIR}/input/networks/rail/{PROJECT_SLUG}/nodes.gpq",
        rail_network_edges = "{OUTPUT_DIR}/input/networks/rail/{PROJECT_SLUG}/edges.gpq",

        raster = "{OUTPUT_DIR}/hazard/{HAZARD_SLUG}.tif",

# Trade OD (nodes to partner country)
# workflow/transport/flow_allocation/allocate.smk
        od = "{OUTPUT_DIR}/input/trade_matrix/{PROJECT_SLUG}/trade_nodes_total.parquet",

[thomas-fred]

The road and rail edges can be prepared by other rules, but they will need to be moved/copied to the input paths you list to be used as inputs for the new rules. I will document this briefly.

[thomas-fred]

@tomalrussell I've added some docs. I'll merge this now. Once you've incorporated your OD generation we can release again for a DOI and let Tim know.