Datasets documentation

Утилиты

You are viewing main version, which requires installation from source. If you'd like regular pip install, checkout the latest stable version (v4.8.4).
Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Утилиты

Настройка журналирования

🤗 Datasets стремится к прозрачности и ясности в описании своей работы, но иногда это может быть излишне подробным. Мы включили набор методов журналирования, которые позволяют легко регулировать уровень детализации сообщений всей библиотеки. В настоящее время уровень детализации библиотеки по умолчанию установлен на WARNING.

Чтобы изменить уровень детализации, используйте один из прямых сеттеров. Например, вот как изменить уровень детализации на INFO:

import datasets
datasets.logging.set_verbosity_info()

Вы также можете использовать переменную окружения DATASETS_VERBOSITY, чтобы переопределить уровень детализации по умолчанию, установив одно из следующих значений: debug, info, warning, error, critical:

DATASETS_VERBOSITY=error ./myprogram.py

Все методы этого модуля журналирования описаны ниже. Основные из них:

  • logging.get_verbosity() для получения текущего уровня детализации в логгере
  • logging.set_verbosity() для установки уровня детализации по вашему выбору

В порядке от наименее к наиболее подробным (с соответствующими значениями int):

  1. logging.CRITICAL или logging.FATAL (целое значение, 50): сообщать только о самых критических ошибках.
  2. logging.ERROR (целое значение, 40): сообщать только об ошибках.
  3. logging.WARNING или logging.WARN (целое значение, 30): сообщает только об ошибках и предупреждениях. Это уровень по умолчанию, используемый библиотекой.
  4. logging.INFO (целое значение, 20): сообщает об ошибках, предупреждениях и базовой информации.
  5. logging.DEBUG (целое значение, 10): выводить всю информацию.

datasets.utils.logging.get_verbosity

< >

( )

Возвращает текущий уровень для корневого логгера библиотеки HuggingFace datasets.

Библиотека HuggingFace datasets поддерживает следующие уровни журналирования:

  • datasets.logging.CRITICAL, datasets.logging.FATAL
  • datasets.logging.ERROR
  • datasets.logging.WARNING, datasets.logging.WARN
  • datasets.logging.INFO
  • datasets.logging.DEBUG

datasets.utils.logging.set_verbosity

< >

( verbosity: int )

Параметры

  • verbosity — Уровень ведения журнала, например, datasets.logging.DEBUG и datasets.logging.INFO.

Установите уровень для корневого логгера библиотеки Hugging Face Datasets.

datasets.utils.logging.set_verbosity_info

< >

( )

Установите уровень корневого логгера библиотеки Hugging Face datasets на INFO.

Это отобразит большую часть информации журнала и прогресс-бары tqdm.

Краткая форма вызова datasets.logging.set_verbosity(datasets.logging.INFO).

datasets.utils.logging.set_verbosity_warning

< >

( )

Установите уровень корневого логгера библиотеки Hugging Face datasets на WARNING.

Это отобразит только предупреждения, сообщения об ошибках и полосы tqdm.

Краткая форма вызова datasets.logging.set_verbosity(datasets.logging.WARNING).

datasets.utils.logging.set_verbosity_debug

< >

( )

Установите уровень корневого логгера библиотеки Hugging Face datasets на DEBUG.

Это отобразит всю информацию журнала и прогресс-бары tqdm.

Краткая форма вызова datasets.logging.set_verbosity(datasets.logging.DEBUG).

datasets.utils.logging.set_verbosity_error

< >

( )

Установите уровень корневого логгера библиотеки Hugging Face datasets на ERROR.

Это отобразит только информацию об ошибках в журнале и полосы tqdm.

Краткая форма вызова datasets.logging.set_verbosity(datasets.logging.ERROR).

datasets.utils.logging.disable_propagation

< >

( )

Отключите распространение логов библиотеки. Обратите внимание, что по умолчанию распространение логов отключено.

datasets.utils.logging.enable_propagation

< >

( )

Включите распространение логов библиотеки. Отключите обработчик по умолчанию библиотеки Hugging Face datasets, чтобы избежать дублирования записей в журнале, если корневой логгер был настроен.

Настройка индикаторов прогресса

По умолчанию во время загрузки и предобработки набора данных отображаются индикаторы прогресса tqdm. Их можно отключить глобально, задав переменную окружения HF_DATASETS_DISABLE_PROGRESS_BARS. Также их можно включать и отключать с помощью функций enable_progress_bars() и disable_progress_bars(). Если переменная окружения задана, она имеет приоритет над вспомогательными функциями.

datasets.enable_progress_bars

< >

( )

Включает глобальные индикаторы прогресса, используемые в datasets, если переменная окружения HF_DATASETS_DISABLE_PROGRESS_BARS не установлена.

Используйте disable_progress_bars(), чтобы отключить их.

datasets.disable_progress_bars

< >

( )

Глобально отключить полосы прогресса, используемые в datasets, если переменная окружения HF_DATASETS_DISABLE_PROGRESS_BARS не была установлена.

Используйте enable_progress_bars(), чтобы включить их снова.

datasets.are_progress_bars_disabled

< >

( )

Возвращает, глобально отключены ли полосы прогресса.

Индикаторы прогресса, используемые в datasets, можно глобально включать или отключать с помощью enable_progress_bars() и disable_progress_bars() либо установив переменную окружения HF_DATASETS_DISABLE_PROGRESS_BARS.

Update on GitHub