Статті з біології та наук про життя: рисунки, багатопанельні композиції та співавтори

Практичний LaTeX для експериментальної й обчислювальної біології: багатопанельні рисунки, роздільна здатність, додаткові матеріали, статистичні позначення та співпраця без взаємного перезапису правок.

Рукописи з наук про життя починаються з рисунків. Рецензенти проглядають складений рисунок, перш ніж читати ваш текст, тож рисунок має нести твердження сам, без відмахування в підписі. LaTeX чудово з цим справляється, якщо ставитися до рисунків як до повноцінних файлів проєкту, а не як до чогось, що вставляють о другій ночі перед терміном подання додаткових матеріалів.

Експериментальні й обчислювальні групи потрапляють у ті самі халепи: панелі без спільних масштабних лінійок, артефакти JPEG на блотах, додаткові матеріали, які не компілюються, і десяток співавторів, що редагують один абзац. Нижче те, що справді працює.

Багатопанельні рисунки

Рецензенти очікують панелі (a)(b)(c) під одним підписом. Можна піти одним із двох шляхів:

  1. Зібрати складений рисунок поза TeX (Illustrator, Inkscape, експорт із Fiji) і вставити один PDF або PNG, або
  2. Зібрати в TeX за допомогою subcaption, коли кожна панель — окремий файл:
\usepackage{subcaption}
\begin{figure}[htbp]
\begin{subfigure}{0.48\textwidth}
\includegraphics[width=\linewidth]{a.pdf}
\caption{Control}\label{fig:exp-a}
\end{subfigure}\hfill
\begin{subfigure}{0.48\textwidth}
\includegraphics[width=\linewidth]{b.pdf}
\caption{Treatment}\label{fig:exp-b}
\end{subfigure}
\caption{Overall experiment.}\label{fig:exp}
\end{figure}

Посилайтеся на панелі в тексті як Рисунок~\ref{fig:exp}a, лише якщо стиль журналу це дозволяє. Багато видань віддають перевагу «Рисунок 2A» з однією схемою, застосованою всюди. Докладніше про цей підхід: панелі a, b, c.

Називайте файли послідовно (fig03_western_a.pdf), щоб ніхто не вигадував final_gel_NEW.png у тиждень подання.

Роздільна здатність, колір і формати файлів

Зберігайте архіви мікроскопії у TIFF або PDF високої роздільної здатності. Для самого PDF статті використовуйте векторну графіку для схем і PNG/PDF із достатньою кількістю dpi для растрових даних. Не використовуйте JPEG для лінійних позначок і гелів. Артефакти стиснення сприймаються як недбала наука, навіть якщо з експериментом усе гаразд.

Перевірте плату за кольоровий друк і правила друку, перш ніж розробляти шестикольорову палітру, що працює лише на вашому відкаліброваному моніторі. Деякі журнали хочуть CMYK; інші погано конвертують без попередження. Коли вони просять версії ключових рисунків, придатні для відтінків сірого, надайте їх.

Розміщуйте масштабні лінійки та одиниці інтенсивності на самій панелі, а не лише в підписі. Якщо видавництво переверстає рисунки, вбудовані масштабні лінійки лишаться; примітки лише в підписі часто зникають.

Схеми та панелі з даними

Тримайте «схематичне зображення шляху» окремо від «кількісної оцінки блоту». Схеми можуть бути на TikZ або зовнішньою векторною графікою. Панелі з даними мають лишатися поруч з експортом аналізу, щоб ви могли згенерувати їх знову, коли рецензент захоче іншу нормалізацію. Вказуйте шлях до скрипта аналізу в примітках до підпису або в додатку про відтворюваність, якщо журнал це дозволяє.

Додаткові матеріали, які все ще компілюються

Величезні таблиці, додаткові гелі та кадри з відео належать до додаткових матеріалів в окремому документі або до чіткого додатка. Кілька правил, що рятують від головного болю:

Мітки мають бути унікальними, якщо основний текст і додаткові матеріали компілюються разом. Якщо це окремі проєкти, пишіть «Рисунок S3» звичайним текстом і не покладайтеся на \ref між різними PDF. Ведіть короткий перелік того, які твердження основного тексту посилаються на які елементи додаткових матеріалів, щоб нічого не розійшлося.

Додаткові матеріали, що не компілюються в тиждень подання, усе одно ваша проблема, навіть якщо основний PDF виглядає чисто.

Хаос із багатьма авторами

У біологічних статтях часто багато співавторів із різним рівнем володіння LaTeX. Закріпіть файли за розділами (results.tex, methods.tex, figs.tex), зливайте зміни через Git і вирішіть, хто підтримує .bib (одна людина чи спільний експорт групи Zotero).

Теку проєкту на вашому комп’ютері простіше запакувати в ZIP для співавтора, ніж хмарний проєкт, доступ до якого він втрачає після закінчення навчання. Справжня історія Git краща за вкладення в листах на кшталт manuscript_JM_edits_FINAL.docx, які хтось потім вручну перетворює назад на TeX. Робіть контрольні точки після успішних компіляцій; відновлюйте, коли злиття пішло не так; тримайте приватний віддалений репозиторій.

Якщо частина співавторів редагує лише у Word, експортуйте для них DOCX або PDF, а .tex залишайте джерелом істини. Див. співавтори, які користуються лише Word.

Методи та статистичні позначення

Визначте статистичні макроси один раз, щоб p-значення не з’являлися в одній статті і як $p$, і як p=:

\newcommand{\pvalue}[1]{$p = #1$}
\newcommand{\ci}[2]{95\% CI $[#1, #2]$}

Вказуйте тест, n і поправку на множинні порівняння в методах або примітках до таблиці, а не лише в легенді рисунка, яку обрізають на видавничому етапі. Щільним статтям корисний короткий перелік позначень. Перевірка посилань і цитувань наживо в редакторі для досліджень виявляє \ref на видалену панель раніше за рецензента.

Підписи, що несуть твердження

Добрий підпис каже, що вимірювали, в якій системі та на що читачеві звернути увагу. Уникайте «Див. текст». Не скидайте в підпис методи, які належать до розділу методів. Літери панелей (жирні або в дужках) мають відповідати внутрішньому стилю видання.

Контрольний список рисунків перед поданням

Перш ніж натиснути «Подати», пройдіться по рисунках ще раз:

  • Кожен основний рисунок процитовано по порядку (або в будь-якому порядку, який дозволяє журнал).
  • Панелі позначені; масштабні лінійки там, де вони важливі.
  • Жодного безладу з JPEG на кількісних панелях.
  • Додаткові матеріали компілюються; номери з літерою S не перетасувалися.
  • Правила щодо кольору перевірено; розміри файлів у межах лімітів порталу.
  • Вихідні зображення та скрипти досі можна знайти в проєкті або в архіві лабораторії.

Вестерн-блоти, гелі та контраст

Не обробляйте блоти надмірно для PDF. Журнали й читачі стежать за маніпуляціями з контрастом. Зберігайте необроблені файли в архіві лабораторії й подавайте панелі, що відповідають тим, які використано для кількісної оцінки. Якщо ви переставляєте панелі, оновлюйте кожну літеру панелі в тексті в той самий день, а не «потім».

Відео та інтерактивні додатки

Коли журнал дозволяє відео, розміщуйте їх так, як він вимагає, а в PDF вставте кадр із підписом. Не покладайтеся на особисте хмарне посилання, що вмирає після закінчення навчання.

Рисунки — основа таких статей. LaTeX — лише рамка. Простежте, щоб саме рамка не підвела напередодні подання.

Всі пости