API Aimsun Next para Pedestres¶
Funções relacionadas a Pedestres¶
Introduzir Pedestres no modelo¶
Em C++ e Python¶
Explicação¶
Introduza Pedestres no modelo definindo sua origem, destino, rota e o número de pedestres. Usando este método, os pedestres entrarão no modelo assim que puderem. Ao usar a função com a opção de Atribuição Dinâmica de Transporte Público, a função gerará apenas um pedestre usando uma viagem multimodal.
Formato¶
int AKIGeneratePedestrians(int fromCentroid, int toCentroid, int idRoute, double nbPedestrians);
Parâmetros¶
- fromCentroid O id do Centróide de Entrada do Pedestre.
- toCentroid: O id do Centróide de Saída do Pedestre.
- idRoute O id da rota que os pedestres irão seguir. Se definido como -1, os pedestres seguirão o caminho mais curto para seu destino.
- nbPedestrians: O número de pedestres a serem gerados.
Saída:
- ≥ 0: Os pedestres entraram com sucesso no modelo.
- < 0: Erro
Introduzir Pedestres no modelo durante um intervalo de tempo¶
Em C++ e Python¶
Explicação¶
Introduza Pedestres no modelo definindo sua origem, destino, rota, o número de pedestres e o intervalo de tempo. Usando este método, os pedestres entrarão no modelo utilizando uma distribuição uniforme durante o intervalo de tempo.
Formato¶
int AKIGeneratePedestriansInTime(int fromCentroid, int toCentroid, int idRoute, double nbPedestrians, double timeInterval);
Parâmetros¶
- fromCentroid: O id do Centróide de Entrada do Pedestre.
- toCentroid: O id do Centróide de Saída do Pedestre.
- idRoute: O id da rota que os pedestres irão seguir. Se definido como -1, os pedestres seguirão o caminho mais curto para seu destino.
- nbPedestrians: O número de pedestres a serem gerados.
- *timeInterval: O intervalo de tempo em segundos quando os pedestres serão gerados.
Saída¶
- ≥ 0: Os pedestres entraram com sucesso no modelo.
- < 0: Erro
Ler a Informação Estática de um Pedestre¶
Em C++ e Python¶
Explicação¶
Ler a informação estática de um pedestre. A informação estática são as características do pedestre que foram definidas quando o pedestre entrou no sistema.
Formato¶
StaticInfPed AKIPedestrianGetStaticInf( std::uint32_t aidPedestrian );
Parâmetros¶
- aidPedestrian: Identificador do Pedestre
Saída¶
struct StaticInfPed {
std::int32_t report;
std::uint32_t id;
std::uint32_t originID;
std::uint32_t destinationID;
std::uint32_t typeID;
double radius;
double preferredWalkSpeed;
double preferredRunSpeed;
};
onde:
- report: 0, OK, caso contrário código de erro
- id: identificador do pedestre
- originID: Identificador da origem de entrada do pedestre.
- destinationID: Identificador do destino de saída do pedestre.
- typeID: Identificador do tipo do pedestre.
- radius: raio do pedestre (m ou pés, dependendo das unidades definidas na rede).
- preferredWalkSpeed: Velocidade de caminhada preferida do pedestre (km/h ou mph, dependendo das unidades definidas na rede).
- preferredRunSpeed: Velocidade de corrida preferida do pedestre (m/s² ou ft/s², dependendo das unidades definidas na rede).
Modificar a Informação Estática de um Pedestre¶
Em C++ e Python¶
Explicação¶
Modificar alguns dos parâmetros estáticos de um pedestre. Parâmetros estáticos são as características do pedestre que foram definidas quando o pedestre entrou no sistema. Os parâmetros estáticos que podem ser alterados são: saída do pedestre, raio, velocidade de caminhada preferida e velocidade de corrida preferida.
Formato¶
void AKIPedestrianSetStaticInf( StaticInfPed newstaticInfPed );
Parâmetros¶
- newstaticInfPed: novos parâmetros estáticos a serem atribuídos ao pedestre com identificador na struct.
Saída¶
- Nenhum
Ler a informação de um Pedestre¶
Em C++ e Python¶
Explicação¶
Ler a informação de um pedestre.
Formato¶
InfPed AKIPedestrianGetInf( std::uint32_t aidPedestrian );
Parâmetros¶
- aidPedestrian: Identificador do Pedestre
Saída¶
struct InfPed {
std::int32_t report;
std::uint32_t id;
InfPosition position;
double speed;
};
onde:
- report: 0, OK, caso contrário o valor representa um código de erro
- id: o identificador do pedestre.
- position: a localização atual do pedestre usando a seguinte struct: struct InfPosition { double x; double y; double z; };
- speed: a velocidade atual do pedestre (em km/h ou mph, dependendo das unidades definidas na rede).