Modelling multi-passenger DRT bookings in MATSim: One person per passenger?

[shairys88-Malmo]

Hi MATSim team,

I’m working with a real-world DRT database and generating daily plans.xml files to simulate them using the RunDoorToDoorDrtExample setup in [matsim-maas](https://github.com/matsim-org/matsim-maas/blob/master/drt.md).

Some bookings in the dataset involve multiple passengers (e.g., NumberOfPassengers > 1 for a single request). To represent this, should I create multiple <person> entries — one per passenger — each with the same trip but a unique ID. I am neglecting several passengers (the plan file is at the end).

My Questions:

1. Is this the correct way to simulate group bookings under MATSim?
2. Will the DRT module potentially group these passengers into the exact vehicle during insertion, if their trips align?
3. Any better or cleaner way to reflect multi-passenger trips in this context?

Additional question: How do we reflect the multi-day database to compare this multi-day simulation with a synthetic day generated based on the real database? Say 10 simulations for 10 real days compared to a single synthetic day, how? Or any other way?

Thanks in advance for your support!
Best regards,

Plans File

[nkuehnel]

Hi @shairys88-Malmo ,
you can install a passenger group identification to mark persons that belong together and which will be handled together in the drt insertion search. For example, we do it like this:

    controller.addOverridingQSimModule(new AbstractDvrpModeQSimModule(drtConfigGroup.mode) {
        @Override
        protected void configureQSim() {
            bindModal(PassengerGroupIdentifier.class).toProvider(modalProvider(getter -> {
                        Population population = getter.get(Population.class);
                        return agent -> {
                            String groupID = (String) population.getPersons().get(agent.getId()).getAttributes().getAttribute("groupID");
                            return Optional.of(Id.create(groupID, PassengerGroupIdentifier.PassengerGroup.class));
                        };
                    })
            ).in(Singleton.class);
        }
    });

This will look for an "groupID" attribute in the person attribute. You could also implement the group identifier differently, e.g. by trip/leg attributes. As sooon as the group ids returned here match, they will be treated as a group.

Caveat: this only works if the departure time is the exact same second for all grouped trips

[shairys88-Malmo]

Hi Nico,
Thanks for your reply. After I inject your suggested block,

I'm having an issue with dependencies. Could you please help? I appreciate any help you can provide.

Here is the pom I am using:
`

<modelVersion>4.0.0</modelVersion>
<artifactId>matsim-maas</artifactId>
<packaging>jar</packaging>
<version>master-SNAPSHOT</version>

<parent>
	<groupId>org.matsim</groupId>
	<artifactId>matsim-all</artifactId>
	<version>16.0-2024w15</version>
	<relativePath/>
</parent>

<name>MATSim MaaS simulation</name>
<description>A toolkit for using MATSim to simulate Mobility as a Service (MaaS)</description>

<repositories>
	<repository>
		<id>matsim</id>
		<url>https://repo.matsim.org/repository/matsim</url>
	</repository>
</repositories>

<dependencies>
	<dependency>
		<groupId>org.matsim</groupId>
		<artifactId>matsim</artifactId>
		<version>${project.parent.version}</version>
	</dependency>

	<!-- the following dependencies show how to use MATSim contributions. For
		a list of available contribs, see http://matsim.org/extensions -->
	<dependency>
		<groupId>org.matsim.contrib</groupId>
		<artifactId>otfvis</artifactId>
		<version>${project.parent.version}</version>
	</dependency>
	<dependency>
		<groupId>org.matsim.contrib</groupId>
		<artifactId>taxi</artifactId>
		<version>${project.parent.version}</version>
	</dependency>
	<dependency>
		<groupId>org.matsim.contrib</groupId>
		<artifactId>av</artifactId>
		<version>${project.parent.version}</version>
	</dependency>
	<dependency>
		<groupId>org.matsim.contrib</groupId>
		<artifactId>drt</artifactId>
		<version>${project.parent.version}</version>
	</dependency>
	<dependency>
		<groupId>org.matsim.contrib</groupId>
		<artifactId>dvrp</artifactId>
		<version>${project.parent.version}</version>
	</dependency>

	<!-- test dependencies -->
	<dependency>
		<groupId>org.junit.jupiter</groupId>
		<artifactId>junit-jupiter-engine</artifactId>
	</dependency>
	<dependency>
		<groupId>org.junit.jupiter</groupId>
		<artifactId>junit-jupiter</artifactId>
	</dependency>
	<dependency>
		<groupId>org.matsim</groupId>
		<artifactId>matsim</artifactId>
		<version>${project.parent.version}</version>
		<type>test-jar</type>
		<scope>test</scope>
	</dependency>
</dependencies>

<build>
	<plugins>
		<plugin>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-shade-plugin</artifactId>
			<version>3.6.0</version>
			<executions>
				<execution>
					<phase>package</phase>
					<goals>
						<goal>shade</goal>
					</goals>
					<configuration>
						<shadedArtifactAttached>true</shadedArtifactAttached>
						<shadedClassifierName>shaded</shadedClassifierName>
						<createDependencyReducedPom>false</createDependencyReducedPom>
						<outputFile>${project.basedir}/${project.build.finalName}.jar</outputFile>
						<transformers>
							<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
								<manifestEntries>
									<Main-Class>org.matsim.maas.RunMaasGui</Main-Class>
									<Specification-Vendor>org.matsim</Specification-Vendor>
									<Implementation-Vendor>org.matsim</Implementation-Vendor>
									<Implementation-Version>${project.version}</Implementation-Version>
									<Multi-Release>true</Multi-Release>
								</manifestEntries>
							</transformer>
							<transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
						</transformers>
						<filters>
							<filter>
								<artifact>*:*</artifact>
								<excludes>
									<!-- exclude jar signatures -->
									<exclude>META-INF/*.SF</exclude>
									<exclude>META-INF/*.DSA</exclude>
									<exclude>META-INF/*.RSA</exclude>
								</excludes>
							</filter>
						</filters>
					</configuration>
				</execution>
			</executions>
		</plugin>
	</plugins>
</build>

`

This is what my new plan looks like, in user naming XXXX_YYYY_Z (XXXX is UserID, YYYY is bookingID, and Z is passengerNo).

[nkuehnel]

The plans look good!
The 'problem' seems to be that your MATSim version is outdated.
I haven't used matsim-maas before so I dont know how easy it is to update. But I suggest to use a newer version

[nkuehnel]

...this means that you need to have one person per passenger