Pular para o conteúdo

Scripting do Aimsun Next

Esta seção do manual se concentra em scripting, usando a linguagem Python para executar operações com o subconjunto de classes de UI e kernel expostas pelo software.

Seu principal objetivo é descrever quais classes do Aimsun estão disponíveis e como usar seus métodos. Inclui exemplos que introduzirão o uso efetivo de scripting. Também explica boas práticas: o que é permitido, o que não é permitido e qual é a melhor forma de realizar tarefas comuns.

Tarefas típicas que podem ser realizadas com scripting são:

  • modificando o modelo
  • importação ou exportação de dados
  • realizando cálculos com dados do modelo
  • modificando o modelo de metadados.

Esta seção apresenta todos os tópicos relacionados ao Aimsun Next Scripting:

Ensinar programação em Python está além do escopo deste manual; no entanto, há uma breve introdução em programação em Python, juntamente com uma introdução ao Paradigma de programação orientada a objetos.

Requisitos

Python

O scripting do Aimsun Next usa um motor Python incorporado. Isso significa que você não precisa instalar manualmente o Python 3 para escrever e executar scripts dentro do Aimsun Next.

No entanto, se você precisar usar bibliotecas adicionais, você irá é necessário instalar a versão 3 do Python para que o Aimsun Next possa usar o interpretador Python externo, que tem acesso a todas as bibliotecas instaladas.

Você pode baixar o Python 3 em site do Python. A versão atual com a qual o Aimsun Next é compatível é Python 3.12.

Importação de módulos adicionais

Para importar módulos adicionais, como xlrd ou win32client para aplicações 64bit, primeiro instale o Python 3 e depois instale o módulo apropriado (veja o exemplo abaixo).

Observação: No Windows OS, defina os caminhos com "/" em vez de barras invertidas; caso contrário, as tentativas de carregar a biblioteca falharão.

Instalação de uma biblioteca/módulo Python de terceiros

Este procedimento explica como instalar o Python e obter acesso a uma biblioteca Python de terceiros.

  1. Instale o Aimsun Next Python 3.
  2. Instale o Python 3 a partir do site do Python.
  3. Instale o Python Additional Module a partir de uma linha de comando, usando, por exemplo: python -m pip install $PYTHON_LIBRARY_NAME (vamos usar "matplotlib" em nosso exemplo).
  4. Defina a variável de ambiente PYTHONPATH com o valor onde o pip salvou a instalação. Esse caminho foi exibido após realizar a etapa 3. No Windows OS, você pode definir isso em Propriedades do Sistema > Variáveis de Ambiente > Variáveis do Sistema > Novo > Nome da Variável. Insira PYTHONPATH e Valor da Variável: PATH usando o caminho onde $PYTHON_LIBRARY_NAME foi instalado.

  5. Abra o Aimsun Next e crie e execute o seguinte script Python (exemplo) (# = comentários no script):

    #Import the necessary packages and modules
import matplotlib.pyplot as plt
import numpy as np
#Prepare the data
x = np.linspace(0, 10, 100)
#Plot the data
plt.plot(x, x, label='linear')
#Add a legend
plt.legend()
#Show the plot
plt.show()

tipos de dados Qt

A maioria dos métodos em scripting do Aimsun Next usa ou retorna dados em contêineres Qt, como QDate, QTime, etc. Descrições do subconjunto de tipos de dados Qt usados pelo Aimsun Next estão disponíveis em site do Qt Project. A versão do Qt no Next 26 é Qt6.