Documentation

VT Planner Analysis Guide

Guide to selecting VT Planner analysis modes, running calculations, simulations, multi-run simulations, and parameter sweep batches.

The Analysis tab lets you select a saved setup, adjust execution options, and launch the study from the Launch panel.

Analysis in Calculation mode — `Calculation` mode with calculation method, losses, and launch panel.

Requirements

Before running:

the building must be saved;
at least one Elevator setup must exist;
the selected setup must not be Outdated;
no other analysis can be queued or running in the account;
your plan must allow new executions.

The Launch panel shows Ready, Action needed, or Processing depending on status.

Analysis mode

VT Planner offers three modes:

Mode	Recommended use
`Calculation`	Fast, structured estimate for checking capacity, interval, and basic criteria.
`Simulation`	Time-based simulation with traffic pattern, dispatcher, and operating parameters.
`Multi-run simulation`	Multiple simulations to observe seed variability and obtain more robust results.

Demand Used

Before launching, read the Demand used panel. It shows the resolved total demand as % population / 5 min, plus the incoming, outgoing, and interfloor components.

If the demand split is not what you intended, review Building type, Calculation method, Traffic pattern, Custom demand fields, and entrance settings before running the analysis.

Calculation

Main fields:

Calculation method: Up-peak, Down-peak, or General analysis.
Losses (%): margin applied to the calculation.
Incoming share, Outgoing share, Interfloor share: appear in General analysis.

Use Calculation to quickly validate an alternative before running more expensive simulations.

Simple Up-peak and Down-peak calculations are focused sizing checks for a normal group scenario: one default lobby entrance and one dominant traffic direction. Use them when you want a fast comparison of RTT, Interval, and Handling capacity.

General analysis is the analytical option to use when the scenario includes multiple entrance floors, basement entrance demand, simple zoning, or a mix of incoming, outgoing, and interfloor traffic. The three shares must sum to 1.0, and configured Transfer floors should be removed. It is still an analytical calculation, so transfer-floor waiting belongs in Simulation.

Simulation

Main fields:

Dispatcher: assignment strategy.
Traffic pattern: Up-peak, Down-peak, Interfloor, Mixed, Midday / Lunch.
Duration (min): simulated duration.
Seed: reproducible seed, optional.
Capacity factor (%): operating load limit.
Load bypass (%): threshold above which a car may skip new stops.
Coincident bonus: adjustment available for compatible dispatchers.

Custom traffic lets you enter direct demand intensities for Incoming, Outgoing, and Interfloor traffic as % population / 5 min. The total must be greater than 0% and cannot exceed 100% population / 5 min.

Analysis in Simulation mode — `Simulation` mode with dispatcher, traffic pattern, and execution parameters.

Multi-run simulation

Multi-run simulation executes multiple simulations to study variability. Options:

10 runs: fixed mode.
Adaptive: runs until target precision or maximum limit is reached.
Confidence level: confidence level used by adaptive mode.
Max runs (adaptive): maximum allowed runs.
Target precision (s): target precision for the main metric.

Analysis in Multi-run simulation mode — Multi-run mode with confidence, run limit, and target precision parameters.

Parameter sweep

When the setup is a Parameter sweep, VT Planner can launch calculation or simulation batches. Before launching:

enable variation in at least one dimension;
confirm that the total number of runs is greater than one;
confirm that the total does not exceed the limit shown in Run limit.

Launch the Analysis

When the panel says Ready to launch with the current setup, select:

Run calculation;
Run simulation;
Run multi-run simulation;
Run calculation batch;
Run simulation batch.

The run appears in Results with status queued, running, succeeded, or failed.