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.