Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Content

Table of Contents

Calendar-objects

Definition of Service Calendar defines days, daytypesdayType, operational  operational periods and other calendar items, as well as the connections between them, are done in a Service Calendar. These definitions are further used in the (mainly) in the Timetable setup to  to specify when a Line is operatedoperates.

The entire XML sample file is located on the project's XML example in it its entirety can be found in the GitHub repository: https://github.com/entur/profile-norway-examples/blob/master/netex/schedule/ServiceCalendar-example.xml

Elements

Below is a more detailed description of the most important elements of modeling modelling a calendar object.

...

Note that this is only a simplified

...

example of NeTEx XML

...

.

See example for simple stopplace, bus for XML containing other necessary items to be valid according to the profile.

PublicationDelivery

All XML files according to the Norwegian NeTEx profile should be of type PublicationDelivery containing relevant Frames. (See GitHub for a complete example.)

Info

Description of the dummy ServiceFrame and TimetableFrame in the example is only made included to indicate a complete PublicationDelivery.

ServiceCalendarFrame

All calendar objects are defined in a ServiceCalendarFrame. It can be done in a ServiceCalendar object, but given that most components are often reused across timeplanerthe dataset, it is recommended to define these directly in ServiceCalendarFrame.

ServiceCalendarFrame
Code Block
languagexml
titleServiceCalendarFrame
collapsetrue
<ServiceCalendarFrame version="any" id="RUT:ServiceCalendarFrame:1">
	<ServiceCalendar version="any" id="RUT:ServiceCalendar">
		<Name>Ukedager<<Name>Weekdays</Name>
		<FromDate>2016<FromDate>2019-04-01</FromDate>
		<ToDate>2016<ToDate>2019-08-31</ToDate>
	</ServiceCalendar>
[...]

dayTypes

Definition of Defining day type day by which weekdays the daytype applies. The type can be further clarified with additional features, e.g. holiday type, if applicablemeans of weekdays.

Code Block
languagexml
<dayTypes>
	<DayType version="any" id="RUT:DayType:weekdays">
		<Name>Ukedager</Name>
		<properties>
			<PropertyOfDay>
				<DaysOfWeek>Monday Tuesday Wednesday Thursday Friday</DaysOfWeek>
			</PropertyOfDay>
		</properties>
	</DayType>
	[...]
</dayTypes>

timebands

Timeband shows time indication.

  • StartTime

    and EndTime or Duration specify period

    and EndTime or Duration specify the period span.

  • If StartTime and EndTime are equal

    , this

    it specifies a specific time. E.

    Eg

    g.

    When

    when specifying a

    specific time each hour

    repeating hourly departure (in Rhythmical Journey), this is indicated by a consistent

    hour

    time of "00".

Code Block
languagexml
<timebands>
	<Timeband version="any" id="RUT:Timeband:TM15">
		<!--Name>15 minutes past the hour</Name-->
		<StartTime>00:15:00</StartTime>
		<EndTime>00:15:00</EndTime>
	</Timeband>
</timebands>

operatingDays

Specification of an operating day, possibly also the start and length of an operating day. Can be linked to a daytypedayType , e.g. 637370378Kalender#dayTypeAssignments.

Code Block
languagexml
<operatingDays>
	<OperatingDay version="any" id="RUT:OperatingDay:default:1">
		<CalendarDate>2016-05-01</CalendarDate>
		<EarliestTime>10:10:00</EarliestTime>
		<DayLength>PT12H45M</DayLength>
	</OperatingDay>
	<OperatingDay version="any" id="RUT:od:default:2">
		<CalendarDate>2016-07-07</CalendarDate>
		<EarliestTime>11:11:00</EarliestTime>
		<DayLength>PT9H10M</DayLength>
	</OperatingDay>
</operatingDays>

operatingPeriods

Specification of an operating period, based on previously defined start and end days.

Code Block
languagexml
<operatingPeriods>
	<OperatingPeriod version="any" id="RUT:op:default">
		<FromOperatingDayRef ref="RUT:OperatingDay:default:1"/>
		<ToOperatingDayRef ref="RUT:od:default:2"/>
	</OperatingPeriod>
</operatingPeriods>

dayTypeAssignments

Attaching a daytype dayType to a specific date or pre-defined OperatingDay/Period for a given calendar, ie a daytype i.e. a dayType will be valid within the time period specified by the calendar object to which it is associated.

...