/transport-network-performance

Measuring the performance of transport networks around urban centres

Primary LanguagePythonMIT LicenseMIT

Repository status is still in development (caution required) Build status badge on mac Build status badge on linux Build status badge on windows Integration Tests Docs status badge

transport-network-performance

⚠️ This repository is still in the development phase. Caution should be taken before using or referencing this work in any way - use it at your own risk.

Introduction

About

Describe what this repo contains and what the project is.

Developers

We welcome contributions from others. Please check out our code of conduct and contributing guidance.

Installation

Describe technical set-up. Such as the required dependencies.

Pre-commit actions

This repository contains a configuration of pre-commit hooks. These are language agnostic and focussed on repository security (such as detection of passwords and API keys). If approaching this project as a developer, you are encouraged to install and enable pre-commits by running the following in your shell:

  1. Install pre-commit:

    pip install pre-commit
    
  2. Enable pre-commit:

    pre-commit install
    

Once pre-commits are activated, whenever you commit to this repository a series of checks will be executed. The pre-commits include checking for security keys, large files and unresolved merge conflict headers. The use of active pre-commits are highly encouraged and the given hooks can be expanded with Python or R specific hooks that can automate the code style and linting. For example, the flake8 and black hooks are useful for maintaining consistent Python code formatting.

NOTE: Pre-commit hooks execute Python, so it expects a working Python build.

Usage

Explain how to use the things in the repo.

Workflow

You may wish to consider generating a graph to show your project workflow. GitHub markdown provides native support for mermaid, an example of which is provided below:

flowchart TD
   id1[(Some data)] --> id2(Some processing)
   id3[(More data)] --> id2
   id2 --> id4[Some output]

Data Science Campus

At the Data Science Campus we apply data science, and build skills, for public good across the UK and internationally. Get in touch with the Campus at datasciencecampus@ons.gov.uk.

License

The code, unless otherwise stated, is released under the MIT Licence.

The documentation for this work is subject to © Crown copyright and is available under the terms of the Open Government 3.0 licence.