Skip to content

Commit

Permalink
README: various improvements (OpenRailAssociation#3057)
Browse files Browse the repository at this point in the history
- 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
multun authored Feb 1, 2023
1 parent 7e1fdcb commit c2c1fdb
Show file tree
Hide file tree
Showing 5 changed files with 375 additions and 33 deletions.
50 changes: 26 additions & 24 deletions README.md
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/">
Expand All @@ -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>
54 changes: 54 additions & 0 deletions assets/sponsors/european-union.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit c2c1fdb

Please sign in to comment.