Service with Area

Services in pedestrian flow models define a group of similar physical service objects (turnstiles, ticket vending machines, security checkpoints, check-in counters, etc.) 

There are two types of space markup shapes you can use to draw services in your pedestrian model:

Service with Area is used for defining service(s) with electronic queue (like in bank office, information office on the railway station, etc.) Pedestrians do not stand in a queue line, but wait for their turn in the neighboring area.

Service with Lines is used for defining service(s) with queue(s) where pedestrians wait until the service becomes available in a queue line. Two types of queues are supported: common queue lines, and "serpentine" queue typically used in airport check-in areas.

You first draw the service in the graphical diagram, then add the PedService Pedestrian Library block in the flowchart and configure it by tuning its parameters.

 To draw a service with area

  1. Drag the Service with Area  element from the  Space Markup palette to the graphical diagram. You will see the markup shapes: two services and the neighboring area.

  1. First, resize the area to make it match the area on the drawing of the simulated space. First you need to select the area shape. When working with markup shapes, the first click selects all shapes of this markup element (in our case - two service shapes and the area shape).

    To select just one particular shape, click it once more.

    You can now edit this particular shape without affecting other markup shapes. The third click on the same shape will select the ground

  2. You can change the shape by dragging its points. You can add a point by double-clicking the border of the shape and remove a point by double-clicking it.

  3. Locate the service points in the graphical diagram. They are usually located with the same offset. If needed, place these two service points so that their locations match the drawing before you change the number of services. Then the service points that you add later will be located with this custom offset. To move a service point, select it and drag without releasing the left mouse button.

  4. Now you can change the number of service points. Open the service properties page and change the value inside the Number of services control. Let's increase it to 4. You will see more service points appeared in the graphical diagram.

Properties

General

Name – The name of the service. The name is used to identify and access the service shape from Pedestrian library block properties.

Ignore – If selected, the service shape is excluded from the model.

Visible on upper level – If selected, the service shape is also visible on the upper level where this agent lives.

Lock – If selected, the node shape is locked. Locked shapes do not react to mouse clicks: it is impossible to select them in the graphical editor until you unlock them. 

Visible – Here you specify whether the shape is visible on animation at model runtime, or not. Using the control, choose yes or no.

Ground – The ground this service belongs to.

Number of services – Here you can define the number of service points.

Appearance

Service color – Here you can change the color of service shape(s).

Advanced

Show in – Here you can choose whether you want the shape to be shown both in 2D and 3D animation, or in 2D only, or in 3D only.

Show name – If selected, the shape's name is displayed on the graphical diagram.

Functions

You can obtain the properties of the service with area at model runtime using the following functions. Note that the service and polygonal area elements, which comprise a service with area, additionally provide their own sets of functions.
Area

Function

Description

QueueArea getQueueArea()

Returns the rectangular area belonging to the current service with area.

List getQueues()

Returns the list of areas (containing a single area) belonging to the current service with area element.



Related topics

Markup for pedestrian simulation

 Selecting markup shapes

 Service with lines

 Service with a serpentine queue

 API reference: ServiceWArea class