Skip to main content

Documentation Status PythonVersion Black

Transport Frames is a Python library designed for spatial transport analysis, offering tools to:

  • Generate transport frames based on drive graphs.

  • Identify priority roads by evaluating the expected popularity of routes between exit pairs.

  • Update drive graphs with new road connections, ensuring proper integration.

  • Grade territory polygons by analyzing distances to federal and regional roads.

  • Compute a weighted connectivity score for a region based on accessibility to transport services and road network quality.

  • Interpret accessibility scores into textual descriptions.

  • Aggregate administrative-level statistics by computing transport indicators at different spatial scales (regions, districts, etc.).

  • Analyze territory-specific indicators by using buffer-based calculations around the center of a given territory.

Features

Frame and Road Network Analysis

  • Constructs frames from drive graphs to analyze road connectivity.

  • Investigates priority roads based on estimated route popularity.

  • Updates transport graphs by adding new edges and ensuring seamless network connectivity.

Territory Grading and Connectivity

  • Grades territories based on proximity to federal and regional roads.

  • Computes connectivity values from road networks and accessibility to key transport services (bus stops, railways, airports, ports).

  • Assigns territory-wide scores to summarize transport accessibility.

Indicator Computation

The library calculates various transport indicators at different administrative levels (region, district, etc.), including:

  • Distance to regional centers

  • Distance to federal roads

  • Connectivity score (measuring how well a region is connected to the transport network)

  • Lengths of roads and railway paths

  • Road density (road length per area)

  • Service accessibility (bus routes, railway coverage, and general service accessibility)

  • Number of services (number of services inside or near a given territory)

  • Number of bus routes (number of bus routes intersecting the territory)

  • Distance to nature objects (water objects, nature reserves, etc.)

Installation

Transport_frames can be installed with pip:

pip install transport-frames

How to use

For the detailed tutorial on usage case see our examples.

The following Jupyter Notebooks illustrate core library functions:

  1. Graph Frame Creation → 1_graph_frame_creation.ipynb - Created graph from territory polygon. - Generates transport frames from drive graphs. - Identifies priority roads using network analysis.

  2. Indicator Computation → 2_indicators.ipynb - Computes transport indicators (road density, connectivity, admin center distances, etc.). - Aggregates statistics at area and territory levels.

  3. Territory grading → 3_criteria.ipynb - Assigns territory scores based on federal and regional roads accessibility. - Analyzes proximity to key infrastructure (bus stops, ports, airports). - Analyzes connectivity metrics of the territory. - Converts numeric scores into textual interpretations.

  4. Road Graph Updates → 4_road_adder.ipynb - Updates transport graphs with new roads and edges. - Analyzes connectivity improvement after graph modifications.

  5. Transport Provision → 5_transport_provision.ipynb - Calculates a transport provision index for each territory polygon. - Combines road and railway density, airport accessibility, and settlement area share into one metric.

Data

Before running the examples, one can use the data from examples/data directory. You can use your own data, but it must follow the structure described in the API documentation.

Documentation

Detailed information and description of Transport Frames is available in documentation.

Project Structure

The latest version of the library is available in the main branch.

The repository includes the following directories and modules:

  • transport_frames - directory with the library code:

    • graph - graph creation module

    • frame - creation of the frame and priority roads module

    • criteria - module for grading territory based on frame and criteria calculation

    • indicators - module for area and territory indicators calculation

    • road_adder - module for updating graph with new road edges

    • utils - module containing utulity functions and consts

  • tests pytest testing

  • examples examples of how methods work

  • docs - documentation sources

License

The project has BSD-3-Clause license

Contacts

You can contact us:

Metadata

Release files for transport-frames 2.0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for transport-frames 2.0.6
File Size Uploaded
transport_frames-2.0.6.tar.gz 38.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for transport-frames 2.0.6
File Interpreter ABI Platform
transport_frames-2.0.6-py3-none-any.whl Python 3 none any Details

Total release size: 76.3 kB

Release files / transport_frames-2.0.6.tar.gz

Download URL transport_frames-2.0.6.tar.gz
Size 38.7 kB
Tags Source
SHA-256 checksum
How to use checksums
eb76b761843fa59010f65e2e7d67e9dd0977d7f8a32762b0a073bb1ab3db742c
BLAKE2b-256 checksum
How to use checksums
1b3772964bf8e28d567d7bfcf8e7de90b1f0263eb9b2b8b0a177156705c43d9f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.15

Release files / transport_frames-2.0.6-py3-none-any.whl

Download URL transport_frames-2.0.6-py3-none-any.whl
Size 37.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
816742483c8360121d26d5808bdfe2168b3696fa031f66e823f5de08015a2386
BLAKE2b-256 checksum
How to use checksums
b259c7402603914594d84c045655f23c3c634d01b7bfc4f24feb7b2de59a44be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.15

Release history Release notifications | RSS feed

This release

2.0.6 This release

2 release files

2.0.5

2 release files

2.0.4

2 release files

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page