Specification/Persons

=Persons= A person moves through the net by walking or using vehicles. It has at least one plan as child element. If it has multiple plans it chooses one at random where the probability may be given in the plan definition. If the person has exactly one plan the explicit "plan" may be omitted, e.g.    ... is equivalent to    ...

Visualization
Persons are rendered in the GUI with the configured detail-level. When assigning a type with attribute imgFile, the person may be rendered with an image. By default, the image will not be rotated (suitable for abstract icons). However, when setting the types guiShape="pedestrian" the image will be rotated according to the persons location and stage.

=Plans= A plan is a sequence of trips and stops if it serves as a router input or of walks, rides and stops if it serves as simulation input.

= Router input = The router input is still not completely defined. There has to be a possibility to define for the trips which vehicles / public transport lines may be used at all and for which vehicles the route can be defined / changed by the person.

Trips
Trips define the start and end point of a movement with optional changes in mode.

In definition they are identical to vehicles except for the missing route information (no route attribute and no route child is allowed). Instead they have the following attributes

= Simulation input =

Rides
Rides define the start and end point of a movement with a single mode of transport (e.g. a car or a bus). They are child elements of plan definitions. the route to take is defined by the vehicle.

Walks
Walks define a pedestrian movement. They are child elements of plan definitions. You can define either a list of "edges" to travel or a "from" and a "to" edge. In the former case the "edges" are traveled in the listed order. They do not need to be joined in the net. In the latter case a shortest path calculation is performed and it is an error if there is no path connecting "from" and "to". At least one attribute of "speed" and "duration" has to be given. If both are given, the walk will last at least "duration" but it may take longer if the "speed" is low.

Stops
Stops define a delay until the next element of a plan is started. They can be used to model activities such as working or shopping. Stops for persons follow the specification at Specification. However, only the attributes lane, duration and until are evaluated. Using these attributes it is possible to model activities with a fixed duration as well as those with a fixed end time.

=Simulation behavior= A person is starting her life at her depart time on the source (resp. first) edge of the first walk, ride or stop. She tries to start the next step of her plan.

Riding
The person checks whether a vehicle with a line from the given list is stopping at the given edge. If so, it enters the vehicle and starts the ride. It does not check whether the vehicle has the aspired destination on the current route. The first time the vehicle stops (on a well defined stop) at the destination edge, the ride is finished and the person proceeds with the next step in the plan.

Walking
The time to reach the last edge of the walk is calculated either from speed and length of the edges or directly from the duration given. The step is finished if the person reaches the last edge of the list.

Stopping
The person stops for the maximum of currentTime+duration and until.

=Example= The following is an example for a person who walks to a train station, rides the train, alights and walks for a bit, then stops for an activity and finally gets into a car and drives away.

     

   

  