Guia do Iniciante 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, subpasta /ProgramFiles/Aimsun/Aimsun Next X.X/programming/Aimsun Next microSDK.
Primeiro, copie todo o diretório microSDK do Aimsun Next dos arquivos do sistema para uma nova pasta de documentos com permissões de leitura e gravação.
A pasta microSDK do Aimsun Next contém 4 subpastas:
- ext
- incluir
- lib
- amostras
As pastas ext, include e lib contêm bibliotecas e arquivos de declaração que serão usados para compilar os arquivos DLL (DYLIB para mac) e NÃO DEVE ser modificado. A pasta samples contém cinco exemplos de projetos 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 na cruz à esquerda de microSDKsample.
Edição¶
Os Header e Source Files podem ser exibidos ao clicar duas vezes neles.
Compilação¶
Para criar o arquivo DLL, clique em Build : Rebuild microSDKsample.
A saída da compilação aparece na janela inferior. Verifique erros e avisos!
Há opções para criar uma DLL Debug ou Release. A DLL Debug deve ser usada para o desenvolvimento do projeto, pois permite usar o depurador e acompanhar cada etapa da execução. A DLL Release será executada mais rapidamente e deve ser usada durante a fase operacional.
Alteração do nome da DLL¶
O nome do arquivo de saída pode ser alterado na pasta Propriedades de microSDKsample, acessada com um clique direito na cruz à esquerda de microSDKsample.
Modificação do arquivo XML¶
O arquivo XML pode ser editado com qualquer editor de texto, como o Notepad, por exemplo. Modifique somente a segunda linha de acordo com o nome do arquivo DLL a ser usado:
Versão para Mac¶
Instalação¶
Os arquivos microSDK estão localizados no pacote de instalação do Aimsun Next (DMG), na subpasta programming/Aimsun Next microSDK.
Primeiro, copie toda a pasta programming para a sua pasta Application, onde você instalou previamente o aplicativo Aimsun Next.
A pasta microSDK do Aimsun Next contém 4 subpastas:
- ext
- incluir
- lib
- amostras
As pastas ext, include e lib contêm bibliotecas e arquivos de declaração que serão usados para compilar os arquivos DYLIB e NÃO DEVE ser modificado. A pasta samples contém cinco exemplos de projetos microSDK.
Compilação¶
Para compilar o arquivo DYLIB, abra um terminal, vá para a pasta onde estão os arquivos de cabeçalho e código-fonte, gere os makefiles (qmake
A saída da compilação aparecerá no terminal. Verifique erros e avisos. Se tudo for bem-sucedido, a dylib estará pronta para ser carregada no Aimsun Next
Exemplos¶
Foram fornecidos cinco exemplos de microSDK que abrangem as possibilidades básicas de implementação de modelos comportamentais atualmente disponíveis no microSDK do Aimsun Next:
01_CarFollowingModel: Calcula o novo valor da velocidade e da posição de todos os veículos usando o Gipps Car Following Model. Todas as partes restantes do modelo são controladas pelo modelo padrão.
02_CarFollowingAccelerationModel: Modifica apenas o componente de aceleração do Car Following Model . Qualquer função que retorne uma velocidade positiva (ou nula) pode ser implementada. Todas as partes restantes do modelo são controladas pelo modelo padrão.
03_LaneChangingModel: Usa as faixas válidas definidas pelo modelo de antecipação para determinar se uma mudança de faixa é necessária, procura uma brecha adjacente e realiza uma mudança de faixa se a brecha for aceitável ou se adapta a ela. Todas as partes restantes do modelo são controladas pelo modelo padrão.
04_GiveWayModel: Usa as informações de preferência de passagem de cada veículo para decidir se deve ceder passagem ou não.
05_FullModel: Este exemplo usa todos os algoritmos acima.
Testar os diferentes exemplos¶
Versão para Windows¶
Para testar os diferentes exemplos, siga as etapas detalhadas abaixo:
- Compile 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 se encontra no diretório samples.
- Abra o projeto microSDKsample e coloque um ponto de interrupção 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á calculando.
Versão para Mac¶
Para testar os diferentes exemplos, siga as etapas detalhadas abaixo:
- Vá para a pasta samples e compile o Makefile para o allSample.pro
- Compile e faça o build deles. o *DYLIB será gerado automaticamente dentro de Aimsun Next.app/Contents/PlugIns/aimsun/models.
- Copie o XML do exemplo que deseja testar para essa mesma pasta (Aimsun Next.app/Contents/PlugIns/aimsun/models)
- Inicie o Aimsun Next e abra a Rede: microSDKtestNetwork.ang, que se encontra no diretório samples.
- Execute a simulação microscópica e você verá que o modelo para o qual você copiou o XML é executado por meio da simulação.