Todo erro ou aviso do localdatasus vem com um código, por exemplo `[LDS-03]`. `ajuda("LDS-03")` explica o que aconteceu e como resolver. Sem argumento, lista todos os códigos.
Value
Um objeto da classe `localdatasus_ajuda`, impresso na tela: a explicação do código (ou a lista de todos os códigos).
Details
O pacote trabalha em silêncio e mostra só um resumo no fim. Para ver cada etapa (consultas, downloads), use `options(localdatasus.detalhes = TRUE)`.
Códigos de erro e aviso
- LDS-01: UF inválida
A UF precisa ser UMA sigla válida, como "RJ" ou "SP". Como resolver: Use a sigla com duas letras: uf = "RJ".
- LDS-02: Município não encontrado
O nome (ou código) do município não bate com nenhum município do Censo 2022. Como resolver: Confira a grafia (acentos e maiúsculas não importam) ou use o código IBGE: municipio = "330455".
- LDS-03: Município com nome repetido
Existe mais de um município com esse nome no Brasil (ex.: Bom Jardim, em MA, PE e RJ). Como resolver: Diga também a UF: obitos_bairro("Bom Jardim", 2023, uf = "RJ").
- LDS-04: Lugar não informado
A função precisa saber ONDE: um município ou uma UF. Como resolver: Exemplos: municipio = "Rio de Janeiro" ou uf = "RJ".
- LDS-05: Não há dado por bairro para esse lugar
Só algumas secretarias publicam dados por bairro. Para esse lugar e esse tipo de dado, não há fonte pública conhecida. Como resolver: Veja o que existe com onde_tem_bairro(). Para internações, use internacoes_bairro(), que funciona em todas as UFs (pelo CEP).
- LDS-06: Agravo não disponível
Esse agravo não está no TabNet desse lugar. Como resolver: Veja os agravos de cada lugar: subset(onde_tem_bairro(), funcao == "agravos_bairro()").
- LDS-07: Agravo ambíguo
O nome dado combina com mais de um agravo (ex.: "sifilis" = gestante e congênita). Como resolver: Seja mais específico: "sifilis congenita" ou "sifilis gestante".
- LDS-08: CID escrita de forma inválida
A CID deve ser letras (capítulos: "I", "J") OU códigos de 3 caracteres ("I21", "I20-I25"), sem misturar os dois tipos. Intervalos ficam dentro de uma letra. Como resolver: Exemplos válidos: cid = "I"; cid = c("I", "J"); cid = "I21"; cid = "I20-I25".
- LDS-09: CID não disponível nesta fonte
A fonte não permite filtrar por causa, ou nenhum dos códigos pedidos aparece nela (pode não ter havido caso). Como resolver: Tente um capítulo inteiro (cid = "I") ou veja as opções: tabnet_opcoes("RIO-SIM", "filtros", filtro = "Causa (CID10 3C)").
- LDS-10: Variável de 'por' não encontrada
O texto de 'por' não corresponde a nenhuma variável que a fonte permite cruzar. Como resolver: Veja as variáveis possíveis: tabnet_opcoes("RIO-SIM", "colunas") (troque pela fonte certa; veja onde_tem_bairro()).
- LDS-11: Ano fora da base
A fonte não tem dados para algum dos anos pedidos; esses anos foram deixados de fora. Como resolver: Veja os anos disponíveis: tabnet_opcoes("RIO-SIM", "anos").
- LDS-12: Nenhum registro encontrado
A consulta funcionou, mas não há nenhum registro com esses filtros, lugar e anos. Como resolver: Amplie o período, tire filtros ou confira se o agravo teve casos nesses anos.
- LDS-13: Falha de conexão
O site da secretaria (ou do IBGE/DATASUS) não respondeu. Pode estar fora do ar ou lento. Como resolver: Espere alguns minutos e tente de novo. O pacote já tenta 3 vezes. Consultas que já deram certo ficam em cache.
- LDS-14: O site mudou ou respondeu algo inesperado
A página do TabNet não veio no formato esperado. Ou o site está instável, ou mudou o formulário. Como resolver: Tente de novo mais tarde. Se continuar, avise os autores do pacote: o cadastro da fonte pode precisar de ajuste.
- LDS-15: Filtro ou opção do TabNet não encontrado
O rótulo pedido não existe no formulário do site, ou combina com mais de uma opção. Como resolver: Veja as opções exatas com tabnet_opcoes(fonte, "filtros", filtro = "..."). Pode usar só o começo do texto.
- LDS-16: Fonte ou sistema desconhecido
O código da fonte (TabNet) ou do sistema (microdados) não está no cadastro do pacote. Como resolver: Veja as opções com fontes_tabnet() ou sistemas_bairro().
- LDS-17: Coluna não encontrada na tabela
A tabela passada não tem a coluna indicada. Como resolver: Confira o nome da coluna com names(sua_tabela).
- LDS-18: SINASC-RJ só existe para o RJ
Os microdados de nascimentos com CEP e bairro são publicados só pela SES-RJ. Como resolver: Para outras UFs, use nascimentos_bairro() com a capital de SP, ou o TabNet da sua secretaria.
- LDS-19: Arquivo do IBGE não encontrado
O arquivo do IBGE para esse município ou UF não foi achado no servidor. Como resolver: Confira o código do município. Se o problema continuar, o IBGE pode ter mudado o nome do arquivo.
- LDS-20: Faltam pacotes para mapas
Os mapas usam os pacotes sf e ggplot2 (estático) ou sf e leaflet (interativo), que não estão instalados. Como resolver: Instale uma vez: install.packages(c("sf", "ggplot2", "leaflet")).
- LDS-21: Tabela sem dados de lugar para o mapa
A tabela não tem código IBGE do bairro nem coordenadas (lat/lon). Como resolver: Use a tabela devolvida por obitos_bairro(), nascimentos_bairro(), agravos_bairro() ou agregar_bairro().
- LDS-22: Poucos registros ganharam bairro
Uma parte grande dos registros ficou sem bairro, geralmente por CEP genérico (um só CEP para a cidade toda) ou CEP do hospital no lugar do da residência. Como resolver: Não é um erro. Compare bairros dentro do mesmo município e confira attr(x, "cobertura").
- LDS-23: Mais de um ano ou categoria no mapa interativo
O mapa interativo mostra um valor por bairro. Com vários anos ou categorias, o pacote soma tudo. Como resolver: Para um ano só, filtre antes: mapa_interativo(subset(x, ano == 2023)).
Examples
ajuda()
#> Códigos de erro e aviso do localdatasus (use ajuda("LDS-xx") para detalhes):
#>
#> LDS-01 UF inválida
#> LDS-02 Município não encontrado
#> LDS-03 Município com nome repetido
#> LDS-04 Lugar não informado
#> LDS-05 Não há dado por bairro para esse lugar
#> LDS-06 Agravo não disponível
#> LDS-07 Agravo ambíguo
#> LDS-08 CID escrita de forma inválida
#> LDS-09 CID não disponível nesta fonte
#> LDS-10 Variável de 'por' não encontrada
#> LDS-11 Ano fora da base
#> LDS-12 Nenhum registro encontrado
#> LDS-13 Falha de conexão
#> LDS-14 O site mudou ou respondeu algo inesperado
#> LDS-15 Filtro ou opção do TabNet não encontrado
#> LDS-16 Fonte ou sistema desconhecido
#> LDS-17 Coluna não encontrada na tabela
#> LDS-18 SINASC-RJ só existe para o RJ
#> LDS-19 Arquivo do IBGE não encontrado
#> LDS-20 Faltam pacotes para mapas
#> LDS-21 Tabela sem dados de lugar para o mapa
#> LDS-22 Poucos registros ganharam bairro
#> LDS-23 Mais de um ano ou categoria no mapa interativo
ajuda("LDS-03")
#>
#> LDS-03 — Município com nome repetido
#>
#> O que aconteceu:
#> Existe mais de um município com esse nome no Brasil (ex.: Bom Jardim,
#> em MA, PE e RJ).
#>
#> Como resolver:
#> Diga também a UF: obitos_bairro("Bom Jardim", 2023, uf = "RJ").
#>
ajuda(3)
#>
#> LDS-03 — Município com nome repetido
#>
#> O que aconteceu:
#> Existe mais de um município com esse nome no Brasil (ex.: Bom Jardim,
#> em MA, PE e RJ).
#>
#> Como resolver:
#> Diga também a UF: obitos_bairro("Bom Jardim", 2023, uf = "RJ").
#>