Package: acR 0.6.1

Anderson Henrique

acR: Content Analysis in R: Integrated Qualitative (LLMs) and Quantitative Pipeline

Provides an integrated pipeline for content analysis combining qualitative coding assisted by large language models (LLMs) with classical quantitative text analysis. Includes modules for pre-processing (tokenization, stopwords for Brazilian Portuguese), descriptive statistics, keyness, co-occurrence networks, word clouds (including comparative and X-ray variants), sentiment analysis via OpLexicon, Latent Dirichlet Allocation (LDA), inter-coder reliability metrics (Krippendorff, Gwet), and modern visualizations based on ggplot2. Special focus on Brazilian corpora and political-institutional codebooks. Inspired by Maerz and Benoit (2025) <https://quallmer.github.io/quallmer/>.

Authors:Anderson Henrique [aut, cre]

acR_0.6.1.tar.gz
acR_0.6.1.zip(r-4.7-any)acR_0.6.1.zip(r-4.6-any)acR_0.6.1.zip(r-4.5-any)
acR_0.6.1.tgz(r-4.6-any)acR_0.6.1.tgz(r-4.5-any)
acR_0.6.1.tar.gz(r-4.7-any)acR_0.6.1.tar.gz(r-4.6-any)
acR_0.6.1.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
acR/json (API)

# Install 'acR' in R:
install.packages('acR', repos = c('https://andersonheri.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/andersonheri/acr/issues

Pkgdown/docs site:https://ahenriquecp.com

On CRAN:

Conda:

6.70 score 4 stars 25 scripts 581 downloads 75 exports 29 dependencies

Last updated from:46f6bf9bfc. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK248
source / vignettesOK474
linux-releaseOK244
macos-releaseOK199
macos-oldrelOK217
windows-develOK179
windows-releaseOK199
windows-oldrelOK209
wasm-releaseOK161

Exports:ac_build_dictionaryac_caac_calibrate_tokensac_chat_localac_cleanac_clean_stopwordsac_cluster_documentsac_collocationsac_cooccurrenceac_corpusac_countac_dictionaryac_dictionary_importac_dictionary_loadac_dictionary_saveac_dictionary_validateac_emotionac_estimate_tokensac_exportac_fetch_camaraac_fetch_senadoac_importac_keynessac_kwicac_ldaac_lda_tuneac_lexical_diversityac_paletteac_plot_caac_plot_clusterac_plot_cooccurrenceac_plot_keynessac_plot_lda_topicsac_plot_lda_tuneac_plot_lexical_diversityac_plot_readabilityac_plot_sentimentac_plot_temporalac_plot_tf_idfac_plot_top_termsac_plot_wordcloud_comparativeac_plot_wordscoresac_plot_xrayac_plot_zipfac_qual_codeac_qual_codebookac_qual_codebook_addac_qual_codebook_historyac_qual_codebook_hybridac_qual_codebook_mergeac_qual_codebook_removeac_qual_codebook_translateac_qual_export_for_reviewac_qual_import_humanac_qual_irrac_qual_list_modelsac_qual_load_codebookac_qual_recommend_modelac_qual_reliabilityac_qual_reportac_qual_report_fullac_qual_sampleac_qual_save_codebookac_qual_search_literatureac_readabilityac_sentimentac_temporalac_tf_idfac_tokenizeac_top_termsac_wordcloudac_wordscoresas_promptis_ac_corpustheme_ac

Dependencies:askpassclicpp11curldplyrgenericsgluehttr2irrjsonlitelifecyclelpSolvemagrittropensslpillarpkgconfigpurrrR6rlangstringistringrsystibbletidyrtidyselectutf8vctrswithryaml

Análise de sentimento
O que é análise de sentimento com léxico | Quando usar léxico vs. LLM? | 1. Corpus: pronunciamentos sobre uma reforma polêmica | 2. Sentimento por documento | 3. Comparar métodos de agregação | 4. Visualização: barras por documento | 5. Visualização: distribuição (densidade) | 6. Visualização: série ordenada | 7. Agregação por grupo (partido) | 8. Termos-chave dentro do texto (X-ray) | 9. Exportar para artigo/relatório | Referências

Last update: 2026-10-15
Started: 2026-04-17

Introdução ao acR: pipeline integrado de análise de conteúdo
O objeto central: ac_corpus | 1. Frequências e termos salientes | 2. Termos distintivos com keyness | 3. Sentimento por documento (OpLexicon) | 4. Escolher um modelo LLM | 5. Codificação qualitativa com LLM | 6. Validação humana e confiabilidade | Próximos passos | Referências

Last update: 2026-10-15
Started: 2026-04-17

Quickstart: acR em 5 minutos
1 · Um corpus mínimo | 2 · Termos mais frequentes por grupo | 3 · Palavras distintivas de cada lado (keyness) | 4 · Sentimento por documento (OpLexicon PT-BR) | 5 · Escolher um modelo LLM para a próxima etapa | O que vem depois?

Last update: 2026-10-15
Started: 2026-07-16

Agrupamento não supervisionado de documentos
Por que agrupar documentos? | 1. Três famílias, três leituras teóricas | 1.1 Hard clustering (o que esta vignette faz) | 1.2 Soft (fuzzy) clustering | 1.3 Modelos de tópicos (LDA) | 1.4 Como escolher? | 2. Um corpus de dois blocos | 3. Ajuste em três linhas | 4. Seis formas de olhar para o mesmo cluster | 4.1 Dendrograma: a árvore das fusões | 4.2 Projeção PCA: a geometria do corpus | 4.3 Mapa de calor: a assinatura da separação | 4.4 Termos mais distintivos por cluster | 4.5 Curva de silhueta: escolhendo k visualmente | 4.6 Hard vs. soft: comparando com LDA | 5. Validando contra a verdade | 6. Escolhendo o método | 7. E depois? Integrando com o pipeline | Referências

Last update: 2026-10-15
Started: 2026-07-17

Análise de Conteúdo Qualitativa com LLMs
Visão geral | Por que essa ordem, e o que reportar em cada etapa | Quando usar LLM (e quando não usar) | Custo real de um estudo com LLM | Instalação e configuração | Etapa 1: Criar o codebook | Adicionar e remover categorias | Etapa 2: Enriquecer o codebook com literatura | Modo híbrido: definições ancoradas em referências | Modo literature: construção inteiramente baseada em literatura | Etapa 3: Fundir e traduzir codebooks | Fundir dois codebooks | Traduzir para inglês | Etapa 4: Inspecionar histórico e gerar system prompt | Etapa 5: Classificar o corpus | Live view: tirando o LLM do caixa-preta | Etapa 6: Salvar e carregar | Etapa 7: Validação e confiabilidade | Diagnosticando problemas comuns | 1. Categorias com concordância baixa entre k_consistency | 2. LLM devolve categoria fora do codebook | 3. Distribuição colapsada em uma categoria | 4. IRR humana × LLM inaceitável | Etapa 8: Replicabilidade e transparência | Referências

Last update: 2026-10-15
Started: 2026-04-17

Análise de proposições legislativas
Contexto | 1. Instalar e configurar | 2. Corpus | 3. Codebook | 3b. Refinamento do codebook | Adicionar exemplos às categorias | Enriquecer com literatura via LLM | Fundir com codebook de estilo retórico | Gerar system prompt e inspecionar histórico | Salvar o codebook para replicabilidade | 4. Classificação com LLM | 5. Validação humana | 6. Análise por tema e tipo | 7. Exportar resultados | Referências

Last update: 2026-10-15
Started: 2026-04-17

Análise quantitativa de texto
Qual métrica responde qual pergunta? | Sequência sugerida para reportar resultados | 1. Construir o corpus | 2. Limpeza: por que remover stopwords? | 3. Tokenização | 4. Frequência | 5. Top termos: o vocabulário do corpus | 6. Nuvem de palavras | 6.1 Nuvem comparativa entre grupos | 7. TF-IDF: o que é distintivo em cada documento? | 8. Keyness: o que é distintivo entre grupos? | 9. Rede de co-ocorrência | 9.1 Trocando o peso: PMI em vez de contagem | 9.2 Trocando o layout | 9.3 Coocorrência como matriz (heatmap) | Novidades: diagnóstico de corpus, escalas e dicionários | 10. Legibilidade e diversidade lexical | 11. Lei de Zipf: o corpus se comporta como linguagem natural? | 12. Concordância (KWIC) e colocações | 12.1 KWIC: ver cada ocorrência em contexto | 12.2 Colocações: associação estatística entre palavras | 13. Análise temporal/diacrônica | 14. Escalonamento Wordscores: posicionar documentos numa escala | 15. Dicionários multi-categoria, emoções e validação | 15.1 Dicionário multi-categoria | 15.2 Léxico de emoções | 15.3 Validação contra codificação humana | 16. Análise de correspondência (CA): um mapa de grupos e termos | Referências

Last update: 2026-10-15
Started: 2026-04-17

Modelagem de tópicos com LDA
O que é LDA e para que serve | LDA vs. clustering vs. LLM | 1. Corpus: agenda legislativa | 2. Preparar: limpeza e remoção de stopwords | 3. Escolher K: quantos tópicos? | Antes de rodar: o prior α importa em textos curtos | 4. Treinar o modelo LDA | 5. Termos por tópico (matriz β) | 6. Distribuição de tópicos por documento (matriz γ) | 7. Interpretação e nomeação dos tópicos | 8. Visualizando as misturas: γ como heatmap | 9. Exportar | Referências

Last update: 2026-10-15
Started: 2026-04-17

Replicabilidade ponta-a-ponta: do codebook ao relatório de método
O pipeline em 6 etapas | 1. Corpus | 2. Codebook | 3. Classificação com live view | 4. Amostra para revisão humana | 5. Confiabilidade inter-codificador | 6. Relatório de método: replicabilidade automática | Fluxo completo em 6 linhas | Referências

Last update: 2026-10-15
Started: 2026-07-17

Classificação com LLM Local em Escala
Visão geral | 1. Conectando a um servidor local | 2. Dimensionando o contexto antes de gastar uma chamada | 3. Rodando em lotes com checkpoint | 4. Lidando com falhas técnicas | 5. Validação humana por categoria (multilabel) | 6. Auditando a configuração da execução | Referências

Last update: 2026-10-15
Started: 2026-10-14

Readme and manuals

Help Manual

Help pageTopics
Construir um dicionário multi-categoriaac_build_dictionary
Análise de correspondência (CA) entre documentos/grupos e termosac_ca
Calibrar a razao caracteres/token contra um modelo realac_calibrate_tokens
Conectar a um servidor LLM local compativel com OpenAIac_chat_local
Limpar e normalizar texto de um corpusac_clean
Inspecionar e editar stopwords extras do acRac_clean_stopwords
Agrupamento não supervisionado de documentosac_cluster_documents
Identificar colocações com medidas de associação estatísticaac_collocations
Calcular co-ocorrências de termosac_cooccurrence
Construir um corpus para análise de conteúdoac_corpus
Contar frequências de tokens ou n-gramas em um corpusac_count
Classificar conteúdo com um dicionário multi-categoriaac_dictionary
Importar um dicionário de uma tabela em formato longoac_dictionary_import
Salvar ou carregar um dicionário em YAMLac_dictionary_load ac_dictionary_save
Validar um dicionário contra codificação humanaac_dictionary_validate
Classificar emoções com um léxico de palavra-emoçãoac_emotion
Estimar número de tokens de um textoac_estimate_tokens
Exporta resultados de análise de conteúdo em múltiplos formatosac_export
Busca discursos de deputados federais via API da Camara dos Deputadosac_fetch_camara
Busca discursos de senadores federais via senatebRac_fetch_senado
Importar arquivos para um corpus acRac_import
Calcular estatísticas de keyness entre dois gruposac_keyness
Concordância (keyword-in-context, KWIC)ac_kwic
Ajustar modelo LDA (Latent Dirichlet Allocation)ac_lda
Ajustar múltiplos modelos LDA para selecionar kac_lda_tune
Calcular diversidade lexical (riqueza de vocabulário)ac_lexical_diversity
Paleta categórica do acRac_palette
Visualizar um biplot de análise de correspondênciaac_plot_ca
Visualiza um objeto ac_clusterac_plot_cluster
Visualizar rede de co-ocorrência de termosac_plot_cooccurrence
Plotar estatísticas de keynessac_plot_keyness
Visualizar top termos por tópicoac_plot_lda_topics
Visualizar curva de seleção de k (perplexidade)ac_plot_lda_tune
Visualizar diversidade lexical por grupoac_plot_lexical_diversity
Visualizar legibilidade por grupoac_plot_readability
Visualizar sentimento ao longo dos documentosac_plot_sentiment
Visualizar uma série temporal de conteúdoac_plot_temporal
Plotar termos mais caracteristicos por tf-idfac_plot_tf_idf
Plotar termos mais frequentesac_plot_top_terms
Nuvem de palavras comparativa entre gruposac_plot_wordcloud_comparative
Visualizar escores Wordscores por documentoac_plot_wordscores
Gráfico X-ray: dispersão lexical de termos no corpusac_plot_xray
Visualizar a Lei de Zipf (frequência × posto)ac_plot_zipf
Classificar textos com LLM usando um codebookac_qual_code
Criar um codebook para análise de conteúdo qualitativaac_qual_codebook
Adicionar categoria a um codebook existenteac_qual_codebook_add
Exibir histórico de modificações de um codebookac_qual_codebook_history
Enriquecer codebook com literatura via LLM (modo híbrido)ac_qual_codebook_hybrid
Fundir dois codebooks em umac_qual_codebook_merge
Remover categoria de um codebook existenteac_qual_codebook_remove
Traduzir codebook para outro idioma via LLMac_qual_codebook_translate
Exportar amostra para revisão humana em Excelac_qual_export_for_review
Importar classificação humana de Excelac_qual_import_human
Calcular métricas de confiabilidade inter-anotadorac_qual_irr
Listar modelos LLM disponíveis para análise de conteúdoac_qual_list_models
Carregar codebook de arquivo YAMLac_qual_load_codebook
Recomendar modelo LLM para análise de conteúdo qualitativaac_qual_recommend_model
Calcular confiabilidade entre codificação LLM e humanaac_qual_reliability
Gerar relatório de replicabilidade da análise qualitativaac_qual_report
Gerar relatório consolidado de múltiplas variáveis de conteúdoac_qual_report_full
Amostrar documentos para validação humanaac_qual_sample
Salvar codebook em arquivo YAMLac_qual_save_codebook
Buscar referências bibliograficas sobre um conceito via OpenAlex e LLMac_qual_search_literature
Calcular legibilidade textual (Índice de Flesch adaptado ao português)ac_readability
Análise de sentimento com OpLexiconac_sentiment
Agregar uma métrica por período de tempoac_temporal
Calcular tf-idf para termos em documentos ou gruposac_tf_idf
Tokenizar textos de um corpus acRac_tokenize
Selecionar os termos mais frequentesac_top_terms
Criar nuvem de palavrasac_wordcloud
Escalonamento ideológico de documentos pelo método Wordscoresac_wordscores
Converter codebook em system prompt para LLMas_prompt as_prompt.ac_codebook as_prompt.default
Verificar se um objeto é um corpus do 'acR'is_ac_corpus
Tema visual consistente do acRtheme_ac