Funções de Custo¶

O editor de funções define vários tipos de funções usando duas linguagens diferentes: Python versão 3 e Lua (algumas funções de custo são excluídas). As funções de custo são apresentadas abaixo:

Funções de Custo

Modelo de pasta de funções ¶

O template do Aimsun Next oferece exemplos das funções de custo codificadas tanto em Python 3 quanto em Lua.

modelo de função

Caixa de diálogo de função ¶

Clique duas vezes em uma função para abrir sua caixa de diálogo. Na caixa de diálogo Função, você pode:

Renomear a função ou definir seu External ID.
Selecione em qual linguagem codificar uma função. Pode ser Python versão 3 ou Lua. Há uma terceira opção chamada "C". Se a opção C for selecionada, entre em contato com support@aimsun.com, pois a função precisa ser codificada internamente.
Altere seu Tipo de função a partir de uma lista suspensa de funções disponíveis (por exemplo, Dynamic Cost,Route Choice, Volume Delay e muitas outras).
Refine o código da função digitando diretamente no Código da função caixa.
Para verificar a validade do código, clique em Verificar. Você será notificado de que o código está correto ou receberá detalhes de quaisquer erros.
Desenhe um gráfico da função (disponível dependendo do tipo de função).

No corpo de uma função, qualquer outra função arbitrária que tenha sido definida fora da declaração da função pode ser usada.

Nota que quando uma função de custo é codificada na linguagem Lua, Lua não permite que o nome de uma variável seja igual ao nome de qualquer função dentro da função de custo. Assim, por exemplo, se você nomear uma função travelTime(), não poderá usar uma variável com o nome travelTime.

Desenhar um Gráfico¶

Como você pode ver na captura de tela anterior, na metade inferior do diálogo Function, dependendo do tipo de função, você pode desenhar um gráfico da função conforme ela se aplica a um objeto na rede.

Para desenhar um gráfico de função:

Selecione nas listas suspensas dos seguintes parâmetros.
- Experimento (um experimento disponível)
- Tipo de Veículo
- Finalidade da Viagem (se disponível, 'None' caso contrário)
Na vista 2D ativa, clique em um objeto que corresponda ao tipo de função (por exemplo, clique em uma seção para uma VDF).
Clique Desenhar para exibir o gráfico.

Aba Uso¶

A aba Usage lista todos os objetos na rede que usam a função.

Editor de Funções

Clique em um objeto listado para centralizá-lo e destacá-lo na visualização 2D.
Clique duas vezes em um objeto para abrir sua caixa de diálogo e inspecionar ou alterar seus parâmetros.

Unidades¶

A unidade de tempo padrão para as funções macroscópicas de atraso e custo nos templates padrão é minutos. A unidade padrão para as funções de custo em simulações dinâmicas é segundos.

Classes de Objetos¶

Os tipos de objeto contêm métodos para obter e definir os atributos do objeto referenciado na chamada da função, por exemplo,

turn.getAttractiveness(vtype)

retorna o valor de atratividade modelado para esse movimento de conversão, para um tipo de veículo especificado.

Uma visão geral completa das classes pode ser encontrada no Documentação de Scripting do Aimsun Next e o detalhe dos métodos e da hierarquia de classes está no Biblioteca de scripts que se refere à referência baseada na web gerada automaticamente para os métodos de script. Esta documentação baseada na web deve ser consultada frequentemente ao escrever funções de script para determinar quais dados estão disponíveis para cada classe de objeto.

Alguns tipos de objeto estarão diretamente acessíveis, pois são argumentos das funções, por exemplo, GKFunctionCostContext ou DTATurning classes de objetos.

Variáveis de Cenário e Experimento¶

Ao escrever funções, variáveis podem ser usadas para definir valores dos parâmetros da função. O valor padrão de uma variável pode ser definido no Editor de cenários ou variado para um experimento no Editor de experimento. Por exemplo, se houver uma variável usada para controlar o valor retornado por uma função de custo, ela é acessada como mostrado aqui:

def pbf(context, line, stop):
    res = context.experiment.getValueForVariable( "$COST").toFloat()
    res += line.getBoardingFare()
    return res

onde $COST é o nome da variável.

Os dados usados nas funções baseadas em viagens ou centroides podem ser armazenados no documento Aimsun como vetores ou como matrizes para dar acesso a eles na função.

Funções de Custo Dinâmico ¶

As funções de Custo Dinâmico permitem que o usuário defina, para cada link, uma função de custo generalizado não restrita apenas ao tempo de viagem. Essas funções são usadas para definir as funções de custo dinâmico que serão utilizadas na Atribuição Dinâmica de Rotas. Elas retornam o custo de um link e podem distinguir por tipo de veículo.

Assinatura:

cost( context, manager, section, turn, travelTime) -> double

em que:

contexto é um GKFunctionCostContext objeto Python.
gerenciador é um DTAManager objeto Python.
seção é um DTASection objeto Python.
movimento de conversão é um DTATurning objeto Python.
travelTime não é usado.

O contexto objeto fornece acesso, por meio dos métodos correspondentes, entre outros, ao tipo de veículo, motivo da viagem, classe de usuário ou experimento para o qual a Dynamic Cost Function está sendo avaliada.

O gerenciador objeto dá acesso à atratividade máxima do movimento de conversão, ao peso da atratividade e ao peso do custo definido pelo usuário.

O seção objeto dá acesso, entre outros, à velocidade, ao comprimento e à capacidade da seção.

O movimento de conversão object dá acesso à origem e ao destino do movimento de conversão, à sua atratividade, comprimento e velocidade.

Exemplo Básico ¶

def cost(context, manager, section, turn, travelTime):
    time = section.getStaTravelT(manager, context.getUserClass())
    dist = section.length3D()
    w = manager.getAttractivenessWeight()
    aTurn = turn.getAttractiveness()
    aMax = manager.getMaxTurnAttractiveness()
    attract = w * (1 - aTurn/aMax)
    cost = 0.9*time + 0.1*dist + attract
    return cost

Exemplo Complexo ¶

Em um exemplo mais complexo, sectionSpeed e turnSpeed são o mínimo entre a velocidade da seção ou do movimento de conversão multiplicada pela aceitação do limite de velocidade do veículo e a velocidade desejada máxima do tipo de veículo. O resultado do custo (res) leva em conta os tempos de viagem em fluxo livre ponderados por um fator de atratividade e, em seguida, é modificado adicionalmente para adicionar um termo para o custo definido pelo usuário mais um custo de pedágio baseado no comprimento da seção e no valor do tempo do veículo.

def cost(context, manager, section, turning, travelTime):
    sectionSpeed = min(
        section.getSpeed()*manager.getNetwork().getVehicleById(context.getVehicle().getId()).getSpeedAcceptanceMean(),
        manager.getNetwork().getVehicleById(context.getVehicle().getId()).getMaxSpeedMean())
    turnSpeed = min(
        turning.getSpeed()*manager.getNetwork().getVehicleById(context.getVehicle().getId()).getSpeedAcceptanceMean(),
        manager.getNetwork().getVehicleById(context.getVehicle().getId()).getMaxSpeedMean())
    attractivityFactor = 1+
        manager.getAttractivenessWeight()*
        (1-turning.getAttractiveness()/manager.getMaxTurnAttractiveness())
    res = (section.length3D()/sectionSpeed+ turning.length3D()/turnSpeed)*attractivityFactor
    res = res + manager.getUserDefinedCostWeight()*section.getUserDefinedCost()
    tollPrice = 10      #units in monetary cost per meter taking also into account time units of VoT
    vehicle = context.getVehicle()
    res = res + (section.length3D()+turning.length3D())*tollPrice/vehicle.getValueOfTimeMean()
    return res

Funções de Custo K-Iniciais ¶

As funções K-Initials Cost permitem ao usuário definir, para cada link, uma função de custo generalizado. Essas funções serão usadas na Dynamic Route Assignment para calcular os K-Initial Shortest Paths.

Assinatura:

kinicost( context, manager, section, turn, funcVolume ) -> double

em que:

contexto é um GKFunctionCostContext objeto Python.
gerenciador é um DTAManager objeto Python.
seção é um DTASection objeto Python.
movimento de conversão é um DTATurning objeto Python.
funcVolume é o volume com o qual avaliar esta função.

O contexto objeto dá acesso, por meio dos métodos correspondentes, entre outros, ao tipo de veículo, propósito da viagem, classe de usuário ou experimento para o qual a K-Initial Cost Function está sendo avaliada.

O gerenciador objeto dá acesso à atratividade máxima do movimento de conversão, ao peso da atratividade e ao peso do custo definido pelo usuário.

O seção objeto dá acesso, entre outros, à velocidade, ao comprimento e à capacidade da seção.

O movimento de conversão object dá acesso à origem e ao destino do movimento de conversão, à sua atratividade, comprimento e velocidade.

O funcVolume objeto é o volume com o qual avaliar esta função.