Package index • climasus4r

Importação e Exportação

Funções principais para obter, ler e salvar dados do DATASUS

sus_data_import(): Import and preprocess data from DATASUS with intelligent caching
sus_data_read(): Read Processed Health Data with Batch and Parallel Support
sus_data_export(): Export Processed Health Data with Metadata

Limpeza e Padronização

Tratamento de encoding, nomes de colunas e criação de variáveis

sus_data_clean_encoding(): Detect and correct character encoding issues
sus_data_standardize(): Standardize SUS data column names and values
sus_data_create_variables(): Create Derived Variables for Epidemiological Analysis

Filtros e Seleção

Filtragem por CID, grupos de doenças e demografia

sus_data_filter_cid(): Filter SUS health data by ICD-10 codes or disease groups with multilingual support
sus_data_filter_demographics(): Filter Health Data by Demographic Variables
sus_data_plot_demographics(): Visualise Demographic Profiles from DATASUS Systems
sus_data_plot_aggregate_ts(): Time-Series Plot of Aggregated DATASUS Health Outcomes
sus_data_plot_aggregate_map(): Plot Municipal Map of Aggregated Health Data

Análise e Dados Espaciais

Agregação de séries temporais e junção com malhas geográficas e demograficas

sus_data_aggregate(): Aggregate Health Data into Time Series
sus_spatial_join(): Spatially Link SUS Data to Brazilian Geographic Units
sus_census_join(): Add Census Socioeconomic variables to Health Data
sus_socio_compute_indicators(): Compute Socioeconomic and Epidemiological Indicators
sus_socio_list_indicators(): List Available Indicators in the Catalogue
sus_climate_inmet(): Import and Process INMET Meteorological Data
sus_climate_uniplu(): Import UNIPLU-BR: Unified Brazilian Rainfall Dataset
sus_climate_fill_inmet(): Fill gaps in INMET climate time series using XGBoost
sus_climate_aggregate(): Integration of Climate and Health Data
sus_climate_compute_indicators(): Compute Bioclimatic and Thermal Stress Indicators
sus_climate_plot_fill(): Visualise time-series gap-filling from sus_climate_fill()
sus_climate_plot_aggregate(): Visualise Climate-Health Aggregate Data
sus_climate_compute_heatwaves(): Detect heatwaves using multiple standard methodologies
sus_climate_plot_heatwaves(): Plot and Analyze Heatwave Events
sus_climate_compute_coldwaves(): Detect coldwaves using multiple standard methodologies
sus_climate_plot_coldwaves(): Plot and Analyze Coldwave Events
hw_active_days(): Return daily rows where at least one heatwave method is active
hw_count_by_year(): Count heatwave events by year, station, and method
hw_get_events(): Extract heatwave events table from a climasus_hw result
cw_active_days(): Return daily rows where at least one coldwave method is active
cw_count_by_year(): Count coldwave events by year, station, and method
cw_get_events(): Extract coldwave events table from a climasus_cw result
sus_climate_normals(): Download and Process INMET Climate Normals
sus_climate_normals_meta(): Browse the INMET Climate Normals Catalogue
sus_climate_anomaly(): Climate Anomaly Computation vs. INMET Climatological Normals
sus_climate_compute_spi(): Compute Standardized Precipitation Index (SPI)
sus_climate_compute_spei(): Compute Standardized Precipitation-Evapotranspiration Index (SPEI)
sus_grid_pdsi(): Import Palmer Drought Severity Index (PDSI) for Brazilian Municipalities
sus_grid_smvi(): Import Soil Moisture Volatility Index (SMVI / Flash Drought) Data
sus_grid_era5(): Import ERA5-Land Daily Climate Data for Brazilian Municipalities
sus_grid_pollution_cams(): Import CAMS Pollution Data for Brazilian Municipalities
sus_grid_pollution_ghap(): Import GHAP High-Resolution Pollution Data for Brazilian Municipalities
sus_grid_fires(): Import Fire Hotspot Data for Brazilian Municipalities
sus_grid_chirps(): Import CHIRPS Rainfall Data for Brazilian Municipalities
sus_grid_koppen(): Assign Kopppen-Geiger Climate Zones to Brazilian Municipalities
sus_grid_prodes(): Import PRODES Deforestation Data from TerraBrasilis for Brazilian Municipalities
sus_grid_join(): Join Gridded Environmental Data to Health Data
sus_grid_pollution_merra2(): Import MERRA-2 Pollution Data for Brazilian Municipalities
sus_grid_plot(): Plot a Raster Grid (GeoTIFF/NetCDF) as a Publication-Ready Map

Analise Espacial e Deteccao de Clusters

Autocorrelacao espacial (LISA), deteccao de clusters (Kulldorff), modelos Bayesianos CAR/BYM e regressao espacial (SAR/SEM)

sus_mod_spatial_weights(): Build Spatial Weights from Municipality Polygons
sus_mod_spatial_moran(): Global Moran's I and LISA Local Autocorrelation for Health Outcomes
sus_mod_spatial_scan(): Kulldorff Circular Scan Statistic for Spatial Cluster Detection
sus_mod_spatial_bayes(): Bayesian CAR / BYM Disease Mapping with Climate Covariates
sus_mod_spatial_reg(): Spatial Regression (SAR / SEM / SDM / SAC) for Climate-Health Associations
sus_mod_spacetime_bayes(): Bayesian Spatiotemporal Hierarchical Model with INLA
sus_mod_spacetime_exceedance(): Posterior Exceedance Probabilities from a Spatiotemporal Bayesian Model
sus_mod_spacetime_predict(): Generate Predictions from a Fitted Space-Time Bayesian Model
sus_mod_plot_spacetime(): Visualizations for Space-Time Bayesian Disease Mapping Results
sus_mod_plot_spatial_moran(): Two-Panel LISA Visualisation: Cluster Map and Moran Scatter Plot
sus_mod_plot_spatial_scan(): Choropleth Map of Kulldorff Spatial Scan Cluster Results
sus_mod_plot_spatial_bayes(): Visualizations for Bayesian Spatial Disease Mapping Results

Qualidade e Metadados

Relatórios de qualidade de dados e dicionários de doenças

sus_data_quality_report(): Pipeline-aware data quality report for health data
sus_data_ts_quality(): Time-Series Quality Control for Daily Municipal Health Counts
print(<climasus_ts_quality>): Print a climasus_ts_quality object
summary(<climasus_ts_quality>): Summarise a climasus_ts_quality object
sus_census_select(): Interactive Census Variables Explorer
sus_data_cid_select(): Interactive Disease Groups Explorer
sus_meta(): Manage climasus_df S3 Class Metadata and Storage Backends
sus_welcome(): Display the climasus4r Pipeline Overview
print(<climasus_df>): Print method for climasus_df
`[`(<climasus_df>): Subsetting method for climasus_df
`[[`(<climasus_df>): Column extraction for climasus_df
`$<-`(<climasus_df>): Column assignment for climasus_df
rbind(<climasus_df>): Row binding for climasus_df objects
as.data.frame(<climasus_df>): Coerce climasus_df to plain data.frame (strips metadata)
write_duckdb_climasus(): Write a climasus_df to a persistent DuckDB file
write_parquet_climasus(): Write a climasus_df directly to a Parquet file
sus_as_arrow(): Convert a climasus_df to an Arrow Table with embedded metadata
sus_as_duckdb(): Convert a climasus_df to a DuckDB lazy tbl with embedded metadata

Pipelines Reprodutiveis (RAP)

Exportar, ler, inspecionar, executar e compartilhar pipelines como Reproducible Analytical Pipelines. Integracao com targets, GUI Shiny, receitas YAML e templates de projeto.

sus_rap_export(): Export a climasus4r Pipeline as a Reproducible Analytical Pipeline (RAP)
sus_rap_read(): Read an Exported RAP File
sus_rap_inspect(): Inspect or Diff rap_object(s)
sus_rap_run(): Re-execute an Exported RAP
sus_rap_update(): Update Parameters in an Exported RAP File
sus_rap_targets(): Generate a targets Pipeline from a climasus4r RAP
sus_rap_make(): Execute a targets Pipeline from a RAP
sus_rap_recipe(): Export a RAP as a Compact YAML Recipe
sus_rap_from_recipe(): Import and Optionally Run a RAP Recipe
sus_rap_template(): Scaffold a Reproducible Analytical Pipeline Project
sus_rap_gui(): Launch an Interactive GUI for Editing and Running RAPs

AI e Gerenciamento de Cache

Controle do armazenamento local de arquivos baixados

sus_install_deps(): Install Optional Dependencies for climasus4r
sus_cache_clear(): Clear the Climasus4r cache
sus_cache_info(): Get cache information
sus_chat(): Launch the climasus4r AI Assistant

Modelagem DLNM

Ajuste e visualização de Modelos de Defasagem Distribuída Não-Linear (DLNM), que capturam simultaneamente a não-linearidade e os efeitos defasados de exposições ambientais (temperatura, poluição) sobre desfechos de saúde. Use estas funções para estimar curvas exposição-resposta e de defasagem a partir de dados de séries temporais de mortalidade ou morbidade.

sus_mod_dlnm(): Distributed Lag Non-linear Model (DLNM) for Climate-Health Analyses
sus_mod_plot_dlnm(): Scientific Plots and Tables from a DLNM Fit

Fração e Número Atribuíveis

Estimativa da Fração Atribuível (FA%) e do Número Atribuível (NA) de desfechos de saúde devidos à exposição ao calor, ao frio ou ao total combinado, com intervalos de confiança por bootstrap. Inclui análise de excesso de risco sob cenários contrafactuais (e.g., sem aquecimento global) e visualizações dedicadas para comunicar o impacto em saúde pública.

sus_mod_af(): Attributable Fraction and Number from a DLNM Fit
sus_mod_excess(): Excess Mortality and Morbidity from Climate-Health Time Series
sus_mod_plot_af(): Plots and Tables from an Attributable Fraction Analysis

Meta-análise e Agrupamento

Agrupamento em dois estágios de ajustes DLNM de múltiplas cidades usando mvmeta, produzindo curvas exposição-resposta pooled e BLUPs cidade a cidade. A meta-regressão permite identificar covariáveis de nível municipal (latitude, IDH, urbanização) que explicam a heterogeneidade entre cidades. Use este bloco para análises multicidade e estudos de vigilância climático-epidemiológica em escala nacional.

sus_mod_pool(): Two-Stage Multi-City Pooling of DLNM Estimates
sus_mod_metaregression(): Meta-Regression of Pooled DLNM Estimates with City-Level Covariates
sus_mod_plot_pool(): Plots and Tables from a Pooled DLNM Meta-Analysis

Carga, Sensibilidade e Vulnerabilidade

Quantificação da carga de doença atribuível ao clima (AN, FA, desigualdade de Lorenz), análise comparativa de sensibilidade entre estratos populacionais e construção do Índice de Vulnerabilidade IPCC baseado em três pilares (Exposição, Sensibilidade, Capacidade Adaptativa). Estas funções convertem estimativas epidemiológicas pontuais em indicadores de saúde pública acionáveis para planejamento territorial e ambiental.

sus_mod_burden(): Ranked Disease Burden Table Across Cities or Strata
sus_mod_sensitivity(): Stratified Climate-Health Sensitivity Analysis from DLNM Fits
sus_mod_vulnerability_index(): IPCC 3-Pillar Composite Vulnerability Index for Climate-Health Analysis
sus_mod_plot_burden(): Plots and Tables from a City-Level Disease Burden Analysis
sus_mod_plot_sensitivity(): Plots and Tables from a Multi-Stratum Sensitivity Analysis
sus_mod_plot_vulnerability(): Plots and Tables from an IPCC Vulnerability Index Analysis

Desenhos Epidemiológicos

Implementações de desenhos observacionais clássicos: o caso-cruzado estratificado por tempo (controle interno do indivíduo, ideal para exposições agudas de curto prazo) e a Análise de Séries Temporais Interrompidas (ITS), que avalia o efeito causal de intervenções ou políticas de saúde sobre tendências temporais de desfechos.

sus_mod_casecrossover(): Time-Stratified Case-Crossover Analysis for Climate-Health Data
sus_mod_its(): Interrupted Time Series Analysis for Health Outcome Counts

Análise SWOT Climático-Saúde

Síntese de objetos climasus já processados num quadro SWOT (Forças, Fraquezas, Oportunidades e Ameaças), com pontuações numéricas (0–100) e categóricas configuráveis por quadrante, e visualizações radar, matriz e barras.

sus_mod_swot(): SWOT Analysis for Climate-Health Surveillance
sus_mod_plot_swot(): Plots and Tables from a Climate-Health SWOT Analysis

Detecção de Aglomerados Espaciais

Estatística circular de varredura de Kulldorff para detecção de aglomerados geográficos de excesso de casos. Identifica o aglomerado mais provável e aglomerados secundários significativos via teste de hipóteses Monte Carlo, com mapeamento dos códigos de município correspondentes.

sus_mod_spatial_scan(): Kulldorff Circular Scan Statistic for Spatial Cluster Detection

Machine Learning aplicado Clima e Saúde

Modelagem preditiva baseada em XGBoost com validação cruzada out-of-fold, importância de características e diagnóstico gráfico (observado vs. predito, curva de perda, importância das variáveis). Use quando o objetivo é previsão de desfechos de saúde a partir de preditores climáticos e socioeconômicos, complementando as abordagens causais do DLNM com capacidade preditiva de alta dimensão.

sus_mod_ml(): XGBoost Machine Learning for Climate-Health Outcome Prediction
sus_mod_plot_ml(): Plots and Tables from an XGBoost Machine Learning Model

Métodos S3 dos Modelos

Métodos S3 exportados (print, summary, coef, vcov, tidy, predict) para todas as classes de saída do módulo de modelagem (climasus_dlnm, climasus_af, climasus_pool, climasus_excess, climasus_casecrossover, climasus_its, climasus_sensitivity, climasus_metaregression, climasus_burden, climasus_vi, climasus_ml).

coef(<climasus_dlnm>): Extract coefficients from a climasus_dlnm model
coef(<climasus_metaregression>): Extract pooled coefficients from a climasus_metaregression object
coef(<climasus_pool>): Extract pooled coefficients from a climasus_pool object
coef(<climasus_vi>): Extract VI scores as a named numeric vector
predict(<climasus_ml>): Generate predictions from a climasus_ml model on new data
print(<climasus_af>): Print a climasus_af object
print(<climasus_burden>): Print a climasus_burden object
print(<climasus_casecrossover>): Print a climasus_casecrossover object
print(<climasus_dlnm>): Print a climasus_dlnm model
print(<climasus_excess>): Print a climasus_excess object
print(<climasus_its>): Print a climasus_its object
print(<climasus_metaregression>): Print a climasus_metaregression object
print(<climasus_ml>): Print a climasus_ml object
print(<climasus_pool>): Print a climasus_pool object
print(<climasus_sensitivity>): Print a climasus_sensitivity object
print(<climasus_spacetime_bayes>): Print method for climasus_spacetime_bayes objects
print(<climasus_spacetime_exceedance>): Print method for climasus_spacetime_exceedance objects
print(<climasus_spacetime_pred>): Print method for climasus_spacetime_pred objects
print(<climasus_spatial_bayes>): Print method for climasus_spatial_bayes objects
print(<climasus_spatial_moran>): Print method for climasus_spatial_moran objects
print(<climasus_spatial_reg>): Print method for climasus_spatial_reg objects
print(<climasus_spatial_scan>): Print a climasus_spatial_scan object
print(<climasus_swot>): Print a climasus_swot object
print(<climasus_vi>): Print a climasus_vi object
print(<climasus_weights>): Print method for climasus_weights
summary(<climasus_af>): Summarise a climasus_af object
summary(<climasus_burden>): Summarise a climasus_burden object
summary(<climasus_casecrossover>): Summarise a climasus_casecrossover object
summary(<climasus_dlnm>): Summarise a climasus_dlnm model
summary(<climasus_excess>): Summarise a climasus_excess object
summary(<climasus_its>): Summarise a climasus_its object
summary(<climasus_metaregression>): Summarise a climasus_metaregression object
summary(<climasus_ml>): Summarise a climasus_ml object
summary(<climasus_pool>): Summarise a climasus_pool object
summary(<climasus_sensitivity>): Summarise a climasus_sensitivity object
summary(<climasus_spacetime_bayes>): Summary method for climasus_spacetime_bayes objects
summary(<climasus_spacetime_exceedance>): Summary method for climasus_spacetime_exceedance objects
summary(<climasus_spacetime_pred>): Summary method for climasus_spacetime_pred objects
summary(<climasus_spatial_bayes>): Summary method for climasus_spatial_bayes objects
summary(<climasus_spatial_moran>): Summary method for climasus_spatial_moran objects
summary(<climasus_spatial_reg>): Summary method for climasus_spatial_reg objects
summary(<climasus_spatial_scan>): Summarise a climasus_spatial_scan object
summary(<climasus_swot>): Summarise a climasus_swot object
summary(<climasus_vi>): Summarise a climasus_vi object
summary(<climasus_weights>): Summary method for climasus_weights
tidy(<climasus_af>): Reduce climasus_af to a tidy one-row tibble
tidy(<climasus_burden>): Tidy a climasus_burden object into a flat tibble
tidy(<climasus_casecrossover>): Tidy a climasus_casecrossover object
tidy(<climasus_dlnm>): Reduce climasus_dlnm to a tidy one-row tibble
tidy(<climasus_excess>): Tidy a climasus_excess object into a one-row summary tibble
tidy(<climasus_its>): Tidy a climasus_its object
tidy(<climasus_metaregression>): Tidy a climasus_metaregression object into a summary tibble
tidy(<climasus_ml>): Tidy a climasus_ml object into a flat predictions tibble
tidy(<climasus_pool>): Tidy a climasus_pool object into a one-row summary tibble
tidy(<climasus_sensitivity>): Tidy a climasus_sensitivity object
tidy(<climasus_swot>): Tidy a climasus_swot object into a flat scores tibble
tidy(<climasus_vi>): Tidy a climasus_vi object into a flat tibble
vcov(<climasus_metaregression>): Extract variance-covariance from a climasus_metaregression object
vcov(<climasus_pool>): Extract pooled variance-covariance from a climasus_pool object