Skip to main content

An open-source tool for collecting railway codes used in different UK rail industry systems.

Project description


Python Version Documentation Status License Codacy Badge Zenodo

PyRCS is an open-source Python package designed to simplify the collection and management of diverse codes used in different systems within the UK rail industry. It serves as a practical toolkit for researchers, practitioners, and individuals who frequently interact with the Railway Codes website and work extensively with railway codes in the UK. Leveraging the capabilities of the Python programming language, PyRCS enables efficient access to and manipulation of railway code data, enhancing productivity and effectiveness in working with these codes.

During installation, PyRCS includes a set of pre-packaged data. When users request data from a specific category listed on the Railway Codes website, PyRCS automatically loads the corresponding pre-packaged data for that category by default. Additionally, it provides functionality that enables direct access to the latest data from the data source website, ensuring users can stay updated with the most current information. Furthermore, PyRCS users can conveniently update the relevant pre-packaged data, keeping their data resources synchronized with the latest developments.

With PyRCS, users can leverage Python's power to streamline workflows and enhance productivity when working with railway codes in the UK rail industry.


To install the latest release of pyrcs from PyPI via pip:

pip install --upgrade pyrcs

Please also refer to Installation for more information.

Quick start

For a concise guide on how to utilise PyRCS, we recommend checking out the quick-start tutorial, which features multiple illustrative examples for three frequently used code categories in the UK railway system:


The complete PyRCS documentation: [HTML] [PDF].

It is hosted on ReadTheDocs and provides a wealth of detailed examples.


PyRCS is licensed under GNU General Public License v3 or later (GPLv3+).


PyRCS uses data available from the Railway Codes website. The time and effort that the website's editor and all contributors put in making the site and data available are fully credited.

Cite as

Fu, Q. (2020). PyRCS: an open-source tool for collecting railway codes used in different UK rail industry systems. Zenodo. doi:10.5281/zenodo.4026744

  author       = {Qian Fu},
  title        = {{PyRCS: an open-source tool for collecting railway
                   codes used in different UK rail industry systems}},
  year         = 2020,
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.4026744},
  url          = {}

(Please also refer to the export options from Zenodo to reference the specific version of PyRCS as appropriate.)


Qian Fu
Qian Fu

🌱 💻 🧪 📖


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyrcs-0.3.7.tar.gz (1.9 MB view hashes)

Uploaded Source

Built Distribution

pyrcs-0.3.7-py3-none-any.whl (2.2 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page