Referência para ultralytics/utils/files.py
Nota
Este ficheiro está disponível em https://github.com/ultralytics/ ultralytics/blob/main/ ultralytics/utils/files .py. Se encontrares um problema, por favor ajuda a corrigi-lo contribuindo com um Pull Request 🛠️. Obrigado 🙏!
ultralytics.utils.files.WorkingDirectory
Bases: ContextDecorator
Usa-o: O decorador @WorkingDirectory(dir) ou o gestor de contexto 'with WorkingDirectory(dir):'.
Código fonte em ultralytics/utils/files.py
__enter__()
__exit__(exc_type, exc_val, exc_tb)
__init__(new_dir)
ultralytics.utils.files.spaces_in_path(path)
Gerenciador de contexto para lidar com caminhos com espaços em seus nomes. Se um caminho contém espaços, substitui-os por substitui por sublinhados, copia o arquivo/diretório para o novo caminho, executa o bloco de código de contexto e, em seguida, copia o copia o ficheiro/diretório de volta para a sua localização original.
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
path |
str | Path
|
O caminho original. |
necessário |
Rende-te:
Tipo | Descrição |
---|---|
Path
|
Caminho temporário com espaços substituídos por sublinhados se existirem espaços, caso contrário, o caminho original. |
Exemplo
Código fonte em ultralytics/utils/files.py
ultralytics.utils.files.increment_path(path, exist_ok=False, sep='', mkdir=False)
Incrementa um caminho de arquivo ou diretório, ou seja, runs/exp --> runs/exp{sep}2, runs/exp{sep}3, ... etc.
Se o caminho existir e exist_ok não estiver definido como True, o caminho será incrementado acrescentando um número e sep ao ao final do caminho. Se o caminho for um ficheiro, a extensão do ficheiro será preservada. Se o caminho for um diretório, o número será anexado diretamente ao final do caminho. Se mkdir for definido como True, o caminho será criado como um diretório se ele ainda não existir.
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
path |
(str, Path)
|
Caminho para o incremento. |
necessário |
exist_ok |
bool
|
Se for True, o caminho não será incrementado e será devolvido tal como está. A predefinição é False. |
False
|
sep |
str
|
Separador a utilizar entre o caminho e o número de incrementação. A predefinição é ''. |
''
|
mkdir |
bool
|
Cria um diretório se ele não existir. A predefinição é Falso. |
False
|
Devolve:
Tipo | Descrição |
---|---|
Path
|
Incrementa o caminho. |
Código fonte em ultralytics/utils/files.py
ultralytics.utils.files.file_age(path=__file__)
Devolve os dias desde a última atualização do ficheiro.
ultralytics.utils.files.file_date(path=__file__)
Devolve a data de modificação do ficheiro legível por humanos, ou seja, '2021-3-26'.
ultralytics.utils.files.file_size(path)
Devolve o tamanho do ficheiro/direção (MB).
Código fonte em ultralytics/utils/files.py
ultralytics.utils.files.get_latest_run(search_dir='.')
Retorna o caminho para o 'last.pt' mais recente em /runs (i.e. para --resume from).
Código fonte em ultralytics/utils/files.py
ultralytics.utils.files.update_models(model_names=('yolov8n.pt'), source_dir=Path('.'), update_names=False)
Atualiza e salva novamente os modelos YOLO especificados em um subdiretório 'updated_models'.
Parâmetros:
Nome | Tipo | Descrição | Predefinição |
---|---|---|---|
model_names |
tuple
|
Nomes de ficheiros de modelos a atualizar; a predefinição é ("yolov8n.pt"). |
('yolov8n.pt')
|
source_dir |
Path
|
Diretório que contém os modelos e o subdiretório de destino, por predefinição o diretório atual. |
Path('.')
|
update_names |
bool
|
Actualiza os nomes dos modelos a partir de um YAML de dados. |
False
|
Exemplo
Código fonte em ultralytics/utils/files.py
Criado em 2023-11-12, Atualizado em 2024-05-08
Autores: Burhan-Q (1), glenn-jocher (4), Laughing-q (1)