Home » railML newsgroups » railml.timetable » [railML3] Looking for a name for trainNumber
[railML3] Looking for a name for trainNumber [message #2706] Sun, 25 April 2021 18:04 Go to next message
Milan Wölke is currently offline  Milan Wölke
Messages: 139
Registered: April 2007
Senior Member
Hallo zusammen,

in unserem letzten Entwickler-Workshop zum Thema railML 3 haben wir uns mit der Modellierung von Zugnummern beschäftigt. Wir haben festgelegt, dass es in railML 3 eine Struktur geben soll, die es erlaubt verschiedene Aspekte einer Zugnummer zu bündeln. Konkret sieht das ganze wie folgt aus:

<trainNumber type="Commercial" issuerRef="refToOrganizationalUnit" number="theActualTrainNumber" variant="knownAsAdditionalTrainNumberInRailML2">
  <range start="refToItineraryPoint" end="refToOtherItineraryPoint"/>
</trainNumber>

Mit "type" kann die Art der Zugnummer bezeichnet werden, also ob es sich bspw. um eine kommerzielle Zugnummer, eine Nummer des Infrastrukturbetreibers oder etwa um eine Taf Tap Tsi Id handelt.
Mit "issuerRef" kann auf die Organisationseinheit verwiesen werden, die die Nummer vergeben hat.
Mit der Attribut "number" kann die eigentliche Zugnummer angegeben werden und mit "variant" können Züge, die die selbe Zugnummer führen, voneinander unterschieden werden.

Nun wurde in der Gruppe angeregt, anstelle von "number" oder "variant" andere Bezeichner zu verwenden, die möglicherweise auch international griffiger wären. Entsprechend bitte ich Euch mit diesem Post entsprechende Vorschläge zu machen, wie in railML 3 diese Attribute heißen sollen. Vorschläge aus der Gruppe waren: Annotation, Identification, Identifier und Name aber keiner dieser überzeugte letzten Endes. Bitte lasst und Eure Meinung wissen.

Gerne kann natürlich auch bzgl. des generellen Modellierungsansatzes zu Zugnummern kommentiert werden.

--

In our last developer workshop on railML 3, we discussed the modeling of train numbers. We determined that there should be a structure in railML 3 that allows to bundle different aspects of a train number. Concretely, the whole thing looks like this:

<trainNumber type="Commercial" issuerRef="refToOrganizationalUnit" number="theActualTrainNumber" variant="knownAsAdditionalTrainNumberInRailML2">
  <range start="refToItineraryPoint" end="refToOtherItineraryPoint"/>
</trainNumber>

"type" can be used to indicate the type of train number, i.e. whether it is, for example, a commercial train number, an infrastructure manager number or, say, a Taf Tap Tsi Train Id.
The "issuerRef" attribute can be used to refer to the organizational unit that issued the number.
The attribute "number" can be used to specify the actual train number and "variant" can be used to distinguish trains that have the same train number.

It was suggested in the group to use other identifiers instead of "number" or "variant", which might be more internationally catchy. Accordingly I ask you with this post to make appropriate suggestions, on how these attributes should be named in railML 3. Suggestions from the group were: Annotation, Identification, Identifier and Name but none of them was convincing after all. Please let us know your opinion.

Of course you are also welcome to comment on modeling approach to train numbers in general.


Best regards, Milan



Milan Wölke – Timetable scheme coordinator
railML.org (Registry of Associations: VR 5750)
Altplauen 19h; 01187 Dresden; Germany www.railML.org
Re: [railML3] Looking for a name for trainNumber [message #2713 is a reply to message #2706] Thu, 06 May 2021 15:13 Go to previous messageGo to next message
David Lichti is currently offline  David Lichti
Messages: 13
Registered: December 2020
Junior Member
Since the element is already called 'trainNumber', it may be enough to have the attribute name only describe its meaning with respect to the train number. In this case, I could think of 'primary' or 'main' as in 'primary train number' for the 'number' attribute. The 'variant' attribute could then be 'secondary' as in 'secondary train number'.
Re: [railML3] Looking for a name for trainNumber [message #2716 is a reply to message #2706] Mon, 10 May 2021 15:44 Go to previous messageGo to next message
Christian Rößiger is currently offline  Christian Rößiger
Messages: 59
Registered: March 2015
Member
Hallo,

mit den bestehenden Namen (number und variant) der Attribute bin ich im
Großen und Ganzen einverstanden. Ich würde aber die Frage stellen, ob
der Name des Elements geeignet ist. <trainNumber> klingt für mich schon
sehr stark nach einer operativer Zugnummer. Da das Element auch für
andere Nummern bzw. Bezeichner (verkehrliche Zugnummern,
Reservierungsnummern) eines Zuges bzw. Zugteils verwendet werden soll,
würde ich eine allgemeinere Bezeichnung bevorzugen. Mögliche
Bezeichnungen wären aus meiner Sicht:
- identifier
- code
- designation
In der Bezeichnung des Elements sollte sich auch wiederspiegeln, ob es
es sich um einen Identifikator handelt, der für jeden Zug / Zugteil
eindeutig ist oder ob es auch für Kategorisierungen (z.B.
Linienbezeichnung) verwendet werden kann. Diese Frage ist, soweit ich
mich erinnere, noch nicht abschließend entschieden worden.

Viele Grüße
Christian
------------------------------------------------------------ -------

Hello,

I broadly agree with the existing names (number and variant) of the
attributes. However, I would ask whether the name of the element is
suitable. <trainNumber> sounds very much like an operational train
number to me. Since the element is also to be used for other numbers or
identifiers (commercial train numbers, reservation numbers) of a train
or train part, I would prefer a more general name. Possible names from
my point of view would be:
- identifier
- code
- designation
The name of the element should also reflect whether it is an identifier
that is unique for each train / train part or whether it can also be
used for categorisations (e.g. line designation). As far as I remember,
this question has not yet been finally decided.

Best regards,
Christian

--
iRFP e. K. · Institut für Regional- und Fernverkehrsplanung
Hochschulstr. 45, 01069 Dresden
Tel. +49 351 4706819 · Fax. +49 351 4768190 · www.irfp.de
Registergericht: Amtsgericht Dresden, HRA 9347
Re: [railML3] Looking for a name for trainNumber [message #2954 is a reply to message #2716] Mon, 14 March 2022 12:33 Go to previous message
Milan Wölke is currently offline  Milan Wölke
Messages: 139
Registered: April 2007
Senior Member
Hi all,

we discussed this topic in the last timetable developer group telco. We decided to follow the suggestion of iRFP and renamed the element trainNumber to identifier. The corresponding collection elements have been renamed accordingly.

---

wir haben dieses Thema in der letzten Fahrplanentwickler-Gruppe Telco diskutiert. Wir haben beschlossen, dem Vorschlag von iRFP zu folgen und das Element trainNumber in identifier umzubenennen. Die entsprechenden Sammlungselemente wurden auch entsprechend umbenannt.


Best regards, Milan



Milan Wölke – Timetable scheme coordinator
railML.org (Registry of Associations: VR 5750)
Altplauen 19h; 01187 Dresden; Germany www.railML.org
Previous Topic: TT:blockPart: Semantic Constraint
Next Topic: [railML3.2]: Proposal for removal of xs:any elements
Goto Forum:
  


Current Time: Fri Mar 29 13:37:27 CET 2024