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).