MirandasTech · Manual profissional

Bibliometria com VOSviewer e Bibliometrix

Mapear o campo da sua revisão: os indicadores do corpus, as redes de coautoria, de termos, de fontes e de acoplamento bibliográfico, e o mapa aberto de verdade no VOSviewer Online — com um corpus real de 236 documentos do OpenAlex, scripts rodados de verdade, ferramentas gratuitas e cada fato datado.

SérieManuais MirandasTech · pesquisa científica
Versão1.0 · setembro de 2026
Formato slides
LicençaCC BY 4.0 — cite a fonte
role para começar
Como usarcada slide é um passo que você executa no terminal ou no navegador

Para quem é — e o que você vai saber fazer ao final

Este manual é para pós-graduandos que já fizeram a busca da própria revisão e querem mapear o campo: quem publica, com quem, onde, sobre o quê e quais documentos compartilham referências. Não exige programação: cada comando está pronto para copiar, e a saída ao lado é a saída real de 09/09/2026 sobre um corpus aberto de 236 documentos exportado do OpenAlex. Os mapas foram abertos de verdade no VOSviewer Online (que não exige conta); o VOSviewer desktop e o Bibliometrix não foram executados e são descritos pela documentação oficial — o manual diz isso sempre que acontece.

Ao final, você vai conseguir

  • Explicar o que a bibliometria mede e o que não mede: item, link, força, cluster, os cinco tipos de rede — e por que o Manifesto de Leiden e a DORA proíbem usar isso para julgar pessoas.
  • Exportar o corpus da base certa, no formato que o VOSviewer lê, respeitando os limites de cada base e sem somar bases diferentes.
  • Calcular os indicadores do corpus com indicadores_bibliometricos.py: produção por ano, fontes, autores, citações pelo Crossref e índice h do corpus.
  • Construir as redes com mapa_vosviewer.py ou com o wizard «Create Map» do VOSviewer, e abrir no VOSviewer Online: itens, cores, links, overlay por ano médio.
  • Instalar o Bibliometrix 5.5.0 e abrir o biblioshiny em R, como alternativa sem código.
  • Relatar a seção de método bibliométrico com tudo o que um leitor precisa para reproduzir o mapa — e ler os clusters sem inventar temas.
Regra

Nomes de painéis, botões e opções são os do manual oficial do VOSviewer (versão 1.6.20, de 31/10/2023) e das páginas públicas observadas em 09/09/2026; quando a sua tela divergir, vale a tela. Todo número deste manual tem um arquivo de origem: o CSV do corpus, o JSON do Crossref ou a saída do script que aparece na figura.

Armadilha

Usar o mapa para dizer quem é «o melhor». Um autor com 3 documentos num corpus de 236 não «lidera» nada; um cluster de termos não é um «tema consolidado»; o fator de impacto de um periódico não diz a qualidade de um artigo. A Parte 1 começa por aí, antes de qualquer mapa.

Manuais irmãos

Este manual cuida do mapa do campo. Os passos vizinhos estão nos manuais de Busca (de onde vem o corpus, com string e data registradas), PRISMA (a triagem), Zotero (as referências), Dados (o CSV e o JSON), Git (versionar os arquivos do mapa), LaTeX (a figura no texto), Uso de IA (declarar) e Plugin (o agente que roda os scripts). Hub: mirandastech.com.br/pesquisa.

Introduçãoo roteiro do manual segue a ordem de uma análise bibliométrica

Mapa: da busca registrada ao mapa relatado — e onde cada parte do manual entra

1Busca registradaString, base, data e n no diário (manual de Busca); aqui: 236 registros do OpenAlex, 09/09/2026
2Exportar da baseWeb of Science, Scopus, Dimensions, Lens, PubMed ou API (OpenAlex, Crossref) no formato que o VOSviewer lê
3Indicadoresindicadores_bibliometricos.py: produção por ano, fontes, autores, citações, índice h do corpus
4Redesmapa_vosviewer.py ou o wizard «Create Map»: coautoria, termos, fontes, acoplamento; limiar declarado
5Abrir o mapaVOSviewer (Java) ou VOSviewer Online (navegador, sem login): itens, links, clusters, overlay
6Ler os clustersCom os documentos de cada cluster na mão; rótulo provisório, nunca «tema» sem leitura
7RelatarBase, string, data, n, software e versão, tipo de link, contagem, limiares, itens/links/clusters — na seção de método
ParteO que cobrePassos
1 O que mede e o que não medeLeiden e DORA · os cinco tipos de rede · contagem completa × fracionada · o corpus vem da busca registradaPasso 1
2 Bases e exportaçõesWeb of Science, Scopus, Dimensions, Lens, PubMed, OpenAlex (e o orçamento da API), Crossref · limites · SCImago e a DORA · o que exportarPasso 2
3 Indicadores com scriptindicadores_bibliometricos.py · produção por ano · fontes e autores · citações pelo Crossref e índice hPasso 3
4 VOSviewerO que é · o aviso de segurança · a interface · «Create Map» · thesaurus · arquivos map/network/JSON · mapa_vosviewer.pyPassos 4 e 5
5 VOSviewer OnlineAbrir · termos · painel View · overlay · coautoria · fontes · salvar e compartilhar · docsPasso 5
6 Bibliometrix e outrosbibliometrix 5.5.0 e biblioshiny · CiteSpace · como citar as ferramentasPassos 3 a 5
7 Relatar e fecharA seção de método · ler clusters · plugin · erros comuns · checklist · glossário · referênciasPassos 6 e 7
Como ler

Quem nunca fez bibliometria começa na Parte 1 e não pula a Parte 2: o mapa só é tão bom quanto a exportação. Quem já tem o CSV da busca vai à Parte 3 com o terminal aberto. Quem já tem os arquivos do VOSviewer e só quer ver o mapa vai à Parte 5. Ninguém pula a Parte 7: é ela que torna o mapa reprodutível.

Convenções

Nomes de painel, botão e opção entre «aspas angulares», em inglês como aparecem no VOSviewer. Comandos em blocos com botão «copiar». Capturas de páginas em 1920 × 938, feitas em 09/09/2026 sem login. Figuras de terminal e do VOSviewer Online com «execução real»: corpus de 236 documentos do OpenAlex. Nenhuma senha, chave ou token aparece neste manual nem nos scripts — o Crossref só pede um mailto.

Parte 1O que a bibliometria mede e o que não mede

Indicadores × avaliação: Leiden e DORA; os cinco tipos de rede; contagem completa × fracionada; o corpus vem da busca registrada

Antes do primeiro mapa: o que um indicador descreve e o que ele não julga, o vocabulário do VOSviewer (item, link, força, cluster), os cinco tipos de rede e as duas maneiras de contar — e de onde os 236 documentos da demonstração vieram.

01
O que mede e o que não mede1 de 5 · leidenmanifesto.org · Hicks et al., Nature, 2015 · captura de 09/09/2026

Indicadores descrevem um campo; não avaliam pessoas — os dez princípios do Manifesto de Leiden

Página inicial do Leiden Manifesto for Research Metrics: 10 principles to guide research evaluation, with 25 translations, a video and a blog; Hicks, Wouters, Waltman, de Rijcke, Rafols, Nature, April 23, 2015
Figura 1 leidenmanifesto.org (captura de 09/09/2026): «10 principles to guide research evaluation», 25 traduções, vídeo. Publicado como comentário na Nature em 23/04/2015 por Hicks, Wouters, Waltman, de Rijcke e Rafols (DOI 10.1038/520429a). A avaliação da pesquisa «é cada vez mais guiada por dados e não pelo julgamento de especialistas» — o manifesto existe para corrigir isso.
#Princípio (Manifesto de Leiden, 2015)O que muda no seu mapa
1A avaliação quantitativa deve apoiar a avaliação qualitativa por especialistasO mapa ilustra a revisão; não a substitui
2Medir o desempenho em relação às missões de pesquisa da instituição, grupo ou pesquisadorNenhum indicador vale fora do contexto
3Proteger a excelência da pesquisa localmente relevanteProdução em português não é «menor»
4Manter a coleta de dados e os processos analíticos abertos, transparentes e simplesScripts abertos, base e string declaradas
5Permitir que os avaliados verifiquem dados e análisesCSV e JSON guardados com o texto
6Considerar a variação por área nas práticas de publicação e citaçãoNão comparar contagens entre áreas
7Basear a avaliação de pesquisadores individuais no julgamento qualitativo do seu portfólioSem ranking de pessoas (slide seguinte)
8Evitar concretude equivocada e falsa precisão«Índice h 17» é do corpus, com data e fonte
9Reconhecer os efeitos sistêmicos da avaliação e dos indicadoresO que se mede muda o que se faz
10Examinar os indicadores regularmente e atualizá-losRode de novo antes da defesa; a base mudou
Regra

Bibliometria, neste manual, é descrição do campo: quantos documentos, em que anos, em quais fontes, com quais termos e quem colabora com quem. Toda vez que um número parecer dizer «quem é melhor», volte a esta tabela — é o princípio 7 sendo violado. Os títulos dos princípios foram conferidos na página do manifesto e na Wikipédia em inglês em 09/09/2026.

O que mede e o que não mede2 de 5 · sfdora.org · captura de 09/09/2026

DORA: o fator de impacto de um periódico não é medida da qualidade de um artigo nem de quem o escreveu

Página The Declaration do site da DORA: San Francisco Declaration on Research Assessment, com o texto sobre a necessidade de melhorar a avaliação da pesquisa e a lista de traduções
Figura 2 sfdora.org, «The Declaration» (captura de 09/09/2026): a San Francisco Declaration on Research Assessment nasceu em 2012, na reunião anual da American Society for Cell Biology; o texto lembra que o fator de impacto foi criado para ajudar bibliotecas a escolher assinaturas, não para medir a qualidade científica de um artigo.
O que a DORA pede
  • Não usar métricas baseadas em periódicos, como o fator de impacto, como medida substituta da qualidade de artigos individuais
  • Não usá-las para avaliar as contribuições de um cientista, nem em decisões de contratação, promoção ou financiamento
  • Aos pesquisadores: avaliar pelo conteúdo; citar a literatura primária; usar várias métricas e indicadores ao apresentar o próprio impacto; desafiar práticas que dependem indevidamente do fator de impacto
O que este manual faz com isso
  • A tabela «fontes mais frequentes» diz onde o campo publica, não onde é «melhor» publicar
  • O SJR do SCImago (Parte 2) aparece como descrição de um periódico, com data, e nunca como nota de um artigo
  • Os «mais citados» do corpus vêm do Crossref, com fonte e data; citação mede atenção, não qualidade
  • Nenhum slide ordena pessoas; o script avisa que os nomes vêm «sem desambiguação»
Armadilha

«Vou publicar onde o fator de impacto é maior». Escolher periódico pelo escopo, pela política de acesso aberto e pela avaliação do seu programa é decisão sua e do seu orientador; usar o fator de impacto como atalho é exatamente o que a DORA recomenda desafiar. O plugin (Parte 7) recusa esse pedido e explica por quê.

O que mede e o que não mede3 de 5 · manual do VOSviewer 1.6.20, cap. 2 e seção 3.5.4

Os cinco tipos de rede: o que liga dois itens, qual é a unidade, o que a rede mede e quando usar cada uma

No vocabulário do manual do VOSviewer (cap. 2), um mapa é uma rede de itens (os objetos de interesse) ligados por links (no máximo um por par de itens), cada um com uma força (um valor positivo: quantos documentos os dois coautoraram, em quantos os dois termos coocorrem, quantas referências têm em comum). O VOSviewer agrupa os itens em clusters (cada item em um só, numerados 1, 2, …). O que muda de um mapa para outro é o que conta como link.

Tipo de linkUnidade (item)O que a rede medeQuando usar na sua revisãoNo corpus real
CoautoriaAutores, organizações ou paísesQuem assina documentos com quem; a força é o nº de documentos em comumPara descrever a colaboração do campo: grupos, países, se a colaboração é densa ou esparsa60 autores, 101 links, 25 clusters (Parte 5)
CoocorrênciaPalavras-chave (da base) ou termos (de títulos e resumos, só em inglês)Quais termos aparecem juntos nos mesmos documentos; a força é o nº de documentos em que coocorremPara ver do que o campo fala e como os assuntos se agrupam — o mapa que mais aparece em revisões80 termos, 3.154 links, 2 clusters
CitaçãoDocumentos, fontes, autores, organizações ou paísesQuem cita quem dentro do corpusPara achar os documentos-ponte; exige dados de citação da base (não vem de RIS/EndNote)não construída neste manual (o mapa_vosviewer.py gera coautoria, termos, fontes e acoplamento)
Acoplamento bibliográficoDocumentos, fontes, autores, organizações ou paísesDois documentos se ligam quando citam as mesmas referências; a força é o nº de referências em comumPara agrupar documentos recentes (que ainda não foram citados) por base intelectual comum90 documentos, 138 links, 35 isolados
CocitaçãoReferências, fontes ou autores citadosDuas referências se ligam quando são citadas juntas pelo mesmo documentoPara ver a base clássica do campo: os trabalhos que todo mundo cita em conjuntonão construída neste manual; disponível no wizard do VOSviewer a partir de arquivos das bases
Regra

Escolha o tipo de rede pela pergunta, não pelo desenho: «quem colabora?» é coautoria; «do que se fala?» é coocorrência; «quais documentos partilham base?» é acoplamento; «quais clássicos são citados juntos?» é cocitação. Cada mapa declara o tipo de link e a unidade na legenda (Parte 7).

Pesos e scores

Além dos links, cada item tem pesos (weight: por padrão «Links» e «Total link strength»; «Documents», «Citations» e «Occurrences» como pesos customizados) e pode ter scores para a visualização overlay («Pub. year», «Avg. pub. year», «Citations», «Avg. citations», «Norm. citations»…). Tamanho do círculo = peso; cor no overlay = score.

O que mede e o que não mede4 de 5 · manual do VOSviewer 1.6.20, seção 3.5.4 · exemplo ilustrativo

Contagem completa × fracionada: na completa cada coautoria vale 1; na fracionada vale 1/n para os n coautores

O wizard «Create Map» pergunta o counting method. Na contagem completa (full counting) cada coautoria, coocorrência ou referência em comum vale 1. Na fracionada (fractional counting), o link vale 1/n para cada um dos n coautores — o que reduz o peso dos documentos com muitos autores. O exemplo ao lado é ilustrativo: um único documento assinado por quatro autores, A1 a A4.

Completa (full counting)
  • Um documento com A1, A2, A3 e A4 gera seis links: A1–A2, A1–A3, A1–A4, A2–A3, A2–A4, A3–A4
  • Cada link vale 1
  • Um documento com 30 autores gera centenas de links de força 1: é ele quem «desenha» o mapa
Fracionada (fractional counting)
  • Os mesmos seis links
  • Cada link vale 1/4 (1/n, com n = 4 coautores)
  • O documento com 30 autores pesa o mesmo que o documento com dois: a contagem corrige a hiperautoria
SituaçãoContagem indicada
Coautoria em área com poucos autores por documentoCompleta — é a que os scripts deste manual usam (média de 3,1 autores por documento no corpus real)
Coautoria com documentos de dezenas de autoresFracionada — senão um único consórcio domina o mapa
Coocorrência de termosCompleta costuma bastar; declare
Comparar dois mapasA mesma contagem nos dois; contagens diferentes não se comparam
Regra

A contagem é um parâmetro do método e entra na seção de método (Parte 7): «contagem completa» ou «contagem fracionada», nunca subentendida. Os números de links e de força total mudam com ela — os da demonstração (coautoria: 101 links, força total 202) são de contagem completa.

Termos também têm limiares

Para mapas de termos o manual usa outros dois filtros: o mínimo de ocorrências (padrão 10) e a relevância (por padrão exclui os 40 % de termos menos relevantes). Ambos são parâmetros a declarar (Parte 4).

O que mede e o que não mede5 de 5 · manual de Busca desta série · buscar_openalex.py · diário JSON de 09/09/2026

O corpus vem da busca registrada: string, base, data, período, tipos e n — sem isso, o mapa não se reproduz

Do diário da buscaO corpus da demonstração (real)
Base e ferramentaOpenAlex, pela API, com o buscar_openalex.py do manual de Busca
String"predictive maintenance" AND (port OR terminal OR crane) — em título e resumo
Período e tipos2015–2026; article | book-chapter | preprint
Data09/09/2026 (diário JSON datado)
n235 na contagem da API; 236 registros gravados no CSV; 226 com DOI; 207 com resumo
Colunas do CSVtitle, abstract, year, doi, authors, source, is_oa, type, openalex_id
os arquivos que a Parte 3 e a Parte 4 vão usar — guardados junto com o texto
corpus.csv            # a exportação da busca (236 linhas + cabeçalho)
crossref_refs.json    # citações e referências pelo Crossref (Parte 3)
coautoria_map.txt  coautoria_network.txt  coautoria.json   # as redes (Parte 4)
termos_map.txt     termos_network.txt     termos.json
acoplamento_map.txt acoplamento_network.txt acoplamento.json
Regra

O mapa herda as regras da busca: string e data registradas (PRISMA-S, o BUSCA.md do manual de Busca), nunca somar bases sem deduplicar com critério — e o VOSviewer nem permite combinar arquivos de bases diferentes — e nenhum número no texto sem arquivo de origem. «235 na API e 236 gravados» é o tipo de detalhe que vai para o diário, não para o esquecimento.

Armadilha

Corpus pequeno e recente. 236 documentos, 111 deles de 2026 (ano corrente, parcial): as redes vão ser esparsas (coautoria com 13 isolados) e os clusters de termos, poucos (2). Isso é uma característica do campo naquela data, e o manual vai mostrá-la como tal — não uma falha a esconder com limiares baixos.

Por que OpenAlex

Porque é aberto: o corpus pode ser publicado com o texto (manual de Dados), e o leitor pode refazer a busca. Exportações da Web of Science e do Scopus são licenciadas — ficam fora do repositório (manual de Git) e o texto relata só a string e os agregados.

Parte 2Bases e exportações

De onde vêm os dados: Web of Science, Scopus, Dimensions, Lens, PubMed, OpenAlex e Crossref; os limites de exportação; SCImago e a DORA; o que exportar em cada base

O VOSviewer lê arquivos de cinco bases e consulta sete APIs. As páginas públicas aparecem em capturas de 09/09/2026, sem login; o que exige assinatura (Web of Science, Scopus) é descrito pelo manual do VOSviewer, com os nomes exatos das opções de exportação. Preços e tamanhos de acervo não foram conferidos e não aparecem.

02
Bases e exportações1 de 6 · webofscience.com · scopus.com · manual do VOSviewer 1.6.20 · captura de 09/09/2026

Web of Science e Scopus: as duas bases por assinatura — exportação por lotes (500 e 2.000 documentos) e dados de citação completos

Tela de login da Web of Science, da Clarivate: Sign in to continue with Web of Science, com os campos de e-mail e senha e o login institucional
Figura 3 webofscience.com (captura de 09/09/2026): a tela «Sign in to continue with Web of Science», com «Faça login», «Registre-se» e «Login Institucional». A base é por assinatura; o manual não fez login e descreve a exportação pelo manual do VOSviewer. O Scopus (scopus.com) bloqueou o navegador automatizado pela verificação da Cloudflare e não foi capturado.
BaseExportação que o VOSviewer pede (manual 1.6.20)Limite por vez
Web of Science (Clarivate)«Full Record and Cited References», em arquivo tab-delimited — é o que traz as referências citadas, necessárias para citação, acoplamento e cocitação500 documentos
Scopus (Elsevier)«CSV export» com todos os campos marcados — sem eles o arquivo perde resumos, palavras-chave ou referências2.000 documentos
Regra

Corpus maior que o limite: exporte em lotes (por ano, por exemplo) e abra todos os arquivos juntos no VOSviewer — arquivos da mesma base podem ser combinados, e os documentos duplicados são removidos automaticamente. Bases diferentes não se combinam: um mapa é de uma base só.

Licença

A exportação completa de uma base paga é material licenciado: fica fora do repositório público (manual de Git). No texto e no repositório vão a string, a data, o n, os agregados e a figura do mapa.

Bases e exportações2 de 6 · dimensions.ai · lens.org · manual do VOSviewer 1.6.20 · capturas de 09/09/2026

Dimensions e Lens: uma versão gratuita com conta e uma base aberta sem conta — com «Export for bibliometric mapping» e «Export» CSV

Página inicial do Dimensions, da Digital Science: Intelligent discovery. Faster insight., com os botões Login e Talk to us
Figura 4 dimensions.ai (captura de 09/09/2026): «Intelligent discovery. Faster insight.», da Digital Science. Segundo o manual do VOSviewer, a versão gratuita (com conta) exporta até 2.500 documentos por vez, com a opção «Export for bibliometric mapping».
Página inicial do Lens.org: Explore global science and technology knowledge, com a busca de patentes e scholarly works e o aviso de cookies
Figura 5 lens.org (captura de 09/09/2026): «serve conhecimento científico e de patentes integrado como bem público»; «todos podem acessar e usar o site sem conta e sem custo». Exportação «Export» em CSV; limite citado pelo manual do VOSviewer: 50.000 documentos.
BaseAcessoExportação para o VOSviewerLimite por vez
Dimensions (Digital Science)Versão gratuita com conta (manual do VOSviewer)«Export for bibliometric mapping»2.500
Lens (Cambia)Sem conta e sem custo, segundo a própria página«Export» em CSV50.000
Regra

Para uma revisão que precisa ser reproduzível por qualquer leitor, prefira uma base que ele também possa consultar: Lens e OpenAlex são abertas; Dimensions tem a versão gratuita; Web of Science e Scopus dependem da assinatura da instituição. Registre no diário qual foi e por quê.

Sem números de acervo

A página do Dimensions exibe contagens de registros; a do Lens, versões. Nenhum desses números foi conferido para este manual e nenhum entra aqui — o que vale é o que a sua busca devolveu na sua data.

Bases e exportações3 de 6 · pubmed.ncbi.nlm.nih.gov · api.crossref.org · manual do VOSviewer 1.6.20 · captura de 09/09/2026

PubMed e Crossref: a base aberta da área da saúde («Save», sem dados de citação) e a API gratuita que conta citações por DOI

Resultados do PubMed para a busca bibliometric analysis predictive maintenance, com 15 resultados, os botões Save, Email e Send to e os filtros por ano e texto
Figura 6 PubMed (captura de 09/09/2026), busca «bibliometric analysis predictive maintenance»: os botões «Save», «Email» e «Send to» acima dos resultados. Para o VOSviewer, «Save» no formato PubMed; limite citado pelo manual: 10.000 documentos por vez. O arquivo não traz dados de citação — serve para coautoria e coocorrência, não para citação, acoplamento ou cocitação.
Crossref (api.crossref.org)O que é e o que devolve
AcessoGratuito, sem chave; um mailto na requisição coloca você no polite pool
Por DOIapi.crossref.org/works/<DOI> devolve, entre outros campos, is-referenced-by-count (quantas vezes o documento foi citado no Crossref) e a lista reference (as referências do documento — nem sempre com DOI)
No corpus real226 DOIs consultados, 196 respondidos (195 com contagem), 91 com referências que têm DOI — é esse subconjunto que alimenta o acoplamento bibliográfico (Parte 4)
No VOSviewerUma das sete APIs do wizard «Create Map» (com OpenAlex, Europe PMC, Semantic Scholar, OCC, COCI e Wikidata)
Regra

Citação pelo Crossref conta só o que o Crossref indexa — menos do que Scopus ou Web of Science contariam. Todo número de citação no texto diz a fonte e a data: «1.131 citações somadas (Crossref, 09/09/2026)». Não compare contagens de fontes diferentes.

Bases e exportações4 de 6 · help.openalex.org · api.openalex.org · capturas de 09/09/2026

OpenAlex: a base aberta de onde veio o corpus — e o aviso de 09/09/2026: a API agora tem um orçamento diário que se esgota

OpenAlex Help Center: Get help with OpenAlex, a comprehensive index of the world's research; seções Search, Learn, Reference e Chat
Figura 7 help.openalex.org (captura de 09/09/2026): o Help Center com «Search», «Learn» (Quickstart, How-to guides, Tutorials) e «Reference». O manual de Busca desta série exporta o corpus daqui com o buscar_openalex.py.
OpenAlex Help Center, com a barra lateral Home, Start, How-to, Tutorials, Access, Data, API e App
Figura 8 help.openalex.org (captura de 09/09/2026), a barra lateral com «Access», «Data» e «API». A página openalex.org/pricing ficou atrás da verificação da Cloudflare e não foi capturada; o que se sabe do orçamento vem da própria resposta da API, ao lado.
resposta real da API do OpenAlex à consulta de teste, 09/09/2026 (JSON, sem alteração)
{"error":"Rate limit exceeded",
 "message":"Insufficient budget. This request costs $0.001 but you only have $0.0001 remaining.
            Resets at midnight UTC. Need more? Add funds at https://openalex.org/pricing",
 "creditsRequired":10,"creditsRemaining":1}
Armadilha

A API cobra por requisição. Em 09/09/2026 cada chamada custava um valor em créditos, com um orçamento diário gratuito que se esgota e reinicia à meia-noite UTC. A exportação do corpus deste manual foi feita antes de o orçamento acabar. O VOSviewer também consome essa API quando baixa por URL de requisição («Create a map based on bibliographic data» → OpenAlex): planeje a exportação, guarde o JSON e não repita a busca sem necessidade.

Regra

Exporte uma vez, com data, e trabalhe sobre o arquivo salvo (corpus.csv ou o JSON da API). O VOSviewer aceita «JSON salvo» como fonte: é o caminho que não depende do orçamento do dia. Valores da tabela de preços não aparecem aqui porque não foram conferidos.

Bases e exportações5 de 6 · manual do VOSviewer 1.6.20, seção 3.5.4 · gerenciadores de referências

Resumo: os limites de exportação e a opção exata de cada base — e o que um arquivo RIS ou EndNote não consegue fazer

FonteOpção de exportação (nome no manual)Limite por vezRedes possíveisObservação
Web of Science«Full Record and Cited References», tab-delimited500Coautoria, coocorrência, citação, acoplamento, cocitaçãoAssinatura; combine lotes da mesma base
Scopus«CSV export», todos os campos2.000TodasAssinatura
Dimensions«Export for bibliometric mapping»2.500Coautoria, coocorrência; as de citação conforme os campos do arquivoVersão gratuita com conta
Lens«Export», CSV50.000Coautoria, coocorrência; as de citação conforme os campos do arquivoSem conta e sem custo
PubMed«Save», formato PubMed10.000Coautoria, coocorrência (sem dados de citação)Aberta
APIs (OpenAlex, Crossref, Europe PMC, Semantic Scholar, OCC, COCI, Wikidata)Por URL de requisição, por busca, por lista de DOIs ou por JSON salvoConforme a APIOpenAlex: orçamento diário (slide anterior)
RIS, EndNote, RefWorksArquivo do gerenciador de referênciasCoautoria e coocorrência apenasSem citação, acoplamento ou cocitação
Arquivos do VOSviewermap/network, JSON, GML, PajekA rede já pronta (Parte 4)É o que mapa_vosviewer.py grava
Regra

Antes de exportar, decida a rede: se a pergunta é de citação, acoplamento ou cocitação, o arquivo precisa das referências citadas — «Full Record and Cited References» na Web of Science, «CSV export» com todos os campos no Scopus; um RIS do Zotero ou o «Save» do PubMed não servem. Se a pergunta é de coautoria ou de termos, qualquer fonte da tabela basta. Anote no diário a opção usada, com o nome exato.

Duplicados

Ao abrir vários arquivos da mesma base, o VOSviewer remove documentos duplicados automaticamente. Entre bases diferentes ele não combina — e nem deveria: a deduplicação entre bases é trabalho da triagem (manual de PRISMA), com critério registrado.

Bases e exportações6 de 6 · scimagojr.com · sfdora.org · captura de 09/09/2026

SCImago e o SJR: um indicador de periódico para descrever onde o campo publica — não para dar nota a um artigo

Página inicial do SCImago Journal and Country Rank, com a busca por título de periódico, ISSN ou editora, os menus Journal Rankings e Country Rankings e a seção What is SJR for
Figura 9 scimagojr.com (captura de 09/09/2026): «SCImago Journal & Country Rank», com «Journal Rankings», «Country Rankings» e a busca por título, ISSN ou editora; logo abaixo, «What is SJR for?». O SJR é um indicador de periódico.
Uso descritivo (aceitável)
  • «As 5 fontes mais frequentes do corpus são Zenodo (21), SSRN (9), arXiv (7), Sensors (5) e Sustainability (4)» — três delas são repositórios, não periódicos (Parte 3)
  • Consultar o SJR de Sensors e Sustainability para caracterizar os periódicos em que o campo publica, com a data da consulta
  • Escolher onde submeter pelo escopo, pela política de acesso aberto e pela avaliação do programa — o SJR é um dado entre vários
Uso avaliativo (o que a DORA proíbe)
  • Dizer que um artigo é bom porque saiu num periódico de SJR alto
  • Ordenar os documentos do corpus pelo SJR da fonte
  • Usar o fator de impacto ou o SJR para avaliar a contribuição de um pesquisador, ou em contratação, promoção e financiamento
Regra

Métrica de periódico descreve o periódico. Se a sua revisão citar o SJR, cite como cita qualquer dado: com fonte (scimagojr.com), data e a ressalva da DORA. O plugin (Parte 7) recusa «usa o fator de impacto para escolher onde publicar» e sugere escopo e política de acesso aberto.

Parte 3Indicadores do corpus com script

indicadores_bibliometricos.py; produção por ano e a armadilha do ano corrente; fontes e autores; citações pelo Crossref e índice h do corpus

Quatro slides com o terminal aberto: um script em Python, só biblioteca padrão (e uma figura opcional), lê o corpus.csv de 236 documentos e imprime os indicadores em Markdown, prontos para a seção de resultados. A saída que aparece é a saída real de 09/09/2026 — com as duas lições que o corpus ensinou: repositórios contados como «fonte» e uma organização contada como «autor».

03
Indicadores com script1 de 4 · execução real de 09/09/2026 · Python 3 · corpus de 236 documentos do OpenAlex

indicadores_bibliometricos.py: total, período, autores, tipos, acesso aberto, produção por ano, fontes, autores, citações e índice h — em Markdown

Terminal: python3 scripts/indicadores_bibliometricos.py corpus.csv --citacoes crossref_refs.json --top 5 --figura producao_por_ano.png --markdown indicadores.md, com a saída em Markdown: 236 documentos, 2015–2026, 671 autores, tipos, acesso aberto, produção por ano, fontes, autores, citações e índice h 17
Figura 10 Execução real; corpus de 236 documentos do OpenAlex (captura de 09/09/2026): indicadores_bibliometricos.py corpus.csv --citacoes crossref_refs.json --top 5 --figura producao_por_ano.png --markdown indicadores.md. A saída é Markdown: «Documentos: 236; período: 2015–2026; autores distintos: 671; média de autores por documento: 3,1»; «Tipos: article 193, preprint 27, book-chapter 16»; «Acesso aberto (is_oa=true): 182 de 236 (77 %)»; as tabelas de produção por ano, fontes, autores e citações; «figura: producao_por_ano.png»; «gravado: indicadores.md».
terminal — uso (o CSV é o da busca; o JSON do Crossref é opcional e vem do slide «Citações»)
python3 scripts/indicadores_bibliometricos.py corpus.csv                 # só o CSV: tudo menos citações
python3 scripts/indicadores_bibliometricos.py corpus.csv \
    --citacoes crossref_refs.json \      # citações e índice h do corpus
    --top 5 \                            # tamanho das tabelas (padrão 10)
    --figura producao_por_ano.png \      # gráfico de barras por ano
    --markdown indicadores.md            # grava a saída em Markdown
IndicadorCorpus real (09/09/2026)
Documentos · período236 · 2015–2026
Autores671 distintos; 3,1 por documento
Tiposarticle 193 · preprint 27 · book-chapter 16
Acesso aberto182 de 236 (77 %), pela coluna is_oa
Regra

O script só lê o CSV e o JSON; não consulta a internet e não altera nada. A saída em Markdown vai para o diário e, depois de lida com calma, para a seção de resultados — cada número com o nome do arquivo e a data. O --top controla o tamanho das tabelas; use 10 para a análise e 5 para a figura do artigo.

Indicadores com script2 de 4 · figura gerada pelo script em 09/09/2026 · corpus de 236 documentos do OpenAlex

Produção por ano: de 1 documento em 2015 a 111 em 2026 — e a armadilha de ler o ano corrente, parcial, como alta ou queda

Gráfico de barras Produção por ano (n = 236): de 2015 a 2026, com crescimento acentuado em 2024, 2025 e 2026
Figura 11 producao_por_ano.png, gerada pelo indicadores_bibliometricos.py (execução real; corpus de 236 documentos do OpenAlex, 09/09/2026): «Produção por ano (n = 236)». A barra de 2026 é o ano corrente, parcial — a busca foi feita em setembro.
AnoDocsAnoDocsAnoDocs
2015120194202311
2016420206202426
2017420214202555
20183202272026111 parcial
Armadilha

O ano corrente. Os 111 documentos de 2026 foram contados em 09/09/2026: o ano não acabou, e a base ainda vai indexar o que falta. Escrever «a produção dobrou em 2026» é falsa precisão (Leiden, princípio 8); escrever «a produção caiu» quando a busca é feita em janeiro é o erro inverso. A frase certa diz a data: «até 09/09/2026, 111 documentos de 2026».

Regra

Na figura do artigo, marque o ano corrente como parcial (na legenda ou com hachura) ou corte a série no último ano completo — e diga qual escolha fez. Em 2026 a base registra também preprints (27 no corpus): a série mistura tipos, e a legenda deve dizer isso.

Indicadores com script3 de 4 · saída real de 09/09/2026 (Figura 10) · corpus de 236 documentos do OpenAlex

Fontes e autores: repositórios aparecem como «fonte» e uma organização aparece como «autor» — o script mostra; você corrige e declara

Fonte (como veio da base)DocsO que é
Zenodo (CERN European Organization for Nuclear Research)21repositório
SSRN Electronic Journal9repositório de preprints
arXiv (Cornell University)7repositório de preprints
Sensors5periódico
Sustainability4periódico
Lição 1 — «fonte» não é «periódico»

A coluna source do OpenAlex traz o lugar onde o documento está: para preprints, teses e conjuntos de dados, é um repositório. Antes de escrever «os periódicos mais produtivos», separe por type (article, preprint, book-chapter) — no corpus real, as três «fontes» mais frequentes são repositórios.

«Autor» (sem desambiguação)DocsO que é
AMC Instruments3organização como autor: erro da base
Prashant Mavani3autor
Byunghyun Ban3autor
Xavier Pillet3autor
Fan Yang2autor (nome frequente: conferir variantes)
Lição 2 — nomes vêm «como vieram da base»

O script avisa no título da tabela: «nomes como vieram da base, sem desambiguação». Um nome de organização registrado como autor é erro a corrigir no CSV (ou no thesaurus, Parte 4) antes do mapa de coautoria. E 3 documentos em 236 não fazem ninguém «líder» de nada: a tabela descreve produção, não importância.

Fonte

Tabelas «top 5» da Figura 10; o arquivo de origem é indicadores.md, gravado pelo script.

Indicadores com script4 de 4 · api.crossref.org, polite pool, 09/09/2026 · corpus de 236 documentos do OpenAlex

Citações pelo Crossref e o índice h do corpus: 1.131 citações somadas, índice h 17, 128 documentos sem citação — o que isso é e o que não é

enriquecimento — um laço sobre os DOIs do CSV (o script grava crossref_refs.json; não há chave nem senha)
# para cada DOI do corpus:
#   GET https://api.crossref.org/works/<DOI>?mailto=seu@email   (User-Agent também com o mailto)
#   guarda: doi, citacoes (is-referenced-by-count), refs_doi (referências com DOI), n_refs, tipo
#   espera 0,15 s entre chamadas
# resultado, 09/09/2026: 226 DOIs consultados → 196 respondidos (195 com contagem);
#   91 com referências que têm DOI (é o que o acoplamento bibliográfico usa)
CitaçõesDocumento mais citado do corpus (Crossref, 09/09/2026)Ano
119Digital twin based condition monitoring of a knuckle boom crane2020
112Designing a Shape–Performance Integrated Digital Twin…2021
101Development of Digital Twin for Intelligent Maintenance of Civil Infra…2022
95Predictive Maintenance of Power Substation Equipment by Infrared Thermography…2017
72Navigating the Sea of Data…2023
O que é o índice h do corpus

O script define: o maior h tal que h documentos do corpus têm pelo menos h citações. Aqui, 17: há 17 documentos com 17 ou mais citações, e não há 18 com 18 ou mais. É uma medida do conjunto — «o índice h deste corpus, pelo Crossref, em 09/09/2026, é 17». Não é o índice h de nenhuma pessoa, e um índice h de pessoa não é assunto deste manual (Leiden, princípio 7).

Limites
  • Conta só o que o Crossref indexa: 226 DOIs, 196 respostas; os 10 documentos sem DOI nem entram
  • Citação mede atenção acumulada: os mais citados são de 2017–2023; os 111 de 2026 mal tiveram tempo — 128 documentos sem citação é o esperado num corpus recente
  • Scopus ou Web of Science dariam outros números; nunca misture contagens de fontes diferentes numa mesma tabela
Parte 4VOSviewer

O que é e quem faz; o aviso de segurança de 31/08; a interface; o wizard «Create Map» passo a passo; thesaurus e limpeza; os arquivos map, network e JSON; mapa_vosviewer.py

O VOSviewer desktop (Java) não foi executado para este manual — não havia display gráfico — e é descrito pelo manual oficial da versão 1.6.20 (31/10/2023), lido diretamente. As redes da demonstração foram construídas pelo mapa_vosviewer.py, nos formatos que o VOSviewer lê, e abertas no VOSviewer Online (Parte 5).

04
VOSviewer1 de 6 · vosviewer.com · manual 1.6.20 · captura de 09/09/2026

VOSviewer: gratuito, em Java, do CWTS (Leiden) — e o aviso de 31/08/2026: baixe só do site oficial e confira o arquivo

Página inicial de vosviewer.com exibindo apenas um Security notice: em 31 de agosto uma parte não autorizada obteve acesso ao site e uma versão maliciosa do executável para Windows ficou disponível entre 3:30 e 13:20 CEST
Figura 12 vosviewer.com (captura de 09/09/2026): a página inicial exibia apenas um «Security notice». Em 31/08 «uma parte não autorizada obteve acesso ao site do VOSviewer» e «uma versão maliciosa do executável do VOSviewer para Windows ficou disponível para download em 31 de agosto entre 3:30 e 13:20 CEST»; quem baixou nesse intervalo deve apagar o arquivo e rodar o antivírus. As páginas de download e «getting started» devolviam 404 nessa data.
VOSviewerManual 1.6.20 e site (09/09/2026)
O que é«Uma ferramenta de software para criar mapas baseados em dados de rede e para visualizar e explorar esses mapas»: redes de publicações, periódicos, pesquisadores, organizações, países, palavras-chave ou termos, ligados por coautoria, coocorrência, citação, acoplamento bibliográfico ou cocitação
Quem fazNees Jan van Eck e Ludo Waltman, CWTS, Universidade de Leiden
Custo · plataforma«Pode ser usado livremente para qualquer finalidade»; desenvolvido em Java, roda na maioria das plataformas
VersãoEste manual segue o manual da 1.6.20 (31/10/2023); a versão mais recente não foi conferida, porque o site só mostrava o aviso
CitarVan Eck e Waltman, Scientometrics, 2010 (Parte 6)
Regra de segurança

Baixe o VOSviewer somente de vosviewer.com, nunca de espelhos, fóruns ou links em mensagens; se baixou o executável para Windows em 31/08/2026 entre 3:30 e 13:20 CEST, apague-o e rode um antivírus completo. Enquanto o download estiver indisponível, o VOSviewer Online (Parte 5) faz a visualização sem instalar nada — e este manual mostra como.

VOSviewer2 de 6 · manual 1.6.20, cap. 3 · descrito pelo manual; o programa não foi executado

A interface: cinco painéis, as abas «File», «Items» e «Analysis», a barra de status — e as três visualizações Network, Overlay e Density

Painel (cap. 3)Para quê
Painel principalO mapa em si: os itens como círculos com rótulo, os links como linhas; zoom e arrasto
Painel de opçõesOs ajustes da visualização ativa: escala, tamanho dos rótulos, cores, linhas
Painel de informaçãoOs dados do item sob o cursor
Painel de visão geralUma miniatura do mapa inteiro, com a área visível marcada
Painel de açãoAs abas «File» (abrir, criar e salvar mapas — é onde fica o «Create Map»), «Items» (a lista de itens do mapa) e «Analysis» (os parâmetros da análise que produz layout e clusters)
Barra de statusO número de itens, de clusters, de links e a força total — os quatro números que vão para a legenda da figura (Parte 7)
VisualizaçãoO que codifica
NetworkTamanho do círculo = peso do item; cor = cluster; linhas = links (até 1.000 linhas por padrão, as mais fortes)
OverlayMesmo layout; cor = score do item (ano médio de publicação, citações…), numa barra de cores azul→verde→amarelo
DensityMapa de calor: item density (quanto mais itens e mais peso por perto, mais quente) e cluster density (a cor do cluster dominante em cada região)
Regra

Um mapa por pergunta e uma visualização por afirmação: Network para «há grupos», Overlay para «o que é recente», Density para «onde está a massa». A figura do artigo diz qual é e traz, na legenda, itens, links, clusters e força total lidos na barra de status.

Sem captura do desktop

Este slide não mostra a tela do VOSviewer porque o programa não foi executado para o manual; os nomes vêm do capítulo 3 do manual oficial. A Parte 5 mostra o VOSviewer Online, cuja interface é diferente (um painel lateral com «View», «Find» e «Update»).

VOSviewer3 de 6 · manual 1.6.20, seção 3.5.4 · «File» → «Create»

«Create Map», passo a passo: tipo de dado → fonte → tipo de link e unidade → contagem → limiares → itens

1Tipo de dado«Create a map based on network data» (map/network, JSON, GML, Pajek) · «…based on bibliographic data» (arquivos de bases ou APIs) · «…based on text data» (termos de títulos e resumos, só em inglês)
2FonteArquivos: Web of Science, Scopus, Dimensions, Lens, PubMed; RIS, EndNote, RefWorks · APIs: OpenAlex, Crossref, Europe PMC, Semantic Scholar, OCC, COCI, Wikidata — por URL de requisição, por busca, por lista de DOIs ou por JSON salvo
3Tipo de link e unidadeCoautoria: autores, organizações, países · Coocorrência: palavras-chave · Citação e acoplamento: documentos, fontes, autores, organizações, países · Cocitação: referências, fontes, autores citados
4ContagemCompleta (cada link vale 1) ou fracionada (1/n para os n coautores) — slide «Contagem completa × fracionada»
5LimiaresMínimo de documentos (ou de ocorrências: padrão 10 para termos) por item; para termos, a relevância (padrão exclui 40 % dos menos relevantes)
6ItensO wizard mostra quantos itens passam o limiar e permite escolher quantos entram; o mapa legível tem dezenas, não centenas — e o número escolhido vai para o método
Regra

Cada escolha do wizard é um parâmetro do método: tipo de dado, fonte, tipo de link, unidade, contagem, limiar mínimo, número de itens. Anote os seis no diário na hora — o VOSviewer não os grava no arquivo do mapa, e sem eles ninguém reproduz a figura. A Parte 7 traz a tabela para preencher.

Itens não conectados

Quando a rede tem itens sem link com o conjunto principal, o VOSviewer pergunta se deve mostrar só o maior conjunto conectado. A resposta muda o mapa (Parte 5 mostra o diálogo com a coautoria real: 60 itens, maior conjunto conectado de 11) e também vai para o método.

VOSviewer4 de 6 · manual 1.6.20, seções 3.5.4 e cap. 4 · OpenRefine como alternativa

Thesaurus e limpeza: unir «h-index» e «Hirsch index», ignorar termos genéricos, corrigir «AMC Instruments» — antes do mapa, não depois

Nos mapas de texto, o VOSviewer identifica os termos por processamento de linguagem natural (OpenNLP; frases nominais; só em inglês), exclui os que ficam abaixo do mínimo de ocorrências (padrão 10) e os 40 % menos relevantes (padrão). O que sobra ainda traz variantes da mesma coisa e termos que dizem pouco. O thesaurus resolve os dois casos: um arquivo que diz «este rótulo vira aquele» (unir variantes) ou «este rótulo não entra» (ignorar).

ProblemaExemplo real ou do manualSolução
Variantes do mesmo termo«h-index» e «Hirsch index» (exemplo do manual)Thesaurus: unir sob um rótulo
Termos genéricos«study», «result», «approach» — aparecem em todo resumo e não distinguem nadaThesaurus: ignorar
Organização como autor«AMC Instruments» com 3 documentos no corpus realCorrigir no CSV ou ignorar no thesaurus da coautoria
Nomes não desambiguados«Silva, J.» e «Silva, João»; «Fan Yang» pode ser mais de uma pessoaConferir nos documentos; unir no thesaurus só com evidência
Regra

Limpe antes de mapear e guarde o thesaurus junto com o mapa: ele é parte do método e vai para o repositório (manual de Git). Cada união ou exclusão é uma decisão sua — o thesaurus documenta; a leitura dos documentos justifica. Corpus em português? Os termos do VOSviewer são só em inglês: use o mapa de palavras-chave da base ou traduza e declare.

Alternativa

O manual do VOSviewer cita o OpenRefine para a limpeza de nomes e termos fora do programa: agrupar variantes, corrigir grafias e exportar de volta o arquivo limpo. O mapa_vosviewer.py faz uma limpeza mínima nos termos (stopwords e descarte do termo curto quando um termo mais longo que o contém tem ≥ 80 % da sua frequência) — o thesaurus ainda é necessário.

VOSviewer5 de 6 · manual 1.6.20, cap. 4 · arquivos gravados pelo mapa_vosviewer.py em 09/09/2026

Os arquivos: o map file (um item por linha), o network file (um link por linha, formato sparse) e o VOSviewer JSON (os dois juntos)

ArquivoColunas (manual, cap. 4)O que o script grava
Map file (<nome>_map.txt)id, label, sublabel, description, url, x, y, cluster (1–1000), weight, normalized weight, score, red/green/blueid, label, weight<Documents>, weight<Links>, weight<Total link strength>, score<Avg. pub. year>
Network file (<nome>_network.txt)Formato sparse: id1, id2, força — ou a matriz completaid1, id2, força (sparse)
VOSviewer JSON (<nome>.json)network.items (id, label, weights, scores) e network.links (source_id, target_id, strength)O mesmo conteúdo dos dois arquivos, num só — é o que o VOSviewer Online abre
OutrosCorpus e scores files (texto), thesaurus, arquivos de cores
head -4 coautoria_map.txt; head -3 coautoria_network.txt — saída real (Figura 13)
id    label            weight<Documents>  weight<Links>  weight<Total link strength>  score<Avg. pub. year>
1     Prashant Mavani  3                  0              0                            2026.00
2     Byunghyun Ban    3                  0              0                            2026.00
3     Xavier Pillet    3                  0              0                            2026.00
6     5     2
11    15    2
11    12    2
O que o JSON não traz

Coordenadas (x, y) e cluster não estão nos arquivos do script: são calculados pelo VOSviewer (ou pelo VOSviewer Online) ao abrir, pelo layout e pelo clustering da aba «Analysis». Por isso o mesmo JSON pode dar desenhos ligeiramente diferentes — o que se relata são os parâmetros, não a posição dos círculos.

Lendo as linhas

Os três autores com 3 documentos têm 0 links e força 0: escreveram sozinhos ou com coautores abaixo do limiar. Já 6 5 2 diz que os itens 6 e 5 assinaram 2 documentos juntos.

VOSviewer6 de 6 · execução real de 09/09/2026 · Python 3 · corpus de 236 documentos do OpenAlex · contagem completa

mapa_vosviewer.py: coautoria, termos, fontes ou acoplamento, com limiar declarado — grava map, network e JSON e imprime itens, links, isolados e força total

Terminal: mapa_vosviewer.py com --tipo coautoria --min 2 (60 itens, 101 links, 13 isolados, força total 202), --tipo termos --min 8 --max-itens 80 (80 itens, 3154 links, força total 39660), --tipo acoplamento --refs crossref_refs.json --min 1 (90 itens, 138 links, 35 isolados, força total 222), e o head dos arquivos map e network
Figura 13 Execução real; corpus de 236 documentos do OpenAlex (captura de 09/09/2026): três chamadas do mapa_vosviewer.py. Coautoria com --min 2: «236 documentos → 60 itens (mínimo 2), 101 links, 13 isolados; força total 202». Termos com --min 8 --max-itens 80: «80 itens (mínimo 8), 3154 links; força total 39660». Acoplamento com --refs crossref_refs.json --min 1: «90 itens (mínimo 1), 138 links, 35 isolados; força total 222». Cada chamada grava _map.txt, _network.txt e .json e imprime o top 10 por documentos.
terminal — as quatro redes (o CSV é o da busca; --refs só para o acoplamento)
python3 scripts/mapa_vosviewer.py corpus.csv --tipo coautoria   --min 2 --saida coautoria
python3 scripts/mapa_vosviewer.py corpus.csv --tipo termos      --min 8 --max-itens 80 --saida termos
python3 scripts/mapa_vosviewer.py corpus.csv --tipo fontes      --min 2 --saida fontes
python3 scripts/mapa_vosviewer.py corpus.csv --tipo acoplamento --refs crossref_refs.json --min 1 --saida acoplamento
# --min N: mínimo de documentos por item (padrão 2) · --max-itens: corte (padrão 100) · contagem completa sempre
RedeUnidade · linkMínimoItensLinksIsoladosForça total
CoautoriaAutores · documentos em comum2 docs6010113202
TermosN-gramas de 1 a 3 palavras de título + resumo · coocorrência8 docs803.154039.660
FontesFontes · autores em comum2 docs26419
AcoplamentoDocumentos · referências com DOI em comum (Crossref)1 ref.9013835222
Regra

O script imprime exatamente o que a legenda da figura precisa: itens, links, isolados e força total, com o limiar. Ajuste --min até o mapa ter dezenas de itens legíveis e declare o valor final; não esconda os isolados — 13 autores isolados numa coautoria de 60 dizem que a colaboração é esparsa, e isso é resultado. Os isolados dos termos são 0 porque, com 80 termos frequentes, todos coocorrem com algum outro.

Parte 5VOSviewer Online passo a passo

Abrir o mapa; o mapa de termos; o painel «View»; o overlay por ano médio; a coautoria e o diálogo dos itens não conectados; as fontes; salvar, capturar e compartilhar; a documentação

Sete slides com os mapas reais abertos de verdade em app.vosviewer.com, em 09/09/2026, sem login: os arquivos JSON do mapa_vosviewer.py, carregados pelo botão «Open». Cada número da barra de status é o número do corpus de 236 documentos.

05
VOSviewer Online1 de 7 · app.vosviewer.com · capturas de 09/09/2026 · sem login

Abrir: a tela de boas-vindas, o botão de pasta «Open», «File type: VOSviewer JSON file» → «JSON file» → o arquivo → «OK»

Tela de boas-vindas do VOSviewer Online: Visualizing scientific landscapes, com a explicação de que é a versão web do VOSviewer, os exemplos Authors, Journals e Terms e os links para a documentação e os vídeos
Figura 14 app.vosviewer.com (captura de 09/09/2026): «VOSviewer Online — Visualizing scientific landscapes», «ferramenta para visualização de redes; versão web do VOSviewer». Para abrir um mapa, o botão de pasta no canto superior direito; ou um dos exemplos «Authors», «Journals» e «Terms». Não há login nem conta.
Diálogo Open do VOSviewer Online: File type VOSviewer JSON file, botão JSON file, No file selected, botões OK e Cancel
Figura 15 O diálogo «Open» (captura de 09/09/2026): «File type» com «VOSviewer JSON file» (a alternativa é o par map/network), o botão «JSON file» com «No file selected», e «OK» / «Cancel». O arquivo escolhido é o termos.json, coautoria.json ou fontes.json gravado pelo script.
1app.vosviewer.comFeche a tela de boas-vindas («Close») ou clique num exemplo para conhecer a interface
2Botão de pasta («Open»)No canto superior direito, ao lado de Save, Screenshot, dark mode, Info e tela cheia
3«File type»«VOSviewer JSON file» para o .json do script; ou map/network para o par _map.txt + _network.txt
4«JSON file» → «OK»Escolha o arquivo no seu computador; o mapa abre com layout e clusters calculados na hora
Regra

Use o upload pelo botão «Open». O VOSviewer Online também aceita parâmetros de URL (json=, map=, network=) para abrir um arquivo hospedado na web — mas um JSON servido de localhost não abriu por URL na demonstração (o app não encontrou o arquivo); o upload funcionou. Para compartilhar por URL, o arquivo precisa estar num endereço público (slide «Salvar, capturar e compartilhar»).

O que fica onde

O arquivo é lido pelo navegador; o layout e os clusters são calculados ao abrir (o JSON não traz x, y nem cluster). Documentação: app.vosviewer.com/docs (CC BY 4.0; «Copyright 2021-2022 Nees Jan van Eck and Ludo Waltman»).

VOSviewer Online2 de 7 · execução real · corpus de 236 documentos do OpenAlex · captura de 09/09/2026

O mapa de termos: 80 itens, 3.154 links, força total 39.660, 2 clusters — cada círculo é um termo, o tamanho é o nº de documentos, a cor é o cluster

Mapa de termos no VOSviewer Online: 80 termos em dois clusters, vermelho e verde, com predictive maintenance ao centro; barra de status Items 80, Links 3154, Total link strength 39660, Clusters 2
Figura 16 Execução real; corpus de 236 documentos do OpenAlex (captura de 09/09/2026): termos.json aberto no VOSviewer Online. Barra de status: «Items: 80 | Links: 3154 | Total link strength: 39660 | Clusters: 2». Os termos vêm de título + resumo, n-gramas de 1 a 3 palavras, mínimo de 8 documentos, contagem completa; o maior círculo é «predictive maintenance», o termo da própria string de busca.
No mapaO que significa
Círculo (item)Um termo; tamanho = peso «Documents» (em quantos documentos aparece)
Linha (link)Os dois termos coocorrem em pelo menos um documento; espessura = força (nº de documentos em que coocorrem)
Cor (cluster)O grupo em que o algoritmo pôs o termo; aqui só dois: vermelho e verde
DistânciaTermos que coocorrem muito ficam perto; a posição exata é calculada ao abrir e não é um dado
Barra de statusOs quatro números da legenda: itens, links, força total, clusters
Armadilha

Chamar os dois clusters de «os dois temas do campo». São 2 clusters de um corpus pequeno (236 documentos), dominado pelo ano corrente (111 de 2026) e com um termo — o da string de busca — no centro de tudo. Antes de dar nome a um cluster, leia os documentos em que os termos dele aparecem (Parte 7). O rótulo é provisório e é seu.

Regra

Na legenda da figura: base, data, n, unidade (termos de título e resumo), tipo de link (coocorrência), contagem, limiar (mínimo 8 documentos), itens (80), links (3.154), força total (39.660), clusters (2) e o software com a versão. É o slide «A seção de método» em uma frase.

VOSviewer Online3 de 7 · execução real · corpus de 236 documentos do OpenAlex · captura de 09/09/2026

O painel lateral, aba «View»: Visualization, Items (Size, Color), Links (Minimum strength, Maximum links) e Color schemes

Mapa de termos no VOSviewer Online com o painel View aberto: Visualization Scale; Items Size Documents, Color Clusters, Size variation, Maximum label length 30; Links Size variation, Minimum strength 0, Maximum links 1000, Curved links; Color schemes Cluster colors, Score colors Viridis
Figura 17 Execução real; corpus de 236 documentos do OpenAlex (captura de 09/09/2026): o mesmo mapa de termos com o painel aberto (seta à esquerda), aba «View». «Items: 80 | Links: 3154 | Total link strength: 39660 | Clusters: 2». «Size: Documents», «Color: Clusters», «Maximum label length: 30», «Minimum strength: 0», «Maximum links: 1000», «Curved links» ligado, «Score colors: Viridis».
SeçãoOpçãoPara quê
VisualizationScaleAmplia ou reduz círculos e rótulos em conjunto
ItemsSizeQual peso dá o tamanho: «Documents», «Links», «Total link strength»…
Color«Clusters» (a cor é o grupo) ou um score («Avg. pub. year» → overlay, slide seguinte)
Size variationQuanto o tamanho varia entre o item mais leve e o mais pesado
Maximum label lengthCorta rótulos longos (30 na captura)
LinksSize variationQuanto a espessura varia com a força
Minimum strengthEsconde links fracos — não os apaga da rede
Maximum linksMostra só os N mais fortes (1000 por padrão)
Curved linksLinhas curvas ou retas
Color schemesCluster colors · Score colorsA paleta dos clusters; a barra de cores dos scores («Viridis»)
Regra

O painel muda o desenho, não a rede: «Minimum strength» e «Maximum links» escondem linhas, mas itens, links e força total da barra de status continuam os mesmos. Se a figura do artigo esconde links, a legenda diz («links com força ≥ 2»). As outras abas do painel são «Find» e «Update».

Legibilidade

Para a figura impressa, suba «Scale» e «Maximum label length» até os rótulos ficarem legíveis, ou reduza o número de itens no script (--max-itens) — o segundo caminho é um parâmetro do método; o primeiro, só do desenho.

VOSviewer Online4 de 7 · execução real · corpus de 236 documentos do OpenAlex · captura de 09/09/2026

Overlay por ano médio: «Color: Avg. pub. year» pinta cada termo pela média do ano dos documentos em que aparece — azul é mais antigo, amarelo é mais recente

Mapa de termos no VOSviewer Online colorido por Avg. pub. year, com a barra de cores Viridis no canto inferior direito; painel View com Color Avg. pub. year
Figura 18 Execução real; corpus de 236 documentos do OpenAlex (captura de 09/09/2026): o mesmo mapa de termos com «Color: Avg. pub. year» — a visualização overlay. A barra de cores (Viridis) aparece no canto inferior direito; o score score<Avg. pub. year> vem do map file gravado pelo script. «Items: 80 | Links: 3154 | Total link strength: 39660».
Score (manual, cap. 2)O que a cor passa a dizer
Avg. pub. yearA média do ano de publicação dos documentos em que o item aparece — termos «novos» × «antigos» dentro do corpus
Pub. yearO ano de um documento (mapas de documentos)
Citations · Avg. citationsCitações do item ou média por documento — só se o arquivo trouxer citações
Norm. citationsCitações normalizadas, para comparar itens que não teriam a mesma chance de ser citados
Armadilha

Ler o amarelo como «tendência». Num corpus em que 111 de 236 documentos são de 2026, quase tudo tem ano médio recente, e a barra de cores cobre um intervalo curto. O overlay diz o que é relativamente mais novo dentro deste corpus, nesta data — não o que «vai crescer». Escreva a faixa da barra de cores na legenda.

Regra

Uma figura Network e uma Overlay do mesmo mapa contam duas coisas diferentes: grupos e tempo. Se usar as duas, diga que é o mesmo mapa (mesmos itens, links e limiar) e o que muda é só a cor.

VOSviewer Online5 de 7 · execução real · corpus de 236 documentos do OpenAlex · capturas de 09/09/2026

Coautoria: 60 autores, 101 links, 25 clusters — e o diálogo «Some of the 60 items in your network are not connected to each other»

Mapa de coautoria no VOSviewer Online com todos os 60 autores, espalhados e com poucas linhas visíveis; barra de status Items 60, Links 101, Total link strength 202, Clusters 25
Figura 19 Execução real; corpus de 236 documentos do OpenAlex (captura de 09/09/2026): coautoria.json aberto com «No» no diálogo — todos os itens. «Items: 60 | Links: 101 | Total link strength: 202 | Clusters: 25». Muitos clusters pequenos e 13 isolados: a colaboração no corpus é esparsa.
Mapa de coautoria no VOSviewer Online mostrando só o maior conjunto de itens conectados, um grupo denso em vermelho, num único cluster
Figura 20 Execução real; corpus de 236 documentos do OpenAlex (captura de 09/09/2026): o mesmo arquivo com «Yes» — só o maior conjunto conectado. O diálogo dizia: «Some of the 60 items in your network are not connected to each other. The largest set of connected items consists of 11 items. Do you want to show this set of items instead of all items?». O grupo denso é um único conjunto de coautores.
«No» — todos os itens (Figura 19)
  • Mostra a rede inteira, inclusive os 13 isolados e os pares soltos
  • É a figura honesta para dizer «a colaboração é esparsa»: 60 autores em 25 clusters
  • Rótulos espalhados, pouca linha visível
«Yes» — o maior conjunto conectado (Figura 20)
  • Mostra só o grupo que se liga entre si: 11 itens, segundo o diálogo
  • Serve para descrever esse grupo — não o campo
  • A legenda precisa dizer que é um subconjunto e qual
Regra

A resposta ao diálogo é um parâmetro do método: «mapa com todos os 60 itens» ou «maior conjunto conectado (11 itens)». O manual do VOSviewer desktop faz a mesma pergunta ao criar o mapa. Antes de interpretar qualquer grupo, confira a desambiguação dos nomes (Parte 4): um autor grafado de duas formas vira dois círculos.

O que 25 clusters dizem

Com 60 itens e 101 links, cada pequeno grupo de coautores vira um cluster próprio. Não são «25 comunidades científicas»: são os grupos de pessoas que assinaram juntas ao menos 2 documentos do corpus até 09/09/2026.

VOSviewer Online6 de 7 · execução real · corpus de 236 documentos do OpenAlex · captura de 09/09/2026

Fontes: 26 itens, 4 links, 19 isolados — o que um mapa quase sem linhas diz sobre o corpus (e sobre os repositórios contados como «fonte»)

Mapa de fontes no VOSviewer Online: 26 fontes espalhadas, quase sem linhas, com Zenodo como o maior círculo, seguido de arXiv e SSRN Electronic Journal
Figura 21 Execução real; corpus de 236 documentos do OpenAlex (captura de 09/09/2026): fontes.json — fontes com pelo menos 2 documentos, ligadas quando têm autores em comum. 26 itens, 4 links, 19 isolados; ao abrir, o diálogo dos itens não conectados informou que o maior conjunto conectado tem 3 itens. O maior círculo é «Zenodo (CERN European Organiza…»; «arXiv (Cornell University)» e «SSRN Electronic Journal» vêm em seguida — repositórios, não periódicos.
O que se vêO que isso diz do corpus
Quase nenhuma linha (4 links em 26 itens)Os autores do corpus raramente publicam em mais de uma fonte com 2+ documentos: o campo está disperso por muitos veículos
19 isoladosA maioria das fontes não compartilha autor com nenhuma outra
Maior conjunto: 3 itensO único «circuito» de fontes com autores em comum tem três veículos
Zenodo, arXiv, SSRN no topoO peso está em repositórios de preprints e depósitos, não em periódicos — a lição da Parte 3 vista no mapa
Regra

Um mapa vazio também é resultado: «não há rede de fontes por autores em comum neste corpus» é uma frase que se escreve. O que não se faz é baixar o limiar até aparecerem linhas e apresentar o desenho como se fosse estrutura. Se o interesse é «onde o campo publica», a tabela de fontes por tipo (Parte 3) responde melhor do que este mapa.

VOSviewer Online7 de 7 · app.vosviewer.com/docs · captura de 09/09/2026

Salvar, capturar e compartilhar: os botões da barra — Open, Save, Screenshot, dark mode, Info, tela cheia — e a documentação oficial

VOSviewer Online Docs: Welcome to VOSviewer Online Docs, com as seções User interface, File types, Sharing a visualization, Examples e Videos
Figura 22 app.vosviewer.com/docs (captura de 09/09/2026): «Welcome to VOSviewer Online Docs», com «User interface», «File types», «Sharing a visualization», «Examples» e «Videos». Licença CC BY 4.0; «Copyright 2021-2022 Nees Jan van Eck and Ludo Waltman».
Botão (barra superior direita)O que faz
Open (pasta)Abre o diálogo da Figura 15: JSON ou map/network
SaveGrava o mapa como arquivo do VOSviewer, para reabrir ou compartilhar
ScreenshotSalva a imagem do mapa como está na tela — é a figura que vai para o artigo, com a legenda completa
Dark modeFundo escuro; para impressão, use o claro
InfoInformações sobre o app, com os links para a documentação e os vídeos
Tela cheiaSó o mapa, sem o navegador — bom para apresentar
Regra

Guarde três coisas: o .json (a rede), a captura («Screenshot») e o diário com os parâmetros. Para compartilhar um mapa interativo, o arquivo JSON precisa estar num endereço público e ser aberto com o parâmetro json= na URL do app — o que a documentação chama de «Sharing a visualization»; um arquivo em localhost não serviu na demonstração.

Manuais irmãos

O JSON e a captura vão para o repositório com o texto (Git) e para o repositório de dados (Dados); a figura entra no .tex com a legenda completa (LaTeX).

Parte 6Bibliometrix e outros

bibliometrix 5.5.0 e biblioshiny: instalar e abrir em R; CiteSpace em uma linha; Van Eck e Waltman (2010) e como citar as ferramentas

A alternativa em R ao VOSviewer, descrita pelo CRAN e pelo site oficial em 09/09/2026 — o pacote não foi executado para este manual (R não instalado), e os menus internos do biblioshiny não são descritos. Depois, o CiteSpace em uma linha e a referência que todo artigo com mapa do VOSviewer precisa citar.

06
Bibliometrix e outros1 de 2 · cran.r-project.org · bibliometrix.org · github.com/massimoaria/bibliometrix · capturas de 09/09/2026 · não executado

bibliometrix 5.5.0 e biblioshiny: o pacote R (GPL-3) que importa Scopus, Web of Science, Dimensions, OpenAlex, Cochrane, Lens e PubMed — e a interface web «sem código»

Página inicial de bibliometrix.org: The Complete Science Mapping Platform, com o logotipo Bibliometrix AI e os menus Features, Tutorials, Download, Education, Products, About e FAQ
Figura 23 bibliometrix.org (captura de 09/09/2026): «The Complete Science Mapping Platform». O site anuncia «Biblio AI» (v5.0); a página específica do biblioshiny devolveu 404 nesta data — por isso este manual não descreve os menus do biblioshiny.
Página do pacote bibliometrix no CRAN: Comprehensive Science Mapping Analysis, versão 5.5.0, publicado em 2026-08-29, R maior ou igual a 3.5.0, licença GPL-3, autores Massimo Aria e Corrado Cuccurullo
Figura 24 CRAN, pacote bibliometrix (captura de 09/09/2026): versão 5.5.0, publicada em 29/08/2026; «ferramenta para pesquisa quantitativa em cientometria e bibliometria»; exige R ≥ 3.5.0; licença GPL-3; autores Massimo Aria (mantenedor) e Corrado Cuccurullo; importa dados de Scopus, Web of Science, Dimensions, OpenAlex, Cochrane Library, Lens e PubMed.
R — instalar e abrir (o pacote não foi executado para este manual; comandos do CRAN e do README oficial)
install.packages("bibliometrix")   # uma vez, no R (≥ 3.5.0)
library(bibliometrix)
biblioshiny()                      # abre a interface web no navegador
O que importa saberFonte (09/09/2026)
O que éPacote R para «pesquisa quantitativa em cientometria e bibliometria»; o biblioshiny é a interface web (Shiny) «sem código» (CRAN e site)
FluxoO README no GitHub (massimoaria/bibliometrix) descreve o fluxo SAAS e cita o livro Science Mapping Analysis: A Primer with Biblioshiny
Quando escolherQuando você já trabalha em R, quer as tabelas e os gráficos além dos mapas, ou precisa importar OpenAlex, Cochrane ou Lens diretamente
CitarAria e Cuccurullo, Journal of Informetrics, 2017 (slide seguinte)
Regra

As mesmas regras valem: um mapa de uma base só, limiares e contagem declarados, versão do pacote no método («bibliometrix 5.5.0»). O que este manual não faz é descrever os menus do biblioshiny — porque não os viu; quando você abrir, os nomes da sua tela é que valem.

Bibliometrix e outros2 de 2 · citespace.podia.com · Springer (Scientometrics, 2010) · capturas de 09/09/2026

CiteSpace em uma linha — e como citar as ferramentas: Van Eck e Waltman (2010) para o VOSviewer, Aria e Cuccurullo (2017) para o Bibliometrix, Chen (2006) para o CiteSpace

Página do CiteSpace com o anúncio New Release CiteSpace 7.0.2 para Windows 11 e Mac, os menus Blogs, Exemplars, Gallery, FAQs e o botão Login
Figura 25 citespace.podia.com (captura de 09/09/2026): «CiteSpace 7.0.2» anunciado para Windows 11 e Mac; «Advanced version». É uma terceira ferramenta de mapeamento científico, com ênfase em tendências emergentes (Chen, 2006); este manual não o executou e não traz preços.
Página da Springer do artigo Software survey: VOSviewer, a computer program for bibliometric mapping, Scientometrics, volume 84, páginas 523–538, 2010, acesso aberto, publicado em 31 de dezembro de 2009
Figura 26 Springer (captura de 09/09/2026): «Software survey: VOSviewer, a computer program for bibliometric mapping», Scientometrics, v. 84, p. 523–538 (2010), publicado on-line em 31/12/2009, acesso aberto. É a referência do VOSviewer.
FerramentaReferência (padrão ABNT; conferir com a biblioteca)DOI
VOSviewerVAN ECK, N. J.; WALTMAN, L. Software survey: VOSviewer, a computer program for bibliometric mapping. Scientometrics, v. 84, p. 523-538, 2010.10.1007/s11192-009-0146-3
BibliometrixARIA, M.; CUCCURULLO, C. bibliometrix: An R-tool for comprehensive science mapping analysis. Journal of Informetrics, v. 11, n. 4, p. 959-975, 2017.10.1016/j.joi.2017.08.007
CiteSpaceCHEN, C. CiteSpace II: Detecting and visualizing emerging trends and transient patterns in scientific literature. JASIST, 2006.10.1002/asi.20317
Regra

Cite a ferramenta e a versão no método: «VOSviewer 1.6.20 (Van Eck; Waltman, 2010)» ou «bibliometrix 5.5.0 (Aria; Cuccurullo, 2017)». O VOSviewer Online cita-se pela mesma referência de 2010, indicando «VOSviewer Online, app.vosviewer.com, acesso em (data)». A referência vai para o Zotero (manual irmão) como qualquer artigo.

Parte 7Relatar e fechar

A seção de método bibliométrico; ler clusters sem inventar temas; tudo num só plugin; erros comuns; checklist; glossário; referências; como citar

O mapa só vale se outra pessoa conseguir refazê-lo: base, string, data, n, software e versão, tipo de link, contagem, limiares, itens, links e clusters. Depois, a regra para nomear clusters, o agente que roda os scripts, o que costuma dar errado, a lista para conferir, os termos e as fontes.

07
Relatar e fechar1 de 9 · o que declarar · exemplo com os números reais de 09/09/2026

A seção de método bibliométrico: onze itens que todo mapa declara — e um parágrafo de exemplo com o corpus real

#DeclararNo corpus real (09/09/2026)
1Base e ferramenta de exportaçãoOpenAlex, API, buscar_openalex.py
2String e campos"predictive maintenance" AND (port OR terminal OR crane), em título e resumo
3Data da busca e da extração de citações09/09/2026 (busca); 09/09/2026 (Crossref)
4n, período e tipos236 documentos; 2015–2026; article, book-chapter, preprint
5Software e versãomapa_vosviewer.py; VOSviewer Online (app.vosviewer.com); manual do VOSviewer 1.6.20
6Tipo de link e unidadeCoocorrência de termos (título + resumo, n-gramas de 1 a 3 palavras)
7ContagemCompleta
8LimiaresMínimo de 8 documentos por termo; 80 itens
9Itens, links, força total, clusters80 · 3.154 · 39.660 · 2
10LimpezaStopwords; descarte do termo curto contido num mais longo com ≥ 80 % da frequência; sem thesaurus
11Itens não conectados e visualizaçãoTodos os itens; Network e Overlay por «Avg. pub. year»
Exemplo — parágrafo de método (números reais)

«O corpus foi exportado do OpenAlex em 09/09/2026 pela API, com a string "predictive maintenance" AND (port OR terminal OR crane) em título e resumo, período 2015–2026 e tipos article, book-chapter e preprint, totalizando 236 documentos (226 com DOI). As contagens de citação vieram do Crossref na mesma data (196 de 226 DOIs respondidos). O mapa de coocorrência de termos foi construído a partir de título e resumo (n-gramas de 1 a 3 palavras, stopwords removidas), com contagem completa e mínimo de 8 documentos por termo, resultando em 80 itens, 3.154 links, força total 39.660 e 2 clusters, e visualizado no VOSviewer Online (app.vosviewer.com), seguindo o manual do VOSviewer 1.6.20 (Van Eck; Waltman, 2010). Os arquivos corpus.csv, crossref_refs.json e termos.json acompanham o texto.»

Fonte dos números: Figuras 10, 13, 16 e 17. Troque pelos seus e mantenha a estrutura.
Regra

Se um dos onze itens não couber no texto, vai para o material suplementar — nunca some. Sem os limiares e a contagem, o leitor não consegue reproduzir o mapa; sem a data, não consegue nem entender por que o dele deu diferente.

Relatar e fechar2 de 9 · a regra de interpretação · Donthu et al. (2021) · Leiden, princípio 1

Ler clusters sem inventar temas: o algoritmo agrupa termos que coocorrem; o «tema» é uma leitura sua, feita com os documentos na mão

1Liste os termos do clusterPelo map file (coluna cluster depois de salvar no VOSviewer) ou pela cor no mapa
2Ache os documentosNo CSV, os documentos em que os termos mais pesados do cluster aparecem — leia títulos e resumos
3Rótulo provisórioUma frase, não uma palavra; com dois ou três documentos citados como exemplo
4Teste o contrárioHá termos no cluster que não cabem no rótulo? Há documentos do «tema» em outro cluster? Diga
5Relate como leitura«O cluster 1 reúne termos ligados a…; por exemplo, os documentos X e Y» — nunca «o campo se divide em dois temas»
Escreve-se
  • «O mapa de termos (80 itens, mínimo 8 documentos) formou 2 clusters; o cluster vermelho reúne, entre outros, os termos «monitoring», «sensor» e «failure», presentes, por exemplo, em [dois documentos]»
  • «A coautoria é esparsa: 60 autores em 25 clusters, 13 isolados; o maior conjunto conectado tem 11 itens»
  • «Até 09/09/2026, 111 dos 236 documentos são de 2026»
Não se escreve
  • «O campo se organiza em dois grandes temas»
  • «Os autores X, Y e Z lideram a pesquisa na área» (3 documentos cada)
  • «A produção explodiu em 2026»
  • «O cluster verde é o futuro da área» (overlay lido como previsão)
Regra

O mapa ilustra a revisão; a revisão é a leitura dos documentos (Leiden, princípio 1; Donthu et al., 2021, sobre como conduzir uma análise bibliométrica). Cluster não é tema pronto: é um agrupamento estatístico de coocorrências num corpus, numa data, com um limiar. Nomeie com evidência, cite exemplos, e deixe registrado o que não coube no rótulo.

Relatar e fechar3 de 9

Tudo num só plugin: a skill bibliometria-vosviewer roda os scripts e explica cada rede; o aluno decide o corpus, os limiares e a interpretação

O plugin Pesquisa MirandasTech (para Claude Code e Codex) coloca os papéis dos manuais dentro do assistente, com um estado único (PROGRESSO.md) e um gerente — o Pesquisador — que só fecha uma fase com evidência. A skill bibliometria-vosviewer segue este manual: confirma o corpus e o diário, roda o indicadores_bibliometricos.py e o mapa_vosviewer.py, explica o que cada rede mede, ajuda a escrever a seção de método e registra os arquivos gerados — mas não decide o limiar nem nomeia os clusters por você.

PapelO que faz com este manualSlides
PesquisadorConfere que o corpus tem diário, que os indicadores e os mapas têm arquivo de origem e data, e que a seção de método traz os onze itensPartes 1, 3 e 7
Skill bibliometria-vosviewerRoda os dois scripts, lê a saída com o aluno, gera map/network/JSON, orienta a abrir no VOSviewer ou no VOSviewer Online e a preencher o métodoPartes 3 a 7
BibliotecárioConfere as referências das ferramentas no Zotero (Van Eck; Waltman, 2010; Aria; Cuccurullo, 2017)Parte 6
Orientador (uso de IA)Declara o uso do assistente na análise e no textoÚltimo slide
Claude Code — pedidos na pasta do projeto (o plugin lê PROGRESSO.md)
Pesquisador, onde paramos?
Rode os indicadores bibliométricos do corpus.csv e me explique a tabela de fontes.
Gere a rede de coautoria com mínimo 2 e me diga quantos isolados há.
Monte o mapa de termos com mínimo 8 e prepare o JSON para o VOSviewer Online.
Escreva o rascunho da seção de método bibliométrico com os parâmetros usados.
/pesquisa:status
/pesquisa:proxima
O que a skill recusa

«Ranqueia os autores para eu dizer quem é o melhor» — produção não é qualidade (Leiden, DORA). «Junta a exportação do Scopus com a do OpenAlex» — bases diferentes não se somam num mapa. «Nomeia os clusters para mim» — propõe rótulos provisórios com os documentos de cada cluster; o aluno lê e decide. «Usa o fator de impacto para escolher onde publicar» — explica a DORA e sugere escopo e política de acesso aberto.

Onde cada manual entra

Busca produz o corpus; PRISMA tria; este manual mapeia; Dados e Git guardam os arquivos; LaTeX põe a figura no texto; Uso de IA declara. Hub: mirandastech.com.br/pesquisa.

Relatar e fechar4 de 9

Erros comuns — como aparecem e como corrigir

ErroComo apareceCausaCorreção
Somar bases num mapaExportação do Scopus e do OpenAlex abertas juntas; o VOSviewer recusa, ou o mapa tem duplicados«Quanto mais dados, melhor»um mapa por base; deduplicar antes, com critério registrado
Mapa sem diárioFigura bonita, sem string, data, n nem limiarO mapa foi feito «para ver»os onze itens do método; sem eles, refaça
Ranking de pessoas«Os autores mais influentes são…» a partir de 3 documentosConfundir produção com importânciaLeiden 7 e DORA: descrever, não julgar
Fator de impacto como qualidade«Publicado em periódico de alto impacto, logo…»Métrica de periódico usada no artigoDORA; SJR só como descrição, com data
Nomes não desambiguadosDois círculos para o mesmo autor; «AMC Instruments» como autorNomes «como vieram da base»thesaurus; corrigir o CSV; conferir nos documentos
Ano corrente como alta ou queda«A produção dobrou em 2026» (busca em setembro)Ano parcial lido como completomarcar como parcial; cortar no último ano completo; dizer a data
Cluster = tema«O campo se divide em dois temas»Agrupamento estatístico lido como teorialer os documentos; rótulo provisório com exemplos
Limiar sem declarar«Mapa de coautoria» sem dizer o mínimo de documentos nem a contagemO wizard não grava os parâmetrosanotar no diário na hora; declarar no método
VOSviewer de site não oficialExecutável baixado de espelho ou de link em mensagemSite oficial fora do ar (aviso de 31/08)só vosviewer.com; conferir o arquivo; ou VOSviewer Online
API sem mailtoCrossref lento ou recusando; OpenAlex sem orçamentoRequisições sem identificação; busca repetidamailto no Crossref; exportar uma vez e trabalhar no arquivo
JSON por URL local que não abreVOSviewer Online «não encontra o arquivo» com json= apontando para localhostO app não lê a sua máquinabotão «Open» com upload; para compartilhar, endereço público
Figura do mapa sem legenda completaImagem do mapa sem n, links, clusters, limiar nem softwareA barra de status ficou fora do recortelegenda com itens, links, força total, clusters, limiar, contagem, base, data e versão
Relatar e fechar5 de 9

Checklist final: antes de pôr o mapa no texto

Marque conforme concluir. O estado fica salvo neste navegador — não é compartilhado nem enviado a lugar nenhum.

0 de 12
Relatar e fechar6 de 9

Glossário

Tudo que aparece no manual sem ser explicado no próprio slide.

Redes e medidas

Bibliometria
Medir a produção científica a partir do que foi publicado: documentos, autores, fontes, citações e as redes entre eles; aqui, descrição de um campo, não avaliação de pessoas.
Corpus
O conjunto de documentos que a busca registrada devolveu; aqui, 236 registros do OpenAlex em 09/09/2026.
Item
Objeto de interesse do mapa: um autor, um termo, uma fonte ou um documento (manual do VOSviewer, cap. 2).
Link
Relação entre dois itens; há no máximo um link por par.
Força do link
Valor positivo do link: nº de documentos coautorados, de documentos em que dois termos coocorrem ou de referências em comum.
Força total (Total link strength)
A soma das forças dos links de um item — ou de toda a rede, na barra de status.
Rede
Itens + links; o que o map file e o network file (ou o JSON) descrevem.
Cluster
Conjunto de itens que o VOSviewer agrupa; cada item pertence a um só cluster, numerado 1, 2, …
Item isolado
Item sem nenhum link na rede; o script imprime quantos há.
Peso (weight)
Atributo numérico do item que dá o tamanho do círculo: «Links», «Total link strength», «Documents», «Citations», «Occurrences».
Score
Atributo numérico do item que dá a cor no overlay: «Pub. year», «Avg. pub. year», «Citations», «Avg. citations», «Norm. citations».
Coautoria
Rede em que dois autores (organizações, países) se ligam quando assinam o mesmo documento.
Coocorrência
Rede em que dois termos ou palavras-chave se ligam quando aparecem no mesmo documento.
Citação (rede de)
Rede em que um documento (fonte, autor…) se liga ao que cita, dentro do corpus.
Acoplamento bibliográfico
Dois documentos se ligam quando citam as mesmas referências; a força é o nº de referências em comum.
Cocitação
Duas referências se ligam quando são citadas juntas pelo mesmo documento.
Contagem completa
Cada coautoria, coocorrência ou referência em comum vale 1 (full counting).
Contagem fracionada
Cada link vale 1/n para os n coautores (fractional counting); reduz o peso de documentos com muitos autores.

Ferramentas, arquivos e avaliação

Network · Overlay · Density
As três visualizações do VOSviewer: cor por cluster; cor por score; mapa de calor de itens ou de clusters.
Limiar
O mínimo de documentos (ou de ocorrências) para um item entrar no mapa; parâmetro do método.
Thesaurus
Arquivo do VOSviewer que une variantes de um mesmo item («h-index» / «Hirsch index») e permite ignorar termos genéricos.
Desambiguação
Decidir se «Silva, J.» e «Silva, João» são a mesma pessoa; sem ela, um autor vira dois círculos.
Map file · network file
Os dois arquivos de texto do VOSviewer: um item por linha (id, label, pesos, scores…) e um link por linha (id1, id2, força).
VOSviewer JSON
Um arquivo só com network.items e network.links; é o que o VOSviewer Online abre pelo botão «Open».
VOSviewer Online
A versão web do VOSviewer (app.vosviewer.com), sem login; abre JSON ou map/network e exporta captura.
Bibliometrix · biblioshiny
Pacote R (5.5.0, GPL-3) para bibliometria e sua interface web «sem código».
DOI
Digital Object Identifier: o identificador que o Crossref usa para devolver citações e referências.
Polite pool
Fila «educada» da API do Crossref: quem se identifica com mailto recebe serviço mais estável.
Acesso aberto
Documento cujo texto completo está disponível sem assinatura; no CSV do OpenAlex, a coluna is_oa.
Índice h do corpus
O maior h tal que h documentos do corpus têm pelo menos h citações; descreve o conjunto, não uma pessoa.
Fator de impacto
Métrica de periódico (média de citações por artigo num período); a DORA pede que não seja usada como medida de qualidade de artigos ou pessoas.
SJR
SCImago Journal Rank: indicador de periódico do SCImago; descreve a revista, não o artigo.
Manifesto de Leiden
Dez princípios para o uso de indicadores na avaliação da pesquisa (Hicks et al., Nature, 2015).
DORA
San Francisco Declaration on Research Assessment (2012): não usar métricas de periódico para avaliar artigos ou pesquisadores.
Diário de busca
O registro (PRISMA-S, BUSCA.md) de string, base, data e n; o mapa herda tudo dele.
Relatar e fechar7 de 9 · fontes conferidas em 09/09/2026

Referências (1 de 2): avaliação responsável, guias e as ferramentas

  1. HICKS, D.; WOUTERS, P.; WALTMAN, L.; DE RIJCKE, S.; RAFOLS, I. Bibliometrics: The Leiden Manifesto for research metrics. Nature, v. 520, p. 429-431, 2015.doi.org/10.1038/520429a leidenmanifesto.org
  2. DORA. San Francisco Declaration on Research Assessment. 2012. Acesso em 9 set. 2026.sfdora.org/read
  3. DONTHU, N.; KUMAR, S.; MUKHERJEE, D.; PANDEY, N.; LIM, W. M. How to conduct a bibliometric analysis: An overview and guidelines. Journal of Business Research, v. 133, p. 285-296, 2021.doi.org/10.1016/j.jbusres.2021.04.070
  4. VAN ECK, N. J.; WALTMAN, L. Software survey: VOSviewer, a computer program for bibliometric mapping. Scientometrics, v. 84, p. 523-538, 2010.doi.org/10.1007/s11192-009-0146-3
  5. VAN ECK, N. J.; WALTMAN, L. VOSviewer Manual. Versão 1.6.20. Leiden: CWTS, 31 out. 2023. Site com aviso de segurança em 9 set. 2026.vosviewer.com
  6. VAN ECK, N. J.; WALTMAN, L. VOSviewer Online; VOSviewer Online Docs. CC BY 4.0. Acesso em 9 set. 2026.app.vosviewer.com app.vosviewer.com/docs
  7. ARIA, M.; CUCCURULLO, C. bibliometrix: An R-tool for comprehensive science mapping analysis. Journal of Informetrics, v. 11, n. 4, p. 959-975, 2017.doi.org/10.1016/j.joi.2017.08.007
  8. ARIA, M.; CUCCURULLO, C. bibliometrix: Comprehensive Science Mapping Analysis. Versão 5.5.0, 29 ago. 2026. CRAN; site oficial; repositório no GitHub. Acesso em 9 set. 2026.cran.r-project.org/package=bibliometrix bibliometrix.org github.com/massimoaria/bibliometrix
  9. CHEN, C. CiteSpace II: Detecting and visualizing emerging trends and transient patterns in scientific literature. Journal of the American Society for Information Science and Technology, 2006. Site do CiteSpace (7.0.2) acessado em 9 set. 2026.doi.org/10.1002/asi.20317 citespace.podia.com
Relatar e fechar8 de 9 · fontes conferidas em 09/09/2026

Referências (2 de 2): bases, APIs, indicadores de periódico e os manuais irmãos

  1. OPENALEX. OpenAlex Help Center; API (api.openalex.org). Acesso em 9 set. 2026 — resposta da API com «Rate limit exceeded / Insufficient budget» nessa data.help.openalex.org
  2. CROSSREF. REST API (api.crossref.org/works/<DOI>). Acesso em 9 set. 2026.api.crossref.org
  3. CLARIVATE. Web of Science. Tela de login acessada em 9 set. 2026.webofscience.com
  4. ELSEVIER. Scopus. Bloqueado pela verificação da Cloudflare para o navegador automatizado em 9 set. 2026.scopus.com
  5. DIGITAL SCIENCE. Dimensions. Acesso em 9 set. 2026.dimensions.ai
  6. CAMBIA. The Lens. Acesso em 9 set. 2026.lens.org
  7. NATIONAL LIBRARY OF MEDICINE. PubMed. Acesso em 9 set. 2026.pubmed.ncbi.nlm.nih.gov
  8. SCIMAGO. SCImago Journal & Country Rank. Acesso em 9 set. 2026.scimagojr.com
  9. WIKIPEDIA. Leiden Manifesto (títulos dos dez princípios conferidos). Acesso em 9 set. 2026.en.wikipedia.org/wiki/Leiden_Manifesto
  10. MIRANDASTECH. Busca em bases abertas: passo a passo (o corpus de 236 documentos e o buscar_openalex.py); PRISMA; Dados; Git. Manuais irmãos. Acesso em 9 set. 2026.busca.mirandastech.com.br prisma.mirandastech.com.br dados.mirandastech.com.br git.mirandastech.com.br
Sobre as datas

Versões (manual do VOSviewer 1.6.20; bibliometrix 5.5.0; CiteSpace 7.0.2), limites de exportação, nomes de opções e a mensagem da API do OpenAlex foram lidos nas páginas acima em 09/09/2026 e mudam sem aviso. Não há versão atual do VOSviewer desktop, preços de Scopus, Web of Science, Dimensions ou CiteSpace, tamanhos de acervo nem valores da tabela de preços do OpenAlex neste manual, porque não foram conferidos nessa data.

Relatar e fechar · último slide9 de 9

Como citar este manual, declaração de uso de IA e licença

Licença

Conteúdo, capturas e os scripts indicadores_bibliometricos.py e mapa_vosviewer.py: CC BY 4.0 — use, copie, adapte e redistribua com atribuição. O VOSviewer «pode ser usado livremente para qualquer finalidade»; a documentação do VOSviewer Online é CC BY 4.0; o bibliometrix é GPL-3. VOSviewer e CWTS, Bibliometrix, Clarivate (Web of Science), Elsevier (Scopus), Digital Science (Dimensions), Cambia (Lens), OpenAlex e OurResearch, Crossref, SCImago, CiteSpace, PubMed e as demais ferramentas e serviços citados são marcas e projetos de terceiros, sem vínculo nem endosso deste manual.

Declaração de uso de IA

Este manual foi escrito com assistência de IA (Claude, Anthropic) na estruturação, na redação, na automação das capturas de tela e na execução dos scripts, sob as regras do manual de Uso de IA na pesquisa científica. Todos os fatos, números, nomes de botões, limites, versões e referências foram conferidos nas fontes indicadas em 09/09/2026. Nenhuma captura foi feita com login. O corpus é real e aberto, exportado do OpenAlex em 09/09/2026; os mapas foram abertos de verdade no VOSviewer Online. O VOSviewer desktop e o Bibliometrix não foram executados e são descritos pela documentação oficial. Decisões de conteúdo, seleção das fontes e responsabilidade pelo texto são do autor.

Sem garantia: interfaces, limites, orçamentos de API e versões mudam; cada fato traz a data em que foi verificado. Quando a sua tela divergir, vale a tela. A escolha da base, dos limiares e da interpretação dos clusters, a citação das ferramentas no seu texto e a declaração de uso de IA da sua pesquisa são seus e seguem o seu programa, o seu orientador e a biblioteca da sua instituição. Nenhum indicador deste manual serve para avaliar pessoas.