参考资料 ultralytics/cfg/__init__.py
备注
该文件可在https://github.com/ultralytics/ultralytics/blob/main/ ultralytics/ cfg/init.py。如果您发现问题,请通过提交 Pull Request🛠️ 帮助修复。谢谢🙏!
ultralytics.cfg.cfg2dict(cfg)
将配置对象转换为字典,无论是文件路径、字符串还是 SimpleNamespace 对象。
参数
名称 | 类型 | 说明 | 默认值 |
---|---|---|---|
cfg |
str | Path | dict | SimpleNamespace
|
要转换为字典的配置对象。 |
所需 |
返回:
名称 | 类型 | 说明 |
---|---|---|
cfg |
dict
|
字典格式的配置对象。 |
源代码 ultralytics/cfg/__init__.py
ultralytics.cfg.get_cfg(cfg=DEFAULT_CFG_DICT, overrides=None)
从文件或字典中加载和合并配置数据。
参数
名称 | 类型 | 说明 | 默认值 |
---|---|---|---|
cfg |
str | Path | Dict | SimpleNamespace
|
配置数据。 |
DEFAULT_CFG_DICT
|
overrides |
str | Dict | optional
|
以文件名或字典形式覆盖。默认为 "无"。 |
None
|
返回:
类型 | 说明 |
---|---|
SimpleNamespace
|
训练参数命名空间。 |
源代码 ultralytics/cfg/__init__.py
ultralytics.cfg.check_cfg(cfg, hard=True)
检查Ultralytics 配置参数类型和值。
源代码 ultralytics/cfg/__init__.py
ultralytics.cfg.get_save_dir(args, name=None)
返回根据 train/val/predict 参数创建的 save_dir。
源代码 ultralytics/cfg/__init__.py
ultralytics.cfg._handle_deprecation(custom)
硬编码函数,用于处理过时的配置键。
源代码 ultralytics/cfg/__init__.py
ultralytics.cfg.check_dict_alignment(base, custom, e=None)
此函数将检查自定义配置列表和基本配置列表之间是否存在不匹配的键。如果 发现任何不匹配的键,该函数就会从基础列表中打印出类似的键,并退出程序。
参数
名称 | 类型 | 说明 | 默认值 |
---|---|---|---|
custom |
dict
|
自定义配置选项词典 |
所需 |
base |
dict
|
基础配置选项词典 |
所需 |
e |
Error
|
调用函数传递的可选错误。 |
None
|
源代码 ultralytics/cfg/__init__.py
ultralytics.cfg.merge_equals_args(args)
合并字符串列表中孤立的"="参数周围的参数。该函数会考虑第一个 参数以"="结尾或第二个参数以"="开始的情况,以及中间参数是等号的情况。
参数
名称 | 类型 | 说明 | 默认值 |
---|---|---|---|
args |
List[str]
|
字符串列表,其中每个元素都是一个参数。 |
所需 |
返回:
类型 | 说明 |
---|---|
List[str]
|
字符串列表,其中孤立的"="周围的参数被合并。 |
源代码 ultralytics/cfg/__init__.py
ultralytics.cfg.handle_yolo_hub(args)
处理Ultralytics HUB 命令行界面 (CLI) 命令。
该函数用于处理Ultralytics HUBCLI 命令,如登录和注销。 在执行带有与 HUB 身份验证相关参数的脚本时,应调用该函数。
参数
名称 | 类型 | 说明 | 默认值 |
---|---|---|---|
args |
List[str]
|
命令行参数列表 |
所需 |
源代码 ultralytics/cfg/__init__.py
ultralytics.cfg.handle_yolo_settings(args)
处理YOLO 设置命令行界面 (CLI) 命令。
该函数处理YOLO 设置CLI 命令,如重置。 在执行带有与YOLO 设置管理相关参数的脚本时,应调用该函数。
参数
名称 | 类型 | 说明 | 默认值 |
---|---|---|---|
args |
List[str]
|
用于YOLO 设置管理的命令行参数列表。 |
所需 |
源代码 ultralytics/cfg/__init__.py
ultralytics.cfg.handle_explorer()
打开Ultralytics Explorer 图形用户界面。
源代码 ultralytics/cfg/__init__.py
ultralytics.cfg.parse_key_value_pair(pair)
解析一对 "key=value",并返回 key 和 value。
ultralytics.cfg.smart_value(v)
将字符串转换为底层类型,如 int、float、bool 等。
源代码 ultralytics/cfg/__init__.py
ultralytics.cfg.entrypoint(debug='')
该函数是ultralytics 软件包的入口点,负责解析传递给软件包的命令行参数。 的命令行参数。
该函数允许 - 以字符串列表的形式传递强制性YOLO args - 指定要执行的任务,"检测"、"分割 "或 "分类 - 指定模式,"train"、"val"、"test "或 "predict "均可 - 运行 "检查 "等特殊模式 - 向软件包的配置传递重载项
它使用软件包的默认 cfg,并使用传递的重载对其进行初始化。 然后调用CLI 函数,并使用组成的 cfg
源代码 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()
复制并创建一个新的默认配置文件,文件名后附加"_copy"。