Skip to content

Add vehicle access equipments #949

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Robbendebiene wants to merge 14 commits into
base: next
Choose a base branch
from
Open

Add vehicle access equipments #949

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
e41fe7a
Add kneeling to AccessVehicleEquipment
Robbendebiene Jul 30, 2025
563fdab
Reuse PassengerEquipmentGroup in AccessVehicleEquipment and Passenger…
Robbendebiene Jul 30, 2025
4dc5287
Add BoardingEquipmentOperationGroup
Robbendebiene Jul 31, 2025
9eae37a
Add BoardingEquipmentHorizontalGapReductionGroup
Robbendebiene Aug 1, 2025
e0f4b6d
Add RetractableStepVehicleEquipment
Robbendebiene Aug 1, 2025
8fb1ddb
Add RampVehicleEquipment
Robbendebiene Aug 1, 2025
246177b
Add HoistVehicleEquipment
Robbendebiene Aug 1, 2025
5cdc2a0
Add OperatingRadius to HoistVehicleEquipment for completeness
Robbendebiene Aug 4, 2025
aa7c6e3
Add NumberOfTreads to solve modeling problems
Robbendebiene Aug 6, 2025
898a01d
Add vehicle boarding equipment examples
Robbendebiene Aug 6, 2025
8cce3f2
Rework Kneeling modelling
Robbendebiene Aug 13, 2025
da1df17
Add real ramp length to calculate the ramps slope
Robbendebiene Aug 13, 2025
6c98f70
Change EquipmentLength/EquipmentWidth terms to be more descriptive at…
Robbendebiene Aug 13, 2025
39711f9
Minor corrections
Robbendebiene Aug 14, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
139 changes: 139 additions & 0 deletions examples/functions/vehicle/Netex_vehicleEquipments_01.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,139 @@
<?xml version="1.0" encoding="UTF-8"?>
<PublicationDelivery xmlns="http://www.netex.org.uk/netex" xmlns:siri="http://www.siri.org.uk/siri" xmlns:gml="http://www.opengis.net/gml/3.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0" xsi:schemaLocation="http://www.netex.org.uk/netex ../../../xsd/NeTEx_publication.xsd">
<PublicationTimestamp>2010-12-17T09:30:47.0Z</PublicationTimestamp>
<ParticipantRef>SYS001</ParticipantRef>
<Description>Example of vehicle boarding equipments</Description>
<dataObjects>
<CompositeFrame version="any" id="CompositeFrame:1">
<frames>
<!--
If multiple boarding equipments are assigned to a vehicle, only one or the other is used in practice.
-->
<ResourceFrame version="any" id="ResourceFrame:1">
<equipments>
<!--
ICE with 1 built-in step and 1 foldable step
https://www.youtube.com/watch?v=AhU9sVWRblk
-->
<!-- Boarding without the folding step -->
<AccessVehicleEquipment version="any" id="AccessVehicleEquipment:1">
<NumberOfSteps>1</NumberOfSteps>
<BoardingHeight>0.5</BoardingHeight>
</AccessVehicleEquipment>
<!-- Boarding with the folding step -->
<RetractableStepVehicleEquipment version="any" id="RetractableStepVehicleEquipment:1">
<ExternalLength>0.2</ExternalLength>
<BoardingHeight>0.35</BoardingHeight>
<NumberOfTreads>1</NumberOfTreads>
<!-- Includes all steps required to board -->
<NumberOfSteps>2</NumberOfSteps>
</RetractableStepVehicleEquipment>
<!--
Tram with 3 (optional) foldable steps where the lowest step reaches out of the vehicle entrance
https://www.youtube.com/watch?v=rtugyMBb904
-->
<!-- Boarding without the folding steps -->
<AccessVehicleEquipment version="any" id="AccessVehicleEquipment:2">
<BoardingHeight>0.7</BoardingHeight>
</AccessVehicleEquipment>
<!-- Boarding with the folding steps -->
<RetractableStepVehicleEquipment version="any" id="RetractableStepVehicleEquipment:2">
<!-- Only the last step reaches out of the train, this is the only step contributing to the equipment length -->
<ExternalLength>0.2</ExternalLength>
<!-- Boarding height of the lowest folding step -->
<BoardingHeight>0.25</BoardingHeight>
<NumberOfTreads>3</NumberOfTreads>
<NumberOfSteps>3</NumberOfSteps>
<StepHeight>0.15</StepHeight>
</RetractableStepVehicleEquipment>
<!--
Stepless train entrance with sliding step
https://www.youtube.com/watch?v=5D-TWksvc3Y
-->
<RetractableStepVehicleEquipment version="any" id="RetractableStepVehicleEquipment:3">
<ExternalLength>0.2</ExternalLength>
<!-- If the gap is smaller than the full length of the sliding step, it can still be used as it automatically stops extending on impact. -->
<IsAdjustableLength>true</IsAdjustableLength>
<BearingCapacity>250</BearingCapacity>
<BoardingHeight>0.7</BoardingHeight>
<NumberOfTreads>1</NumberOfTreads>
<!-- The sliding step does not introduce any meaningful vertical height difference it just bridges the horizontal gap. -->
<NumberOfSteps>0</NumberOfSteps>
</RetractableStepVehicleEquipment>
<!--
Combi-ramp (electrical sliding ramp and manual fold out ramp)
https://www.hubner-group.com/news/pressemeldung/doppelrampe-fuer-doppelte-zuverlaessigkeit-bereits-in-madrid-und-oslo-huebner-transportation-entwickelt-hybrides-einstiegssystem-fuer-busse/
-->
<RampVehicleEquipment version="any" id="RampVehicleEquipment:1">
<Fixed>true</Fixed>
<IsAutomatic>true</IsAutomatic>
<AssistanceRequired>false</AssistanceRequired>
<InOperationDuration>PT8S</InOperationDuration>
<OutOperationDuration>PT8S</OutOperationDuration>
<ExternalLength>0.678</ExternalLength>
<ExternalWidth>0.917</ExternalWidth>
<BearingCapacity>350</BearingCapacity>
<Length>0.678</Length>
</RampVehicleEquipment>
<RampVehicleEquipment version="any" id="RampVehicleEquipment:2">
<Fixed>true</Fixed>
<IsAutomatic>false</IsAutomatic>
<AssistanceRequired>true</AssistanceRequired>
<ExternalLength>0.819</ExternalLength>
<ExternalWidth>1.004</ExternalWidth>
<BearingCapacity>350</BearingCapacity>
<Length>0.819</Length>
</RampVehicleEquipment>
<!--
Portable ramp
https://www.youtube.com/watch?v=FUpuUMP2U_k
-->
<RampVehicleEquipment version="any" id="RampVehicleEquipment:3">
<Fixed>false</Fixed>
<IsAutomatic>false</IsAutomatic>
<AssistanceRequired>true</AssistanceRequired>
<!-- ExternalLength is undefined due to the portability of the ramp. Ultimately the entrance determines how much of the ramp will be outside of the vehicle. -->
<ExternalWidth>1</ExternalWidth>
<BearingCapacity>350</BearingCapacity>
<Length>2</Length>
</RampVehicleEquipment>
<!--
Automatic double arm lift
https://www.youtube.com/watch?v=Kvycxhss2TA
-->
<HoistVehicleEquipment version="any" id="HoistVehicleEquipment:1">
<IsAutomatic>true</IsAutomatic>
<AssistanceRequired>true</AssistanceRequired>
<InOperationDuration>PT20S</InOperationDuration>
<OutOperationDuration>PT20S</OutOperationDuration>
<!-- This differs widely from the useable/inner width as the arms of the lift have to be taken into account as well -->
<ExternalLength>3</ExternalLength>
<ExternalWidth>1.2</ExternalWidth>
<BearingCapacity>500</BearingCapacity>
<InnerLength>1.5</InnerLength>
<InnerWidth>1</InnerWidth>
<!-- More than the actual boarding height as boarding height is measured from the top of the rail -->
<LiftingHeight>1.2</LiftingHeight>
</HoistVehicleEquipment>
<!--
Automatic tram lift
https://www.youtube-nocookie.com/embed/6pWkmiuln28?rel=0
-->
<HoistVehicleEquipment version="any" id="HoistVehicleEquipment:2">
<IsAutomatic>true</IsAutomatic>
<AssistanceRequired>false</AssistanceRequired>
<InOperationDuration>PT25S</InOperationDuration>
<OutOperationDuration>PT25S</OutOperationDuration>
<ExternalLength>0.4</ExternalLength>
<ExternalWidth>1</ExternalWidth>
<BearingCapacity>350</BearingCapacity>
<InnerLength>1.2</InnerLength>
<InnerWidth>1</InnerWidth>
<LiftingHeight>0.3</LiftingHeight>
</HoistVehicleEquipment>
</equipments>
</ResourceFrame>
</frames>
</CompositeFrame>
</dataObjects>
</PublicationDelivery>
79 changes: 79 additions & 0 deletions examples/functions/vehicle/Netex_vehicleEquipments_02.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
<?xml version="1.0" encoding="UTF-8"?>
<PublicationDelivery xmlns="http://www.netex.org.uk/netex" xmlns:siri="http://www.siri.org.uk/siri" xmlns:gml="http://www.opengis.net/gml/3.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1.0" xsi:schemaLocation="http://www.netex.org.uk/netex ../../../xsd/NeTEx_publication.xsd">
<PublicationTimestamp>2010-12-17T09:30:47.0Z</PublicationTimestamp>
<ParticipantRef>SYS001</ParticipantRef>
<Description>Bus example with kneeling and ramp</Description>
<dataObjects>
<CompositeFrame version="any" id="CompositeFrame:1">
<frames>
<ResourceFrame version="any" id="ResourceFrame:1">
<equipments>
<AccessVehicleEquipment version="any" id="AccessVehicleEquipment:1">
<BoardingHeight>0.2</BoardingHeight>
<Kneeling>true</Kneeling>
</AccessVehicleEquipment>
<AccessVehicleEquipment version="any" id="AccessVehicleEquipment:2">
<BoardingHeight>0.3</BoardingHeight>
<Kneeling>false</Kneeling>
</AccessVehicleEquipment>
<RampVehicleEquipment version="any" id="RampVehicleEquipment:1">
<Fixed>true</Fixed>
<IsAutomatic>false</IsAutomatic>
<AssistanceRequired>true</AssistanceRequired>
<ExternalLength>1</ExternalLength>
<ExternalWidth>1</ExternalWidth>
<BearingCapacity>350</BearingCapacity>
</RampVehicleEquipment>
</equipments>

<vehicleTypes>
<VehicleType version="any" id="VehicleType:1">
<Name>Bus</Name>
<DeckPlanRef ref="DeckPlan:1"></DeckPlanRef>
</VehicleType>
</vehicleTypes>

<deckPlans>
<DeckPlan version="any" id="DeckPlan:1">
<decks>
<Deck version="any" id="Deck:1">
<deckSpaces>
<PassengerSpace version="any" id="PassengerSpace:1">
<deckEntrances>
<!-- Front entrance -->
<PassengerEntrance version="any" id="PassengerEntrance:1">
<actualVehicleEquipments>
<ActualVehicleEquipment>
<AccessVehicleEquipmentRef ref="AccessVehicleEquipment:1"/>
</ActualVehicleEquipment>
<ActualVehicleEquipment>
<AccessVehicleEquipmentRef ref="AccessVehicleEquipment:2"/>
</ActualVehicleEquipment>
</actualVehicleEquipments>
</PassengerEntrance>
<!-- Middle entrance -->
<PassengerEntrance version="any" id="PassengerEntrance:2">
<actualVehicleEquipments>
<ActualVehicleEquipment>
<AccessVehicleEquipmentRef ref="AccessVehicleEquipment:1"/>
</ActualVehicleEquipment>
<ActualVehicleEquipment>
<AccessVehicleEquipmentRef ref="AccessVehicleEquipment:2"/>
</ActualVehicleEquipment>
<ActualVehicleEquipment>
<RampVehicleEquipmentRef ref="RampVehicleEquipment:1"/>
</ActualVehicleEquipment>
</actualVehicleEquipments>
</PassengerEntrance>
</deckEntrances>
</PassengerSpace>
</deckSpaces>
</Deck>
</decks>
</DeckPlan>
</deckPlans>
</ResourceFrame>
</frames>
</CompositeFrame>
</dataObjects>
</PublicationDelivery>
63 changes: 63 additions & 0 deletions xsd/NeTEx_publication.xsd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2783,6 +2783,69 @@
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:key>
<!-- =====RetractableStepVehicleEquipment============================== -->
<!-- =====RetractableStepVehicleEquipment unique========================== -->
<xsd:unique name="RetractableStepVehicleEquipment_UniqueBy_Id_Version">
<xsd:annotation>
<xsd:documentation>Every [RetractableStepVehicleEquipment Id + Version] must be unique within document.</xsd:documentation>
</xsd:annotation>
<xsd:selector xpath=".//netex:RetractableStepVehicleEquipment"/>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:unique>
<!-- =====RetractableStepVehicleEquipment Key ========================== -->
<xsd:keyref name="RetractableStepVehicleEquipment_AnyKeyRef" refer="netex:RetractableStepVehicleEquipment_AnyVersionedKey">
<xsd:selector xpath=".//netex:RetractableStepVehicleEquipmentRef"/>
<xsd:field xpath="@ref"/>
<xsd:field xpath="@version"/>
</xsd:keyref>
<xsd:key name="RetractableStepVehicleEquipment_AnyVersionedKey">
<xsd:selector xpath=".//netex:RetractableStepVehicleEquipment"/>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:key>
<!-- =====RampVehicleEquipment============================== -->
<!-- =====RampVehicleEquipment unique========================== -->
<xsd:unique name="RampVehicleEquipment_UniqueBy_Id_Version">
<xsd:annotation>
<xsd:documentation>Every [RampVehicleEquipment Id + Version] must be unique within document.</xsd:documentation>
</xsd:annotation>
<xsd:selector xpath=".//netex:RampVehicleEquipment"/>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:unique>
<!-- =====RampVehicleEquipment Key ========================== -->
<xsd:keyref name="RampVehicleEquipment_AnyKeyRef" refer="netex:RampVehicleEquipment_AnyVersionedKey">
<xsd:selector xpath=".//netex:RampVehicleEquipmentRef"/>
<xsd:field xpath="@ref"/>
<xsd:field xpath="@version"/>
</xsd:keyref>
<xsd:key name="RampVehicleEquipment_AnyVersionedKey">
<xsd:selector xpath=".//netex:RampVehicleEquipment"/>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:key>
<!-- =====HoistVehicleEquipment============================== -->
<!-- =====HoistVehicleEquipment unique========================== -->
<xsd:unique name="HoistVehicleEquipment_UniqueBy_Id_Version">
<xsd:annotation>
<xsd:documentation>Every [HoistVehicleEquipment Id + Version] must be unique within document.</xsd:documentation>
</xsd:annotation>
<xsd:selector xpath=".//netex:HoistVehicleEquipment"/>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:unique>
<!-- =====HoistVehicleEquipment Key ========================== -->
<xsd:keyref name="HoistVehicleEquipment_AnyKeyRef" refer="netex:HoistVehicleEquipment_AnyVersionedKey">
<xsd:selector xpath=".//netex:HoistVehicleEquipmentRef"/>
<xsd:field xpath="@ref"/>
<xsd:field xpath="@version"/>
</xsd:keyref>
<xsd:key name="HoistVehicleEquipment_AnyVersionedKey">
<xsd:selector xpath=".//netex:HoistVehicleEquipment"/>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:key>
<!-- =====CycleStorageEquipment=========================== -->
<!-- =====CycleStorageEquipment unique========================== -->
<xsd:unique name="CycleStorageEquipment_UniqueBy_Id_Version">
Expand Down
63 changes: 63 additions & 0 deletions xsd/NeTEx_publication_timetable.xsd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2257,6 +2257,69 @@ Provides a general purose wrapper for NeTEx data content.</xsd:documentation>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:key>
<!-- =====RetractableStepVehicleEquipment============================== -->
<!-- =====RetractableStepVehicleEquipment unique========================== -->
<xsd:unique name="RetractableStepVehicleEquipment_UniqueBy_Id_Version">
<xsd:annotation>
<xsd:documentation>Every [RetractableStepVehicleEquipment Id + Version] must be unique within document.</xsd:documentation>
</xsd:annotation>
<xsd:selector xpath=".//netex:RetractableStepVehicleEquipment"/>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:unique>
<!-- =====RetractableStepVehicleEquipment Key ========================== -->
<xsd:keyref name="RetractableStepVehicleEquipment_AnyKeyRef" refer="netex:RetractableStepVehicleEquipment_AnyVersionedKey">
<xsd:selector xpath=".//netex:RetractableStepVehicleEquipmentRef"/>
<xsd:field xpath="@ref"/>
<xsd:field xpath="@version"/>
</xsd:keyref>
<xsd:key name="RetractableStepVehicleEquipment_AnyVersionedKey">
<xsd:selector xpath=".//netex:RetractableStepVehicleEquipment"/>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:key>
<!-- =====RampVehicleEquipment============================== -->
<!-- =====RampVehicleEquipment unique========================== -->
<xsd:unique name="RampVehicleEquipment_UniqueBy_Id_Version">
<xsd:annotation>
<xsd:documentation>Every [RampVehicleEquipment Id + Version] must be unique within document.</xsd:documentation>
</xsd:annotation>
<xsd:selector xpath=".//netex:RampVehicleEquipment"/>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:unique>
<!-- =====RampVehicleEquipment Key ========================== -->
<xsd:keyref name="RampVehicleEquipment_AnyKeyRef" refer="netex:RampVehicleEquipment_AnyVersionedKey">
<xsd:selector xpath=".//netex:RampVehicleEquipmentRef"/>
<xsd:field xpath="@ref"/>
<xsd:field xpath="@version"/>
</xsd:keyref>
<xsd:key name="RampVehicleEquipment_AnyVersionedKey">
<xsd:selector xpath=".//netex:RampVehicleEquipment"/>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:key>
<!-- =====HoistVehicleEquipment============================== -->
<!-- =====HoistVehicleEquipment unique========================== -->
<xsd:unique name="HoistVehicleEquipment_UniqueBy_Id_Version">
<xsd:annotation>
<xsd:documentation>Every [HoistVehicleEquipment Id + Version] must be unique within document.</xsd:documentation>
</xsd:annotation>
<xsd:selector xpath=".//netex:HoistVehicleEquipment"/>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:unique>
<!-- =====HoistVehicleEquipment Key ========================== -->
<xsd:keyref name="HoistVehicleEquipment_AnyKeyRef" refer="netex:HoistVehicleEquipment_AnyVersionedKey">
<xsd:selector xpath=".//netex:HoistVehicleEquipmentRef"/>
<xsd:field xpath="@ref"/>
<xsd:field xpath="@version"/>
</xsd:keyref>
<xsd:key name="HoistVehicleEquipment_AnyVersionedKey">
<xsd:selector xpath=".//netex:HoistVehicleEquipment"/>
<xsd:field xpath="@id"/>
<xsd:field xpath="@version"/>
</xsd:key>
<!-- =====CycleParkingEquipment============================== -->
<!-- =====CycleParkingEquipment unique========================== -->
<xsd:unique name="CycleParkingEquipment_UniqueBy_Id_Version">
Expand Down
Loading