Aimsun Next API Informações da Rede (Meso)¶
Funções relacionadas às Informações da Rede Meso¶
Leia o Número de Seções¶
Em C++ e Python¶
Explicação¶
Leia o número de seções presentes na rede viária, incluindo as filas virtuais do modelo. Filas virtuais são consideradas seções internas. Seções internas retornarão -1 com a função AMesoGetSectionId.
Formato¶
int AMesoGetNumberSections (void * simhandler);
Parâmetros:¶
- simhandler: manipulador do simulador
Saída¶
- > 0: Número de seções na rede viária
- < 0: Erro
Leia o Identificador da Seção¶
Em C++ e Python¶
Explicação¶
Obtenha o id da seção com base no índice da seção.
Formato¶
int AMesoGetSectionId (void * simhandler, int index);
Parâmetros:¶
- simhandler: manipulador do simulador
- index: índice da seção de 0 a AMesoGetNumberSections
Saída¶
- > 0: Número de seções na rede viária
- < 0: Erro
Leia o Número de Tipos de Veículos¶
Em C++ e Python¶
Explicação¶
Leia o número total de tipos de veículos.
Formato¶
int AMesoNumberVehicles (void * simhandler);
Parâmetros:¶
- simhandler: manipulador do simulador
Saída¶
- > 0: Número de tipos de veículos
- < 0: Erro
Leia o Nome do Tipo de Veículo¶
Em C++ e Python¶
Explicação¶
Leia o nome do tipo de veículo usando o índice do tipo de veículo.
Formato¶
const unsigned short *AMesoGetVehicleTypeName (void * simhandler, int vehTypePos);
Parâmetros:¶
- simhandler: manipulador do simulador
- vehTypePos: índice de 0 a AMesoNumberVehicles()-1
Saída¶
- <> NULL: Nome do tipo de veículo. Use AMesoConvertToAsciiString para converter para o formato const char * genérico.
- = NULL: Erro
Leia o ID do Tipo de Veículo¶
Em C++ e Python¶
Explicação¶
Leia o ID do tipo de veículo usando o nome do tipo de veículo. Note que o parâmetro de entrada é um const unsigned short . Você pode precisar usar a função AMesoConvertFromAsciiString para converter o unsigned short em char .
Formato¶
int AMesoGetVehicleTypeId(void * simhandler, const unsigned short * vehName);
Parâmetros:¶
- simhandler: manipulador do simulador
- vehName: Nome do tipo de veículo
Saída¶
- >0: ID do tipo de veículo
- -1: erro
Leia o Índice do Veículo¶
Em C++ e Python¶
Explicação¶
Retorna o índice do veículo usado para o ID do veículo especificado.
Formato¶
int AMesoGetVehicleTypeIndex(void * simhandler, int gkid);
Parâmetros:¶
- simhandler: manipulador do simulador
- gkid: ID do tipo de veículo para obter seu índice de 0 a AMesoNumberVehicles()-1
Saída¶
- >0: índice do tipo de veículo
- -1: erro
Leia o ID do Veículo¶
Em C++ e Python¶
Explicação¶
Leia o ID do veículo usando o índice do veículo.
Formato¶
int AMesoGetVehicleGKId (void * simhandler, int vehTypePos);
Parâmetros:¶
- simhandler: manipulador do simulador
- vehTypePos: índice de 0 a AMesoNumberVehicles()-1
Saída¶
- >0: identificador do tipo de veículo
- -1: erro
Leia o Número de Centróides de Origem¶
Em C++ e Python¶
Explicação¶
Leia o número de centróides de origem.
Formato¶
int AMesoGetNumberOriginCentroids (void * simhandler);
Parâmetros:¶
- simhandler: manipulador do simulador
Saída¶
- > 0: Número de centróides de origem na rede viária
- < 0: Erro
Leia o Número de Centróides de Destino ¶
Em C++ e Python¶
Explicação¶
Leia o número de centróides de destino.
Formato¶
int AMesoGetNumberDestinationCentroids (void * simhandler);
Parâmetros:¶
- simhandler: manipulador do simulador
Saída¶
- > 0: Número de centróides de origem na rede viária
- < 0: Erro
Leia o Identificador do Centróide de Origem¶
Em C++ e Python¶
Explicação¶
Leia o id do centróide de origem pelo índice.
Formato¶
int AMesoOriginCentroidId (void * simhandler, int index);
Parâmetros:¶
- simhandler: manipulador do simulador
- index: índice de 0 a AMesoGetNumberOriginCentroids-1
Saída¶
- > 0: identificador de origem
- < 0: Erro
Leia o Identificador do Centróide de Origem¶
Em C++ e Python¶
Explicação¶
Leia o id do centróide de origem pelo índice.
Formato¶
int AMesoOriginCentroidId (void * simhandler, int index);
Parâmetros:¶
- simhandler: manipulador do simulador
- index: índice de 0 a AMesoGetNumberOriginCentroids-1
Saída¶
- > 0: identificador de origem
- < 0: Erro
Leia o identificador externo do centróide de origem¶
Em C++ e Python¶
Explicação¶
Leia o identificador externo do centróide de origem pelo índice. O intervalo do índice é de 0 a AMesoGetNumberOriginCentroids()
Formato¶
const unsigned short * AMesoOriginExternalId (void * simhandler, int index);
Parâmetros:¶
- simhandler: manipulador do simulador
- index: índice de 0 a AMesoGetNumberOriginCentroids-1
Saída¶
- Identificador externo de origem
Leia o identificador externo do centróide de destino¶
Em C++ e Python¶
Explicação¶
Leia o identificador externo do centróide de destino pelo índice. O intervalo do índice é de 0 a AMesoGetNumberDestinationCentroids()
Formato¶
const unsigned short * AMesoDestinationExternalId (void * simhandler, int index);
Parâmetros:¶
- simhandler: manipulador do simulador
- index: índice de 0 a AMesoGetNumberDestinationCentroids-1
Saída¶
- Identificador externo de destino
Leia o Identificador do Centróide de Destino¶
Em C++ e Python¶
Explicação¶
Leia o ID do centróide de destino pelo índice.
Formato¶
int AMesoDestinationCentroidId (void * simhandler, int index);
Parâmetros:¶
- simhandler: manipulador do simulador
- index: índice de 0 a AMesoGetNumberDestinationCentroids-1
Saída¶
- > 0: identificador de destino
- < 0: Erro
Leia o Índice do Centróide de Origem¶
Em C++ e Python¶
Explicação¶
Leia o índice do centróide de origem usando o identificador.
Formato¶
int AMesoGetOriginCentroidIndex (void * simhandler, int id);
Parâmetros:¶
- simhandler: manipulador do simulador
- id: Identificador do centróide
Saída¶
- > 0: índice do centróide
- < 0: Erro
Leia o Índice do Centróide de Destino¶
Em C++ e Python¶
Explicação¶
Leia o índice do centróide de destino usando o identificador.
Formato¶
int AMesoGetDestinationCentroidIndex (void * simhandler, int id);
Parâmetros:¶
- simhandler: manipulador do simulador
- id: Identificador do centróide
Saída¶
- > 0: índice do centróide
- < 0: Erro
Obtenha o índice do centróide de origem pelo ID externo do centróide¶
Em C++ e Python¶
Explicação¶
Leia o índice do centróide de origem usando o identificador externo.
Formato¶
int AMesoGetOriginCentroidIndexByExternalId (void * simhandler, const unsigned short * externalId);
Parâmetros:¶
- simhandler: manipulador do simulador
- id: identificador externo usando o formato const unsigned short *. Você pode precisar usar a função AMesoConvertToAsciiString para obter o formato char *.
Saída¶
- > 0: índice do centróide
- < 0: Erro
Obtenha o índice do centróide de destino pelo ID externo do centróide¶
Em C++ e Python¶
Explicação¶
Leia o índice do centróide de destino usando o identificador externo.
Formato¶
int AMesoGetDestinationCentroidIndexByExternalId (void * simhandler, const unsigned short * externalId);
Parâmetros:¶
- simhandler: manipulador do simulador
- id: identificador externo usando o formato const unsigned short *. Você pode precisar usar a função AMesoConvertToAsciiString para obter o formato char *.
Saída¶
- > 0: índice do centróide
- < 0: Erro
Leia o Índice do Centróide de Destino ¶
Em C++ e Python¶
Explicação¶
Leia o índice do centróide de destino usando o identificador.
Formato¶
int AMesoGetDestinationCentroidId (void * simhandler, int id);
Parâmetros:¶
- simhandler: manipulador do simulador
- id: Identificador do centróide
Saída¶
- > 0: índice do centróide
- < 0: Erro
Defina o Custo Definido pelo Usuário da Seção ¶
Em C++ e Python¶
Explicação¶
Defina o custo definido pelo usuário para a seção com id.
Formato¶
bool AMesoSetSectionUserDefinedCost (void * simhandler, int sectionId, double value);
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionId: Identificador da seção
- value: custo definido pelo usuário
Saída¶
- Verdadeiro: Se o id da seção foi encontrado.
- Falso: Seção não encontrada.
Defina o Custo Definido pelo Usuário da Seção 2 ¶
Em C++ e Python¶
Explicação¶
Defina o custo definido pelo usuário 2 para a seção com id.
Formato¶
bool AMesoSetSectionUserDefinedCost2 (void * simhandler, int sectionId, double value);
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionId: Identificador da seção
- value: custo definido pelo usuário
Saída¶
- Verdadeiro: Se o id da seção foi encontrado.
- Falso: Seção não encontrada.
Defina o Custo Definido pelo Usuário da Seção 3 ¶
Em C++ e Python¶
Explicação¶
Defina o custo definido pelo usuário 3 para a seção com id.
Formato¶
bool AMesoSetSectionUserDefinedCost3 (void * simhandler, int sectionId, double value);
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionId: Identificador da seção
- value: custo definido pelo usuário
Saída¶
- Verdadeiro: Se o id da seção foi encontrado.
- Falso: Seção não encontrada.
Obtenha o Custo Definido pelo Usuário da Seção ¶
Em C++ e Python¶
Explicação¶
Obtenha o custo definido pelo usuário para a seção com id.
Formato¶
double AMesoGetSectionUserDefinedCost (void * simhandler, int sectionId);
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionId: Identificador da seção
Saída¶
- > 0: Custo definido pelo usuário para a seção
- < 0: Erro: Seção não encontrada.
Obtenha o Custo Definido pelo Usuário da Seção 2 ¶
Em C++ e Python¶
Explicação¶
Obtenha o custo definido pelo usuário 2 para a seção com id.
Formato¶
double AMesoGetSectionUserDefinedCost2 (void * simhandler, int sectionId);
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionId: Identificador da seção
Saída¶
- > 0: Custo definido pelo usuário 2 para a seção
- < 0: Erro: Seção não encontrada.
Obtenha o Custo Definido pelo Usuário da Seção 3¶
Em C++ e Python¶
Explicação¶
Obtenha o custo definido pelo usuário 3 para a seção com id.
Formato¶
double AMesoGetSectionUserDefinedCost3 (void * simhandler, int sectionId);
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionId: Identificador da seção
Saída¶
- > 0: Custo definido pelo usuário 3 para a seção
- < 0: Erro: Seção não encontrada
Obtenha a Semente Aleatória de Replicação¶
Em C++ e Python¶
Explicação¶
Obtenha a semente aleatória definida na replicação.
Formato¶
int AMesoGetRandomSeed (void * simhandler);
Parâmetros:¶
- simhandler: manipulador do simulador
Saída¶
- Número da semente aleatória
Obtenha o Identificador da Replicação¶
Em C++ e Python¶
Explicação¶
Obtenha o identificador da replicação.
Formato¶
int AMesoGetReplication (void * simhandler);
Parâmetros:¶
- simhandler: manipulador do simulador
Saída¶
- Identificador de replicação
Obtenha a Iteração Atual¶
Em C++ e Python¶
Explicação¶
Obtenha a iteração atual em um DUE.
Formato¶
int AMesoGetCurrentIteration (void * simhandler);
Parâmetros:¶
- simhandler: manipulador do simulador
Saída¶
- Número da iteração atual
Obtenha o valor de uma variável de experimento¶
Em C++ e Python¶
Explicação¶
Retorna o valor de uma variável de experimento. O valor retornado pode ser transformado em um const char * genérico usando a função AMesoConvertToAsciiString.
Formato¶
const unsigned short * AMesoGetValueForExperimentVariable(void * simhandler, const char * stringvalue);
Parâmetros:¶
- simhandler: manipulador do simulador
- stringvalue: nome da variável de experimento
Saída¶
- valor da variável de experimento no formato const unsigned short
Defina o atraso extra de parada para uma conversão¶
Em C++ e Python¶
Explicação¶
Defina o atraso extra de parada para a conversão. Retorna verdadeiro se a conversão com a seção de origem e a seção de destino foi encontrada, falso caso contrário.
Formato¶
bool AMesoSetTurnExtraStopDelay( void* simhandler, int sectionIdFrom, int sectionIdTo, double value );
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionIdFrom: id da seção de origem
- sectionIdTo: id da seção de destino
- value: valor numérico, o atraso
Saída¶
- Verdadeiro se conseguiu definir o parâmetro, falso caso contrário.
Obtenha o atraso extra de parada para uma conversão¶
Em C++ e Python¶
Explicação¶
Obtenha o atraso extra de parada para a conversão. Retorna -1 se a conversão com a seção de origem e a seção de destino não foi encontrada.
Formato¶
double AMesoGetTurnExtraStopDelay( void* simhandler, int sectionIdFrom, int sectionIdTo );
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionIdFrom: id da seção de origem
- sectionIdTo: id da seção de destino
Saída¶
- Atraso extra da conversão ou -1 se não foi definido.
Defina o atraso extra para uma conversão¶
Em C++ e Python¶
Explicação¶
Defina o atraso extra para a conversão. Retorna verdadeiro se a conversão com a seção de origem e a seção de destino foi encontrada, falso caso contrário.
Formato¶
bool AMesoSetTurnExtraDelay( void* simhandler, int sectionIdFrom, int sectionIdTo, double value );
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionIdFrom: id da seção de origem
- sectionIdTo: id da seção de destino
- value: valor numérico, o atraso
Saída¶
- Verdadeiro se conseguiu definir o parâmetro, falso caso contrário.
Obtenha o atraso extra para uma conversão¶
Em C++ e Python¶
Explicação¶
Obtenha o atraso extra para a conversão. Retorna -1 se a conversão com a seção de origem e a seção de destino não foi encontrada.
Formato¶
double AMesoGetTurnExtraDelay( void* simhandler, int sectionIdFrom, int sectionIdTo );
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionIdFrom: id da seção de origem
- sectionIdTo: id da seção de destino
Saída¶
- Atraso extra da conversão ou -1 se não foi definido.