Ações de Gerenciamento da API Aimsun Next¶
Funções relacionadas às Ações de Gerenciamento¶
Ativar uma Ação de Redução de Velocidade em uma seção¶
Em C++ e Python¶
Explicação¶
Ativar uma ação de mudança de velocidade em uma seção para um tipo de veículo específico e um nível de conformidade. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use a função ByID e use o ID especificado para desativar a ação mais tarde.
Formato¶
void *AKIActionAddSpeedAction (int sectionId, double newSpeed, int vehTypePos, double compliance)
void *AKIActionAddSpeedActionByID(int idAction, int nbSections, int *sectionIDs, double newSpeed, int vehTypePos, double compliance, bool considerSpeedAcceptance)
Parâmetros¶
- sectionId: O identificador da seção.
- newSpeed: A nova velocidade expressa nas unidades do modelo (Km/h ou Mph).
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 é usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
- compliance: é o nível de conformidade (definido entre 0 e 1).
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
- sectionIDs: Uma lista de seções (identificadas por seus IDs) onde a ação deve ser aplicada.
- nbSections: Tamanho da lista de seções onde a ação deve ser aplicada.
- considerSpeedAcceptance: verdadeiro quando a nova velocidade ignora o limite de velocidade da seção e falso quando a nova velocidade ignora o limite de velocidade da seção x aceitação do limite de velocidade do veículo. Nesse segundo caso, nenhum veículo dirigirá mais rápido que a nova velocidade, não importando o valor de sua aceitação de limite de velocidade.
Saída¶
- !=NULL: ponteiro para a ação, que será necessário para desativar a ação ou modificar seu nível de conformidade mais tarde.
- = NULL: Erro
Ativar uma Ação de Mudança de Velocidade para uma faixa ou segmento de seção¶
Em C++ e Python¶
Explicação¶
Ativar uma ação de mudança de velocidade em uma seção para apenas uma faixa ou um segmento para um tipo de veículo específico e um nível de conformidade. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use a função ByID e use o ID especificado para desativar a ação mais tarde.
Formato¶
void *AKIActionAddDetailedSpeedAction(int sectionId, int laneId, int segmentId, double newSpeed, int vehTypePos, double compliance, bool considerSpeedAcceptance)
void *AKIActionAddDetailedSpeedActionByID(int idAction, int nbSections, int *sectionIDs, int laneId, int fromSegmentId, int toSegmentId, double newSpeed, int vehTypePos, double compliance, bool considerSpeedAcceptance)
Parâmetros¶
- sectionId: O identificador da seção.
- laneId: O identificador da faixa (-1 para todas as faixas, 1 para a faixa mais à direita e N, onde N é o número de faixas na seção, para a faixa mais à esquerda).
- segmentId: O identificador do segmento se apenas um segmento na seção for afetado pela ação (-1 para todos os segmentos, 1 para o primeiro segmento que os veículos encontram ao cruzar a seção, e N, onde N é o número de segmentos, para o último segmento que os veículos encontram ao cruzar a seção).
- newSpeed: A nova velocidade expressa nas unidades do modelo (Km/h ou Mph).
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 deve ser usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
- compliance: O nível de conformidade (definido entre 0 e 1).
- considerSpeedAcceptance: verdadeiro quando a nova velocidade ignora o limite de velocidade da seção e falso quando a nova velocidade ignora o limite de velocidade da seção e a aceitação do limite de velocidade do veículo. Nesse segundo caso, nenhum veículo dirigirá mais rápido que a nova velocidade, não importando o valor de sua aceitação de limite de velocidade.
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
- sectionIDs: Uma lista de seções (identificadas por seus IDs) onde a ação deve ser aplicada.
- nbSections: Tamanho da lista de seções onde a ação deve ser aplicada.
Saída¶
- !=NULL: ponteiro para a ação, que será necessário para desativar a ação ou modificar seu nível de conformidade mais tarde.
- = NULL: Erro
Ativar uma Ação de Redução de Velocidade para uma conversão¶
Em C++ e Python¶
Explicação¶
Ativar uma ação de mudança de velocidade em uma conversão para um tipo de veículo específico e um nível de conformidade. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use a função ByID e use o ID especificado para desativar a ação mais tarde.
Formato¶
void *AKIActionAddTurnSpeedActionByID(int idAction, int nbTurns, int * turnIDs, double newSpeed, int vehTypePos, double compliance, bool considerSpeedAcceptance)
Parâmetros¶
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
- nbTurns: Tamanho da lista de conversões onde a ação deve ser aplicada.
- turnIDs: Uma lista de conversões (identificadas por seus IDs) onde a ação deve ser aplicada.
- newSpeed: A nova velocidade expressa nas unidades do modelo (Km/h ou Mph).
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 é usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
- compliance: é o nível de conformidade (definido entre 0 e 1).
- considerSpeedAcceptance: verdadeiro quando a nova velocidade ignora o limite de velocidade da seção e falso quando a nova velocidade ignora o limite de velocidade da seção x aceitação do limite de velocidade do veículo. Nesse segundo caso, nenhum veículo dirigirá mais rápido que a nova velocidade, não importando o valor de sua aceitação de limite de velocidade.
Saída¶
- !=NULL: ponteiro para a ação, que será necessário para desativar a ação ou modificar seu nível de conformidade mais tarde.
- = NULL: Erro
Ativar uma Ação de Fechamento de Faixa¶
Em C++ e Python¶
Explicação¶
Ativar uma ação de fechamento de faixa em uma seção para um tipo de veículo específico. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use a função ByID e use o ID especificado para desativar a ação mais tarde. Quando usar esta função, o fechamento de faixa criado considerará o modelo de seguimento de carros de 2 faixas. Se esta não for a ação desejada, consulte a função AKIActionCloseLaneDetailedAction.
Formato¶
void *AKIActionCloseLaneAction (int sectionId, int alane, int vehTypePos)
void * AKIActionCloseLaneActionByID(int idAction, int sectionId, int alane, int vehTypePos);
Parâmetros¶
- sectionId: O identificador da seção.
- alane: O id da faixa a ser fechada (1 faixa mais à direita, n é a faixa mais à esquerda).
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 é usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
Saída¶
- !=NULL: ponteiro da ação, que será necessário para desativar a ação ou modificar seu nível de conformidade mais tarde.
- = NULL: Erro
Ativar uma Ação de Fechamento de Faixa especificando se deve aplicar o modelo de seguimento de carros de 2 faixas¶
Em C++ e Python¶
Explicação¶
Ativar uma ação de fechamento de faixa em uma seção para um tipo de veículo específico. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. Também pode ser especificado se o modelo de seguimento de 2 faixas deve ser aplicado ou não. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use a função ByID e use o ID especificado para desativar a ação mais tarde.
Formato¶
void * AKIActionCloseLaneDetailedAction(int sectionId, int alane, int VehTypePos, bool apply2LanesCF, double visibilityDistance );
void * AKIActionCloseLaneDetailedActionByID(int idAction, int sectionId, int alane, int vehTypePos, bool apply2LanesCF, double visibilityDistance );
Parâmetros¶
- sectionId: O identificador da seção.
- alane: O id da faixa a ser fechada.
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 deve ser usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
- apply2LanesCF: Verdadeiro se o modelo de seguimento de 2 faixas deve ser considerado e falso caso contrário.
- visibilityDistance: A distância a partir da qual o fechamento da faixa começará a ser visível para os veículos. 200 metros é o valor padrão ao criar uma ação de fechamento de faixa usando a interface gráfica do usuário.
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
Saída¶
- !=NULL: ponteiro da ação, que será necessário para desativar a ação ou modificar seu nível de conformidade mais tarde.
- = NULL: Erro
Ativar uma Ação de Fechamento de Faixa para um segmento¶
Em C++ e Python¶
Explicação¶
Ativar uma ação de fechamento de faixa em uma seção para um tipo de veículo específico e para um grupo de segmentos. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. Também pode ser especificado se o modelo de seguimento de 2 faixas deve ser aplicado ou não. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use a função ByID e use o ID especificado para desativar a ação mais tarde.
Formato¶
void *AKIActionCloseLaneActionBySegment (int sectionId, int alane, int segmentFromId, int segmentToId, int vehTypePos, bool apply2LanesCF, double visibilityDistance )
void * AKIActionCloseLaneActionBySegmentByID(int idAction, int sectionId, int alane, int segmentFromId, int segmentToId, int vehTypePos, bool apply2LanesCF, double visibilityDistance);
Parâmetros¶
- sectionId: O identificador da seção.
- alane: O id da faixa a ser fechada.
- segmentFromId: A posição do primeiro segmento (de 0 ao número de segmentos - 1) onde a ação de fechamento de faixa será aplicada.
- segmentToId: A posição do último segmento (de 0 ao número de segmentos - 1) onde a ação de fechamento de faixa será aplicada.
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 deve ser usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
- apply2LanesCF: Verdadeiro se o modelo de seguimento de 2 faixas deve ser considerado e falso caso contrário.
- visibilityDistance: A distância a partir da qual o fechamento da faixa começará a ser visível para os veículos. 200 metros é o valor padrão ao criar uma ação de fechamento de faixa usando a interface gráfica do usuário.
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
Saída¶
- !=NULL: ponteiro da ação, que será necessário para desativar a ação ou modificar seu nível de conformidade mais tarde.
- = NULL: Erro
Ativar uma Ação de Forçar a Próxima Conversão¶
Em C++ e Python¶
Explicação¶
Ativar uma ação de "forçar a próxima conversão" em uma seção para um tipo de veículo específico e um nível de conformidade. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use a função ByID e use o ID especificado para desativar a ação mais tarde.
Formato¶
void * AKIActionAddForceTurningODActionByID( int idAction, int sectionId, const std::vector
void * AKIActionAddForceTurningResultActionByID( int idAction, int sectionId, int aOldNextSection, const std::vector
Funções obsoletas que devem ser atualizadas com as acima:
void * AKIActionAddNextTurningODAction (int fromSectionId, int toSectionId, int originCent, int destCent, int vehTypePos, int sectionInPath, double compliance, double visibilityDistance)
void * AKIActionAddNextTurningODActionByID(int idAction, int sectionId, int anextSection, int aOrigin, int aDest, int VehType, int asectionInPath, double acomplianceLevel, double visibilityDistance);
void * AKIActionAddNextTurningResultAction (int fromSectionId, int oldToSectionId, int toSectionId, int vehTypePos, double compliance)
void * AKIActionAddNextTurningResultActionByID(int idAction, int sectionId, int aoldNextSection, int anewNextSection, int VehType, double acomplianceLevel);
As funções AKIActionAddForceTurningODActionByID e AKIActionAddForceTurningODSubPathActionByID (assim como as anteriores AKIActionAddNextTurningODAction e AKIActionAddNextTurningODActionByID) são usadas quando a demanda de tráfego é baseada em Matrizes OD. As funções AKIActionAddForceTurningResultActionByID e AKIActionAddForceTurningResultSubPathActionByID (assim como as anteriores AKIActionAddNextTurningResultAction e AKIActionAddNextTurningResultActionByID) são usadas quando a demanda de tráfego é baseada em estados de tráfego.
Parâmetros¶
- fromSectionId: O identificador da seção de origem da conversão.
- toSectionId: O novo identificador da seção de destino da conversão.
- oldToSectionId: O identificador da seção de destino dos veículos que serão afetados por essa mudança (-1 significa não considerar a conversão atual do veículo).
- originCent: O identificador do centro de origem para forçar a próxima conversão. Todos os veículos com esta origem podem seguir a ação dependendo do nível de conformidade (-1 significa não considerar a origem).
- destCent: O identificador do centro de destino para forçar a próxima conversão. Todos os veículos com este destino podem seguir a ação dependendo do nível de conformidade (-1 significa não considerar o destino).
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 deve ser usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
- sectionInPath: O identificador da seção que significa (usando apenas OD’s) a ação é aplicada quando esta seção está no caminho do veículo (-1 significa não considerar nenhuma seção específica).
- compliance: O nível de conformidade, definido como probabilidade entre 0 e 1.
- visibilityDistance: A distância a partir da qual a força de conversão começará a ser visível para os veículos. 200 metros é o valor padrão ao criar uma ação de força de conversão usando a interface gráfica do usuário.
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
Saída¶
- !=NULL: ponteiro da ação, que será necessário para desativar a ação ou modificar seu nível de conformidade mais tarde.
- = NULL: Erro
Ativar uma Ação de Forçar a Próxima Conversão seguindo um sub-caminho¶
Apenas em C++¶
Explicação¶
Ativar uma ação de "forçar a próxima conversão" em uma seção para um tipo de veículo específico e um nível de conformidade. Os veículos seguirão o sub-caminho definido. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use a função ByID e use o ID especificado para desativar a ação mais tarde.
Formato¶
void * AKIActionAddNextSubPathODAction(int sectionId, int nbNextSections , int * nextSections, int originCent, int destCent, int vehTypePos, int sectionInPath, double compliance, double visibilityDistance);
void * AKIActionAddNextSubPathODActionByID(int actionId, int ang_sectionId, int nbNextSections, int * anextSections, int aOrigin, int aDest, int VehType, int asectionInPath, double acomplianceLevel, double visibilityDistance);
void * AKIActionAddNextSubPathResultAction(int sectionId, int nbNextSections, int * nextSections, int vehTypePos, double compliance);
void * AKIActionAddNextSubPathResultActionByID(int actionId, int ang_sectionId, int nbNextSections, int * anextSections, int VehType, double acomplianceLevel);
As funções AKIActionAddNextSubPathODAction e AKIActionAddNextSubPathODActionByID são usadas quando a demanda de tráfego é baseada em Matrizes OD. A função AKIActionAddNextSubPathResultAction e AKIActionAddNextSubPathResultActionByID são usadas quando a demanda de tráfego é baseada em estados de tráfego.
Parâmetros¶
- sectionId: O identificador da seção.
- nextSections: Uma lista de seções consecutivas (identificadas por seus IDs) que definem o percurso que o veículo seguirá uma vez desviado.
- originCent: O identificador do centro de origem para forçar a próxima conversão. Todos os veículos com esta origem podem seguir a ação dependendo do nível de conformidade (-1 significa não considerar a origem).
- destCent: O identificador do centro de destino para forçar a próxima conversão. Todos os veículos com este destino podem seguir a ação dependendo do nível de conformidade (-1 significa não considerar o destino).
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 deve ser usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
- sectionInPath: O identificador da seção que significa que a ação é aplicada quando esta seção está no caminho do veículo - apenas se os veículos estiverem usando a demanda de tráfego OD.
- compliance: O nível de conformidade (definido entre 0 e 1).
- visibilityDistance: A distância a partir da qual a força de conversão começará a ser visível para os veículos. 200 metros é o valor padrão ao criar uma ação de força de conversão usando a interface gráfica do usuário.
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
Saída¶
- !=NULL: ponteiro da ação, que será necessário para desativar a ação ou modificar seu nível de conformidade mais tarde.
- = NULL: Erro
Ativar uma Ação de Mudança de Centro de Destino¶
Em C++ e Python¶
Explicação¶
Ativar uma ação de "mudar o centro de destino" em uma seção para um tipo de veículo específico e um nível de conformidade. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use a função ByID e use o ID especificado para desativar a ação mais tarde.
Formato¶
void *AKIActionAddChangeDestAction (int sectionId, int anewDest, int originCent, int destCent, int vehTypePos, double compliance)
void *AKIActionAddChangeDestActionByID (int idAction, int sectionId, const std::vector<A2KDestinationProportion*>& aNextSections, int originCent, int destCent, int vehTypePos, double compliance)
Parâmetros¶
- sectionId: O identificador da seção.
- anewDest: O novo identificador do centro de destino.
- originCent: O identificador do centro de origem para aplicar a ação. Todos os veículos com esta origem podem seguir a ação dependendo do nível de conformidade (-1 significa não considerar a origem).
- destCent: O identificador do centro de destino para aplicar a ação. Todos os veículos com este destino podem seguir a ação dependendo do nível de conformidade (-1 significa não considerar o destino).
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 deve ser usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
- compliance: O nível de conformidade (definido entre 0 e 1).
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
- nbNewDests: O número de itens na lista de proporções de destinos.
- newDests: Lista de proporções de centros de destino.
Saída¶
- !=NULL: ponteiro da ação, que será necessário para desativar a ação ou modificar seu nível de conformidade mais tarde.
- = NULL: Erro
Ativar uma Ação de Mudança de Destino de Parque e Transporte¶
Apenas em C++¶
Explicação¶
Ativar uma "ação de mudar o destino de parque e transporte" em uma seção para um tipo de veículo específico e um nível de conformidade. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use o ID especificado para desativar a ação mais tarde.
Formato¶
void *AKIActionAddChangeDestParkRideActionByID(int idAction, int sectionId, const std::vector
Parâmetros¶
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
- sectionId: O identificador da seção.
- nbNewDests: O número de itens na lista de proporções de destinos.
- newDests: Lista de proporções de centros de destino.
- originCent: O identificador do centro de origem para aplicar a ação. Todos os veículos com esta origem podem seguir a ação dependendo do nível de conformidade (-1 significa não considerar a origem).
- destCent: O identificador do centro de destino para aplicar a ação. Todos os veículos com este destino podem seguir a ação dependendo do nível de conformidade (-1 significa não considerar o destino).
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 deve ser usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
- compliance: O nível de conformidade (definido entre 0 e 1).
- scaleFactor: O fator de escala logarítmica para calcular as probabilidades de escolha.
Saída¶
- !=NULL: ponteiro da ação, que será necessário para desativar a ação ou modificar seu nível de conformidade mais tarde.
- = NULL: Erro
Ativar uma Ação de Mudança de Probabilidade de Conversão¶
Apenas em C++¶
Explicação¶
Ativar uma mudança de probabilidade de conversão em uma seção para um tipo de veículo específico. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use o ID especificado para desativar a ação mais tarde. Para usar esta função, a demanda deve ser composta de estados de tráfego.
Formato¶
void *AKIActionChangeTurningProbAction (int sectionId, int nbnewProb, int *anextSection, int *anewProb, int vehTypePos)
Parâmetros¶
- sectionId: O identificador da seção.
- nbnewProb: O número de probabilidades a serem alteradas. Isso deve corresponder ao número de conversões saindo da seção.
- anextSection: Um array que contém os identificadores das próximas seções (o tamanho do array deve ser igual a nbnewProb).
- anewProb: Um array que contém as novas probabilidades para as próximas seções (o tamanho do array deve ser igual a nbnewProb). As probabilidades devem estar entre 0 e 1.
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 deve ser usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
Saída¶
- !=NULL: ponteiro da ação, que será necessário para desativar a ação mais tarde.
- = NULL: Erro
Adicionar uma Ação de Desativar Faixa Reservada¶
Em C++ e Python¶
Explicação¶
Ativar uma ação de Desativar Faixa Reservada em uma seção para uma faixa e segmento específicos. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use a função ByID e use o ID especificado para desativar a ação mais tarde.
Formato¶
void * AKIActionDisableReservedLaneAction(int sectionId, int alane, int ang_segmentId);
void * AKIActionDisableReservedLaneActionByID(int idAction, int sectionId, int alane, int ang_segmentId);
Parâmetros¶
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
- sectionId: O identificador da seção.
- alane: O id da faixa reservada a desativar.
- ang_segmentId: A posição do segmento (de 0 ao número de segmentos - 1, ou -1 para todos eles) onde a ação de desativação de faixa reservada será aplicada.
Saída¶
- !=NULL: ponteiro da ação, que será necessário para desativar a ação mais tarde em C++.
- = NULL: Erro
Adicionar uma Ação de Forçar Atualização de Caminho¶
Em C++ e Python¶
Explicação¶
Ativar uma Ação de Forçar Atualização de Caminho em uma seção para um tipo de veículo específico e um nível de conformidade. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use o ID especificado para desativar a ação mais tarde.
Formato¶
void *AKIActionAddEnRouteAssignmentAction(int idAction, int sectionId, int sectionInPath, int originCent, int destCent, int vehTypePos, double compliance, bool reevaluateAction, int routeChoiceType, double routeChoiceParam1, double routeChoiceParam2, double routeChoiceParam3)
Parâmetros¶
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
- sectionId: O identificador da seção.
- sectionInPath: O identificador da seção que indica que a ação é aplicada quando essa seção está no caminho do veículo - apenas se os veículos estiverem usando a demanda de tráfego OD.
- originCent: O identificador do centro de origem para forçar a atualização do caminho. Todos os veículos com esta origem podem seguir a ação dependendo do nível de conformidade (-1 significa não considerar a origem).
- destCent: O identificador do centro de destino para forçar a atualização do caminho. Todos os veículos com este destino podem seguir a ação dependendo do nível de conformidade (-1 significa não considerar o destino).
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 deve ser usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
- compliance: O nível de conformidade, definido como probabilidade entre 0 e 1.
- reevaluateAction: A opção de atualizar o caminho dos veículos toda vez que o tempo de viagem for atualizado.
- routeChoiceType: O tipo de escolha de trajeto (0 para distribuição fixa, 1 para tempo fixo, 2 para binomial, 3 para proporcional, 4 para Logit, 5 para C-Logit, 6 para definido pelo usuário e 7 para DUE).
- routeChoiceParam1: Primeiro parâmetro de escolha de trajeto (por exemplo, probabilidade para o tipo de escolha de trajeto binomial ou atributo de escala para Logit e C-Logit).
- routeChoiceParam2: Segundo parâmetro de escolha de trajeto (por exemplo, alpha no tipo de escolha de trajeto C-Logit) - defina como 0 se irrelevante para o tipo de escolha de trajeto de entrada.
- routeChoiceParam3: Terceiro parâmetro de escolha de trajeto (por exemplo, gamma no tipo de escolha de trajeto C-Logit) - defina como 0 se irrelevante para o tipo de escolha de trajeto de entrada.
Saída¶
- !=NULL: ponteiro da ação, que será necessário para desativar a ação mais tarde.
- = NULL: Erro
Ativar uma Ação de Fechar Conversão¶
Em C++ e Python¶
Explicação¶
Ativar um fechamento de conversão em um movimento de conversão para um tipo de veículo específico. No caso de o tipo de veículo ser 0, a ação é aplicada a todos os tipos de veículos. O void * retornado deve ser usado para desativar a ação em C++. Em Python, use o ID especificado na função ByID para desativar a ação mais tarde.
Formato¶
void * AKIActionAddCloseTurningODAction(int fromSectionId, int toSectionId, int aOrigin, int aDest, int vehTypePos, double compliance, double visibilityDistance, bool localEffect, int sectionAffectingPathCostId );
void * AKIActionAddCloseTurningODActionByID(int idAction, int sectionId, int anewSection2Close, int aOrigin, int aDest, int vehType, double acomplianceLevel, double visibilityDistance, bool localEffect, int sectionAffectingPathCostId );
Parâmetros¶
- fromSectionId: O identificador da seção de origem da conversão.
- toSectionId: O identificador da seção de destino da conversão.
- originCent: O identificador do centro de origem para forçar o fechamento da conversão. Todos os veículos com esta origem podem seguir a ação dependendo do nível de conformidade (-1 significa não considerar a origem).
- destCent: O identificador do centro de destino para forçar o fechamento da conversão. Todos os veículos com este destino podem seguir a ação dependendo do nível de conformidade (-1 significa não considerar o destino).
- vehTypePos: A posição do tipo de veículo na lista de tipos de veículos em uso. 0 é usado para todos os tipos de veículos e um valor de 1 até AKIVehGetNbVehTypes (), para um tipo de veículo específico.
- compliance: é o nível de conformidade (definido entre 0 e 1).
- visibilityDistance: A distância a partir da qual o fechamento da conversão começará a ser visível para os veículos. 200 metros é o valor padrão ao criar uma ação de fechamento de conversão usando a interface gráfica do usuário.
- localEffect: Verdadeiro quando a ação não afetará diretamente os cálculos da escolha da rota, uma vez que os veículos perceberão que a conversão está fechada ao chegarem nela. É falso quando há um conhecimento global sobre a conversão sendo fechada, de forma que é considerado no cálculo da rota. É verdadeiro por padrão.
- idAction: Um identificador único para a ação que será usado ao desativá-la. Certifique-se de que o ID especificado não pertence a nenhuma outra ação já existente.
- sectionAffectingPathCostId: Identificador para a seção destinada a afetar o custo do cálculo do caminho quando o caminho vier dela (-1 significa não considerar uma seção específica).
Saída¶
- !=NULL: ponteiro da ação, que será necessário para desativar a ação ou modificar seu nível de conformidade mais tarde.
- = NULL: Erro
Desativar uma Ação¶
Em C++ e Python¶
Explicação¶
Desativar uma ação ativada anteriormente. O parâmetro necessário é o ponteiro retornado quando a ação é habilitada.
Formato¶
void AKIActionRemoveAction (void *anaction)
void AKIActionRemoveActionByID (int idAction)
Parâmetros¶
- anaction: O ponteiro para a ação retornado quando a ação foi ativada.
- idAction: O identificador da ação retornado quando a ação foi ativada. Se a ação foi criada usando uma função byID, então é o ID especificado na criação da ação.
Saída¶
- nenhum
Desativar todas as Ações ativadas¶
Em C++ e Python¶
Explicação¶
Desativar todas as ações ativadas anteriormente.
Formato¶
void AKIActionReset ()
Parâmetros¶
- nenhum
Saída¶
- nenhum
Modificar o nível de conformidade de uma Ação de Forçar a Próxima Conversão¶
Em C++ e Python¶
Explicação¶
Modifica o nível de conformidade de uma ação de forçar a próxima conversão ativada anteriormente. O void * retornado ao ativar a ação deve ser usado para modificar o nível de conformidade da ação em C++. Em Python, use o ID especificado na função ByID ao criá-lo para modificar o nível de conformidade.
Formato¶
void AKIActionModifyNextTurningODAction( void * action, double compliance);
void AKIActionModifyNextTurningODActionByID( int idAction, double compliance);
void AKIActionModifyNextTurningResultAction( void * action, double compliance);
void AKIActionModifyNextTurningResultActionByID( int idAction, double compliance);
A função AKIActionModifyNextTurningODAction é usada quando a demanda de tráfego é baseada em Matrizes OD e a função AKIActionModifyNextTurningResultAction é usada quando a demanda de tráfego é baseada em estados de tráfego.
Parâmetros¶
- action O ponteiro para a ação que foi retornado ao ativar a ação.
- idAction: O identificador da ação retornado quando a ação foi ativada. Se a ação foi criada usando uma função byID, então é o ID especificado na criação da ação.
- compliance O novo nível de conformidade (definido entre 0 e 1).
Saída¶
Nenhum
Modificar o nível de conformidade de uma Ação de Forçar a Próxima Conversão seguindo um sub-caminho¶
Em C++ e Python¶
Explicação¶
Modifica o nível de conformidade de uma ação de forçar a próxima conversão ativada anteriormente seguindo um sub-caminho. O void * retornado ao ativar a ação deve ser usado para modificar o nível de conformidade da ação em C++. Em Python, use o ID especificado na função ByID ao criá-lo para modificar o nível de conformidade.
Formato¶
void AKIActionModifyNextSubPathODAction ( void * action, double compliance);
void AKIActionModifyNextSubPathODActionByID ( int idAction, double compliance);
void AKIActionModifyNextSubPathResultAction ( void * action, double compliance);
void AKIActionModifyNextSubPathResultActionByID ( int idAction, double compliance);
A função AKIActionModifyNextSubPathODAction é usada quando a demanda de tráfego é baseada em Matrizes OD e a função AKIActionModifyNextSubPathResultAction é usada quando a demanda de tráfego é baseada em estados de tráfego.
Parâmetros¶
- action O ponteiro para a ação que foi retornado ao ativar a ação.
- idAction: O identificador da ação retornado quando a ação foi ativada. Se a ação foi criada usando uma função byID, então é o ID especificado na criação da ação.
- compliance O novo nível de conformidade (definido entre 0 e 1).
Saída¶
- nenhum
Modificar o nível de conformidade de uma Ação de Mudança de Centro de Destino¶
Em C++ e Python¶
Explicação¶
Modifica o nível de conformidade de uma ação de mudar o centro de destino ativada anteriormente. O void * retornado ao ativar a ação deve ser usado para modificar o nível de conformidade da ação em C++. Em Python, use o ID especificado na função ByID ao criá-lo para modificar o nível de conformidade.
Formato¶
void AKIActionModifyChangeDestAction ( void * action, double compliance);
void AKIActionModifyChangeDestActionByID ( int idAction, double compliance);
Parâmetros¶
- action O ponteiro para a ação que foi retornado ao ativar a ação.
- idAction: O identificador da ação retornado quando a ação foi ativada. Se a ação foi criada usando uma função byID, então é o ID especificado na criação da ação.
- compliance O novo nível de conformidade (definido entre 0 e 1).
Saída¶
Nenhum
Modificar o nível de conformidade de uma Ação de Fechar Conversão¶
Em C++ e Python¶
Explicação¶
Modifica o nível de conformidade de uma ação de fechamento de conversão ativada anteriormente. O void * retornado ao ativar a ação deve ser usado para modificar o nível de conformidade da ação em C++. Em Python, use o ID especificado na função ByID ao criá-lo para modificar o nível de conformidade.
Formato¶
void AKIActionModifyCloseTurningODAction( void * action, double compliance);
void AKIActionModifyCloseTurningODActionByID( int idAction, double compliance);
Parâmetros¶
- action: O ponteiro para a ação que foi retornado ao ativar a ação.
- idAction: O identificador da ação retornado quando a ação foi ativada. Se a ação foi criada usando uma função byID, então é o ID especificado na criação da ação.
- compliance: O novo nível de conformidade (definido entre 0 e 1).
Saída¶
Nenhum
Modificar o nível de conformidade de uma Ação de Forçar Atualização de Caminho¶
Em C++ e Python¶
Explicação¶
Modifica o nível de conformidade de uma Ação de Forçar Atualização de Caminho ativada anteriormente. O void * retornado ao ativar a ação deve ser usado para modificar o nível de conformidade da ação em C++. Em Python, use o ID especificado na função ByID ao criá-lo para modificar o nível de conformidade.
Formato¶
void AKIActionModifyEnRouteAssignmentAction( void * action, double compliance);
void AKIActionModifyEnRouteAssignmentActionByID( int idAction, double compliance);
Parâmetros¶
- action: O ponteiro para a ação que foi retornado ao ativar a ação.
- idAction: O identificador da ação retornado quando a ação foi ativada. Se a ação foi criada usando uma função byID, então é o ID especificado na criação da ação.
- compliance: O novo nível de conformidade (definido entre 0 e 1).
Saída¶
Nenhum
Ler o número de Ações de Cenário¶
Em C++ e Python¶
Explicação¶
Lê o número de ações de gerenciamento de tráfego que estão selecionadas no cenário atual.
Formato¶
int AKIGetNbScenarioActions();
Saída¶
O número de ações de gerenciamento de tráfego (incidentes, fechamento de conversões, etc.) selecionadas no cenário (ou o experimento, em caso de estratégias).
Ler os identificadores de Ação do Cenário¶
Em C++ e Python¶
Explicação¶
Lê os identificadores de ações de gerenciamento de tráfego que estão selecionadas no cenário atual.
Formato¶
int AKIGetScenarioActions ( int * actions );
Parâmetros¶
- actions Um vetor de tamanho AKIGetNbScenarioActions.
Saída¶
Ações contém os identificadores das ações de gerenciamento de tráfego (incidentes, fechamento de conversões, etc.) selecionadas no cenário (ou o experimento, em caso de estratégias).
Ler se uma Ação de Gerenciamento de Tráfego está ativa ou não¶
Em C++ e Python¶
Explicação¶
Lê se a ação de gerenciamento de tráfego fornecida está ativa ou não.
Formato¶
bool AKIIsActionActive( int actionId )
Parâmetros¶
- actionId: O identificador da ação de gerenciamento de tráfego.
Saída¶
- True: a ação está