Skip to content

Aimsun Next Scripting

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

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

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

  • modificar o modelo
  • importar ou exportar dados
  • realizar cálculos com dados do modelo
  • modificar 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 Python, juntamente com uma introdução ao paradigma de programação orientada a objetos.

Requisitos

Python

O scripting Aimsun Next utiliza um motor Python embutido na versão 6 do Aimsun Next e seguintes. 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ê precisará 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 no site do Python. A versão atual com a qual o Aimsun Next é compatível é o Python 3.10.

Importando módulos adicionais

Para importar módulos adicionais, como xlrd ou win32client para aplicativos de 64 bits, primeiro instale o Python 3 e, em seguida, instale o módulo apropriado (veja o exemplo abaixo).

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

Instalando 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 Python 3 do Aimsun Next.
  2. Instale o Python 3 a partir do site do Python.
  3. Instale o Módulo Adicional do Python a partir da 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. Este caminho foi exibido após a realização da etapa 3. No sistema operacional Windows, você pode definir isso em Propriedades do Sistema > Variáveis de Ambiente > Variáveis do Sistema > Nova > Nome da Variável. Insira PYTHONPATH e Valor da Variável: CAMINHO usando o caminho onde o $PYTHON_LIBRARY_NAME foi instalado.

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

    #Importar os pacotes e módulos necessários
import matplotlib.pyplot as plt
import numpy as np
#Preparar os dados
x = np.linspace(0, 10, 100)
#Plotar os dados
plt.plot(x, x, label='linear')
#Adicionar uma legenda
plt.legend()
#Mostrar o gráfico
plt.show()

Tipos de dados Qt

Na maioria dos métodos em scripting Aimsun Next, os dados usados ou retornados estão em contêineres Qt, como QDate, QTime, etc. Descrições do subconjunto de tipos de dados Qt utilizados pelo Aimsun Next estão disponíveis no site do Projeto Qt.