temperatura
A temperatura é uma informação gerada pelo leggoR usando a classificação dos eventos e seus respecitivos pesos. Quanto mais eventos relevantes a proposição tiver, maior será sua temperatura no período. Portanto, a temperatura é uma medida de quanto a proposição está sendo discutida, mexida e efetivamente em tramitação no Congresso.
O cálculo da temperatrua surgiu com o objetivo de produzir uma metáfora compreensível de quão ativa está a tramitação de uma proposição. A temperatura deve ser um indicativo de atuação recente e de chance de progresso em curto prazo na proposição.
Como já mencionado, a temperatura é calculada a partir dos eventos. Um evento aqui é um evento definido pelo Parlametria. Esses eventos são criados a partir de eventos definidos pela câmara e senado, mas também a partir de outros sinais que o congresso não chama de eventos. Por exemplo, se uma proposição entra na pauta da semana, criamos um evento no parlametria, mas não há um evento correspondente no congresso.
Hoje os eventos têm 3 níveis de prioridade criados manualmente (também chamados de pesos). Esses níveis determinam o quanto eles impactam na temperatura.
Os eventos são classificados ou rotulados usando um conjunto de regras (em expressão regular) aplicadas sobre o texto original do evento na tramitação. A partir dessas regras os eventos recebem um rótulo (ex: aprovacao_parecer, requerimento_urgencia_apresentado) e um título (ex: Aprovação de Parecer, Requerimento de Urgência Aprovado) que são identificados e criados pelo próprio Parlametria. A lista de regras para classificação dos eventos na Câmara encontra-se aqui, para o Senado aqui, e a lista dos títulos dos eventos aqui.
Cada evento rotulado pelo conjunto de regras (expressão regular) tem um peso atribuído. O peso do evento indica o quanto ele impacta na temperatura. Atualmente existem 3 níveis/pesos possíveis (1, 2 ou 3, ou ainda seria_a, serie_b, serie_c em alusão as divisões do campeonato brasileiro de futebol). Os pesos de cada nível estão declarados aqui. A identificação de qual nível cada evento classificado pertence pode ser obtida nos links da seção acima.
Os locais dos eventos também possuem pesos que afetam a temperatura. A depender do local onde o evento aconteceu a temperatura sobe mais. A definição desse peso é feita aqui. A lista de locais para a Câmara aqui e para o Senado aqui.
Todos os eventos considerados na temperatura (mesmo aqueles que não tenham sido classificados/rotulados pelo regex) possuem um peso base para impactar na temperatura. Atualmente este peso base é de 1 e está definido aqui. Na leitura/abstração da temperatura cada unidade pode ser lida/interpretada como 1 grau Celsius.
A temperatura de uma proposição é um conceito criado com o objetivo de medir quão movimentada está a tramitação de um Projeto de Lei num determinado período, indicando quanto esforço tem sido empregado por atores do processo legislativo em avançar/barrar o projeto.
A temperatura de um PL pode ser calculada com diferentes granularidades/períodos (dia, semana, mês). Além disso, é possível escolher o tamanho da janela do histórico recente a ser considerado no cálculo (ex: os últimos 22 dias, ou as últimas 4 semanas). A temperatura de um período é definida como a quantidade de eventos ocorridos nesse período ponderados, estes pesos são dados de acordo com o tipo de evento (despacho, discussão e votação, etc) além do local do evento também influenciar o peso (plenário, ccj, cft, comissões especiais e cae têm um peso maior). A função de temperatura é dada pela fórmula:
onde:
- n é o tamanho da janela móvel a ser utilizada
- j é o índice da janela móvel a ser utilizada
- alpha é a taxa de decaimento (deve estar entre 0 e 1);
- vj é a quantidade de eventos ponderados (requerimentos, votações, etc) do período de índice j na janela;
- t é a temperatura recente do período;
Para acessar o relatório completo sobre o cálculo da temperatura com exemplos e visualizações acesse aqui. Versão em Nov/2020.
Mais análises sobre a temperatura podem ser encontradas aqui.
O diagrama a seguir mostra a arquitetura para o cálculo da temperatura no leggoR:
A seguir apresentaremos o diagrama com mais detalhes do fluxo da informação da temperatura pelo leggoR.
O fluxo do cálculo da temperatura envolve 3 etapas principais:
- Fetcher dos dados de tramitações (rcongresso::fetch_tramitacao, agoradigital::fetch_tramitacao): funções responsáveis por acessar as APIs da Câmara e do Senado para recuperar cada evento de tramitação das proposições.
- Processador dos dados de tramitações (agoradigital::process_tramitacao): função responsável por classificar os eventos da tramitação, atribuir níveis de prioridade (peso dos eventos) e extrair os locais dos eventos.
- Cálculo da temperatura (agoradigital::get_historico_temperatura_recente_id_leggo): função responsável por, a partir dos eventos, calcular a temperatura com a granularidade (período de tempo) e demais parâmetros definidos. Aplicando a fórmula citada acima.
As duas principais funções para o cálculo da temperatura são:
-
get_historico_temperatura_recente_id_leggo: Calcula o histórico de temperatura por proposição (considerando as duas etapas de tramitação (câmara e senado)).
-
get_historico_temperatura_recente: Retorna o histórico da temperatura para uma proposição específica no Congresso a partir dos eventos de tramitação.