SDK участника · трек A
Проверять работу на своей машине
Пакет finalgo-sdk проверяет файл теми же проверками, которые исполнит сервер, и считает результат тем же кодом. Цикл «отправил — жду — не понял ошибку» на этом заканчивается.
SDK не повторяет сервер — он и есть сервер в этой части. Разбор файла и проверка полноты покрытия вынесены в пакет, а ядро оценки импортирует их оттуда же, откуда получаете вы. Две реализации одной проверки разошлись бы молча: локально «годится», на сервере отказ — и участник был бы прав в своём недоумении.
Что умеет
Проверка
Примет ли сервер файл
Схема и полнота покрытия — те же два условия допуска, что проверяет гейт. Ответ за секунду вместо суток в очереди.
Расчёт
Свой результат локально
Поэрная ранговая корреляция, поправка на перекрытие эр, значимость —
пакетом finalgo_metrics, которым считает сервер.
Заготовка
Полное покрытие по построению
Файл со всеми парами набора и нулями вместо предсказаний. Пропущенная строка — это отказ гейта, и лучше не создавать такой возможности.
Как пользоваться
Проверить работу перед отправкой
finalgo-sdk validate work.csv --dataset dataset.parquetКоманда печатает исход каждой проверки и возвращает ненулевой код, если хоть одна не пройдена: её можно поставить в свой конвейер, а не читать глазами.
Посчитать результат на учебном наборе
finalgo-sdk score work.csv --dataset dataset.parquetПечатаются измеренные величины: средняя корреляция по эрам, доля положительных эр, разброс, эффективное число наблюдений и значимость.
Собрать заготовку
finalgo-sdk template --dataset dataset.parquet --output work.csvВ заготовке все предсказания равны нулю, а покрытие полное. Заменяйте значения своими — строки удалять не нужно и нельзя.
Композитного балла SDK не считает. Он относителен: компоненты приводятся к сопоставимому виду рангом среди работ раунда, и в расчёте на своей машине сравнивать не с чем. Считаются измеренные величины — те же, из которых балл потом собирается.
В сеть пакет не ходит. Ни одна его функция никуда не обращается: работа проверяется и считается на вашей машине, а отправляется через сайт. Пакету, ходящему в сеть, потребовался бы ключ доступа — то есть секрет, лежащий у вас на диске.