Referência para ultralytics/cfg/__init__.py
Nota
Este ficheiro está disponível em https://github.com/ultralytics/ ultralytics/blob/main/ ultralytics/cfg/init.py. Se detectares um problema, por favor ajuda a corrigi-lo contribuindo com um Pull Request 🛠️. Obrigado 🙏!
ultralytics.cfg.cfg2dict(cfg)
Converte um objeto de configuração em um dicionário, seja ele um caminho de arquivo, uma cadeia de caracteres ou um objeto SimpleNamespace.
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
cfg |
str | Path | dict | SimpleNamespace
|
Objeto de configuração a ser convertido em um dicionário. |
necessário |
Devolve:
Nome | Tipo | Descrição |
---|---|---|
cfg |
dict
|
Objeto de configuração em formato de dicionário. |
Código fonte em ultralytics/cfg/__init__.py
ultralytics.cfg.get_cfg(cfg=DEFAULT_CFG_DICT, overrides=None)
Carrega e funde dados de configuração a partir de um ficheiro ou dicionário.
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
cfg |
str | Path | Dict | SimpleNamespace
|
Dados de configuração. |
DEFAULT_CFG_DICT
|
overrides |
str | Dict | optional
|
Substitui na forma de um nome de ficheiro ou de um dicionário. A predefinição é Nenhum. |
None
|
Devolve:
Tipo | Descrição |
---|---|
SimpleNamespace
|
Espaço de nome dos argumentos de treino. |
Código fonte em ultralytics/cfg/__init__.py
ultralytics.cfg.check_cfg(cfg, hard=True)
Verifica Ultralytics os tipos e valores dos argumentos de configuração.
Código fonte em ultralytics/cfg/__init__.py
ultralytics.cfg.get_save_dir(args, name=None)
Retorna save_dir como criado a partir dos argumentos train/val/predict.
Código fonte em ultralytics/cfg/__init__.py
ultralytics.cfg._handle_deprecation(custom)
Função com código rígido para lidar com chaves de configuração obsoletas.
Código fonte em ultralytics/cfg/__init__.py
ultralytics.cfg.check_dict_alignment(base, custom, e=None)
Esta função verifica a existência de chaves incompatíveis entre uma lista de configuração personalizada e uma lista de configuração de base. Se encontrar chaves incompatíveis, a função imprime as chaves semelhantes da lista de base e sai do programa.
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
custom |
dict
|
um dicionário de opções de configuração personalizadas |
necessário |
base |
dict
|
um dicionário de opções de configuração de base |
necessário |
e |
Error
|
Um erro opcional que é transmitido pela função de chamada. |
None
|
Código fonte em ultralytics/cfg/__init__.py
ultralytics.cfg.merge_equals_args(args)
Combina argumentos em torno de argumentos '=' isolados numa lista de cadeias de caracteres. A função considera os casos em que o primeiro argumento termina com '=' ou o segundo começa com '=', bem como quando o argumento do meio é um sinal de igual.
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
args |
List[str]
|
Uma lista de cadeias de caracteres em que cada elemento é um argumento. |
necessário |
Devolve:
Tipo | Descrição |
---|---|
List[str]
|
Uma lista de cadeias de caracteres onde os argumentos em torno de '=' isolado são fundidos. |
Código fonte em ultralytics/cfg/__init__.py
ultralytics.cfg.handle_yolo_hub(args)
Trata dos comandos da interface de linha de comandos do Ultralytics HUB (CLI).
Esta função processa Ultralytics HUB CLI comandos como login e logout. Deve ser chamada quando se executa um script com argumentos relacionados com a autenticação do HUB.
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
args |
List[str]
|
Uma lista de argumentos de linha de comando |
necessário |
Código fonte em ultralytics/cfg/__init__.py
ultralytics.cfg.handle_yolo_settings(args)
Trata os comandos da interface de linha de comandos das definições YOLO (CLI).
Esta função processa as definições de YOLO CLI comandos como a reposição. Deve ser chamada quando executa um script com argumentos relacionados com a gestão das definições de YOLO .
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
args |
List[str]
|
Uma lista de argumentos da linha de comandos para a gestão das definições do YOLO . |
necessário |
Código fonte em ultralytics/cfg/__init__.py
ultralytics.cfg.handle_explorer()
Abre a GUI do Ultralytics Explorer.
Código fonte em ultralytics/cfg/__init__.py
ultralytics.cfg.parse_key_value_pair(pair)
Analisa um par 'key=value' e devolve a chave e o valor.
Código fonte em ultralytics/cfg/__init__.py
ultralytics.cfg.smart_value(v)
Converte uma cadeia de caracteres para um tipo subjacente, como int, float, bool, etc.
Código fonte em ultralytics/cfg/__init__.py
ultralytics.cfg.entrypoint(debug='')
Esta função é o ponto de entrada do pacote ultralytics , é responsável por analisar os argumentos da linha de comando passados para o pacote.
Esta função permite-te: - passar os argumentos obrigatórios YOLO como uma lista de cadeias de caracteres - especificar a tarefa a executar, seja "detetar", "segmentar" ou "classificar - especificar o modo, ou 'train', 'val', 'test', ou 'predict' - executar modos especiais como "checks" (verificações) - passando substituições para a configuração do pacote
Usa o cfg padrão do pacote e o inicializa usando as substituições passadas. Em seguida, chama a função CLI com o cfg composto
Código fonte em ultralytics/cfg/__init__.py
441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 |
|
ultralytics.cfg.copy_default_cfg()
Copia e cria um novo arquivo de configuração padrão com '_copy' anexado ao seu nome.
Código fonte em ultralytics/cfg/__init__.py
Criado em 2023-11-12, Atualizado em 2024-05-08
Autores: Burhan-Q (1), glenn-jocher (4), AyushExel (1), Laughing-q (1)