forked from OpenRailAssociation/osrd
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
README: various improvements (OpenRailAssociation#3057)
- move acknowledgements to the website - make the project's description clearer - add working getting started instructions - make generate-infra.sh load small_infra by default - add sponsor logos
- Loading branch information
Showing
5 changed files
with
375 additions
and
33 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,5 +1,5 @@ | ||
<p align="center"> | ||
<a href="https://github.com/DGEXSolutions/osrd"> | ||
<a href="https://osrd.fr/en/"> | ||
<img src="assets/branding/osrd_small.svg" width="200px" alt="OSRD logo"/> | ||
</a> | ||
<a href="https://publiccode.eu/"> | ||
|
@@ -15,43 +15,45 @@ | |
|
||
## What is OSRD? | ||
|
||
OSRD is a work in progress tool meant to help design and operate railway infrastructure. | ||
It's built around a simulator, which evaluates a timetable on a given infrastructure. | ||
OSRD is an open source web application for railway infrastructure design, | ||
capacity analysis, timetabling and simulation. | ||
|
||
It's free and open-source forever! | ||
|
||
## WARNING | ||
|
||
OSRD is still in the early stages of development. | ||
APIs can and will change (now is the time to make suggestions!). | ||
OSRD it not yet production ready. | ||
User and programming interfaces can and will change (now is the time to make suggestions!). | ||
Important features are missing. Documentation is sparse. | ||
Please don't build any serious projects with OSRD unless you are prepared to be broken by API changes. | ||
Please don't rely on OSRD unless you are prepared to deal with frequent changes. | ||
|
||
## Getting Started | ||
|
||
You'll need: | ||
- Docker | ||
- Docker Compose | ||
To compile and run the application with an example infrastructure: | ||
|
||
```sh | ||
docker-compose up | ||
``` | ||
|
||
## Contributing | ||
|
||
If you think OSRD doesn't quite fit your needs yet, but still believe it could, | ||
please [tell us about your needs](https://github.com/DGEXSolutions/osrd/issues/new). | ||
# build and run the entire stack | ||
docker-compose up -d --build | ||
|
||
Please consider committing resources to help development if you'd like to use OSRD in production. | ||
Code contributions are very welcome, and we'd love to work together to make this project better. | ||
# generate and load an example infrastructure | ||
python3 -m venv .venv | ||
source .venv/bin/activate | ||
pip install geojson-pydantic | ||
scripts/generate-infra.sh small_infra | ||
|
||
## Thanks | ||
# open the web app | ||
xdg-open http://localhost:3000/ | ||
``` | ||
|
||
We would like to thank: | ||
## Get in touch | ||
|
||
- Bjørnar Steinnes Luteberget, who wrote a very interesting thesis on the matter, | ||
as well as a [pretty impressive prototype](https://github.com/luteberget/junction) | ||
- Chat with us on IRC at [libera.chat#osrd](https://web.libera.chat/#osrd) | ||
- Email us at <[email protected]> | ||
|
||
## Contact | ||
## Sponsors | ||
|
||
You are interested in the project, and you want to know more? Contact us at <[email protected]>. | ||
<p align="center"> | ||
<img src="assets/sponsors/france-dot.svg" width="150px" height="150px" alt="Ministère chargé des Transports"/> | ||
<img src="assets/sponsors/european-union.svg" width="150px" height="150px" alt="European Union"/> | ||
<img src="assets/sponsors/sncf-reseau.svg" width="150px" height="150px" alt="SNCF Réseau"/> | ||
</p> |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Oops, something went wrong.