Gráficos de erro de Guttman: uma abordagem visual para a análise de escalabilidade

Reichenheim, Michael Eduardo; Moraes, Claudia Leite de; Bastos, João Luiz

doi:10.11606/s1518-8787.2026060007015

person Michael Eduardo Reichenheim

Concepção e planejamento do estudo · Coleta, análise e interpretação dos dados · Elaboração ou revisão do manuscrito · Aprovação da versão final · Responsabilidade pública pelo conteúdo do artigo

school Universidade do Estado do Rio de Janeiro. Instituto de Medicina Social Hésio Cordeiro. Departamento de Epidemiologia. Rio de Janeiro, RJ, Brasil

0000-0001-7232-6745

person Claudia Leite de Moraes

Coleta, análise e interpretação dos dados · Elaboração ou revisão do manuscrito · Aprovação da versão final · Responsabilidade pública pelo conteúdo do artigo

school Universidade do Estado do Rio de Janeiro. Instituto de Medicina Social Hésio Cordeiro. Departamento de Epidemiologia. Rio de Janeiro, RJ, Brasilschool Universidade Estácio de Sá. Programa de Pós-graduação em Saúde da Família. Rio de Janeiro, RJ, Brasil

0000-0002-3223-1634

person João Luiz Bastos

Concepção e planejamento do estudo · Coleta, análise e interpretação dos dados · Elaboração ou revisão do manuscrito · Aprovação da versão final · Responsabilidade pública pelo conteúdo do artigo

school Universidade Federal de Santa Catarina. Departamento de Saúde Pública. Florianópolis, SC, Brasil

0000-0002-1816-0745

personCorrespondência: Michael Reichenheim Universidade do Estado do Rio de Janeiro Rua São Francisco Xavier, 524, Bloco D, 7º andar 20550-013 Rio de Janeiro, RJ, Brasil E-mail: michaelreichenheim@gmail.com

Editor Associado:

Leandro F. M. Rezendehttps://orcid.org/%200000-0002-7469-1399

Conflito de Interesses:

Os autores declaram não haver conflito de interesses.

Argumento	Default	Instruções e explicações
data,	---	Banco de dados especificado pelo usuário.
... (items)	---	Especificado pelo usuário. Os itens devem ser seguidos de vírgula, inclusive o último.
sw	NULL	Caso = TRUE, a variável contendo o peso amostral deve ser indicada (e.g., ‘sw = data$sw_var,’. Veja texto para mais detalhes, assim como no Supplementary Documentation for guttemap v 1.0.
scl	1	Indica o scaling de uma variável interna, visando maximizar a discreção para a projeção à população-alvo se sw é especificado. De forma conexa, mais detalhes encontram-se no texto e documentação suplementar.
sclmsg	FALSE	Por padrão, impede que algumas informações sobre a transformação e scaling de sw sejam impressas no console. Pode (deve) ser configurada para TRUE nas primeiras vezes que a/o usuário usar guttemap para orientar o uso de scl. Mais detalhes encontram-se também no texto e documentação suplementar.
grtit	“Guttman Error Map”	Especifica o título do gráfico. O padrão pode ser sobrescrito com o seu próprio título.
grfont	“Times New Roman”	Caso a/o usuária/o deseje, qualquer outra fonte permitida pelo sistema operacional pode ser especificada.
grsave	FALSE	Não grava o gráfico no HD/SSD do computador por padrão. Caso a/o usuário deseje desconsiderar isso, basta indicar o nome que quer dar ao arquivo a gravar.
grty	“svg”	Usa o formato SVG por padrão, caso “grsave” seja indicado. Esse formato pode ser transformado em objetos editáveis subsequentemente. Muitos outros formatos suportados pelo R podem ser especificados (entre aspas) a critério da/o usuário (por exemplo, PDF, PostScript (PS), JPG, WMF).
titsize	18	Tamanho da fonte usada no título.
xlabsize	12	Tamanho da fonte usada nos rótulos horizontais
ylabsize	12	Tamanho da fonte usada nos rótulos verticais.
valsize	3.5	Tamanho da fonte usada para os valores mostrados dentro dos gráficos, indicando o percentual de pairwise Erros de Guttman.
valformat	%.1f	Indica o número de casas decimais que os valores dentro dos gráficos (EG) devem ser mostrados. O padrão é 1ª casa decimal, mas isso pede ser desconsiderado pela/o usuária/o (e.g., %.3f para mostrar os valores na 3ª casa decimal).
item_position	“bottom”	Indica onde os rótulos dos itens devem ser posicionados no gráfico. O padrão os coloca na parte debaixo do eixo horizontal para conformar com a tradição. No entanto, há vantagem em colocá-lo no topo (especificando “top”), visando uma apreciação vertical dos EG. Mais detalhes no texto.
item_order	“decreasing”	Especifica a ordem em que os itens são posicionados no gráfico. O padrão faz com que a ordem (da esquerda para a direita e de cima para baixo) automaticamente atenda a lógica decrescente de frequência dos itens, pressupondo que quanto menos frequente o item, mais intenso este é. A/o usuária/o pode alterar o padrão, especificando “custom”. Isso leva a ordem de posicionamento àquela especificada pela/o usuária/o no argumento de declaração dos itens.
legposit	“bottom”	Indica onde a legenda deve ser posicionada. Além da parte debaixo, é possível especificar “right”, “left” e “top”. Caso a/o usuário não queira apresentar a legenda, basta especificar “none”.
legtit	“% error”	Especifica o título da legenda. O padrão pode ser sobrescrito com o seu próprio título.
legsize	100	Especifica o tamanho da legenda em relação ao corpo do gráfico. O padrão é máximo, mas a/o usuária/o pode diminuir o tamanho de todo o conjunto (gradiente de cores, título e valores).
obs	FALSE	Exibe o tamanho efetivo da amostra no console se TRUE.
mat	FALSE	Exibe as matrizes calculadas no console se TRUE. Inclui as matrizes de erros de Guttman e dos H de Loevinger referentes aos pares (H_ij), itens (H_i) e total (H_(·)).
tith	FALSE	Se TRUE, exibe os H_i dos itens abaixo do rótulo dos itens no eixo horizontal.
itemh	FALSE	Se TRUE, exibe o H_(·) total da escala no título do gráfico.
nowarn	FALSE	Se TRUE, evita que outras mensagens que não as específicas de guttemap sejam exibidas.
smooth	0	Controla o nível de suavização aplicado ao mapa de erros de Guttman. O padrão “smooth = 0” exibe um standard discrete heatmap; “smooth = 100” cria um heatmap de gradiente contínuo, oferecendo um efeito de gradiente de cores suavizado; valores entre 0 e 100 aplicam suavização parcial, mesclando blocos discretos com um efeito de gradiente contínuo. Mais detalhes no texto.