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

Практический 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).

Локальную папку проекта проще упаковать в архив для коллеги, чем облачный проект, доступ к которому он теряет после окончания обучения. Настоящая история 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 — лишь рама. Позаботьтесь, чтобы рама не подвела в ночь перед подачей.

Все записи