Tài liệu tham khảo cho ultralytics/utils/files.py
Ghi
Tệp này có sẵn tại https://github.com/ultralytics/ultralytics/blob/main/ultralytics/utils/files.py. Nếu bạn phát hiện ra một vấn đề, vui lòng giúp khắc phục nó bằng cách đóng góp Yêu cầu 🛠️ kéo. Cảm ơn bạn 🙏 !
ultralytics.utils.files.WorkingDirectory
Căn cứ: ContextDecorator
Cách sử dụng: Trình trang trí @WorkingDirectory (dir) hoặc trình quản lý ngữ cảnh 'với WorkingDirectory (dir):'.
Mã nguồn trong ultralytics/utils/files.py
__enter__()
__exit__(exc_type, exc_val, exc_tb)
ultralytics.utils.files.spaces_in_path(path)
Trình quản lý ngữ cảnh để xử lý các đường dẫn có dấu cách trong tên của chúng. Nếu một đường dẫn chứa khoảng trắng, nó sẽ thay thế chúng bằng gạch dưới, sao chép tệp / thư mục vào đường dẫn mới, thực thi khối mã ngữ cảnh, sau đó sao chép tập tin / thư mục trở lại vị trí ban đầu của nó.
Thông số:
Tên | Kiểu | Sự miêu tả | Mặc định |
---|---|---|---|
path |
str | Path
|
Con đường ban đầu. |
bắt buộc |
Năng suất:
Kiểu | Sự miêu tả |
---|---|
Path
|
Đường dẫn tạm thời có dấu cách được thay thế bằng dấu gạch dưới nếu có dấu cách, nếu không thì đường dẫn ban đầu. |
Ví dụ
Mã nguồn trong ultralytics/utils/files.py
ultralytics.utils.files.increment_path(path, exist_ok=False, sep='', mkdir=False)
Gia tăng đường dẫn tệp hoặc thư mục, tức là runs/exp --> runs/exp{sep}2, runs/exp{sep}3,... v.v.
Nếu đường dẫn tồn tại và exist_ok không được đặt thành True, đường dẫn sẽ được tăng lên bằng cách thêm một số và sep vào điểm cuối của con đường. Nếu đường dẫn là một tệp, phần mở rộng tệp sẽ được giữ nguyên. Nếu đường dẫn là một thư mục, Số sẽ được nối trực tiếp vào cuối đường dẫn. Nếu mkdir được đặt thành True, đường dẫn sẽ được tạo dưới dạng thư mục nếu nó chưa tồn tại.
Thông số:
Tên | Kiểu | Sự miêu tả | Mặc định |
---|---|---|---|
path |
(str, Path)
|
Con đường tăng dần. |
bắt buộc |
exist_ok |
bool
|
Nếu True, đường dẫn sẽ không được tăng lên và trả về nguyên trạng. Mặc định là False. |
False
|
sep |
str
|
Dấu phân cách để sử dụng giữa đường dẫn và số gia tăng. Mặc định là ''. |
''
|
mkdir |
bool
|
Tạo một thư mục nếu nó không tồn tại. Mặc định là False. |
False
|
Trở lại:
Kiểu | Sự miêu tả |
---|---|
Path
|
Đường dẫn tăng dần. |
Mã nguồn trong ultralytics/utils/files.py
ultralytics.utils.files.file_age(path=__file__)
Ngày trả lại kể từ lần cập nhật tệp cuối cùng.
ultralytics.utils.files.file_date(path=__file__)
Trả về ngày sửa đổi tệp mà con người có thể đọc được, tức là '2021-3-26'.
ultralytics.utils.files.file_size(path)
Trả về file/dir size (MB).
Mã nguồn trong ultralytics/utils/files.py
ultralytics.utils.files.get_latest_run(search_dir='.')
Đường dẫn trả về 'last.pt' gần đây nhất trong /runs (tức là đến --resume from).
Mã nguồn trong ultralytics/utils/files.py
ultralytics.utils.files.update_models(model_names=('yolov8n.pt'), source_dir=Path('.'), update_names=False)
Cập nhật và lưu lại được chỉ định YOLO mô hình trong thư mục con 'updated_models'.
Thông số:
Tên | Kiểu | Sự miêu tả | Mặc định |
---|---|---|---|
model_names |
tuple
|
Tên tệp mô hình để cập nhật, mặc định là ("yolov8n.pt"). |
('yolov8n.pt')
|
source_dir |
Path
|
Thư mục chứa các mô hình và thư mục con đích, mặc định là thư mục hiện tại. |
Path('.')
|
update_names |
bool
|
Cập nhật tên model từ dữ liệu YAML. |
False
|