# PyRCS
[](https://www.python.org/downloads/)
[](https://pyrcs.readthedocs.io/en/latest/?badge=latest)
[](https://github.com/mikeqfu/pyrcs/blob/master/LICENSE)
[](https://app.codacy.com/gh/mikeqfu/pyrcs/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
[](https://zenodo.org/badge/latestdoi/92501006)
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](http://www.railwaycodes.org.uk/index.shtml) 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](https://pyrcs.readthedocs.io/en/latest/installation.html), PyRCS includes a set of pre-packaged data. When users request data from a specific category listed on the [Railway Codes](http://www.railwaycodes.org.uk/index.shtml) 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.
## Installation
To install the latest release of pyrcs from [PyPI](https://pypi.org/project/pyrcs/) via [pip](https://pip.pypa.io/en/stable/cli/pip/):
```bash
pip install --upgrade pyrcs
```
Please also refer to [Installation](https://pyrcs.readthedocs.io/en/latest/installation.html) for more information.
## Quick start
For a concise guide on how to utilise PyRCS, we recommend checking out the [quick-start tutorial](https://pyrcs.readthedocs.io/en/latest/quick-start.html), which features multiple illustrative examples for three frequently used code categories in the UK railway system:
* [Location identifiers](http://www.railwaycodes.org.uk/crs/CRS0.shtm) (CRS, NLC, TIPLOC and STANOX codes)
* [Engineer’s Line References](http://www.railwaycodes.org.uk/elrs/elr0.shtm) (ELRs) and their associated mileage files
* [Railway station data](http://www.railwaycodes.org.uk/stations/station1.shtm) (mileages, operators and grid coordinates)
## Documentation
The complete PyRCS documentation: [[HTML](https://pyrcs.readthedocs.io/en/latest/)\] \[[PDF](https://pyrcs.readthedocs.io/_/downloads/en/latest/pdf/)].
It is hosted on [ReadTheDocs](https://readthedocs.org/projects/pyrcs/) and provides a wealth of detailed examples.
## License
PyRCS is licensed under [GNU General Public License v3](https://github.com/mikeqfu/pyrcs/blob/master/LICENSE) or later (GPLv3+).
## Acknowledgement
PyRCS uses data available from the [Railway Codes](http://www.railwaycodes.org.uk/index.shtml) website. The time and effort that the website's editor and [all contributors](http://www.railwaycodes.org.uk/misc/acknowledgements.shtm) 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](https://doi.org/10.5281/zenodo.4026744)
```bibtex
@software{qian_fu_pyrcs_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 = {https://doi.org/10.5281/zenodo.4026744}
}
```
(Please also refer to the export options from [Zenodo](https://zenodo.org/search?page=1&size=20&q=conceptrecid:%224026744%22&sort=-version&all_versions=True) to reference the specific version of PyRCS as appropriate.)
## Contributors
<!--suppress HtmlDeprecatedAttribute -->
<table>
<tbody>
<tr>
<td align="center">
<a href="https://github.com/mikeqfu" target="_blank"><img src="https://avatars.githubusercontent.com/u/1729711?v=4?s=100" width="100px;" alt="Qian Fu"/><br><sub><b>Qian Fu</b></sub></a><br>
<a href="https://github.com/mikeqfu/pyrcs" target="_blank" title="Seeding">🌱</a>
<a href="https://github.com/mikeqfu/pyrcs/commits?author=mikeqfu" target="_blank" title="Code">💻</a>
<a href="https://github.com/mikeqfu/pyrcs/tree/master/tests" target="_blank" title="Tests">🧪</a>
<a href="https://pyrcs.readthedocs.io/en/latest/" target="_blank" title="Documentation">📖</a>
</td>
<td align="center">
<a href="https://github.com/Firtun" target="_blank"><img src="https://avatars.githubusercontent.com/u/75030535?v=4?s=100" width="100px;" alt="Firtun"/><br><sub><b>Firtun</b></sub></a><br>
<a href="https://github.com/mikeqfu/pyrcs/commits?author=Firtun" target="_blank" title="Documentation">📖</a>
</td>
</tbody>
</table>
Raw data
{
"_id": null,
"home_page": "https://github.com/mikeqfu/pyrcs",
"name": "pyrcs",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "Python,Railway Codes,Railway,Bridges,CRS,NLC,TIPLOC,STANOX,Electrification,ELR,Mileage,LOR,Stations,Signal boxes,Tunnels,Viaducts,Depots,Tracks",
"author": "Qian Fu",
"author_email": "q.fu@bham.ac.uk",
"download_url": "https://files.pythonhosted.org/packages/b0/74/dee1efdd71800498f6c1763b1e5aed200f4e27fa6094e0fe1b0476b84694/pyrcs-0.3.7.tar.gz",
"platform": "nt",
"description": "# PyRCS\r\n\r\n[](https://www.python.org/downloads/)\r\n[](https://pyrcs.readthedocs.io/en/latest/?badge=latest)\r\n[](https://github.com/mikeqfu/pyrcs/blob/master/LICENSE)\r\n[](https://app.codacy.com/gh/mikeqfu/pyrcs/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)\r\n[](https://zenodo.org/badge/latestdoi/92501006)\r\n\r\nPyRCS 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](http://www.railwaycodes.org.uk/index.shtml) 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.\r\n\r\nDuring [installation](https://pyrcs.readthedocs.io/en/latest/installation.html), PyRCS includes a set of pre-packaged data. When users request data from a specific category listed on the [Railway Codes](http://www.railwaycodes.org.uk/index.shtml) 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.\r\n\r\nWith PyRCS, users can leverage Python's power to streamline workflows and enhance productivity when working with railway codes in the UK rail industry.\r\n\r\n## Installation\r\n\r\nTo install the latest release of pyrcs from [PyPI](https://pypi.org/project/pyrcs/) via [pip](https://pip.pypa.io/en/stable/cli/pip/):\r\n\r\n```bash\r\npip install --upgrade pyrcs\r\n```\r\n\r\nPlease also refer to [Installation](https://pyrcs.readthedocs.io/en/latest/installation.html) for more information. \r\n\r\n## Quick start\r\n\r\nFor a concise guide on how to utilise PyRCS, we recommend checking out the [quick-start tutorial](https://pyrcs.readthedocs.io/en/latest/quick-start.html), which features multiple illustrative examples for three frequently used code categories in the UK railway system: \r\n\r\n* [Location identifiers](http://www.railwaycodes.org.uk/crs/CRS0.shtm) (CRS, NLC, TIPLOC and STANOX codes)\r\n* [Engineer\u2019s Line References](http://www.railwaycodes.org.uk/elrs/elr0.shtm) (ELRs) and their associated mileage files\r\n* [Railway station data](http://www.railwaycodes.org.uk/stations/station1.shtm) (mileages, operators and grid coordinates) \r\n\r\n## Documentation\r\n\r\nThe complete PyRCS documentation: [[HTML](https://pyrcs.readthedocs.io/en/latest/)\\] \\[[PDF](https://pyrcs.readthedocs.io/_/downloads/en/latest/pdf/)].\r\n\r\nIt is hosted on [ReadTheDocs](https://readthedocs.org/projects/pyrcs/) and provides a wealth of detailed examples.\r\n\r\n## License\r\n\r\nPyRCS is licensed under [GNU General Public License v3](https://github.com/mikeqfu/pyrcs/blob/master/LICENSE) or later (GPLv3+).\r\n\r\n## Acknowledgement\r\n\r\nPyRCS uses data available from the [Railway Codes](http://www.railwaycodes.org.uk/index.shtml) website. The time and effort that the website's editor and [all contributors](http://www.railwaycodes.org.uk/misc/acknowledgements.shtm) put in making the site and data available are fully credited.\r\n\r\n## Cite as\r\n\r\nFu, Q. (2020). PyRCS: an open-source tool for collecting railway codes used in different UK rail industry systems. Zenodo. [doi:10.5281/zenodo.4026744](https://doi.org/10.5281/zenodo.4026744)\r\n\r\n```bibtex\r\n@software{qian_fu_pyrcs_4026744,\r\n author = {Qian Fu},\r\n title = {{PyRCS: an open-source tool for collecting railway\r\n codes used in different UK rail industry systems}},\r\n year = 2020,\r\n publisher = {Zenodo},\r\n doi = {10.5281/zenodo.4026744},\r\n url = {https://doi.org/10.5281/zenodo.4026744}\r\n}\r\n```\r\n\r\n(Please also refer to the export options from [Zenodo](https://zenodo.org/search?page=1&size=20&q=conceptrecid:%224026744%22&sort=-version&all_versions=True) to reference the specific version of PyRCS as appropriate.)\r\n\r\n## Contributors\r\n\r\n<!--suppress HtmlDeprecatedAttribute -->\r\n<table>\r\n <tbody>\r\n <tr>\r\n <td align=\"center\">\r\n <a href=\"https://github.com/mikeqfu\" target=\"_blank\"><img src=\"https://avatars.githubusercontent.com/u/1729711?v=4?s=100\" width=\"100px;\" alt=\"Qian Fu\"/><br><sub><b>Qian Fu</b></sub></a><br>\r\n <a href=\"https://github.com/mikeqfu/pyrcs\" target=\"_blank\" title=\"Seeding\">\ud83c\udf31</a>\r\n <a href=\"https://github.com/mikeqfu/pyrcs/commits?author=mikeqfu\" target=\"_blank\" title=\"Code\">\ud83d\udcbb</a>\r\n <a href=\"https://github.com/mikeqfu/pyrcs/tree/master/tests\" target=\"_blank\" title=\"Tests\">\ud83e\uddea</a>\r\n <a href=\"https://pyrcs.readthedocs.io/en/latest/\" target=\"_blank\" title=\"Documentation\">\ud83d\udcd6</a>\r\n </td>\r\n <td align=\"center\">\r\n <a href=\"https://github.com/Firtun\" target=\"_blank\"><img src=\"https://avatars.githubusercontent.com/u/75030535?v=4?s=100\" width=\"100px;\" alt=\"Firtun\"/><br><sub><b>Firtun</b></sub></a><br>\r\n <a href=\"https://github.com/mikeqfu/pyrcs/commits?author=Firtun\" target=\"_blank\" title=\"Documentation\">\ud83d\udcd6</a>\r\n </td>\r\n </tbody>\r\n</table>\r\n",
"bugtrack_url": null,
"license": "GPLv3+",
"summary": "An open-source tool for collecting railway codes used in different UK rail industry systems.",
"version": "0.3.7",
"project_urls": {
"Bug Tracker": "https://github.com/mikeqfu/pyrcs/issues",
"Documentation": "https://pyrcs.readthedocs.io/en/0.3.7/",
"Homepage": "https://github.com/mikeqfu/pyrcs",
"Source": "https://github.com/mikeqfu/pyrcs"
},
"split_keywords": [
"python",
"railway codes",
"railway",
"bridges",
"crs",
"nlc",
"tiploc",
"stanox",
"electrification",
"elr",
"mileage",
"lor",
"stations",
"signal boxes",
"tunnels",
"viaducts",
"depots",
"tracks"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "382b9ef2227600fd9b3bf5ca54b48f6b1742ef53a52ea710b09469376f98dfb5",
"md5": "fd2dd9ebd9eecfe88655736e5d851a69",
"sha256": "5b922d0fe2962fa09ca1080f86fe8f476ecbfc658c6af90d7294c784b5aec069"
},
"downloads": -1,
"filename": "pyrcs-0.3.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fd2dd9ebd9eecfe88655736e5d851a69",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 2224093,
"upload_time": "2023-09-16T14:34:10",
"upload_time_iso_8601": "2023-09-16T14:34:10.247348Z",
"url": "https://files.pythonhosted.org/packages/38/2b/9ef2227600fd9b3bf5ca54b48f6b1742ef53a52ea710b09469376f98dfb5/pyrcs-0.3.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b074dee1efdd71800498f6c1763b1e5aed200f4e27fa6094e0fe1b0476b84694",
"md5": "ef347f154bf6c64cf6b7febb4b4dfba8",
"sha256": "4aecc1b844bd94cc520dc2fadcaf9457531c98abceb0d238bf2b098145497953"
},
"downloads": -1,
"filename": "pyrcs-0.3.7.tar.gz",
"has_sig": false,
"md5_digest": "ef347f154bf6c64cf6b7febb4b4dfba8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 1890102,
"upload_time": "2023-09-16T14:34:14",
"upload_time_iso_8601": "2023-09-16T14:34:14.520556Z",
"url": "https://files.pythonhosted.org/packages/b0/74/dee1efdd71800498f6c1763b1e5aed200f4e27fa6094e0fe1b0476b84694/pyrcs-0.3.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-16 14:34:14",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mikeqfu",
"github_project": "pyrcs",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "pyrcs"
}
JSON
