Obiekt node::track: Różnice pomiędzy wersjami

Z MaSzyna
Skocz do: nawigacja, szukaj
(Parametry opcjonalne)
Linia 216: Linia 216:
  
 
== Parametry opcjonalne ==
 
== Parametry opcjonalne ==
 +
Parametry opcjonalne zapisane są na samym końcu wpisu, między definicjami krzywych a słowem kluczowym ''endtrack''.
 +
Nazwę i wartość parametru zapisuje się zwyczajowo w jednej linii, a kolejne parametry - w kolejnych liniach.
 +
 
     <span style="color:orange;font-weight:bold">velocity</span> predkosc <span style="color:gray">// Maksymalna prędkość, z jaką AI przejedzie po tym torze.</span>
 
     <span style="color:orange;font-weight:bold">velocity</span> predkosc <span style="color:gray">// Maksymalna prędkość, z jaką AI przejedzie po tym torze.</span>
 
     <span style="color:orange;font-weight:bold">event0</span> nazwa_eventu <span style="color:gray">// Zdarzenie które zostanie uruchomione gdy obsadzony załogą dynamic stoi na torze.</span>
 
     <span style="color:orange;font-weight:bold">event0</span> nazwa_eventu <span style="color:gray">// Zdarzenie które zostanie uruchomione gdy obsadzony załogą dynamic stoi na torze.</span>

Wersja z 19:40, 4 kwi 2022

Definiuje odcinek trajektorii ruchu: drogi, tory, rzeki.

Każda definicja zaczyna się od parametrów definiujących podstawowe parametry wizualne i funkcjonalne trajektorii.

Pod tymi parametrami zapisane są parametry krzywych Beziera które opisują geometrię trajektorii.

Pod definicją krzywych znajduje się lista opcjonalnych parametrów.


Struktura wpisu

node range_max range_min name track type length width friction clatter_distance quality_flag damage_flag environment visibility
map1 map1_length map2 profile_parameter1 profile_parameter2 profile_parameter3
p1x p1y p1z roll1
cv1x cv1y cv1z
cv2x cv2y cv2z
p2x p2y p2z roll2
radius1
// opcjonalna druga krzywa beziera dla tylko dla skrzyżowań i zwrotnic!
p3x p3y p3z roll3
cv3x cv3y cv3z
cv4x cv4y cv4z
p4x p4y p4z roll4
radius2
// opcjonalne parametry w formie klucz-wartość
optionalparameter1 value1
optionalparameter2 value2
endtrack


Parametry funkcjonalno-wizualne

Opis parametrów
Nazwa Znaczenie
type Określa typ trajektorii.

Dostępne typy:

  • normal - tor
  • switch - zwrotnica
  • road - droga
  • cross - skrzyżowanie dróg
  • river - rzeka
  • tributary - skrzyżowanie rzek
  • turn - obrotnica (zobacz, jak zastosować)
  • table - obrotnica, przesuwnica, wywrotnica (nie działa)
length Długość toru [m].

Parametr nieużywany, aczkolwiek edytor Rainsted w to miejsce wpisuje kilometraż punktu 1.

width

Definiuje:

  • rozstaw szyn (dla typów normal, switch, turn, table)
  • szerokość jezdni (dla typów road, cross)
  • szerokość koryta rzeki (dla typów river, tributary)
friction Statyczny współczynnik tarcia.
clatter_distance Odległość powtarzania dźwięku stukotu kół na stykach.

Dla toru bezstykowego należy podać wartość 0.

quality_flag Ile ton/oś (?).
damage_flag Poziom uszkodzeń toru w formie maski bitowej.
  • 0 - tor przejezdny
  • 128 - tor uszkodzony (po najechaniu nastąpi wykolejenie)
environment Środowisko w jakim znajduje się trajektoria.

W zależności od środowiska zmienia się echo dźwięków.

  • flat - tor na otwartym terenie.
  • mountains/mountain - tor w górach.
  • canyon - tor w wykopie.
  • tunnel - tor w tunelu.
  • bridge - tor na moście/wiadukcie.
  • bank - ?
visibility Widoczność trajektorii.
  • unvis/novis - niewidoczna
  • vis - widoczna


Jeśli parametr visibility określa, że trajektoria jest widoczna, to należy podać kolejny zbiór parametrów. W przypadku gdy trajektoria jest niewidoczna, należy je pominąć:

Opis parametrów
Nazwa Znaczenie
map1 Ścieżka do materiału numer 1.

Określa materiał:

  • szyn (dla typów normal, turn, table)
  • szyn toru zasadniczego (dla typu switch)
  • nawierzchni drogi (dla typów road, cross)
  • wody w rzece (dla typów river, tributary)

Jeśli jako teksturę szyn podano none, to szyny staną się niewidoczne.

map1_length Odległość powtarzania mapowania materiałem map1 [m].

Jeśli materiał podany w map1 definiuje parametr size, to wartość z wpisu jest nadpisywana wartością z materiału.

map2 Ścieżka do materiału numer 2.

Określa materiał:

  • podsypki (dla typów normal, turn, table)
  • szyn toru zwrotnego (dla typu switch)
  • pobocza drogi/chodnika (dla typów road, cross)
  • brzegów rzeki (dla typów river, tributary)

Jeśli jako teksturę szyn podano none, to szyny staną się niewidoczne

profile_parameter1
  • wysokość pryzmy podsypki (dla typów normal, turn, table)
  • wysokość pobocza drogi/chodnika (dla typów road, cross).
  • wysokość brzegu rzeki (dla typów river, tributary)

W przypadku dróg podanie ujemnej wartości włączy generowanie chodników.

profile_parameter2
  • odległość od szyny do początku skosu podsypki (dla typów normal, turn, table)
  • szerokość pobocza dla drogi (dla typów road, cross).
  • szerokość chodnika po lewej stronie (dla typów road, cross), jeśli włączone jest generowanie chodników.
  • szerokość lewego brzegu rzeki (dla typów river, tributary)
profile_parameter3
  • szerokość skosu podsypki (dla typów normal, turn, table)
  • szerokość skosu pobocza drogi (dla typów road, cross).
  • szerokość chodnika po prawej stronie (dla typów road, cross), jeśli włączone jest generowanie chodników.
  • szerokość prawego brzegu rzeki (dla typów river, tributary)

Geometria toru

Geometria toru opisana jest za pomocą krzywej Beziera. Proste odcinki trajektorii, niebędące skrzyżowaniami lub zwrotnicami, definiują tylko jedną krzywą.

Opis parametrów
Nazwa Znaczenie
p1x p1y p1z Współrzędne punktu P1.
roll1 Kąt przechyłki w punkcie P1
cv1x cv1y cv1z Współrzędne punktu kontrolnego CV1.
cv2x cv2y cv2z Współrzędne punktu kontrolnego CV2.
p2x p2y p2z Współrzędne punktu P2.
roll2 Kąt przechyłki w punkcie P2
radius1 Wartość promienia łuku dla pierwszej krzywej - wartość nieużywana.

W przypadku rozjazdów i skrzyżowań należy dodatkowo zdefiniować drugą krzywą. W rozjeździe i skrzyżowaniu trójwlotowym punkt 1 musi mieć takie same współrzędne jak punkt 3. W przypadku skrzyżowania czterowlotowego takiego wymogu nie ma.

Opis parametrów
Nazwa Znaczenie
p3x p3y p3z Współrzędne punktu P3.
roll3 Kąt przechyłki w punkcie P3
cv3x cv3y cv3z Współrzędne punktu kontrolnego CV3.
cv4x cv4y cv4z Współrzędne punktu kontrolnego CV4.
p4x p4y p4z Współrzędne punktu P4.
roll4 Kąt przechyłki w punkcie P4
radius2 Wartość promienia łuku dla drugiej krzywej - wartość nieużywana.

Parametry opcjonalne

Parametry opcjonalne zapisane są na samym końcu wpisu, między definicjami krzywych a słowem kluczowym endtrack. Nazwę i wartość parametru zapisuje się zwyczajowo w jednej linii, a kolejne parametry - w kolejnych liniach.

    velocity predkosc // Maksymalna prędkość, z jaką AI przejedzie po tym torze.
    event0 nazwa_eventu // Zdarzenie które zostanie uruchomione gdy obsadzony załogą dynamic stoi na torze.
    event1 nazwa_eventu // Zdarzenie które zostanie uruchomione gdy obsadzony załogą dynamic wjedzie na tor w kierunku punktu 1.
    event2 nazwa_eventu // Zdarzenie które zostanie uruchomione gdy obsadzony załogą dynamic wjedzie na tor w kierunku punktu 2.
    eventall0 nazwa_eventu // Zdarzenie które zostanie uruchomione gdy jakikolwiek dynamic stoi na torze.
    eventall1 nazwa_eventu // Zdarzenie które zostanie uruchomione gdy jakikolwiek dynamic wjedzie na tor w kierunku punktu 1.
    eventall2 nazwa_eventu // Zdarzenie które zostanie uruchomione gdy jakikolwiek dynamic wjedzie na tor w kierunku punktu 2.
    isolated nazwa_odcinka_izolowanego // Nazwa odcinka izolowanego, do którego tor należy
    overhead stan_jazdy_bezpradowej //0 - jazda bezprądowa; >0 opuszczenie pantografów i przejazd z zadanym ograniczeniem prędkości
    vradius promien // Promień łuku pionowego - nie zaimplementowano
    angle1 kat1 // Kąt ścięcia profilu od strony punktu 1 - nie zaimplementowano
    angle2 kat2 // Kąt ścięcia profilu od strony punktu 2 - nie zaimplementowano
    fouling1 ukres1 // Wskazanie modelu ukresu w kierunku 1 - nie zaimplementowano
    fouling2 ukres2 // Wskazanie modelu ukresu w kierunku 2 - nie zaimplementowano
    railprofile plik_z_profilem //odniesienie do pliku z definicją przekroju szyny
    trackbed material  // Nazwa materiału dla automatycznie generowanej podsypki 
    friction nazwakomorkipamieci //Modyfikator wartości tarcia zgodne ze wzorem: tarcie = wartosc bazowa * pierwsza wartosc liczbowa z komorki pamieci + druga wartosc bazowa z komorki pamieci