Feat/shapes with stops

[yxuo]

Objetivo

• Criar novo endpoind shape_with_stops, do app do app predictor.
• Este endpoint retorna a junção de shapes e stops com colunas de stoptimes, trips, routes.
• O preditor será o cliente, ele usará esta junção para calcular a previsão de chegada do BRT.

Mudanças

Novo endpoint finalizado: shape_with_stops

• Adicionar colunas restantes no modelo ShapesWithStops

  • predictor/models.py

• Função para gerar consulta de shapes_with_stops, pesquisando por stop_id.

  • predictor/utils.py

    Função principal shapes_with_stops().

  • pontos/utils.py

    Função q_stoptimes__stop_id() para filtrar stop_id ou seus filhos em stops.
    Usado nos endpoints shapes_with_stops e stoptimes.

  • predictor/views.py

    Implementar q_shapes_with_stops() em shapes_with_stops.

    Remover lixo de código.

  • utils/django_utils.py

    get_col(), get_table() - Facilitar obter o nome de tabela e colunas de um modelo.

    postgis_exists() - Verificar se extensão postgis existe.
    Usado em shapes_with_stops() para calcular a distância 3D se existir ou 2D se não.

• README

  • Adicionar informações sobre os novo app, endpoint e parâmetro.

Correções e melhorias

• populate_db - Nova configuração pra escolher extensão do arquivo de tabelas. O padrão é txt.

  • Arquivos afetados:
  • populate_db/populate_db.py
  • populate_db/settings.json

• Corrigir nome do modelo ShapeWithStops para ShapesWithStops.

  • Arquivos afetados:
  • predictor/admin.py
  • predictor/models.py
  • predictor/serializers.py
  • predictor/views.py

• Adição de arquivos para testes:

  • predictor/utils.ipynb

    Testar shapes_with_stops

• Utilitários de Jupyter separados de query_utils.py e movidos para jupyter_utils.py.

  • utils/query_utils.ipynb

    Atualizar mudanças nas funções e implementar integração com Django para realizar os testes.

  • utils/query_utils.py,

    Remover funções de Jupyter.

  • utils/jupyter_utils.py

    Adicionar funções de Jupyter.

• Renomear ShapeWithStops para ShapesWithStops

  • Arquivos afetados:
  • urls.py

    Também renomear endpoint shape_with_stops para shapes_with_stops

  • predictor/models.py
  • predictor/serializers.py
  • predictor/views.py

• README

  • Corrigir URL exemplo de shape_id em stoptimes

Como usar

Estas informações estão disponíveis no README desta atualização.

shapes_with_stops

Objetivo:

• Retornar a junção de shapes e stops com colunas de stoptimes, trips, routes.
• O preditor usará esta junção para calcular a previsão de chegada do BRT.

Endereço:

• /predictor/shapes_with_stops

Parâmetros:

• stop_id - Filtra por 1 ou mais stop_id
  • Uso: stop_id=1,2,3
  • Exemplo real: http://localhost:8010/predictor/shapes_with_stops/?stop_id=1001O00006C0,1003O00006C0

Funcionamento:

1. Obtém o stoptimes com o stop_id passado.
2. Junta stoptimes com shapes, trips, stops e routes.
3. Calcula a distância entre cada shape e o stop e obtém o shape mais próximo

   Por padrão a distância calculada é cartesiana (2D).

   Caso o banco de dados possua a extensão postgis (veja aqui), será calculada a distância geográfica (3D).

4. Adiciona colunas extras:
   • previous_stop_id
   • previous_stop_name
   • next_stop_id
   • next_stop_name

[gmartinsoc]

Ocorreram mudanças no modelo, aguardando GTFS do brt/sppo para validar alterações no script populatedb.