Dev:RailTopoModel

From wiki.railML.org
Jump to: navigation, search

UIC RailTopoModel

Introduction

"UIC and railML® act for creating the foundations for a Universal Infrastructure Data Exchange Format", that is the headline of UIC Press Release N°21 /2013 (external link, pdf). Further steps can be found on the railML website under the headline The development of the new railML 3 schema (link to the railML® website).

The development of railML3 is strongly tuned with the UIC ERIM workgroup in order to achieve a widely agreed basis for Infrastructure Managers to implement railML 3 for theirs needs.

Documentation

Modelling Concept

The first public version of the UIC RailTopoModel was published in on April 27, 2015.<ref name="RTM V1.0">http://documents.railml.org/science/270415_uic_railtopomodel_v1-0.pdf</ref>

This PDF document explains in detail, how the railway topology may be modelled by deploying the "graph of connexity".

For the acadamic background of the "graph of connexity" look at the "Computers in Railways XI" Proceedings or this document (external link, pdf).

UML Explanations

Please read the above mentioned PDF<ref name="RTM V1.0"/> carefully before getting to this UML staff here.

The following paragraphs may help to understand the intention of the proposed UML model and as a start for its documentation. All italic parts (questions) may be changed into explaining statements.

The conclusions should be written into the UML model itself, it provides documentation tags therefore.

Localisation part

Chapter 5.1 "Reference and Positioning System"<ref name="RTM V1.0"/>

Localisation UML diagram
NetworkResource

Defined as basic class, that provides the basic attributes:

  • uuid universal unique identifier, more than file-wide unique
  • name some string, that has no uniqueness constraint

This class works as super class for the following sub classes:

The sub classes inherit the above mentioned attributes from this super class.

The sub classes are a type of NetworkResource.

What is the reason for the generalization (chosen UML relation)?

This class is not abstract, it may be instantiated.

What is a real-world sample for this class?
PositioningSystem

From the UIC-RTM-PDF<ref name="RTM V1.0"/>: "This class defines the general concept of a Reference System."

This class is used as positioningSystem by Localisation.

This class inherits the following attributes:

  • uuid universal unique identifier, more than file-wide unique
  • name some string, that has no uniqueness constraint

Defined as basic class. It works as super class for the following sub classes:

The sub classes are a type of PositioningSystem, they further refine it.

This class is not abstract, it may be instantiated.

What is a real-world sample for this class?
IntrinsicPositioningSystem

From the Draft-PDF<ref name="RTM V1.0"/>: "This class defines a canonical linear referencing system for a LinearElement. It assigns "0" to the start and "1" to the end of the LinearElement. It references other LinearReferencingSystem in order to link to other reference systems."

BTW, the UML model at the end of the Draft-PDF shows the relation between the IntrinsicPositioningSystem and the LinearElement.
Where are the values "0" and "1" for the LinearElement defined? No attributes or constraints are given.
Other LinearReferencingSystems are referred with use of the intermediate AssociatedLinearSystem.

This class contains one or more AssociatedLinearSystems.

If only one AssociatedLinearSystem is given, how about the real length between the start and end of the IntrinsicPositioningSystem?
How about multiple AssociatedLinearSystem? Are they used as supporting points? That would allow for varying stretch factors along one IntrinsicPositioningSystem.

This class inherits the following attributes:

  • uuid universal unique identifier, more than file-wide unique
  • name some string, that has no uniqueness constraint

This class is not abstract, it may be instantiated.

What is a real-world sample for this class?
LinearPositioningSystem
GeodeticPositioningSystem
AssociatedLinearSystem
Localisation
LinearLocalisation
GlobalLocalisation

<references/>