1385
.pdfПриложение 13
Спецификация модулей TraCI
Модуль simulation.py
Функция: getCurrentTime()
Назначение: получить текущее время симуляции Параметры: отсутствуют Результат: время, мс
Функция: getLoadedNumber()
Назначение: получить число машин, которые скоро появятся в сети (загружаются)
Параметры: отсутствуют Результат: число машин
Функция: getLoadedIDList()
Назначение: получить список идентификаторов машин, которые скоро появятся в сети (загружаются)
Параметры: отсутствуют Результат: список идентификаторов машин
Функция: getDepartedNumber()
Назначение: получить число машин, которые появились в сети на последнем шаге
Параметры: отсутствуют Результат: число машин
Функция: getDepartedIDList()
Назначение: получить список идентификаторов машин, которые появились в сети на последнем шаге
Параметры: отсутствуют Результат: список идентификаторов машин
Функция: getArrivedNumber()
Назначение: получить число машин, которые покинули сеть на последнем шаге
Параметры: отсутствуют Результат: число машин
161
Продолжение прил . 1 3
Функция: getArrivedIDList()
Назначение: получить список идентификаторов машин, которые покинули сеть на последнем шаге
Параметры: отсутствуют Результат: список идентификаторов машин
Функция: getStartingTeleportNumber()
Назначение: получитьчисломашин, которыеначалителепортироваться Параметры: отсутствуют Результат: число машин
Функция: getStartingTeleportIDList()
Назначение: получить список идентификаторов машин, которые начали телепортироваться
Параметры: отсутствуют Результат: список идентификаторов машин
Функция: getEndingTeleportNumber()
Назначение: получить число машин, которые завершили телепортирование
Параметры: отсутствуют Результат: число машин
Функция: getEndingTeleportIDList()
Назначение: получить список идентификаторов машин, которые завершили телепортирование
Параметры: отсутствуют Результат: список идентификаторов машин
Функция: getDeltaT()
Назначение: получение времени изменения шага (?) (исходный код tracl вернул ошибку)
Параметры: отсутствуют Результат: время изменения шага
Функция: getNetBoundary()
Назначение: получение границ сети (исходный код tracl вернул ошибку)
Параметры: отсутствуют Результат: границы сети
162
Продолжение прил . 1 3
Модуль edge.py
Функция: getIDList()
Назначение: получить список идентификаторов дорог Параметры: отсутствуют Возвращаемое значение: список дорог
Функция: getAdaptedTraveltime(edgeID, time)
Назначение: получить адаптированное время проезда по дороге Параметры:
edgeID: идентификатор дороги time: время
Возвращаемое значение: при разных значениях времени выходило -1: возможно, т.к. необходим был некий составной (сложный) объект
(compound object)
Функция: getEffort(edgeID, time)
Назначение: получить объем работы Параметры:
edgeID: идентификатор дороги time: время
Возвращаемое значение:при разных значениях времени выходило -1: возможно, т.к. необходим был некий составной (сложный) объект
(compound object)
Функция: getCO2Emission(edgeID)
Назначение: посчитать объем выделенного CO2 Параметры:
edgeID: идентификатор дороги Возвращаемое значение: объем CO2
Функция: getCOEmission(edgeID)
Назначение: посчитать объем выделенного CO Параметры:
edgeID: идентификатор дороги Возвращаемое значение: объем СО
Функция: getHCEmission(edgeID)
Назначение:посчитать объем выделенного HC
163
Продолжение прил . 1 3
Параметры:
edgeID: идентификатор дороги
Возвращаемое значение: объем HС в единицу времени
Функция: getPMxEmission(edgeID)
Назначение:посчитать объем выделенного PMx Параметры:
edgeID: идентификатор дороги
Возвращаемое значение: объем PMx в единицу времени
Функция: getNOxEmission(edgeID)
Назначение:посчитать объем выделенного NOx Параметры:
edgeID: идентификатор дороги
Возвращаемое значение: объем NOx в единицу времени
Функция: getFuelConsumption(edgeID)
Назначение:посчитать потребление топлива Параметры:
edgeID: идентификатор дороги
Возвращаемое значение: объем топлива(л) в единицу времени
Функция: getNoiseEmission(edgeID)
Назначение:посчитать шум Параметры:
edgeID: идентификатор дороги Возвращаемое значение: уровень шума, дб
Функция: getLastStepMeanSpeed(edgeID)
Назначение:получить среднюю скорость на последнем шаге Параметры:
edgeID: идентификатор дороги Возвращаемое значение: средняя скорость, м/с
Функция: getLastStepOccupancy(edgeID)
Назначение:получить загруженность дороги на последнем шаге Параметры:
edgeID: идентификатор дороги Возвращаемое значение: загруженность, %
164
Продолжение прил . 1 3
Функция: getLastStepLength(edgeID)
Назначение: получить длину участка дороги, занятого машинами Параметры:
edgeID: идентификатор дороги
Возвращаемое значение: длина участка дороги, который занимают машины, м
Функция: getTraveltime(edgeID)
Назначение: узнать время в пути по дороге Параметры:
edgeID: идентификатор дороги Возвращаемое значение: время, с
Функция: getLastStepVehicleNumber(edgeID)
Назначение: получить количество машин на последнем шаге на дороге Параметры:
edgeID: идентификатор дороги Возвращаемое значение: количество машин
Функция: getLastStepHaltingNumber(edgeID)
Назначение: получить количество машин на последнем шаге на дороге, пребывающих в состоянии покоя
Параметры:
edgeID: идентификатор дороги Возвращаемое значение: количество машин
Функция: getLastStepVehicleIDs(edgeID)
Назначение: получить список идентификаторов машин на последнем шаге
Параметры:
edgeID: идентификатор дороги
Возвращаемое значение: список идентификаторов
Функция: adaptTraveltime(edgeID, time)
Назначение: установить адаптивное время движения Параметры:
edgeID: идентификатор дороги time: время
Возвращаемое значение: отсутствует
165
Продолжение прил . 1 3
Функция: setEffort(edgeID, effort)
Назначение: установка объекма работы (усилий) Параметры:
edgeID: идентификатор дороги effort: объем работы (усилия) Возвращаемое значение: отсутствует
Функция: setMaxSpeed(edgeID, speed)
Назначение: установка максимальной скорости Параметры:
edgeID: идентификатор дороги speed: скорость
Возвращаемое значение: отсутствует
Модуль gui.py
Функция: getIDList()
Назначение: получить список идентификаторов точек обзора дорожной сети
Параметры: отсутствуют Возвращаемое значение: список идентификаторов точек обзора
Функция: getZoom(viewID=DEFAULT_VIEW)
Назначение: получить коэффициент увеличения изображения Параметры:
viewID: идентификатор точки обзора (необязательный) Возвращаемое значение: коэффициент увеличения изображения (по
умолч. - 100)
Функция: getOffset(viewID=DEFAULT_VIEW)
Назначение: получить смещение изображения от точки обзора Параметры:
viewID: идентификатор точки обзора
Возвращаемое значение: список (смещение по Х, смещение по У)
Функция: getSchema(viewID=DEFAULT_VIEW)
Назначение: получить схему (о какой схеме говорится - неясно) Параметры:
viewID: идентификатор точки обзора Возвращаемое значение: схема
166
Продолжение прил . 1 3
Функция: getBoundary(viewID=DEFAULT_VIEW)
Назначение: узнать границы Параметры:
viewID: идентификатор точки обзора
Возвращаемое значение: границы (не получилось узнать: ошибка в исходном python коде)
Функция: setZoom(viewID, zoom)
Назначение: установить новый коэффициент увеличения изображения Параметры:
viewID: идентификатор точки обзора
zoom: коэффициент увеличения изображения Возвращаемое значение: отсутствует
Функция: setOffset(viewID, x, y)
Назначение: установить смещение относительно точки обзора Параметры:
viewID: идентификатор точки обзора
x:смещение по х
y:смещение по у
Возвращаемое значение: отсутствует
Функция: setSchema(viewID, schemeName)
Назначение: установить схему Параметры:
viewID: идентификатор точки обзора schemeName: название схемы Возвращаемое значение: отсутствует
Функция: setBoundary(viewID, xmin, ymin, xmax, ymax)
Назначение: установить границы (не получилось установить: ошибка в исходном python коде)
Параметры:
viewID: идентификатор точки обзора xmin: минимальный х
ymin: минимальный у xmax: максимальный х ymax: максимальный у
Возвращаемое значение: отсутствует
167
Продолжение прил . 1 3
Функция: screenshot(viewID, filename)
Назначение: сделать снимок экрана и сохранить в файл (не получилось сделать: ошибка в исходном python коде)
Параметры:
viewID: идентификатор точки обзора filename: файл для снимка Возвращаемое значение: отсутствует
Функция: trackVehicle(viewID, vehID)
Назначение: проследить за перемещением машины (не получилось проследить: ошибка в исходном python коде)
Параметры:
viewID: идентификатор точки обзора vehID: идентификатор объекта наблюдения Возвращаемое значение: отсутствует
Модуль inductionloop.py
Функция: getIDList()
Назначение: получить список индикаторов Параметры: отсутствуют
Возвращаемое значение: список идентификаторов детекторов
Функция: getLastStepVehicleNumber(loopID)
Назначение: получить число машин, которые проехали за последний шаг мимо детектора
Параметры:
loopID: идентификатор детектора Возвращаемое значение: число машин
Функция: getLastStepMeanSpeed(loopID)
Назначение: получить среднюю скорость машин, которые проехали за последний шаг мимо детектора
Параметры:
loopID: идентификатор детектора Возвращаемое значение: средняя скорость, м/с
Функция: getLastStepVehicleIDs(loopID)
Назначение: получить список идентификаторов машин, которые проехали за последний шаг мимо детектора
168
Продолжение прил . 1 3
Параметры:
loopID: идентификатор детектора
Возвращаемое значение: список идентификаторов машин
Функция: getLastStepOccupancy(loopID)
Назначение: узнать загруженность для машин, которые проехали за последний шаг мимо детектора
Параметры:
loopID: идентификатор детектора Возвращаемое значение: показатель загруженности
Функция: getLastStepMeanLength(loopID)
Назначение: узнать среднюю длину очереди машин, которые проехали за последний шаг мимо детектора
Параметры:
loopID: идентификатор детектора Возвращаемое значение: средняя длина
Функция: getTimeSinceDetection(loopID)
Назначение: получить время, прошедшее с начала цикла детектора Параметры:
loopID: идентификатор детектора Возвращаемое значение: время, c
Функция: getVehicleData(loopID)
Назначение: получить данные о машинах, которые проехали за последний шаг мимо детектора (ошибка в исходных кодах traci)
Параметры:
loopID: идентификатор детектора Возвращаемое значение: данные о машинах
Модуль junction.py
Функция: getIDList()
Назначение: получить список идентификаторов переходов Параметры: отсутствуют Возвращаемое значение: список идентификаторов переходов
Функция: getPosition(junctionID)
Назначение: узнать позицию перехода
169
Продолжение прил . 1 3
Параметры:
junctionID: идентификатор перехода Возвращаемое значение: позиция в виде списка (x,y)
Модуль lane.py
Функция: getIDList()
Назначение: получить список идентификаторов полос Параметры: отсутствуют Возвращаемое значение: список идентификаторов полос
Функция: getLength(laneID)
Назначение: получить длину полосы Параметры:
laneID: идентификатор полосы Возвращаемое значение: длина, м
Функция: getMaxSpeed(laneID)
Назначение: получить максимально допустимую скорость на полосе Параметры:
laneID: идентификатор полосы
Возвращаемое значение: максимальная скорость, м/с
Функция: getAllowed(laneID)
Назначение: список типов машин, которым разрешается ехать по полосе
Параметры:
laneID: идентификатор полосы Возвращаемое значение: список типов машин
Функция: getDisallowed(laneID)
Назначение: список типов машин, которым запрещается ехать по полосе
Параметры:
laneID: идентификатор полосы Возвращаемое значение: список типов машин
Функция: getLinkNumber(laneID)
Назначение: узнать число выездов с полосы
170