Статьи по биологии и наукам о жизни: рисунки, составные панели и соавторы
Практический LaTeX для экспериментальной и вычислительной биологии: составные рисунки, разрешение, дополнительные материалы, запись статистики и совместная работа без перезаписи правок друг друга.
Рукописи по наукам о жизни строятся вокруг рисунков. Рецензенты просматривают составной рисунок раньше, чем читают ваш текст, поэтому рисунок должен нести утверждение сам, без отговорок в подписи. LaTeX с этим справляется, если относиться к рисункам как к полноценным файлам проекта, а не как к чему-то, что вставляют в два часа ночи перед сроком сдачи дополнительных материалов.
Экспериментальные и вычислительные группы попадают в одни и те же неприятности: панели без общих масштабных линеек, артефакты JPEG на блотах, дополнительные материалы, которые не компилируются, и десяток соавторов, правящих один абзац. Ниже то, что действительно работает.
Составные рисунки из нескольких панелей
Рецензенты ожидают панели (a)(b)(c) под одной общей подписью. Есть два пути:
- Собрать рисунок вне TeX (Illustrator, Inkscape, экспорт из Fiji) и вставить один PDF или PNG, или
- Собрать в 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 — лишь рама. Позаботьтесь, чтобы рама не подвела в ночь перед подачей.