Informações de Rede da API do Aimsun Next (Meso)¶
Funções relacionadas a Informações da Rede Meso¶
Ler o Número de Seções¶
Em C++ e Python¶
Explicação¶
Lê 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
Ler 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
- índice: índice da seção de 0 a AMesoGetNumberSections
Saída¶
- > 0: Número de seções na rede viária
- < 0: Erro
Ler o Número de Tipos de Veículos¶
Em C++ e Python¶
Explicação¶
Ler o número total de tipos de veículo.
Formato¶
int AMesoNumberVehicles (void * simhandler);
Parâmetros:¶
- simhandler: manipulador do simulador
Saída¶
- > 0: Número de tipos de veículo
- < 0: Erro
Ler 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 const char * genérico.
- = NULL: Erro
Ler o ID do Tipo de Veículo¶
Em C++ e Python¶
Explicação¶
Ler o ID do tipo de veículo usando o nome do tipo de veículo. Observe que o parâmetro de entrada é um const unsigned short . Talvez seja necessário 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
Ler o índice de veículos¶
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
Ler 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
Ler o Número de Centroides de Origem¶
Em C++ e Python¶
Explicação¶
Ler o número de centroides de origem.
Formato¶
int AMesoGetNumberOriginCentroids (void * simhandler);
Parâmetros:¶
- simhandler: manipulador do simulador
Saída¶
- > 0: Número de centroides de origem na rede viária
- < 0: Erro
Ler o Número de Centroides de Destino ¶
Em C++ e Python¶
Explicação¶
Leia o número de centroides de destino.
Formato¶
int AMesoGetNumberDestinationCentroids (void * simhandler);
Parâmetros:¶
- simhandler: manipulador do simulador
Saída¶
- > 0: Número de centroides de origem na rede viária
- < 0: Erro
Ler o Identificador do Centroide de Origem¶
Em C++ e Python¶
Explicação¶
Ler o id do centroide de origem por índice.
Formato¶
int AMesoOriginCentroidId (void * simhandler, int index);
Parâmetros:¶
- simhandler: manipulador do simulador
- índice: índice de 0 a AMesoGetNumberOriginCentroids-1
Saída¶
- > 0:Identificador da origem
- < 0: Erro
Ler o Identificador do Centroide de Origem¶
Em C++ e Python¶
Explicação¶
Ler o id do centroide de origem por índice.
Formato¶
int AMesoOriginCentroidId (void * simhandler, int index);
Parâmetros:¶
- simhandler: manipulador do simulador
- índice: índice de 0 a AMesoGetNumberOriginCentroids-1
Saída¶
- > 0:Identificador da origem
- < 0: Erro
Ler o identificador externo do Centroide de Origem¶
Em C++ e Python¶
Explicação¶
Ler o identificador externo do centroide de origem por índice. O intervalo do índice é de 0 a AMesoGetNumberOriginCentroids()
Formato¶
const unsigned short * AMesoOriginExternalId (void * simhandler, int index);
Parâmetros:¶
- simhandler: manipulador do simulador
- índice: índice de 0 a AMesoGetNumberOriginCentroids-1
Saída¶
- Identificador externo da origem
Ler o identificador externo do centroide de destino¶
Em C++ e Python¶
Explicação¶
Lê o identificador externo do centroide de destino por índice. O intervalo de índices é de 0 a AMesoGetNumberDestinationCentroids()
Formato¶
const unsigned short * AMesoDestinationExternalId (void * simhandler, int index);
Parâmetros:¶
- simhandler: manipulador do simulador
- índice: índice de 0 a AMesoGetNumberDestinationCentroids-1
Saída¶
- Identificador externo de destino
Ler o Identificador do Centroide de Destino¶
Em C++ e Python¶
Explicação¶
Ler o ID do centroide de destino por índice.
Formato¶
int AMesoDestinationCentroidId (void * simhandler, int index);
Parâmetros:¶
- simhandler: manipulador do simulador
- índice: índice de 0 a AMesoGetNumberDestinationCentroids-1
Saída¶
- > 0: Identificador do destino
- < 0: Erro
Ler o índice do Centroide de Origem¶
Em C++ e Python¶
Explicação¶
Leia o índice do centroide de origem usando o identificador.
Formato¶
int AMesoGetOriginCentroidIndex (void * simhandler, int id);
Parâmetros:¶
- simhandler: manipulador do simulador
- id: Identificador do centroide
Saída¶
- > 0: índice do centroide
- < 0: Erro
Ler o índice do Centroide de Destino¶
Em C++ e Python¶
Explicação¶
Leia o índice do centroide de destino usando o identificador.
Formato¶
int AMesoGetDestinationCentroidIndex (void * simhandler, int id);
Parâmetros:¶
- simhandler: manipulador do simulador
- id: Identificador do centroide
Saída¶
- > 0: índice do centroide
- < 0: Erro
Obter o índice do centroide de origem pelo id externo do centroide¶
Em C++ e Python¶
Explicação¶
Leia o índice do centroide de destino usando o identificador.
Formato¶
int AMesoGetOriginCentroidIndexByExternalId (void * simhandler, const unsigned short * externalId);
Parâmetros:¶
- simhandler: manipulador do simulador
- id: identificador externo usando o formato const unsigned short *. Talvez seja necessário usar a função AMesoConvertToAsciiString para obter o formato char *.
Saída¶
- > 0: índice do centroide
- < 0: Erro
Obter índice do centroide de destino pelo id externo do centroide¶
Em C++ e Python¶
Explicação¶
Leia o índice do centroide de destino usando o identificador.
Formato¶
int AMesoGetDestinationCentroidIndexByExternalId (void * simhandler, const unsigned short * externalId);
Parâmetros:¶
- simhandler: manipulador do simulador
- id: identificador externo usando o formato const unsigned short *. Talvez seja necessário usar a função AMesoConvertToAsciiString para obter o formato char *.
Saída¶
- > 0: índice do centroide
- < 0: Erro
Ler o índice do Centroide de Destino ¶
Em C++ e Python¶
Explicação¶
Leia o índice do centroide de destino usando o identificador.
Formato¶
int AMesoGetDestinationCentroidId (void * simhandler, int id);
Parâmetros:¶
- simhandler: manipulador do simulador
- id: Identificador do centroide
Saída¶
- > 0: índice do centroide
- < 0: Erro
Definir Custo Definido pelo Usuário da Seção ¶
Em C++ e Python¶
Explicação¶
Definir 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
- valor: custo definido pelo usuário
Saída¶
- True: Se o id da seção foi encontrado.
- False: Seção não encontrada.
Definir Custo Definido pelo Usuário 2 da Seção ¶
Em C++ e Python¶
Explicação¶
Definir o custo 2 definido pelo usuário 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
- valor: custo definido pelo usuário
Saída¶
- True: Se o id da seção foi encontrado.
- False: Seção não encontrada.
Definir Custo Definido pelo Usuário 3 da Seção ¶
Em C++ e Python¶
Explicação¶
Defina o custo 3 definido pelo usuário 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
- valor: custo definido pelo usuário
Saída¶
- True: Se o id da seção foi encontrado.
- False: Seção não encontrada.
Obter Custo Definido pelo Usuário da Seção ¶
Em C++ e Python¶
Explicação¶
Obtém 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.
Obter Custo Definido pelo Usuário 2 da Seção ¶
Em C++ e Python¶
Explicação¶
Obter o custo 2 definido pelo usuário 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 2 definido pelo usuário para a seção
- < 0: Erro: Seção não encontrada.
Obter Custo Definido pelo Usuário 3 da Seção¶
Em C++ e Python¶
Explicação¶
Obter o custo 3 definido pelo usuário 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 3 definido pelo usuário para a seção
- < 0: Erro: Seção não encontrada
Obter a semente aleatória da replicação¶
Em C++ e Python¶
Explicação¶
Obter a semente aleatória definida na replicação.
Formato¶
int AMesoGetRandomSeed (void * simhandler);
Parâmetros:¶
- simhandler: manipulador do simulador
Saída¶
- Número de semente aleatória
Obter identificador da replicação¶
Em C++ e Python¶
Explicação¶
Obter o identificador da replicação.
Formato¶
int AMesoGetReplication (void * simhandler);
Parâmetros:¶
- simhandler: manipulador do simulador
Saída¶
- Identificador da replicação
Obter iteração atual¶
Em C++ e Python¶
Explicação¶
Obter 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
Obter 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 do experimento
Saída¶
- valor da variável do experimento no formato const unsigned short
Definir atraso extra de parada para um movimento de conversão¶
Em C++ e Python¶
Explicação¶
Define o atraso extra de parada para o movimento de conversão. Retorna true se o movimento de conversão com section from e section to foi encontrado; false caso contrário.
Formato¶
bool AMesoSetTurnExtraStopDelay( void* simhandler, int sectionIdFrom, int sectionIdTo, double value );
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionIdFrom: do id da seção de origem
- sectionIdTo: para o id da seção
- valor: número do valor, o atraso
Saída¶
- True se pôde definir o parâmetro, false caso contrário.
Obter atraso extra de parada para um movimento de conversão¶
Em C++ e Python¶
Explicação¶
Obter o atraso extra de parada para o movimento de conversão. Retorna -1 se o movimento de conversão com seção de origem e seção de destino não for encontrado.
Formato¶
double AMesoGetTurnExtraStopDelay( void* simhandler, int sectionIdFrom, int sectionIdTo );
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionIdFrom: do id da seção de origem
- sectionIdTo: para o id da seção
Saída¶
- Atraso extra de parada do movimento de conversão ou -1 se não tiver sido definido.
Definir atraso adicional para um movimento de conversão¶
Em C++ e Python¶
Explicação¶
Define o atraso extra para o movimento de conversão. Retorna true se o movimento de conversão com seção de origem e seção de destino foi encontrado, false caso contrário.
Formato¶
bool AMesoSetTurnExtraDelay( void* simhandler, int sectionIdFrom, int sectionIdTo, double value );
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionIdFrom: do id da seção de origem
- sectionIdTo: para o id da seção
- valor: número do valor, o atraso
Saída¶
- True se pôde definir o parâmetro, false caso contrário.
Obter atraso adicional para um movimento de conversão¶
Em C++ e Python¶
Explicação¶
Obtenha o atraso extra para o movimento de conversão. Retorna -1 se o movimento de conversão com seção de origem e seção de destino não foi encontrado.
Formato¶
double AMesoGetTurnExtraDelay( void* simhandler, int sectionIdFrom, int sectionIdTo );
Parâmetros:¶
- simhandler: manipulador do simulador
- sectionIdFrom: do id da seção de origem
- sectionIdTo: para o id da seção
Saída¶
- Atraso extra do movimento de conversão ou -1 se não tiver sido definido.