tracker
最后更新
luxonis_ml.trackerLuxonis ML 工作流的实验跟踪门面。luxonis_ml.tracker 包导出了 LuxonisTracker,这是一个用于 TensorBoard、Weights & Biases 和 MLflow 的统一日志接口。训练和评估代码可以通过一个 API 记录指标、超参数、图像、矩阵和工件,同时在运行时选择启用的后端。在分布式训练中传递 rank。受 rank 限制的日志记录方法,例如 LuxonisTracker.log_metric,仅在 rank 0 上写入。保存或重放本地缓冲区的辅助函数不检查 rank。示例
启动一个由 TensorBoard 支持的运行并记录一个标量指标。
Python
1from luxonis_ml.tracker import LuxonisTracker
2
3tracker = LuxonisTracker(
4 project_name="training",
5 run_name="baseline",
6 is_tensorboard=True,
7)
8tracker.log_metric("loss", 0.42, step=1)
9tracker.close()注意
tracker 额外功能不会安装此包的所有依赖项。该包在导入时导入 mlflow 和 cv2,因此也请安装 mlflow 和 opencv-python:Command Line
1pip install "luxonis-ml[tracker,mlflow]" opencv-python- TensorBoard 需要
torch,因为写入器来自torch.utils.tensorboard; - Weights & Biases 需要
wandb。
torch 和 wandb,因此缺少 SDK 仅对您打开的后端有影响。启用后端
Python
1from luxonis_ml.tracker import LuxonisTracker
2
3tracker = LuxonisTracker(
4 project_name="my-project",
5 run_name="baseline",
6 is_tensorboard=True,
7 is_wandb=True,
8 wandb_entity="my-entity",
9)
10
11tracker.log_hyperparams({"lr": 1e-3, "batch_size": 32})
12tracker.log_metrics({"acc": 0.92, "loss": 0.18}, step=1)
13tracker.upload_artifact("model.onnx", name="model", typ="model")
14tracker.close()ValueError:后端参数| 标志 | 还需要 |
|---|---|
is_tensorboard | 无。写入器使用 <save_directory>/tensorboard_logs/<run_name>。一个 sweep 运行会添加一个 trial_<n> 级别。 |
is_wandb | wandb_entity,以及 project_name 或 project_id。 |
is_mlflow | mlflow_tracking_uri,以及 project_name 或 project_id。 |
日志记录 API
- LuxonisTracker.log_hyperparams;
- LuxonisTracker.log_metric 和 LuxonisTracker.log_metrics;
- LuxonisTracker.log_image 和 LuxonisTracker.log_images;
- LuxonisTracker.log_matrix;
- LuxonisTracker.upload_artifact。
numpy 数组。MLflow 注意事项
<save_directory>/<run_name> 下:local_logs.json包含指标、参数、矩阵以及保存图像和工件的索引;images/包含缓冲的图像;artifacts/包含每个缓冲工件的副本,其源文件仍然存在。
MLFLOW_CLOUDFLARE_ID 和 MLFLOW_CLOUDFLARE_SECRET。在您的应用程序中注册 LuxonisRequestHeaderProvider,因为 LuxonisML 没有为其声明 MLflow 入口点。另请参阅
luxonis_ml.tracker.tracker 用于日志记录实现,luxonis_ml.tracker.mlflow_plugins 用于 MLflow 请求头支持。