Tendências comparativas de ICSAP
compare_icsap_trendsRead-onlyIdempotent
Análise temporal comparativa de ICSAP entre UFs ou grupos CSAP. Calcula tendências, variação anual e identifica melhores/piores desempenhos. Para percentage e count valem todos os anos do SIH (desde 1992); rate_per_10k exige população e aceita só os anos de get_available_years.population_years. Em 1992–1997 a ICSAP vem de lista CID-9 DERIVADA e não oficial (g03 e g05 não comparáveis com 1998+) e uf é a UF do arquivo — ver as notes. Percentual no universo do pacote R csapAIH por padrão (universe): fora do numerador e do denominador as internações por procedimento obstétrico, parto e longa permanência.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end_year | Yes | Ano final | |
| universe | No | Universo do % ICSAP: 'csapaih' (padrão) tira do numerador e do denominador as internações por procedimento obstétrico, com diagnóstico de parto (O80-O84) e as AIH de longa permanência, como o pacote R csapAIH (Nedel); 'all' conta todas as internações. | |
| indicator | No | Indicador: percentage (% ICSAP), count (número), rate_per_10k (taxa) | |
| compare_by | No | Comparar por UF ou grupo CSAP | |
| start_year | Yes | Ano inicial | |
| compare_values | No | Valores específicos para comparar (UFs ou grupos CSAP) | |
| include_trend_line | No | Incluir análise de tendência linear (default: true) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Sempre vazio: só aparece no caminho de erro-mole do funil | |
| note | No | Como obter o dado (por exemplo, consultar get_available_years) | |
| error | No | Motivo pelo qual não há dados nesta resposta (ano sem dado, cobertura populacional, falha na consulta) | |
| notes | No | Avisos que qualificam os números: era CID-9, raça/cor ausente, universo do % ICSAP, denominador populacional, truncamento | |
| period | No | ||
| series | No | Pontos em ordem cronológica | |
| trends | No | Tendência por valor comparado; só com `include_trend_line` e ao menos dois anos — ausente quando desligada | |
| summary | No | ||
| indicator | No | Indicador das séries | |
| compare_by | No | Eixo comparado: uf, csap_group ou total (sem eixo) | |
| provenance | Yes | Um bloco por procedência que contribuiu com esta resposta (SIH, lista CSAP, csapAIH, população…); licenças nunca se fundem | |
| attribution | Yes | URLs canônicas das fontes desta resposta (lista de atribuição) | |
| published_years | No | Anos que o canal de cubos publica — a verdade do canal, distinta do que esta instância tem em disco; só com o cache de cubos ligado | |
| population_years | No | Cobertura populacional; só no erro-mole de `rate_per_10k` fora do intervalo | |
| available_sih_years | No | Anos com dados SIH atendíveis por este servidor | |
| years_not_available | No | Presente só quando parte dos anos pedidos não tem dado: os números cobrem apenas os anos atendidos |