---
title: Calibrator
---

Asks for the value of a certain variable of the named Calibrator.
The value returned is the state of the asked variable/value within the
last simulation step. Please note that for asking values from your
Calibrator [you have to define
them](../Simulation/Calibrator.md)
within an {{AdditionalFile}} and load them at the start of the simulation. The `period` and `file`
attributes do not affect TraCI.

The following variable values can be retrieved, the type of the return
value is also shown in the table.

<center>
**Overview Calibrator Variables**
</center>

| Variable                                     | ValueType           | Description       |  [Python Method](../TraCI/Interfacing_TraCI_from_Python.md)    |
| -------------------------------------------- | ------------------- | ----------------- | -------------------------------------------------------------- |
| begin                                  | double          | Returns the begin time of the current calibration interval  | [getBegin](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getBegin) |
| edge ID                                  | string          | Returns the edge of this calibrator  | [getEdgeID](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getEdgeID) |
| end                                  | double          | Returns the end time of the current calibration interval  | [getEnd](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getEnd) |
| insert                                  | double          | Returns the number of inserted vehicles in the current calibration interval  | [getInserted](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getInserted) |
| lane ID                                  | string          | Returns the lane of this calibrator (if it applies to a single lane)| [getLaneID](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getLaneID) |
| passed                                  | double          | Returns the number of passed vehicles in the current calibration interval  | [getPassed](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getPassed) |
| removed                                  | double          | Returns the number of removed vehicles in the current calibration interval  | [getRemoved](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getRemoved) |
| route ID                                  | string          | Returns the route id for the current calibration interval  | [getRouteID](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getRouteID) |
| routeProbe ID                                 | double          | Returns the routeProbe id for this calibrator  | [getRouteProbeID](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getRouteProbeID) |
| speed                                  | double          | Returns the target speed of the current calibration interval  | [getSpeed](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getSpeed) |
| type ID                                  | string          | Returns the type id for the current calibration interval  | [getTypeID](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getTypeID) |
| vTypes                                  | string          | Returns a list of all types to which the calibrator applies (in a type filter is active)  | [getVTypes](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getVTypes) |
| vehicle per hour                                  | double          | Returns the number of vehicles per hour in the current calibration interval  | [getVehsPerHour](https://sumo.dlr.de/pydoc/traci/_calibrator.html#CalibratorDomain.getVehsPerHour) |
