Instrukcja SWDR4/en

System Wspomagania Dyżurnego Ruchu 4 (SWDR4) is a browser-based application linked to the Train Driver 2 simulator, based on the SWDR system previously used by PKP Polskie Linie Kolejowe (currently replaced by EDR – Electronic Traffic Register). SWDR4 enables train traffic to be managed based on timetables created for specific trains, containing the train route along with planned arrival and departure times. It is also used for communication between dispatchers, as well as between dispatchers and drivers, and for registering delays of trains with an active timetable. SWDR4 is available as a web application accessible from a browser on both computers and mobile devices. To start using SWDR4, you must first run at least one scenery in dispatcher mode in the simulator. Then, log in to the website rj.td2.info.pl using the login and password used to launch the simulator. SWDR4 allows you to control train traffic on all available servers: PL1 (main server), PL2 (secondary server for training and sessions), DE (German server), CZ (Czech server), and ENG (test server).

SWDR4 operation

Login window

The SWDR4 login window allows you to choose between two main modes of operation: dispatcher mode and editor mode. First one is used to control train traffic. Logging in into this mode without at least one scenery running will result in automatic kick from the system. The second mode is intended for authors of sceneries in order to enter scenery data into the system (after passing the scenery verification process using the Gitlab platform).

Login window

Dispatcher mode

After successfully logging in a list of sceneries launched by the user will be shown. If you have launched a scenery and it is not visible, wait a moment and refresh the page, making sure that the scenery is also visible on the right side of the list of all users and that you have selected proper server on which the scenery is running, and its state is not "NIEWPISANA DO SWDR4" (not registered into the system). In this case, you have a scenery with a wrong hash. This may happen due to an update to the scenery or its withdrawal.

view of the login window after succesfull scenery detection

---

Chat tab

After logging into the system with at least one scenery running, the user is taken to the "Chat" tab. Here, there is a chat window for dispatchers, a notification window, information about recent violations and tables with active dispatchers and trains in the simulator.

Dispatcher's chat

The chat window and the text input field below it are used for real-time communication between logged-in users. By default, all messages sent are public, meaning that they are visible to all dispatchers. In addition, you may encounter messages highlighted in color in the chat:

• Red - system messages and messages published by SWDR4 administrators,
• Green - communication with train drivers (messages sent with the /swdr command from the simulator),
• Blue - private messages (visible only to the sender and reciever, system messages e.g. approaching end of duty).

Dispatcher's chat window with messages from users

To send a private message to another dispatcher or train driver, click on their username from the list below the chat window or select them directly by clicking on their avatar before sending the message. You can also manually enter the name or number of the train by typing it in the input field with the sign (@) at the beginning.

Notifications

The notification window displays system information regarding changes in the hourly status of dispatchers, the removal of timetables and information about derailments.

Notification window

Railway traffic safety

Between the chat and notification windows and the tables with active users, there is a section called Railway Traffic Safety. Here you can find out who, when, and where recently passed a red signal or derailed on a given server.

Railway traffic safety section

Online dispatchers

The Online Dispatchers contains a list of all active users acting as a dispatchers on a given server, along with their status, language and expearience level.

Table with active dispatchers on the PL1 server

After logging into the system, the player is required to set the statuses of the sceneries which they are running using the buttons located in the "Status" column next to their nickname on the scenery list. Not setting the appropriate status will result in the player being kicked out of the system after a certain amount of time and will prevent them from creating and reciving new timetables.

Statuses available to dispatchers in the SWDR4 system:

• Availavble - dispatcher is available until the time specified in the status, or without limit; until then, they are required to accept trains and handle traffic at their sceneries,
• Be right back - dispatcher temporarily unavailable at the computer; prevents the creation of timetables
• Finishing soon - dispatcher is finishing their duty; status set automatically when the scheduled duty time has passed,
• No space - dispatcher is available, but the scenery cannot accept more trains due to excessive traffic,
• Unavailable - dispatcher has not yet set its status, but has logged in the SWDR4 system.

Trains online

The trains online contains a list of active train drivers on the selected server, along with information about the train number, speed, user level, their language, and location in a given region. Trains that are offline for some reason (e.g. due to loss of internet connection) are marked with a red cross - the user is then likely to have no contact with other traffic participants.

Trains online table on PL1 server

Similar to the dispatcher list, clicking on the user name (driver) opens a pop-up menu allowing, among other things, sending a message (to which the driver can reply with the command /swdr).

---

Timetable tab

The timetable tab shows sceneries with active trains and their timetables. Depending on the scenery, there may be oione, two or even several stations that need to be updated on an ongoing basis as trains are being dispatched. Correctly updating the data in this tab is crucial for informing other dispatchers about the situation with trains passing through sceneries.

After logging into the system, this tab will usually be empty due to the lack of active timetables. It may also happen that staffed station has been left by a previous dispatcher with existing positions still in place. Over time (and depending on the traffic situation on the server), the tab will begin to fill with information about trains passing through stations.

Timetable preview

This tab displays timetables for stations and signal boxes on sceneries launched by the user. Unlike previous versions of SWDR, there is no longer a single timetable for several stations one one scenery - all stations and signal boxes are listed separately in the timetables.

When at least one timetable is set, it will be displayed in the table of signal boxes which it runs through. The timetable table contains basic information about the train:

• K / NK - (Kursuje / Nie Kursuje) Running / Not Running - shows whether the driver with a given number is online or offline (for example, due to a lack of internet connection),
• PRZYJAZD - (Arrival) - shows scheduled and actual arrival time of the train and its expected delay / advancements in minutes,
• UWAGI - (Notes) - additional notes about the cargo being transported - "TWR" (high - risk dangerous goods) / "TN" (dangerous goods) / "PN" (special shipments),
• RODZ - Train category - when you hover over it with the cursor, full name will be shown,
• NUMER - train number,
• MASZYNISTA - nickname of the train's driver
• TRASA - (Route) - shows from which scenery and route the train will arrive, which route it will enter your scenery, and to which scenery and route it should be sent,
• POSTÓJ - (Stop) - scheduled stop of the train at a given station (ph - mandatory stop for passanger trains, pt - technical stop that can be skipped, pm - shunting such as locomotive run - around or cab change for multiple units); no stop means that the train is not scheduled to stop,
• ODJAZD - (Departure) - scheduled and actual train departure time and its expected delay / advancements in minutes,
• RELAJCA - (Total train route) - total train route i.e. its starting and ending points.

Dispatched trains from the station are marked with a green background color in the table.
Stopped trains at the station are marked with an orange color in the scheduled departure column.
Trains that have completed their journey are marked with a red background in the table - system automatically deletes them after several seconds.

Timetable table with (from the top) dispatched train, stopped train and not - dispatched train

Each of the tables can be collapsed at any time using the button to the left of the signal box name. The button with the eye icon on the right allows you to hide and show cleared trains. The number of all and hidden timetables is shown next to the station name.

Timetable generation

The dispatcher in Train Driver 2 is responsible not only for managing existing timetables, but also for creating them for drivers who do not yet have them. This is done using the buttons at the top of the tab, which allow you to generate timetables in two modes - automatic and manual.

Automatic mode

Automatic mode allows you to quickly list several timetable proposals for selected driver. To scelect this mode, use the "New timetable (auto)" button, which opens a new generator window. Here, select the train for which you want to create a timetable and complete the data based on the provided analysis and inspection of the train:

• Train number,
• Train type - it determines train type for later selection of the proper category (passanger, freight, light loco or other),
• Train category - if you have trouble selecting a category, ask the driver to clarify it or refer to the gelper located next to the buttons for creating timetables,
• Rolling stock type - type of vehicle driven by the driver,
• Starting point - starting point from which the timetable will be created,
• Starting route - route on the scenery towards which the new timetable will be created,
• Maximum number of sceneries - maximum number of sceneries through which the schedule will run,
• Departure in [min] - minimum departure time from the starting point (if for example the train has to be moved from the sidings to the platforms, take into account the estimated time for shunting!),
• Train timetable speed - maximum speed of the train, which should not exceed the operating speeds available for the vehicles; reference in the form of table with speeds,
• Lenght of the train - value automatically updates based on the selected train,
• TWR (high - risk dangerous goods) / Dangerous goods (TN) / Special shipments (PN) - selected in case of a consist carrying additional information related to safety and / or the transport of specyfic goods (forum thread explaining TWR and TN)

Automatyczne generowanie rozkładu jazdy

Po naciśnięciu przycisku “Generuj rozkład jazdy” i poprawnym uzupełnieniu danych (w przeciwnym przypadku pojawi się informacja z błędami, które należy poprawić) pojawi się 10 gotowych propozycji trasowań. Postaraj się dobrać taką propozycję, która nie przewiduje długich postojów (chyba, że maszynista zadeklarował chęć na takowe). Możesz również ręcznie edytować już gotowy rozkład jazdy z podanej listy i dołożyć do niego dodatkowe scenerie lub zmienić ich kolejność.

Przykład automatycznie wygenerowanego rozkładu jazdy

Tryb ręczny

Tryb ręczny to nieco bardziej zaawansowana forma generowania rozkładu jazdy. Do wybrania tego trybu służy przycisk “Nowy rozkład (ręcznie)”. Informacje na górze okna wybieramy identycznie jak w/w przy trybie automatycznym, z pominięciem maksymalnej ilości scenerii i punktów początkowych.

Po uzupełnieniu informacji o pociągu należy ułożyć przebieg trasy nowego rozkładu jazdy. Za pomocą przycisku “Dodaj trasę” znajdującego się w dolnej części okna dobieramy początkową scenerię i szlak wyjazdowy, a następnie tym samym przyciskiem uzupełniamy trasę o kolejne elementy. Podgląd gotowego rozkładu wyświetli się pod przebiegiem, o ile jest on ułożony poprawnie i nie zawiera błędów (takich jak na przykład: zła liczba torów na połączonych ze sobą szlakach, dyżurny kończący służbę przed czasem przyjazdu na scenerię, długość składu nieprzyjmowana na danym posterunku ruchu). Miej na uwadze długość postojów i czas przejazdu pomiędzy sceneriami.

Ręczne generowanie rozkładu jazdy

Po poprawnym wygenerowaniu danych naciskamy przycisk “Wybierz rozkład”, za pomocą którego zostanie wysłany do maszynisty w symulatorze. Po chwili powinien pokazać się także na liście posterunków dyżurnych ruchu, przez które ma ułożoną trasę.

Zarządzanie rozkładami

Wszystkie opcje edycji rozkładu są dostępne klikając lewym przyciskiem myszy na dany rozkład pod wybranym posterunkiem:

• Szczegóły rozkładu - dodatkowe informacje o rozkładzie jazdy maszynisty

• Wprowadzanie godzin - moduł do aktualizowania czasów przyjazdu, odjazdu i postoju pociągu

• Aktualizuj rozkład - moduł do aktualizowania parametrów rozkładu jazdy (numeru pociągu / kategorii) lub jego usunięcia w szczególnych przypadkach

• Skopiuj numer pociągu - opcja pomocnicza do szybkiego skopiowania numeru do schowka

• Wiadomość do następnej scenerii - opcja pomocnicza kopiująca numer pociągu do schowka oraz otwierająca okno z wiadomością prywatną do kolejnego dyżurnego na trasie pociągu, np. w celu poinformowania go o odjeździe pociągu

Zarządzanie rozkładami klikając lewym przyciskiem myszy na dany rozkład pod wybranym posterunkiem

Moduł do aktualizowania parametrów rozkładu jazdy (numeru pociągu / kategorii) lub jego usunięcia w szczególnych przypadkach

---

Zakładka Blokady liniowe

Dyżurny ruchu ma także za zadanie zajmować się blokadami liniowymi na swoich sceneriach, co zapewnia bezpieczeństwo ruchu i uniemożliwia wysłanie dwóch pociągów na ten sam tor szlakowy. W systemie SWDR4 realizowane jest to za pomocą repliki systemu Eap-94, jednak poszczególne szlaki i scenerie mogą mieć inne typy blokad liniowych.

Każda sceneria posiada swój zestaw blokad liniowych dla szlaków zewnętrznych, po jednej dla każdego toru szlakowego. Dla szlaków dwutorowych, po lewej stronie wylistowane są blokady dla torów w kierunku przeciwnym do zasadniczego (“lewych”), natomiast po prawej dla torów w kierunku zasadniczym (“prawych”). Pamiętaj, że ruch kolejowy w Polsce jest prawostronny, a jazda po torze “lewym” odbywa się na specjalnych warunkach po uprzednim uzgodnieniu tego z dyżurnym ruchu kolejnej scenerii, do której wysyłasz pociąg. W przypadku szlaków jednotorowych nie istnieje rozróżnienie toru prawego i lewego.

Widok blokad liniowych dla jednej ze scenerii

Blokady liniowe można obsługiwać za pomocą SWDR4, jednak zalecana jest ich obsługa z poziomu pulpitów SCS, SPK lub SPE w przypadku scenerii, które takowe sterowanie posiadają, w szczególności dla szlaków z samoczynną blokadą liniową (SBL).

Podstawowa obsługa blokad liniowych za pomocą repliki Eap-94 w systemie SWDR4

W celu wyprawienia pociągu do następnej scenerii należy wykonać następujące kroki:

• 1. Z listy rozkładów jazdy dowiadujemy się o scenerii docelowej i szlaku, na który chcemy wysłać pociąg (kolumna TRASA / PRZEZ oraz DO SCENERII):
  

Przykładowo: z powyższego zrzutu możemy odczytać, że chcemy wysłać pociąg na nasz szlak SR, a docelową scenerią będzie LCS Żywiec i szlak Mil

• 2. Przekierowujemy się do odpowiedniego szlaku i toru na naszej scenerii, a następnie z listy wybieramy docelową scenerię i szlak:
  

500px|thumb|centruj|Wybrana docelowa scenerie i szlak

• 3. Jeśli jest to szlak jednotorowy - pytamy o pozwolenie dyżurnego na połączenie blokady dla danego pociągu, wysyłając mu wiadomość prywatną o treści: Czy droga dla pociągu <nr pociągu> jest wolna? i dopiero po odpowiedzi o wolnym szlaku naciskamy “Połącz” i używamy czerwonego przycisku “Wbl”.W przypadku szlaku dwutorowego - dla pociągu planowego możemy od razu użyć opcji “Połącz” i “Wbl”.

Połączona blokada liniowa

• 4. Przez resztę procesu podążamy zgodnie z obsługą blokady liniowej Eap-94. Szczegóły na temat jej działania i obsługi możemy znaleźć w artykule wikipedii (należy lekko zjechać do sekcji z graficznymi wyjaśnieniami stanów blokady).
• 5. W przypadku szlaku z półsamoczynną blokadą liniową (PBL): po opuszczeniu scenerii przez wysłany pociąg połączenie blokady zostanie automatycznie zakończone (jeśli nie zmieniono opcji obsługi przycisku dKo w ustawieniach systemu). Jest to efekt zamierzony - blokada dla scenerii docelowej nadal będzie założona, natomiast dla scenerii wysyłającej pociąg zresetuje się do stanu początkowego w celu zwiększenia przepustowości! Dla szlaku z samoczynną blokadą liniową (SBL), połączenie zostanie zakończone po zajęciu przez pociąg drugiego odstępu SBL szlaku wyjazdowego do następnej scenerii.

W momencie przyjmowania blokady od posterunku, który wysyła do nas pociąg i użycia przycisku “Wbl” przez poprzedniego dyżurnego, zakładka “Blokady liniowe” w pasku nawigacyjnym zacznie migać oraz uruchomi się dzwonek blokady. Po jej obsłużeniu miganie oraz dźwięk zostaną zatrzymane.

---

Edytor wpisów scenerii

Zakładka Scenerie

Główne okno edytora wpisów zawiera listę wpisanych przez użytkownika scenerii wraz z informacją, czy dana sceneria została zaakceptowana. Dla każdej scenerii wyszczególnione są zdefiniowane trasy oraz biała i czarna lista użytkowników, które można edytować wpisując nazwy dyżurnych.

Jeśli sceneria zawiera co najmniej jednego gracza na białej liście - tylko gracze z białej listy będą mogli uruchomić scenerię. Jeśli biała lista jest pusta - sceneria może być prowadzona przez wszystkich użytkowników - pod warunkiem, że nie otrzymali oni indywidualnej blokady poprzez wpisanie ich na czarną listę dyżurnych.

Główne okno edytora składa się z trzech sekcji

• Elementy składowe
• Trasy
• Ograniczenia prędkości

Budowę nowego wpisu należy rozpocząć od zdefiniowania wszystkich elementów składowych, takich jak:

• Szlaki zewnętrzne (tzw. "lasek" - łączące z innymi sceneriami),
• Stacje i posterunki odgałęźne
• Przystanki osobowe
• Szlaki wewnętrzne (łączące ze sobą stacje i przystanki)
• Prace manewrowe

Każda sceneria musi zawierać co najmniej jeden szlak zewnętrzny. Przebiega on od miejsca wjazdu na scenerię do pierwszego punktu widocznego w rozkładzie, np. do przystanku osobowego. Dla jazdy wewnątrz scenerii (np. z przystanku na główną stację) należy zdefiniować szlaki wewnętrzne. Jeśli na danej scenerii przewiduje się wykonywanie prac manewrowych w celu wyjazdu na dany szlak (np. stacje czołowe, węzłowe) - należy zdefiniować pracę manewrową i określić minimalny czas potrzebny na jej wykonanie. EZT, SZT i lokomotywy luzem mają przypisany skrócony czas manewrów ze względu na ograniczenie do zmiany kabiny. Dla szlaków wewnętrznych zaleca się stosować nazwy skrótowe opisujące jakie elementy łączy dany szlak wewnętrzny, np "TrMa" dla szlaku Truskawka - Malina.

Każdy z elementów składowych pozwala zdefiniować charakterystyczne dla danego typu właściwości, np. czas postoju na stacji, czas pracy manewrowej, długość szlaku, ilość torów szlaku itd. Prawidłowe wykonanie pomiarów długości szlaków ma wpływ na prawidłowe obliczenia czasów przejazdu pociągów. W przypadku stacji o dużej rozpiętości należy przyjąć zasadę, że szlaki kończą i zaczynają się w miejscu obsługi, np. w środku długości peronu czy na środku długości bocznicy towarowej.

Od niedawna jest dostępna opcja tworzenia posterunków odstępowych, które dla maszynisty nie są widoczne w rozkładzie jazdy, a powodują zwiększenie przepustowości na szlakach z samoczynną blokadą liniową (w skrócie SBL). Tworzy się je poprzez wybranie opcji "Posterunek odstępowy" z dostępnych elementów, a następnie nazwanie go jako SBL_XY, gdzie XY to nazwy semaforów SBL stanowiące nasz domniemany posterunek odstępowy. Należy jednak pamiętać o umiejętnym tworzeniu tych posterunków, ponieważ zbyt gęsta ich ilość może wpłynąć negatywnie na przepustowość szlaku i czasy przejazdu (SWDR daje minimalny czas 1 minutę na przejazd między 2 punktami na trasie). Przyjmuje się, że minimalna długość takiego odstępu wynosi tyle, ile może przejechać pociąg z maksymalną prędkością szlakową w czasie 1 minuty. Przykładowo, na szlaku z maksymalną prędkością 160 km/h minimalna długość odstępu, dająca realne czasy przejazdu na szlaku, to ok. 2666 metrów. Oczywiście wartości można, a nawet należy zwiększać, aby wychodziły one idealnie między parami semaforów SBL zwróconych do siebie plecami.

Po utworzeniu elementów składowych należy zdefiniować trasy przejazdu przez daną scenerię. Trasa to narzucona kolejność pokonywania elementów scenerii przez pociąg. Należy osobno zdefiniować trasy w kierunku A > B oraz B > A. W tym celu można skorzystać z przycisków "skopiuj trasę" oraz "odwróć trasę". Po dodaniu elementu do trasy, kolejność jego położenia można zmienić metodą przeciągnij & upuść.

Sekcja ograniczenia prędkości pozwala zdefiniować istniejące na scenerii ograniczenia. Ze względu na możliwość występowania ograniczeń podczas jazdy tylko w jednym kierunku, należy określić kierunek występowania ograniczenia. Przyjmuje się, że dla szlaków dwutorowych jazda odbywa się zawsze torem prawym, a dla szlaków jednotorowych - ograniczenie można wpisać w obu kierunkach.

Efekty pracy w edytorze można zapisać lokalnie (w pamięci przeglądarki) lub zgłosić jako gotowy wpis do SWDR4. Przed zapisem w SWDR4 wpis zostanie sprawdzony pod kątem występujących błędów. Jeśli wpis będzie wymagał poprawek, ich lista zostanie przedstawiona w podsumowaniu.

---

Zakładka Hashe

Przykładowy wpis scenerii z wpisanymi i zaakceptowanymi już hashami scenerii i pulpitów

Razem z wydaniem wersji 2022.2.1 "Latarnia" do SWDR została dodana funkcja samodzielnego dodawania hashy scenerii i pulpitów do akceptacji w bazie wpisów. W tej zakładce po wykonaniu wpisu scenerii pojawia nam się tabela ze sceneriami posiadającymi wpis w SWDR. Wybieramy wtedy do takiej scenerii opcję "Aktualizuj hashe", a następnie w przeznaczonym do tego miejscu wklejamy hash naszej scenerii, a w części z pulpitami, wpisując odpowiednią etykietę (SCS, SPK, SPE, RASP lub SUP), dodajemy odpowiadające etykiecie hashe. Gdy wykonamy wszelkie te czynności, wysyłamy hashe do bazy do akceptacji. Wszelkie zmiany w hashach plików scenerii należy uwzględnić w tickecie scenerii na Gitlabie.