upgrade
最后更新
luxonis_train.upgrade升级旧配置和已安装的软件包。upgrade_config 将旧版本配置迁移到已安装版本的架构。Config.get_config 为其加载的每个配置文件或字典调用它。luxonis_train upgrade config 命令将结果写入文件。upgrade_installation 使用 pip 升级软件包。类
NestedDict
"trainer.optimizer.name" 代表 config["trainer"]["optimizer"]["name"]。读取缺失的键返回 None,写入则创建缺失的字典。包装器不复制字典,因此每个更改都会进入包装的字典。示例
Pycon
1>>> from luxonis_train.upgrade import NestedDict
2>>> config = {"trainer": {"epochs": 10}}
3>>> cfg = NestedDict(config)
4>>> cfg["trainer.epochs"], cfg["trainer.batch_size"]
5(10, None)
6>>> cfg["model.name"] = "detector"
7>>> config
8{'trainer': {'epochs': 10}, 'model': {'name': 'detector'}}方法
get
Python
1def get(key: str, default: Any = None) -> Any:key(str): 点键,例如"model.nodes"。default(Any): 当key不存在时返回的值。
Any:key下的值,或当key不存在时返回default。存储的None返回None。
log_change
Python
1def log_change(old_field: str, new_field: str):INFO 级别记录配置字段具有新键。参数old_field(str): 旧的点键。new_field(str): 新的点键。
pop
Python
1def pop(key: str, default: Any = ...) -> Any:key 的最后一部分。父字典保留,即使它们变为空。示例
Pycon
1>>> from luxonis_train.upgrade import NestedDict
2>>> config = {"exporter": {"output_names": ["boxes"]}}
3>>> cfg = NestedDict(config)
4>>> cfg.pop("exporter.output_names")
5['boxes']
6>>> config
7{'exporter': {}}
8>>> cfg.pop("exporter.output_names", None) is None
9Truekey(str): 点键,例如"exporter.output_names"。default(Any): 当key不存在时返回的值。默认...表示没有默认值。
Any: 删除的值,或当key不存在时返回default。
KeyError: 当key不存在且default为...时。
replace
Python
1def replace(old_key: str, new_key: str, value: ParamValue | EllipsisType | None = ...):old_key 不存在时,该方法不执行任何操作。否则,它会像 pop 那样删除 old_key,并像 self[new_key] = value 那样设置 new_key。然后它调用 log_change。参数old_key(str): 要删除的点键。new_key(str): 要设置的点键。value(ParamValue | EllipsisType | None):new_key的值。默认...保留旧值。任何其他值,包括None,都会替换它。
update
Python
1def update(key: str, value: Any):INFO 级别记录消息。对于缺失的 key,消息表示该字段是新的。否则,它显示旧值和新值。然后该方法像 self[key] = value 那样设置值。参数key(str): 点键,例如"version"。value(Any): 新值。
函数
get_latest_version
Python
1def get_latest_version() -> Version | None:luxonis-train 版本的版本。该函数从 PyPI JSON API 读取 info.version。请求超时为 5 秒。返回Version | None: 最新版本。当请求失败或响应状态不是200时,它为None。当响应正文不是带有有效info.version的 JSON 时,它也为None。
upgrade_config
Python
1def upgrade_config(config: PathType | Params) -> Params:.json 时,该函数将其读取为 JSON,否则读取为 YAML。它不会将文件写回。它不复制字典:它就地更改字典并返回它。没有 version 的配置算作 0.3.0 版本。该函数总是删除已弃用的 config_version 字段。当 version 是已安装版本或更新版本时,该函数不进行其他更改。否则,它执行以下步骤:- 它重命名这些字段:
trainer.use_rich_progress_bar到rich_logging。preprocessing.train_rgb到preprocessing.color_space。真值给出"RGB",假值给出"BGR"。model.predefined_model.params.variant到model.predefined_model.variant。tuner.storage.storage_type到tuner.storage.backend。"local"给出"sqlite",任何其他值给出"postgresql"。
- 它删除值为
None的tuner字段。 - 在
model.nodes的每个节点中,它将params.variant移动到variant。对于FOMOHead,它将params.num_conv_layers重命名为params.n_conv_layers。它删除params.download_weights,当该值为真时,它将params.weights设置为"download"。 - 当模型只有一个头时,它将
exporter.output_names移动到头的params.export_output_names。否则,它会记录错误并删除名称。 - 它将
model.losses、model.metrics和model.visualizers的每个模块移动到模块的attached_to字段命名的头。模块进入头的losses、metrics或visualizers列表,不带attached_to。 - 它将
version设置为已安装版本。
name 包含 "Head" 时,该节点是一个头。该函数通过其 alias 查找头,或者当头没有别名时通过其 name 查找头。当找到 config_version 时,该函数以 INFO 级别记录消息。当配置已是最新时,它也会记录一条消息,当升级开始时也会记录一条消息。在同一级别,它记录每个重命名的字段、每个移动的 params.variant、每个移动的模块和新的 version。tuner 的删除、params.download_weights 的更改以及 exporter.output_names 的移动没有 INFO 消息。参数config(PathType | Params): 本地 YAML 或 JSON 配置文件的路径,或作为字典的配置。
Params: 迁移后的配置。
ValueError: 当model.losses、model.metrics或model.visualizers中的模块没有attached_to字段,或者当attached_to未命名头时。
upgrade_installation
Python
1def upgrade_installation():luxonis-train 软件包。如果存在较新的版本,则使用当前的 Python 解释器升级 pip、luxonis_train 和 luxonis_ml[data]。版本检查失败将被记录并保持安装不变。