Посмотреть как Markdown

Цитирование

Полная ссылка на LibreYOLO состоит из двух частей: сама библиотека и опубликованная работа, стоящая за тем семейством моделей, которое дало результат.

Цитирование LibreYOLO

Репозиторий публикует метаданные для цитирования в виде файла CITATION.cff, а не блоком BibTeX. GitHub читает этот файл и показывает на странице репозитория кнопку Cite this repository, которая генерирует из него APA и BibTeX. Берите запись оттуда, а не набирайте её сами.

Файл целиком:

yaml
cff-version: 1.2.0
message: "If you use LibreYOLO in your research or software, please cite it as below."
title: "LibreYOLO"
type: software
authors:
  - family-names: Ceccon
    given-names: Xuban
  - name: "The LibreYOLO contributors"
license: MIT
url: "https://github.com/LibreYOLO/libreyolo"
repository-code: "https://github.com/LibreYOLO/libreyolo"

Ни версии, ни даты релиза в нём нет намеренно. RELEASING.md требует от мейнтейнеров никогда не повышать версию, не проставлять дату и не переименовывать CITATION.cff и .zenodo.json во время релиза — чтобы все ссылки вели на одну запись, а не расползались по версиям. Версию, которую вы запускали, укажите в своём тексте, а саму запись цитирования не трогайте.

Цитирование семейства моделей

LibreYOLO — это порт. Запуск LibreRFDETRm.pt означает запуск RF-DETR, и рецензент ожидает увидеть в ссылках именно тех, кто написал RF-DETR. Ссылка на одну лишь библиотеку приписывает их работу не тому проекту.

Всё нужное есть на странице семейства. Строка Upstream в шапке называет оригинальную работу и стоящую за ней организацию, а также даёт ссылки на статью и исходный репозиторий. Ниже, в разделе «Цитирование», лежит BibTeX.

Этот BibTeX скопирован дословно из блока цитирования самих авторов — обычно это раздел Citation в README оригинального проекта или файл CITATION.cff — и отображается со ссылкой на тот блок, откуда он взят, чтобы вы могли сверить его с источником. Он никогда не собирается из метаданных статьи. Запись, пересобранная вручную, подводит незаметно и дорого: потерянный соавтор, не та конференция, не тот тип записи, год, взятый из препринта. Препринты к тому же принимают к публикации, так что запись может оказаться @inproceedings, даже если версия, которую вы читали, лежала на arXiv.

Копируйте блок как есть. Если вашему библиографическому стилю нужен другой тип записи, преобразуйте запись, а не набирайте её заново, и сохраните исходный порядок авторов.

Что нужно указать в разделе о методах

Чтобы результат LibreYOLO был воспроизводимым и правильно атрибутированным, нужны три вещи:

  • Библиотека, процитированная по CITATION.cff, вместе с версией, которую вы запускали. libreyolo version выводит её, а заодно версии Python, torch и CUDA, с которыми она работает.
  • Оригинальная работа, процитированная из раздела «Цитирование» на странице семейства.
  • Точное имя файла чекпойнта, например LibreRFDETRm.pt. Размеры внутри одного семейства ведут себя по-разному, а несколько семейств публикуют чекпойнты, обученные на разных датасетах, под одним и тем же префиксом, так что имя семейства само по себе не определяет, что именно было запущено.

Атрибуция — это ещё и условие лицензии для значительной части того, что публикует LibreYOLO. И Apache-2.0, и семейство CC BY требуют, чтобы уведомление сопровождало веса, которые вы распространяете, — и это обязательство, отдельное от цитирования статьи. См. лицензирование, чтобы понять, какие условия действуют для какого чекпойнта.

Проверено с LibreYOLO v1.5.0.