Estrutura do projeto¶

Um projeto do Aimsun Next pode ser composto por vários arquivos diferentes: o documento do modelo com revisões e backups, fundos, dados reais, caminhos, saídas etc.. Controlar todos os arquivos pode se tornar trabalhoso em projetos complexos; por isso, introduzimos a capacidade de manter todos os arquivos referenciados por um projeto em um conjunto de subpastas que são criadas e mantidas automaticamente.

Isso facilita a criação de backups, o trabalho mais eficiente com revisões, permitindo entregar facilmente os produtos do projeto e, naturalmente, retomar o trabalho em fases futuras de um projeto. Esta nova estrutura de pastas também se aplica aos Tutoriais; após selecionar se deseja abrir a rede inicial ou final, selecione a pasta onde deseja criar a estrutura de pastas do projeto e salvar a rede do tutorial.

Trabalhando com a Estrutura do Projeto¶

Quando um novo Projeto do Aimsun Next é criado, vários diretórios são criados automaticamente no caminho indicado no campo "New Project" > "Folder", ou seja, C:/tmp:

Uma nova pasta é criada com o nome informado no campo "Project Name" (ou seja: test). Dentro dessa pasta, são criados uma subpasta chamada "Model" e o arquivo ReadMe.md. O ReadMe.md o arquivo inclui a "Description" referente ao projeto fornecida pelo usuário:

A pasta "Model" contém outra subpasta chamada "Resources" e o .ang arquivo que recebe o mesmo nome indicado no campo "Folder" (ou seja: test.ang):

A pasta "Resources" é o local onde todos os outros arquivos do projeto são armazenados. Esses arquivos serão organizados em diferentes pastas que são criadas automaticamente pelo Aimsun Next "sob demanda" enquanto o usuário trabalha neste modelo. Para salvar ou ler um arquivo, por padrão será oferecida ao usuário outra pasta dentro da pasta "Resources" para armazenar esse tipo específico de arquivo. Por exemplo, se o usuário quiser criar um novo Initial State (i.e.: test.ais) arquivo, então o caminho padrão oferecido será aquele em "/Resources/Initial States/test.ais" , no entanto, para importar um novo arquivo de imagem, recomenda-se que o arquivo de imagem seja primeiro copiado para dentro da pasta "Maps" e depois importado para continuar com o refinamento da geometria.

Veja a estrutura completa de pastas abaixo:

Se o usuário precisar especificar uma pasta para salvar um arquivo ou ler um arquivo, o Aimsun Next sempre sugerirá a pasta padrão da nova Project Structure relacionada a esse tipo de arquivo. Somente para matrizes OD e arquivos Script, existe o Copiar para a Pasta do Projeto opção que permite que os arquivos sejam armazenados externamente em diferentes diretórios se a caixa de seleção estiver marcada no diálogo.

Observação importante: O nome da pasta "Resources" NUNCA deve ser alterado. Portanto, certifique-se de que esta pasta esteja no mesmo diretório que o arquivo .ang e nunca seja renomeada, removida nem movida para um diretório diferente.

Exemplos¶

Quando escolhemos armazenar uma Path Assignment, ou armazenar externamente um arquivo de matriz/script OD, por padrão esse arquivo será armazenado dentro da Project Structure:

1. Criação de um novo Arquivo de Atribuição de Caminhos (.apa): O caminho padrão criado será "/Project Name > Model > Resources > Path Assignments > pathAssignmentName.apa":

1. Criar uma nova matriz OD e configurá-la manualmente para ser armazenada externamente (.txt): O caminho padrão criado será "/Project Name > Model > Resources > Matrices > matrixName.txt":

Se a matriz OD estiver configurada para ser armazenada externamente, mas em um caminho diferente da pasta padrão Project Structure, então a opção "Copy to Project Folder" é desbloqueada. A caixa de seleção é habilitada por padrão. Se você mantiver a caixa de seleção habilitada e pressionar OK para sair da caixa de diálogo, a matriz OD será copiada para a pasta Project Structure e o caminho será atualizado.

1. Criar um novo script e configurá-lo manualmente para ser armazenado externamente (.txt): O caminho padrão criado será "/Project Name > Model > Resources > Scripts > scriptName.py":

Arquivos de script armazenados externamente também terão a opção Copiar para a Pasta do Projeto opção para permitir a cópia e o uso de qualquer script de qualquer diretório fora da pasta Project Structure chamada "Scripts". Esta opção destina-se a ser usada quando você tem um repositório central de scripts para todos os seus projetos e deseja garantir que esteja sempre acessando a versão mais recente de um script que pode ser modificado externamente.

Conversão de projetos antigos para trabalhar com a Estrutura de Pastas do Projeto¶

O recurso de pastas da Estrutura do Projeto é ativado por padrão ao criar um novo projeto. No entanto, projetos antigos também podem se beneficiar desse recurso. Para ativar a Estrutura do Projeto, o usuário precisa criar manualmente a pasta "Resources" no mesmo local do arquivo .ang. Todos os subdiretórios serão criados automaticamente quando um novo objeto for criado, ou quando qualquer objeto existente for configurado para ser armazenado externamente. Outros arquivos de entrada/saída também podem ser movidos para as pastas correspondentes da Estrutura do Projeto. O usuário também deve converter os caminhos nos objetos correspondentes. Abaixo, você pode encontrar os arquivos incluídos em cada pasta da Estrutura do Projeto:

• Animações: Arquivos de reprodução (.arf), Animação Legion XML (.xml).
• APIs: Arquivos Advanced Programming Application (.py, .pyc e .dll).
• Planos de fundo: Arquivos CAD .(.cad).
• Backup: Fazer backup dos arquivos arquivos .sang, .ang.old.
• FZP: Arquivos com informações sobre veículos geradas em uma microssimulação (.fzp).
• Estados Iniciais: Arquivos de estado inicial armazenados externamente (.ais).
• Análise de links: Salvar e Recuperar dados de Análise de Links (.ala).
• Logs: os arquivos são gerados por Interfaces de Controle Adaptativo e normalmente têm extensão .txt ou .log. Eles se destinam a ser usados para fins de depuração e não são necessários para simulações subsequentes.
• Mapas: arquivos de imagem e desenho vetorial tipos que podem ser importados para um documento Aimsun como blueprints para criar a geometria da rede: .png, .jpg, .gif, .svg, .sid, .ecw, .jp2, .tif, .tiff, .osm, .osm.xml, .shp, .tab, .gml, .gpx, .kml, .mif.
• Matrizes: matrizes OD externas (.txt).
• Saídas: arquivos de saída como .sqlite, .adj, .dis, .dynAdj, .mod, .pdj, .dea.
• Atribuições de caminhos: arquivos de alocação de caminhos (.apa).
• Conjuntos de dados reais: arquivos externos (.csv) recuperados como objetos de conjunto de dados reais.
• Scripts: arquivos de script python armazenados externamente (.py).
• SSAM: arquivos SSAM de saída (.trj).
• Chegadas de Tráfego: arquivos (.ata) que contêm uma lista de todos os veículos gerados em uma simulação dinâmica.

Desativação do gerenciamento automático dos arquivos do projeto¶

Você pode desativar esta funcionalidade renomeando, movendo ou excluindo a pasta "Resources". Certifique-se de manter um backup de todos os arquivos externos utilizados.

Mover ou fazer uma cópia de um modelo¶

Ao trabalhar em um projeto do Aimsun Next, talvez você queira salvar cópias de segurança em vários estados do modelo ou alterar a localização do modelo. Veja abaixo o fluxo de trabalho para manter com segurança cópias de segurança do projeto do Aimsun Next:

1. Crie uma cópia de toda a pasta Model com todas as suas subpastas.
2. Renomeie a pasta (ou seja: usando a data como referência).
3. Para backups, você pode excluir quaisquer arquivos desnecessários (por exemplo, imagens de fundo, matrizes externas que você excluiu no .ang etc.) para economizar espaço, se necessário; você também pode compactar esta pasta, se desejar. Ao mover o modelo para um novo local junto com qualquer outro arquivo, todos os caminhos de arquivo serão atualizados automaticamente conforme explicado abaixo.

caminhos relativos para arquivos externos¶

Usando ou não a estrutura da pasta Resources, para todos os arquivos externos dentro da pasta onde o projeto está armazenado (ou subpastas), todos os caminhos de arquivo salvos são considerados relativos. Isso implica que, se você fizer uma cópia da pasta do seu modelo e colá-la em outro local, o caminho raiz para o arquivo (texto em cinza claro na imagem abaixo) será atualizado automaticamente.