Introduction

Welcome to the user documentation for Paiagram 0.1.3.

Have you ever wondered how transportation works? As the author of Paiagram, I don’t know! But I created Paiagram¹ because I think it would be fun to create my own timetable software, and in addition, my own timetables. Paiagram is a simple tool to make transport timetables and visualize them.

Paiagram can help you on…:

• Making timetables for your model transportation system
• Visualizing and simulating vehicle movement at any given time point
• Diagnosing your timetables.
• Maybe more?

Paiagram is not an all-in-one tool where you would find every single feature related with timetabling. However, if you do want something to be added into the program, feel free to open a ticket!

Getting Started

You can use the web version or the desktop version. The web version runs on Chromium 113+. Latest versions of Firefox and Safari are also supported, although they might run at a lower framerate. Despite the fact that Paiagram supports Linux and Windows, we do not provide a pre-compiled version just yet. You would, unfortunately, have to compile the desktop version yourself.

If you have any trouble using the application, feel free to ask in GitHub discussions, or in our QQ group chat: 865211882.

The performance gap between the web version and the desktop version when processing small datasets is usually acceptable. To give you a rough idea of how performant the app is, here are some very inaccurate, for-reference-only benchmarks:

• OuDiaSecond (Windows version, via Wine, which taxes the CPU a bit) runs at some PowerPoint level framerate on my i9-13900HX laptop after loading the sample.oud2 file. The app lags whenever I scroll down the timetable or the diagram, regardless of how many items are displayed on the screen.
• This app runs at ~30fps on my classmate’s Chromebook’s Chrome browser after loading the same sample.oud2 dataset. The app only lags when there are too many elements displayed on the screen, but even so the app still feels quite responsive.

In some cases, the web version runs faster than the native version (e.g. a poorly configured Linux laptop).