Pular para o conteúdo principal
Receita número 140

Receitas · Capítulo 7 · Figuras e imagens

Uma carta de física com a figura de dados no alto

A carta da descoberta de GW150914 em duas colunas: o sinal redesenhado com dados abertos na página 1, citações [1] numeradas, fórmulas e a Tabela I.

Nesta página
  • Amostra em inglês: ainda sem edição em português
  • Refile 215,9 × 279,4 mm
  • 2 colunas, medianiz de 7 mm
  • Gelasio 9,3/12,4
  • Albert Sans
  • 5 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 209 ms
  • 189 linhas de código

Em poucas palavras

A carta de 2016 que anunciou as primeiras ondas gravitacionais, resumida e composta de novo em papel carta. O sinal dos dois detectores, desenhado com os dados públicos, cruza a página 1; as referências vão numeradas entre colchetes.

O que você vai compor

Cinco páginas da carta que anunciou as primeiras ondas gravitacionais, Observation of Gravitational Waves from a Binary Black Hole Merger (Abbott et al., 2016), resumida e recomposta em papel carta US, em duas colunas. A página 1 abre com a evidência: a deformação registrada em Hanford e Livingston, redesenhada a partir dos arquivos de dados abertos do Gravitational Wave Open Science Center, atravessa as duas colunas sob o título. Abaixo vêm a autoria da colaboração com a nota, o resumo na largura da página e o texto, com as citações numeradas [1,2] e [25–27] como as revistas da APS as imprimem. A massa de chirp é a equação (1). A Tabela I compõe os erros assimétricos como sobrescrito e subscrito empilhados, escritos como fórmulas nas células, e as legendas imprimem as fórmulas da própria carta. Traga seu BibTeX e seus arquivos de dados, e o mesmo script compõe sua carta.

Esta receita responde a

  • Como componho um artigo curto de física (letter): a assinatura de uma colaboração, o resumo sobre as duas colunas e uma figura de dados no alto, em toda a largura?
  • Como decido onde vai uma figura: no alto da página, sobre as duas colunas, exatamente aqui ou na margem?
  • Como componho matemática (em linha, em destaque, equações) e a mantenho vetorial no PDF?
  • Como recomponho com o Postext um artigo de acesso aberto do arXiv ou do PubMed Central, mantendo citações, figuras e linha de licença?

A resposta curta

script.js · linhas 32–60no código completo
// [@key] numbers works by first citation. APS journals print [1,2] and [2–4] in one pair of
// brackets and list "A. Einstein, Sitzungsber. K. Preuss. Akad. Wiss. 1, 688 (1916).": no
// title, volume bold. No APS style is bundled: four edits turn the IEEE file into one.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const ARTICLE = '<group delimiter=" "><text variable="container-title"/><text '
  + 'variable="volume" font-weight="bold" suffix=","/><text variable="page"/><date '
  + 'variable="issued" prefix="(" suffix=")"><date-part name="year"/></date></group>';
const BOOK = '<group delimiter=" "><group delimiter=", "><choose><if type="chapter"><text '
  + 'variable="container-title" prefix="in " font-style="italic"/></if><else><text variable='
  + '"title" font-style="italic"/></else></choose><names variable="editor" prefix="edited by ">'
  + '<name and="text" initialize-with=". "/></names><text variable="collection-title"/><text '
  + 'variable="volume" prefix="Vol. "/></group><group prefix="(" suffix=")" delimiter=", ">'
  + '<text variable="publisher"/><text variable="publisher-place"/><date variable="issued">'
  + '<date-part name="year"/></date></group></group><text variable="page" prefix="pp. "/>';
const aps = STYLES.ieee
  .replace('<citation>', '<citation collapse="citation-number">') // [2–4], not [2], [3], [4]
  .replace(/<layout delimiter=", ">\s*<group prefix="\[" suffix="\]" delimiter=", ">/,
    '<layout prefix="[" suffix="]" delimiter=","><group delimiter=", ">') // [1,2]
  .replace('et-al-min="7"', 'et-al-min="11"') // ten authors are listed, as in the letter
  .replace(/<bibliography[\s\S]*<\/bibliography>/, '<bibliography second-field-align="flush">'
    + '<layout suffix="."><text variable="citation-number" prefix="[" suffix="]"/><text '
    + 'macro="author"/><choose><if type="manuscript"><text variable="note" prefix=" "/></if>'
    + `<else><group prefix=", " delimiter=", "><choose><if type="article-journal">${ARTICLE}`
    + `</if><else-if type="book chapter" match="any">${BOOK}</else-if><else><text variable=`
    + '"URL"/><text variable="note"/></else></choose></group></else></choose></layout>'
    + '</bibliography>');
const citations = { style: 'custom', customStyle: aps, link: true,
  bibliography: { fontSize: em(0.84), lineHeight: pt(9.5), entrySpacing: pt(0.4),
    labelWidth: mm(6.2) } }; // the [64] column: turnovers line up after the widest label

Ingredientes

Tipografia
Gelasio, Albert Sans (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Citações numeradas de física a partir do arquivo IEEE

O código é a resposta curta logo acima. O postext-citeproc não traz um estilo APS, e o estilo ieee que o acompanha é o mais próximo: ordem de citação, números entre colchetes, iniciais antes do sobrenome. Quatro substituições de texto em STYLES.ieee cobrem a diferença. collapse="citation-number" junta as sequências ([25–27]), um único par de colchetes no layout imprime [1,2], et-al-min sobe para onze para que uma lista de dez autores saia inteira, e um bloco <bibliography> novo imprime a referência como a Physical Review faz, com a revista, o volume em negrito, a página e o ano: Phys. Rev. Lett. 74, 3515 (1995). As 43 obras vêm num bloco :::references{format=bibtex} próprio; um nome entre chaves duplas como {{J. Aasi et al.}} sai impresso tal como foi escrito, e é assim que a carta cita as longas listas de autores da própria colaboração. Veja Citações e bibliografia.

#2 · A Figura 1 sob o título, na largura das duas colunas

script.js · linhas 64–89no código completo
const text = (id, content, family, size, extra) => ({ kind: 'text', id, content, align: 'left',
  fontFamily: family, fontSize: pt(size), color: col('ink'), overflow: 'wrap', ...extra });
const at = (to, edge, x, y, width) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
  ...(width && { size: { width: mm(width), height: 'auto' } }) });
const caps = (size) => ({ fontWeight: 700, letterSpacing: pt(size * 0.2),
  textTransform: 'uppercase', color: col('accent') });
const letter = { id: 'letter', numbered: false, span: 'page', marginBottom: pt(0),
  advancedDesign: { enabled: true, minHeight: mm(21), slot: { elements: [
    text('kicker', '{attr.kicker}', SANS, 7.5, { ...caps(7.5),
      placement: at('container', 'top-left', 0, 2, MEASURE) }),
    text('title', '{titleText}', SANS, 23, { fontWeight: 700, lineHeight: 1.08,
      placement: at('#kicker', 'below', 0, 2.2, MEASURE) }),
  ] } } };
const box = { padding: { top: mm(2.6), right: mm(12), bottom: mm(2.4), left: mm(12) },
  background: col('tint'), marginTop: pt(0), marginBottom: pt(LEAD), span: 'page',
  body: { fontSize: pt(9.3), lineHeight: pt(12.6), firstLineIndent: pt(0) } };
// ::resource{id="fig1"} right under the title, placed { position: 'here', span: 'page' }:
// it spans both columns on page 1, where a float could only follow its citation.
const paragraphStyles = [
  { id: 'byline', fontFamily: SANS, fontSize: pt(10), lineHeight: pt(12.6), fontWeight: 600,
    textAlign: 'center', firstLineIndent: pt(0) },
  { id: 'dates', fontFamily: SANS, fontSize: pt(7.6), lineHeight: pt(12.6), textAlign: 'center',
    color: col('muted'), firstLineIndent: pt(0) },
  { id: 'colophon', fontFamily: SANS, fontSize: pt(7), lineHeight: pt(9.4), color: col('muted'),
    textAlign: 'left', firstLineIndent: pt(0), marginTop: pt(LEAD) },
];

Um flutuante nunca fica acima da linha que o cita, e o texto cita a Figura 1 pela primeira vez na seção II, por isso, como flutuante, ela não chegaria à página 1. A carta a põe ali diretamente: ::resource{id="fig1"} vem logo depois do título, e o posicionamento dele, { position: 'here', span: 'page' }, a estende sobre as duas colunas nesse ponto, com as colunas continuando embaixo. A autoria e o resumo vêm em seguida num boxe na largura da página, front, cujos blocos :::paragraphs centralizam a autoria e compõem as datas em corpo pequeno. A chamada de nota depois de et al. manda o texto da nota para o pé da primeira coluna, onde as revistas da APS imprimem a nota sobre os autores, e footnotes.numberFormat: 'lower-alpha' marca as notas com letras, para que nunca sejam lidas como referências. Veja Inserção em bloco e Notas de rodapé.

#3 · A Tabela I, com fórmulas nas células

script.js · linhas 346–354no código completo
// A cell sets $…$ in the line, at the table's size: the errors stack over and under the value.
const VALUES = [['Primary black hole mass', '$36^{+5}_{-4}\\,M_\\odot$'],
  ['Secondary black hole mass', '$29^{+4}_{-4}\\,M_\\odot$'],
  ['Final black hole mass', '$62^{+4}_{-4}\\,M_\\odot$'],
  ['Final black hole spin', '$0.67^{+0.05}_{-0.07}$'],
  ['Luminosity distance', '$410^{+160}_{-180}$ Mpc'],
  ['Source redshift $z$', '$0.09^{+0.03}_{-0.04}$']];
const table = { model: { columnWidths: [1.3, 1], rows: VALUES.map(([label, value]) =>
  [{ content: label, verticalAlign: 'middle' }, { content: value }]) } };

Uma célula de tabela compõe $…$ como o texto (desde o postext 1.19), por isso cada valor é escrito em TeX, $36^{+5}_{-4}\,M_\odot$, e os dois erros se empilham acima e abaixo do número, ajustados à linha da célula; o ^+5^~−4~ do Markdown os imprimiria um depois do outro. Legendas e notas aceitam as mesmas fórmulas: a Figura 2 escreve $R_S = 2GM/c^2$ e a Figura 4, $5.1\sigma$, compostas com os glifos do MathJax, que têm o grego que nenhuma das duas fontes do texto traz, e o PDF os mantém como traçados vetoriais. Os tipos de recurso imprimem FIG. 1 e TABLE I nas legendas e Fig. 1 e Table I no texto: um captionPrefix, e counterFormat: 'upper-roman' para as tabelas. Veja Fórmulas matemáticas.

#4 · Figuras desenhadas a partir dos dados abertos

script.js · linhas 17–22no código completo
const palette = { ink: '#171a21', accent: '#25578a', tint: '#eef2f6', rule: '#b7c0ca',
  muted: '#5a636e', paper: '#ffffff' };
const data = { hanford: '#cf5f24', livingston: palette.accent, purple: '#74519c' }; // figures
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

As quatro figuras são desenhadas em código a partir dos arquivos de dados que o GWOSC publica com a carta, sob CC BY 4.0. Cada traço mantém uma de cada oito amostras, 430 pontos para os 0,21 s da Figura 1, guardados com um caractere em base 64 por ponto para a variação em relação ao anterior, o que deixa os cinco traços com menos de 3 KB dentro do script. A linha do resíduo são os dados menos a forma de onda, como no original. Hanford é laranja e Livingston é azul em todas as figuras, e o texto fica com a tinta da página e um único azul. Os rótulos são traçados do MathJax na letra sem serifa (\textsf), de modo que um expoente ou um símbolo num eixo é composto como as fórmulas do texto, e o PDF mantém cada linha e cada rótulo como vetores.

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 140 · A physics letter with a data figure across the top ═══
// https://postext.dev/en/cookbook/physics-letter-two-columns
// Code: MIT · Text: Abbott et al., PRL 116, 061102 (CC BY 3.0) · Data: GWOSC (CC BY 4.0)
// Fonts: Gelasio, Albert Sans (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage, registerCitationEngine,
  defaultResourceTypes, initMathEngine, renderMath,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { createCiteprocEngine, STYLES, LOCALES } from 'https://esm.sh/postext-citeproc';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'physics-letter-two-columns';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink and one blue for the text; the detectors' colours for the data
const palette = { ink: '#171a21', accent: '#25578a', tint: '#eef2f6', rule: '#b7c0ca',
  muted: '#5a636e', paper: '#ffffff' };
const data = { hanford: '#cf5f24', livingston: palette.accent, purple: '#74519c' }; // figures
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.accent })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [SERIF, SANS] = ['Gelasio', 'Albert Sans'];
// mm: US Letter, head, foot and side margins, gutter; then the measure and one column
const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [215.9, 279.4, 21, 21, 16, 7];
const MEASURE = TRIM_W - 2 * SIDE;
const COLUMN = (MEASURE - GUTTER) / 2;
const [BODY, LEAD] = [9.3, 12.4]; // pt: a letter journal's density, two columns of 88 mm

// #region answer: physics citations [1] and [2–4], from the bundled IEEE style
// [@key] numbers works by first citation. APS journals print [1,2] and [2–4] in one pair of
// brackets and list "A. Einstein, Sitzungsber. K. Preuss. Akad. Wiss. 1, 688 (1916).": no
// title, volume bold. No APS style is bundled: four edits turn the IEEE file into one.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const ARTICLE = '<group delimiter=" "><text variable="container-title"/><text '
  + 'variable="volume" font-weight="bold" suffix=","/><text variable="page"/><date '
  + 'variable="issued" prefix="(" suffix=")"><date-part name="year"/></date></group>';
const BOOK = '<group delimiter=" "><group delimiter=", "><choose><if type="chapter"><text '
  + 'variable="container-title" prefix="in " font-style="italic"/></if><else><text variable='
  + '"title" font-style="italic"/></else></choose><names variable="editor" prefix="edited by ">'
  + '<name and="text" initialize-with=". "/></names><text variable="collection-title"/><text '
  + 'variable="volume" prefix="Vol. "/></group><group prefix="(" suffix=")" delimiter=", ">'
  + '<text variable="publisher"/><text variable="publisher-place"/><date variable="issued">'
  + '<date-part name="year"/></date></group></group><text variable="page" prefix="pp. "/>';
const aps = STYLES.ieee
  .replace('<citation>', '<citation collapse="citation-number">') // [2–4], not [2], [3], [4]
  .replace(/<layout delimiter=", ">\s*<group prefix="\[" suffix="\]" delimiter=", ">/,

O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)

Variações

#Use o estilo IEEE como ele vem

Sem as substituições, as referências aparecem como [2], [3], [4] no texto e A. Einstein, “title”, journal… na lista.

-const citations = { style: 'custom', customStyle: aps, link: true,
+const citations = { style: 'ieee', link: true,

#Suba os números como faz a Nature

O estilo da Nature usa números sobrescritos e lista os títulos; ele vem incluído.

-const citations = { style: 'custom', customStyle: aps, link: true,
+const citations = { style: 'nature', link: true,

#Componha em A4

Mude o formato; a medida, as colunas e todas as figuras derivam dele.

-const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [215.9, 279.4, 21, 21, 16, 7];
+const [TRIM_W, TRIM_H, TOP, BOTTOM, SIDE, GUTTER] = [210, 297, 22, 22, 15, 7];

Erros comuns

Erro comum

Matemática precisa de await initMathEngine() antes da primeira composição

Fórmulas diagramadas antes de o motor de matemática estar rodando saem como caixas cinza no lugar da fórmula. Importe initMathEngine de https://esm.sh/postext com os outros símbolos e aguarde-o com await antes da primeira composição; um documento com matemática composto sem ele imprime um aviso no console. Desde o postext 1.5, o MathJax vem dentro do pacote postext como um único módulo que initMathEngine baixa, então a importação simples funciona a partir de uma CDN e ?bundle não é necessário (até a 1.4, todos os símbolos tinham de vir de https://esm.sh/postext?bundle). Importe de uma única URL: duas URLs carregam dois motores. Matemática →

  • Até o postext 1.18, um recurso 'here' com span: 'page' saía na largura de uma coluna num fluxo de duas colunas, e um $ numa legenda ou numa célula era impresso como digitado. Fixe a versão 1.19 ou posterior.
  • Uma letra grega, ⊙ ou ≃ digitado como caractere numa legenda ou numa célula cai numa fonte do sistema na tela e some do PDF, que incorpora os arquivos latin de cada fonte. Escreva como fórmula, $\sigma$ ou $M_\odot$, e desenhe nas figuras.
  • Uma lista de centenas de autores não cabe num arquivo BibTeX. Escreva o nome como a revista o imprime, entre chaves duplas: author={{B. Abbott et al.}}.
  • Mantenha a linha de licença do artigo e a dos dados. Aqui, uma nota de rodapé e o colofão dizem o que foi cortado, e a nota de cada legenda identifica os dados e o que a figura redesenhada deixa de fora.

Créditos

Texto
  • Text: B. P. Abbott et al. (LIGO Scientific Collaboration and Virgo Collaboration), “Observation of Gravitational Waves from a Binary Black Hole Merger”, Phys. Rev. Lett. 116, 061102 (2016), doi:10.1103/PhysRevLett.116.061102. Abridged from the published letter (Sections IV and VII, parts of Sections I, III, V and VI and most of the acknowledgments cut; sections and references renumbered); figures redrawn; figure captions shortened. Licence: CC BY 3.0, https://creativecommons.org/licenses/by/3.0/ · LIGO Scientific Collaboration and Virgo Collaboration · CC BY 3.0
  • Data for Figures 1, 2 and 4: the GW150914 data files released by the Gravitational Wave Open Science Center (gwosc.org), a service of the LIGO Scientific Collaboration, the Virgo Collaboration and KAGRA; redrawn in code · LIGO Scientific Collaboration and Virgo Collaboration, GWOSC · CC BY 4.0
Fontes
Gelasio (SIL OFL 1.1) · Albert Sans (SIL OFL 1.1)
SandboxPDF