Guia do Usuário do Aimsun Next MicroSDK¶
Versão para Windows¶
Instalação¶
Os arquivos do microSDK estão localizados na pasta de instalação do Aimsun Next, /ProgramFiles/Aimsun/Aimsun Next X.X/programming/Aimsun Next microSDK.
Primeiro, copie toda a pasta do Aimsun Next microSDK dos arquivos do sistema para uma nova pasta de documentos com permissões de leitura e escrita.
A pasta do Aimsun Next microSDK contém 4 subpastas:
- ext
- include
- lib
- samples
As pastas ext, include e lib contêm bibliotecas e arquivos de declaração que serão usados para construir os arquivos DLL (DYLIB para mac) e NÃO DEVEM ser modificados. A pasta samples contém cinco exemplos de projetos de microSDK.
Para abrir um projeto, o Visual Studio 2019 deve estar instalado. Clique duas vezes no arquivo microSDKsample.sln de qualquer um dos exemplos. O conteúdo do projeto pode ser visualizado clicando no sinal de mais à esquerda de microSDKsample.
Edição¶
Os Arquivos de Cabeçalho e Fonte podem ser exibidos clicando duas vezes neles.
Compilação¶
Para construir o arquivo DLL, clique em Build : Rebuild microSDKsample.
A saída da compilação aparece na janela inferior. Verifique se há erros e avisos!
Existem opções para compilar uma DLL de Debug ou Release. A DLL de Debug deve ser usada para o desenvolvimento do projeto, pois permite o uso do depurador e segue cada passo da execução. A DLL de Release será executada mais rápido e deve ser usada durante a fase operacional.
Alterando o nome da DLL¶
O nome do arquivo de saída pode ser alterado na pasta de Propriedades do microSDKsample acessada através de um clique direito no sinal de mais à esquerda de microSDKsample.
Modificando o arquivo XML¶
O arquivo XML pode ser editado com qualquer editor de texto, como o Notepad, por exemplo. Modifique apenas a segunda linha de acordo com o nome do arquivo DLL a ser utilizado:
Versão para Mac¶
Instalação¶
Os arquivos do microSDK estão localizados no pacote de instalação do Aimsun Next (DMG), na subpasta programming/Aimsun Next microSDK.
Primeiro, copie toda a pasta de programação para sua pasta de Aplicativos, onde você já instalou o aplicativo Aimsun Next.
A pasta do Aimsun Next microSDK contém 4 subpastas:
- ext
- include
- lib
- samples
As pastas ext, include e lib contêm bibliotecas e arquivos de declaração que serão usados para construir os arquivos DYLIB e NÃO DEVEM ser modificados. A pasta samples contém cinco exemplos de projetos de microSDK.
Compilação¶
Para construir o arquivo DYLIB, abra um terminal, vá para a pasta onde estão os arquivos de cabeçalho e código fonte, gere os arquivos makefiles (qmake
A saída da compilação aparecerá no terminal. Verifique se há erros e avisos. Se tudo for bem-sucedido, o dylib estará pronto para ser carregado no Aimsun Next.
Exemplos¶
Cinco exemplos de microSDK foram fornecidos, cobrindo as possibilidades básicas de implementação do modelo comportamental atualmente disponíveis no microSDK do Aimsun Next:
01_ModeloDeSeguimentoDeCarro: Computa o novo valor para a velocidade e posição de todos os veículos usando o Modelo de Seguimento de Carro de Gipps. Todas as partes restantes do modelo são controladas pelo modelo padrão.
02_ModeloDeAceleraçãoDeSeguimentoDeCarro: Modifica apenas o componente de aceleração do Modelo de Seguimento de Carro. Qualquer função que retorna uma velocidade positiva (ou nula) pode ser implementada. Todas as partes restantes do modelo são controladas pelo modelo padrão.
03_ModeloDeMudançaDeFaixa: Usa as faixas válidas definidas pelo modelo de previsão para determinar se uma mudança de faixa é necessária, procura um espaço adjacente e realiza uma mudança de faixa se o espaço for aceitável ou se adapta a ele. Todas as partes restantes do modelo são controladas pelo modelo padrão.
04_ModeloDeDêPreferência: Usa as informações de dê preferência para cada veículo para decidir se deve ou não dar preferência.
05_ModeloCompleto: Este exemplo usa todos os algoritmos acima.
Testando os diferentes exemplos¶
Versão para Windows¶
Para testar os diferentes exemplos, siga os passos detalhados abaixo:
- Construa a DLL de Debug e copie tanto o arquivo XML quanto o arquivo DLL para o seguinte diretório: "Program Files/Aimsun/Aimsun Next X.X/plugins/aimsun/models"
- Inicie o Aimsun Next e abra a Rede: microSDKtestNetwork.ang que está na pasta de samples.
- Abra o projeto microSDKsample e coloque um ponto de parada em uma das funções do arquivo behavioralModelParticular.cxx.
- Anexe-o ao processo usando: Debug : Attach to Process e selecione o processo "Aimsun Next.exe".
- Execute a simulação e acompanhe o que a DLL está computando.
Versão para Mac¶
Para testar os diferentes exemplos, siga os passos detalhados abaixo:
- Vá para a pasta samples e construa o Makefile para o allSample.pro
- Compile e construa-os. O *DYLIB será gerado automaticamente dentro de Aimsun Next.app/Contents/PlugIns/aimsun/models.
- Copie o XML do exemplo que você deseja testar para essa mesma pasta (Aimsun Next.app/Contents/PlugIns/aimsun/models)
- Inicie o Aimsun Next e abra a Rede: microSDKtestNetwork.ang que está na pasta de samples.
- Execute a simulação microscópica e você verá que o modelo para o qual você copiou o XML é executado através da simulação.