Sweep Класс

Базовый класс для узла очистки.

Экземпляр этого класса не следует создавать напрямую. Вместо этого его следует создать с помощью функции построителя: sweep.

Наследование

azure.ai.ml.entities._job.sweep.parameterized_sweep.ParameterizedSweep

Sweep

azure.ai.ml.entities._builders.base_node.BaseNode

Sweep

Конструктор

Sweep(*, trial: CommandComponent | str | None = None, compute: str | None = None, limits: SweepJobLimits | None = None, sampling_algorithm: str | SamplingAlgorithm | None = None, objective: Objective | None = None, early_termination: BanditPolicy | MedianStoppingPolicy | TruncationSelectionPolicy | None = None, search_space: Dict[str, Choice | LogNormal | LogUniform | Normal | QLogNormal | QLogUniform | QNormal | QUniform | Randint | Uniform] | None = None, inputs: Dict[str, int | str | float | bool | Input] | None = None, outputs: Dict[str, str | Output] | None = None, identity: ManagedIdentityConfiguration | AmlTokenConfiguration | UserIdentityConfiguration | None = None, queue_settings: QueueSettings | None = None, **kwargs)

Параметры

trial

Union[CommandComponent, str]

Обязательно

Идентификатор или экземпляр компонента команды или задания, которые будут выполняться для шага.

compute

str

Обязательно

Определение вычислений, содержащее сведения о вычислениях для шага.

limits

SweepJobLimits

Обязательно

Ограничения для узла очистки.

sampling_algorithm

str

Обязательно

Алгоритм выборки, используемый для выборки в пространстве поиска. Допустимые значения: "random", "grid" или "bayesian".

objective

Objective

Обязательно

Цель, используемая для определения целевого запуска с локальным оптимальным гиперпараметровом в пространстве поиска.

early_termination_policy

Union[BanditPolicy, MedianStoppingPolicy, TruncationSelectionPolicy]

Обязательно

Политика раннего завершения узла очистки.

search_space

Dict[str, Union[Choice, LogNormal, LogUniform, Normal, QLogNormal, QLogUniform, QNormal, QUniform, Randint, Uniform]]

Обязательно

Пространство поиска гиперпараметров для запуска пробных версий.

inputs

Dict[str, Union[Input, str, bool, int, float]]

Обязательно

Сопоставление привязок входных данных, используемых в задании.

outputs

Dict[str, Union[str, Output]]

Обязательно

Сопоставление привязок выходных данных, используемых в задании.

identity

Union[ManagedIdentityConfiguration, AmlTokenConfiguration, UserIdentityConfiguration]

Обязательно

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

queue_settings

QueueSettings

Обязательно

Параметры очереди для задания.

Методы

clear
copy
dump	Создает дампы содержимого задания в файл в формате YAML.
fromkeys	Создайте новый словарь с ключами из итерируемых значений и значениями со значением value.
get	Возвращает значение для ключа, если ключ находится в словаре, в противном случае значение по умолчанию.
items
keys
pop	Если ключ не найден, верните значение по умолчанию, если оно задано. в противном случае создайте keyError.
popitem	Удалите и верните пару (ключ, значение) в виде двух кортежей. Пары возвращаются в порядке LIFO (последний вход, первый выход). Вызывает ошибку keyError, если дикт пуст.
set_limits	Задайте ограничения для узла очистки. Оставьте для параметров значение Нет, если вы не хотите обновлять соответствующие значения.
set_objective	Задайте объект очистки. Оставьте для параметров значение Нет, если вы не хотите обновлять соответствующие значения. "minimize", "maximize". :type goal: str :ключевое слово primary_metric: имя метрики для оптимизации. :p aramtype primary_metric: str
setdefault	Вставьте ключ со значением по умолчанию, если ключ отсутствует в словаре. Возвращает значение для ключа, если ключ находится в словаре, в противном случае значение по умолчанию.
update	Если присутствует E и имеет метод .keys(), то выполняет: для k в E: D[k] = E[k] Если E присутствует и отсутствует метод .keys(), то выполняет: для k, v в E: D[k] = v В любом случае за этим следует: для k в F: D[k] = F[k]
values

clear

clear() -> None.  Remove all items from D.

copy

copy() -> a shallow copy of D

dump

Создает дампы содержимого задания в файл в формате YAML.

dump(dest: str | PathLike | IO, **kwargs) -> None

Параметры

dest

Union[<xref:PathLike>, str, IO[AnyStr]]

Обязательно

Локальный путь или файловый поток для записи содержимого YAML. Если dest — это путь к файлу, будет создан новый файл. Если dest является открытым файлом, файл будет записан напрямую.

kwargs

dict

Дополнительные аргументы для передачи в сериализатор YAML.

Исключения

FileExistsError

Возникает, если dest — это путь к файлу, а файл уже существует.

IOError

Возникает, если dest является открытым файлом и файл не поддерживает запись.

fromkeys

Создайте новый словарь с ключами из итерируемых значений и значениями со значением value.

fromkeys(value=None, /)

Параметры

type

Обязательно

iterable

Обязательно

value

значение по умолчанию: None

get

Возвращает значение для ключа, если ключ находится в словаре, в противном случае значение по умолчанию.

get(key, default=None, /)

Параметры

key

Обязательно

default

значение по умолчанию: None

items

items() -> a set-like object providing a view on D's items

keys

keys() -> a set-like object providing a view on D's keys

pop

Если ключ не найден, верните значение по умолчанию, если оно задано. в противном случае создайте keyError.

pop(k, [d]) -> v, remove specified key and return the corresponding value.

popitem

Удалите и верните пару (ключ, значение) в виде двух кортежей.

Пары возвращаются в порядке LIFO (последний вход, первый выход). Вызывает ошибку keyError, если дикт пуст.

popitem()

set_limits

Задайте ограничения для узла очистки. Оставьте для параметров значение Нет, если вы не хотите обновлять соответствующие значения.

set_limits(*, max_concurrent_trials: int | None = None, max_total_trials: int | None = None, timeout: int | None = None, trial_timeout: int | None = None) -> None

Параметры

max_concurrent_trials

int

максимальное число одновременных пробных версий.

max_total_trials

int

максимальное общее число пробных версий.

timeout

int

общее время ожидания в секундах для узла очистки

trial_timeout

int

время ожидания в секундах для каждой пробной версии

set_objective

Задайте объект очистки. Оставьте для параметров значение Нет, если вы не хотите обновлять соответствующие значения.

"minimize", "maximize". :type goal: str :ключевое слово primary_metric: имя метрики для оптимизации. :p aramtype primary_metric: str

set_objective(*, goal: str | None = None, primary_metric: str | None = None) -> None

Параметры

goal

Определяет поддерживаемые цели метрики для настройки гиперпараметров. Допустимы следующие значения:

setdefault

Вставьте ключ со значением по умолчанию, если ключ отсутствует в словаре.

Возвращает значение для ключа, если ключ находится в словаре, в противном случае значение по умолчанию.

setdefault(key, default=None, /)

Параметры

key

Обязательно

default

значение по умолчанию: None

update

Если присутствует E и имеет метод .keys(), то выполняет: для k в E: D[k] = E[k] Если E присутствует и отсутствует метод .keys(), то выполняет: для k, v в E: D[k] = v В любом случае за этим следует: для k в F: D[k] = F[k]

update([E], **F) -> None.  Update D from dict/iterable E and F.

values

values() -> an object providing a view on D's values

Атрибуты

base_path

Базовый путь к ресурсу.

Возвращаемое значение

Базовый путь к ресурсу.

Возвращаемый тип

str

creation_context

Контекст создания ресурса.

Возвращаемое значение

Метаданные создания для ресурса.

Возвращаемый тип

Optional[SystemData]

early_termination

Политика досрочного завершения для задания очистки.

Возвращаемый тип

Union[str, BanditPolicy, MedianStoppingPolicy, TruncationSelectionPolicy]

id

Идентификатор ресурса.

Возвращаемое значение

Глобальный идентификатор ресурса, идентификатор Resource Manager Azure (ARM).

Возвращаемый тип

Optional[str]

inputs

Получение входных данных для объекта .

Возвращаемое значение

Словарь, содержащий входные данные для объекта .

Возвращаемый тип

Dict[str, Union[Input, str, bool, int, float]]

limits

Ограничения для задания очистки.

Возвращаемое значение

Ограничения для задания очистки.

Возвращаемый тип

SweepJobLimits

log_files

Выходные файлы задания.

Возвращаемое значение

Словарь имен и URL-адресов журналов.

Возвращаемый тип

Optional[Dict[str, str]]

name

Получение имени узла.

Возвращаемое значение

Имя узла.

Возвращаемый тип

str

outputs

Получение выходных данных объекта .

Возвращаемое значение

Словарь, содержащий выходные данные для объекта .

Возвращаемый тип

Dict[str, Union[str, Output]]

sampling_algorithm

Алгоритм выборки для задания очистки.

Возвращаемое значение

Алгоритм выборки для задания очистки.

Возвращаемый тип

SamplingAlgorithm

search_space

Словарь пространства поиска гиперпараметров.

Каждый ключ — это имя гиперпараметров, а его значение — выражение параметра.

Возвращаемый тип

Dict[str, Union[Choice, LogNormal, LogUniform, Normal, QLogNormal, QLogUniform, QNormal, QUniform, Randint, Uniform]]

status

Состояние задания.

Обычно возвращаются значения Running (Выполняется), Completed (Завершено) и Failed (Сбой). Все возможные значения:

• NotStarted — это временное состояние, в которое клиентские объекты Run находятся перед отправкой в облако.

• Starting — началась обработка запуска в облаке. На этом этапе вызывающий объект имеет идентификатор запуска.

• Подготовка — вычислительные ресурсы по запросу создаются для заданной отправки задания.

• Подготовка — среда выполнения подготавливается и находится в одном из двух этапов:

  • Сборка образа Docker

  • настройка среды conda.

• В очереди— задание помещается в очередь в целевом объекте вычислений. Например, в BatchAI задание находится в состоянии очереди.

  ожидая готовности всех запрошенных узлов.

• Выполнение — задание запущено для целевого объекта вычислений.

• Завершение — выполнение пользовательского кода завершено, и выполнение выполняется на этапах постобработки.

• CancelRequested — для задания запрошена отмена.

• Завершено — выполнение успешно завершено. Сюда входит выполнение пользовательского кода и выполнение.

  пользовательского кода и запуска.

• Failed — сбой запуска. Подробное описание причины как правило предоставляет свойство Error.

• Canceled — применяется после запроса отмены и указывает, что выполнение теперь успешно отменено.

• NotResponding — для запусков с включенными пульсами недавно не отправлялся пульс.

Возвращаемое значение

Состояние задания.

Возвращаемый тип

Optional[str]

studio_url

Конечная точка Студии машинного обучения Azure.

Возвращаемое значение

URL-адрес страницы сведений о задании.

Возвращаемый тип

Optional[str]

trial

Идентификатор или экземпляр компонента команды или задания, которые будут выполняться для шага.

Возвращаемый тип

CommandComponent

type

Тип задания.

Возвращаемое значение

Тип задания.

Возвращаемый тип

Optional[str]